Previous Topic: 7.1.1 Account Codes

Next Topic: 7.1.1.2 Account Code Derivation Exit (VMCACRT)

7.1.1.1 Account Code Definition (VMCACCT)


The CA MICS Analyzer Option for VM/CMS accounting fields have
the names of the form VMCACTn, where n is the sequential
number of the accounting field.  If three fields are defined,
they will be VMCACT1, VMCACT2, and VMCACT3 (in your
accounting structure, these might identify division, region,
and project, respectively).  The sequential number is called
the accounting field "level" number.  There is a maximum of
nine levels.  A sample account code structure is provided
with the distribution materials.

Figure 7-1 is a worksheet for collecting the data.  Once you
have completed this form, code the contents of
sharedprefix.MICS.PARMS(VMCACCT) as follows:

  o  Blank statements are permitted.  Comments are coded by
     beginning the statement with an asterisk (*).

  o  Account levels are provided in ascending order, starting
     with 1.

  o  Up to nine levels are permitted, with no gaps between
     the numbers permitted.

  o  The format of a statement is free-form, but positional.
     All parameters are required.  The format of each
     statement is as follows:

     n m 'descriptive title assigned to VMCACTn'

     where:

     'n' is account level.

     The level of importance of each element is specified,
     with Level 1 being the most important (major field) and
     the highest level number being the least important
     (minor field); 1 to 9 levels can be specified.

     'm' is field length.

     The length of the specified element, which may range
     from 1-30.

     'descriptive title' is the description of the account
     level.

     The title that describes the account code field is
     limited to forty characters.

  o  An account level can be deactivated in the DAYS, WEEKS,
     MONTHS, and YEARS timespans.  Setting account code
     levels by timespan is accomplished by specifying the
     timespan mask on the account code statements in
     VMCACCT, as follows:

     n T(......) m 'descriptive title assigned to VMCACTn'

     where:

     Each "." position in the timespan parameters
     represents a timespan, in this order:  DETAIL, DAYS,
     WEEKS, MONTHS, YEARS, and TABLES.  For each
     timespan, a "Y" indicates that the account level
     should be active, or an "N" indicates that the
     account level should be inactive.

     The following example shows the VMCACT3 element being
     retained only at the DETAIL and DAYS timespans.

     1             8  'DIVISION'
     2             8  'REGION'
     3  T(YYNNNY)  8  'PROJECT'

     See the PIOM, Section 2.3.1.7, for more information on
     the timespan mask.

+--------------------------------------------------------------------------+ | INSTALLATION PREPARATION WORKSHEET: VM Account Code Level Definition | | PARMS Library Member is VMCACCT | | Reference Section: 7.1 CA MICS VM Component Guide | +--------------------------------------------------------------------------+ | | | ACCOUNT FIELD | | CODE LEVEL LENGTH ACCOUNT CODE LEVEL DESCRIPTION | | (1-9) | | | | _ __ '________________________________________' | | | | _ __ '________________________________________' | | | | _ __ '________________________________________' | | | | _ __ '________________________________________' | | | | _ __ '________________________________________' | | | | _ __ '________________________________________' | | | | _ __ '________________________________________' | | | | _ __ '________________________________________' | | | | _ __ '________________________________________' | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | +--------------------------------------------------------------------------+ | ....5...10...15...20...25...30...35...40...45...50...55...60...65...70.. | +--------------------------------------------------------------------------+

 Figure 7-1.  CP Account Code Level Definition Worksheet