10. MODIFICATION › 10.1 Checklists › 10.1.2 Add or Change Data Elements in a File

10.1.2 Add or Change Data Elements in a File

You can add new data elements to any of the CIC Information
Area files.  You can also change the definitions associated
with existing data elements, such as data element type,
length, and label.  In addition, you can activate or
deactivate data elements in a specific timespan or in all
timespans.  Note that adding or changing data elements may
affect your CA MICS Accounting and Chargeback files.

For each data element defined to the CA MICS CICS Analyzer,
there is a corresponding NAME or NAMX statement in
sharedprefix.MICS.GENLIB(CICGENIN).  NAME statement indicates
that the data element is an essential data element, which
means it is always kept in the CA MICS Data Base. NAMX
statements denote nonessential data elements, which,
depending upon the definition of the ESSENTIAL option in
sharedprefix.MICS.PARMS(CPLXDEF), may be excluded from the
CA MICS Data Base.

Both NAME and NAMX statements define the data element name,
the cluster code that associates the data element with a
specific data source, the timespans in which the data element
is active, and the 40-byte data element label.

For derived data elements, you can also supply their
computations or expressions using the EXP statements.  If the
computations depend upon the presence of other data elements,
then a DEPEND statement is also needed.  Therefore, a NAME or
NAMX statement, followed by DEPEND and one or more EXP
statements are typically defined in CICGENIN for a derived
data element.

The NAME and NAMX statements are preceded by a TYPE
statement, which defines the data element type, and length
and output formats in different timespans.

The TYPE, NAME, and NAMX statements are associated with a
FILE statement, which defines the file name, the file type,
the timespans in which the file is active, and the file
label.

To add a data element or change the attributes associated
with a data element, follow the checklist provided below.
   ****************************************************
   *                                                  *
   *  CHECKLIST 2 - ADD OR CHANGE ELEMENTS IN A FILE  *
   *                                                  *
   ****************************************************

___ 1.  Save a copy of sharedprefix.MICS.GENLIB(CICGENIN) in
        sharedprefix.MICS.LOCALMOD.CNTL for recovery
        purposes.

___ 2.  Review the descriptions of data element definition
        statements provided by Section 4.2.4.3 of the System
        Modification Guide.

___ 3.  Add or modify TYPE, NAME, NAMX, DEPEND, or EXP
        statements in sharedprefix.MICS.GENLIB(CICGENIN).
        Ensure these statements follow the appropriate FILE
        statements for the file in which you are adding or
        modifying the data elements.  In addition, any
        changes or additions made to the CSU, CAU, or CAC
        files must also be made in the CSW file at the DETAIL
        timespan.  The CSW file is a work file used during
        daily CICS Analyzer processing (DAY040 step of DAILY
        job) to build other files.  Use IEBUPDTE to apply the
        change.

___ 4.  Regenerate the CICS Analyzer by submitting the job in
        sharedprefix.MICS.CNTL(CICCGEN).