CL Command Reference - CHGWSE
CL Command List > CHGWSE Reference
Description:
The Change Work Station Entry (CHGWSE) command changes one or more attributes of a work station entry in the specified subsystem description.
Notes:
1. 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.
2. 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.
3. The job associated with an active subsystem can only find objects that exist in the system auxiliary storage pool (ASP) or in a basic user ASP. Therefore, objects that are referenced by this command should exist in the system ASP or in a basic user ASP.
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.
. object operational (*OBJOPR) and read (*READ) authority to the job description and execute (*EXECUTE) authority to the library containing that job description.
2. Only a user with all object (*ALLOBJ) special authority is allowed to change an entry for which the job description does not exist.
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.