Previous Topic: 2.3.3 CA MICS JCL Planning and Parameters

Next Topic: 2.3.3.1.1 Processing Done by Standard JCLGEN Jobs

2.3.3.1 JCLGEN Process Flow


The CA MICS JCL generation (JCLGEN) process is accomplished
by a series of jobs.  When run, these jobs create the job
streams and JCL procedures needed to install and run CA MICS.

The JCLGEN function is divided into small jobs in order to
separate functions which will be performed with greater or
lesser frequency.  The function of each of these jobs is
shown below.

 JCLGEN0  - Complex-wide jobs and clists
 JCLGEN1  - CA MICS Accounting and Chargeback specific jobs
 JCLGEN3  - CA MICS Templates Used in Q&R Workstation

 JCLGENA  - Database Unit Installation Jobs - Part 1
            Note:  This job is copied from
                   sharedprefix.MICS.CNTL(JCLGENA) by the
                   COPYLIBS job.  JCLGENA generates the same
                   JCL as JCLGENB and is used only during
                   creation of a new database unit.
 JCLGENB  - Database Unit Installation Jobs - Part 1
 JCLGENC  - Database Unit Installation Jobs - Part 2
 JCLGEND  - Database Unit Operational Jobs
 JCLGENE  - Jobs Affected by a DB Split After Installation
 JCLGENF  - SPECIAL Database Unit Installation Jobs
 JCLGENG  - SPECIAL Database Unit Operational Jobs

 JCLGENUC - Regenerate Complex Jobs from a User Supplied List
 JCLGENU  - Regenerate Unit Jobs from a User Supplied List

Note:  The consolidated UNITGEN process is a combination of
       JCL, MACRO, and DATABASE generation processing that
       consolidates most CA MICS generation processes for a
       database unit into a single batch process.  The
       UNITGEN job generates (and optionally submits) the
       UNITGEN1 job to perform, in a single batch process,
       the JCL generation processing of the JCLGENB, JCLGENC,
       and JCLGEND jobs, along with the COPYLIBU, ALLPGEN,
       CYCLEGEN, and GDGSGEN processing for a unit database.
       See section 5.6 for more information on the UNITGEN
       process.

The process flow of complex level JCLGEN is illustrated in
Figure 2-15.

|-------------User Defined PARMS Members-------------| |-Skeleton JCL Members-| |--------CA MICS Definition Tables---------| +-------------+ | JCL Options | +---------------+ +-------------+ +-------------+ | Definition | | Prototype | |sharedprefix.| |sharedprefix.| |sharedprefix.| | Library | | MICS.GENLIB | | MICS.ISPTLIB| | MICS.PARMS | | sharedprefix. | | (COMPTDEF | +------+------+ | (JCLDEFC) | | MICS.PROTOLIB | | DBTABLE) | | | "GENLIST" | +-------+-------+ +------+------+ | | USERJCL | | | | | JCLINFO | | | | | JCL$Iccc | | | | | JCLNAMES | | | | | CPLXDEF) | | | | +------+------+ | | | | | | | | | | | | | | | +--------------------------------------+--------------------------+------------------+ | | V +--------------+ +------------+ | sharedprefix.| | JCL | | MICS.SOURCE |----------->| Generation | | (JCLGEN01 | | Process | | JCLGEN02 | | | | JCLPARM) | +------+-----+ +--------------+ | | | +-----------------+---------------+-------+--------+-----------------+--------------+ | | | | | | | | | | | | V V V V V V +--------------+ +--------------+ +--------------+ +--------------+ +--------------+ +-------------+ | Generated | | Generated | | Complex | | ISPF Table | | Updated | | Generated | | CLISTs | | Jobs | | Options | | Definitions | | Database | | Formats | | sharedprefix.| | sharedprefix.| | sharedprefix.| | sharedprefix.| | Table | | shareprefix.| | MICS.CLIST | | MICS.CNTL | | MICS.MACAUTOS| | MICS.ISPTLIB | | sharedprefix.| | MICS.MCOLIB | +--------------+ +--------------+ +--------------+ +--------------+ | MICS.GENLIB | +-------------+ | (DBTABLE) | +--------------+


Figure 2-15.  Complex Level JCLGEN Process Flow
Input consists of the user-modified JCLDEFC, USERJCL,
JCLINFO, JCL$Iccc, JCLNAMES, and CPLXDEF members of
sharedprefix.MICS.PARMS; all selected (GENLIST) prototype job
stream (JCL), procedure, CLIST, and MACRO members from
sharedprefix.MICS.PROTOLIB; and the CA MICS-provided
definition tables from the sharedprefix.MICS.PARMS, GENLIB,
and ISPTLIB libraries.  These definition tables contain lists
of jobs to be created (JCLGENx and JCL$xccc) along with
definitions for data set names (JCLNAMES) and job attribute
(JCLINFO and JCL$Iccc) specifications.  The default tables
cause the creation of all jobs and must be used the first
time you do a JCLGEN.  See Section 2.3.3.3.2.1, Job/CLIST
Generation Lists, for a more complete description of these
lists.

JCLGEN may generate any number of job streams (JCL),
procedures, CLISTs, MACROs, and ISPF table definitions.
These outputs are placed in the CA MICS CLIST, CNTL,
MACAUTOS, ISPTLIB, GENLIB, and MCOLIB libraries.

The process flow of a unit level JCLGEN is illustrated in
Figure 2-16.

|-------------User-Defined PARMS Members-------------| |-Skeleton JCL Members-| |--------CA MICS Definition Tables------------| +-------------+ | JCL Options | +--------------+ +---------------+ +-------------+ +-------------+ | Definition | | JCL Options | | Prototype | |sharedprefix.| |sharedprefix.| | prefix. | | Definition | | Library | | MICS.GENLIB | | MICS.ISPTLIB| | MICS.PARMS | | sharedprefix.| | sharedprefix. | | (COMPTDEF | +------+------+ | (JCLDEF | | MICS.PARMS | | MICS.PROTOLIB | | DBTABLE) | | | "GENLIST" | | (JCL$xccc | +-------+-------+ +------+------+ | | USERJCL | | (JCLINFO | | | | | JCLINFO | | JCL$Iccc) | | | | | JCLNAMES | +------+-------+ | | | | DBSPLIT | | | | | | SITE | | | | | | EXECDEF | | | | | | INPUTccc) | | | | | +------+------+ | | | | | | | | | +-------------------+----------------------------+--------------------------+------------------+ | | V +--------------+ +------------+ | sharedprefix.| | JCL | | MICS.SOURCE |----------->| Generation | | (JCLGEN01 | | Process | | JCLGEN02 | | | | JCLPARM) | +------+-----+ +--------------+ | | | | +---+-----------+--------+---+---+-----------------+--------------+--+-------------+----------------+ | | | | | | | | | | | | | | | | | | | | V | V | V V V | V V +--------------+ +--------------+|+--------------+ +--------------+ +-------------+ +--------------+ +--------------+ | Generated | | Complex ||| ISPF Table | | Updated | | Generated | | Database | | Complex | | Jobs | | Options ||| Definitions | | Database | | Formats | | Configuration| | Options | | prefix. | | sharedprefix.||| sharedprefix.| | Table | | shareprefix.| | prefix. | | sharedprefix.| | MICS.CNTL | | MICS.MACAUTOS||| MICS.ISPTLIB | | sharedprefix.| | MICS.MCOLIB | | MICS.PARMS | | MICS.SOURCE | +--------------+ +--------------+|+--------------+ | MICS.GENLIB | +-------------+ | (DBCONFIG) | | (#CPLXLST) | | | | (DBTABLE) | | +--------------+ +--------------+ | | +--------------+ V V V +-------------+ +--------------+ +------------------+ | Generated | | Generated | | Generated | | Formats | | CLISTs | | Unit MACROs | | prefix. | | sharedprefix.| | prefix. | | MICS.MUOLIB | | MICS.CLIST | | MICS.USER.SOURCE | +-------------+ +--------------+ +------------------+


Figure 2-16.  Unit Level JCLGEN Process Flow
Input consists of the user-modified JCLDEF, USERJCL, JCLINFO,
JCLNAMES, DBSPLIT, SITE, EXECDEF, and the INPUTccc members of
prefix.MICS.PARMS; all JCL$xccc GENLIST and all JCLINFO and
JCL$Iccc members of sharedprefix.MICS.PARMS; all selected
(GENLIST) prototype job stream (JCL), procedure, CLIST, and
MACRO members of sharedprefix.MICS.PROTOLIB; and the
CA MICS-provided definition tables from
sharedprefix.MICS.PARMS, sharedprefix.MICS.GENLIB, and
sharedprefix.MICS.ISPTLIB.  These definition tables contain
lists of jobs to be created (JCLGENx and JCL$xccc) along with
definitions for data set names (JCLNAMES), job attributes
(JCLINFO and JCL$Iccc), database split (DBSPLIT), site
characteristics (SITE), and dynamic execution options
(EXECDEF) specifications.  The default tables cause the
creation of all jobs and must be used the first time you do a
JCLGEN.  See Section 2.3.3.3.2.1, Job/CLIST Generation Lists,
for a more complete description of these lists.

JCLGEN may generate any number of job streams (JCL),
procedures, CLISTs, MACROs, CA MICS parameter members, and
ISPF table definitions.  These outputs are placed in the
sharedprefix.MICS CLIST, CNTL, MACAUTOS, ISPTLIB, GENLIB,
MCOLIB, and SOURCE libraries.  Output is also placed in the
prefix.MICS USER.SOURCE, MUOLIB, and PARMS libraries.