IBM ISPF Productivity Tool, Version 7.1

OLIST command

The OLIST command invokes an Objects List, or a list of referenced objects lists.

Syntax


>>-OLIST--+--------------------------------+-------------------><
          +-OLIST_name---------------------+   
          +-DD=-+--------+-----------------+   
          |     '-ddname-'                 |   
          +-DSNpatt-+----------+-----------+   
          |         '-,VOLpatt-'           |   
          +-level--------------------------+   
          '-special_list,special_parameter-'

Operands

OLIST_name: The name of an OLIST to be displayed or created. The name of an OLIST can be from one to eight characters; it must conform to the syntax of a member name.
DD=ddname: When ddname is specified, it displays an object list of all data sets allocated to that ddname. If not specified, all currently allocated data sets are displayed.
DSNpatt: A data set name using the wildcard characters "%" and "*".
VOLpatt: A volume name using the wildcard characters "%" and "*".
level: The level qualifiers for the data set names. For example, for a fully-qualified data set name of ACCOUNTS.PAYABLE.COBOL, the level could be ACCOUNTS.PAYABLE or ACCOUNTS.
special_list: One of the @LISTxxx options. See examples in the table in the Usage Notes.
special_parameter: The parameter relevant to the special list option.

Usage notes

Processing depends on the form of the command, as shown below. (In this table, newlist is an OLIST that does not already exist, oldlist is an OLIST that already exists. VOLpatt and DSNpatt are as defined above.)

Form of Command	Processing
OLIST	Invoke the default (last) referenced permanent OLIST.
OLIST *	Displays the list of permanent objects lists.
OLIST oldlist	The OLIST "oldlist" is displayed.
OLIST newlist	A new OLIST with the name "newlist" is created. "newlist" is checked to see if it matches a first-level qualifier. If so, the OLIST is filled with all catalog entries that have "newlist" as their first-level qualifier. If not, the OLIST is prefilled with the names of the ISPF libraries on the EDIT entry panel and DSLIST entry panel.
OLIST /	Opens a temporary OLIST and immediately executes the POPULATE command to prompt for sources of names to go into this list.
OLIST DSNpatt	A temporary OLIST is displayed listing all data sets in the catalog matching pattern "DSNpatt".
OLIST DSNpatt,VOLpatt	Invoke a temporary list showing catalogued data sets matching the specified DSN pattern (with wildcards). If a volume pattern is specified, only data sets catalogued to the specified volumes are listed.
OLIST @DD,ddname	Invoke a temporary OLIST displaying allocated data sets. If a ddname is specified, only libraries allocated to the specified ddname are listed.
OLIST DD=	Open a temporary OLIST with all currently allocated data sets.
OLIST DD=ddname	Open a temporary OLIST with all data sets allocated to that ddname.
OLIST @H	Display a temporary OLIST showing the history list (the list of last 100 data sets referenced by the user).
OLIST @LISTB,DSNpatt	Opens a temporary OLIST showing catalogued data sets matching the specified data set name pattern that are Generation Data Groups.
OLIST @LISTE,DSNpatt	Opens a temporary OLIST showing catalogued data sets matching the specified data set name pattern that are PDSE libraries.
OLIST @LISTF,DSNpatt	Opens a temporary OLIST showing catalogued IBM BookManager Book-Shelf files matching the specified DSNpatt. (.BKSHELF may be omitted from DSNpatt.)
OLIST @LISTGDG,DSNpatt	Opens a temporary list of generation data sets whose GDG base name is matching the specified pattern. The OLIST shows both the exact data set name as it appears in the VTOC and the relative generation number from the catalog.
OLIST @LISTI,DSNpatt,VOLpatt	A combination of OLIST DSNpatt,VOLpatt, followed by "* INFO". Invoke a temporary list showing catalogued data sets matching the specified data set name pattern. If a volume pattern is specified, only data sets catalogued to the specified volumes are listed. Then issues an OLIST INFO command on each data set to display the attributes of the data set. Issue a QUIT at any point to stop further attribute displays.
OLIST @LISTK,DSNpatt	Opens a temporary OLIST showing catalogued IBM BookManager Book files matching the specified DSNpatt. (.BOOK may be omitted from DSNpatt.)
OLIST @LISTM,DSNpatt OLIST @LISTARC,DSNpatt	Opens a temporary OLIST with the list of migrated (or archived) data sets matching the specified data set name pattern. Both commands are similar and are offered for installations with HSM, ASM2, or DMS systems.
OLIST @LISTP,DSNpatt	Opens a temporary OLIST showing catalogued data sets matching the specified volume pattern that are system page-space data sets.
OLIST @LISTS,listtype	Opens a temporary OLIST displaying system data sets. The listtype parameter may be used to restrict the display to one of the four list types available: LPALIB, LINKLIST, APFLIST, and PARMLIB. If listtype is omitted, a menu of choices is displayed.
OLIST @LISTT,DSNpatt	Opens a temporary OLIST showing catalogued data sets matching the specified data set name pattern that are Tape data sets.
OLIST @LISTV,VOLpatt,DSNpatt	Opens a temporary OLIST based on the VTOC entries matching the specified volume pattern and the specified DSN pattern. Wildcards are allowed in both patterns, practically offering a data-set search capability
OLIST @LISTVS,DSNpatt	Opens a temporary OLIST showing catalogued data sets matching the specified data set name pattern that are VSAM clusters.
OLIST @LISTZ,DSNpatt	Opens a temporary OLIST showing SMP/E Zone clusters matching the specified DSNpatt. (.CSI may be omitted from DSNpatt.)

Your default OLIST is the last permanent OLIST displayed. The first time you invoke OLIST, or if you have deleted the OLIST last used as the default, your default is an OLIST with the name set to your USERID. Processing is the same as if you specified the name explicitly. Your USERID is checked to see if it matches a first-level qualifier. If so, the OLIST is filled with all catalog entries that have your USERID as their first-level qualifier. If not, the OLIST is prefilled with the names of the ISPF libraries on your BROWSE, EDIT, and VIEW, and DSLIST Entry Panels.

You can also explicitly set the OLIST that is displayed when OLIST is next invoked without any specifications. To do so, enter the line command NXT on the OLIST selection list panel.

To display a temporary OLIST of all data sets in the catalog matching a first-level qualifier, rather than to display an existing OLIST of the same name or to create a new (permanent) OLIST of that name, enter it with a period, like this:

    OLIST ACCOUNTS.

rather than

    OLIST ACCOUNTS

Examples

OLIST
OLIST *
OLIST LEDGER1
OLIST ACCOUNTS.%PAY*.COB*
OLIST TAXES*YEAREND*
OLIST SYS1.*,SYSR01
OLIST SYS1.*,*
OLIST @LISTV,SYS*,SYS1*MACLIB
OLIST @LISTM,SYS1.A*LIB
OLIST @LISTARC,SYS2.*
OLIST @LISTGDG,ACCOUNTS.TRANSACT
OLIST @LISTS,LPALIB
OLIST @LISTS,APFLIST
OLIST @LISTS,LINKLIST
OLIST @LISTS,PARMLIB
OLIST @LISTS,ALL

Feedback