Input Requirements

COBOL source program requirements

One execution of the Program Processor requires as input a single, complete COBOL source program. The program must meet the following requirements:

The program must be in a form suitable for COBOL compilation. Programs containing COBOL COPY statements are expanded automatically. The library member being copied must contain the 01 level description.
If the program contains embedded CA IDMS/DB navigational DML commands, it must be run through the DMLC processor before being input to the Program Processor. The DMLC processor changes DML commands to COBOL comments and generates CALLS, as appropriate, for requesting database services. The file output from the DMLC processor can be input to the Program Processor.
If the program resides in a library in compressed format, it must be run through the appropriate librarian utility to expand it into standard 80-character format before being input to the Program Processor. Output from the librarian utility can be input to the Program Processor.

z/VSE considerations

Note that z/VSE users can copy source code input to the Program Processor from a source statement library by using the =COPY facility. To use this facility, specify the member containing the source code in the following syntax:

►►── =COPY IDMS ─┬──────────────────────┬─ member-name ───────────────────────►◄
                 ├─ sublibrary-name. ─┬─┘
                 └─ A. ◄ ─────────────┘

If member-name is not in the A. sublibrary, specify the sublibrary (usually C.) name. Note that if a private source statement library is used to store member-name, the DLBL file type must be specified as DA at run time.

An example of the use of this statement is shown below:

=COPY IDMS C.PRANDEM1

Other input form

The Program Processor accepts one other form of input: the parameter statement. This statement specifies override processing options for executing the Program Processor. The following table is a summary of the options available with this statement. For syntax and rules, see the Parameter Statement later in this chapter.

Note: For z/OS clients, parameters can be specified more conventionally in the execution JCL by using the PARM clause of the EXEC statement.

Runtime Options for the Program Processor

The Program Processor operates with the default options listed in effect unless override options are specified.

Parameter	Default Option	Override Option
SYSREF/NOSYSREF	SYSREF—The data usage file is to be produced	NOSYSREF—The data usage file is not to be produced
SOURCE/NOSOURCE	NOSOURCE—The COBOL source program is not to be listed	SOURCE—The COBOL source program is to be listed
SUMM/NOSUMM	SUMM—The Management Summary Report is to be printed	NOSUMM—The Management Summary Report is not to be printed
DMAP/NODMAP	DMAP—The File and Record Layouts Report is to be printed	NODMAP—The File and Records Layout Report is not to be printed
DXREF/NODXREF	DXREF—The DATA DIVISION Cross-Reference Report is to be printed	NODXREF—The DATA DIVISION Cross- Reference Report is not to be printed
DIAG/NODIAG	DIAG—The Diagnostic Report is to be printed	NODIAG—The Diagnostic Report is not to be printed
ANS/ANS68/ ANS74/NOANS	NOANS—ANS diagnostics are not to be included in the Diagnostic Report	ANS—All diagnostic messages are to be included in the Diagnostic Report ANS68-Only ANS 1968 diagnostic messages are to be included in the Diagnostic Report ANS74-Only ANS 1974 diagnostic messages are to be included in the Diagnostic Report
FLO/NOFLO	FLO—FLO diagnostic messages are to be included in the Diagnostic Report	NOFLO—FLO diagnostic messages are not to be included in the Diagnostic Report
NUM/NONUM	NUM—The line numbers present in the source program are to be used for referencing	NONUM-Line numbers are to be assigned sequentially to all lines in the source program for referencing