Register Application (QNMREGAP) API

Required Parameter Group:

1	Handle	Input	Binary(4)
2	Category	Input	Char(8)
3	Application type	Input	Char(10)
4	Replace Registration	Input	Char(10)
5	Error code	I/O	Char(*)

Default Public Authority: *USE

Threadsafe: No

The Register Application (QNMREGAP) API, an SNA/Management Services Transport API, registers the application name specified in the previous start application operation so that it may receive unsolicited requests. A given application name may only be registered once on the system.

Applications must be registered to receive requests and error messages when a reply is not expected. The application name used is specified on the Start Application (QNMSTRAP) API. See the Start Application (QNMSTRAP) API for more information.

The only applications that do not need to register are those issuing requests and expecting replies.

If the value of the replace registration parameter is *YES, a previously registered application with the same name can no longer receive requests.

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.

Category

INPUT; CHAR(8)

The SNA/Management Services function set group with which the application is associated. The only allowed value is:

*NONE

Not associated with any category.

Application type

INPUT; CHAR(10)

The role the application is performing:

*EPAPP	An entry point application.
*FPAPP	A focal point application.

Replace registration

INPUT; CHAR(10)

Whether or not this registration should replace a previous registration that has the same local application name.

*YES	This registration should replace any previous registration with the same local application name. Any other SNA/Management Services program that previously registered with the same local application name can no longer receive incoming requests.
*NO	Do not replace previous registrations. If another SNA/Management Services program in the same or different job is already registered for this local application name, then it continues to receive incoming requests. Error message CPF7AED is issued if that application is already registered.

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.
CPF7ADB E	Replace registration value &3 not valid.
CPF7ADC E	Internal processing error.
CPF7AEB E	Category value &3 not valid.
CPF7AED E	Application &2 already registered.
CPF7AEF E	Application type &3 not valid.
CPF7AE2 E	Handle &1 not found.
CPF9872 E	Program or service program &1 in library &2 ended. Reason code &3.

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.

CPF7ADB E

Replace registration value &3 not valid.

CPF7ADC E

Internal processing error.

CPF7AEB E

Category value &3 not valid.

CPF7AED E

Application &2 already registered.

CPF7AEF E

Application type &3 not valid.

CPF7AE2 E

Handle &1 not found.

CPF9872 E

Program or service program &1 in library &2 ended. Reason code &3.