gtps1m54System Macros

SOUTC-Write Path Information Unit (PIU) Systems Network Architecture (SNA) Input/Output (I/O)

Use this system macro to send data to a systems network architecture (SNA) logical unit (LU) or a SNA resource.

Required Authorizations
Key0 Restricted System Common Storage

X

Format




Dx|Rx
An optional data block is attached to a specified core block reference word (CBRW). The data level may be coded directly (D0|...|DF) or may be contained in a register (R0|...|R6).

This parameter is positional and, when coded, must be the first parameter. This parameter is required when the passed data block is attached to an entry control block (ECB).

BLOCK=Rx
The data to be sent resides in a data block that is not attached to an ECB. The register specified (R0|...|R6|R14) contains the address of the block. The data block must be either a 4-KB block or a system work block (SWB). The address in the specified register must be consistent with the ADSPACE parameter, ECB virtual memory or system virtual memory (SVM). This parameter is only valid when issued by C-type code.

TYPE
An optional parameter used to denote special processing.

F
Indicates that RID to SID conversion will be bypassed.

X
Indicates a channel contact operation (prenegotiation XID, negotiation XID, nonactivation XID contact, or discontact) is to be initiated. No other parameters except ADSPACE parameter are valid when TYPE=X is coded. When called from a C-type program, the ADSPACE parameter is required.

L
Indicates that a core chained PIU is being sent.

H
Indicates that a network layer packet (NLP) is being sent over a rapid transport protocol (RTP) connection for one of the following conditions:
  • Retransmit a message that was lost in the network
  • Send a message that was dequeued from the RTP output queue
  • Send a high-performance routing (HPR) control message
  • Send an NLP, but bypass session address (SA) to resource identifier (RID) conversion
  • Send an NLP that is completely built.

ADSPACE
This parameter is required and is only valid when issued by C-type code. It is used to indicate the address space in which the code is executing in the ECB virtual memory (EVM) or system virtual memory (SVM).

EVM
The program that processed the SOUTC is running in the EVM.

SVM
The program that processed the SOUTC is running in the SVM.

Entry Requirements

Return Conditions

Programming Considerations

This macro can be run on any I-stream.

Examples