Statements for SM2 administrators

These statements are used by SM2 administrators to control data acquisition by SM2. The statements for assigning authorizations to nonprivileged users and for admitting other SM2 administrators are only available to the SM2 primary administrator

Statements for switching between the  evaluation part and the administration  part

Statement	Function
CALL-ADMINISTRATION-PART	Switch from the  evaluation part to the administration  part
CALL-EVALUATION-PART	Switch from the administration partto the  evaluation part

Statements for defining monitoring programs

Some monitoring programs require you to specify which objects are to be monitored and with what parameters. The ADD, REMOVE, SET and MODIFY statements are provided for this purpose.
The ADD statements each define an object to be monitored by a particular monitoring program. The REMOVE statements can be used to exclude a set of monitored objects, defined with the aid of ADD statements, from the monitoring process. The SET statements define a list of objects to be monitored or the monitoring parameters. The MODIFY statements can be used to modify the default values. The objects to be monitored or the monitoring parameters defined using the statements listed above can be output using the SHOW-DEFINED-PARAMETERS statement. Monitoring of the defined objects does not begin until the monitoring programs are started (using the START-MEASUREMENT-PROGRAM statement) or restarted (using CHANGE-MEASUREMENT-PROGRAM).
The monitoring program definitions become active and can be output using the SHOW-ACTIVE-PARAMETERS statement.

Statement	Function
ADD-BCAM-CONNECTION-SET	Add a connection set for BCAM-CONNECTION monitoring
ADD-CONNECTION-SET	Add a connection set (applications) for RESPONSETIME monitoring
ADD-COSMOS-EVENT	Define events for monitored-data acquisition
ADD-FILE	Define a file to be monitored
ADD-ISAM-FILE	Define an ISAM pool (data space) to be monitored
ADD-ISAM-POOL	Define an ISAM pool to be monitored
ADD-OPENFT-INSTANCE	Define an openFT instance to be monitored
MODIFY-COSMOS-PARAMETERS	Modify the parameters for COSMOS monitoring
MODIFY-RESPONSETIME- PARAMETERS	Modify the parameters for RESPONSETIME monitoring
REMOVE-BCAM-CONNECTION-SET	Exclude a connection set from BCAM-CONNECTION monitoring
REMOVE-CONNECTION-SET	Exclude a connection set from RESPONSETIME monitoring
REMOVE-COSMOS-EVENT	Remove events from the COSMOS monitoring parameters
REMOVE-FILE	Remove file(s) from the FILE monitoring parameters
REMOVE-ISAM-FILE	Remove ISAM pool (data space) from the ISAM monitoring parameters
REMOVE-ISAM-POOL	Remove ISAM pool(s) from the ISAM monitoring parameters
REMOVE-OPENFT-INSTANCE	Remove an openFT instance from the OPENFT monitoring parameters
SET-BCAM-CONNECTION-PARAMETERS	Define BCAM-CONNECTION monitoring parameters
SET-CHANNEL-IO-PARAMETERS	Define CHANNEL-IO monitoring parameters
SET-COSMOS-PARAMETERS	Define COSMOS monitoring parameters
SET-DISK-FILE-PARAMETERS	Define DISK-FILE monitoring parameters
SET-PERIODIC-TASK-PARAMETERS	Define PERIODIC-TASK monitoring parameters
SET-RESPONSETIME-PARAMETERS	Define RESPONSETIME monitoring parameters
SET-SAMPLING-DEVICE-PARAMETERS	Specify recording of service times for disk devices
SET-SERVICETIME-PARAMETERS	Define SERVICETIME monitoring parameters
SET-SYSTEM-PARAMETERS	Define SYSTEM monitoring parameters
SET-TASK-PARAMETERS	Define TASK monitoring parameters

Statements for preparing, starting, and stopping monitoring programs

Once you have defined the objects to be monitored and the monitoring parameters, the monitoring program run can be started.
Certain preparations are recommended for the COSMOS monitoring program to ensure that it starts quickly and without errors. After defining new monitored objects/monitoring parameters, the monitoring program run must be stopped and then started again in order to actually add the newly defined objects and parameters to the monitoring program. The INITIATE, START, CHANGE and STOP statements are used for this purpose.

Statement	Function
INITIATE-COSMOS	Prepare the COSMOS monitoring program
START-MEASUREMENT-PROGRAM	Start the monitoring program run
CHANGE-MEASUREMENT-PROGRAM	Stop the current monitoring program run and restart it with new monitored objects/monitoring parameters
STOP-MEASUREMENT-PROGRAM	Terminate the monitoring program run

The START statement is used to start the monitoring programs. The CHANGE statement is required following the redefinition of monitored objects/monitoring parameters of the monitoring program run in order to add the new objects/parameters to the monitoring program. The monitoring program run is stopped and then started with the new monitored objects/monitoring parameters. The STOP statement terminates the specified monitoring programs.

The START, CHANGE and STOP statements merely interrupt the current monitoring cycle.

Statements for opening and closing the SM2 output file and controlling monitored-data acquisition

In addition to the output of reports on the screen, monitored data can be continuously written to file. Creating the SM2 output file (OPEN-LOG-FILE) and closing it (CLOSE-LOG-FILE) is a privilege reserved for SM2 administrators. The OPEN-LOG-FILE statement can be used to modify the predefined SM2 file attributes.

The MODIFY-MEASUREMENT-PERIODS statement can be used to modify the monitoring cycles for background monitoring (collecting and writing monitored data to the SM2 output file), and to modify the screen output and the sampling cycle.

Statement	Function
OPEN-LOG-FILE	Open the SM2 output file
CLOSE-LOG-FILE	Close the SM2 output file
MODIFY-MEASUREMENT-PERIODS	Modify the SM2 monitoring cycle

Statements for assigning privileges

After the subsystem is started, monitoring of tasks, files and ISAM pools by the nonprivileged user is not permitted. But by using the MODIFY-USER-ADMISSION statement, the primary SM2 administrator can grant or withdraw permission for all BS2000 users to monitor tasks under their own ID, files and ISAM pools. The MODIFY-ADMINISTRATOR-ADMISSION statement allows the primary SM2 administrator to admit additional (secondary) administrators.

Statement	Function
MODIFY-USER-ADMISSION	Define authorizations for nonprivileged users
MODIFY-ADMINISTRATOR-ADMISSION	Admit additional SM2 administrators

Statements for outputting information

The SHOW statements provide information on the monitoring status, the objects, and the monitoring parameters for selected monitoring programs, as well as on the status of the SM2 system tasks.

Statement	Function
SHOW-MEASUREMENT-STATUS	Output the monitoring status
SHOW-DEFINED-PARAMETERS	Output defined monitoring parameters
SHOW-ACTIVE-PARAMETERS	Output active monitoring parameters
SHOW-USER-MEASURED-OBJECTS	Output monitored objects and associated users
SHOW-SM2-STATUS	Output the status of SM2 system tasks
SHOW-SELECTED-HOSTS	Output selected hosts

Statement for specifying hosts for administration statements and screen outputs

This statement is used to specify the hosts to which the SM2 administration statements apply and for which the screens are to be output.

Statement	Function
SELECT-HOSTS	Define hosts for SM2 statements and screen output

Statement for terminating the SM2 program

The END statement is used to terminate the SM2 session. However, monitoring operations which have already been initiated are not affected, i.e. they continue to run.

Statement	Function
END	Terminate the SM2 run

The following sections describe the statements for SM2 administrators in alphabetical order.

In all statements which allow you to use wildcard syntax, only the character * is supported as the last character. All other constructs possible in SDF are rejected with a error message.

The internal program name for syntax validation in SM2 statements in EDT is SM2<ver>.