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	Type	Field
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

This name is left-justified and padded with trailing blanks.

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	Type	Field
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	Type	Field
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

[ Back to top | Configuration APIs | APIs by category ]