IBM System/360 System Programmer's Guide

~RITING AN ACCOUNTING ROUTINE
The conventions that you must follow when writing an accounting
routine and the accounting informaticn that is supplied by the operating
system are described in the following text.
Entry to the Accounting Routine: Your accounting routine receives
control during job and step terrrination. The entry point of your
accounting routine must be named IEFACTRT. You can specify this name in
either a CSECT staterrent or an ENTRY statement.
The first sequence of instructions in your routine must save the
contents of registers 0 through 14. You can use the SAVE macro-
instruction to perform this function; register 13 contains the address
of a register save area.
Input to the Accounting Routine: Register 1 contains the starting
address of a list of pointers to accounting information. Each pointer
is on a full-word boundary. The items in the list ana the order in
which they appear are as follows:
1. 4-byte pointer to the 8-byte jot name area.
2. 4-byte pointer to the 8-byte step name area. The pointer to the
step name is zero when the job is terminated.
3. 4-byte pointer to the 20-byte prograrrmer's name area.
4. 4-byte pointer to the job running time.
1
The job running time is
contained in the first three bytes of a 4-tyte area. The last byte
contains the number of jeb accounting data fielas.
5. 4-byte painter to the job accounting data fields. If the JOB
statement did not contain accounting information this pointer
indicates a four-byte field whose last byte is zeroed. These data
fields contain the accounting information that was specified in the
JOB statement. The first byte of each data field contains the
number of bytes of data that follow. All job accounting data
fields are contiguous in main storage. The last data field is
followed by a byte of zeros.
6. 4-byte painter to the step running tirre.
1
The step running time is
contained in the first three bytes of a 4-byte area. The last byte
contains the number of step accounting data fields. The pointer to
the step running time is zero when the job is terminated.
7. 4-byte pointer to the step accounting data fields. These fields
contain the accounting information that was specified in the EXEC
statement. The first byte of each data field contains the number
of bytes of data that follow. All step accounting data fields are
contiguous in main storage. The last data field is followed by a
byte of zeros. If the EXEC statement did not contain an
ACCT=parameter, the pointer ind~cates a one-byte field of zeros.
The pointer to the step accounting data fields is zero when the jot
is terminated.
1Job running time and step running time are not supplied unless you have
selected multiprogramming with a variable nurrter of tasks and intsrval
timing. However, if only timing is selected, you can use the timer
macro-instructions in your accounting routine. An explanation of these
features is contained in the publication IBM System/360 Operating
System: Storage Estimates, Form C28-6551.
40

IBM System/360 Specifications

General

Brand	IBM
Model	System/360
Category	Desktop
Language	English