Displays a selection list of data sets that begin with a specified name prefix.
&CONTROL SHRVARS=($DS)
EXEC $DSCALL OPT=CATLIST
QUAL= qualifier
This call allows users of your product region to obtain a full-screen selection list of cataloged data sets that have a specified name prefix. The list is obtained by your product region using an IDCAMS LISTCAT operation. When the list is displayed, the user can obtain data set information about data sets in the list.
Operands:
Specifies that a selection list of data sets be obtained.
The fully qualified name prefix for the list of data sets to be displayed. The qualifier can consist of more than one level.
Return Codes:
Note: For more information about &SYSMSG, &$DSRC, and &$DSFDBK, see Return Codes and Feedback Codes.
Example: OPT=CATLIST
EXEC $DSCALL OPT=CATLIST QUAL=PROD1.MAIN
The CATLIST option returns a selection list such as the one shown in the first example that follows. Enter S beside a data set to select it and display data set information, as shown in second example that follows.
The following is an example of OPT=CATLIST Output:
USER01------------ Dataset Services : Listcat Output ---------------------
Command ===> Scroll ===> PAGE
S/=Select B=Browse E=Edit P=Print M=Memlist
D=Delete R=Rename SUB=Submit RC=Recall
Dataset Name Catalog Volume Created
PROD1.MAIN.ALERTCKP VMVS005 17-AUG-2008
PROD1.MAIN.ALERTCKP.DATA VMVS005 MVS007 17-AUG-2008
PROD1.MAIN.ALERTCKP.INDX VMVS005 MVS007 17-AUG-2008
S PROD1.MAIN.ALERTHST VMVS005 17-AUG-2008
PROD1.MAIN.ALERTHST.DATA VMVS005 MVS007 17-AUG-2008
PROD1.MAIN.ALERTHST.INDX VMVS005 MVS007 17-AUG-2008
PROD1.MAIN.BASE.INSTALL VMVS005 PGM002 16-AUG-2008
PROD1.MAIN.CMDLIB VMVS005 PGM002 16-AUG-2008
PROD1.MAIN.CSI VMVS005 16-AUG-2008
PROD1.MAIN.CSI.DATA VMVS005 PGM002 16-AUG-2008
PROD1.MAIN.CSI.INDEX VMVS005 PGM002 16-AUG-2008
PROD1.MAIN.HELP VMVS005 PGM002 16-AUG-2008
PROD1.MAIN.ICOPANL VMVS005 17-AUG-2008
PROD1.MAIN.ICOPANL.DATA VMVS005 MVS007 17-AUG-2008
PROD1.MAIN.ICOPANL.INDX VMVS005 MVS007 17-AUG-2008
PROD1.MAIN.INSTAL VMVS005 PGM002 16-AUG-2008
F1=Help F2=Split F3=Exit F5=Find F6=Refresh
F7=Backward F8=Forward F9=Swap
The following is an example of Information for a Selected Data Set:
USER01------------------- PROD1.MAIN.ALERTHST -----------Columns 001 079
Command ===> Scroll ===> PAGE
**************************** TOP OF DATA *******************************
Dataset name ........... PROD1.MAIN.ALERTHST
Dataset organization ... VSAM
Dataset record format ..
Logical record length ..
Dataset blocksize ......
Dataset volume ......... MVS007
Dataset unit ........... 3380
Storage class .......... DASD
Number of extents ...... 0
Create date ............ 17-AUG-2008
Expiration date ........ None
Last reference date .... Not available
Tracks per cylinder .... 15
Primary tracks ......... 0
Allocated tracks ....... 0
Used tracks ............ 0
Secondary allocation ... 0
*************************** BOTTOM OF DATA *****************************
F1=Help F2=Split F3=Exit F4=Return F5=Find
F7=Backward F8=Forward F9=Swap F10=Left F11=Right
Note: This function performs an IDCAMS LISTCAT to obtain the list of data sets. The SYSPRINT data set is automatically deleted. The only option available on the selection list is used to obtain data set information. The information is returned unless the data set is migrated.