Calling OLIST from an application

Edit online

You can invoke OLIST from an application or CLIST. You can invoke the OLIST selection list, a new or existing permanent OLIST, or a temporary OLIST, with the default process (Edit, Browse, or View) of your choice. For example, to invoke a temporary OLIST of all data sets matching the level USER2.TEST, you can issue a command like this:

ISPEXEC SELECT PGM(IQIPLST) PARM('USE2.TEST.*') NEWAPPL(ISR) PASSLIB

The parameters passed to the IQIPLST program are the same parameters you can pass to the OLIST general command. For example, to obtain a temporary OLIST with the libraries allocated to STEPLIB you can enter the command:

OLIST @DD STEPLIB

Similarly you can invoke the same OLIST from a REXX exec with the statement:

ISPEXEC SELECT PGM(IQIPLST) PARM('@DD STEPLIB')
NEWAPPL(ISR) PASSLIB

The following are acceptable OLIST parameters:

Parameter Explanation
= Invoke the default (last) referenced permanent OLIST
* Display the OLIST reference list
DSNpatt,VOLpatt Opens a temporary list showing cataloged data sets matching the specified DSN pattern (with wildcards). If a volume pattern is specified, only data sets cataloged to the specified volumes are listed.

Examples:

   OLIST TAXES.YEAREND.*
   OLIST SYS1.*,SYSR01
   OLIST SYS1.*,*
Name Invoke a previously saved OLIST. OLIST names follow the naming conventions of member names.
@DD,ddname
@LISTA,ddname
 Opens a temporary OLIST displaying allocated data sets. If a ddname is specified, only libraries allocated to the specified DD statement are listed.
@H Opens a temporary OLIST showing the history list (the list of last 100 data sets referenced by the user).
@LISTB,DSNpatt Opens a temporary list of generation data sets of generation group names matching the GDG base pattern.
Examples: 
   OLIST @LISTB,GB*
   OLIST @LISTGRP,GB*
@LISTC,DSNpatt Opens a temporary list of cataloged entries (objects).
Example: 
   OLIST @LISTC,SYS*
@LISTG,DSNpatt
@LISTGDG,DSNpatt
 Opens a temporary list of Generation-Data-Sets by DSN pattern.
Examples: 
   OLIST @LISTG,S*
   OLIST @LISTGDG,S*
@LISTM,DSNpatt
@LISTARC,DSNpatt
 Opens a temporary OLIST with the list of migrated (or archived) data sets matching the specified volume pattern. Both commands are similar and are offered for installations with HSM, ASM2, or DMS systems.
Examples: 
   OLIST @LISTM,SYS1.A*LIB
   OLIST @LISTARC,SYS2.*
@LISTP,DSNpatt Opens a temporary list of all Page-Space files by DSN pattern
Examples: 
   OLIST @LISTP,*
   OLIST @LISTPAG,*
@LISTS,keyword,value Opens a temporary OLIST displaying system data sets depending on the parameters.
Examples: 
   OLIST @LISTS,ALL
   OLIST @LISTS,APF
   OLIST @LISTS,LINK
   OLIST @LISTS,LINK,ALL
   OLIST @LISTS,LINK,CURR
   OLIST @LISTS,LINK,IPL
   OLIST @LISTS,LINK,J=PROD*
   OLIST @LISTS,LINK,L=MRO*
   OLIST @LISTS,LINK,U=INT*
   OLIST @LISTS,LINK,S=JES*
   OLIST @LISTS,LPA
   OLIST @LISTS,PARMLIB
@LISTT,DSNpatt Opens a temporary list of Tape Files by DSN pattern. Requires a volume pattern and the first character cannot be a wildcard.
Examples: 
   OLIST @LISTT,I*
   OLIST @LISTT,MYTAPE*
@LISTV,VOLpatt,DSNpatt Opens a temporary list of files (including uncataloged) by VOLSER pattern and DSN pattern. You must supply a volume serial or pattern.
Example: 
OLIST @LISTV,USER*,I*SPF*
@LISTW,DSNpatt
@LISTVS,DSNpatt
 Opens a temporary OLIST of VSAM Clusters by DSN pattern.
Example: 
   OLIST @LISTW,VS*
   OLIST @LISTVS,MYVSAM*FILE%1
@LISTZ,DSNpatt Opens a temporary OLIST displaying SMP/E Zone VSAM clusters by DSN pattern.
Note: The .CSI implied suffix does not have to be included in the pattern.
Example: 
   OLIST  @LISTZ,SYS
   OLIST  @LISTZ,FMN*V6