4. CA MICS Facilities › 4.2 CA MICS Component Generator (MCG) › 4.2.4 Generator Definition Statements › 4.2.4.1 Component Definition Statements › 4.2.4.1.3 Component Statements (COMP and COMPOPT)
4.2.4.1.3 Component Statements (COMP and COMPOPT)
The component statements define the component that is
being generated by assigning the required identification
name, job step number, input file attributes, and Essential
and Derived data element options.
STATEMENT FORMAT
The COMP and COMPOPT statements are always specified in a
matched pair. There is one COMP statement per cccGENIN
member. The COMPOPT statement may be omitted, in which case
default values for the Essential and Derived options are
taken. If the COMPOPT statement is present, it MUST
immediately follow the COMP statement in cccGENIN.
The COMP statement is coded with the KEYWORD starting in
column 1, free-form, and continuing through column 72.
Continuation is not supported. The following describes the
format and coding rules for the component statements.
COMP ccc sss bbbbb rrr AAAA xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
| | | | | |
| | | | | +--- COMPNAME - Name of the
| | | | | component.
| | | | |
| | | | +--- ACCOUNTING - Definition of
| | | | component's use of account
| | | | level data elements.
| | | |
| | | +--- RECFM - Input file record format
| | | to be used for input data.
| | |
| | +---BLKSIZE - Input file maximum block size
| | to be used for input data.
| |
| +---STEPNUM - Job step number used to identify
| this component in the CA MICS jobs.
|
+---COMPID - Component identification.
The COMPOPT statement is coded with the KEYWORD starting
in column 1, free-form, and continuing through column 72.
Continuation is not supported. The following describes the
format and coding rules for the component option statement.
COMPOPT eeeeeeee dddddddd xxxxxxxx
| | |
| | |
| | +--- BYPASS - Optional
| | protection bypass for all
| | files in this component.
| |
| +--- DERIVED - The derived data element
| option to be used for all files in
| this component.
|
+------ ESSENTIAL - The essential data element
option to be used for all files in this
component.
STATEMENT OPTION DEFINITIONS
COMP - Defines the description of the component that is
being generated.
COMPID - The 3-character component identifier that
identifies this component (for example,
the CICS Analyzer's COMPID is CIC). A
user component must have a 'U' or 'Z' as
its first letter to denote that it is a
user component and ensure uniqueness in
the component's identification.
Additionally, MSI cannot be used as
component identifier.
STEPNUM - The 3-character job step number that
identifies this component's job steps in
the DAILY, WEEKLY, MONTHLY, and YEARLY
jobs (for example, the CICS Analyzer's
STEPNUM is 040). Step numbers for user
components should be restricted to those
numbers from 150 through 190. If there
is a concern about eventually using all
of the numbers in this range, one should
define multiple information areas within
user components wherever it is possible.
BLKSIZE - This is an obsolete parameter which must
be a "." or range from 18 to 32000 for
compatibility.
RECFM - This is an obsolete parameter which must
be ".", F, FB, U, VB, or VBS for
compatibility.
ACCOUNTING - The keywords ACCT or NOACCT define
whether this component has files that
contain account level data elements.
ACCT causes the ACCTGEN process to be
performed and is used if the data element
name @@ACCT appears on any file in the
component's definition.
This parameter controls the
interpretation of the @@ACCT NAME
statement in this component's files. If
files contain @@ACCT NAME statements,
specifying NOACCT here will cause @@ACCT
to be ignored. Specifying ACCT will
cause @@ACCT to expand into one or more
account code data elements. If no @@ACCT
names appear in any file in the
component, this parameter is ignored.
For user components, specify ACCT to
generate component shells that include
the user component interface to CA MICS
Accounting and Chargeback.
COMPNAME - A 1-40 character name for the component.
COMPOPT - Defines the Essential and Derived data element
options to be used for this component's files.
ESSENTIAL - Must take the value of DEFAULT, INITIAL,
ONLY, or ALL. If DEFAULT is coded, the
component will be generated using the
option for essential data elements set in
sharedprefix.MICS.PARMS(CPLXDEF), which
is activated by the CPLXGEN job. If
INITIAL, ONLY, or ALL is specified, files
in the component will be generated using
this essential option value. See the
FOPT statement description for more
information.
DERIVED - Must take the value of DISK, COMP, or
DEFAULT. If DEFAULT is coded, the option
for derived data elements set in
sharedprefix.MICS.PARMS(CPLXDEF), which
is activated by the CPLXGEN job, will be
used for all files in the component. If
COMP or DISK is specified, the files in
the component will be generated using
this derived option value. See the FOPT
statement description for more
information.
BYPASS - This optional parameter is normally left
blank. There are safeguards in the
evaluation of the Essential option that
help prevent inadvertent data loss. If
you wish to bypass these safeguards and
force the Essential option for all files
in a component to a value of INITIAL or
ONLY unless overridden on the FOPT
statement, code the word BYPASS in this
position on the COMPOPT statement.
Otherwise, for the protection of the data
on an existing database, do not code
this parameter.
STATEMENT DEFINITION EXAMPLE
COMP USL 150 . . NOACCT User SYSLOG Component
COMPOPT DEFAULT DEFAULT
This component statement defines a user component (USL)
named User SYSLOG Component, which is to execute as step 150.
The component will not require account level data elements
and will use the default Essential and Derived data element
options set at the complex level in
sharedprefix.MICS.PARMS(CPLXDEF).
