Send Error (QNMSNDER) API


  Required Parameter Group:

1 Handle Input Binary(4)
2 Request identifier Input Char(53)
3 Application error code Input Char(10)
4 Error code I/O Char(*)

  Default Public Authority: *USE

  Threadsafe: No

The Send Error (QNMSNDER) API, an SNA/Management Services Transport API, sends an SNA/Management Services error message to the remote application. This is used by the target application if the remote system is unable to process a request because the request data is not recognized.

If the application that is to receive the error message is on a System i™ platform, it will receive the error message using the Receive Data (QNMRCVDT) API. This operation results in a CPF7AC4 error message being sent, and no data is returned.


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 identifier for the request that contained an error.

*PRV The last request identifier used (for example, the one specified on the Receive Data (QNMRCVDT) API).

Application error code
INPUT; CHAR(10)

The type of failure specified:

*BADDATA The application is unable to interpret the data received.
*CANCEL The application has canceled the processing of the this request.

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.
CPF7ADC E Internal processing error.
CPF7ADD E Operation did not complete.
CPF7ADF E Session failure. Cannot send data at this time.
CPF7AD1 E Application error code value &3 not valid.
CPF7AE2 E Handle &1 not found.
CPF7AE6 E Communication with control point &3.&4 failed.
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 ]