Customizing Control-M JCL Verify
Control-M JCL Verify Customization Considerations
CTJPARM is the Control-M JCL Verify source parameter member (located in the IOA.PARM library) that provides Control-M JCL Verify with installation parameters, as well as operational parameters.
This member can be maintained as a regular source member (for example, using the ISPF editor), or through ICE panels. BMC recommends that you use ICE to update the member, reducing the risk of making mistakes and entering invalid values.
For information on the customization processes, see the section on installing Control-M JCL Verify in the INCONTROL for z/OS Installation Guide: Installing.
Control-M JCL Verify Management Parameters
These parameters are found in Step 1.1 of Control-M JCL Verify customization:
Table 23 Control-M JCL Verify Management Parameters
Parameter |
Description |
---|---|
DSNACCSS |
Verifies that the owner of the job has access privileges to the datasets used in the job. Valid values are:
The required access privilege (for example, read and update) is verified according to the DISP parameter coded in the DD statement. If the user is not specified one of the following users are verified: when a JCL job is verified - the user that invoked Control-M JCL Verify when a Control-M job definition is verified - the Control-M job owner The verification is performed by the security products supported by IOA (for example, RACF, CA-Top Secret, and CA-ACF2). If the JCL verification is performed while editing a job member (during the edit JCL function), the access privileges of the Control-M job owner is verified. |
DSNEXIST |
Verifies the existence of the datasets referred to in the job. Valid values are:
|
JESTTMNT |
Verifies that JES2 and JES3 statements can be used in the job. Valid values are:
|
PGMCHECK |
Verifies that the PGM load modules used by the job exist and can be found in the conventional search order (as follows: steplib, joblib, linklist…). Valid values are:
|
SITESTDR |
Verifies that site standard rules can be used for JCL verification. Valid values are:
|
SUPUTIL |
Verifies utilities, such as IEBGENER, IEBCOPY, and SORT. Valid values are:
|
RMTUSER |
Remote verification user ID. Defines the user ID that will be used when a JCL verification request is received from a remote node (i.e. a verification request from a Control-M JCL Verify monitor running on an LPAR other than the local one) and the user ID that issued the verification request on the remote note is undefined in the local security system. RMTUSER must be a valid user ID and have maximum of 8 characters. If omitted, the remote verification request will fail if the requester user ID from the remote node is undefined in the local security system. Optional. |
SUPDB2 |
Controls activation of DB2 support. Valid values are:
|
DB2SYS |
Default DB2 subsystem ID. The value specified is used when the DSN command does not include the SYSTEM parameter, and you do not want Control-M JCL Verify to use the default DB2 subsystem ID specified in the DSNDECP module. Default value - None |
DB2PLAN |
Control-M JCL Verify DB2 plan name. Name of the plan used by Control-M JCL Verify to verify the status of the user's plans. The name specified here must match the name on the BIND and GRANT EXECUTE commands in the CTJBIND job. Default value - CTJDB2 |
CTMVARS |
Resolves Control-M AutoEdit variables in the job. Valid values are:
|
CTMCJCLI |
Determines whether to handle Control-M conditional JCL statements. Control-M conditional JCL statements are conditionally submitted by Control-M based on the resolution of %%IF, %%ELSE, and %%GOTO statements. Valid values are:
|
MSGLEVEL |
Specifies the minimum severity of messages to be issued. Messages with lower severity than specified are not printed and do not affect the final return code (RC). Valid values are:
|
RULETRAC |
Enables Rule Trace. Issues a message with the rule name, rule member, and environment before executing a rule.
|
JREPPREF |
Defines a prefix for a flat file that contains saved reports. Up to 19 characters. Besides this prefix, the file name also includes the date and time when saved and the name of the verifying JCL. |
JREPVOL |
Defines the VOLUME where reports are saved. To use SMS to manage the saving location, leave this parameter blank. If you specify a value for JREPVOL, you must also specify a value for JREPUNIT. |
JREPUNIT |
Defines the UNIT where reports are saved. To use SMS to manage the saving location, leave this parameter blank. |
SUMMFRMT |
Display format for the message summary section. Valid values are:
Consisting of 2 lines per message - First line - type of message and label - Second line - message text and Message ID (optionally, depending on parameter MSGID below)
|
MSGID |
Display Message ID. Valid values are:
|
XCF |
Use XCF for inter-Plex communication. Valid values are:
|
XCFGROUP |
CTJ monitors XCF communication group. Default value is: @CTJMON@ |
AROUTE |
Enable Auto Routing. Valid values are:
|
J2GUSEJ |
Use JES node name as the GATE node name if not explicitly resolved by the CTJJ2G member. Valid values are:
|
CNDALC |
Conditional allocation considerations. Mandatory. Valid values are:
|
EXPREOJC |
Verify that no EOJ card (line begins with: //) appears anywhere in the external procedures used by the job, with the exception of the last card. Valid values:
Setting this parameter to Y might impact the performance because the verification process will be running longer. |
RFBRKEY |
Split positional sub-parameters of JCL keywords. Mandatory. Valid values are:
Determines whether positional sub-parameters of JCL keywords are continued on an additional line in the reformat process, when the COLS range defined is exceeded. This parameter affects keywords such as DISP and SPACE, but does not have an impact on keywords that are not sub-parameters, such as DCB. |
STMAXCPU |
The maximum CPU time, in seconds, that can be used by a session to process one JCL statement. Valid values: 1–20 Default: 10 seconds |
CMNTPOS |
Where comment lines are to be positioned in JCLs that are enforced or reformatted:
|
For information about other Control-M JCL Verify parameters that may be specified during a customized installation, see the chapter about installing Control-M JCL Verify in the INCONTROL for z/OS Installation Guide: Installing.