Overview

SM2 offers a range of optional monitoring programs that record additional data. A distinction is drawn between privileged monitoring programs, which only an SM2 administrator can start and stop, and monitoring programs for user-specific monitored objects, for which the permission of the SM2 primary administrator is required (see the MODIFY-USER-ADMISSION statement).

The monitoring programs are started and stopped by means of START-MEASUREMENT-PROGRAM and STOP-MEASUREMENT-PROGRAM. For some monitoring programs, monitoring parameters must be defined with the SET-<programname>-PARAMETERS statement and/or the objects to be monitored must be selected with ADD-... and REMOVE-... before the program is started.

The data supplied by the monitoring programs is output on screen and/or to the SM2 output file. To start monitoring programs that output their data exclusively to the SM2 output file, an SM2 output file must be open. All other monitoring programs also write their data to the SM2 output file when it is open. In the case of screen output with some monitoring programs, it is possible to use a SELECT-... statement to select additional, object-specific online reports.

The following table indicates the monitoring programs:

• for which parameters must be defined or the objects to be monitored must be selected

• that output their data exclusively to the SM2 output file

• that output data in an online report on the screen

• that output data in an online report only to privileged users

• for which additional, object-specific reports can be selected.

Monitoring programs	Parameter/monitored object definition	Output exclusively to file	Online output
			Name of the online report	Only privileged users	Selection of additional reports
BCAM-CONNECTION	x		BCAM CONNECTION BCAM MEMORY
CHANNEL-IO (4)(6)	x
CMS (5)
COSMOS	x	x (1)
DAB					x
DISK-FILE	x
DLM			DLM
FILE	x		FILE	x
HSMS
ISAM	x		ISAM ISAM FILE	x
MSCF			MSCF
NSM			NSM
OPENFT	x		OPENFT
PERIODIC-TASK (4)(5)	x		PERIODIC TASK
POSIX			POSIX
PUBSET			PUBSET
RESPONSETIME	x		RESPONSETIME
SAMPLING-DEVICE (4)(6)(7)	x (3)		DEVICE DISK DEVICE TAPE DEVICE TD
SESAM-SQL			SESAM-SQL
SERVICETIME	x	x
SVC	x		SVC
SYSTEM	x		CATEGORY
TASK	x	x
TCP-IP			TCP-IP
TLM			TLM
UDS-SQL			UDS-SQL
UTM			UTM
VM			VM VM CPU POOL VM GROUP
USER FILE			FILE
USER ISAM			ISAM
USER TASK		x (2)

(1)	COSMOS outputs data to a separate output file (see the description of COSMOS).
(2)	Output is to a user-specific SM2 output file.
(3)	Parameter definition is optional because there is a default.
(4)	The online output can be controlled via sort criteria.
(5)	The volume of output information can be controlled.
(6)	The monitoring program is started for all channels when the SM2 subsystem is started.
(7)	The monitoring program cannot be terminated with the STOP-MEASUREMENT-PROGRAM TYPE=*ALL statement, but only with the STOP-MEASUREMENT-PROGRAM TYPE=*SAMPLING-DEVICE statement.