Dataset Services Interface › $DSCALL OPT=MEMLIST

$DSCALL OPT=MEMLIST

Obtains or displays a list of PDS members.

&CONTROL SHRVARS=($DS)
EXEC $DSCALL OPT=MEMLIST DSN=dataset_name 
           [ DISPLAY={ YES | NO } ] 
           [ MEMBER=pattern ]

This call is used to obtain a list of members in a PDS and return information about the members to the calling procedure in variables. It is also used to obtain a full-screen selection list of members in a PDS.

Operands:

• OPT=MEMLIST

  Specifies that information about the members be obtained.

• DSN=dataset_name

  Specifies the name of the PDS containing the members. No member name is specified.

• DISPLAY={YES | NO }

  Specifies whether to display the selection list of PDS member names. When DISPLAY=NO is specified, the member information is returned in variables &$DSMEM#, &$DSMEMn, and &$DSSTATn.

• MEMBER=pattern

  Specifies the name of a member pattern which specifies a subset of the members in the PDS. If not specified all members are searched. You can specify a particular pattern name, or use a mask to indicate more than one pattern name.

  A pattern can contain the question mark (?) and asterisk (*) characters. The ? character is used to match any single character in more than one member name. The * character is used to match any number of characters in more than one member name. For example:

  • ABCD

    matches only the pattern name ABCD

  • A?D

    matches any three character pattern name that begins with A and ends with D, such as, AID, AFD, AZD

  • A*D

    matches member names of any length that begin with A and ends with D, such as, AD, ABCD, ABD

Return Codes:

Note: For more information about &SYSMSG, &$DSRC, and &$DSFDBK, see Return Codes and Feedback Codes.

Return Variables:

• &$DSMEM#

  Number of members returned

• &$DSMEMn

  Member names in ascending order

• &$DSSTATn

  SPF statistics for the associated member name

• &$DSLIBn

  The concatenation level of the data set where the member resides

Examples:

EXEC $DSCALL OPT=MEMLIST DSN=SYS.WORK.DEV01 DISPLAY=YES

The selection list displays ISPF member information as shown in the following figure. The BROWSE, EDIT, DELETE, PRINT, RENAME, and SUBMIT actions can be applied to the members on the list.

This example produces the following output:

 PROD----------- Dataset Services : PDS Member SPF Statistics ------------------
 Command ===>                                                    Scroll ===> CSR

                           B/=Browse E=Edit D=Delete P=Print R=Rename SUB=Submit
     Member   VV.MM    Created        Changed      Size  Init   Mod ID       Lib
     $$$AW    01.05  11-MAY-2007 14-MAY-2007 20:41  418   378     0 SYSIP01    1
     $$$AW1   01.07  11-MAY-2007 15-MAY-2007 02:29  531   378     0 SYSIP01    1
     $$$AW3   01.03  15-MAY-2007 15-MAY-2007 21:48  570   570     0 SYSIP01    1
     $$$SPACE
     $$COPYRI 01.00  26-JAN-2008 26-JAN-2008 22:16    0     0     0 SYSIP02    7
     $$NMLIC  01.00  26-JAN-2008 26-JAN-2008 22:16    0     0     0 SYSIP02    7
     $$QASMSG 01.01  23-AUG-1995 23-AUG-1995 18:44    0     0     0 SYSIP14    8
     $$SL     01.00  11-FEB-2008 11-FEB-2008 19:27    0     0     0 SYSIP02    6
     $$SYSPRD 01.00  18-MAR-2008 18-MAR-2008 00:04    0     0     0 SYSIP02    3
     $$SYSPRO 01.00  11-FEB-2008 11-FEB-2008 19:27    0     0     0 SYSIP02    6
     $@COPY   01.02  04-MAY-1992 17-JUL-2004 05:44    0     0     0 SYSIP02    8
     $@DELETE 01.02  04-MAY-1992 17-JUL-2004 05:44    0     0     0 SYSIP02    8
     $@E      01.02  04-MAY-1992 17-JUL-2004 05:44    0     0     0 SYSIP02    8
     $@L      01.02  04-MAY-1992 17-JUL-2004 05:44    0     0     0 SYSIP02    8
     $@M      01.02  04-MAY-1992 17-JUL-2004 05:44    0     0     0 SYSIP02    8
     $@NMFTS  01.02  04-MAY-1992 17-JUL-2004 05:44    0     0     0 SYSIP02    8
     $@NOTIFY 01.02  04-MAY-1992 17-JUL-2004 05:44    0     0     0 SYSIP02    8
     $@R      01.02  04-MAY-1992 17-JUL-2004 05:44    0     0     0 SYSIP02    8
     $@REPRO  01.03  05-JUN-1994 17-JUL-2004 05:44    0     0     0 SYSIP02    8
     $@S      01.02  04-MAY-1992 17-JUL-2004 05:44    0     0     0 SYSIP02    8
     $ACBERFL 01.01  04-MAY-1992 04-MAY-1992 20:36    0     0     0 SYSIP24    8