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 receiving the error message is on an iSeries server, 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
Top | Network Management APIs | APIs by category