The Remove Configuration List Entries (RMVCFGLE) command removes entries from a configuration list.

Note: The user may also use the full screen entry display of the Change Configuration List (CHGCFGL) command to add, remove, or change entries in an existing list except for the configuration list TYPE(*SNAPASTHR).

Parameters

Keyword	Description	Choices	Notes
TYPE	Configuration list type	*APPNDIR, *APPNLCL, *APPNRMT, *APPNSSN, *ASYNCADR, *ASYNCLOC, *RTLPASTHR, *SNAPASTHR	Required, Positional 1
APPNLCLE	APPN local location entry	Values (up to 50 repetitions): Element list	Optional
	Element 1: Local location name	Communications name
APPNRMTE	APPN remote location entry	Values (up to 50 repetitions): Element list	Optional
	Element 1: Remote location name	Generic name, name, *ANY
	Element 2: Remote network identifier	Communications name, *NETATR, *NONE
	Element 3: Local location name	Communications name, *NETATR
CFGL	Configuration list	Name	Optional
ASYNCADRE	Async network address entry	Values (up to 50 repetitions): Element list	Optional
	Element 1: Network address	Character value
ASYNCLOCE	Async remote location entry	Values (up to 50 repetitions): Element list	Optional
	Element 1: Remote location name	Name
RTLPASTHRE	Retail pass-through entry	Values (up to 50 repetitions): Element list	Optional
	Element 1: Retail device	Name
FTRCPNAME	Filtered control point name	Generic name, name, *ANY	Optional
FTRCPNETID	Filtered CP network identifier	Communications name, *NETATR	Optional
LCLLOCNAME	Local location name	Generic name, name, *ANY	Optional
SNAPASTHRE	SNA pass-through entry	Values (up to 254 repetitions): Element list	Optional
	Element 1: SNA pass-through group name	Communications name

Top

Configuration list type (TYPE)

Specifies one of the possible configuration list types.

This is a required parameter.

*APPNDIR

An advanced peer-to-peer networking (APPN) directory search filter configuration list is used. The user can specify one APPN directory search filter entry in the configuration list.

*APPNLCL

An APPN local location list is used. The user can specify up to 476 APPN local location entries in the configuration list.

*APPNRMT

An APPN remote location list is used. The user can specify up to 1898 APPN remote location entries in the configuration list.

*APPNSSN

An APPN session end point filter configuration list is used. The user can specify one APPN session entry in the configuration list.

*ASYNCADR

An asynchronous network address list is used. The user can specify up to 294 asynchronous network address entries in the configuration list.

*ASYNCLOC

An asynchronous remote location list is used. The user can specify up to 32000 asynchronous remote location entries in the configuration list.

*RTLPASTHR

A retail pass-through list is used. The user can key up to 450 retail pass-through entries in the configuration list.

*SNAPASTHR

An SNA pass-through list is used. The user can key one SNA pass-through entry in the configuration list.

APPN local location entry (APPNLCLE)

Specifies the APPN local location entry. This value is required if *APPNLCL is specified for the Configuration list type prompt (TYPE parameter).

You can enter multiple values for this parameter.

A maximum of 50 entries can be specified directly for this parameter. An entry consists of a value from each of the following elements.

local-location-name

Specify the local location of the entry being removed from the configuration list.

APPN remote location entry (APPNRMTE)

Specifies the APPN remote location entry. This value is required if *APPNRMT is specified for the Configuration list type prompt (TYPE parameter).

You can enter multiple values for this parameter.

A maximum of 50 entries can be specified directly for this parameter. An entry consists of a value from each of the following elements.

remote-location-name

Specify the remote location of the entry being removed from the configuration list.

remote-network-identifier

Specify the remote network identifier of the entry being removed from the configuration list.

local-location-name

Specify the local location of the entry being removed from the configuration list.

Configuration list (CFGL)

Specifies the name of the configuration list. This value is required and valid only when the configuration list is an asynchronous network address list (*ASYNCADR is specified for the Configuration list type (TYPE) parameter). The list types have system-supplied names: QAPPNLCL, QAPPNRMT, QASYNCADR, QASYNCLOC, QRTLPASTHR, and QSNAPASSTHR.

This is a required parameter.

Async network address entry (ASYNCADRE)

Specifies the asynchronous network address entry. This value is required if *ASYNCADR is specified for the Configuration list type prompt (TYPE parameter).

You can enter multiple values for this parameter.

A maximum of 50 entries can be specified directly for this parameter. An entry consists of a value from each of the following elements.

network-address

Specify the network address of the entry being removed from the configuration list.

Note: All entries having the same network address as the one you specify are removed from the configuration list.

Async remote location entry (ASYNCLOCE)

Specifies the asynchronous remote location entry. This value is required if *ASYNCLOC is specified for the Configuration list type prompt (TYPE parameter).

You can enter multiple values for this parameter.

A maximum of 50 entries can be specified directly for this parameter. An entry consists of a value from each of the following elements.

remote-location-name

Specify the remote location of the entry being removed from the configuration list.

Retail pass-through entry (RTLPASTHRE)

Specifies the retail pass-through entry. This value is required if *RTLPASTHR is specified for the Configuration list type prompt (TYPE parameter).

You can enter multiple values for this parameter.

A maximum of 50 entries can be specified directly for this parameter. An entry consists of a value from each of the following elements.

Retail-device-name

Specify the retail device name of the entry being removed from the configuration list.

Filtered control point name (FTRCPNAME)

Specifies the control point name of the adjacent control point that is being filtered by the local system when a directory search request is made.

Note: This parameter is valid only if TYPE(*APPNDIR) is specified.

*ANY

Any control point name is filtered.

generic*-filtered-CP-name

Specify the generic control point name (part of a name followed by an asterisk) of the adjacent control point(s) being filtered. The generic control point name allows one directory entry to be defined for all control points, in a single network, with a name that matches the characters preceding an asterisk (*).

filtered-CP-name

Specify the control point name of the adjacent control point being filtered.

Filtered CP network identifier (FTRCPNETID)

Specifies the control point network identifier of the adjacent control point being filtered by the local system when a directory search request is made.

Note: This parameter is valid only if TYPE(*APPNDIR) is specified.

*NETATR

The LCLNETID value specified in the system network attributes is used.

filtered CP-network-ID

Specify the control point network identifier of the adjacent control point being filtered by the local system.

Local location name (LCLLOCNAME)

Specifies the local location name being supplied by the caller that is being filtered by the local system. When the local system is initiating a session, this is the local location name being used. When a bind is received from another system, this is the Secondary Logical Unit (SLU) name being used.

Note: This parameter is valid only if TYPE(*APPNSSN) is specified.

*ANY

Any local location name will be filtered by the local system.

generic*-local-location-name

Specify the generic local location name (part of a name followed by an asterisk) of the local location(s) being filtered. The generic local location name allows one entry to be defined for all local location names, on the system, with a name that matches the characters preceding an *.

local-location-name

Specify the local location name that is being filtered by the local system.

SNA pass-through entry (SNAPASTHRE)

Specifies the SNA pass-through entry. This value is required if TYPE(*SNAPASTHR) is specified. One group entry can be specified for this parameter.

Examples

RMVCFGLE   TYPE(*ASYNCLOC)  ASYNCLOCE(RMTLOC1)

This command removes the configuration list entry RMTLOC1 from the asynchronous remote location list QASYNCLOC.

Error messages

*ESCAPE Messages

CPF260F

Configuration list &1 not found.

CPF261C

Index for configuration list &1 not changed.

CPF261D

Index for configuration list &1 not changed.

CPF2625

Not able to allocate object &1.

CPF263A

CFGL type &1 does not match existing type &2.

CPF2634

Not authorized to object &1.

CPF2663

Configuration list &1 previously deleted.

CPF2666

Cannot remove all entries from configuration list &1.