The SWSAPSND Function
Related Topics
 |
May be used in Shadow/REXX |
|
May be used from Other REXX Interpreters |
| |
HLL entry point name is SDCPAR or SWCPAS |
The REXX-language SWSAPSND built-in function can be used to send data to an IMS transaction. This function requires that an active connection already be established to IMS.
Upon return from the call, the following Rexx variables are populated with data:
| APPC.STMTHDL | The statement handle for the interface call. |
| APPC.CONVID | The Conversation ID for the IMS APPC conversation. |
| APPC.OUTBUFF.0 | The length of the data contained within the APPC.OUTBUFF.1 Rexx variable. |
| APPC.OUTBUFF.1 | The returned Message Output Descriptor data. The output message contains the MOD data as well as a two byte length prefix. This variable contains the data, including any supplied trailing blanks. |
| APPC.RETCODE | The APPC Interface return code. |
| APPC.DATATYPE | The returned datatype. |
SWSAPSND Syntax
The general form for a REXX-language invocation of SWSAPSND is:
rc = SWSAPSND("Connection Type", ,
"Conversation ID", ,
"Transaction Data", ,
"Partner LU Name")
| Connection Type | Specifies the type of IMS transaction to execute IMS IMS Non-conversational transaction. IMSCONV IMS Conversational transaction. Note: Required parameter. |
| Conversation ID | Specifies the IMS Conversation ID. Note: Required parameter. |
| Transaction Data | Specifies any data required by the application program in order to process the
transaction. This would be data in the format of the Message Input Descriptor (without the
LLZZ prefix). Note: Required parameter. |
| Partner LU Name | Specifies the APPC LU Name for the IMS system Note: Optional parameter. |
| Synchronization Level | Specifies whether or not confirmation processing will be performed on this
conversation. NONE No confirmation processing is required for this conversation. CONFIRM Confirmation processing is required for this conversation. Note: Optional parameter. If used, it requires that placeholders be specified for the Partner LU Name. |
SWSAPSND Examples
/*-------------------------------------------------------------*/
/* initialize some system values */
/*-------------------------------------------------------------*/
address SWSSEND
imsappc = 'P390.P392AIMS'
imstran = 'NEONDISP'
parms = ''
/*-------------------------------------------------------------*/
/* Send data into IMS */
/*-------------------------------------------------------------*/
rc = swsapsnd('ims',APPC.CONVID,parms,imsappc)