CL Command Reference - CHGJOBD
CL Command List > CHGJOBD Reference
Description:
The Change Job Description (CHGJOBD) command changes the job-related attributes contained in a job description object. Any attribute can be changed, except for the authority attribute. Refer to the Revoke Object Authority (RVKOBJAUT) command and Grant Object Authority (GRTOBJAUT) command for more information on changing object authorizations.
Restrictions:
1. To use this command, you must have:
. object operational (*OBJOPR), object management (*OBJMGT), and read (*READ) authority to the job description and execute (*EXECUTE) authority to the library containing that job description.
. use (*USE) authority to the user profile specified in the User (USER) parameter.2. To change the Accounting code (ACGCDE) parameter to a value other than *USRPRF, you must have use (*USE) authority to the Change Accounting Code (CHGACGCDE) command.
2. To change the Accounting code (ACGCDE) parameter to a value other than *USRPRF, you must have use (*USE) authority to the Change Accounting Code (CHGACGCDE) command.
Examples:
Example 1: Setting Job Running and Output Priorities
CHGJOBD JOBD(QGPL/QPGMR) JOBPTY(2) OUTPTY(2)
This command allows jobs using the IBM-supplied job description QPGMR in the QGPL library to process with a higher job and output priority than originally specified for QPGMR. QPGMR originally sets job running and output priorities at level 5. More information about the IBM-supplied job description parameter values is in the CL Programming book.
Example 2: Changing Priority Limits
Assume that the user profile was created as follows:
Part 1:
CRTUSRPRF USRPRF(JLRAY) PASSWORD(GAMMA) SPCAUT(*JOBCTL)
PTYLMT(4) AUT(*NONE)
Then attempt to change the priority limits of the job description BATCH5 with the following command:
Part 2:
CHGJOBD JOBD(BATCH5) USER(JLRAY) JOBPTY(1) OUTPTY(1)
Because the priority limit specified in the user profile takes precedence over any limit specified in a job description, an error message is sent and a priority of 4 is assumed for both job and output priority levels.
Example 3: Requiring a Password to Sign On at Work Station
CHGJOBD JOBD(INT4) USER(*RQD) RTGDTA(QCMDI) LOG(*SAME)
ACGCDE(ĄŻUSERXYZ CODE123ĄŻ) TEXT(*BLANK)
The USER parameter indicates the user of the job description INT4 must enter a password to sign on at a work station. The characters QCMDI are used as the routing data being compared with the routing table of the subsystem under which the job is run. All values of the LOG parameter list are not changed. Jobs that use this job description have accounting data recorded under the accounting code, ĄŻUSERXYZ CODE123ĄŻ, when job accounting is active. The text for this job description is changed to all blanks.
Example 4: Directing Jobs Using This System to a Specific Job Queue
CHGJOBD JOBD(BATCH3) JOBQ(NIGHTQ) JOBPTY(4) OUTPTY(4)
RTGDTA(QCMDB) INQMSGRPY(*DFT)
TEXT(ĄŻBatch #3 JOBD for high priority night workĄŻ)
This command changes a job description named BATCH3 found in the library search list. The jobs using this description are now placed on the job queue NIGHTQ. The priority for jobs using this description and their spooled files is 4. QCMDB is the routing data that is compared with entries in the routing table of the subsystem where the job is run. The text is changed to indicate that this job description is for high priority night work. The INQMSGRPY parameter specifies that all messages of type *INQ that are issued from a job using this job description automatically causes the default reply message to be issued.