Previous Topic: 2.3.2 Activating Accounting for a Complex-Level Ext. FileNext Topic: 2.3.4 External Journal File in Accounting-Only Unit


2.3.3 Activating Accounting for NSM AND CA-IAM


Do NOT use these checklists unless you followed the checklist
in Chapter 3 of the PIOM to install CA MICS Accounting and
Chargeback Option in your complex and then completed the
checklist in Section 2.2 of this guide.

Once CA MICS Accounting and Chargeback Option is installed,
use these checklists if you wish to charge for CA I/S
Inventory and Assets Manager (CA-IAM), NSM NT resource
Accounting (NTA), NSM Asset Management Option (AMO), and NSM
UNIX resource Accounting (NIX).

Review the discussion of external file charging so
that you will be familiar with its purpose and the
different specifications that need to be made. For more
information, see section 4.4.

When you activate charging for CA-IAM, NTA, NIX or for AMO
you must fill in the file specifications and review the
default charging algorithm and its algorithm qualifications.
You may optionally code an exit for these special external
files.

Each computation code used in an External File Rate Table
must be defined in the Charging Element definition. We have
predefined the computation codes in the 2100-2105 range for
CA-IAM, 2801-2826 for NTA, 2900-2930 for NIX and 2120-2125
for AMO. The default computation code is 2100 for inventory
and assets charging, 2801 for NT resource accounting, 2120
for Asset Management option and 2900 for UNIX resource
accounting.

You can use a default charging strategy to bring in your
CA-IAM, NTA, NIX or AMO charges. This default strategy uses:

  o  Direct charging with the TYPE variable
  o  A rate of 1.0
  o  One algorithm
  o  No algorithm qualification
  o  Computation code 2100, 2120, 2900 and 2801
  o  Invoice category 2120, 2110, 1750 and 1800
  o  Invoice category description
       "I/S Inventory and Assets"
       "NT Systems"
       "UNIX Resource Accounting"
       "NSM Asset Management"

Using the default strategy, all of the inventory and assets
charges accumulate on one reporting line in the standard
reports.


There are two checklists below:

  o  Use the default strategy checklist to activate the
     default strategy.

  o  Use the alternate checklist to design your own charging
     strategy.


DEFAULT STRATEGY CHECKLIST

Follow the steps in this checklist to use the default
strategy to activate accounting for CA-IAM, AMO, NT resource
accounting and UNIX resource accounting data.

In the steps that follow, you will use CA MICS Accounting and
Chargeback Option online panels to specify your parameters.
To access the panels for a parameter, select the appropriate
option number on the Parameter Specifications and Generation
menu. To display the Parameter Specification and Generation
menu, proceed as follows:

  o  Invoke the CA MICS Workstation Facility (MWF) and select
     option 4, Management Support Applications, from the MWF
     menu.

  o  Select Option 2, Accounting and Chargeback, from the
     Management Support Applications menu.

  o  Select Option 3, Parameter Specification and Generation
     from the Installation Accounting Primary Options Menu.


 __ 1.  Select Option 7, External File Definition, on the
        Parameter Specification and Generation menu to
        display the External File Selection panel.

        We have predefined the UMAIAM, UAMAMO, UAMNTA and
        UNXNIX files to process charges from CA-IAM, AMO,
        NT resource accounting and UNIX resource accounting
        data.

        Select line command to display the External File
        Definition - File Options panels and proceed as
        follows:

        o  Select Option 1, External File Specifications, to
           code the INPUTACT DD statement. Provide the name
           of the data set that contains the charge records.
           You must enter the INPUTACT DD statement for each
           file on the External File Specifications panel.
           The JCL that is generated includes the DD
           statement.

        o  The input data set for NT and UNIX resource
           accounting created by NSM Systems Performance. The
           input data set for AMO is created by the AMO
           EXTRACT program delivered with CA MICS

           The input data set for the I/S Inventory and
           Assets Manager is created by the ChargeBack
           (Bill To) Detail Report (#180A).

           +----------------------------------------------+
           | Reference(s): Sections 4.4.1, 4.4.1.2 and    ¦
           | 4.4.6                                        ¦
           +----------------------------------------------+

        o  For CA-IAM, select Option 6, Cost Center Look Up
           Table, to optionally add the RSCACCT values from
           the I/S Inventory and Assets Manager that you want
           translated to COSTCTRs. The entries on this panel
           will be placed in a SAS PROC FORMAT called
           $ACTUIAM. You can use this PROC FORMAT member in
           sharedprefix.MICS.PARMS(COSTRTE) to assign values
           to your COSTCTR1-9 fields based on the RSCACCT
           values entered on this panel as the ORIGINAL
           VALUE.

           +----------------------------------------------+
           | Reference(s):  Section 4.4.5. through 4.4.5.2|
           +----------------------------------------------+

        o  Submit the External File Generation job. If you
           made any changes to the external file parameter,
           you are automatically requested to submit the job
           when you END from the External File Selection
           panel.

           You can also submit the External File Generation
           job from TSO as follows:

              SUB 'sharedprefix.MICS.CNTL(EXTFILE)'

           Return to the Installation Accounting Primary
           Options Menu.

 __ 2. Modify the Cost Center Derivation Routine (COSTRTE) to
       create your COSTCTR1-9 values for CA-IAM, AMO, NTA and
       for NIX charges. Complete the following:

       o  Select Option 1, Cost Center Definition, from the
          Parameter Specification and Generation menu.

       o  Select Option 2, Cost Routine, on the Cost Center
          Definition Menu to add SAS code and to assign
          values to your COSTCTR1-9 variables. The variable
          ROUTINE supports the following values:

           IAMINPUT - Process I/S Inventory and Assets
                      Manager records
           AMOINPUT - Process Asset Manager records
           NTAINPUT - Process NSM NT records
           NIXINPUT - Process NSM UNIX records

          You can use the PROC FORMAT $ACTUIAM, $ACTUAMO,
          $ACTUNIX or FORMAT $ACTUNTA in your coding if you
          filled in the table in step 1. Review the sample
          COSTRTE member in sharedprefix.MICS.HOLD.PARMS for
          coding hints.

          +----------------------------------------------+
          | Reference(s): Sections 4.1.3 through 4.1.3.2 |
          +----------------------------------------------+

       o  Return to the Installation Accounting Primary
          Options Menu after performing the prior steps.

 __ 3. Review the new job that has been created to process
       the UMAIAM, UAMAMO, UNXNIX OR the UAMNTA file. It will
       add records to the Standard Debit File (ACTSDT00).
       Test this job by processing your external file and
       adding the output records to a test data set instead
       of to your production data set. Catalog a test
       data set with the same attributes as
       sharedprefix.MICS.TABLES to allow your test job to
       have an output data set.

       o  Select Option 1, Month End Close Out Jobs, from the
          Installation Accounting Primary Options Menu.

       o  Select Option 1, External File Update, from the
          Month End Close Out Jobs menu.

       o  If you have both complex-level and unit-level
          external files defined, the External File Update
          menu will appear. Select Option 1, Complex-level
          External Files.

       o  Select the new job, ACTfffTB, that you created.
          Check the input data set name for accuracy. Modify
          the JCL to use a test output data set in place of
          the standard output data set
          sharedprefix.MICS.TABLES. Then submit the job.

       o  After you have submitted the job, CANCEL from the
          PDF EDIT function to avoid a permanent change to
          the JCL.

       o  After the External File Update job has finished,
          validate the records in your ACTSDT00 file in your
          test data set.  You can use the MSAS option of the
          CA MICS Workstation Facility (MWF) to interactively
          review the file.

          For UMAIAM file, review the report that is
          produced as part of the output of this job for
          accuracy and compare it to the Charge Back/Bill to
          Detail Report (#180A) in the I/S Inventory and
          Assets Manager.

 __ 4. Notify your Production Control Group, or the group
       responsible for the production use of this external
       file processing job, that it is now available.

ALTERNATE STRATEGY CHECKLIST

Follow this checklist to design your own charging strategy
for CA-IAM, AMO, NT and UNIX resource accounting data.

 __ 1. If you plan to use different charging algorithms for
       different groups of SYSID, Subsysid, Subtype, Cost
       Center 1, or Workunit values; Select Option 9,
       Qualification Groups, from the Parameter Specification
       and Generation menu. On the Group Selection panel,
       insert a group ID and description line for each group
       that you want to create. Then, on the Group
       Specification panel, select the line for each group
       and enter the values that comprise the group.

       +-------------------------------------------------+
       | Reference(s):  Sections 4.3.2 through 4.3.2.2   |
       +-------------------------------------------------+

       Submit the Qualification Group Generation job.  If you
       added, deleted, or changed any cost center groups, you
       are automatically requested to submit the job when you
       END from the Group Selection panel. You may submit
       the job at this point, or you may CANCEL because the
       Qualification Group Generation job will be performed
       by the External File Generation job that you will run
       in step 4.

       You can also submit the Qualification Group Generation
       job from TSO as follows:

          SUB 'sharedprefix.MICS.CNTL(CHRGROUP)'

 __ 2. Select Option 3, Invoice Category Definition, from the
       Parameter Specification and Generation menu and make
       any invoice category additions or modifications that
       you require.

       +-------------------------------------------------+
       | Reference(s):  Sections 4.2.2 through 4.2.2.2   |
       +-------------------------------------------------+

       If you added, deleted, or changed any invoice
       categories, you are automatically requested to submit
       the Invoice Category Generation job when you END from
       the Invoice Category Definition panel.  You may submit
       the job at this point, or you may CANCEL because the
       Invoice Category Generation job will be performed by
       the External File Generation job that you will run in
       step 4.


       Return to the Parameter Specification and Generation
       menu.

 __ 3. Select Option 5, Charging Element Definition, from the
       Parameter Specification and Generation menu to display
       the Charging Element Definition - Element Selection
       panel.  Use the Insert and Select line commands,
       respectively, to add or modify charging elements.
       Both of these line commands cause the Charging Element
       Specifications panel to be displayed for data entry.
       If you are activating a standard CA MICS product, you
       can display the Master Charging Element Table and copy
       the charging elements for the product into your
       charging element table.

       We have predefined the following charging elements:

         CA-IAM - 2100-2105
         AMO    - 2120-2123
         NT     - 2801-2803, 2806-2809, 2815, 2816,
                  2820-2822, 2825, and 2826
         UNIX   - 2900, 2905, 2906, 2910, 2911, 2915, 2916,
                  2920, 2922, and 2925

       We recommend that you add new elements in the
       8000-9999 range.

       +-------------------------------------------------+
       | Reference(s):  Sections 4.2.1 through 4.2.1.2   |
       +-------------------------------------------------+

       If you added, deleted, or changed any charging
       elements, you are automatically requested to submit
       the Charging Element Generation job when you END from
       the Charging Element Selection panel.  You may submit
       the job at this point, or you may CANCEL because the
       Charging Element Generation job will be performed by
       the External File Generation job that you will run in
       step 4.

 __ 4. Select Option 7, External File Definition, on the
       Parameter Specification and Generation menu to display
       the External File Selection panel.

       We have predefined the UMAIAM, UAMAMO, UAMNTA and
       UNXNIX files to process charges from the CA I/S
       Inventory and Asset Manager (CA-IAM), from Asset
       Management option (AMO), from NSM NT resource (NTA)
       and from NSM UNIX resource (NIX).  Use the Select line
       command to display the External File Definition - File
       Options menu, and proceed as follows:

       o  Select Option 1, External File Specifications, to
          specify prorating, SUBSYSID, and SUBTYPE
          information and to code the INPUTACT DD statement.
          (For example, If you qualify your UMAIAM file
          charging algorithms by SUBSYSID or SUBTYPE (that
          is, you use the SUBSYSID or SUBTYPE keyword with
          a value other than *ALL) on the Algorithm
          Qualification panel, you must ensure that the
          specifications for the SUBSYSID or SUBTYPE
          variables are appropriate.  LOCATION is the default
          for SUBSYSID and TYPE is the default for SUBTYPE.)

          If you want to do prorating, change the
          External File Specifications panel options as
          follows:

          The Prorating option must be YES.

          You must enter the INPUTACT DD statement for your
          Uxxfff file on the External File Specifications
          panel. This DD will be included in the generation
          of ACTfffTB job and it will be used to input the
          external file.

       o  The input data set for NT and UNIX resource
          accounting is created by NSM Systems Performance.
          The input data set for AMO is created by the AMO
          EXTRACT program delivered with CA MICS.

          The input data set for the I/S Inventory and
          Assets Manager is created by the ChargeBack
          (Bill To) Detail Report (#180A).

          +----------------------------------------------+
          | Reference(s): Sections 4.4.1, 4.4.1.2 and    ¦
          | 4.4.6                                        ¦
          +----------------------------------------------+

       o  Select Option 3, Algorithm Selection and
          Specification, on the External File Definition -
          File Options menu. Select the algorithm shown on
          the Algorithm Selection panel to review the
          computation codes and rates. The default
          computation codes are:

              CA-IAM - 2100
              AMO    - 2120
              NT     - 2801
              UNIX   - 2900

          You can use any of the new external file
          computation codes or assign any computation codes
          you defined. See CA MICS Accounting and Chargeback
          Option section 4.2.1.3 for list of the computation
          codes. The default algorithm is using VARIABLE
          VALUE with the TYPE variable as the qualifier to
          allow you to have different computation codes based
          on the value of TYPE from the input records.  A
          rate of 1.0 is used to indicate the input quantity.

          You can insert a line if you want another
          algorithm, then enter an algorithm identifier and a
          description on the Algorithm Selection panel. Then
          use the Select line command to display the
          Algorithm Specification panel and enter the
          computation codes and rates for the algorithm.

          +-------------------------------------------------+
          | Reference(s): Sections 4.3.1.4 through 4.3.1.4.2|
          +-------------------------------------------------+

       o  If you defined more than one charging algorithm for
          the external file, select Option 4, Algorithm
          Qualification.  Use the Algorithm Qualification
          panel to specify the work to which each algorithm
          applies.

          +-------------------------------------------------+
          | Reference(s): Sections 4.3.1.5 through 4.3.1.5.2|
          +-------------------------------------------------+

       o  If you wish to code a SAS exit for use immediately
          prior to the output of each external file
          observation, select Option 5, External File Exit.

          +----------------------------------------------+
          | Reference(s):  Section 4.4.4 through 4.4.4.2 |
          +----------------------------------------------+

       o  Select Option 6 to optionally build a table to
          look up a cost center value based on the value of
          a variable in a external file.

          For CA-IAM, as an example you can optionally add
          the RSCACCT values from the I/S Inventory and
          Assets Manager that you want translated to
          COSTCTRs. The entries on this panel will be placed
          in a SAS PROC FORMAT called $ACTUIAM. You can use
          this PROC FORMAT member in sharedprefix.MICS.PARMS
          (COSTRTE) to assign values to your COSTCTR1-9
          fields based on the RSCACCT values entered on this
          panel as the ORIGINAL VALUE.

          +----------------------------------------------+
          | Reference(s):  Section 4.4.5 through 4.4.5.2 |
          +----------------------------------------------+

       o  Submit the External File Generation job.  If you
          made any changes to the external file parameter,
          you are automatically requested to submit the job
          when you END from the External File Selection
          panel.

          You can also submit the External File Generation
          job from TSO as follows:

             SUB 'sharedprefix.MICS.CNTL(EXTFILE)'

 __ 5. If you plan to prorate the UMAfff file on the
       Parameter Specification and Generation menu, select
       Option 8 to display the Prorating Menu.  Select Option
       2, Complex-Level External File Prorating. When you
       select the option, the Prorating Percent
       Specifications panel will be displayed.  The lines you
       insert on this panel specify an old value, which
       identifies a record to prorate;  a new value, which
       identifies the new Cost Center 1 value; and a percent,
       which indicates the percent of the original charge the
       new Cost Center 1 value will receive.

       Prorating specifications for complex-level external
       files are made at the complex level. These
       specifications will be used for all complex-level
       external files that are being prorated.

       +-------------------------------------------------+
       | Reference(s):  Section 4.8, 4.8.5, and 4.8.5.3  |
       +-------------------------------------------------+

       Submit the Prorating Generation job. If you made any
       changes, you are automatically requested to submit the
       proper job when you END from the Prorating Percent
       Specifications panel.

       You can also submit the Prorating Generation job for
       external file prorating from TSO as follows:

        SUB 'sharedprefix.MICS.CNTL(PRORATE)'

       Return to the Installation Accounting Primary Options
       Menu.

 __ 6. Modify the Cost Center Derivation Routine (COSTRTE) to
       create your COSTCTR1-9 values for the external files.
       Complete the following:

       o  Select Option 1, Cost Center Definition, from the
          Parameter Specification and Generation menu.

       o  Select Option 2, Cost Routine, on the Cost Center
          Definition Menu to add SAS code and to assign
          values to your COSTCTR1-9 variables. The variable
          ROUTINE has a value of IAMINPUT to denote
          processing of I/S Inventory and Assets Manager
          records, AMOINPUT to denote processing Asset
          Management Options, NTAINPUT to indicate processing
          NSM NT records and NIXINPUT denote NSM UNIX
          records. You can use the PROC FORMAT $ACTUIAM,
          $ACTUAMO, $ACTUNIX or FORMAT $ACTUNTA in your
          coding if you filled in the table in step 1. Review
          the sample COSTRTE member in
          sharedprefix.MICS.HOLD.PARMS for coding hints.

          +----------------------------------------------+
          | Reference(s):  Section 4.1.3 through 4.1.3.2 |
          +----------------------------------------------+
       o  Return to the Parameter Specification and
          Generation menu.
 __ 7. Review the new job that has been created to process
       the Uxxfff file. It will add records to the Debit
       File (ACTSDT00). Test this job by processing your
       external file and adding the output records to a test
       data set instead of to your production data set.
       Catalog a test data set with the same attributes as
       sharedprefix.MICS.TABLES to allow your test job to
       have an output data set.

       o  Select Option 2, Month End Processing, from the
          Primary Options menu.

       o  Select Option 1, Month End Close Out Jobs, from the
          Month End Processing menu.

       o  Select Option 1, External File Update, from the
          Month End Close Out Jobs menu.

       o  If you have both complex-level and unit-level
          external files defined, the External File Update
          menu will appear. Select Option 1, Complex-level
          External Files.

       o  Select the new job, ACTfffTB, that you created.
          Check the input data set name for accuracy. Modify
          the JCL to use a test output data set in place of
          the standard output data set
          sharedprefix.MICS.TABLES. Then submit the job.

       o  After you submit the job, CANCEL from the EDIT
          function to avoid a permanent change to the JCL.

       o  After the External File Update job has finished,
          validate the records in your ACTSDT00 file in your
          test data set. You can use the MSAS option of the
          CA MICS Workstation Facility (MWF) to interactively
          review the file.

          For UMAIAM file, review the report that is produced
          as part of the output of this job for accuracy and
          compare it to the Charge Back/Bill to Detail Report
          (#180A) in the I/S Inventory and Assets Manager.

 __ 8. Notify your Production Control Group, or the group
       responsible for the production use of this external
       file processing job, that it is now available.