SM2R1 transfer file records

The detailed description of the records provides the following information on every record field:

• contents of the record field

• data format: binary, floating or alphanumeric representation

• length of the field (in bytes)

• field displacement, counting from the beginning of the data area; for fields within a monitored object group or repeat group, counting starts from the beginning of the group (marked by a “+”).

A 4-byte control field (record length field), whose first two bytes contain in binary form the length of the record, including the control field, always comes before the actual data area of each record.

TIM2 record

The TIM2 record contains the data from the TIME record (Version 10.0). The only difference is that dates and times are output in ISO4 format. The date and time are separated by a “T”.

Displacement	Length	Format	Meaning
0	4	character	TIM2 identification
4	19	character	Start of the analysis period (= 1st time stamp in the period) in the format yyyy-mm-ddThh:mm:ss
23	19	character	End of the analysis period (= last timestamp in the period) in the format yyyy-mm-ddThh:mm:ss
42 46	4 4	binary binary	Length of a subinterval: Number of days Number of seconds
50	19	character	Start of grid subdivision in the format yyyy-mm-ddThh:mm:ss
69	2	binary	Number of selected time slots
from 71 to 111	8 8	character character	Description of time slot (3 times): Start of the time slot in the format: hh:mm:ss End of the time slot in the format: hh:mm:ss
119	2	binary	Number of excluded time periods
from 121 to 216	19 19	character character	Description of excluded time periods (3 times): Start of the exclusion period in the format yyyy-mm-ddThh:mm:ss End of the exclusion period in the format yyyy-mm-ddThh:mm:ss
235 237 245 247	2 8 2 8	binary character binary character	Description of a regularly excluded time period (once only) Start of the exclusion period: Day of week (*) Time in the format hh:mm:ss End of the exclusion period: Day of week (**) Time in the format hh:mm:ss
255	2	binary	Number of entries per DATA record

(*)	The day of the week can have the values 0 (= no regular exclusion period) and 1 through 7 (1 being Monday, 7 being Sunday).
(**)	The day of the week can have the values 1 through 7 (one being Monday, 7 being Sunday), and also the values 8 (Monday) through 13 (Saturday). The values 8 through 13 are required if the excluded time period selected extends over a weekend.

SYST record

A “T” is used to separate the date and time when they are represented in ISO4 format.

Displacement	Length	Format	Meaning
0	4	character	SYST identifier
4 6 8 10 12 14	2 2 2 2 2 2	binary binary binary binary binary binary	Point in time at which this system information was obtained Year Month Day Hour Minute Second
16	8	character	Name of BS2000 system
24	3	character	Operating system version number
27	8	character	Creation date of the generated system in the form yy/mm/dd
35	8	character	SM2 version designation
43	8	character	SM2R1 version designation
51	8	character	MTFILE version designation
59	4	binary	Size of main memory (in 4-Kb pages, minus 1)
63	21	character	Configuration name
84	4	binary	Size of virtual class 1 memory (4 Kb)
88	4	binary	Size of virtual class 2 memory (4 Kb)
92	4	binary	reserved
96	4	binary	Task address space (in 1-Kb pages)
100	2	binary	Length of a monitored object group
102	2	binary	Displacement between the first monitored object group and the beginning of the record
104	2	binary	Number of monitored object groups
106	19	character	Time this system information was obtained in the format yyyy-mm-ddThh:mm:ss
125	10	character	Creation date for the generated system in the format yyyy-mm-dd
135	8	character	Host name

The identification is supplied for each processor in the monitored object group.

Monitored object group:

Displacement	Length	Format	Meaning
+0	4	binary	Processor ID reserved for the processor
+4	4	-	reserved

CONF records

Each CONF record consists of the record header and at least one repeat group. The repeat groups can be global information, channel, controller or device. The entry under the “record identifier” header indicates the repeat group in question.

If all CONF records are consecutively read to memory and the header is omitted, the individual repeat groups can be located with the aid of the displacement values and the number given in the repeat group entitled “global information”.

The “device” repeat group can only occur once in a CONF record, followed by at least one of its path repeat groups.

A set of CONF records might then have the following appearance:

Record header	global
Record header	CHA	CHA	CHA
Record header	CTL	CTL	CTL
Record header	DEV	Path repeat group
Record header	DEV	Path repeat group	Path repeat group
Record header	DEV	Path repeat group
Record header	DEV	Path repeat group

CONF record

Record header:

Displacement	Length	Format	Meaning
0	4	character	CONF' identification
4	2	binary	Length of a repeat group entry
6	2	binary	Displacement between the first repeat group and the beginning of the record
8	2	binary	Number of repeat groups in this record
10	1	binary	Record identifier X'00': global information X'02': channel record X'03': controller record X'04': device record

Record identifier X'00' – global information

Repeat group:

Displacement	Length	Format	Meaning
+0	2	binary	Length
+2	2		Not used
+4	8	character	Identification (C'$DSTATUS')
+12	8		Not used
+20	4	binary	Displacement for the first channel information value
+24	4	binary	Number of channel information values
+28	4	binary	Displacement for the first controller information value
+32	4	binary	Number of controller information values
+36	4	binary	Displacement for the first device information value
+40	4	binary	Number of device info. values
+44	4		Not used

Record identifier X'02' – channel
Repeat group:

Displacement	Length	Format	Meaning
+0	2	binary	Length
+2	2		Not used
+4	4	character	Identification (C'CHN')
+8	4		Reserved
+12	1	binary	Channel type
+13	1	binary	Channel path ID
+14	4	character	IO-SIDE number or X'FFFFFFFF'

Record identifier X'03' – controller
Repeat group:

Displacement	Length	Format	Meaning
+0	2	binary	Length
+2	2		Not used
+4	4	character	Identification (C'CTL')
+8	4	character	Controller mnemonic
+12	1	binary	Controller type
+13	1	binary	Difference in controller type

Record identifier X'04' – device
Repeat group:

Displacement	Length	Format	Meaning
+0	2	binary	Length
+2	2		Not used
+4	4	character	Identification (C'DEV')
+8	4	character	Device mnemonic
+12	1	binary	TSOS device type
+13	4		Reserved
+17	1	binary	Device information: X'01': unit record device X'02': disk device X'04': tape device X'10': paging device X'20': public device X'40': device switchable X'80': shared private disk device
+18	4		Reserved
+22	6	character	VSN
+28	4	character	TSN of the device user task
+32	4	character	TSN of the device owner task
+36	2	binary	Length of the path repeat group
+38	2	binary	Displacement for the first path repeat group
+40	2	binary	Number of path repeat groups

Path repeat group:

Displacement	Length	Format	Meaning
+0	1	binary	Channel path ID
+1	1	binary	CTL#/DEV# or controller and device address
+2	1	binary	Display of path availability
+3	1		Reserved
+4	4	character	Controller mnemonic
+8	4		Reserved
+12	4	character	X'FFFFFFFF'

DSCR record

Displacement	Length	Format	Meaning
0	4	character	DSCR identification
4	2	binary	Report number
6	2	binary	Variable number (1 –
8	40	character	Description of monitoring value
48	2	binary	Length of monitoring group description (l1)
50	(l1)	character	Description of monitoring group

DATA record

Displacement	Length	Format	Meaning
0	4	character	DATA identification
4	2	binary	Report number
6	2	binary	Monitoring value number (1 –
8	4	float	Average value over the entire analysis period
12	4	float	Maximum value over the entire analysis period
16	4	float	Minimum value over the entire analysis period
20	4	float	Standard deviation over the entire analysis period
24	4	float	Number of subintervals in the analysis period, including monitored values
from 28	4 each	float	Values of individual subintervals

As of a displacement of 28, the DATA contains the values of the individual subintervals.

The total number of data entries is contained in the TIM2 record.

The number of data entries not equal to 0 is contained in the DATA record. If this value is 0, no values follow.