2. INSTALLATION › 2.3 Activating Accounting for Data Sources › 2.3.4 External Journal File in Accounting-Only Unit
2.3.4 External Journal File in Accounting-Only Unit
The procedures in this section are used to define and
activate a unit intended only for external file accounting.
The section is divided into three parts:
o Build an Accounting-Only Unit
o Review Complex-Level Accounting Parameters
o Finalize and Activate the Accounting-Only Unit
Build an Accounting-Only Unit
-----------------------------------------------------
Use the Generate the New Database Unit checklist, Section
3.8.1.4, in the PIOM to build your accounting-only unit.
While following the checklist, make the following
modifications:
o PIOM Section 3.8.1.4, Step 4
When you define JCLDEF in prefix.MICS.PARMS:
- Use only the ACT component in the COMPONENT statement.
- Leave the SMFRECORDING statement blank.
- Specify NO for the three ARCHIVE statements.
- Delete or comment out the BACKUP FREQ statement.
Neither the DAILY or the WEEKLY job will be run.
o PIOM Section 3.8.1.4, Step 23
When you define EXECDEF in prefix.MICS.PARMS, set the
three REPORT MBO statements to none.
o PIOM Section 3.8.1.4, Steps 28 through 30
Skip steps 28 through 30. These steps are not required
for an accounting-only unit.
Review Complex-Level Accounting Parameters
-----------------------------------------------------
Review the value of the ACCTMGDG parameter in
sharedprefix.MICS.PARMS(JCLDEFC). The ACCTMGDG parameter
specifies the number of generations of monthly audit files
to be maintained in the monthly generation data group:
o If you want to maintain complex-level audit files, ensure
the ACCTMGDG parameter is set to any numeric value greater
than zero.
o If you do not want to maintain complex-level audit files,
ensure the ACCTMGDG parameter is set to zero.
If no ACCTMGDG parameter is specified, the default is set to
85, meaning 85 generations will be kept.
+----------------------------------------------+
| Reference(s): PIOM Section 2.3.1.6 |
+----------------------------------------------+
If you change the ACCTMGDG parameter, you must regenerate
the GDGSGENC job as follows for the new parameter value to
take effect:
__ 1. Edit sharedprefix.MICS.PARMS(JCLGENUC) so that it
contains the following line:
GDGSGENC
__ 2. Regenerate GDGSGENC by submitting the following
job:
SUB 'sharedprefix.MICS.CNTL(JCLGENUC)'
Finalize and Activate the Accounting-Only Unit
-----------------------------------------------------
To finalize and activate the accounting-only unit, you must
define an accounting journal file, specify the external file
data source, define rates, and so on. Complete the
following steps using the CA MICS Workstation Facility
(MWF):
__ 1. Specify the journal file
o Select Option S, Special Requirements (MWF;4;2;S),
to display the Special Requirements menu.
o Select Option 2, Journal File Eligibility
(MWF;4;2;S;2), to display the File Selection panel.
o Use the insert line command to add the FDA or
external journal files that you want to create.
When you have finished typing, press the END key to
return to the Journal File Eligibility panel.
Press END again to return to the Special
Requirements menu. You will be prompted to run the
CA MICS algorithm generation job (MAGRUN).
o Press END on the Special Requirements menu to
return to the Installation Accounting Primary
Options menu.
o Select Option 3, Parameter Specification and
Generation (MWF;4;2;3), to specify data center
accounting component parameters.
+----------------------------------------------+
| Reference(s): Sections 4.13 through 4.13.2 |
+----------------------------------------------+
__ 2. Optionally update invoice category table
A default invoice category table is distributed with
the system. To provide maximum flexibility, you can
make additions or changes so that the reporting
structure is consistent with your data center's
requirements.
o Select Option 3, Invoice Category Definition (MWF
4;2;3;3), on the Parameter Specification and
Generation menu to display the Invoice Category
Definition panel and make necessary changes.
+---------------------------------------------------+
| Reference(s): Sections 4.2.2 through 4.2.2.2 |
+---------------------------------------------------+
__ 3. If you will be using 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 have added, deleted, or changed any qualification
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 enter
CANCEL because the Invoice Category Generation will
be performed by the External File Generation job that
you will run in step 4.
You can also submit the CHRGROUP job from TSO as
follows:
SUB 'sharedprefix.MICS.CNTL(CHRGROUP)'
__ 4. Optionally define charging elements
Select Option 5, Charging Element Definition (MWF;
4;2;3;5), on the Parameter Specification and
Generation menu to display the Charging Element
Definition panel. Use the select line command to
change the specifications for a charging element.
+-------------------------------------------------+
| Reference(s): Sections 4.2.1 through 4.2.1.2 |
+-------------------------------------------------+
__ 5. Specify Journal File Rate Table Parameters
o Select Option 6, Rate Table (MWF;4;2;3;6), from the
Parameter Specification and Generation menu to
display the Component and File Selection panel. If
Accounting and Chargeback is installed in more than
one database unit, the Unit Selection panel will be
displayed prior to the Component and File Selection
panel. Select the unit in which you want to set
the Rate Table parameters. You must specify Rate
Table parameters for each unit in which you want to
use Accounting and Chargeback.
The Component and File Selection panel shows each
journal file that you can activate in the selected
database unit. To activate a journal file, use the
Select line command to display the Rate Table File
Options menu.
o Select Option 1, Journal File Specifications
(MWF;4;2;3;6;1), to specify the number of journal
file cycles, prorating, and zone charging
information.
+---------------------------------------------------+
| Reference(s): Sections 4.3.1.2 through 4.3.1.2.2 |
+---------------------------------------------------+
o Select Option 2, Journal File Exit (MWF;4;2;3;6;2),
to invoke a user exit that will be taken
immediately before the output of each journal file
observation.
+---------------------------------------------------+
| Reference(s): Sections 4.3.1.3 through 4.3.1.3.2 |
+---------------------------------------------------+
o Select Option 3, Algorithm Selection and
Specification (MWF;4;2;3;6;3), to create one or
more sets of charging algorithms to be used for the
journal file. Each algorithm consists of a set of
computation codes and rates. Insert a line for
each algorithm and 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.
For example, the Linux journal file ACTJLX is
delivered with the default algorithm identifier
LNX and associated computation codes.
Note that when a standard CA MICS journal file is
selected for the first time, the default rate table
for that file is copied into your rate table with
all rates set to zero and the journal file marked
ACTIVE. All of the charges will be zero unless you
change one or more to a non-zero value.
+---------------------------------------------------+
| Reference(s): Sections 4.3.1.4 through 4.3.1.4.2 |
+---------------------------------------------------+
o Select Option 4, Algorithm Qualification
(MWF;4;2;3;6;4), to specify the work to which each
algorithm applies.
+---------------------------------------------------+
| Reference(s): Sections 4.3.1.5 through 4.3.1.5.2 |
+---------------------------------------------------+
o Select Option 5, External Journal File
Specifications (MWF;4;2;3;6;5), to identify the
external file dataset name and to specify whether
date range validation should be performed when the
external journal file update job runs.
Option 5 is used for non-Linux external files. For
Linux external files using the ACTJLX journal file,
specify the external file dataset using Option 8.
The non-Linux external Journal File ddname must
always be INPUTACT. This DD statement will be
included in the generated ACTfffTB job for the
file, where fff represents the last three
characters of the external file name.
On the Option 5 panel is the prompt:
Date Range Validation ===> (YES or NO)
You should code YES if you want the update job
to eliminate input records whose ENDTS values
come before the last datetime in the checkpoint.
o Select Option 6, External Journal File Input
Routine (MWF;4;2;3;6;6), to define the SAS routine
used to input the external file data. This
selection contains a sample SAS routine that inputs
Linux process-level data generated by the Linux
accounting ACCT command.
o Select Option 7, External Journal File
Preprocessing Exit (MWF;4;2;3;6;7), if you require
SAS code to preprocess the data from your external
file before it is read in by the external journal
file input routine previously specified with Option
6.
o If you need to sort the input in such a way that
duplicate observations are removed, the basic input
and the sort should be coded in the preprocessing
exit of Option 7. The output of the sort should be
accessed in the Option 6 code. Here is an outline
of this process:
In the Preprocessing Exit (MWF;4;2;3;6;7), code
DATA INPUTSRT;
INFILE INPUTACT;
INPUT var1 var2 ... ENDTS ;
FORMAT ENDTS DATETIME20.2;
PROC SORT DATA=INPUTSRT NODUP;
BY var1 var2 ... ENDTS;
The variable names on the INPUT statement are
whatever you need. The ENDTS is included here
since it will likely be an important part of the
sort sequence that removes duplicate observations.
Note that this exit will be saved in member
prefix.MICS.USER.SOURCE(ACTUfffR).
Go into Option 6 (MWF;4;2;3;6;6). Enter the line
SET INPUTSRT END=ACTEOF;
This is all that is necessary to make the
chargeback to work if you have coded all of the
needed variables in the Preprocessing Exit.
Otherwise you should add any other statements or
variable definitions that you need after this SET
statement. Note that "END=ACTEOF" is required on
the SET statement since this is the code for Option
6.
o Select Option 8, Linux Option Specification Member
(MWF;4;2;3;6;8), to specify Linux external file
dataset names and other Linux specific parameters.
This option is used in conjunction with the Linux
ACTJLX journal file.
+---------------------------------------------------+
| Reference(s): Sections 2.3.4.1 through 2.3.4.2 |
+---------------------------------------------------+
o The COSTCTRn definitions should be made at this
time and should be based on the variables that are
defined in Options 6 through 8. Lines should be
added to sharedprefix.MICS.PARMS(COSTRTE) as
follow:
IF ROUTINE = 'fffINPUT' THEN DO;
/* SET COST CENTER FOR fff */
COSTCTR1=var1;
COSTCTR2=var2;
COSTCTR3=var3;
END;
See section 4.1.3 - Assigning Cost Center Values.
For information on setting COSTCTRn values by
looking up values in a table, see section 4.4.5 -
Entering Cost Center Look Up Table Values.
o After completing the journal file specification and
activation activities listed above, submit the
MAGRUN job. MAGRUN will generate the unit-level
external job in prefix.MICS.CNTL under the name
ACTULXTB. This external update job will include
the ddname and the dataset names specified in Step
4, option 5 or 8 above.
If you make any changes to the journal file
specifications, you are automatically prompted to
submit MAGRUN when you press the END key to exit
from the Rate Table Component and File Selection
panel.
You can also submit the MAGRUN job manually. It is
located in prefix.MICS.CNTL(MAGRUN).
Copyright © 2014 CA.
All rights reserved.
|
|