Change Job (CHGJOB)

The Change Job (CHGJOB) command changes some of the attributes of a job. With the exception of a change in job queue, the job can be in a job queue or in an output queue, or it can be active in a subsystem. The job queue can only be changed when the job is a batch job and is in a job queue. If the job is in the output queue, only the Output priority (on OUTQ) (OUTPTY), the Job log output (LOGOUTPUT), and the Spooled file action (SPLFACN) can be changed. With the exception of the class attributes, the new attributes remain in effect for the duration of the job unless they are changed by another CHGJOB command. The class attributes remain in effect until the routing step that is currently active ends. If no routing step is active when the changes are made, they apply to the next routing step that is started. If an attribute that no longer affects the job is changed, a message is sent to the user of the command. For example, if the job has already completed running, it is too late to change the Output queue (OUTQ) and Job priority (on JOBQ) (JOBPTY) parameters. If any output files are still on the output queue, however, changing the OUTPTY parameter changes their output priority.

Restrictions:

  1. The command must be issued from within the job being changed, or the issuer of the command must be running under a user profile which is the same as the job user identity of the job being changed, or the issuer of the command must be running under a user profile which has job control (*JOBCTL) special authority.

    The job user identity is the name of the user profile by which a job is known to other jobs. It is described in more detail in the Work Management Guide.

  2. To use this command, the following authorities are required:
    • To change the job queue (JOBQ), you must have use (*USE) authority to the job queue that the job is being changed to and execute (*EXECUTE) authority to the library containing that job queue.
    • To change the output queue (OUTQ), you must have read (*READ) authority to the output queue that is currently allocated to the job and execute (*EXECUTE) authority to the library containing this output queue. This authority can come from adopted authority. When a job changes itself, no authority is required to the OUTQ currently allocated to the job. You also must have read (*READ) authority to the output queue that the job is being changed to use, and execute (*EXECUTE) authority to the library containing that output queue. This authority cannot come from adopted authority.
    • To change the RUNPTY, TIMESLICE, PURGE, DFTWAIT, TSEPOOL, WLCGRP, CPUTIME, MAXTMPSTG, or PRCRSCPTY values, you must have job control (*JOBCTL) special authority.
    • To change the sort sequence table (SRTSEQ), you must have use (*USE) authority to the new sort sequence table and execute (*EXECUTE) authority to the library that contains that sort sequence table.
  3. This command is conditionally threadsafe. Refer to Considerations for Attribute Thread Safety for additional information.

Considerations for Attribute Thread Safety:

This command is intended to be used to change the job attributes for a job. All of the attributes are scoped to the job.

The Threadsafe column of the following table indicates whether the attributes can be changed in a manner that is threadsafe.

Yes: - Attributes marked with this value are considered to be threadsafe. These attributes can be changed safely by issuing this command from either the initial thread or from a secondary thread. The target job may also be either single threaded or multi threaded.

No: - Attributes marked with this value are not threadsafe. An attempt to change these attributes will be denied if multiple threads are active in the job issuing this command or in the target job.

Attribute and Thread Safety Table:

Parameters

Keyword Description Choices Notes
JOB Job name Single values: *
Other values: Qualified job name		 Optional, Key, Positional 1
Qualifier 1: Job name Name
Qualifier 2: User Name
Qualifier 3: Number 000000-999999
JOBPTY Job priority (on JOBQ) 0-9, *SAME Optional
OUTPTY Output priority (on OUTQ) 1-9, *SAME Optional
PRTDEV Print device Name, *SAME, *USRPRF, *SYSVAL, *WRKSTN Optional
OUTQ Output queue Single values: *SAME, *USRPRF, *DEV, *WRKSTN
Other values: Qualified object name		 Optional
Qualifier 1: Output queue Name
Qualifier 2: Library Name, *LIBL, *CURLIB
RUNPTY Run priority 1-99, *SAME Optional
JOBQ Job queue Single values: *SAME
Other values: Qualified object name		 Optional
Qualifier 1: Job queue Name
Qualifier 2: Library Name, *LIBL, *CURLIB
PRTTXT Print text Character value, *SAME, *SYSVAL, *BLANK Optional
LOG Message logging Element list Optional
Element 1: Level 0-4, *SAME
Element 2: Severity 0-99, *SAME
Element 3: Text *SAME, *MSG, *SECLVL, *NOLIST
LOGCLPGM Log CL program commands *SAME, *NO, *YES Optional
LOGOUTPUT Job log output *SAME, *SYSVAL, *JOBLOGSVR, *JOBEND, *PND Optional
JOBMSGQFL Job message queue full action *SAME, *SYSVAL, *NOWRAP, *WRAP, *PRTWRAP Optional
INQMSGRPY Inquiry message reply *SAME, *RQD, *DFT, *SYSRPYL Optional
BRKMSG Break message handling *SAME, *NORMAL, *NOTIFY, *HOLD Optional
STSMSG Status message *SAME, *USRPRF, *SYSVAL, *NONE, *NORMAL Optional
DDMCNV DDM conversation *SAME, *KEEP, *DROP Optional
SCDDATE Schedule date Date, *SAME, *CURRENT, *MONTHSTR, *MONTHEND, *MON, *TUE, *WED, *THU, *FRI, *SAT, *SUN Optional
SCDTIME Schedule time Time, *SAME, *CURRENT Optional
DATE Job date Date, *SAME Optional
DATFMT Date format *SAME, *SYSVAL, *YMD, *MDY, *DMY, *JUL Optional
DATSEP Date separator *SAME, *SYSVAL, *BLANK, '/', '-', '.', ' ', ',' Optional
TIMSEP Time separator *SAME, *SYSVAL, *BLANK, ':', '.', ' ', ',' Optional
SWS Job switches Character value, *SAME Optional
TIMESLICE Time slice 1-9999999, *SAME Optional
PURGE Eligible for purge *SAME, *YES, *NO Optional
DFTWAIT Default wait time 1-9999999, *SAME, *NOMAX Optional
DEVRCYACN Device recovery action *SAME, *SYSVAL, *MSG, *DSCMSG, *DSCENDRQS, *ENDJOB, *ENDJOBNOLIST Optional
TSEPOOL Time slice end pool *SAME, *SYSVAL, *NONE, *BASE Optional
PRTKEYFMT Print key format *SAME, *SYSVAL, *NONE, *PRTBDR, *PRTHDR, *PRTALL Optional
SRTSEQ Sort sequence Single values: *SAME, *USRPRF, *SYSVAL, *HEX, *LANGIDUNQ, *LANGIDSHR
Other values: Qualified object name		 Optional
Qualifier 1: Sort sequence Name
Qualifier 2: Library Name, *LIBL, *CURLIB
LANGID Language ID Character value, *SAME, *USRPRF, *SYSVAL Optional
CNTRYID Country or region ID Character value, *SAME, *USRPRF, *SYSVAL Optional
CCSID Coded character set ID 1-65535, *SAME, *USRPRF, *SYSVAL, *HEX Optional
DECFMT Decimal format *SAME, *SYSVAL, *BLANK, I, J Optional
CHRIDCTL Character identifier control *SAME, *USRPRF, *SYSVAL, *DEVD, *JOBCCSID Optional
SPLFACN Spooled file action *SAME, *SYSVAL, *KEEP, *DETACH Optional
WLCGRP Workload group Simple name, *SAME, *NONE Optional
CPUTIME Maximum CPU time 1-9999999, *SAME, *NOMAX Optional
MAXTMPSTG Maximum temporary storage 1-2147483647, *SAME, *NOMAX Optional
PRCRSCPTY Processor resources priority *SAME, *SYSCTL, *NORMAL, *HIGH, *LOW Optional
DUPJOBOPT Duplicate job option *SELECT, *MSG Optional

Job name (JOB)

Specifies the name of the job whose attributes are being changed.

*
The attributes of the job that issues this command are changed.

Qualifier 1: Job name

name
Specify the name of the job.

Qualifier 2: User

name
Specify the name of the user profile under which the job is run.

Qualifier 3: Number

000000-999999
Specify the job number assigned by the system.

If no job qualifier is given, all jobs currently in the system are searched for the job name. If more than one occurrence of the specified name is found, a qualified job name must be specified.

Job priority (on JOBQ) (JOBPTY)

Specifies the scheduling priority used for the job being changed. Valid values range from 0 through 9, where 0 is the highest priority and 9 is the lowest priority.

*SAME
The scheduling priority does not change.
0-9
Specify the scheduling priority for the job. If the job is currently on the job queue, its position on the queue in relationship to other jobs may be changed. The scheduling priority specified cannot be higher than the priority specified in the user profile under which the job in which this command is entered, is running.

Output priority (on OUTQ) (OUTPTY)

Specifies the output priority for spooled output files that are produced by this job. The highest priority is 1 and the lowest priority is 9.

*SAME
The job's priority for spooled output does not change.
1-9
Specify the priority of the job's output files. The output priority specified cannot be higher than the priority specified in the user profile under which the job in which this command entered, is running. Only those spooled output files which are on output queues in the library name space of the thread issuing this command will be changed.

Print device (PRTDEV)

Specifies the default printer device for this job.

Note: This assumes the defaults are specified on the OUTQ parameter for the printer file, job description, user profile and workstation.

*SAME
The default printer device does not change.
*USRPRF
When the job being changed is the job in which this command is running, the printer device is obtained from the user profile under which this thread was initially running. When the job being changed is a different job, the printer device is obtained from the current user profile associated with that job.
*SYSVAL
The value in the system value QPRTDEV is used as the printer device.
*WRKSTN
The default printer device used with this job is the printer device assigned to the work station that is associated with the job.

Output queue (OUTQ)

Specifies the output queue used for spooled files that specify OUTQ(*JOB). This parameter applies only to printer files that have *JOB specified for the OUTQ parameter.

Single values

*SAME
The default output queue does not change.
*USRPRF
When the job being changed is the job in which this command is running, the output queue is obtained from the user profile under which this thread was initially running. When the job being changed is a different job, the output queue is obtained from the current user profile associated with that job.
*DEV
The DEV parameter is determined by one of these printer file commands: Create Printer File (CRTPRTF), Change Printer File (CHGPRTF), or Override with Printer File (OVRPRTF).

Note: This assumes the defaults were specified on the OUTQ parameter for the printer file, job description, user profile, and workstation.

*WRKSTN
The default output queue used with this job is the output queue assigned to the work station that is associated with the job at the time the job is started.

Qualifier 1: Output queue

name
Specify the name of the default output queue used by the job.

Qualifier 2: Library

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the thread is used to locate the default output queue. If no library is specified as the current library for the thread, the QGPL library is used.
name
Specify the library where the default output queue used by the job is located.

Run priority (RUNPTY)

Specifies the run priority for the job. Run priority is a value, ranging from 1 (highest priority) through 99 (lowest priority), that represents the priority at which the job competes for the processing unit relative to other jobs that are active at the same time. This value represents the relative (not the absolute) importance of the job. For example, a job with a run priority of 25 is not twice as important as one with a run priority of 50. This value is the highest run priority allowed for any thread within the job. Individual threads within the job may have a lower priority. Changing the run priority of the job will affect the run priorities of all threads within the job. For example, the job is running at priority 10, thread A within the job is running at priority 10 and thread B within the job is running at priority 15. The priority of the job is changed to 20. The priority of thread A would then be adjusted to 20 and the priority of thread B would be adjusted to 25.

If the job consists of multiple routing steps, a change to this attribute during a routing step does not apply to subsequent routing steps.

*SAME
The run priority does not change.
1-99
Specify the run priority of the job.

Job queue (JOBQ)

Specifies the job queue in which this job is placed.

Single values

*SAME
The job queue does not change.

Qualifier 1: Job queue

name
Specify the name of the job queue.

Qualifier 2: Library

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the thread is used to locate the job queue. If no library is specified as the current library for the thread, the QGPL library is used.
name
Specify the library where the job queue is located.

Print text (PRTTXT)

Specifies the text that is printed at the bottom of each page of printed output and on separator pages.

*SAME
The current value of the PRTTXT parameter does not change.
*SYSVAL
The system value, QPRTTXT, is used.
*BLANK
No text is printed on printed output.
character-value
Specify the character string that is printed at the bottom of each page. A maximum of 30 characters can be entered, enclosed in apostrophes.

Message logging (LOG)

Specifies the message logging values used to determine the amount and type of information sent to the job log by this job. This parameter has three elements: the message (or logging) level, the message severity, and the level of message text. If no values are specified on this parameter, the values are not changed.

Element 1: Level

*SAME
The message logging level of the job does not change.
0-4
Specify the message logging level used for the job's messages. The possible logging levels are:
0
No messages are logged.
1
All messages sent to the job's external message queue with a severity greater than or equal to the message logging severity are logged. This includes the indications of job start, job end, and job completion status.
2
The following information is logged:
  • Logging level 1 information
  • Request messages which result in a high-level message with a severity code greater than or equal to the message logging severity. Both the request message and all associated messages are logged.

Note: A high-level message is one that is sent to the program message queue of the program that receives the request message. For example, QCMD is an IBM-supplied request processing program that receives request messages.

3
The following information is logged:
  • Logging level 1 and 2 information
  • All request messages
  • Commands run by a CL program are logged if it is allowed by the logging of CL programs job attribute and the log attribute of the CL program.
4
The following information is logged:
  • All request messages and all messages with a severity greater than or equal to the message logging severity, including trace messages.
  • Commands run by a CL program are logged if it is allowed by the logging of CL programs job attribute and the log attribute of the CL program.

Element 2: Severity

*SAME
The message logging severity does not change.
0-99
Specify the message logging severity that is used in conjunction with the logging level to determine which error messages are logged in the job log.

Element 3: Text

*SAME
The level of message text does not change.
*MSG
Only the message text is written to the job log.
*SECLVL
Both the message text and the message help (cause and recovery) of the error message are written to the job log.
*NOLIST
If the job ends normally, no job log is produced. If the job ends abnormally (if the job end code is 20 or higher), a job log is produced. The messages that appear in the job log contain both the message text and the message help.

Log CL program commands (LOGCLPGM)

Specifies whether the commands that are run in a control language program are logged to the job log by way of the CL program's message queue. This parameter sets the status of the job's logging flag. If *JOB has been specified for the Message logging (LOG) parameter in the Create CL Program (CRTCLPGM) command, the flag set in the Log CL program commands (LOGCLPGM) parameter is used. Other values for the Message logging (LOG) parameter override the Log CL program commands (LOGCLPGM) parameter. The commands are logged in the same manner as the requests.

*SAME
The current state of the job's logging flag does not change.
*NO
Commands that come later in a CL program are not written to the job log.
*YES
Commands that come later in a CL program, and are capable of being written, are logged to the job log.

Job log output (LOGOUTPUT)

Specifies how the job log will be produced when the job completes. This does not affect job logs produced when the message queue is full and the job message queue full action specifies *PRTWRAP. Messages in the job message queue are written to a spooled file, from which the job log can be printed, unless the Control Job Log Output (QMHCTLJL) API was used in the job to specify that the messages in the job log are to be written to a database file.

The job log output value can be changed at any time until the job log has been produced or removed. To change the job log output value for a job, use the Change Job (QWTCHGJB) API or the Change Job (CHGJOB) command.

The job log can be displayed at any time until the job log has been produced or removed. To display the job log, use the Display Job Log (DSPJOBLOG) command.

The job log can be removed when the job has completed and the job log has not yet been produced or removed. To remove the job log, use the Remove Pending Job Log (QWTRMVJL) API or the End Job (ENDJOB) command.

*SAME
The value does not change.
*SYSVAL
The value specified in the system value QLOGOUTPUT is used.
*JOBLOGSVR
The job log will be produced by a job log server. For more information about job log servers, refer to the Start Job Log Server (STRLOGSVR) command.
*JOBEND
The job log will be produced by the job itself. If the job cannot produce its own job log, the job log will be produced by a job log server. For example, a job does not produce its own job log when the system is processing a Power Down System (PWRDWNSYS) command.
*PND
The job log will not be produced. The job log remains pending until removed.

Job message queue full action (JOBMSGQFL)

Specifies the action that should be taken when the job message queue is full.

*SAME
The job message queue full option does not change.
*SYSVAL
The value specified for the QJOBMSGQFL system value is used.
*NOWRAP
The message queue does not wrap when it is full. This action ends the job.
*WRAP
The message queue wraps to the start of the message queue when full and starts filling the message queue again.
*PRTWRAP
The message queue wraps the job message queue when full and prints the messages that are being overlaid because of wrapping.

Inquiry message reply (INQMSGRPY)

Specifies the way that predefined messages that are sent as a result of running this job are answered. You can specify that the inquiry message reply control is taken from the job description, or that all inquiry messages require a reply, or that a default reply is issued, or that the system reply list is checked for a matching reply as each predefined inquiry message is sent.

*SAME
The method to use for inquiry message replies does not change.
*RQD
A reply is required by the receiver of the inquiry message for inquiry messages that are sent during the running of this job.
*DFT
The default message reply is used to answer any inquiry messages issued during the running of this job.
*SYSRPYL
The system reply list is checked to see if there is an entry for any inquiry message issued as a result of running this job. If a match occurs, the reply value in that entry is used. If no entry exists for that inquiry message, a reply is required.

Break message handling (BRKMSG)

Specifies how break messages are handled for the job. This is determined by the status of the message queue, the message queue severity, and the setting of this value.

*SAME
Break message handling does not change.
*NORMAL
Break message handling is determined by the message queue status.
*NOTIFY
An audible alarm sounds to indicate the presence of a message. *NOTIFY is allowed only for interactive jobs.
*HOLD
Neither break messages, or messages sent to a signed-on work station through the Send Break Message (SNDBRKMSG) command, are shown for message queues in *BREAK delivery mode. The alarm does not sound for messages sent to message queues in *NOTIFY delivery mode. The user break message handling program is not started.

Status message (STSMSG)

Specifies how status messages are handled for the job.

*SAME
Status message handling does not change.
*USRPRF
When the job being changed is the job in which this command is running, the status message handling is obtained from the user profile under which this thread was initially running. When the job being changed is a different job, the status message handling is obtained from the current user profile associated with that job.
*SYSVAL
Status messages are shown or not shown as specified in the QSTSMSG system value.
*NONE
Status messages are not shown.
*NORMAL
Status messages are shown. Text on the bottom line of the display is lost.

DDM conversation (DDMCNV)

Specifies whether the connections using distributed data management (DDM) protocols remain active when they are not being used. The connections include APPC conversations, active TCP/IP conversations or OptiConnect connections. The DDM protocols are used in Distributed Relational Database Architecture (DRDA) applications, DDM applications, or DB2 Multisystem applications.

*SAME
The current state of the job's DDM conversation attribute does not change.
*KEEP
The system keeps DDM conversation connections active when there are no users, except when:
  • The routing step ends on the source system, either at the job or when the job starts a reroute of the job.
  • There is an explicit request that conversations be disconnected, using the Reclaim DDM Conversations (RCLDDMCNV) command or the Reclaim Resources (RCLRSC) command.
  • There is a communications failure or internal failure.
  • A DRDA connection to an application server not running on the System i ends.
*DROP
The system ends a DDM-allocated conversation when there are no users. Examples include when an application closes a DDM file, or when a DRDA application runs an SQL DISCONNECT statement.

Schedule date (SCDDATE)

Specifies the date on which the submitted job becomes eligible to run.

If your system or your job is configured to use the Julian date format, *MONTHSTR and *MONTHEND are calculated as if the system or job did not use the Julian date format.

*SAME
This value does not change.
*CURRENT
The submitted job becomes eligible to run on the current date.
*MONTHSTR
The submitted job becomes eligible to run on the first day of the month. If you specify *MONTHSTR, and if today is the first day of the month and the time you specify on the SCDTIME parameter has not passed, the job becomes eligible to run today. Otherwise, the job becomes eligible on the first day of the next month.
*MONTHEND
The submitted job becomes eligible to run on the last day of the month. If you specify *MONTHEND, and if today is the last day of the month and the time you specify on the SCDTIME parameter has not passed, the job becomes eligible to run today. Otherwise, the job becomes eligible on the last day of the next month.
*MON
The job becomes eligible to run on Monday.
*TUE
The job becomes eligible to run on Tuesday.
*WED
The job becomes eligible to run on Wednesday.
*THU
The job becomes eligible to run on Thursday.
*FRI
The job becomes eligible to run on Friday.
*SAT
The job becomes eligible to run on Saturday.
*SUN
The job becomes eligible to run on Sunday.
date
Specify a date in the job date format with or without separators.

Schedule time (SCDTIME)

Specifies the time on the scheduled date at which the job becomes eligible to run.

Note: Although the time can be specified to the second, the load on the system may affect the exact time at which the job becomes eligible to run.

*SAME
This value does not change.
*CURRENT
The job is submitted on the current time.
time
Specify the time you want the job to start. The time is specified in 24-hour format and can be specified with or without a time separator:
  • Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. Valid values for hh range from 00 to 23. Valid values for mm and ss range from 00 to 59.
  • With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If this command is entered from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.

Job date (DATE)

Specifies the date that is assigned to the job. The job date remains the same for the duration of the job, unless it is changed by the user.

*SAME
The job date does not change.
date
Specify the value that is used as the job date for the job. The date must be entered in the current job date format. If no job date is specified for a job, the system date is used as the default for any function requiring a job date. The date specified in this parameter overrides the system date for the running of the job only.

Date format (DATFMT)

Specifies the format used for the date.

*SAME
The date format used does not change.
*SYSVAL
The system value, QDATFMT, is used.
*YMD
The date format used is year, month, and day.
*MDY
The date format used is month, day, and year.
*DMY
The date format used is day, month, year.
*JUL
The date format used is Julian.

Date separator (DATSEP)

Specifies the date separator used for the date.

*SAME
The date separator does not change.
*SYSVAL
The system value for the date separator is used.
*BLANK
A blank is used for the date separator.
'/'
A slash (/) is used for the date separator.
'-'
A dash (-) is used for the date separator.
'.'
A period (.) is used for the date separator.
' '
A blank is used for the date separator.
','
A comma (,) is used for the date separator.

Time separator (TIMSEP)

Specifies the time separator used for the job.

Note: When specifying time on other commands, you must use the time separator specified on this parameter or no time separator. If a time separator different from the time separator specified here is used to specify time on another command, the command will fail.

*SAME
The time separator does not change.
*SYSVAL
The time separator specified in the system value QTIMSEP is used.
*BLANK
A blank is used for the time separator.
':'
A colon (:) is used for the time separator.
'.'
A period (.) is used for the time separator.
' '
A blank is used for the time separator.
','
A comma (,) is used for the time separator.

Job switches (SWS)

Specifies the switch settings for a group of eight job switches that are used with the job. These switches can be set or tested in a CL program and used to control the flow of the program. The only valid values for each 1-digit switch are 0 (off), 1 (on), or X. The X indicates that a switch value does not change.

*SAME
The values in the eight job switches do not change.
character-value
Specify any combination (in quotation marks or not) of eight 0's, 1's, or X's to change the job switch settings. If a switch value is not being changed, enter an X in the position representing that switch.

Time slice (TIMESLICE)

Specifies the maximum amount of processor time (in milliseconds) given to each thread in the job before other threads in this job and in other jobs are given an opportunity to run. The time slice establishes the amount of time needed by a thread in the job to accomplish a meaningful amount of processing. At the end of the time slice, the thread might be put in an inactive state so that other threads can become active in the storage pool.

If the job consists of multiple routing steps, a change to this attribute during a routing step does not apply to subsequent routing steps.

*SAME
The value specified for the time slice does not change.
1-9999999
Specify the amount of time (in milliseconds) that each thread in the job is allowed to run when it is given processing time.

Note: A millisecond is one thousandth of a second. So, 9 999 999 milliseconds equals 9999.999 seconds. Although you can specify a value of less than 8, the system takes a minimum of 8 milliseconds to run a process. If you display a job's run attributes, the time slice value is never less than 8.

Eligible for purge (PURGE)

Specifies whether the job is eligible to be moved out of main storage and put into auxiliary storage at the end of a time slice or when entering a long wait (such as waiting for a work station user's response). This attribute is ignored when more than one thread is active within the job.

If the job consists of multiple routing steps, a change to this attribute during a routing step does not apply to subsequent routing steps.

*SAME
The value specified for the purge option does not change.
*YES
The job is eligible to be moved out of main storage and put into auxiliary storage. However, a job with multiple threads is never purged from main storage.
*NO
The job is not eligible to be moved out of main storage and put into auxiliary storage. However, when main storage is needed, pages belonging to a thread in this job may be moved to auxiliary storage. Then, when a thread in this job runs again, its pages are returned to main storage as they are needed.

Default wait time (DFTWAIT)

Specifies the default maximum time (in seconds) that a thread in the job waits for a system instruction, such as the LOCK machine interface (MI) instruction, to acquire a resource. This default wait time is used when a wait time is not otherwise specified for a given situation. Normally, this is the amount of time the system is willing to wait for the system before the request is ended. The wait time specified for this parameter is ignored for read operations to database files.

If the job consists of multiple routing steps, a change to this attribute during a routing step does not apply to subsequent routing steps.

*SAME
The default maximum wait time does not change.
*NOMAX
There is no maximum wait time.
1-9999999
Specify the number of seconds for the maximum time that the system waits for the instruction to acquire a resource.

Device recovery action (DEVRCYACN)

Specifies the recovery action to take for the job when an I/O error is encountered on the *REQUESTER device for interactive jobs. This parameter can be specified only for interactive jobs.

*SAME
The work station recovery action does not change.
*SYSVAL
The value in the system value, QDEVRCYACN, is used as the device recovery action for this job.
*MSG
The application program requesting the I/O operation receives an error message indicating the I/O operation has failed.
*DSCMSG
The job is automatically disconnected. When the job is reconnected, it receives an error message indicating that an I/O error has occurred but the device has been recovered. Although the device has been recovered, the contents of the display prior to the error must be shown again.
*DSCENDRQS
The job is automatically disconnected. Once it is reconnected, the ENDRQS command is issued specifying the previous request processor. If there is no request processor, an error message is issued.
*ENDJOB
The job is ended with the *IMMED option. A job log is produced for the job.
*ENDJOBNOLIST
The job is ended with the *IMMED option. No job log is produced for the job.

Time slice end pool (TSEPOOL)

Specifies whether threads in interactive jobs should be moved to another main storage pool when they reach the time slice end. When a long wait occurs, the thread is moved back to the pool in which it was originally running. This may minimize the effect on the interactive response time of other interactive jobs. This parameter can be specified only for interactive jobs.

*SAME
The value for the time slice end pool does not change.
*SYSVAL
The value in the system value, QTSEPOOL, at the time the CHGJOB command is issued is used as the time slice end pool action for this job.
*NONE
A thread in the job is not moved when it reaches the end of its time slice.
*BASE
A thread in the job is moved to the base pool when it reaches the end of its time slice.

Print key format (PRTKEYFMT)

Specifies whether border and header information is printed when the print key is pressed.

*SAME
The value specified for this parameter does not change.
*SYSVAL
The value specified on the system value QPRTKEYFMT determines whether header or border information is printed.
*NONE
Border information and header information are not printed.
*PRTBDR
Border information is printed.
*PRTHDR
Header information is printed.
*PRTALL
Border information and header information are printed.

Sort sequence (SRTSEQ)

Specifies the sort sequence table to be used for string comparisons for this job.

Single values

*SAME
This value does not change.
*USRPRF
When the job being changed is the job in which this command is running, the sort table is obtained from the user profile under which this thread was initially running. When the job being changed is a different job, the sort table is obtained from the current user profile associated with that job.
*SYSVAL
The system value QSRTSEQ is used.
*HEX
A sort sequence table is not used. The hexadecimal values of the characters are used to determine the sort sequence.
*LANGIDUNQ
A unique-weight sort table is used.
*LANGIDSHR
A shared-weight sort table is used.

Qualifier 1: Sort sequence

name
Specify the name of the sort sequence table to be used with this job.

Qualifier 2: Library

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is used.
name
Specify the library where the sort sequence table is located.

Language ID (LANGID)

Specifies the language identifier to be associated with this job. The language identifier is used when *LANGIDUNQ or *LANGIDSHR is specified on the Sort sequence (SRTSEQ) parameter. If the job CCSID is 65535, this parameter is also used to determine the value of the job default CCSID (DFTCCSID).

*SAME
The value does not change.
*USRPRF
When the job being changed is the job in which this command is running, the language ID is obtained from the user profile under which this thread was initially running. When the job being changed is a different job, the language ID is obtained from the current user profile associated with that job.
*SYSVAL
The system value QLANGID is used.
character-value
Specify the language identifier to be used by the job.

Country or region ID (CNTRYID)

Specifies the country or region identifier to be used by the job.

*SAME
The value does not change.
*USRPRF
When the job being changed is the job in which this command is running, the country or region ID is obtained from the user profile under which this thread was initially running. When the job being changed is a different job, the country or region ID is obtained from the current user profile associated with that job.
*SYSVAL
The system value QCNTRYID is used.
character-value
Specify the country or region identifier to be used by the job.

Coded character set ID (CCSID)

Specifies the coded character set identifier (CCSID) used for this job.

*SAME
The CCSID value does not change.
*USRPRF
When the job being changed is the job in which this command is running, the CCSID is obtained from the user profile under which this thread was initially running. When the job being changed is a different job, the CCSID is obtained from the current user profile associated with that job.
*SYSVAL
The CCSID specified in the system value QCCSID is used.
*HEX
The CCSID 65535 is used, which indicates that the character data in the fields is treated as bit data and is not converted.
1-65535
Specify the CCSID.

Decimal format (DECFMT)

Specifies the decimal format used for the job.

*SAME
The value does not change.
*SYSVAL
The value specified for the QDECFMT system value is used.
*BLANK
A period (.) is used for the decimal format, zero suppression.
I
A comma (,) is used for the decimal format, zero suppression.
J
A comma (,) is used for the decimal format, one leading zero.

Character identifier control (CHRIDCTL)

Specifies the character identifier control used for the job. This attribute controls the type of CCSID conversion that occurs for display files, printer files and panel groups. The *CHRIDCTL special value must be specified on the CHRID command parameter on the create, change or override commands for display files, printer files and panel groups before this attribute will be used.

*SAME
The value does not change.
*USRPRF
When the job being changed is the job in which this command is running, the character identifier control is obtained from the user profile under which this thread was initially running. When the job being changed is a different job, the character identifier control is obtained from the current user profile associated with that job.
*SYSVAL
The value specified for the QCHRIDCTL system value will be used.
*DEVD
The *DEVD special value performs the same function as on the CHRID command parameter for display files, printer files and panel groups.
*JOBCCSID
The *JOBCCSID special value performs the same function as on the CHRID command parameter for display files, printer files and panel groups.

Spooled file action (SPLFACN)

Specifies whether or not spooled files are accessed through job interfaces after the job ends. Keeping spooled files with jobs allows job commands such as Work with Submitted Jobs (WRKSBMJOB) to work with the spooled files even after the job has ended. Detaching spooled files from jobs reduces the use of system resources by allowing job structures to be recycled when the jobs end.

*SAME
The value does not change.
*SYSVAL
The value specified in the system value QSPLFACN is used.
*KEEP
When the job ends, as long as spooled files for the job exist in the system auxiliary storage pool (ASP 1) or in a basic user ASP (ASPs 2-32), the spooled files are kept with the job and the status of the job is updated to indicate that the job has completed. If all remaining spooled files for the job are in independent ASPs (ASPs 33-255), the spooled files will be detached from the job and the job will be removed from the system.
*DETACH
When the job ends, the spooled files are detached from the job and the job is removed from the system. If the job has already ended, this change will immediately detach the spooled files from the job and remove the job from the system.

Workload group (WLCGRP)

Specifies the workload group associated with this job. You can use the Add Workload Group (ADDWLCGRP) command to define a workload group.

If the job consists of multiple routing steps, a change to this attribute during a routing step does not apply to subsequent routing steps.

Note: Changes to this parameter may affect the performance of the job being changed.

*SAME
The workload group does not change.
*NONE
The job will not be associated with a workload group.
simple-name
Specify the name of a workload group.

Maximum CPU time (CPUTIME)

Specifies the maximum processing unit time (in milliseconds) that the job can use. If the job consists of multiple routing steps, only the current routing step is affected. If the job is on a job queue, only the next routing step is affected. If the maximum time is exceeded, the job is held.

*SAME
The maximum processing unit time does not change.
*NOMAX
There is no limit on the processing unit time used.
1-9999999
Specify the maximum amount of processing unit time (in milliseconds) that can be used.

Maximum temporary storage (MAXTMPSTG)

Specifies the maximum amount of temporary (auxiliary) storage (in megabytes) that the job can use. If the job consists of multiple routing steps, only the current routing step is affected. If the job is on a job queue, only the next routing step is affected.

This temporary storage is used for storage required by the program itself and by implicitly created internal system objects used to support the job. (It does not include storage for objects in the QTEMP library.) If the maximum temporary storage is exceeded, the job is held. This parameter does not apply to the use of permanent storage, which is controlled through the user profile.

*SAME
The maximum amount of temporary storage allowed for the job does not change.
*NOMAX
The system maximum is used.
1-2147483647
Specify the maximum amount of temporary storage (in megabytes) that can be used.

Processor resources priority (PRCRSCPTY)

If your system has simultaneous multithreading (SMT) enabled, the processor resources priority will be used by the operating system to determine the relative importance of the job when it is dispatched compared to other jobs that are dispatched.

Performance may vary depending on processor model, partition placement, processor utilization and other system settings and configuration.

Note: Changes to the processor resources priority may impact overall system performance and utilization. PRCRSCPTY(*HIGH) should be used conservatively to minimize any potential performance degradation to the rest of the system.

*SAME
The processor resources priority does not change.
*SYSCTL
The system determines the processor resources priority for the job and its threads.
*NORMAL
The job and its threads will be dispatched uniformly across the maximum number of available processors.
*HIGH
The operating system will isolate this job and its threads, when possible, to processors with fewer threads running concurrently.
*LOW
The job and its threads will be dispatched to processors with other low priority jobs executing, when possible.

Duplicate job option (DUPJOBOPT)

Specifies the action taken when duplicate jobs are found by this command.

*SELECT
The selection display is shown when duplicate jobs are found during an interactive session. Otherwise, a message is issued.
*MSG
A message is issued when duplicate jobs are found.

Examples

Example 1: Changing Message Logging Values 

CHGJOB   JOB(123581/DEPT2/WS1)  LOG(2 40 *SECLVL)

This command changes the job WS1, which is associated with the user profile DEPT2, and has the job number 123581. It receives only commands and associated diagnostic messages (help text) if the messages have a severity level greater than or equal to 40. Help text, in addition to the message text, is logged in the job log.

Example 2: Changing Scheduling Priority and Job Switches 

CHGJOB   JOB(PAYROLL)  JOBPTY(4)  OUTPTY(3)  SWS(10XXXX00)

This command changes the scheduling priority for the job PAYROLL to 4 and the priority of the job's output to 3. Also, four of the eight job switches are changed: switches 1 and 2 are set to 1 and 0, switches 3 through 6 remain the same, and switches 7 and 8 are both set to 0. Because only the simple name of the job is specified, there can be only one job named PAYROLL in the system.

Example 3: Moving a Job to Another Queue 

CHGJOB   JOB(MYJOB)  JOBQ(MYLIB/MYJOBQ)  INQMSGRPY(*SYSRPYL)

This command moves the job from the job queue it is currently in to the job queue MYJOBQ in library MYLIB. For this change to be made, the job must not have begun running and must be a batch job. Also, the job is changed so that any inquiry message that is issued on behalf of this job that has an entry in the system automatic reply list is answered according to the reply in that system reply list entry. For any inquiry message not represented in the system reply list, a reply is required.

Example 4: Changing Run Priority and Default Wait Time 

CHGJOB   JOB(MYJOB)  RUNPTY(10)  DFTWAIT(150)

This command changes the run priority of the job MYJOB to 10 and the default wait time to 150 seconds, if the issuer of the command has job control authority. If the job is active, these changes take effect immediately. If the job is on a job queue, when the next routing step for the job is started, the run priority and default wait times become these values and not what was specified in the class associated with the routing entry used to start the step.

Error messages

*ESCAPE Messages

CPF1317
No response from subsystem for job &3/&2/&1.
CPF1321
Job &1 user &2 job number &3 not found.
CPF1332
End of duplicate job names.
CPF1334
Must be an interactive job for requested change.
CPF1336
Errors on CHGJOB command for job &3/&2/&1.
CPF1337
&3/&2/&1 not authorized to change parameters.
CPF1340
Job control function not performed.
CPF1341
Reader or writer &3/&2/&1 not allowed as job name.
CPF1343
Job &3/&2/&1 not valid job type for function.
CPF1344
Not authorized to control job &3/&2/&1.
CPF1351
Function check occurred in subsystem for job &3/&2/&1.
CPF1352
Function not done. &3/&2/&1 in transition condition.
CPF1634
Specified date or time has passed.
CPF1635
Requested change no longer allowed.
CPF1642
Schedule date &1 not correct.
CPF1644
Scheduled date and time not changed.
CPF1650
Both scheduled date and time must be changed.
CPF1651
Sort sequence table not accessed.
CPF180E
&4 not changed.
CPF1846
Request did not complete. System value not available.
CPF1854
Value &1 for CCSID not valid.