Start Application (QNMSTRAP) API


  Required Parameter Group:

1 Handle Output Binary(4)
2 Local application name Input Char(8)
3 Qualified data queue name Input Char(20)
4 Error code I/O Char(*)

  Default Public Authority: *USE

  Threadsafe: No

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

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.
CPF7ADA E Data queue &4/&3 not valid.
CPF9800 E All CPF98xx messages could be signaled. xx is from 01 to FF.

API introduced: V2R2

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