Previous Topic
Table Of Contents
Parent Topic
Next Topic

High-Level Language SWSAPRCV(SDCPAR or SWCPAR) Function

Related Topics

Web Server API Function Index


gfChkMrk.gif (134 bytes) May be used in Shadow/REXX
gfChkMrk.gif (134 bytes) May be used from Other REXX interpreters
gfChkMrk.gif (134 bytes) HLL entry point name is SDCPAR or SWCPAR

Use this call to do a receive and wait from APPC for IMS information.

 

gfGrayBr.gif (1830 bytes)

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 )

gfGrayBr.gif (1830 bytes)

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.
 

 gfGrayBr.gif (1830 bytes)

Example:

CALL 'SDCPAR' USING STATEMENT-HANDLE
SQL-APPC-TYPE
CONVERSATION-ID
REQUESTED-LENGTH
RECEIVE-BUFFER
ATB-RETCODE
PARTNER-LU-NAME
ATB-DATA-RECVD.

Top