Change Resource Entry Information (QRZCHGE) API
Required Parameter Group:
| 1 | Resource variable | Input | Char(*) |
| 2 | Format name | Input | Char(8) |
| 3 | Error code | I/O | Char(*) |
Default Public Authority: *EXCLUDE
Threadsafe: No
The Change Resource Entry Information (QRZCHGE) API changes resource information and maps one resource onto another.
Authorities and Locks
- API Public Authority
- *EXCLUDE
Required Parameter Group
- Resource variable
- INPUT; CHAR(*)
The structure that specifies which resource information is to be changed and what the resource information is to be changed to.
- Format name
- INPUT; CHAR(8)
The content and format of the resource information and resource change variables. The possible format names are as follows:
CHGE0100 A resource name is to be changed. See CHGE0100 Format for details of this format. CHGE0200 A resource that is to be mapped. See CHGE0200 Format for details of this format. CHGE0300 A resource mode is to be changed. See CHGE0300 Format for details of this format.
- Error code
- I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter.
CHGE0100 Format
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | CHAR(32) | Resource name |
| 32 | 20 | CHAR(32) | Resource name change |
Field Descriptions
Resource name. The resource name to be changed. The resource name must comply with the following rules:
- Be up to and including 10 characters in length
- Begin with one of the following characters: A-Z, 0-9, $, #, or @
- Can use, after the first character, any combination of A-Z, 0-9, $, @, #, period (.), and underscore (_) for the remaining characters
Resource name change. The value that the resource name is to be changed to. This name is left-justified and padded with trailing blanks.
CHGE0200 Format
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | CHAR(32) | Resource name |
| 32 | 20 | CHAR(32) | Resource name |
Field Descriptions
Resource name. The name of the resource that is to have its resource information exchanged with another resource.
CHGE0300 Format
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | CHAR(32) | Resource name |
| 32 | 20 | CHAR(32) | Reserved |
Field Descriptions
Resource name. The name of the HSL I/O Bridge resource for which the switchable mode is to be changed. If it is Switchable then the mode will be changed to Private and viceversa.
Reserved. A reserved field.
Error Messages
| Message ID | Error Message Text |
|---|---|
| CPF0B3B E | Resource name not found. |
| CPF0B38 E | Resource information not valid. |
| CPF0B43 E | Return code from API &1 is &2. |
| CPF0B46 E | Materialize failed. |
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF3CF1 E | Error code parameter not valid. |
| CPF3C21 E | Format name &1 is not valid. |
| CPF3C90 E | Literal value cannot be changed. |
| CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |
API introduced: V3R6