Cross Reference Processor › Parameter Statement

Parameter Statement

Specifies overrides

The parameter statement specifies override processing options for the Cross-Reference Processor.

Coding rules

The following rules apply to coding parameter statements.

• Parameter statements, if used, must be included at the beginning of the file of control statements.
• Multiple statements can be entered.
• Statements can be coded in positions 1 through 72.
• Options can be specified in any order, with one or more options per statement and at least one blank or comma between specifications.
• If an option requires a list of information, the list must follow the option keyword immediately on the same statement. If the list must be continued to a new line, the option keyword must be repeated. For the PROGRAM-ID option, source-program-name (see syntax below) must also be repeated when a list of new names is being continued.

Syntax

►►─┬────────────────┬─────────────────────────────────────────────────────────►
   ├─ FILler ─────┬─┘
   └─ NOFiller ◄ ─┘

 ►─┬───────────────┬──────────────────────────────────────────────────────────►
   ├─ REfonly ◄ ─┬─┘
   └─ NORefonly ─┘

 ►─┬────────────────────┬─────────────────────────────────────────────────────►
   ├─ DICtionary ─────┬─┘
   └─ NODICtionary ◄ ─┘

 ►─┬─────────────────────────────────────────────────────┬────────────────────►
   │           ┌─────────────────────────────────────┐   │
   ├─ LIBrary ─▼── member-name ─┬──────────────────┬─┴─┬─┘
   │                            └─ = program-name ─┘   │
   └─ NOLIBrary ◄ ─────────────────────────────────────┘
 ►─┬────────────┬─────────────────────────────────────────────────────────────►
   ├─ DISk ◄ ─┬─┘
   └─ NODISk ─┘

 ►─┬─────────────────────────┬────────────────────────────────────────────────►
   ├─ MEMber-name-is-id ◄ ─┬─┘
   └─ NOMember-name-is-id ─┘
 ►─┬───────────────────────────────────────────────────────────┬──────────────►
   │              ┌──────────────────────────────────────────┐ │
   │              │                        ┌───── , ──────┐  │ │
   └─ PROgram-id ─▼── source-program-name ─▼─ = new-name ─┴──┴─┘
 ►─┬──────────────────────────────┬───────────────────────────────────────────►◄
   ├─ LIMit = ─┬─ 10 ◄ ───────┬─┬─┘
   │           └─ list-limit ─┘ │
   └─ NOLIMit───────────────────┘

Parameter list

FILler/NOFiller

Specifies whether the System Data Cross-Reference Report is to include data elements named FILLER, as follows:

• FILLER—Data elements named FILLER are to be included in the Syst em Data Cross-Reference Report.
• NOFILLER (default)—Data elements named FILLER are not to be included in the System Data Cross-Reference Report.

REfonly/NORefonly

Specifies whether the System Data Cross-Reference Report is to include only the data items referred to by a PROCEDURE DIVISION statement, as follows:

• REFONLY (default)—Only those data items referred to be a PROCEDURE DIVISION statement are to included in the System Data Cross-Reference Report.
• NOREFONLY—All data items are to included in the System Data Cross-Reference Report. Note that this parameter does not affect the inclusion of data items named FILLER.

DICtionary/NODICtionary

Specifies whether to print the Dictionary of Data Names Report, as follows:

• DICTIONARY—The Dictionary of Data Names Report is to be printed.
• NODICTIONARY (default)—The Dictionary of Data Names Reports is not to be printed.

LIBrary/NOLIBrary

Specifies information about the data usage files to be input to the DDDL Generator, as follows:

• LIBRARY identifies the data usage file. Each occurrence of member-name identifies a data usage file. All member names specified must be members of the same partitioned data set (z/OS) or source statement library (z/VSE). The optional entry, program-name, can be specified for any member name and overrides the use of the member name as the program ID on the generated ADD PROGRAM syntax.

  LIBRARY must always be specified with NODISK (see below) if all of the data usage files are stored in a partitioned data set (z/OS) or source statement library (z/VSE). It can be specified with DISK if data usage files are to be read from both a sequential data set, and partitioned data set (z/OS) or a source statement library (z/VSE).

• NOLIBRARY (default) specifies that data usage files are not to be read from a partitioned data set (z/OS) or source statement library (z/VSE). If the default of NOLIBRARY is taken, then the default of DISK (see below) must also be taken.

DISk/NODISk

DISK/NODISK are options that are used with LIBRARY/NOLIBRARY, as follows:

• DISK (default) specifies that data usage files are to be read from a sequential data set. DISK must always be specified with NOLIBRARY. DISK can be specified with LIBRARY if the data usage files are to be read from both a sequential data set and a partitioned data set (z/OS ) or source statement library (z/VSE).
• NODISK specifies that data usage files are not to be read from a sequential data set. LIBRARY (see above) must be specified with NODISK if all of the data usage files are stored in a partitioned data set (z/OS) or source statement library (z/VSE).

MEMber/NOMember

Specifies the source of the program IDs to be used on reports, as follows:

• MEMBER-NAME-IS-ID (default)—All of the member names supplied with the LIBRARY parameter are to be used as program IDs on the reports. Note that once member names are assigned as program IDs with this parameter, member names must also be used for program IDs on selection statements.
• NOMEMBER-NAME-IS-ID—The program ID specified in the PROGRAM-ID paragraph in the COBOL source program is to be used as the program id on the report.

Note: To guarantee unique identification of all programs whose data usage files are stored in a partitioned data set or source statement library, operate under the default MEMBER-NAME-IS-ID and specify the LIBRARY and NODISK parameters. To guarantee unique identification of all programs whose data usage files are stored in sequential data sets, use the PROGRAM-ID parameter described below, as needed.

PROgram-id

Provides unique program IDs for source programs that have the same name (that is, duplicate names in their internal PROGRAM-ID paragraphs) or changes an internal PROGRAM-ID name to another name for printing in the reports. This parameter is only used with data usage files that are stored in sequential data sets.

Source-program-name specifies the source PROGRAM-ID name that is to be changed. Occurrences of new-name specify the names that will be assigned sequentially whenever the common PROGRAM-ID name (that is, source-program-name) appears in the input data usage files. Source-program-name = new-name can be repeated to name other PROGRAM-ID names and their associated new names.

Note: Whenever internal PROGRAM-ID names are changed in this way, the new names must be used for specifying program-ID on selection statements.

LIMit/NOLIMit

Establishes the maximum number of reference statements per data item to be listed completely in the System Data Cross-Reference Report, as follows:

• LIMIT=10 (default)/list-limit—To be listed are complete reference statements including line number and text for each data item up to the default limit taken (10) or the limit specified. When the limit is reached, only line numbers are listed for the remaining references to the data item. Limit=O specifies that only line numbers are to be listed for all references to the item.
• NOLIMIT—To be listed are the line numbers and statements for all references to all data items.