Customization

SMF Extensions › Features and Benefits › Customization

Customization

Customized SMF/E by assembling and link editing a customization table. Specify the load module name of the table to the SMF/E initialization program when SMF/E is enabled. This table controls the SMF/E billing algorithm. A sample table is provided and is used during the installation verification. To build this customized table, use this table as a starter. The source member name is YJ2000 in CAJRSAMP. The JCL for customization is found in CAJRJCL as a member SMFECUST. SMF/E can also be customized using Software Customization Services (SCS) in the CA Mainframe Software Manager. If SCS is used, a copy of the source that is constructed by SCS can be saved for more detailed customization if necessary.

The assembled table is a collection of four or five subtables.

Rate Table: Contains factors and rates for computing the estimated charge for the batch job.
TSO Rate Table: Contains factors and rates for computing the estimated charge for the session.
Priority Table: Contains weighting factors that are applied to the job charge during the charge calculation that are based on the job priority. (The PRTY value that is for the JOB card or default value that is supplied by JES).
Job Class Table: Contains weighting factors that are applied to the job charge during the charge calculation that are based on the job CLASS.
Config Table: Used to categorize devices into one of five groups that are based on the device address/device number. SMF/E can also determine the device type from the UCB type code in the Type 30 SMF record by specifying GNRC(YES) during activation. This method is preferable to coding the CONFIG entries. If using SCS to customize SMF/E, then the Config Table is not available. Use either the GNRC(YES) option during initialization as recommended, or the SCS generated source that can be modified, reassembled, and relinked outside of SCS.

Manual Customization of SMF/E

All five subtables are assembled in a single CSECT and form a single load module. Each subtable is built from three macros:

CAIJS01: Start a subtable
CAIJS02: Enter rates or other variables to a subtable.
CAIJS03: End a subtable

The format of the CAIJS01 macro specification is fixed for each of the five subtables. Code one of the following values at the beginning of each of the five subtables according to the subtable you are generating.

CAIJS01  PRIORITY,DEFAULT
CAIJS01  JOBCLASS,DEFAULT
CAIJS01  CONFIG,RANGE
CAIJS01  RATE
CAIJS01  TSORATE

Each of the subtables must be terminated with a CAIJS03 macro.

Coding the CAIJS02 macro is more complex than either of the other two. The format varies depending upon which subtable is generated.

CAIJS02 statements in the CONFIG subtable have the format:
CAIJS02 hexlow,hexhigh,device

Where hexlow and hexhigh are three-digit hexadecimal channel-unit addresses or four-digit hexadecimal device number and provide the boundaries of a range for that device type. The device is the four-character device code that is assigned to each device within the range. Valid device types match the CA JARS CONFIG statement options:

READ

Card Reader

WRIT

Printer

PUNC

Card Punch

TAPE

Magnetic Tape Unit

DISK

Direct Access Storage Device

OTHE

Other

The CAIJS02 statements order is not important, except when two CAIJS02 statements include the same address, the device is taken from the first CAIJS02 statement.
CAIJS02 statements in the RATE and TSORATE subtables have the format:
```
CAIJS02 keyword,factor (or rate)
```
The keyword portion of the CAIJS02 statement is a self-defining character string constant and must have one of the values shown in the example. The sample table that is shown here and distributed with the product contains the full set of possible keyword values. Generally, the factor value names a rate or factor that you are specifying. All factors can be specified or set to zero if charging on the particular element is not desired.
CAIJS02 statements in the PRIORITY and JOBCLASS tables have the format:
```
CAIJS02 value,factor
```
Both the value and factor parameters must be specified. Values in the PRIORITY table must be numeric priority values. Values in the JOBCLASS table must be single character job classes. The factor is a weight which is applied to the job charge. The weight is specified as a percentage where 100 percent means that the weight has no effect. 50 percent would reduce the charge in half, and 200 percent would double the charge. This table is included in CAJRSAMP and can be used as your starter table.

Example with a sample table:

YJ2000   TITLE 'JARSTAT RATE TABLES'
YJ2000   CSECT
*                                    JOB PRIORITY TABLE
         CAIJS01 PRIORITY,DEFAULT
         CAIJS02 0,100               PRIORITY 0 OR ANY PRIORITY NOT IN
*                                      THE TABLE BILLS AT 100% X STD
         CAIJS02 13,150              BILL PRIORITY 13 AT 150% X STD
*        .
*        .
*        .
         CAIJS03
*
*                                    JOB CLASS TABLE
         CAIJS01 JOBCLASS,DEFAULT
         CAIJS02 Z,100               BILL JOB CLASS Z, OR ANY CLASS
*                                      NOT IN THE TABLE, AT 100% X STD
         CAIJS02 A,100               BILL JOB CLASS A AT 100% X STD
*        .
*        .
*        .
         CAIJS03
*
*
*                                    RATE TABLE
         CAIJS01 RATE
*
         CAIJS02 BASIC-PROCESSOR-RATE,1000     9999 DOLLARS/HOUR
         CAIJS02 CORE-FACTOR,1.00              99V99 DOLLARS/1K CORE HR
         CAIJS02 ELAPSED-FACTOR,000            999 PERCENTAGE
         CAIJS02 TOTAL-CPU-FACTOR,100          999 PERCENTAGE
         CAIJS02 SRB-CPU-FACTOR,000            999 PERCENTAGE
         CAIJS02 TCB-CPU-FACTOR,000            999 PERCENTAGE
         CAIJS02 READER-I/O-FACTOR,000         9V99 DOLLARS/1000 EXCPS
         CAIJS02 PRINTER-I/O-FACTOR,000        9V99 DOLLARS/1000 EXCPS
         CAIJS02 PUNCH-I/O-FACTOR,000          9V99 DOLLARS/1000 EXCPS
         CAIJS02 TAPE-I/O-FACTOR,5.00          9V99 DOLLARS/1000 EXCPS
         CAIJS02 DISK-I/O-FACTOR,5.00          9V99 DOLLARS/1000 EXCPS
         CAIJS02 OTHER-I/O-FACTOR,000          9V99 DOLLARS/1000 EXCPS
         CAIJS02 CORE-INDICATOR,0              '0' = CORE ALLOCATED
*                                              '1' = CORE USED

         CAIJS03

*
*                                 TSORATE TABLE
         CAIJS01 TSORATE
*
         CAIJS02 BASIC-PROCESSOR-RATE,1000     9999 DOLLARS/HOUR
         CAIJS02 CORE-FACTOR,1.00              99V99 DOLLARS/1K CORE HR
         CAIJS02 ELAPSED-FACTOR,000            999 PERCENTAGE
         CAIJS02 TOTAL-CPU-FACTOR,100          999 PERCENTAGE
         CAIJS02 SRB-CPU-FACTOR,000            999 PERCENTAGE
         CAIJS02 TCB-CPU-FACTOR,000            999 PERCENTAGE
         CAIJS02 READER-I/O-FACTOR,000         9V99 DOLLARS/1000 EXCPS
         CAIJS02 PRINTER-I/O-FACTOR,000        9V99 DOLLARS/1000 EXCPS
         CAIJS02 PUNCH-I/O-FACTOR,000          9V99 DOLLARS/1000 EXCPS
         CAIJS02 TAPE-I/O-FACTOR,5.00          9V99 DOLLARS/1000 EXCPS
         CAIJS02 DISK-I/O-FACTOR,5.00          9V99 DOLLARS/1000 EXCPS
         CAIJS02 OTHER-I/O-FACTOR,000          9V99 DOLLARS/1000 EXCPS
         CAIJS02 CORE-INDICATOR,1              '0' = CORE ALLOCATED
*                                              '1' = CORE USED
         CAIJS02 TPUT-TGET-RATE,1.00           99V99 DOLLARS/1000
         CAIJS02 CONNECT-TIME-RATE,5.00        99V99 DOLLARS/HR
         CAIJS02 ACTIVE-TIME-FACTOR,100        PERCENTAGE


         CAIJS03
*
CONFIG TABLE                     (illustration purposes only)
         CAIJS01 CONFIG,RANGE
         CAIJS02 150,15B,DISK        DISK DEVICE ADDRESS RANGE
         CAIJS02 180,183,TAPE        TAPE DEVICE ADDRESS RANGE
         CAIJS02 380,383,TAPE        TAPE DEVICE ADDRESS RANGE
         CAIJS02 00E,00E,WRIT        PRINTER DEVICE ADDRESS RANGE
         CAIJS02 00D,00D,PUNC        PUNCH DEVICE ADDRESS RANGE
         CAIJS02 00C,00C,READ        READER DEVICE ADDRESS RANGE
         CAIJS02 450,45F,OTHE        OTHER DEVICE ADDRESS RANGE


         CAIJS03
         END

This table can be assembled and link edited into a library that is available to SMF/E activation through STEPLIB or LNKLST.