DSM/SCM Event Management Programming Manual

Common Definitions
DSM/SCM Event Management Programming Manual—529844-003
4-6
DSM/SCM Definitions
DSM/SCM Definitions
Definitions whose names begin with ZPHI are DSM/SCM definitions. DSM/SCM
definitions are provided in ZSPIDEF.ZPHIDDL and in the corresponding definition files
for other languages.
General information about the DSM/SCM standard definitions is provided here. For
specific information about these definitions as they apply to a particular event
message, see the individual message description in Section 5, Event Messages.
Buffer Declarations
DSM/SCM provides the following buffer declaration for message buffers that can be
used with Subsystem Programmatic Interface (SPI) procedures.
ZPHI-DDL-EVT-BUFFER
is a message buffer whose size is that recommended for a DSM/SCM event
message.
where ZPHI-VAL-EVT-BUFLEN is the buffer length.
Predefined Token and Field Values
Many of the tokens and fields defined by DSM/SCM have predefined values.
DSM/SCM defines these token and field values:
ZPHI-SSN-DSMSCM
is the subsystem number assigned to DSM/SCM. This value name is defined as a
constant in the SPI DDL file, ZSPIDEF.ZSPIDDL.
ZPHI-VAL-ACT-nnn
is a possible value of the ZPHI-TKN-ACT-NM-CD token. The ZPHI-TKN-ACT-NM-
CD token specifies the activity that generated the event:
ZPHI-VAL-ACT-CB-BLD-CNFG
indicates the message was generated by a Build Configuration activity.
def ZPHI-DDL-MSG-BUFFER.
02 Z-MSGCODE type ZSPI-DDL-INT.
02 Z-BUFLEN type ZSPI-DDL-UINT.
02 Z-OCCURS type ZSPI-DDL-UINT.
02 Z-FILLER type ZSPI-DDL-BYTE.
occurs 0 to ZPHI-VAL-EVT-BUFLEN times
depending on Z-OCCURS.
end.