Remove Work Station Entry (RMVWSE)

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

Restrictions:

1. 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.
2. Work station entries in the subsystem description of an active subsystem may not be removed if there are active jobs associated with the entry.
3. A *CON or CONS entry may not be removed from the controlling subsystem.

Parameters

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.

Error messages

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