Change Work Station Entry (CHGWSE)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Work Station Entry (CHGWSE) command changes one or more attributes of a work station entry in the specified subsystem description.
Notes:
- When the Job description (JOBD) parameter is specified, the work station entry will be changed; however, the value of this parameter is not changed for any jobs started through this entry that are active at the time.
- If the value of the Maximum active jobs (MAXACT) parameter is reduced to a number less than the total number of work stations that are active through the work station entry, no additional work stations will be allowed to sign on. Active work stations will not be signed-off. Additional jobs can be created for an active work station by the Transfer Secondary Job (TFRSECJOB) command or the Transfer to Group Job (TFRGRPJOB) command. Other work stations will not be allowed to sign on until the number of active work stations is less than the value specified for the MAXACT parameter.
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.
- object operational (*OBJOPR) and read (*READ) authority to the job description and execute (*EXECUTE) authority to the library containing that job description.
- Only a user with all object (*ALLOBJ) special authority is allowed to change an entry for which the job description does not exist.
| Top |
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, Positional 2 |
| WRKSTNTYPE | Work station type | *ALL, 3179, 3180, 3196, 3197, 3277, 3278, 3279, 3476, 3477, 3486, 3487, 5251, 5291, 5292, 5555, *ASCII, CONS, *CONS, *NONASCII | Optional, Positional 3 |
| JOBD | Job description | Single values: *SAME, *USRPRF, *SBSD Other values: Qualified object name |
Optional, Positional 4 |
| Qualifier 1: Job description | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| MAXACT | Maximum active jobs | 0-32000, *SAME, *NOMAX | Optional |
| AT | Allocation | *SAME, *SIGNON, *ENTER | Optional |
| Top |
Subsystem description (SBSD)
Specifies the name and library of the subsystem description that contains the work station entry that is to be changed.
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 changed.
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.
| Top |
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.
| Top |
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.
| Top |
Job description (JOBD)
Specifies the name and library of the job description used for jobs started through this work station entry. If the job description does not exist when the entry is added, a library qualifier must be specified because the qualified job description name is kept in the subsystem description.
Note: Only a user with all object (*ALLOBJ) special authority is allowed to add or change an entry for which the job description does not exist.
Single values
- *SAME
- The job description does not change.
- *USRPRF
- The job description named in the user profile that is used to sign on at this work station (or at this type of work station) is used for jobs started through this entry.
- *SBSD
- The job description having the same name as the subsystem description, specified on the Subsystem description (SBSD) parameter, is used for jobs started through this entry.
Qualifier 1: Job description
- name
- Specify the name of the job description.
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 job description is located.
| Top |
Maximum active jobs (MAXACT)
Specifies, for work stations that use this work station job entry, the maximum number of work station jobs that can be active at the same time.
- *SAME
- The maximum number of jobs that can be active at the same time does not change.
- *NOMAX
- There is no maximum number of jobs (work stations) that can be active at the same time through this work entry.
- 0-32000
- Specify the maximum number of jobs that can be active at the same time through this work entry.
| Top |
Allocation (AT)
Specifies how the work stations associated with this job entry are allocated. For more information on how work stations are allocated to subsystems, see the Start Subsystem (STRSBS) command.
- *SAME
- The job entry specification does not change.
- *SIGNON
- The work stations are allocated when the subsystem is started if the work station is not already in use (signed on) in another subsystem. A sign-on prompt is displayed at each work station associated with this work entry. If a work station becomes allocated to a different subsystem, interactive jobs associated with the work station are allowed to enter this subsystem through the Transfer Job (TFRJOB) command.
- *ENTER
- The work stations associated with this work entry are not allocated when the subsystem is started. However, the interactive jobs associated with the work stations are allowed to enter this subsystem through the TFRJOB command.
| Top |
Examples
Example 1: Changing an Entry at Signon
CHGWSE SBSD(QGPL/BAKER) WRKSTN(A12) AT(*SIGNON)
This command changes the work station job entry for work station A12 in subsystem BAKER found in the general purpose library. A job is created for work station A12 when the user's password is entered on the sign-on prompt and the Enter key is pressed.
Example 2: Changing an Entry
CHGWSE SBSD(QGPL/BAKER) WRKSTN(B28) JOBD(*USRPRF)
This command changes the work station job entry for work station B28 in subsystem BAKER found in library QGPL. The job description named in the user profile that is used to sign on at this work station is used for jobs started through this entry. The other command parameters default to the *SAME value.
| Top |
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.
| Top |