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:
    1. 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)
    2. 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.
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.
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