Specifications - MONSPEC

The Monitor specifications (MONSPEC) views display information about CICS resource types that are to be monitored by CICSPlex SM. A monitor specification identifies the types of resources to be monitored and how frequently information about these resources is to be gathered. After you associate a monitor specification with a CICS system, that specification is automatically installed every time the CICS system starts.

Supplied views

To access from the main menu, click:

Administration views > Monitor administration views > Specifications

Table 1. Views in the supplied Monitor specifications (MONSPEC) view set
View Notes
Monitor specifications

EYUSTARTMONSPEC.ADDSYSDEF

Associate a monitor specification with a CICS System.
Monitor specifications

EYUSTARTMONSPEC.ADDSYSGRP

Associate a monitor specification with a CICS System Group.
Monitor specifications

EYUSTARTMONSPEC.CREATE

Create a monitor specification and add it to the data repository.
Monitor specifications

EYUSTARTMONSPEC.DETAILED

Detailed information about a selected monitor specification.
Monitor specifications

EYUSTARTMONSPEC.REMOVE

Remove a monitor specification from the data repository.
Monitor specifications

EYUSTARTMONSPEC.TABULAR

Tabular information about all monitor specifications within the current context.

Actions

Table 2. Actions available for MONSPEC views
Action Description
ADDSYSDEF Associate a monitor specification with a CICS System.
ADDSYSGRP Associate a monitor specification with a CICS System Group.
CREATE Create a monitor specification and add it to the data repository.
REMOVE Remove a monitor specification from the data repository.
UPDATE Update a selected monitor specification.

Fields

Table 3. Fields in MONSPEC views
Field Attribute name Description
Monitor activation status ACTSTATUS Indicates whether monitoring is to be activated or not during the initialization of an associated CICS system.

The field comes into effect only when 'Monitoring status' is set to 'INHERIT' in the associated definition for the CICS system (CSYSDEF). This field does not apply to monitoring definitions installed dynamically, or dynamic changes made to active monitoring.

Last modification agent CHANGEAGENT The change agent identifier that made the last modification.
  • DREPAPI - Resource was last changed by a CICSPlex SM API command.
Last modification agent release CHANGEAGREL The CICS release level of the agent that made the last modification.
Last modification CHANGETIME The local time when the definition was last changed
Last modification user ID CHANGEUSRID The user ID that made the last modification.
Sample interval for CICS region monitoring CICSSAMP The number of seconds in the range 1 - 86400 that CICSPlex SM is to wait between requests to collect sample data for the named type of monitoring. A value of 0 means that no resource monitoring is to occur.

Note: The field comes into effect only when the CICSSAMP is set to INHERIT in the associated definition for the CICS system (CSYSDEF).

Sample interval for connection monitoring CONNSAMP The number of seconds in the range 1 - 86400 that CICSPlex SM is to wait between requests to collect sample data for the named type of monitoring. A value of 0 means that no resource monitoring is to occur.

Note: The field comes into effect only when the CONNSAMP is set to INHERIT in the associated definition for the CICS system (CSYSDEF).

Time created CREATETIME The local time when the definition was created.
Sample interval for DB2 and DBCTRL monitoring DBXSAMP The number of seconds in the range 1 - 86400 that CICSPlex SM is to wait between requests to collect sample data for the named type of monitoring. A value of 0 means that no resource monitoring is to occur.

Note: The field comes into effect only when the DBXSAMP is set to INHERIT in the associated definition for the CICS system (CSYSDEF).

Description DESC A description of the monitor specification.
Description code page DESCCODEPAGE The code page of the description field.
Sample interval for file monitoring FILESAMP The number of seconds in the range 1 - 86400 that CICSPlex SM is to wait between requests to collect sample data for the named type of monitoring. A value of 0 means that no resource monitoring is to occur.

Note: The field comes into effect only when the FILESAMP is set to INHERIT in the associated definition for the CICS system (CSYSDEF).

Sample interval for global region monitoring GLBLSAMP The number of seconds in the range 1 - 86400 that CICSPlex SM is to wait between requests to collect sample data for the named type of monitoring. A value of 0 means that no resource monitoring is to occur.

Note: The field comes into effect only when the GLBLSAMP is set to INHERIT in the associated definition for the CICS system (CSYSDEF).

Sample interval for journal monitoring JRNLSAMP The number of seconds in the range 1 - 86400 that CICSPlex SM is to wait between requests to collect sample data for the named type of monitoring. A value of 0 means that no resource monitoring is to occur.

Note: The field comes into effect only when the JRNLSAMP is set to INHERIT in the associated definition for the CICS system (CSYSDEF).

Specification NAME The name of the monitoring specification.
Sample interval for program monitoring PROGSAMP The number of seconds in the range 1 - 86400 that CICSPlex SM is to wait between requests to collect sample data for the named type of monitoring. A value of 0 means that no resource monitoring is to occur.

Note: The field comes into effect only when the PROGSAMP is set to INHERIT in the associated definition for the CICS system (CSYSDEF).

Data retention period RETENTION The number of minutes collected data is to be kept after resource monitoring stops. (Resource monitoring stops when the CICS system stops or when the MAS view command is used to stop resource monitoring for the CICS system.) The retention period can be:
  • 1 - 1440
    • Collected data is to be kept the specified number of minutes.
  • 0
    • Collected data is not to be kept.
  • INHERIT
    • The CICS system is to use the value specified with its associated monitor specification.
Note: This value can be overridden by the RETENTION value set in CSYSDEF and MAS views.
Resource status facility CMAS name RODMCMAS Identifies the CMAS that is to handle all the resource status facility requests associated with this monitor specification.
Sample interval for TDQ monitoring TDQSAMP The number of seconds in the range 1 - 86400 that CICSPlex SM is to wait between requests to collect sample data for the named type of monitoring. A value of 0 means that no resource monitoring is to occur.

Note: The field comes into effect only when the TDQSAMP is set to INHERIT in the associated definition for the CICS system (CSYSDEF).

Sample interval for terminal monitoring TERMSAMP The number of seconds in the range 1 - 86400 that CICSPlex SM is to wait between requests to collect sample data for the named type of monitoring. A value of 0 means that no resource monitoring is to occur.

Note: The field comes into effect only when the TERMSAMP is set to INHERIT in the associated definition for the CICS system (CSYSDEF).

Sample interval for transaction monitoring TRANSAMP The number of seconds in the range 1 - 86400 that CICSPlex SM is to wait between requests to collect sample data for the named type of monitoring. A value of 0 means that no resource monitoring is to occur.

Note: The field comes into effect only when the TRANSAMP is set to INHERIT in the associated definition for the CICS system (CSYSDEF).



eyua7bg1.html | Timestamp icon Last updated: Sunday, 4 June 2017