gtps2m2r | ACF/SNA Data Communications Reference |
The following services may be requested:
The TPF SNA system segment (CSU0) is provided for applications to request the session services.
To start a particular session service, a TPF application:
CSU0 resides in all subsystems.
The ISHLL macro defines the parameter area that should reside in working storage. The parameter area settings for each service call are described in detail in Table 7, Table 8, and Table 9.
The service program (CSU0) sets the return code field (ISHLRC) in the
parameter area and returns control to the calling program.
Interface | Input to CSU0 | Returned from CSU0 |
---|---|---|
Registers | R1: ISHLL Parameter List Address | R0-R7: Not changed |
ECB Workarea |
|
|
Data Levels | Irrelevant | Not Changed |
Protect Key | Working Storage | Working Storage |
Table 8. Request Session Resynchronization Interface
Label | Length (In Bytes) | Description |
---|---|---|
ISHLREQ | 1 | X'01' RESYNCH SESSION REQUEST |
ISHLTYP | 1 | Reserved |
ISHLRC | 1 | Return Code (output only)
|
ISHLSW | 1 | Indicator, reserved for TPF internal usage. |
ISHLSNAM | 4 | Secondary LU Name Address
The address of a 16-byte field that contains the NETID and the Network Qualified LU name of the resource functioning as secondary LU (SLU) for the requested session. The NETID is an 8-character string left-justified and padded with blanks. The name, which immediately follows the NETID, is also an 8-character string left-justified and padded with blanks. |
ISHLPNAM | 4 | Primary LU Name Address
The address of a 16-byte field that includes the NETID and the Network Qualified LU name of the resource functioning as primary LU (PLU) for the requested session. The NETID is an 8-character string left-justified and padded with blanks. The name, which immediately follows the NETID, is also an 8-character string left-justified and padded with blanks. |
Table 9. Request Session Termination Interface
Label | Length (In Bytes) | Description |
---|---|---|
ISHLREQ | 1 | Deactivate Session Request (X'02') |
ISHLTYP | 1 | Type of Deactivation
|
ISHLRC | 1 | Return Code (output only)
|
ISHLSW | 1 | Indicator, reserved for TPF internal usage. |
ISHLSNAM | 4 | Secondary LU Name Address
The address of a 16-byte field that contains the NETID and the Network Qualified LU name of the resource functioning as secondary LU (SLU) for the requested session. The NETID is an 8-character string left-justified and padded with blanks. The name, which immediately follows the NETID, is also an 8-character string left-justified and padded with blanks. |
ISHLPNAM | 4 | Primary LU Name Address
The address of a 16-byte field that contains the NETID and the Network Qualified LU name of the resource functioning as primary LU (PLU) for the requested session. The NETID is an 8-character string left-justified and padded with blanks. The name, which immediately follows the NETID, is also an 8-character string left-justified and padded with blanks. |