Table of Contents
Advertisement
~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
Advertisement
Table of Contents
