The generic alert structure
The CICSPlex® SM Alert MS major vector contains generic alert information in a number of subvectors.
The CICSPlex SM Alert MS major vector contains the following subvectors.
- "Generic Alert Data" (X'92') MS subvector
- This identifies the Alert Description code as "IMPENDING PROBLEM: THRESHOLD HAS BEEN REACHED" (X'4012').
- "Probable Causes" (X'93') MS subvector
- This identifies a single code point specifying "PERFORMANCE DEGRADED" (X'4000').
- "Cause Undetermined" (X'97') MS subvector
- This contains:
- A "Recommended Actions" (X'81') common subfield. This identifies one code point specifying "REVIEW" (X'00A1').
- Two "Detailed Data" (X'82') common subfields containing:
- Data ID of "THRESHOLD PARAMETER" (X'7111'), with
EBCDIC encoding. The contents are dependant on the ALERTVER CMAS
System Parameter (EYUPARM) used by the CMAS identified in the ACTNDEF
associated with the event.
ALERTVER(0) and ALERTVER(1) records contain the following characters:
- 0-2
- Creator (SAM ] MRM ] APM)
- 3-5
- RTA Event Severity (VLS | VLW | LW | HW | HS | VHS)
- 6-13
- RTA Event name (RTADEF name |STATDEF name | !!SAMxxx)
- Data ID of "PROBLEM DATA" (X'F511'), with EBCDIC
encoding, containing the following characters:
- 0-29
- The text of the "Enter Msg" from the action definition (ACTNDEF)
ALERTVER(1) records also contain the following:
- 14-16
- Alert Version (001)
- 17-19
- Priority (001-255)
- 20-27
- Sequence
- 28-29
- Evaluation Logical Operator (GT | GE |EQ |NE |LE |LT)
- Data is only available for RTADEF events. The field contains spaces for STATDEF and SAM events.
- 30-32
- Evaluation Type ( VAL | THR) - VALuation or THReshold.
- Data is only available for RTADEF events. The field contains spaces for STATDEF and SAM events.
- 33-44
- Evaluation Resource Table Attribute
- Data is only available for RTADEF events. The field contains spaces for STATDEF and SAM events.
- 45-88
- Evaluation Data
- Data is only available for RTADEF events which have an Evaluation Type of VAL. The field contains spaces for all other events.
- 89-132
- Evaluation Last Evaluated Data
- Data is only available for RTADEF events. The field contains spaces for STATDEF and SAM events.
- Data ID of "THRESHOLD PARAMETER" (X'7111'), with
EBCDIC encoding. The contents are dependant on the ALERTVER CMAS
System Parameter (EYUPARM) used by the CMAS identified in the ACTNDEF
associated with the event.
- "Product Set ID" (X'10') MS common subvector
- a "Product ID" (X'11') common subvector that identifies
the product as IBM® Software (X'04') and contains:
- A "Product Number" (X'08') Product ID subfield that identifies the product number as 5655S97.
- A "Product Common Name" (X'06') Product ID subfield that identifies the common name as CICSPLEX.SM.
- A "Product Common Level" (X'04') Product ID subfield that identifies the version, release, and modification levels.
- "Hierarchy/Resource List" (X'05') MS common subvector
- This contains:
- A "Hierarchy Name List" (X'10') Hierarchy/Resource
List subfield, which contains the following list elements:
Element Resource Type Resource Name 1 Service point (X'81') RTA CONTEXT 2 Unspecified device (X'00') RTA SCOPE 3 Unspecified device (X'00') RTA RESOURCE TYPE or SAM EVENT NAME - An "Associated Resource List" (X'11') subfield,
which contains a 16-character EBCDIC resource name that identifies
either the event name or the instance key from the CICSPlex SM
resource table associated with the event. For SAM events the "Associated
Resource List" is set as follows:
- !!SAMMAX, !!SAMOPS or !!SAMNRM
- blank
- !!SAMSDM
- The 6-character system dump code
- !!SAMSOS
- The character DSA name or SOS location
- !!SAMSTL
- The character stall reason
- !!SAMTDM
- CCCCTTTTUUUUUUUU, where CCCC is the 4-character transaction dump code, TTTT is the 4-character transaction dump name and UUUUUUUU is the User Id associated with the dumping task.
- A "Hierarchy Name List" (X'10') Hierarchy/Resource
List subfield, which contains the following list elements:
- "Incident Identification" (X'4A') MS common subvector
- This contains an "Incident Identification" (X'01')
Incident Identification subfield. This uses encoding type X'01'.
The fields are as follows:
- Field
- Contents; Length
- Netid:
- Periods; 8 characters
- Network addressable unit:
- APPLID of the originating CMAS; 8 characters
- Application name:
- CICSplex name; 8 characters
- Unique id:
- CMAS name concatenated with GMT timestamp; 16 characters