7. DEFINING PARAMETERS › 7.3 Unit Level Parameters › 7.3.1 TSO Application Unit Derivation Routine (TSOAURT)
7.3.1 TSO Application Unit Derivation Routine (TSOAURT)
The TSO Application Unit Identifier (TSOAPU) data element is
used for transaction accounting by CA MICS Accounting and
Chargeback. It is present in the following files:
TSO User Command Counts File (TSOTSC)
TSO User Interactive Usage File (TSOTSI)
TSO Batch User Command Counts File (TSO_BC)
TSO Batch Command Information File (TSO_BI)
TSOAPU is normally set to the value of COMMAND (the TSO
command name). For the TSOTSI and TSO_BI files, TSOAPU can
optionally be set to the value of PROGRAM (the name of the
program executed). TSOAPU differs from the cccAPU field of
other CA MICS products in that it is not part of the file's
key.
The TSO application unit derivation routine (TSOAURT), a
user-written routine, assigns a value to the TSOAPU (TSO
Application Unit) variable.
The TSOAURT routine is invoked once for each observation to
be placed in the files. If an observation is being placed in
the TSOTSC and TSO_BC files, the value of the work variable
WRKTSC is 1. If an observation is being placed in the TSOTSI
and TSO_BI files, the value of the work variable WRKTSI is 1.
These work variables make it possible to determine which file
is currently in use, and to take specific action in the
TSOAURT routine based on the requirements of the file.
The application unit routine is written in SAS and stored in
prefix.MICS.PARMS(TSOAURT). Coding and testing the accuracy
of the exit is your responsibility. However, a sample
application unit derivation routine is provided in the
distributed TSOAURT member. The worksheet for coding the TSO
Application Unit Derivation Routine is shown in Figure 7-3.
PREPARATION
Follow these guidelines for coding this CA MICS exit routine:
1. Validate input data to ensure that they have valid
application units. When invalid codes are
encountered, they should be assigned to the
application codes representing the installation's
overhead account.
2. Ensure that all of the fields that you require are
available for application unit construction.
3. Refer to the discussion of exit coding in Notes on
Coding CA MICS Parameters, Section 2.3.1.5 of the
CA MICS Planning, Installation, Operation, and
Maintenance Guide.
SAMPLE
A sample application unit exit routine is shown below.
/* *********************************************************
** TSOAURT - TSO APPLICATION UNIT EXIT ROUTINE SAMPLE **
** ********************************************************/
/* THIS ROUTINE SETS THE VALUE OF TSOAPU FROM THE COMMAND */
/* NAME FOR THE TSOTSI AND TSOTSC FILES. OTHERWISE, IT IS*/
/* SET TO BLANKS. */
IF WRKTSI OR WRKTSC THEN TSOAPU=COMMAND;
ELSE TSOAPU=BLANKS;
+--------------------------------------------------------------------------+
| INSTALLATION PREPARATION WORKSHEET: TSO Application Unit Routine |
| Definition |
| PARMS Library Member is TSOAURT |
| Reference: Section 7.3.1 - CA MICS TSO Analyzer Guide |
+--------------------------------------------------------------------------+
| |
| * VALIDATE FOR VALID APPLICATION UNITS, WHERE POSSIBLE ; |
| |
| ________________________________________________________________________ |
| |
| ________________________________________________________________________ |
| |
| ________________________________________________________________________ |
| |
| ________________________________________________________________________ |
| |
| ________________________________________________________________________ |
| |
| ________________________________________________________________________ |
| |
| ________________________________________________________________________ |
| |
| ________________________________________________________________________ |
| * BUILD APPL. UNIT FIELDS; |
| TSOAPU =field source 1 || |
| field source n ; |
| ________________________________________________________________________ |
| |
| ________________________________________________________________________ |
| |
| ________________________________________________________________________ |
| |
| ________________________________________________________________________ |
| |
| ________________________________________________________________________ |
| |
| ________________________________________________________________________ |
| |
| ________________________________________________________________________ |
| |
| |
+--------------------------------------------------------------------------+
| ....5...10...15...20...25...30...35...40...45...50...55...60...65...70.. |
+--------------------------------------------------------------------------+
Figure 7-3. TSO Application Unit Routine Worksheet
