Start Application (QNMSTRAP) API

The Start Application (QNMSTRAP) API, an SNA/Management Services Transport API, starts support for a network management application. The handle returned by this SNA/Management Services program must be used on all subsequent API calls to identify this application. The handle is unique to a specific job.

The Start Application API must be called before any other SNA/Management Services Transport APIs.

Authorities and Locks

Data queue name

*CHANGE

Target data queue

Other than *NONE

Data queue library

*USE

Required Parameter Group

Handle

OUTPUT; BINARY(4)

A variable that represents an instance of an application using some function.

Local application name

INPUT; CHAR(8)

The application name to be associated with the handle.

Qualified data queue name

INPUT; CHAR(20)

The data queue that indicates when asynchronous events occur, and enables an application to receive requests. The first 10 characters specify the data queue object name, and the last 10 characters specify the library name.

The data queue object must exist when this SNA/Management Services program is called. The maximum entry length of the data queue must be at least 80 bytes. You must specify FIFO for the sequence of the data when you create the data queue.

*NONE	A data queue is not used.
The following special values may be specified for the library name:
*LIBL	The library list.
*CURLIB	The job's current library.

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