Pathway/iTS Management Programming Manual

SPI Programming Considerations

NonStop Pathway/iTS Management Programming Manual—426749-002

3-20

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 };

#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 };