Version 4.2.6 for Mainframes
 —  Utilities  —

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 or FIND 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,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 Debug Environments

NATPATH DEBUG
LIBRARY library-name

DBID dbid [FNR fnr]

[NAME vsam-name] [CIPHER cipher]

PASSWORD
PSW

password

Natural-Related Profiles

NATPATH PROFILE

DBID dbid [FNR fnr]

[NAME vsam-name] [CIPHER cipher]

PASSWORD
PSW

password

Natural-Related DL/I Subfiles

NATPATH SUBFILE

DBID dbid [FNR fnr]

[NAME vsam-name] [CIPHER cipher]

PASSWORD
PSW

password

FDTs

FDT

Top of page

Syntax of object-name-description

The syntax diagrams that apply toobject-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]

DDMs

object-name

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 Debug Environments

object-name

Natural-Related Profiles

object-name [ OBJTYPE profile-type]

Natural-Related DL/I Subfiles

object-name [ OBJTYPE subfile-type]

FDTs

DBID dbid FNR fnr [CIPHER cipher]

PASSWORD
PSW

password

Top of page

Example of an Object List

The follwing 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
  )

Top of page