| 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(*) |
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.
None.
The unique identifier for this application, which was returned by the Start Application (QNMSTRAP) API.
The SNA/Management Services function set group with which the application is associated. The only allowed value is:
| *NONE | Not associated with any category. |
The role the application is performing:
| *EPAPP | An entry point application. |
| *FPAPP | A focal point application. |
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. |
The structure in which to return error information. For the format of the structure, see Error code parameter.
| 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. |
[ Back to top | Network Management APIs | APIs by category ]