RMVWSE (Remove Work Station Entry)
Purpose
The Remove Work Station Entry (RMVWSE) command is used, when the system is being set up, to remove a specified work station or type of work station from a specified subsystem description.
Restrictions
- The user, typically a system operator or system administrator, must have operational or object management authority to change the subsystem description.
- Work station entries in the subsystem description of an active subsystem may not be removed if there are active workstations within that subsystem.
- A *CON or CONS entry may not be removed from the controlling subsystem.
Required Parameters
- SBSD
- Specifies the qualified name of the subsystem description containing the work station job entry that is being removed.
The name of the subsystem description can be qualified by one of the following library values:
*LIBL: All libraries in the job's library list are searched until the first match is found.
*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
library-name: Specify the name of the library to be searched.
subsystem-description-name: Specify the name of the subsystem description containing the work station entry that is being removed.
- WRKSTN
- Specifies the device description name of the work station for which the job entry is being removed.
work-station-name: Specify the name of the work station whose work station entry is removed.
generic*-work-station-name: Specify the generic name of the work station. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete object name. For more information on the use of generic names, refer to generic names.
The WRKSTN parameter and the WRKSTNTYPE parameter are mutually exclusive. When a generic name is specified, only the generic name entry is removed. For more information on the use of generic functions, see generic functions.
- WRKSTNTYPE
- Specifies the work station device type for which the job entry is being removed. The following type codes are valid:
- Type Code
- Device
- 3179
- 3179 Display station
- 3180
- 3180 Display Station
- 3196
- 3196 Display Station
- 3197
- 3197 Display Station
- 3277
- 3277 Display Station
- 3278
- 3278 Display Station
- 3279
- 3279 Display Station
- 3476
- 3476 Display Station
- 3477
- 3477 Display Station
- 3486
- 3486 Display Station
- 3487
- 3487 Display Station
- 5251
- 5251 Display Station
- 5291
- 5291 Display Station
- 5292
- 5292 Color Display Station
- 5555
- 5555 Display Station (on systems supporting DBCS (double-byte character set))
*ALL: The work station entry for all valid work station types is removed.
*NONASCII: The work station entry for all valid work stations that use 5250 data stream is removed.
*ASCII: The work station entries for all work stations that use ASCII data streams are added.
*CONS: This value overrides a device type entry that specifies the same device type as the device being used as the console.
work-station-type: Specify the work station device type whose work station entry is being removed.
The WRKSTN parameter and the WRKSTNTYPE parameter are mutually exclusive.
Example for RMVWSE
RMVWSE SBSD(LIB2/CHARLES) WRKSTN(B53)This command removes the work station entry for work station B53 from the subsystem description named CHARLES in library LIB2.
Error messages for RMVWSE
*ESCAPE Messages
- CPF1619
- Subsystem description &1 in library &2 damaged.
- CPF1691
- Active subsystem description may or may not have changed.
- CPF1697
- Subsystem description &1 not changed.