Deregister Application (QNMDRGAP) API


  Required Parameter Group:

1 Handle Input Binary(4)
2 Error code I/O Char(*)

  Default Public Authority: *USE

  Threadsafe: No

The Deregister Application (QNMDRGAP) API, an SNA/Management Services Transport API, removes the registration of the application name associated with a handle. The QNMDRGAP API only deregisters the application; the application can continue to send requests as long as replies are expected.

Only registered applications can receive requests from remote systems. After an application is deregistered, the remote applications are sent error messages notifying them that the application is not available to receive requests. In addition, it can no longer receive error messages from requests that did not request a reply. Therefore, the application should not send any request-only data.

The QNMDRGAP API is used by applications that do not want to continue receiving requests. The End Application (QNMENDAP) API automatically removes registration before ending the application instance. See the End Application (QNMENDAP) API for more information.


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.

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.
CPF7ADC E Internal processing error.
CPF7AEE E Application &2 not registered.
CPF7AE2 E Handle &1 not found.
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 ]