Conversion Process Flow

This chapter includes the following topics:

Overview of Conversion Process Flow

This chapter describes in detail the components of the conversion process from the perspective of jobs, programs, and data sets.

A familiarity with the conversion process flow helps in understanding the conversion logic and the installation and operation steps discussed in Conversion Details.

The process is comprised of the following jobs:

Table 2 Jobs in the Conversion Process

Job

Description

JOB0

Packs, compresses, and uploads to the BMC FTP site the JOBTRAC files that will be used by the conversion

JOB1

Creates the Control-M table library, the CMEM rules table, and XML definitions

JOB2

Converts JCL members and JMF Variable Definition members and creates an INCLIB library

JOB3

Converts ADR and AMR tables and creates a Control-O Rules library

JOB0. Packs, Compresses, and Uploads the JOBTRAC Files to the FTP Site

JOB0

  • Packs all the CA-JOBTRAC files into a single DFDSS DUMP file.

  • Compresses the single DFDSS DUMP file, using the TERSE utility.

  • Uploads the TERSED file to the BMC support site, using FTP.

JOB0 Input

  • CA-JOBTRAC EXCLPARM member in the TRACPARM library.

  • CA-JOBTRAC RESOURCE member in the TRACPARM library.

  • CA-JOBTRAC SCL library(s).

  • Print image file of the CA-JOBTRAC CCPF (Condition Code Program Filter) table.

  • CA-JOBTRAC JMFSYM01 member in the DATELIB library.

  • CA-JOBTRAC PRODDATE member in the DATELIB library.

  • (Optional) CA-JOBTRAC ADR and AMR reports.

JOB0 Output

A tersed file that is uploaded to the BMC support site.

JOB1. Create Job Scheduling Library, CMEM Rules Table, and XML Definitions

JOB1

  • Creates the Control-M tables from the CA-JOBTRAC SCL libraries, using the CTMBLT utility.

  • Creates a CMEM rule table for jobs triggered by CA-JOBTRAC Resource requirements.

  • Invokes the CTMTLB utility to create XML table definitions for distributed jobs from the table created by the CTMBLT utility.

JOB1 Input

  1. CONTROL-M scheduling table library.
    One or more SCL libraries may be processed in a single execution of the conversion tool. See Step 6. Modify and Run the JOB1 Member for instructions on concatenating more than 1 SCL library.

    This library must not contain non-SCL members.

  2. CA-JOBTRAC EXCLPARM member in the TRACPARM library.

  3. CA-JOBTRAC RESOURCE member in the TRACPARM library.

  4. Print image file of the CA-JOBTRAC CCPF (Condition Code Program Filter) table.
    This file must be created, and copied from the JES spool to a disk data set (fixed block format). For more information on how to produce this file, see the CA-JOBTRAC Extended Scheduling Services Guide, version 3.2 or later. For version 3.1 or earlier the CCPF table must be converted manually. Contact CA-JOBTRAC support on how to extract CCPF table information from the VSAM HISTORY file.

JOB1 Output

  1. Intermediate Control-M table library.
    Default File Name: CTM.Vxxx.SCHED (where xxx refers to the version number).
    Library Characteristics: PDS; record length 80; block size 3,120.

  2. Control-M CMEM table containing JOBARRIVAL triggering events.
    Default File Name: CTM.Vxxx.CMEM
    Library Characteristics: Sequential; record length 80; block size 3,120.
    This file must be specified as a member within a CMEM rule table library. Themember contains a CMEM rule tablespecifying ON JOBARRIVAL rules.

  3. Table definition file.
    Default File Name: CTM.JBT.OUTLST
    Library Characteristics: Sequential; record length 100; block size 23,400.

  4. File containing the JCL for the IOACND utility job that adds resources to the Control-M Resources file.
    Default File Name: CTM.JBT.DAPRM
    Library Characteristics: Record length 80; block size 3,120.

  5. XML file containing distributed job definitions.
    Default File Name: CTM.Vxxx.XML
    Library Characteristics: Sequential; record length 255; block size 27795.

  6. File containing conversion messages.

JOB2. Convert JCL Libraries and JMF Variables

JOB2

  • Creates a Control-M AutoEdit member containing user-defined variables, and their assigned values, using the CA-JOBTRAC JMFSYM01 member in the DATELIB library.

  • Creates a Control-M INCLUDE library from the CA-JOBTRAC PRODDATE member in the DATELIB library.

  • Converts, in-place, the CA-JOBTRAC JCL libraries into Control-M format.

JOB2 Input

  1. CA-JOBTRAC JMFSYM01 JCL JMF variable member in the DATELIB library.

  2. CA-JOBTRAC PRODDATE member in the DATELIB library containing insertion control records.
    The PRODDATE member can be processed regardless of whether the logical record length of the DATELIB library is80 or 88.

  3. Copies of the CA-JOBTRAC JCL libraries.

JOB2 Output

  1. JCL libraries in Control-M AutoEdit format.

  2. Control-M JMFSYM01 INCLUDE member.

    This member must be placed in the library defined by the INCLIB conversion parameter, which is described in "INCLIB" in Conversion Parameters.

  3. An INCLUDE library, defined by the INCLIB conversion parameter, containing members for all JCL Automatic Date Insertion (ADI) control statements.
    Default File Name: CTM.Vxxx.INCLIB (where xxx refers to the version number).
    Library Characteristics: PDS; record length 80; block size 3,120.

  4. JCL conversion report.

JOB3. Create Control-O Rules Library (Optional)

JOB3

  • Creates Control-O rules tables from the CA-JOBTRAC ADR, AMR, and SCS reports. JOB3 is optional and must only be executed if Control-O is installed.

  • You make use of the CA-JOBTRAC ADR , AMR, and/or SCS extended scheduling services.

JOB3 Input

Print image file of the CA-JOBTRAC ADR table.

  1. Print image file of the CA-JOBTRAC AMR table.

  2. Print image file of the CA-JOBTRAC SCS table.

  3. Control-M job scheduling library (created in JOB1).

The above print image files must be created, and copied from the JES spool to a disk data set (fixed block format). For more information on how to produce this file, see the CA-JOBTRAC Extended Scheduling Services Guide, version 3.2 or later. For version 3.1 or earlier, the ADR , AMR, and SCS tables must be converted manually; contact CA-JOBTRAC support on how to extract the ADR, AMR, and SCS tables information from the VSAM HISTORY file.

JOB3 Output

  1. Control-O Rules table containing ON DSNEVENT triggering events.
    Default File Name: CTM.Vxxx.CTODSN (where xxx refers to the version number).
    File characteristics: Sequential; record length 80; block size 3,120.

    This file must be specified as a member within a Control-O rule table library. Themember contains a Control-O rule tablespecifying ON DSNEVENT rules.

  2. Control-O Rules table containing ON MESSAGE and/or ON STRING triggering events
    Default File Name: CTM.Vxxx.CTOMSG
    File Characteristics: Sequential; record length 80; block size 3,120.

    This file must be specified as a member within a Control-O rule table library. Themember contains a Control-O rule tablespecifying ON MESSAGE and/or ON STRING rules.

  3. Control-O Rules table containing ON EVENT rules which issue system commands based on scheduling and runtime criteria.
    Default File Name: CTM.Vxxx.CTOEVT
    File Characteristics: Sequential; record length 80; block size 3,120.

    This file must be specified as a member within a Control-O rule table library. Themember contains a Control-O rule tablespecifying ON EVENT rules.

  4. File containing conversion messages.