Change Job Authority using JS (CHGAUTJS)

The Change Job Authority using Job Scheduler (CHGAUTJS) command allows you to change the job authority that you have set up for IBM Advanced Job Scheduler for i jobs. You can select specific jobs, generic jobs or all jobs as well as group and application whose authority you want to change.

After you select the parameters in the change command and press Enter, the authority that you have specified for the jobs are changed.

Parameters

Keyword Description Choices Notes
JOB Job entry Element list Required, Positional 1
Element 1: Job Generic name, name, *ALL
Element 2: Group Generic name, name, *ALL, *NONE
Element 3: Group sequence 1-99, *ALL, *NONE
USER User Name, *PUBLIC Required, Positional 2
APP Application Generic name, name, *ALL Optional
AUT Authority Single values: *ALL, *CHANGE, *OPER, *USE, *EXCLUDE, *REMOVE
Other values (up to 7 repetitions): *SBM, *MGT, *AUT, *DSP, *CPY, *UPD, *RMV		 Optional
REPLACE Replace authority *NO, *YES Optional

Job entry (JOB)

Specifies the name of the job, generic job or all jobs whose authority that you want to change. You can optionally specify the group that the job belongs to and the associated sequence number within the group.

This is a required parameter.

Element 1: Job

*ALL
All the job entries that meet this command's other parameter values are changed.
generic-name
Specify the generic name of the job schedule entries whose job schedule entries that you want to change. A generic job is a character string of one or more characters followed by an asterisk (*); for example, ABC*. If the generic name is specified, then all entries with jobs that begin with the generic name are changed. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete job.
name
Specify the user-defined name of the job entry whose authority that you want to change.

Element 2: Group

*NONE
This job does not belong to a group.
*ALL
All the group entries that meet this command's other parameter values are changed.
generic-name
Specify the generic name of the group entry. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. If the generic name is specified, then all entries with groups that begin with the generic name are changed. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete group.
name
Specify the user-defined name of the group entries you want to change.

Element 3: Group sequence

*NONE
There is not a sequence number associated with this job.
*ALL
All sequence numbers in the group are included in the authority change.
1-99
Specify the sequence number of the job in the group whose authority you are changing.

User (USER)

Specifies the name of a user to whom authority for the named job is being given.

This is a required parameter.

*PUBLIC
All enrolled users (or their group) of the system who do not have specific authority to the job are changed.
name
Specify the name of the user profile whose authority you want to change.

Application (APP)

Specifies the name of the application, generic application or all applications whose authority that you want to change.

*ALL
All the applications that meet this command's other parameter values are changed.
generic-name
Specify the generic name of the application whose job schedule entries that you want to change. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. If the generic name is specified, then all entries with application names that begin with the generic name are changed. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete application name.
name
Specify the user-defined name of the application whose authority that you want to change.

Authority (AUT)

Specifies the authority given to the user specified for the Users (USER) parameter.

Single values

*CHANGE
Change authority allows the user to perform all operations on the job except authority maintenance.
*ALL
The user can perform all operations on the job. The user can control the job's existence, specify the security for the job, change the job, and perform basic functions on the job.
*OPER
Operational authority provides job submission, job management and display authorities.
*USE
Use authority provides display authority.
*EXCLUDE
Exclude authority prevents the user from accessing the job.
*REMOVE
Removes the authority entry for the specified user.

Other values (up to 7 repetitions)

*SBM
Submit authority allows the user to start a job group or submit a job.
*MGT
Management authority allows the user to hold or release jobs. Additionally, management authority allows the user to work with job dependencies as well as allowing use of the Set Dependent Job using Job Scheduler (SETDEPJS) command.
*AUT
Allows the user to change the authority of a job.
*DSP
Display authority allows the user to display the information of a job.
*CPY
Copy authority allows the user to copy a job.
*UPD
Update authority allows the user to change the attributes of a job.
*RMV
Remove authority allows the user to remove a job.

Replace authority (REPLACE)

Specifies whether you should replace the current job authorities for the user specified for the User (USER) parameter.

*NO
Do not replace the current job authorities. This will combine current job authorities with the authorities specified for the Authority (AUT) parameter.
*YES
Replace the current job authorities with the authorites specified for the AUT parameter.

Examples 

CHGAUTJS   JOB(JOB02)  USER(SAM)  AUT(*USE)

This command changes job JOB02 to give user SAM *USE authority, which provides screen display authority to user SAM.

Error messages

Unknown