Generic alert and resolution structures

This reference topic describes the structure of SNA generic alerts and resolutions that are used by CICSPlex® SM.

The generic alert structure

The CICSPlex SM Alert MS major vector contains generic alert information in a number of 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 dependent 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 the following subfields:
  • 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 the following subfields:
  • 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

The resolution structure

The Resolution (X'0002') MS major vector has the same structure as the Alert MS major vector, except for two "Detailed Data" common subfields of the Cause Undetermined MS subvector:
  • The first "Detailed Data" common subfield of the Cause Undetermined MS subvector always contains spaces in the Evaluation Last Evaluated Data (89-132) field of the ALERTVER(1) version of the record.
  • The second of the two Detailed Data common subfields of the Cause Undetermined MS subvector contains the text of the Exit Msg from the action definition rather than the Enter Msg text.