4. CA MICS Facilities › 4.2 CA MICS Component Generator (MCG) › 4.2.4 Generator Definition Statements
4.2.4 Generator Definition Statements
Components are defined using several types of generator
definition statements, as discussed below. These statements
are located in several members of sharedprefix.MICS.GENLIB,
the generation library.
Distribution material includes one member in the GENLIB
library for each CA MICS component licensed. The members are
named in the form cccGENIN, where ccc is the three letter
component identifier. The specific members on the library
may include:
Member Component Described
Name
-------- ---------------------------------
BASGENIN CA MICS Platform
RMFGENIN Hardware and SCP Analyzer
SMFGENIN Batch and Operations Analyzer
cccGENIN ccc CA MICS component
(where ccc is the three letter component
identifier. An example is CICGENIN, which
is the member containing definition
statements for CICS Analyzer.)
UxxGENIN User-Written Component
ZxxGENIN User-Written Component
(where one member is coded for each
user-written component installed.)
Common data elements are elements that are used by more than
one CA MICS file. If a common element is used by files in
more than one product, the common element is defined in the
special generation library member called $DEGENIN. If a
common element is used by files in a single product, the
common element is defined in that product's cccGENIN member
prior to the first AREA statement.
Components are defined through component definition
statements that contain the following keywords:
GEN: Defines the generation process to be
performed.
OPTION: Defines the data element clusters to be
included in the generation.
COMP: Defines the component name, identifier, job
step number, and input file attributes.
COMPOPT: Defines the component-specific Essential and
Derived Data Element options.
COMPJOB: Defines the operational JOBs that will
contain a component-specific step.
INPUTSOURCE: Defines the component's input source and the
record types that will be processed by the
component.
common Defines elements that are available to more
elements: than one of this component's files. These
elements must appear prior to the first AREA
statement.
AREA: Defines the information area within which a
file or set of files belongs.
Files are defined through file definition statements that
contain the following keywords:
FILE: Defines a file's name, identifier,
timespans supported, and archive levels
supported.
FOPT: Defines the file's specific Essential and
Derived Data Element options.
CYCLES: Defines a file's default database cycle
retention values.
COMPRESS: Defines whether or not the file is eligible
to be compressed when the compression
facility is activated.
Standard and common data elements are defined through
standard and common data element definition statements that
contain the following keywords:
TYPE: Defines a data element's type, file sequence
position, length, and format.
ALIAS: Defines a data element's data dictionary
alias.
ALTNAME: Defines a common data element's alternate
name, as saved on all files.
NAME/NAMX: Defines a data element's name and label and,
for standard data elements, the timespans
in which the data element exists.
EXP: Defines a standard data element's expression
to compute the element's value, if the data
element is a computed element (type C).
DEPEND: Defines dependencies between standard data
elements on the file.
The following terms will help you understand how these
statements relate to each other hierarchically. It is
useful, and sometimes necessary, to refer to clusters of
Component Generator (MCG) control statements by their group
function. The following groups are defined:
Component Group: The set of all MCG control statements that
define a component in the cccGENIN member. This group
consists of one GEN statement, an optional OPTION
statement, one COMP statement, an optional COMPOPT
statement, an optional COMPJOB statement, an optional
INPUTSOURCE statement, and one or more AREA statements.
File Group: The set of all MCG statements that define a file
within an information area. This group consists of one
FILE statement, one FOPT statement, one CYCLES statement,
an optional COMPRESS statement, and one or more Type
Groups.
Type Group: The set of all MCG statements that define one or
more data elements within a file, such that all the data
elements in the group share common summarization
algorithms and common SAS characteristics of format and
length in all timespans of the file. This group
consists of a TYPE statement followed by one or more Data
Element Groups.
Data Element Group: The set of all MCG statements that
completely defines one single data element within the
Type Group. This group consists of different statements
based on the data element's type:
Derived summarization elements (type "C" or computed)
consist of:
o one ALIAS statement, optional
o one NAME or NAMX statement, mandatory
o one EXP statement, mandatory
o additional EXP statements, optional
o one or more DEPEND statements, optional
Common elements (type "X") consist of:
o one ALIAS statement, optional
o one ALTNAME statement, optional
o one NAME statement, mandatory
All other summarization types consist of:
o one ALIAS statement, optional
o one NAME or NAMX statement, mandatory
o one or more DEPEND statements, optional
** THE ORDER OF STATEMENTS IS CRITICAL **
If optional statements are used, they must appear in the
order shown in the diagram that follows. For example, if an
OPTION statement is being used, it MUST appear after the
COMP statement.
The statements are documented in the following sections:
1 - Component Definition Statements
2 - File Definition Statements
3 - MSI Definition Statements
4 - Standard Data Element Definition Statements
5 - Common Data Element Definition Statements
+- GEN ...
+------------------(component header)-+ COMP xyz
| +- COMPOPT ...
| +- COMPJOB ...
| +- OPTION ...
| +- INPUTSOURCE
| +- ..common..
| ..elements.
| +------------------------------ AREA ...
| | +------------------+- FILE ...
| | | +- FOPT ...
| | | +- CYCLES ...
| | | +- COMPRESS...
| | | +---------- TYPE ....
| | | | +- ALIAS ...
| | | | D.E. | NAME ...
| | | | group -+ EXP 01 ...
| | | type | | EXP nn ...
| | | group -+ +- DEPEND ...
| | | | D.E.
| | file | | group -+- NAME ...
| | group -+ | +- EXP 01 ...
| info | | |
| area -+ | | D.E. +- NAME ...
| group | | | group -+ EXP 01 ...
| | | +------- +- DEPEND ...
GENLIB | | | more
member -+ | | type
xyzGENIN | | | groups - ...
| | |
| | +-------------------- last D.E.
| |
| | +------------------+- FILE ...
| | | +- FOPT ...
| | more | +- CYCLES ...
| | file -+ type +- COMPRESS...
| | groups | groups - ...
| | |
| | +-------------------- last D.E.
| +------------------------------ last file
|
| +------------------------------ AREA ...
| | +------------------+- FILE ...
| | | +- FOPT ...
| more | | +- CYCLES ...
| info -+ file -+ type +- COMPRESS...
| area | groups | groups - ...
| groups | |
| | +-------------------- last D.E.
| +------------------------------ last file
+--------------------------------------- last area