$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).