April 1, 1981
Accounting Records
The accounting data gathered by VM/370 can help in analysis of overall
system operation. Also, accountinq data can be used to bill users for time and other system resources they use.
There are three types of accounting records: the virtual machine user
records, records for dedicated devices as well as T-disk space assigned
to virtual machine users, and accounting records generated as a result
of user initiated DIAGNOSE X'4C' instruction. A eMS batch virtual
machine creates an accounting record with the userid and account number
of the user who sent his job to the batch machinee Accounting records
are prepared as SO-character card images and sent to a punch file at
various times. output class C
is reserved for accounting records.
If the amount of free storage (available page frames) is relatively
small and the card punch is not periodically assigned to punch CP's
accounting cards, it is possible for CP's accounting routine to
progressively use a significant percentage of the available page frames
and cause a paqe thrashing condition to occur in VM/370. This happens
because the accounting routine creates and maintains accounting records
in real storaqe, and does not free that storage space until the
accounting records are punched on the real system card punch.
To eliminate this problem, it is recommended that one punch pocket be
permanently dedicated to this accounting function, or if that is not
feasible, to punch all the accumulated records every 1 to 2 hours.
Accounting cards are punched and selected to pocket 2 of any class C
card punch when a user logs off of the system, detaches a dedicated
device or T-disk, or issues a DIAGNOSE code X' 4C' instruction. (If the
real punch is a 2540, the accounting cards are put in pocket 3.) These
records should be kept for system accounting purposes.
Accounting Records for Virtual Machine Resource
Usage
The punched in the accountinq card when a user ends his
terminal session (or when the ACNT command is invoked) is as follows
(columns 1-28 contain character data; all other data is in hexadecimal
form, except as noted): 1- 8
9-16
17-28
29-32 33- 36 37-40 41- 44
45- 49-52
53-56
57- 60 Contents Userid-- Account num1::er Date and Time of Accou nting (mmddyyhhmmss)
Number of seconds connected to VM/370 System of processor time used, including time
for VM/370 supervisor functions
Milliseconds of virtual processor time used
Number of page reads
Number of page writes
Number of virtual machine SIO instructions for
nonspooled I/O Number of spool cards to virtual punch
Number of spool lines to virtual printer (this
includes one line for each carriage control command)
Part 2. Control Program (CP) 127

61-64
65-78
79- 80 April 1, 1981
Number of spool cards from virtual reader
Reserved
Accounting card identification code (01) Accounting Records for Dedicated Devices and
Temporary Disk Space Accounting cards are punched and selected to pocket 2 of any class C
card punch when a previously dedicated device and temporary disk space
is released by a user via DETACH, LOGOFF, or releasing from DIAL
(dedicated device only). A dedicated device is any device assigned to a
virtual machine for that machine's exclusive use. These include devices
dedicated by the ATTACH command, those being assigned at logon by directocy entries, or by a user establishing a connection (via DIAL)
with a system that has virtual 2702 or 2703 lines. The information on
the accounting card is as follows (columns 1-28 contain character data;
all other data is in hexadecimal form, except as noted): 1- 8
9-16
17-28
29-32
33
34
35
36
37-38
39-78 79-80 Conte1!ts Userid Account number
Date and Time of Accounting (mmddyyhhmmss)
Number of $econds connected to V"1370 system
Device class
Device type Model (if any)
Feat ure (if any)
Number of cylinders of disk space used (if
any). This information appears only in a code 03 accoun tin g card. Unused Accounting card identification code (02, 03) The device class, device type, model, and feature codes in columns
33-36 are shown in Figure 10. Accounting Records for LOGON, AUTOLOG, and LINK Journaling When LOGON, AUTOLOG, and LINK journaling is on, V"1370 may write type 04, type OS, or type 06 records to the accounting data set. These
records are written under the following circumstances: • Type 04 records are written when V8/370 detects that a user has
issued enough LOGON or AUTOLOG commands with an invalid password to
reach or exceed an installation defined threshold value. • Type 05 records are written when V8/370 detects that a user has
successfully issued a LINK command to a protected minidisk not owned
by that user. • Type 06 records are written when V8/370 detects that a user has
issued enough LINK commands with an invalid password to reach or
exceed an installation defined threshold value.
128 IBM VM/370 System Programmer's Guide