Previous Topic: 7.4.2 File Creation and Update ProcessNext Topic: 7.5 Credit File (ACTSCT)


7.4.3 Usage Considerations


Note the following special considerations or techniques
related to using the audit files:

1.  The audit files are generation data groups and are, by
    default, created on tape. Optionally the DAY1 and the
    DAY2 audit files can be written to disk using the
    following JCLDEF parameters.

    ACCTDAY1PARM
       The ACCTDAY1PARM parameter is used to generate the
       unit-level DAY1 audit file on disk.  This parameter
       includes both keyword parameters and keyword=value
       specifications.  The general form of the ACCTDAY1PARM
       statement is the keyword ACCTDAY1PARM followed by one
       or more ACCTDAY1PARM parameters.

    ACCTDAY2PARM
       The ACCTDAY2PARM parameter is used to generate the
       unit-level DAY2 audit file on disk.  This parameter
       includes both keyword parameters and keyword=value
       specifications.  The general form of the ACCTDAY2PARM
       statement is the keyword ACCTDAY2PARM followed by one
       or more ACCTDAY2PARM parameters.

    The following describes each of the ACCTDAY1PARM and
    ACCTDAY2PARM parameters:

       o  DISK

          Required if you want the DAY1 or DAY2 audit file
          written to a disk device. If not specified, the
          file is written to tape and other parameters on the
          ACCTDAY1PARM/ACCTDAY2PARM statements have no
          effect.

       o  SPACE=spacedef

          Default: No SPACE parameter specified.

          Defines the space allocation parameter for the DAY1
          and/or DAY2 audit file on disk. Specify this
          parameter according to JCL language syntax.

       o  UNIT=unitname

          Default: No UNIT parameter specified

          The generic unit name to be used for the DAY1
          and/or DAY2 audit file on disk. Specify this
          parameter according to JCL language syntax.  The
          default will be the value used in DASDUNIT.

       o  VOLSER=volser

          Default: No VOLSER parameter specified.

          Define the VOLSER parameter if you want the DAY1
          and/or DAY2 audit file written onto a specific
          disk. Specify this parameter according to JCL
          language syntax.


    Note: If you chose to write the DAY1 and/or DAY2 audit
          file to disk, the following unit jobs must be
          regenerated:

          ACTDAY1R - ACT Daily Audit File Recovery Job
          ACTEXTU  - Accounting External Files Job
          ACTINITA - ACT DAY1 Audit File Initialization Job
          ACTRTSIM - ACT Rate Simulation of Charges Job
          AUDITRPT - ACT Component Audit Report Job
          DAILY    - Database Daily Job
          MONTHACT - Special Accounting Dates Monthly Update
                     Job
          MONTHLY  - Standard Monthly Update Job


    ACCTDAY1SMSPARM
       Optional parameter for specifying System Managed
       Storage (SMS) keywords (e.g., STORCLAS=storclas) to be
       used for the DAY1 audit file disk/tape data set
       allocations.  Specify one or more SMS parameters
       according to JCL language syntax.  There is no default
       and continuation is not allowed. This statement is
       used to generate daily audit jobs at a unit level.

    ACCTDAY2SMSPARM
       Optional parameter for specifying System Managed
       Storage (SMS) keywords (e.g., STORCLAS=storclas) to be
       used for the DAY2 audit file disk/tape data set
       allocations.  Specify one or more SMS parameters
       according to JCL language syntax.  There is no default
       and continuation is not allowed. This statement is
       used to generate daily audit jobs at a unit level.

2.  The generation of the DAY1 file containing the
    month-to-date data is the most current GDG version (that
    is, 0) and is modified each day in the daily CA MICS
    job stream.  The prior month's audit information is
    contained on previous GDGs.

3.  The reports show the information in this file can be
    produced from the Audit Reports option of the Process
    Control Menu (MWF;4;2;4;5;1).  Use the selection options
    on the panel to select a subset of the information from
    the file.

4.  The DAY1 audit file may be recreated from the DAY2
    tape/disk by submitting ACTDAY1R from prefix.MICS.CNTL.

5.  Since the DAY1 audit file is a "MOD" GDG, the tape is
    reused every day in the DAY199 step.  It may be
    beneficial to change the DAY199 JCL to have the DAY1
    Audit File written to a disk or a mass storage GDG to
    avoid tape-handling problems.  If this file is switched
    to disk, you may need to change the DAY1 blocksize.  To
    write the DAY1 file to disk instead of to tape, you must
    also change the MONTH199 JCL.

6.  Use the ACTAUDRD macro in sharedprefix.MICS.MACAUTOS to
    read in the ACTAUDIT, NEWAUDIT, and ACT6100 format audit
    tapes.

7.  A new, empty, generation of the complex-level audit tape
    is created each month by the CLOSETBL job.  The INVOICE
    and FINRECAP jobs delete the most recent generation and
    write ACTSDT01 and ACTSCT01 to a new generation.  This
    means that there will be gaps in the generation numbers.
    These gaps do not affect either the number of generations
    kept or the retention period.

8.  In sharedprefix.MICS.PARMS(JCLDEFC), the ACCTMGDG
    parameter determines whether audit files are maintained
    at the complex level in the monthly generation data
    group.  If audit files are maintained, it determines how
    many generations are maintained.

    If, after installation, you want to start or stop
    maintaining complex-level audit files or change the
    number of generations maintained, follow these steps:

    ___ a.  Edit the ACCTMGDG parameter value in
            sharedprefix.MICS.PARMS(JCLDEFC).  To turn off
            the complex-level audit file, change the value to
            zero.  To change the number of generations
            maintained in the monthly generation data group,
            change the value to any numeric value other than
            zero.  If no ACCTMGDG parameter is specified, it
            will default to a value of 85.

    ___ b.  Regenerate the GDGSGENC job as follows for the
            new parameter value to take effect.

            -  Edit sharedprefix.MICS.PARMS(JCLGENUC) so that
               it contains the following line:

               GDGSGENC

            -  Regenerate GDGSGENC by submitting JCLGENUC.

               SUB 'sharedprefix.MICS.CNTL(JCLGENUC)'

    ___ c.  Run GDGSGENC.

            SUB 'sharedprefix.MICS.CNTL(GDGSGENC)'

9.  In the JCL parameters at the complex or unit level, you
    can optionally override individual TAPE parameter
    specifications using accounting parameter statements that
    apply to specific types of audit tape files.  This
    gives you the option to establish a common set of
    defaults, which you override, as needed, for specific
    tape applications.

    The following are JCL parameters:

    ACCTMTAPEPARM
       The general form of the ACCTMTAPEPARM statement is the
       keyword ACCTMTAPEPARM, followed by one or more
       ACCTMTAPEPARM parameters. The ACCTMTAPEPARM parameters
       are used to generate complex-level or unit-level
       monthly audit jobs. The parameters include both
       keyword parameters and keyword=value specifications.
       You can specify the ACCTMTAPEPARM statement as many
       times as you want in order to specify all of the tape
       data set definitions you require.  (This statement can
       be used at the complex or unit level.)

    ACCTMTAPESMSPARM
       Optional parameter for specifying System Managed
       Storage (SMS) keywords (e.g., STORCLAS=storclas) to be
       used as the default for CA MICS tape data set
       allocations.  Specify one or more SMS parameters
       according to JCL language syntax.  There is no default
       and continuation is not allowed. This statement is
       used to generate monthly audit jobs at the complex or
       unit level.

    ACCTDTAPEPARM
       The general form of the ACCTDTAPEPARM statement is the
       keyword ACCTDTAPEPARM, followed by one or more
       ACCTDTAPEPARM parameters. The ACCTDTAPEPARM parameters
       are used to generate unit-level daily audit jobs. The
       parameters include both keyword parameters and
       keyword=value specifications.  You can specify the
       ACCTDTAPEPARM statement as many times as you want in
       order to specify all of the tape data set definitions
       you require.

    ACCTDTAPESMSPARM
       Optional parameter for specifying System Managed
       Storage (SMS) keywords (e.g., STORCLAS=storclas) to be
       used as the default for tape data set allocations.
       Specify one or more SMS parameters according to JCL
       language syntax.  There is no default and continuation
       is not allowed. This statement is used to generate
       daily audit jobs at a unit level.

   All keywords used on the TAPEPARM parameter can also
   be used on the accounting tape specification parameters.
   See the Planning, Installation, Operation, and Maintenance
   Guide, Sections 2.3.1.6, 2.3.1.6.4, 2.3.3.2.1, and
   2.3.3.2.1.5, for details.