RMVCFGLE (Remove Configuration List Entries)

RMVCFGLE Command syntax diagram

 

Purpose

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

 

Required Parameters

TYPE
Specifies one of the possible configuration list types.

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

CFGL
Specifies the name of the configuration list. This parameter is valid only when *ASYNCADR is specified on the TYPE parameter. Only one of the other configuration list types is allowed on a system. The list types have system-supplied names: QAPPNDIR, QAPPNLCL, QAPPNRMT, QAPPNSSN, QASYNCADR, QASYNCLOC, QRTLPASTHR, QSNAPASTHR.

 

Optional Parameters

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

filtered-CP-name: Specify the control point name of the adjacent control point being filtered.

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.

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.

APPNLCLE
Specifies the APPN local location entry. If TYPE(*APPNLCL) is specified, this value is required. Up to 50 entries can be specified for this parameter.

APPNRMTE
Specifies the APPN remote location entry. If TYPE(*APPNRMT) is specified, this value is required. Up to 50 entries can be specified for this parameter.

Element 1: Remote Location Name

*ANY: The system potentially accepts all requests sent to it.

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

Element 2: Remote Network Identifier

*NETATR: The RMTNETID value specified in the system network attributes is used.

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

Element 3: Local Location Name

*NETATR: The LCLLOCNAME value specified in the system network attributes is used.

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

ASYNCADRE
Specifies the asynchronous network address entry. This value is required if TYPE(*ASYNCADR) is specified. Up to 50 entries can be specified for this parameter.

Note: All entries having the same network address as that specified are removed from the configuration list.

ASYNCLOCE
Specifies the asynchronous remote location entry. This value is required if TYPE(*ASYNCLOC) is specified. Up to 50 entries can be specified for this parameter.

RTLPASTHRE
Specifies the retail pass-through entry. This value is required if TYPE(*RTLPASTHR) is specified. Up to 50 entries can be specified for this parameter.

Note: All entries that have the same retail device name as the one the user specified are removed from the configuration list.

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.

Example for RMVCFGLE

RMVCFGLE  TYPE(*ASYNCLOC)  ASYNCLOCE(RMTLOC1)

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

Error messages for RMVCFGLE

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