CHANGE-ISAM-STATISTICS Include and exclude ISAM pools

Every SM2 user can use the CHANGE-ISAM-STATISTICS statement to select one or more ISAM pools whose monitored data is to be output or no longer output in the next monitoring interval. The user can only include ISAM pools for monitoring provided the SM2 administrator has permitted the user-specific monitoring program ISAM. If this is the case, the entry ISAM appears in the USER MEASUREMENTS ALLOWED line of the SM2 MEASUREMENT STATUS screen.

If ISAM pool monitoring has been permitted, each user can activate or deactivate global ISAM pools and all task-local ISAM pools which have been or will be set up under his/her user ID.

SM2 supports the simultaneous monitoring of up to 16 ISAM pools for the set of all users.

Indirect selection of a pool by specifying a file contained in the pool is reserved for the SM2 administrator.

Format

Operation

Operand

CHANGE-ISAM-STATISTICS

[ADD-POOL =     { *NONE /       (*POOL({ POOL-NAME=poolname1 /                [,SCOPE = { *HOST-SYSTEM / *TASK(TSN=tsn) }] /                [,CAT-ID = { *HOME / catid }]              }) [,*POOL( )]...)     }]  [,REMOVE-POOL =     { *NONE /       (*POOL({ POOL-NAME=poolname1 /                [,SCOPE = { *HOST-SYSTEM / *TASK(TSN=tsn) }] /                [,CAT-ID = { *HOME / catid }]              }) [,*POOL( )]...) /       *OWN     }]

Operands

ADD-POOL	Defines which ISAM pools are to be included in the monitoring process.
=*NONE	No ISAM pools are included in the monitoring process.
=*POOL( )	Defines which ISAM pools are to be monitored. Up to 16 ISAM pools can be defined in one list.
POOL-NAME
=poolname1	Defines a pool name up to 8 characters in length.
SCOPE	Defines the type of ISAM pool.
=*HOST-SYSTEM	The pool is a global ISAM pool.
=*TASK( )	The pool is a task-local ISAM pool. The TSN operand defines the task under which the ISAM pool has been set up.
TSN=tsn	TSN of the task under which the task-local ISAM pool has been set up.
CAT-ID	Catalog ID of the pubset to which the ISAM pool has been assigned. This specification is part of the identification of the ISAM pool (in addition to the specifications for POOL-NAME and SCOPE).
=*HOME	The catalog ID is the one of the home pubset.
=catid	Catalog ID of the pubset to which the ISAM pool has been assigned.
REMOVE-POOL	Defines which ISAM pools are to be excluded from the monitoring process.
=*NONE	No ISAM pools are to be excluded from the monitoring process.
=*OWN	Only those ISAM pools included by a user in the monitoring process are excluded.
=*POOL( )	See the description of ADD-POOL=*POOL( )

The *POOL structure name can be omitted, but if so it must not occur anywhere else in the statement.