Setting additional CA Jobtrac rules

This procedure describes how to set additional CA Jobtrac rules.

After you have imported your data, you can modify conversion rules by setting general rules and Field Editor rules.

Before you begin

Ensure that the Conversion Settings window is open. For more information, see Modifying conversion settings.

To set additional CA Jobtrac rules:

1. From the Additional Jobtrac Rules tab, type or select the Jobtrac rules as described in Additional Jobtrac rules.

   The following table describes the additional Jobtrac rules parameters.

   Parameter	Description
   Convert DS jobs	Enables you to perform a conversion of the Distributed Systems (DS) job definition by selecting the Convert DS jobs checkbox. In the Date format field, you can select how to view the date through either ddmm or mmdd (default). Convert DS jobs check box to perform a conversion of the DS jobs.
   Conditions	JOBA_JOBB: Enables you to define how two jobs are connected by creating unique condition in the format: JOBA_JOBB. Select the Cleanup conditions check box to delete the condition after the next job has finished running. JOBA_OK: Enables you to set a successful dependence condition between many jobs according its end status. For more details see Job Dependencies in Using Control-M.
   Start Day of the Week	Enables you to select the start day of the week for scheduling. The value is used for Date Scheduling parameters Ln, -Ln, Dn, -Dn, DnPi, -DnPi, LnPi, -LnPi, DnWm. NOTE: BMC Software recommends that you do not change this parameter once Control-M has been in operation in a production environment, as it may affect scheduling.
   New Day time	Enables you to type the value in the New Day time value specified in CTMPARM field. NOTE: When a positive number is specified as a New day time value, the conversion avoids scheduling date discrepancies for jobs that are scheduled by Jobtrac between Midnight and the specified Newday time by moving them one day earlier. When a negative number is specified, jobs that are scheduled by Jobtrac between the specified New day and Midnight are scheduled one day later
   Customize Control-M jobname	Use Alternative JCL member name as JOBNAME: Enables you to use the Alternate JCL member name (if it exists) as the jobname, instead of the event name for the converted jobs and their connecting conditions.
   SCL libraries processing	Process each SCL library independently: Enables you to process each SCL library separately. By default, the Conversion Tool loads and processes all of the libraries as a single repository. By selecting the checkbox you can process each SCL library separately, which is useful where SCL libraries are large, and it is not possible to convert all libraries together. If there are cross SCL dependencies they are not resolved as part of the conversion. A manual adjustment has to be made.

2. To set mainframe rules, select the Mainframe Editor tab. Type the following parameters:
   • Jobtrac Additional Rules

     The following table describes the Jobtrac Additional Rules parameters in the Mainframe Editor tab. For more information, see Setting additional CA Jobtrac rules.

     Parameter	Description
     SCHED TAB – Scheduling Table Library	Defines the Control-M scheduling table that stores job definitions. Default value: CTM.SCHEDULE. NOTE: You can use the Scheduling Table Library that was allocated during Control-M installation. You must verify that the Scheduling Table Library is allocated in the Mainframe.
     OVERLIB – JCL Over Lib	Defines the value as OVERLIB for converted jobs. Default value: CTM.OVERLIB. NOTE: You must verify that the JCL Overlib Library is allocated in the Mainframe.
     INCLIB – Control-M Include Library	Defines the value as INCLIB for converted jobs. Default value: CTM.INCLIB. NOTE: You must verify that Control-M Include Library is allocated in the Mainframe.
     JCLLIB – Alternate Memname	Defines the value of an additional Memname, which is used for saving converted jobs. Default value: CTM.JCLLIB. NOTE: You can use the JCL Library for alternate members allocated during Control-M installation. You must verify that the Control-M JCL Library for alternate members is allocated in the Mainframe.
     CTODSN – Control-O rule library	Defines the Control-O rules library containing Dataset and messages triggering events for ADR, AMR and SCS. Default value: CTM.CTODSN. NOTE: You can use the Control-O rules library allocated during Control-O installation. You must verify that Control-O rules library is allocated in the Mainframe.
     IOAENV - Library full path	Defines the name of the IOA/Control-M production environment’s IOAENV library.
     CMEM – CMEM rule library	Defines the CMEM rules library containing Job Arrival events for RESOURCE file conversion. Default value: CTM.CMEM. NOTE: You must verify that the CMEM rules library is allocated in the Mainframe.
     Control-O run JCL library	Defines the JCL library name containing JCL files running from Control-O rules. Default value: CTM.CTO.JCL. NOTE: You can use the Control-O JCL library allocated during Control-O installation. You must verify that Control-O run JCL library is allocated in the Mainframe.
     Control-O rule user	Defines the user name for invoking the CONTROL-O rules. Default value: USERNAME. Enter a maximum of 8 characters.
     (Mandatory) JOB CARD - Job card for output JCL	Enables you to use job cards for the output JCL that is created to run at the end of the conversion for returning the converted data to the appropriate files. In the Job Card field, enter the job card that you want, for example, //CTMJOB JOB. You can also click Edit to enter multiple job cards.

     For JCL parameters and Advanced parameters, see JCL parameters and Advanced Parameters.

   • JCL parameters

     The following table describes the JCL parameters for Defining new Jobtrac conversion data and Setting additional CA Jobtrac rules.

     Parameter	Description
     JCL created file (project set up only)	(Mandatory) Defines a filename for the JCL file created on the Mainframe.
     Output data file name (project set up only)	(Mandatory) Defines a filename for the output file or use the default CTM.JBT.OUT.
     Job card (project set up only)	(Mandatory) Defines the job card that you want, for example, //COLLECTED JOB. You can also click to enter multiple job cards.
     Allocate converted JCL libraries (Mainframe Editor rules only)	Enables you to allocate new JCL libraries. If this parameter is not selected, the Conversion Tool overrides the original JCL libraries.
     JCL library Prefix (Mainframe Editor rules only)	(Mandatory) Defines a prefix value. For example, CTM.
     UNIT	Defines the volser unit.
     VOLSER	Defines the volume on which to allocate the output file.
     SMS DATA CLASS	Defines the SMS data class
     SMS STORAGE CLASS	Defines the SMS storage class
     SMS MANAGEMENT CLASS	Defines the SMS management class
     Primary Allocation (CYL):	(Mandatory) Defines a value, for example, 100.
     Secondary Allocation (CYL)	(Mandatory) Defines a value, for example, 100.
     Number of Directory Blocks (Mainframe Editor Rules only)	Defines the number of directory blocks allocated to the converted JCL library. This should must be the same as the number of directory blocks in the original Jobtrac JCL library.

   • Advanced Parameters

     The following table describes the Advanced parameters in the Mainframe Editor tab. For more information, see Setting additional CA Jobtrac rules.

     Parameter	Description
     Prefix for Maybe condition	Defines an in condition dependency, which is required only on days when a job is released as an out condition.
     Prefix for Global Conditions added by MF	Defines Global conditions that are propagated from Mainframe Control-M to Distributed Control-M.
     Prefix to Global Conditions added by DS	Defines Global conditions that are propagated from Distributed Control-M to Mainframe Control-M.
     Prefix for Global Conditions added by MF and DS	Defines Global conditions that are propagated in both directions between Mainframe and Distributed Control-M.
     Control-R installed	Enables you to select if Control-R is installed on the mainframe
     Automatic restart	Enables you to automatically restart the mainframe
     MAXCC:	Defines the Maximum condition code for OK status. Valid range: 0-4095 (integers).
     Sysout From Class	Defines a blank space or single character to specify the Sysout class.
     Sysout To Class	Defines a blank space or single character to specify the Sysout class. The Sysout is moved to the end of the job. The default value is ‘*’.
     Sysout option	Defines the Sysout action when a job finishes. Valid values: Release Delete None

     For Jobtrac additional rule parameters and JCL parameters, see Jobtrac mainframe parameters and JCL parameters.

3. Click Next to start the conversion.

   A message appears confirming that conversion is in progress. The results appear in the Conversion Results window, as described in Conversion results.

   The conversion rules are automatically saved after you run the conversion. The set of conversion rules appears in the Conversion rules list in the Run Conversion window. You can use these rules in future conversions.

   NOTE: When there are DS and MF jobs:

   • If Convert DS jobs is not selected, only MF jobs are converted.
   • If Convert DS jobs is selected, both MF and DS jobs are converted.