$DSCALL OPT= LISTC

Dataset Services Interface › $DSCALL OPT= LISTC

$DSCALL OPT= LISTC

Obtains or displays a list of data sets that begin with a specified name prefix.

&CONTROL SHRVARS=($DS)
EXEC $DSCALL OPT= LISTC QUAL=qualifier 
           [ SYSPRINT= { KEEP | DSN | DELETE } ] 
           [ DISPLAY= { YES | NO } ] 
           [ PARM={ NAME | VOLUME | ALL } ]

This call allows users of your product region to perform an IDCAMS LISTCAT operation and receive the results. This is used to obtain a list of cataloged data sets which have a specified name prefix.

Operands:

OPT=LISTC

Specifies that a list of data sets be obtained or displayed.

QUAL=qualifier

The fully qualified name prefix for the list of data sets to be displayed.

SYSPRINT={ KEEP | DSN | DELETE }

Specifies the type of data set to be allocated to the SYSPRINT DD for the copy operation.

If SYSPRINT=KEEP is specified, your product region allocates a SYSOUT file with CLASS=A, and after the copy has completed the SYSOUT data set is deallocated with DISP=KEEP to cause it to be kept. The output from the copy operation is browsed through, for example, SDSF.
If SYSPRINT=DSN is specified, your product region allocates a temporary data set, which is deleted when your product region terminates. The output from the copy operation is browsed through ISPF or by the use of the DISPLAY=YES operand on this call. The data set is not deallocated from your product region on completion of the copy operation. The data set name, ddname, and volume for the data set are returned in variables to the caller.
If SYSPRINT=DELETE is specified, your product region allocates a SYSOUT file with CLASS=A, and after the copy has completed, the SYSOUT file is deallocated with DISP=DELETE to cause it to be deleted. The output from the copy operation cannot be browsed.

DISPLAY={ YES | NO }

Specifies whether to display the SYSPRINT output. The display parameter is only valid if SYSPRINT=DSN.

PARM={ NAME | VOLUME | ALL }

Specifies the level of detail of the returned catalog information. The value is any valid parameter used in the IBM LISTCAT utility after the LEVEL parameter.

Return Codes:

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

Return Variables:

&$DSPRINTDSN: Name of SYSPRINT file
&$DSPRINTVOL: Volume where SYSPRINT file is located
&$DSPRINTDD: SYSPRINT ddname

Examples: OPT=LISTC

When $DSCALL is called with the LISTC option and no PARM specified:

EXEC $DSCALL OPT=LISTC QUAL=SYS1 DISPLAY=YES SYSPRINT=DSN

it produces the following output:

USER01---------- SYS95229.T172448.RA000.PROD1.R0000102 ----Columns 001 079 Command ===> Scroll ===> PAGE ****************************** TOP OF DATA ******************************* 1IDCAMS SYSTEM SERVICES TIME: 17:24: 0 LISTCAT LEVEL(SYS1) NAME 0NONVSAM ------- SYS1.AADFMAC1 IN-CAT --- CATALOG.MCAT.VMVS006 0NONVSAM ------- SYS1.ABLSCLI0 IN-CAT --- CATALOG.MCAT.VMVS006 0NONVSAM ------- SYS1.ABLSKEL0 IN-CAT --- CATALOG.MCAT.VMVS006 0NONVSAM ------- SYS1.ABLSMSG0 IN-CAT --- CATALOG.MCAT.VMVS006 0NONVSAM ------- SYS1.ABLSPNL0 IN-CAT --- CATALOG.MCAT.VMVS006 0NONVSAM ------- SYS1.ABLSTBL0 IN-CAT --- CATALOG.MCAT.VMVS006 0NONVSAM ------- SYS1.ABMFMOD0 IN-CAT --- CATALOG.MCAT.VMVS006 0NONVSAM ------- SYS1.ABNJMISC F1=Help F2=Split F3=Exit F4=Return F5=Find F7=Backward F8=Forward F9=Swap F10=Left F11=Right

When $DSCALL is called with the LISTC option and PARM=ALL specified:

EXEC $DSCALL OPT=LISTC QUAL=PROD.V3R2M0 DISPLAY=YES PARM=ALL  
+      SYSPRINT=DSN

it produces the following output:

USER01---------- SYS95229.T172834.RA000.PROD1.R0000106 ----Columns 001 079 Command ===> Scroll ===> PAGE ****************************** TOP OF DATA ******************************* 1IDCAMS SYSTEM SERVICES TIME: 17:28: 0 LISTCAT LEVEL(SYS1) ALL 0NONVSAM ------- SYS1.AADFMAC1 IN-CAT --- CATALOG.MCAT.VMVS006 HISTORY DATASET-OWNER-----(NULL) CREATION--------1991.310 RELEASE----------------2 EXPIRATION------0000.000 VOLUMES VOLSER------------MVS005 DEVTYPE------X‘3010200E’ FSEQN---- ASSOCIATIONS ALIAS----TARGSYS.SYS1.AADFMAC1 0NONVSAM ------- SYS1.ABLSCLI0 IN-CAT --- CATALOG.MCAT.VMVS006 HISTORY DATASET-OWNER-----(NULL) CREATION--------1991.310 RELEASE----------------2 EXPIRATION------0000.000 VOLUMES F1=Help F2=Split F3=Exit F4=Return F5=Find F7=Backward F8=Forward F9=Swap F10=Left F11=Right

When $DSCALL is called with the LISTC option and PARM=VOLUME specified:

EXEC $DSCALL OPT=LISTC QUAL=SYS1 DISPLAY=YES PARM=VOLUME +
      SYSPRINT=DSN

it produces the following output:

USER01--------- SYS98265.T154724.RA000.PROD41.R0105116 -----Columns 001 079 Command ===> Scroll ===> PAGE ***************************** TOP OF DATA ******************************** 1IDCAMS SYSTEM SERVICES TIME: 17:30: 0 0NONVSAM ------- SYS1.AACBCNTL IN-CAT --- CATALOG.VOS3SCT HISTORY DATASET-OWNER-----(NULL) CREATION--------1997.167 RELEASE----------------2 EXPIRATION------0000.000 VOLUMES VOLSER------------OS3SDL DEVTYPE------X‘3010200F’ FSEQN---- 0NONVSAM ------- SYS1.AADFMAC1 IN-CAT --- CATALOG.VOS3SCT HISTORY DATASET-OWNER-----(NULL) CREATION--------1997.167 RELEASE----------------2 EXPIRATION------0000.000 VOLUMES VOLSER------------OS3SDL DEVTYPE------X‘3010200F’ FSEQN---- 0NONVSAM ------- SYS1.AADRLIB F1=Help F2=Split F3=Exit F4=Return F5=Find F7=Backward F8=Forward F9=Swap F10=Left F11=Right

When $DSCALL is called with the LISTC option and PARM=VOLUME specified:

EXEC $DSCALL OPT=LISTC QUAL=SYS1 DISPLAY=YES PARM=VOLUME +
      SYSPRINT=DSN

it produces the following output:

Note: This is the same as the output produced when $DSCALL is called with the LISTC option and no PARM specified (see the first example).