Considerations For Ssinit; Using Zspi-Tkn-Maxresp; Declaring The Pathway Subsystem Id - HP NonStop Pathway/iTS Programming Manual

SPI Programming Considerations

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
ZPWY^VAL^SSID.Z^VERSION
For TACL:
#SET ZPWY^VAL^SSID &
[ZSPI^VAL^TANDEM].[ZSPI^SSN^ZPWY].[ZPWY^VAL^VERSION]
For C:
zpwy_val_ssid_def
or
#include stringb
strcopy ( zpwy_val_ssid.z_owner, ZSPI_VAL_TANDEM };
strcopy ( zpwy_val_ssid.z_number
strcopy ( zpwy_val_ssid.z_version = ZPWY_VAL_VERSION };
NonStop Pathway/iTS Management Programming Manual—426749-002
:= ZSPI^SSN^ZPWY;
:= ZPWY^VAL^VERSION;
zpwy_val_ssid ={ ZSPI_VAL_TANDEM,
3- 20
Considerations for SSINIT
ZSPI_SSN_ZPWY
ZPWY_VAL_VERSION };
= ZSPI_SSN_ZPWY };