How to Use CA JCLCheck › Integrating Products › About External Variables › Control-M Parameters

Control-M Parameters

This topic contains the Control-M parameters and the following example:

• Sample Parameter Data Set

This procedure describes how to specify the parameters.

Follow these steps:

1. Specify the Control-M parameters in a sequential file (including partitioned data set member).
2. Start the parameters in column 1 and stop on or before column 71.
3. Specify the parameters in any order (there is no correct parameter order).
4. Specify comment lines (if necessary) by placing an asterisk (*) in column 1. Do not add comments to the right side of the parameter value.

For Control-M, two types of statements can be specified in the Resolve Parameters:

1. RESOLVE Parameters—required for resolve processing
2. CTMAESIM Options—passed to the CTMAES Program

The following parameters are the RESOLVE parameters:

RECORD

Informs CA JCLCheck to record the resolution session. The record data is written to the partitioned data set allocated in the RECORD DD statement. Allocate this file as a PDS whose DCB is LRECL=500, RECFM=FB, and DSORG=PO. Under EDCHEK and ISPF, the name of this file can be specified in the JCLUSRCM CLIST. In a batch job, the JCL deck must contain a RECORD DD statement.

Use this parameter only under the direction of CA Support.

Example: RECORD

RECORDSEQ

Informs CA JCLCheck to record the resolution session. The record data is written to a sequential data set allocated in the RECORDSQ DD statement. Allocate this file as a sequential file whose DCB is LRECL=500 and RECFM=FB. Under EDCHEK, a RECORDSQ DD statement must be allocated before calling CA JCLCheck. In a batch job, the JCL deck must contain a RECORDSQ DD statement. This option is not supported under the ISPF interface.

Use this parameter only under the direction of CA Support.

Example: RECORDSEQ

SOURCE=I|E

Identifies the source of the input JCL.

I—Internal—The JCL source is specified using CTMAESIM options (that is, LIBRARY/MEMBER or SCHDLIB/TABLE/JOB) in the resolve parameter file. CTMAESIM processes these options directly. This parameter is the default.

E—External—The input JCL comes from an external file that a SYSIN DD statement defines. The SYSIN must be a sequential file. Any CTMAESIM options that reference JCL that are found in the resolve parameter file are ignored.

Example: SOURCE=E

Use this parameter only in Batch.

ERES

Simulates EDCHK processing in batch and is intended for use only by CA Support. This parameter requires specially modified input JCL that is provided on the SYSIN DD statement. This parameter also requires the member name for the job that is specified on the JOBNAME() parameter on the EXEC statement.

Use this parameter only under the direction of CA Support.

Example: ERES

Use this parameter only in Batch.

JCLPRFX=

When SOURCE=E is used or the CTM Resolve option is used in EDCHEK (EJCK), a file is created to hold the JCL member. This file is deleted after CTMAESIM is called. The allocated file is named jclprfx.JCKTEMP. By default, the prefix jclprfx is the USER ID of the current user. The JCLPRFX option allows for an alternative file prefix to be specified. You can specify up to 17 characters.

Example: JCLPRFX=WORK.TEST

CTMPRINT

When the CTMAESIM program is called, a report is returned. By default, this report is examined for error messages that can be reported. This report includes, in addition to error messages, the complete resolved JCL for the job. By default, only error messages are returned for the job. Include this option if you would like to see the entire report.

Example: CTMPRINT

The following bullets describe the CTMAESIM options:

• CTMAESIM has options for selecting JCL needing resolution, and for setting parameters that can affect the parameter resolution.
• CTMAESIM allows JCL selection in two modes: Library and Scheduling. Some options are only used with a particular mode and other options that can be used with either mode. Common CTMAESIM parameters are discussed following this bullet. For a complete list of parameters available, see the section titled ‘CTMAESIM — Test AutoEdit Syntax’ in the CONTROL-M Utilities Guide.
• CA JCLCheck permits any valid CTMAESIM option in the RESPARMS file.
• The resolve option under EDCHEK (EJCK) only supports Library mode and provides the needed LIBRARY, MEMBER, and SUBMIT command options. Any Library mode or general option can be specified, except for LIBRARY, MEMBER, and the commands (SUBMIT, LIST, ...) that are provided. EDCHEK generates these statements to define the location of a temporary file containing the JCL that is being edited. If these restricted parameters are specified, they are ignored.
• In the CA JCLCheck ISPF panels, all valid CTMAESIM options can be specified in Library or Scheduling mode. Always specify the command field as SUBMIT. When any of the other command field values are specified CA JCLCheck changes these values to SUBMIT before calling the CTMAES utility. For example, LIST, SEND, or SUBSCAN.
• In a batch job, the RESPARM requirements depend on the setting of the SOURCE= parameter. When SOURCE=Internal is specified, then the same requirements that are described for the CA JCLCheck ISPF panels apply. When SOURCE=External or RESOLVE(CTM,NOPARM) is specified, then the same requirements that are described for EDCHEK apply. Note the added requirement that the SYSIN DD point to a sequential file containing the JCL to process.