Remove Work Station Entry (RMVWSE)

The Remove Work Station Entry (RMVWSE) command removes a work station entry from the specified subsystem description.

Restrictions:

To use this command, you must have:
- object operational (*OBJOPR), object management (*OBJMGT), and read (*READ) authority to the specified subsystem description and execute (*EXECUTE) authority to the library containing the subsystem description.
Work station entries in the subsystem description of an active subsystem may not be removed if there are active jobs associated with the entry.
A *CON or CONS entry may not be removed from the controlling subsystem.

Parameters

Keyword	Description	Choices	Notes
SBSD	Subsystem description	Qualified object name	Required, Positional 1
	Qualifier 1: Subsystem description	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
WRKSTN	Work station name	Generic name, name	Optional
WRKSTNTYPE	Work station type	ALL, 3179, 3180, 3196, 3197, 3277, 3278, 3279, 3476, 3477, 3486, 3487, 5251, 5252, 5291, 5292, 5555, ASCII, CONS, CONS, NONASCII	Optional

Top

Subsystem description (SBSD)

Specifies the name and library of the subsystem description containing the work station job entry that is removed.

This is a required parameter.

Qualifier 1: Subsystem description

name

Specify the name of the subsystem description where the work station job entry is being removed.

Note: The following IBM-supplied objects are not valid on this parameter:

QLPINSTALL
QSYSSBSD

Qualifier 2: Library

*LIBL: All libraries in the thread's library list are searched until a match is found.
*CURLIB: The current library for the thread is used to locate the object. If no library is specified as the current library for the thread, the QGPL library is used.

name: Specify the library where the subsystem description is located.

Work station name (WRKSTN)

Specifies the name of the work station used by the subsystem. The device description name that was specified in the Create Device Desc (Display) (CRTDEVDSP) command associated with the work station is the name used.

Double-Byte Character Set Considerations: For double-byte character set (DBCS), a work station whose type is 5555 must be specified for either this parameter or the Work station type (WRKSTNTYPE) parameter, but not for both.

generic-name: Specify a generic name. Examples include: DSP*, RMT*,...
Note: Specifying a generic work station name does not result in multiple entries being added, changed, or removed.
name: Specify the name of a specific work station. Examples include: DSP10, DSP11, RMT55,...
A value must be specified on either this parameter or the Work station type (WRKSTNTYP) parameter, but not for both.

Work station type (WRKSTNTYPE)

Specifies the type of work station associated with the entry being added, changed, or removed. This entry applies to all work stations of this type that do not have specific entries for an individual work station.

*ALL: All work station devices. This includes devices with 5250, ASCII, and 327x device types.
3179: 3179 work station.
3180: 3180 work station.
3196: 3196 work station.
3197: 3197 work station.
3277: 3277 work station.
3278: 3278 work station.
3279: 3279 work station.
3476: 3476 work station.
3477: 3477 work station.
3486: 3486 work station.
3487: 3487 work station.
5251: 5251 work station.
5291: 5291 work station.
5292: 5292 color work station.
5555: 5555 double-byte character set (DBCS) capable work station.
*ASCII: All ASCII work station device types.
CONS: System console display. This entry overrides a device type entry that specifies the same device type as the device being used as the console.
*CONS: System console display. This entry overrides a device type entry that specifies the same device type as the device being used as the console.
*NONASCII: All work station devices that use the 5250 data stream, as well as, 327x device types.

A value must be specified on either this parameter or the Work station name (WRKSTN) parameter, but not for both.

Examples

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.