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
- Control is returned to the next sequential instruction (NSI).
- For E-type code, the contents of R14 and R15 are unknown. The
contents of all other registers are preserved across this macro call.
- For C-type code, the contents of all registers are preserved across this
macro call.
- The specified core block reference word is initialized to indicate that a
storage block is no longer held.
- The register specified in the BLOCK parameter is set to zero. The
passed block will be used and released by the SOUTC service routine.
Programming Considerations
This macro can be run on any I-stream.
Examples