Receive Operation Completion (QNMRCVOC) API


  Required Parameter Group:

1 Handle Input Binary(4)
2 Request identifier Input Char(53)
3 Remote application name Output Char(24)
4 Error code I/O Char(*)

  Default Public Authority: *USE

  Threadsafe: No

The Receive Operation Completion (QNMRCVOC) API, an SNA/Management Services Transport API, receives an operation completion, which allows an application to determine if a send operation completed successfully. This is only used by applications that do not wait for a send operation to complete (wait time parameter equals 0). This API must be used after an application receives an entry on the data queue confirming the completion of an operation.

If the operation did not complete successfully, an error code is returned or an exception is signaled based on IBM® i error-handling rules.


Authorities and Locks

None.


Required Parameter Group

Handle
INPUT; BINARY(4)

The unique identifier for this application, which was returned by the Start Application (QNMSTRAP) API.

Request identifier
INPUT; CHAR(53)

The request identifier of the operation completion reply that is to be received.

*PRV The last request identifier used (for example, the one returned on the Send Request (QNMSNDRQ) API).

Remote application name
OUTPUT; CHAR(24)

The name of the remote application that received the data. The first 8 characters contain the network ID, the second 8 characters contain the control point name (or the logical unit name may be used), and the third 8 characters contain the application name of the remote application.

Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.


Error Messages

Message ID Error Message Text
CPF24B4 E Severe error while addressing parameter list.
CPF3C90 E Literal value cannot be changed.
CPF3CF1 E Error code parameter not valid.
CPF7AC0 E &3.&4 cannot receive data at this time.
CPF7AC2 E Previous send operation not complete.
CPF7ADC E Internal processing error.
CPF7ADF E Session failure. Cannot send data at this time.
CPF7AE0 E Function requested not supported by remote system.
CPF7AE2 E Handle &1 not found.
CPF7AE5 E Control point &3.&4 not found.
CPF7AE6 E Communication with control point &3.&4 failed.
CPF7AE7 E Remote application program &5 not found.
CPF7AE9 E Request identifier not valid.
CPF9872 E Program or service program &1 in library &2 ended. Reason code &3.


API introduced: V2R2

[ Back to top | Network Management APIs | APIs by category ]