Remove Cfg List Entries (RMVCFGLE)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

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).

Top

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.
Top

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.
Top

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.
Top

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.

Top

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.

Top

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.
Top

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.
Top

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.
Top

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.
Top

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.
Top

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.

Top

Examples

RMVCFGLE   TYPE(*ASYNCLOC)  ASYNCLOCE(RMTLOC1)

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

Top

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.
Top