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 |