Accounting records

Structure of the FT accounting records

The FT accounting record is divided into four parts:

1. record definition

2. identification section

3. basic information

4. variable information

The record sections contain the displacement, length and format of the data field.

The field number identifies the sequence number within the part of the record written.

The displacement is the position of the data field relative to the beginning of the part of the record that has been written.

The length is the length of the data field in bytes.

The format is the format of the data field:

A = alphanumeric (including $, #, and @)

B = binary number

C = printable characters

F = file name for BS2000

Z = unpacked decimal number (0...9)

- = undefined

1. Record definition section

The record definition section contains the record identifier, the time of day, the length of the identification section and the length of the basic information.

Field No.	Displ.	Length	Format	Meaning
1	00	4	A	Record identifier ‘FTR0‘
2	04	8	- /B	Time stamp of the time-of-day clock
3	0C	2	B	Length of the identification section
4	0E	2	B	Length of the basic information
5	10	4	-	Reserved

Layout of the record definition section

2. Identification section

The identification section contains the user ID, account number and job number (TSN).

Field No.	Displ.	Length	Format	Meaning
1	00	8	A	User ID
2	08	8	A	Account number
3	10	4	Z	Job number (TSN) (This field applies only to locally issued requests.)

Layout of the identification section

3. Basic information

The basic information includes

• Date and time when the FT request was stored,

• Date and time when the transfer ended,

• Result of the transfer,

• Details of the start of follow-up processing,

• Name of the remote system,

• Indication as to whether the accounting record was written by the local or the remote system,

• Identification of the FT request,

• Number of disk accesses,

• Number of bytes written to or read from disk,

• Number of bytes sent to or read from the accounting record.

Field No.	Displ.	Length	Format	Meaning
1	00	12	Z	Time when the file transfer request was stored (format: yymmddhhmmss; this field applies only to locally issued requests)
2	0C	12	Z	Time when the transfer ended (format: yymmddhhmmss)
3	18	1	C	Result of the transfer: + : successful execution - : execution with errors 0 : not used
4	19	1	C	Result of the start of follow-up: + : successful execution - : execution with errors 0 : not used
5	1A	8	A	Partner name
6	22	1	A	Specifies whether the request was issued in local or remote system: L : the request was submitted in the local system R : the request was submitted in the remote system
7	23	11	Z	Transfer ID
8	2E	2	-	Reserved
9	30	4	-	Reserved

Layout of the basic information

Field No.	Displ.	Length	Format	Meaning
10	34	4	B	Number of disk accesses
11	38	8	B	Number of bytes on disk
12	40	8	B	Number of bytes in network

Layout of the basic information

4. Variable information

Field No.	Displ.	Length	Format	Meaning
1	00	2	B	Number of extensions = 4
2	02	2	B	Displacement of the record extension for the file name from the start of record
3	04	2	B	Displacement of the record extension for the library member name from the start of record
4	06	2	B	Displacement of the record extension for the century part of the time specification from the start of the record
5	08	2	B	Displacement of the record extension for the CPU time from the start of the record
The variable information includes the file name and the name of the library member.

Header of the variable section

Field No.	Displ.	Length	Format	Meaning
1	00	2	A	Extension identification = ‘FN‘
2	02	1	B	Extension type = x‘00‘
3	03	1	B	Length of the file name
4	04	see field 3	F	File name
If a displacement is set to 0, the corresponding record extension has not been specified.

Record extension for the file name

Field No.	Displ.	Length	Format	Meaning
1	00	2	A	Extension identification = ‘MN‘
2	02	1	B	Extension type = x‘00‘
3	03	1	B	Length of extension (not including identification, type and length field)
4	04	8	A	Library member type
5	0C	24	A	Library member version
6	24	8	Z	Library member variant
7	2C	1	B	Length of library member name
8	2D	see field 7	A	Library member name

Record extension for the library member name

Field No.	Displ.	Length	Format	Meaning
1	00	2	A	Extension identification = ‘YY‘
2	02	1	B	Extension type = x‘00‘
3	03	1	B	Length of extension (not including identification, type, length field) = 4
4	04	2	Z	Time at which the request was stored in the form yy (see field 1 in the basic information)
5	06	2	Z	Time of transfer in the form yy (see field 2 in basic information)

Record extension for the century part of the time specification

Field No.	Displ.	Length	Format	Meaning
1	00	2	A	Extension identification = ‘MS‘
2	02	1	B	Extension type = x‘00‘
3	03	1	B	Length of extension (not including identification, type, length field) = 4
4	04	4	B	Number of machine commands required in the local system by this request (in units of 10,000 commands)

Record extension for CPU time