Previous Topic: 4.13 Defining Journal Files

Next Topic: 4.13.2 Journal File Eligibility Example

4.13.1 Journal File Eligibility Worksheet


Figure 4-90 is the Journal File Eligibility Worksheet:

         +----------------------------------------------------------------------------------------------------------+          |                                                                                                          |          | Date: ____/____/____                        Administrator:  ____________________________________________ |          +----------------------------------------------------------------------------------------------------------+                                            JOURNAL FILE ELIGIBILITY - FILE SPECIFICATIONS WORKSHEET             Journal File ID                ACTJ_____________             Journal File Description       _________________             Component ID                   _________________             Source Component File ID       _________________             Source Component File Timespan _________________     (DETAIL or DAYS)             Workunit Variable              _________________             Billing Timestamp Variable     _________________             Workarea Variable 1            _________________             Workarea Variable 2            _________________             Subsysid Variable              _________________             Subtype  Variable              _________________             Single File Data Step          _________________     (YES/NO)             Priority charging               ________________     (YES/NO)               Priority variable  _____________                   Format  _____________      ID  _____________   __________________________________________________________________________________________________________________________


 Figure 4-90.  Journal File Eligibility Worksheet
Use the worksheet to define the following parameters:

1.  JOURNAL FILE ID

    Description:  The journal file identifier.

    Default:  None

    Values:  Character, length 6.  It must begin with ACTJ.
    For external journal files or FDA journal files, you must
    use U or Z in the fifth position to avoid conflict with
    standard CA MICS journal files.

    NOTE:  This value must be unique across all journal
           files.

2.  JOURNAL FILE DESCRIPTION

    Description:  A descriptive long name for the journal
    file.

    Default:  None

    Values:  Character, length 40

    NOTE:  The long name will appear on the rate table
           parameter panels.

3.  COMPONENT ID

    Description:  The identifier of the database component,
    external journal file, or FDA associated with the journal
    file (for example, SMF for the CA MICS Batch and
    Operations Analyzer).  Use EXT for external journal
    files.

    Default:  None

    Values:  Character, length 3

    NOTE:  There must be an entry for the CA MICS component
           or FDA in the MICF Information Area Table.  An
           entry in this table is automatically created as
           part of the component or FDA generation process.

4.  SOURCE COMPONENT FILE ID

    Description:  The identifier of the CA MICS database
    component file, external file, or FDA file from which the
    journal file is derived (for example, JOB from the BATJOB
    file).

    Default:  None

    Values:  Character, length 3. This is the last three
    characters of the six-character file name. For external
    files not based on a CA MICS database component file, the
    first character must begin with U or Z.

    NOTE:  There must be an entry in the MICF File Definition
           Table for a CA MICS component file or for an FDA
           file.  An entry in this table is automatically
           created as part of the generation process.

5.  SOURCE COMPONENT FILE TIMESPAN

    Description:  The timespan of the CA MICS component file,
    external file, or FDA file from which the journal file is
    derived.

    Default:  None

    Values:  Character, length 7--For standard CA MICS
             journal files and FDAs, use DETAIL or DAYS.  For
             external journal files not based on a CA MICS
             database component file, leave this area blank.
             For external journal files based on a higher
             timespan of a CA MICS component file, use the
             file's timespan.

    NOTE:  The file must be active in this timespan.  This
           field is used by the online Charging Element Table
           and Rate Table parameter processing to determine
           which data elements exist in the file.

6.  WORKUNIT VARIABLE

    Description:  The name of the variable to be assigned to
    the Workunit variable.

    Default:  None

    Values:  Character, length 8

    NOTE:  If the variable name is not an active variable in
           the CA MICS component or FDA file from which this
           journal file is derived, a warning message is
           displayed.

           If you change this variable, it is very important
           that you re-examine the Workunit values in
           algorithm qualification and any Workunit
           qualification groups used with this journal file.
           Failure to do so could result in lost charges.  No
           validation is done for external journal files not
           based on a CA MICS database component file.

7.  BILLING TIMESTAMP VARIABLE

    Description:  The name of the variable to be assigned to
    BILLTS.

    Default:  None

    Values:  Character, length 8

    NOTE:  If the variable name is not contained in the
           CA MICS component or FDA file from which this
           journal file is derived, a warning message is
           displayed.  No validation is done for external
           journal files not based on a CA MICS database
           component file.

8.  Workarea VARIABLE 1

    Description:  The name of the variable to be assigned to
    the Workarea variable in positions 1-8.

    Default:  Blank

    Values:  Character, length 8

    NOTE:  This field is optional.  If it is left blank, no
           assignment will be made.  If the variable name is
           not contained in the CA MICS component or FDA file
           from which this journal file is derived, a warning
           message is displayed.  No validation is done for
           external journal files not based on a CA MICS
           database component file.

9.  Workarea VARIABLE 2

    Description:  The name of the variable to be assigned to
    the Workarea variable in positions 9-16.

    Default:  Blank

    Values:  Character, length 8

    NOTE:  This field is optional.  If it is left blank, no
           assignment will be made.  If the variable name is
           not contained in the CA MICS component or FDA file
           from which this journal file is derived, a warning
           message is displayed.  No validation is done for
           external journal files not based on a CA MICS
           database component file.

10. SUBSYSID VARIABLE

    Description:  The name of the variable that contains the
    SUBSYSID value.

    Default:  Blank

    Values:  Character, length 8

    NOTE:  This field is optional.  If it is left blank, *ALL
           is the only SUBSYSID value that may be used during
           Rate Table Algorithm Qualification.  If the
           variable name is not contained in the CA MICS
           component or FDA file from which this journal file
           is derived, a warning message is displayed.  No
           validation is done for external journal files not
           based on a CA MICS database component file.

           If you change this variable, it is very important
           that you re-examine the SUBSYSID values in
           algorithm qualification and any SUBSYSID
           qualification groups used with this journal file.
           Failure to do so could result in lost charges.

           A validation table may be entered for any SUBSYSID
           variable.  This table will be used in the
           algorithm qualification and qualification groups
           panels to prevent invalid values from being
           entered.  Invalid values could result in lost
           charges.

           Validation tables have been delivered for default
           SUBSYSID variables wherever possible.  These may
           be edited, and new ones created, by specifying
           YES in the "Edit validation table" field that
           follows the "SUBSYSID variable" field on the
           panel.  Note that there is one validation table
           per SUBSYSID variable per component.  If two
           journal files in the same component use the same
           variable for SUBSYSID, they will also use the
           same validation table.

11. SUBTYPE VARIABLE

    Description:  The name of the variable that contains the
    Subtype value.

    Default:  Blank

    Values:  Character, length 8

    NOTE:  This field is optional.  If it is left blank, *ALL
           is the only Subtype value that may be used during
           Rate Table Algorithm Qualification.  If the
           variable name is not contained in the CA MICS
           component or FDA file from which this journal file
           is derived, a warning message is displayed.  No
           validation is done for external journal files not
           based on a CA MICS database component file.

           If you change this variable, it is very important
           that you re-examine the Subtype values in
           algorithm qualification and any Subtype
           qualification groups used with this journal file.
           Failure to do so could result in lost charges.

           A validation table may be entered for any Subtype
           variable.  This table will be used in the
           algorithm qualification and qualification groups
           panels to prevent invalid values from being
           entered.  Invalid values could result in lost
           charges.

           Validation tables have been delivered for default
           Subtype variables wherever possible.  These may
           be edited, and new ones created, by specifying
           YES in the "Edit validation table" field that
           follows the "Subtype variable" field on the
           panel.  Note that there is one validation table
           per Subtype variable per component.  If two
           journal files in the same component use the same
           variable for Subtype, they will also use the
           same validation table.

12. SINGLE FILE DATA STEP

    Description:  Indicates whether this is the only journal
    file created in the CA MICS database component SAS data
    step.

    Default:  YES

    Values:  Character, length 3--For standard CA MICS
             journal files and external journal files, you
             cannot change this field.  (This field is always
             set to YES for external journal files.)

             For FDA journal files, enter YES if this journal
             file is the only journal file created in the
             user component SAS data step.  Otherwise, enter
             NO to indicate that at least one other journal
             file is created.


13. PRIORITY CHARGING

    Description:  Indicates whether the priority charging can
    be used with the journal file.

    Default:  NO

    Values:  Character, length 3, YES or NO

14. PRIORITY VARIABLE

    Description:  The name of the variable that contains the
    priority value.

    Default:  Blank

    Values:  Character, length 8

    NOTE:  If this is not a priority charging file, leave
           this field blank.  If the variable name is not
           contained in the CA MICS component or FDA file
           from which this journal file is derived, a warning
           message is displayed.  No validation is done for
           external journal files not based on a CA MICS
           database component file.

15. PRIORITY FORMAT

    Description:  The name of the SAS PROC FORMAT that
    specifies the service factors for the priority values.

    Default:  Blank

    Values:  Character, length 8

    NOTE:  If this is not a priority charging file, leave
           this field blank.  The charge for a work unit run
           at a particular priority is multiplied by the
           corresponding service factor.  The service factors
           are specified in a data source component (for
           example, Batch and Operations Analyzer) parameter,
           and the PROC FORMAT is created by the component's
           PGEN job.

16. PRIORITY ID

    Description:  The character that will be used for the
    first position of the computation code.  The rest of the
    computation code will contain the priority charged.

    Default:  Blank

    Values:  Character, length 1

    NOTE:  If this is not a priority charging file, leave
           this field blank.