Creating and Using the Accounting Table

The VM Interface › Creating and Using the Accounting Table

Creating and Using the Accounting Table

The User Accounting Table gives you the ability to select, reject, or modify VM accounting data. You define the table to select the records you want to process. When a record is selected, you can use the table to assign a specific CPU ID and/or accounting information to the record.

The translate component scans the User Accounting Table for an entry whose virtual machine ID and account number match the VM accounting record. The table is searched sequentially. The CPU ID and User Accounting Information fields from the first entry that matches the account record are inserted into the output history record. If no match is found, the output CPU ID field contains blanks and the output User Accounting Information field contains the virtual machine account number as set by CP from the information in the user directory.

Each table entry is scanned for comparison, character by character. An asterisk (*) can be used to represent any character in a character string for searching purposes; however, it can appear only once within a given VM ID or VM account number. You can place the asterisk in any position in either the VM ID or Account Number. This wild card technique lets you reduce the number of entries in your table based on identical character strings found in VM IDs and Account Numbers. The following table shows how you can use wild cards in the matching process.

Position	VM ID	VM Account #	Result
Prefix	DEV01	*	Gives you a match for any account number providing the last five characters of the VM ID are DEV01.
Suffix	SYS*	117*	A match occurs for an account number whose first three characters are 117 providing the first three characters of the VM ID are SYS.
Middle	APL*01	*	A match occurs against any account number and if the first three characters of the VM ID are APL and the last two 01.

If a table entry is specified using the DELETE option, any account record that matches a table entry is rejected from further processing. Conversely, the KEEP option allows processing of the record to continue; this includes placing any CPU ID and User Account Information into the output history record. You build a User Accounting Table by assembling a set of CAIJV01 macro instructions. A dummy User Accounting Table is included as CAJRSAMP(CAIJV01A). This source program will create the distributed default User Accounting table found in CAJRLOAD(CAIJV01). If used, it allows all records to be processed and assigns a blank CPU ID. CAIJV01 macro instructions are input to the macro assembler, and must follow the rules for coding macro statements. Two more complex sample User Accounting Tables are included in CAJRSAMP members CAIJV11A and CAIJV14A to illustrate the format required.

You first create a User Accounting Table as an ordinary z/OS file, using ISPF or the editor of your choice. When you have entered the necessary statements, you assemble the file, then link edit it into a load library. These steps are described in the Creating a User Accounting Table section of this chapter. Sample assembly and link-edit JCL are found in CAJRJCL(CAIJVMAT).