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.