Object List - LIST Workplan

An object list is a Workplan of the type LIST, which specifies object selection criteria for the objects to be processed in the UNLOAD, LOAD, FIND or DELETE command. An object list can be used as an alternative to the select-clause and the SELECTION Workplan.

The following syntax applies to an object list:

TYPE LIST  

../graphics/cbo2.gif

object-type-and-location (object-name-description ...)

../graphics/cbc2.gif

...

The syntactical options are explained in the following section. The keywords and variable values contained in the syntax diagrams shown in this section represent parameters that are used to specify object selection criteria. If indicated, a variable value must be supplied with a keyword. Each syntax element (except for the ones enclosed in parentheses) must start on a new line and end on the same line.

For explanations of the keywords contained in the syntax diagrams, refer to the section select-clause.


Syntax of object-type-and-location

The syntax diagrams that apply to object-type-and-location are shown in the following section.

Natural Objects and DDMs

LIBRARY library-name

DBID dbid FNR fnr [NAME vsam-name] [CIPHER cipher]

PASSWORD
PSW

password

[ OBJTYPE group-type]

Notes:

  1. No ranges are allowed for library-name.
  2. For DDMs on mainframe platforms,OBJTYPE must be set to D.

Natural System Error Messages

ERROR NATERROR
 

DBID dbid FNR fnr [NAME vsam-name] [CIPHER cipher]

PASSWORD
PSW

password

Natural Command Processor Sources

PROCESSOR ncp-library-name
 

DBID dbid FNR fnr [NAME vsam-name] [CIPHER cipher]

PASSWORD
PSW

password

Note:
No ranges are allowed for ncp-library-name.

Natural-Related Objects

NATPATH natural-path-name

External Files

PATH external-path-name

FDTs

FDT

Syntax of object-name-description

The syntax diagrams that apply to object-name-description are shown in the following section:

Natural Objects

object-name [SCKIND object-kind]

error-number [ SLKIND message-type] [ LANGUAGE languages]
FMNUM error-number-from TONUM error-number-to [SLKIND message-type] [LANGUAGE languages]

Natural System Error Messages

error-number [ SLKIND message-type] [ LANGUAGE languages]

FMNUM error-number-from TONUM error-number-to [ SLKIND message-type] [ LANGUAGE languages]

Natural Command Processor Sources

object-name

Natural-Related Objects

related-object-name

External Files

external-file-name

FDTs

DBID dbid FNR fnr [CIPHER cipher]

PASSWORD
PSW

password

Example of an Object List

The following is an example of a Workplan of the type LIST:

TYPE LIST
  LIBRARY LIB-1 OBJTYPE N    /* process Natural objects from library 'LIB-1'
   ( A* SCKIND S             /* all sources objects whose names start with 'A'
  B1                         /* source and/or cataloged object of  'B1'
  CDE> SCKIND C )            /* all cataloged objects with names greater than/equal to 'CDE'
  /*                         /* comment line
  LIBRARY LIB-2              /* process Natural objects from library 'LIB-2'
                             /* including error messages and shared resources
  ( *                        /* all source and/or cataloged objects
                             /* including shared resources
  FMNUM 1 TONUM 100          /* error messages from 1 to 100
  )