Program interface for querying system utilization

Application area: SM2 information macro
Macro type: S type (E form/L form/C form/D form)

Macro description

The PFMON macro provides information on the utilization of the overall system. Shares of CPU time (subdivided into idle, TU, TPR and SIH times) and the number of I/O operations for disks, magnetic tapes and other devices are output. The list of operands begins with the standard header. The user can generate a DSECT or data list for the output area.

Macro call format and operand description

Operation	Operands
PFMON	MF = { E,PARAM = { adr / r() } / L / C[,PREFIX = prefix][,MACID = macid] / D[,PREFIX = prefix] }

MF	Describes the form of the macro call (see also the “Executive Macros” manual [4].
=E,...	E form: only the command part of the macro is generated. addr = symbolic address of the operand list. r = register with the address value “addr”.
=L	L form: the standard header and the output area are generated. The output area is not structured.
=C,...	C form: the standard header and a data list for the output area are generated. prefix = prefix (one character) with which the symbolic names in the data list begin. Default: prefix=P. macid = 1 – 3 characters that replace the second to fourth characters in the symbolic names of the data list; Default: macid=FD.
=D,...	D form: a DSECT is generated for the standard header and output area. prefix = prefix (one character) with which the symbolic names in the DSECT begin. Default: prefix=P.

Layout of the output area

PFDDATA	DS	0F	START OF DATA AREA
PFDETIM	DS	F	ELAPSED TIME IN 1/300 SEC
PFDITIM	DS	F	IDLE TIME IN 0.1 MSEC
PFD1TIM	DS	F	TU TIME IN 0.1 MSEC
PFD2TIM	DS	F	TPR TIME IN 0.1 MSEC
PFD3TIM	DS	F	SIH TIME IN 0.1 MSEC
PFDPAGW	DS	F	PAGING I/O
PFDDISW	DS	F	DISK I/O
PFDTAPW	DS	F	TAPE I/O
PFDMISW	DS	F	OTHER I/O
PFDSTIM	DS	CL6	SNAP TIME IN HHMMSS
PFDDLEN	EQU	*-PFDDATA	L'DATA-AREA

Explanation of the fields

Field name	Meaning
PFDDATA	Specifies the beginning of the output area
PFDETIM	Duration of the last SM2 (ONLINE) monitoring cycle (unit = 1/300 seconds)
PFDITIM	Idle time in the last SM2 (ONLINE) monitoring cycle (unit = 100 microseconds)
PFD1TIM	TU time in the last SM2 (ONLINE) monitoring cycle (unit = 100 microseconds)
PFD2TIM	TPR time in the last SM2 (ONLINE) monitoring cycle (unit = 100 microseconds)
PFD3TIM	SIH time in the last SM2 (ONLINE) monitoring cycle (unit = 100 microseconds)
PFDPAGW	PFDPAGW
PFDDISW	Number of DMS disk I/O operations in the last SM2 (ONLINE) monitoring cycle
PFDTAPW	Number of DMS tape I/O operations in the last SM2 (ONLINE) monitoring cycle
PFDMISW	Number of I/O operations on other devices in the last SM2 (ONLINE) monitoring cycle
PFDSTIM	Time stamp at the moment at which the monitoring data is updated by SM2 (end of the relevant SM2 (ONLINE) monitoring cycle) Format: hhmmss (hh=hours, mm=minutes, ss=seconds)

Return code and error indicators

Register R1 contains the address of the parameter list.

A return code is supplied in the standard header relating to execution of the PFMON macro. The values specify hexadecimal constants. When MF=C/D applies, the structure of the return code is explained and equates are offered for the return codes.

Return code:
	c	c	b	b	a	a	a	a

cc	bb	aaaa	Meaning
00	00	0000	Normal execution
00	00	0004	Data supplied, but SM2 subsystem “in delete”
00	01	001C	Data area not accessible
00	01	FFFF	Function not supported
00	03	FFFF	Interface version not supported
00	04	FFFF	Alignment error
00	40	0004	SM2 not active; no monitoring data available
FF	FF	FFFF	Standard header not accessible

• In multiprocessor systems, the time monitoring data that is output for the function statuses represents mean values of the data obtained on the individual processors.

• The number data for the I/O operations represents the sums of the data obtained on the individsual processors.

• Under VM2000 there may be large differences between the sum of the IDLE, TU, TPR and SIH times and the elapsed time on account of the CPU allocation to the different guest systems.