The Remove Local Area Network Adapter (RMVLANADPT) command removes an active local area network (LAN) adapter from a line description that is varied on.

Restrictions:

1. This command is only valid for users with QSECOFR authority.
2. This command is only valid for LAN managers with QSECOFR authority, that are in the controlling mode.

   Note: The mode (controlling or observing) of the LAN manager is set on the TRNMGRMODE parameter when the line is created or changed with the Create Line Description (Token-Ring Network) (CRTLINTRN) or the Change Line Description (Token-Ring Network) (CHGLINTRN) commands.

Attention: Use of this command to remove an active adapter results in loss of communications with any attached products, such as workstations or other systems.

Parameters

Keyword	Description	Choices	Notes
LINE	Line description	Name	Required, Positional 1
ADPTNAME	Adapter	Name, *ADPTADR	Required, Positional 2
ADPTADR	Adapter address	Hexadecimal value	Optional

Top

Line description (LINE)

Specifies the name of the line description attached to the adapter being removed.

This is a required parameter.

Adapter (ADPTNAME)

Specifies the name of the adapter being removed.

The possible values are:

*ADPTADR

The adapter address is used to identify the adapter.

adapter-name

Specify the name of the adapter being removed.

This is a required parameter.

Adapter address (ADPTADR)

Specifies the 12-character hexadecimal adapter address.

Examples

RMVLANADPT   LINE(CHGBRANCH)  ADPTNAME(*ADPTADR)
             ADPTADR(000000001BFF)

This command removes the adapter with an address of 000000001BFF from the line description, CHGBRANCH.

Error messages

*ESCAPE Messages

CPF8B44

Adapter address required.

CPF8B47

Request to remove adapter &29 on line &23 failed.

CPF8B49

Unable to remove network adapter &29 on line &23.

CPF8B50

Adapter &29 on line &23 cannot be removed.

CPF8B68

Line description &23 not found.

CPF8B70

Network line description &23 not varied on.

CPF8B74

Request to display active adapters failed.

CPF8B75

No adapter entries in network adapter file.

CPF8B76

No functional addresses for adapter.