3. Installation › 3.3 Define Database Complex › 3.3.2 Generate Complex-Level JCL Jobs, PROCs, CLISTs
3.3.2 Generate Complex-Level JCL Jobs, PROCs, CLISTs
Section 2.3.1.6, Database Complex JCL Definitions (JCLDEFC),
describes the CA MICS parameters that control the process by
which the JCL procedures, batch jobs, and TSO CLISTs required
for complex-level functions are created.
Before you run JCLGEN0, provide the environmental
parameter values in sharedprefix.MICS.PARMS, as described
below. Any changes you make using the facilities described
in Section 2.3.3.3, JCLGEN Parameters for Special
Requirements, must also be complete before JCLGEN0 is
submitted.
JCL OPTIONS
Member: sharedprefix.MICS.PARMS(JCLDEFC)
See Section 2.3.1.6
USER JOB CARD JCL
Member: sharedprefix.MICS.PARMS(USERJCL)
See Section 2.3.3.2.2
Review and complete the JOB card and the parameters on the
EXEC statement of sharedprefix.MICS.CNTL(JCLGEN0). The EXEC
statement is written as follows:
//STEP1 EXEC MICSDM,
// ISPTLB1='__________________', <-- REQUIRED
// ISPTLB2='__________________', <-- EQ ISPTLB1 IF NONE
// ISPMLB1='__________________', <-- REQUIRED
// ISPMLB2='__________________', <-- EQ.ISPMLB1 IF NONE
// WKUNIT='SYSDA', <-- REQUIRED
// SHRPFX='sharedprefix.MICS', <-- NO TRAILING PERIOD
//*
// SASNAME='entry', <-- SASHOST for V8
//* SAS for V9
// SASPFX='sas.prefix', <-- NO TRAILING PERIOD
//*SASENV='TKMVSENV(TKMVSENV)', <-- Environment File SAS >= 9.1.3
//* Uncomment if you have this library
//* If you do NOT have this file
//* you MUST comment the TKMVSENV DD
//* as the job will abend if it does
//* not refer to the actual library
// SASCFG1='config', <-- CNTL(BATCH) IF SAS V8
//* CNTL(BATW0) IF SAS 9.1.3
//* CONFIG(BATCH) IF SAS >= 9.2
//* For SAS >= 9.2 uncomment
//* and specify next 3:
//*SASCFG2='CONFIG(COMMON)', CONFIG(COMMON)
//*SASCFG3='CONFIG(ENW0)', CONFIG(ENW0)
//*SASCFG4='CONFIG(SITE)', CONFIG(SITE)
//*
//*AUTOLIB='fixed.block.AUTOLIB',<-- For 9.1.3 only
//* uncomment and
//* point to FB version
//* of SAS AUTOCALL library
//*
// LANG1='', <-- SAS V9 LANGUAGE
//* EN = English
//* blank if V8
// LANG2='' <-- SAS V9 encoding value
//* W0. = EBCDIC (1047)
//* MUST HAVE TRAILING .
//* blank if V8
//*
JCLGEN Parameter Sharing lets you specify the commonly used
JCLGEN parameters in sharedprefix.MICS.PARMS(JCLDEFC), where
they then become default parameters for
prefix.MICS.PARMS(JCLDEF) at the unit level.
Use of this facility can greatly reduce the amount of coding
in the JCLDEF and JCLDEFC members.
JCLGEN parameters eligible for sharing can be organized into
the following groups:
SAS Data Set Definitions:
------------------------
SASNAME - SAS program name
SASCONFIGx - SAS configuration member
SASENV - SAS environment file
SASAUTOS - SAS auto include library
SASMSG - SAS message data set
SASLIB - SAS executable library
SASVER - SAS version
SASHELP - SAS help library
ISPF Data Set Definitions:
-------------------------
ISPTLIBx - ISPF table data set
ISPLLIBx - ISPF load library
ISPMLIBx - ISPF message data set
ISPPLIBx - ISPF panel data set
ISPSLIBx - ISPF skeleton data set
Miscellaneous Definitions:
-------------------------
ASSEMBLER - IBM Assembler level
AUTHLIB - Name of Authorized Library for Q&R if JES3
COLIBSPACE - Size of the temporary MCOLIB
COMPLEXPARMS- Allow/disallow JCLGEN parameter sharing
DIRSTATS - ISPF stats for generated members
HFSROOT - Name of the CA MICS HFS path
JCLLIB - Include JCLLIB statement with job card
MICSDMDELIM - Delimiter character for MICSDM/MICSDU procs
OBJACCESS - Access mode for MCOLIB and MUOLIB
OBJWAIT - Wait time for MCOLIB and MUOLIB allocation
PROCLIB - Location of CA MICS PROCs
SORTLIB - SORT utility library
SORTUTILITY - Installation sort utility
SORTWKNO - Number of sort work data set allocations
STEPCPULIMIT- Limit CPU time for any step to 60 minutes
STEPLIBx - User-defined STEPLIBs
SYSTEMMODEL - Name of model data for GDG creation
USEROBJLIB - User object definition library
JCLGEN Parameter Sharing is always active, but it must be
enabled by specifying the following in
sharedprefix.MICS.PARMS(JCLDEFC) or
prefix.MICS.PARMS(JCLDEF):
COMPLEXPARMS YES
When specified in JCLDEFC, the value of COMPLEXPARMS is the
default for all units. If specified in JCLDEF, COMPLEXPARMS
overrides the COMPLEXPARMS action specified in JCLDEFC.
Section 5.5 provides an optional checklist that shows how to
activate JCLGEN parameter sharing for all units in the CA
MICS complex.
Notes:
o For the ISPF data set and the STEPLIB definitions,
specifying the first definition (that is, ISPTLIB1) will
automatically blank out the second definition (that is,
ISPTLIB2). Therefore, always specify these
definitions in numeric order.
o COMPLEXPARMS must be the first statement in JCLDEFC
and JCLDEF. If it is not, an error message is generated.
The ISPxLIBn definitions are used to supply the data set
names of your site's IBM ISPF and ISPF/PDF product libraries.
The TSO LISTALC command can be used to assist you in
determining the correct names to specify for the ISPxLIBn
definitions that follow:
ISPTLB1-2
The names of your IBM ISPF Program Product table
libraries. ISPTLB1 is required. If ISPF and PDF are
combined in one library at your site, specify
ISPTLB2 with the same name in ISPTLB1.
ISPMLB1-2
The names of your IBM ISPF Program Product message
libraries. ISPTLB1 is required. If ISPF and PDF are
combined in one library at your site, specify
ISPMLB2 with the same name in ISPMLB1.
WKUNIT
The unit for the SYSUT3 and SYSUT4 work data sets needed
by IEBCOPY.
SHRPFX
The sharedprefix for the database complex. Include the CA
MICS level node as needed by your site. Specify the
sharedprefix name without the trailing period.
SASNAME
The library member name of the SAS program to be used,
also called the entry point name. Typically this is
SASHOST for version 8, and SAS for version 9.
SASPFX
The common data set name prefix for your SAS libraries.
Specify the name without the trailing period.
SASENV
The name of the SAS environment file. The TKMVSENV file
is used to make a list of pseudo environment variables.
Option values in SAS configuration files can contain
symbolic references. The values of these symbolic
references are resolved from a variable that is set in
the TKMVSENV file. Whether this file is optional
depends on how SAS was installed at your installation.
SASCFG1-4
The data set name qualifier and member name of your SAS
configuration files. Specify only SASCFG1 for SAS
versions 8 and 9.1.3. Typically, the value is CNTL(BATCH)
for SAS version 8 and CNTL(BATW0) for SAS version 9.1.3.
For SAS version 9.2 or above, SASCFG1 is typically
CONFIG(BATCH). To specify additional configuration files
for SAS version 9.2 or above, uncomment SASCFG2, SASCFG3
and SASCFG4. The values are typically CONFIG(COMMON),
CONFIG(ENW0), and CONFIG(SITE). The full data
set names are built by prefixing the value of SASPFX.
AUTOLIB
The SAS AUTOCALL library that is being converted to fixed
block with SAS 9.1.3. It is not required for SAS Version
9.2 and higher.
LANG1
The language code required with SAS Versions 9 and
higher, for example, EN stands for English. The value is
blank for SAS Version 8.
LANG2
The encoding value required with SAS Version 9 and
higher. The value for EBCDIC is W0 and must have a
trailing period (.). The value is blank for SAS Version
8.
When you have completed editing the job, submit it as
follows:
SUB 'sharedprefix.MICS.CNTL(JCLGEN0)'
There are other JCL generation requirements at the complex
level, but they are for creating JCL specific to certain
products such as Accounting and Chargeback (JCLGEN1). The
guides for these products describe these complex-level
generations.
