Conversion Parameters
Table 3 Conversion Parameters
Parameter |
Description |
---|---|
ALLMSG |
Specifies whether all messages in the JCL conversion (JOB4) are to be printed. Valid values are:
|
CALPREF |
Calendar prefix for Control-M calendar names. Must be 5 characters or less in length. Names in certain forms must not be used, and these are discussed in Record Layout. Default: MCAL |
CLASBAR |
Specifies whether CA-7 CLASS Barrier support is to be implemented. For more information, see 12. CLASS and #RES. Valid values are:
|
CTDCOND |
Only applicable at sites where Control-D is installed. The user-text parts of the OUT conditions are added to job scheduling definitions when the DCAT basic scheduling parameter is specified in a job scheduling definition. Default: Blank, which indicates that no OUT conditions are to be added to the job scheduling definitions. For more information, see CATEGORY. |
CTRCONF |
Control-M/Restart confirmation parameter. If Control-M/Restart is installed, this parameter specifies whether manual confirmation is required before the job is scheduled for restart using the DO IFRERUN statement. Valid values are:
|
CYCFROM |
Option to set the Cyclic FROM parameter when a CA7 head-of-tree job is converted to a job flow in a cyclic table/folder in Control-M due to multiple SCHIDs with identical scheduling criteria and different start times. Valid values are:
|
DCTGRY |
Only applicable at sites where Control-D is installed. A character string to be searched for, starting in column 1, in the JCL of the job that precedes the Control-D Report Decollating Mission Category specification and identifies its position. Default: Blank, which indicates that no D-CAT basic scheduling parameters are to be specified in the job scheduling definitions being set up by the conversion tool. For more information, see CATEGORY. |
DELJOB |
Whether CA-7 jobs whose LAST RUN date is earlier than a date specified should be ignored by the conversion. Valid values are:
|
DIRMAX |
Maximum number of members in a CA-7 JCL library. The value you set for DIRMAX must be as small as possible without going below the actual maximum. Default: 10000 |
DSDSREQ |
Whether to convert DSN Requirements to an IN condition for distributed jobs when a non-zero LEADTM is specified in the DSN Requirement. Valid values:
|
DSFWCYC |
Whether the File Watcher process runs cyclically or as a single occurrence. Valid values:
Default: N |
ELAPSED |
Whether to create a SETVAR parameter in each job scheduling definition with the job's clock-time. Valid values are:
|
FLCLEAN |
Whether to perform folder-level condition cleanup.
|
FROMC |
Which of the held sysout classes must be requeued. Specify (Blank) if all held sysouts must be requeued. Default: (Blank) For distributed job definitions and when TOCLASS is (Blank) this parameter is ignored. |
HISTORY |
History Active Jobs file feature. Valid values are:
|
HOTSCH0 |
If the conversion tool
due to many CA-7 job definitions which
The current design of the conversion tool is to force these jobs to be considered head-of-tree jobs by creating 'phoney' schedule-ids (up to 255 schids depending on how many different schids appear in the LJOB report) in their reformatted (LJOB) definitions. This might cause a very large increase in the size of the CTMBLT file used in creating the intermediate scheduling table library (resulting in Sx37 ABENDs) and a large CPU and I/O overhead in merging these tables to form the final schedule lib. In addition, if any of the affected job flows contain cyclic sub-groups, then the number of CTMCA705-09W messages might also be greatly increased. If the CA-7 job definitions (mentioned above) which cause the problem also satisfy the following criteria:
then the user should consider setting the HOTSCH0 option to Y. This option causes the conversion tool to treat such jobs as if they were scheduled head-of-tree jobs with a schid of 000. This should eliminate most of the CTMCA705-09W messages (90% or more) and should substantially reduce the size of the CTMBLT file and the processing overhead in merging the tables into the final scheduling library. |
JCLIPLCE |
Determines how to convert JCL members. Valid values:
Default: N |
JESRPRT |
Specifies whether JES ROUTE PRINT JCL statements are to be converted to Control-M SYSOUT post-processing parameters. Valid values are:
|
JOBCLAS |
CA-7 JCL Job Class conversion. This parameter specifies whether JCL job classes are converted to Control-M Quantitative resources. For more information, see 27. JCL Job Class. Valid values are:
|
JOBMXOC |
Maximum number of occurrences of a job within a table. This parameter enables the control of application creation by the conversion tool for recursively-defined jobs. Valid values are from 1 through 99. Default: 5 |
KEEPOSTP |
Determines how to convert JCL members. Valid values:
Default: N |
LDTTHRSH |
Indicates how to convert CA-7 Lead time. The LDTTHRSH option is used to create a group of Boolean IN conditions all connected by OR operators for the job as follows: When LDTTHRSH=00 (default), then regardless of the job's Leadtime value, the only IN condition created is Copy
and a warning message is produced (when the Leadtime is not 00). When a job's Leadtime=mm and LDTTHRSH=nn (nn NOT 00) then the following pre-requisite conditions are created: Copy
otherwise a set of Boolean OR conditions are created as follows: Copy
|
LINMAX |
Maximum number of lines in a JCL member. Default: 5000. Ensure that this number is large enough to accommodate the growth of JCL members due to the insertion of Control-M AutoEdit statements by the conversion tool. |
LEADTM0 |
Whether to specify ODAT or **** as the date reference of Control-M conditions created from CA-7 job connection requirements which specify a lead time of 0. Valid values are:
Default: ODAT |
L2VARS |
For users who are running CA-7 release 3.1 or later, and have implemented CA-DRIVER only. CA-DRIVER provides various reserved-name variable parameters specifically for CA-7. These variables can be referenced in CA-DRIVER procedures, and values are automatically assigned when the variable is referenced during procedure expansion. Many of these variables can be automatically converted by the conversion tool, as follows. The CA-DRIVER variable is converted to a Control-M AutoEdit variable, and a Control-M SET VAR statement for the newly created AutoEdit variable is placed into the job scheduling definition of the invoking job to provide an initial value. The initial value is derived from the corresponding CA-7 job definition. The conversion supports the CA-DRIVER variables listed in Table 4, "CA-DRIVER Variables." For the definition of CA-DRIVER system variable and other CA-7 specific variables, such as &C_MONTH, &C_DAY, &C_DATE, &C_JDATE, &C_TIME, &C_L2SID, &C_L27#, and &C_L2JN, see the DAYMONTH member in the conversion source library. Since not all users utilize all the above variables in their CA-DRIVER procedures, this conversion parameter enables you to choose whether to create the corresponding SET VAR parameters in the job scheduling definitions, thereby preventing clutter in the job scheduling definitions. The choice is indicated by coding a positional Y (Yes) or N (No) value in the L2VARS parameter. The position of the Y or N corresponds to the position of the relevant variable in the list in Table 4, "CA-DRIVER Variables." For example, L2VARS=NNYYNNNNYN indicates that the only variables that will be automatically processed by the conversion tool are &C_L2RO, &C_L2CC, &C_L2DOT. Default: L2VARS=NNNNNNNNNN |
MAXGENT |
The maximum number of lines in a SMART Table Entity. Default: 5000. In general, the default value of this parameter should not be changed unless the CTMCA7V5-12S error message is displayed. In that event, the value of MAXGENT should be increased to approximately 5% of the value in the PARM parameter on the EXEC statement in STEP2 of JOB7. |
MAXCALS |
Maximum number of calendars contained in the AUXCAL file. Default: 5000 |
MSGAREP |
Determines how conversion messages are produced. Valid values:
Default: N |
MULTSCHD |
When a CA-7 job definition which specifies multiple schedule-ids which differ only in their time parameters (due-out, submit, start) will be converted to a Control-M cyclic or enhanced cyclic SMART Table depending on the setting of this option.
|
PJCLCNV |
Determines the scope of the JCL conversion performed. Valid values:
Note the following when value Y is chosen:
|
PNIBTSD |
Process Non-Instream Batch Terminal SYSIN Data indicator. Whether to convert CA-7 Batch Terminal Input commands, such as DEMAND, POST, and RESCHNG, that are not contained instream in the SYSIN DD statement of a CA-7 Batch Terminal Step (that is, are pointed to by a sequential file or a member of a PDS). Valid values are:
For sites where references to Batch Terminal commands are made from within JCL procedures, that is, the SYSIN DD statement does not appear in the JCL member being converted, you can run the JCL conversion (JOB3) against the affected procedure library. The following SYSIN PDS files are not processed:
|
PRVNCT2 |
Automatic setting of the PREVENT-NCT2 parameter. Valid values are:
This automatically prevents NOT CATLGD 2 situations from occurring in non-restarted jobs, by causing the deletion of problematic data sets prior to job execution.
This parameter is ignored when Control-M/Restart is not installed. The Control-M/Restart PREVENT-NCT2 processing encompasses data sets with any DISP setting (not just DISP=NEW). Therefore, Control-M/Restart EXCLUDE DSN statements may be necessary for some data sets, such as data sets specifying DISP=(OLD,CATLG), for proper CA-11 emulation. |
REL |
The release of CA-7 from which you are converting, in the format xx.y (for example, 03.3). Default: 3.3 For pre-R3.1 specify 3.0. For 3.1 and 3.2 specify 03.1. From 3.3 to 11.2 specify 03.3. For 11.3 and above specify 11.3. |
RELEASE |
Sysout release specifies whether the job sysouts are released for printing after they are analyzed by Control-M, or are deleted. Valid values are:
|
SCHDMOD |
SCHDMOD CURRENT calendar indicator. Enables you to specify globally whether SCHDMOD CURRENT calendars are automatically placed into the job scheduling definitions for all applications. Valid values are:
For more information, see 13. SCAL and 12. CLASS and #RES. |
SFXCND |
A 3-character suffix for Control-M condition names for CA-7 job triggers and job connections. Default: "_OK" |
SFXDSN |
Suffix for Control-M condition names for CA-7 DSN job connection. This must be at least one character long. Default: "_DS" |
SFXGRP |
Suffix to be added to Control-M group names. Default: Null. |
SHOUTDL |
Destination for SHOUT WHEN LATE and SHOUT WHEN EXECTIME messages. For more information on valid values and the default, see SHOUTDT in this table. |
SHOUTDT |
Destination for SHOUT messages when a job failed. Valid values are:
For information about additional options, see SHOUT in the parameter descriptions chapter of the Control-M for z/OS User Guide. |
SHOUTE |
The text (up to 50 characters) of the SHOUT WHEN LATE * message that is sent when the job is still executing after its DUE TIME time has passed. Specify (Blank) to suppress the message. The default is: Copy
|
SHOUTL |
The text (up to 50 characters) of the SHOUT WHEN LATESUB message that is sent when the submission time for the job has elapsed. Specify (Blank) to suppress the message. The default is MEMBER %%JOBNAME IS LATE! |
SHOUTT |
The text (up to 50 characters) of the SHOUT WHEN NOTOK message that is sent when a job fails. Specify (Blank) to suppress the message. The default is: %%JOBNAME J%%JOBID ENDED NOTOK! |
SHOUTX |
A 2-digit value added to the weighted average elapsed runtime of the job and used to determine the Control-M SHOUT WHEN EXECTIME parameter. Specify (Blank) to suppress this message. Default: 05. For more information, see 38. SHOUT. |
STARTM |
When an SBTM CA-7 submit time is specified, it is always used as the Control-M FROM TIME. When the SBTM is not specified, the value of the STARTM parameter determines the FROM TIME, as follows:
|
STOPCYCL |
Whether to add a post processing statement: ONPGM STEP=ANYSTEP CODES=NOTOK DO STOPCYCL to terminate cyclic processing when a cyclic job ends NOTOK.
|
SUPMSG |
Whether messages are suppressed in JOB3. Valid values are:
|
SWLPROP |
Whether to propagate the SHOUT WHEN LATESUB message to all successor jobs of the head-of-tree job. Valid values are:
|
SYMETRIC |
Determines how to convert SYMETRIC schedules:
Default: CYC |
TAPE1 |
Control-M Quantitative resource name for the CA-7 TAPE1 resource, corresponding to the value of the NAME parameter of the CA-7 workload balancing TAPE1 macro. Default: TAPE1 To suppress creation of a TAPE1 resource, set TAPE1 to (Blank). |
TAPE2 |
Control-M Quantitative resource name for the CA-7 TAPE2 resource, corresponding to the value of the NAME parameter of the CA-7 workload balancing TAPE2 macro. Default: TAPE2 To suppress creation of a TAPE2 resource, set TAPE2 to (Blank). |
TOCLASS |
New output class to which Control-M is to requeue the JCL MSGCLASS sysouts of the job. Valid values are:
This option is ignored for CA-7 distributed job definitions, then specify TOCLASS as blank. For more information, see DO SYSOUT. |
UNTIL |
Time Until Indicator. The conversion tool does not set the Control-M TIME UNTIL scheduling parameter unless you set the UNTIL conversion parameter to >. Valid values are:
For more information, see the TIME parameter in the Control-M for z/OS User Guide. |
UPDLCLPR |
Whether to allow or prevent updating of production JCL libraries.
|
USERLEN |
When the USEROPT conversion parameter is specified as OWNER, JOB, APPL, JCLUSER, JCLGRP, or NOTIFY, this parameter specifies how many characters of the specified parameter are used for the Control-M OWNER parameter. Default: 8 |
USEROPT |
Source for the Control-M OWNER job scheduling parameter for mainframe job definitions. The OWNER parameter is useful for implementing security checking by various Control-M components. In the following description of values, n is set by the USERLEN parameter, which is described elsewhere in this table. Valid values for USEROPT are:
The following options create an OWNER parameter derived from the JCL JOB statement of the job.
For these options, an OWNER ID of NOUSER, NOGROUP, or NONOTIFY is specified for jobs whose JCL member cannot be found and for jobs whose JOB statement does not contain a USER, GROUP, or NOTIFY parameter, respectively. |
|
If you are using the ACF2 security product, you can use the following option to create an OWNER parameter derived from the ACF2 JOBFROM or LOGONID JCL statements:
For this option, OWNER ID is set to NOACF2 for jobs whose JCL member cannot be found and for jobs which do not contain a JOBFROM or LOGONID statement. For distributed job definitions, see 35. OWNER |
Table 4 CA-DRIVER Variables
No. |
Variable |
Description |
---|---|---|
1 |
&C_L2UID |
CA-7 user security identification. |
2 |
&C_L2SN |
Application system name. |
3 |
&C_L2RO |
Relational operator of the condition code (OR if step level #SCC statements are being used). |
4 |
&C_L2CC |
Job level condition codes, used to determine whether a job executes successfully. |
5 |
&C_L2PRY |
CA-7 workload-balancing job priority. |
6 |
&C_L2CLS |
CA-7 workload-balancing job class. |
7 |
&C_L2#T1 |
TYPE1 tape drives needed for the job. |
8 |
&C_L2#T2 |
TYPE2 tape drives needed for the job. |
9 |
&C_L2DOT |
Job due-out time of day, for a particular schedule ID. |
10 |
&C_L2MID |
Indicates on which CPU a job may or may not be scheduled. |