SPI Programming Considerations
NonStop Pathway/iTS Management Programming Manual—426749-002
3-20
Considerations for SSINIT
Considerations for SSINIT
When setting up a call to SSINIT, you need to consider the following information.
Using ZSPI-TKN-MAXRESP
ZSPI-TKN-MAXRESP is used by some subsystems to enable multiple responses in a
single response buffer. Because the Pathway subsystem does not support multiple
responses in a single response buffer, ZSPI-TKN-MAXRESP is only useful if your
management application must handle all subsystems in a consistent manner; that is, if
Pathway responses must be enclosed in data lists. To reference the Pathway
subsystem alone, it is not necessary to specify ZSPI-TKN-MAXRESP.
You can include ZSPI-TKN-MAXRESP by using SSINIT or SSPUT. If you do not
include this token in the command message or you include it but set the value to zero,
the PATHMON process returns a single response. If you include ZSPI-TKN-MAXRESP
and assign a nonzero value, the PATHMON process returns a single response and
encloses that response in a data list. (The ZSPI-TKN-DATALIST token precedes the
response, and the ZSPI-TKN-ENDLIST token follows the response.)
Declaring the Pathway Subsystem ID
The Pathway subsystem ID is expressed by the value ZPWY-VAL-SSID, defined in
Section 4, “SPI and EMS Standard Definitions,” in the TS/MP Management
Programming Manual.
These declarations produce an appropriately initialized structure for COBOL. For TAL,
TACL, and C, your program must initialize the structure explicitly, as follows:
For TAL:
ZPWY^VAL^SSID.Z^OWNER.Z^B ':=' [ ZSPI^VAL^TANDEM ];
ZPWY^VAL^SSID.Z^NUMBER := ZSPI^SSN^ZPWY;
ZPWY^VAL^SSID.Z^VERSION := ZPWY^VAL^VERSION;
For TACL:
#SET ZPWY^VAL^SSID &
[ZSPI^VAL^TANDEM].[ZSPI^SSN^ZPWY].[ZPWY^VAL^VERSION]
For C:
zpwy_val_ssid_def zpwy_val_ssid ={ ZSPI_VAL_TANDEM,
ZSPI_SSN_ZPWY
ZPWY_VAL_VERSION };
or
#include stringb
strcopy ( zpwy_val_ssid.z_owner, ZSPI_VAL_TANDEM };
strcopy ( zpwy_val_ssid.z_number = ZSPI_SSN_ZPWY };
strcopy ( zpwy_val_ssid.z_version = ZPWY_VAL_VERSION };