High-Level Language SWSAPRCV(SDCPAR or SWCPAR) Function
Related Topics
 |
May be used in Shadow/REXX |
|
May be used from Other REXX interpreters |
|
HLL entry point name is SDCPAR or SWCPAR |
Use this call to do a receive and wait from APPC for IMS information.
Call Arguments
The arguments passed to this routing are:
| Type | Argument | Use | Description |
| ptr | hstmt | input | Statement handle. Note: Because only one host rpc can execute at a time for each host session, this value is ignored and must be zero. |
| S9(5) | sql-appc-type | input | Connection type. This should always be set to IMS. |
| X(8) | conversation-id | output | Identifies a conversation to the system. |
| S9(9) | requested-length | i/o | Specifies the maximum amount of data the program is to receive. |
| X(92) | receive-buffer | output | Specifies the buffer which contains the data to be received. |
| S9(9) | atb-retcode | output | The return code that is sent to the local program. |
| X(17) | partner-lu-name | input | The name of the LU at which the partner program is located. |
| S9(9) | atb-data-recvd | output | Specifies what type of data was received. Possible values are b-no-data-received ) 1 (atb-data-received ) 2 (atb-complete-received ) 3 (atb-incomplete-data-received ) |
Return Values
Possible values are:
- SWS_SUCCESS
- The operation succeeded. The specified operation was performed.
- SWS_ERROR
- A parameter validation or run-time error was encountered. Error information is available using the SWSERROR function.
- SWS_ENVIRONMENT_ERROR
- The request can not be processed because of a run-time environmental error. For example, you invoked the API service outside of a Web transaction procedure or from outside the server's address space. Use the server's wrap-around trace to obtain diagnostic information.
Example:
CALL 'SDCPAR' USING STATEMENT-HANDLE SQL-APPC-TYPE CONVERSATION-ID REQUESTED-LENGTH RECEIVE-BUFFER ATB-RETCODE PARTNER-LU-NAME ATB-DATA-RECVD.