Status probes - STATDEF

The Status probe definition (STATDEF) display identifies a user-program that is to be called by CICSPlex SM at specific intervals.

Supplied views

To access from the main menu, click:

Administration views > RTA MAS resource monitoring > Status probes

Table 1. Views in the supplied **Status probe definitions** (STATDEF) view set
View	Notes
Status probe definitions EYUSTARTSTATDEF.ADDTOGRP	Add a status probe definition to a RTA group.
Status probe definitions EYUSTARTSTATDEF.CREATE	Create a status probe definition and add it to the data repository.
Status probe definitions EYUSTARTSTATDEF.DETAILED	Detailed information about a selected user status probe.
Status probe definitions EYUSTARTSTATDEF.INSTALL	Install a status probe definition in a CICS system or CICS system group.
Status probe definitions EYUSTARTSTATDEF.REMOVE	Remove a status probe definition from the data repository.
Status probe definitions EYUSTARTSTATDEF.TABULAR	Tabular information about user status probe definitions for the CICSplex identified as the context.

Actions

Table 2. Actions available for STATDEF views
Action	Description
ADDTOGRP	Add a status probe definition to a RTA group.
CREATE	Create a status probe definition and add it to the data repository.
INSTALL	Install a status probe definition in a CICS system or CICS system group.
REMOVE	Remove a status probe definition from the data repository.
UPDATE	Update a selected status probe definition.

Fields

Table 3. Fields in STATDEF views
Field	Attribute name	Description
Action definition name	ACTION	The name of an action definition to be used if the status probe definition enters the True state.
Last modification agent	CHANGEAGENT	The change agent identifier that made the last modification. DREPAPI - Resource was last changed by a CICSPlex SM API command. N_A - Resource was created or last updated prior to CICS TS Version 4 Release 1 and support for resource signatures.
Last modification agent release	CHANGEAGREL	The CICS release level of the agent that made the last modification.
Last modification	CHANGETIME	The local date and time when the definition was last changed.
Last modification user ID	CHANGEUSRID	The user ID that made the last modification.
Time created	CREATETIME	The local time when the definition was created.
Description	DESC	An (optional) description of the status definition.
Description code page	DESCCODEPAGE	The code page of the description field.
Interval between calls to status program (seconds)	FREQ	The interval, in seconds, between calls to the status program. The value must be between 1 and 86400.
Evaluation count with HS true before event	HSENTRY	The number of consecutive call frequency intervals, with this severity level, that must result in a true condition before this definition is considered true.
Evaluation count with HS false before resolution	HSEXIT	The number of consecutive call frequency intervals, with this severity level, that must result in a false condition before this definition is considered true.
Evaluation count with HW true before event	HWENTRY	The number of consecutive call frequency intervals, with this severity level, that must result in a true condition before this definition is considered true.
Evaluation count with HW false before resolution	HWEXIT	The number of consecutive call frequency intervals, with this severity level, that must result in a false condition before this definition is considered true.
Evaluation count with LS true before event	LSENTRY	The number of consecutive call frequency intervals, with this severity level, that must result in a true condition before this definition is considered true.
Evaluation count with LS false before resolution	LSEXIT	The number of consecutive call frequency intervals, with this severity level, that must result in a false condition before this definition is considered true.
Evaluation count with LW true before event	LWENTRY	The number of consecutive call frequency intervals, with this severity level, that must result in a true condition before this definition is considered true.
Evaluation count with LW false before resolution	LWEXIT	The number of consecutive call frequency intervals, with this severity level, that must result in a false condition before this definition is considered true.
Name	NAME	The name of the status definition.
Status program name	STATPGM	(Optional) The name of a user-written status program to be called by CICSPlex SM. If the program is to return status information about multiple conditions, you can create one status definition for each condition, where: Each definition identifies the user program. In this case, a separate task is started for each status definition that names a program. Only the first definition identifies the user program. In this case, one task is started for the definition that names the program.
Transaction ID for task	TRANID	(Optional) The transaction identifier under which the status probe is to execute in the target CICS system (optional). If this attribute is not specified, then the transaction the status probe will execute under depends upon the CICS release of the MAS where the status probe executes. If the release is CICS 700 or less, then the transaction ID is COIE. If the release is greater than CICS 700, the transaction ID is CORT.
User ID for task	USERID	(Optional) The ID of the user (defined to your external security manager) that is to be associated with the CICS status probe task running in the MAS (optional). If this attribute is not specified, then the user ID that is associated with the status probe depends upon the CICS release of the MAS where the status probe executes. If the release is CICS 700 or less, then the user ID will be either the PLTPIUSR ID (if specified) or the region user ID. If the release is greater than CICS 700, the user ID will be the region user ID.
Evaluation count with VHS true before event	VHSENTRY	The number of consecutive call frequency intervals, with this severity level, that must result in a true condition before this definition is considered true.
Evaluation count with VHS false before resolution	VHSEXIT	The number of consecutive call frequency intervals, with this severity level, that must result in a false condition before this definition is considered true.
Evaluation count with VLS true before event	VLSENTRY	The number of consecutive call frequency intervals, with this severity level, that must result in a true condition before this definition is considered true.
Evaluation count with VLS false before resolution	VLSEXIT	The number of consecutive call frequency intervals, with this severity level, that must result in a false condition before this definition is considered true.