Change LAN Adapter Information (CHGLANADPI)

The Change Local Area Network Adapter Information (CHGLANADPI) command changes an adapter name entry in the adapter file.

If a default name is associated with an address that changes, the default name will also change to reflect the new address. The default name consists of the last nine digits of the adapter address, prefixed by the character D.

Parameters

Keyword Description Choices Notes
ADPTNAME Adapter Name Required, Positional 1
ADPTADR Adapter address 000000000001-7FFFFFFFFFFF, *SAME Optional
TEXT Text 'description' Character value, *SAME, *BLANK Optional

Adapter (ADPTNAME)

Specifies the name of the adapter being changed in the adapter file.

This is a required parameter.

Adapter address (ADPTADR)

Specifies the 12-character hexadecimal adapter address.

The possible values are:

*SAME
The value does not change.
adapter-address
Specify the adapter address being changed.

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

*SAME
The text (if any) does not change.
*BLANK
No text is specified.
character-value
Specify no more than 50 characters of text, enclosed in apostrophes.

Examples

CHGLANADPI   ADPTNAME(ACCOUNTING)  ADPTADR(00000000110F)

This command changes the address of adapter ACCOUNTING to 0000000110F.

Error messages

*ESCAPE Messages

CPF8B68
Line description &23 not found.
CPF8B71
Change failed. Adapter &29 already exists in network adapter file.
CPF8B72
Change failed. Adapter &29 not found in network adapter file.
CPF8B74
Request to display active adapters failed.
CPF8B75
No adapter entries in network adapter file.
CPF8B76
No functional addresses for adapter.