COZTOOLS-Change Job Using JOBD (CHGJOBA)

The COZTOOLS-Change Job Atributes (CHGJOBA) command uses the specified *JOBD (job description) to change the attributes of the current running job to those of the *JOBD. The attributes that are changed include the User Portion of the Library List, CL Logging, Message Logging, and the Job's Output Queue. The corresponding parameters of the IBM CL CHGJOB command would be LOG, LOGCLPGM, and OUTQ. In addition the CL command CHGLIBL's LIBL parameter would be the corresponding functionality to change the library list.

Parameters

Keyword	Description	Choices	Notes
JOBD	Job Description	Single values: USRPRF, SAME, NONE Other values: Qualified object name*	Required, Positional 1
	Qualifier 1: Job Description	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
LIBL	Change Library List to	JOBD, QUSRLIBL, SYSVAL, *SAME	Optional, Positional 2
OUTQ	Output Queue	JOBD, SAME	Optional, Positional 3
LOG	Job Logging Level	JOBD, SAME	Optional, Positional 4
LOGCLPGM	Log CL Programs	JOBD, SAME, YES, NO	Optional, Positional 5
LOGOUTPUT	Joblog Output Schedule	JOBD, SAME	Optional, Positional 6
JOBMSGQFL	Job Message Queue Full action	JOBD, SAME	Optional, Positional 7
INQMSGRPY	Inquiry Message Reply	JOBD, SAME	Optional, Positional 8
SPLFACN	SPOOL File action	JOBD, SAME	Optional, Positional 9

Top

Job Description (JOBD)

Specifies the Job Description whose attributes are applied to the currently running job.

This is a required parameter.

Qualifier 1: Job Description

*USRPRF: The Job Description associated with the User Profile of the user running the command is retrieved and used as the Job Description name.
name: Specify the name of a Job Description object (*JOBD) whose attributes shall be used to change the current job's attributes.
*SAME or *NONE: The Job Description parameter is ignored. All attributes with *JOBD are not changed. Only the LIBL and LOGCLPGM commands are processed.

Change Library List (LIBL)

Specifies if the User Portion of the current Job's library is changed to that of the Job Description specified on the JOBD parameter.

*JOBD: The user portion of the current job's library list is changed to the library list (LIBL parameter) attribute of the Job Description. If the JOBD's INLLIBL is *SYSVAL then the QUSRLIBL system value is retrieved and used to set the current job's library list.
*SYSVAL: The library list stored in QUSRLIBL is retrieved and used to set the library list. Whatever value is specified for the actual JOBD's INLLIBL parameter is ignored.
*SAME: The library list is not changed by this command when *SAME is specified.

Output Queue (OUTQ)

Specifies whether the Job's Output Queue is changed to the Output Queue (OUTQ) attribute of the specified Job Description.

*JOBD: The Output Queue for this job is change to that of the Job Description specified on the JOBD parameter.
*SAME: The Output Queue for this job is not changed by this command.

Job Logging Level (LOG)

Specifies the message logging values used to determine the amount and type of information sent to the joblog are changed to that of the job description specified on the JOBD parameter.

*JOBD: The Message Logging values are changed to that of the job description specified on the JOBD parameter.
*SAME: The Message Loggin values of the current job are not changed by this command.

Log CL programs (LOGCLPGM)

Specifies whether the commands that are run in a CL program are logged to the job log through the message queue.

*JOBD: CL command logging is changed to that of the job description specified on the JOBD parameter.
*SAME: CL Logging for the current job is not changed by this command.

Joblog Output Schedule (LOGOUTPUT)

Specifies how the job log will be produced when the job completes. The settings are *JOBEND, *JOBLOGSVR, *PND or *SYSVAL

Using LOGOUTPUT(*JOBEND) is the default and produces the best results. But LOGOUTPUT(*JOBLOGSVR) causes the job to use the Joblog Server to produce Joblogs regardless of the ability of the Job to produce the joblog itself. Note that LOGOUTPUT(*JOBEND) will switch automatically to *JOBLOGSVR when the job cannot produce the joblog for any reason. LOGOUTPUT(*PND) means that the joblog is not produced at job end by stays in a Pending status until you actually attempt to produce the joblog using an API or the DSPJOBLOG command.

*JOBD: Joblog schedule is changed to that of the job description specified on the JOBD parameter.
*SAME: Joblog schedule is not changed by this command.

Joblog message queue full action (JOBMSGQFL)

Specifies what happens when the joblog message queue becomes full. The settings are *WRAP, *NOWRAP, *PRTWRAP or *SYSVAL.

*JOBD: Joblog Message Queue Full action is changed to that of the job description specified on the JOBD parameter.
*SAME: Joblog Message Queue Full action is not changed by this command.

Inquiry Message Reply action (INQMSGRPY)

Specifies what happens when an Inquiry message is issued for this job. The settings for this option are: *RQD, *DFT, and *SYSRPYL

*JOBD: The Inquiry Message Reply action is changed to that of the job description specified on the JOBD parameter.
*SAME: The Inquiry Message Reply action is not changed by this command.

SPOOL File action at job end (SPLFACN)

Specifies whether SPOOL files are detached from this job when the job ends. This can free up resources. If the SPOOL file is detached, the SPOOL file is no longer associated with this job after the job completes/ends. Using CHGJOB SPLACN(*DETACH) releases the SPOOL file once the job ends, specifying *KEEP (the default) retains the SPOOL-File-to-Job association after the job ends. The settings for this option are: *SYSVAL, *KEEP, *DETACH

*JOBD: The SPOOL File action is changed to that of the job description specified on the JOBD parameter.
*SAME: The SPOOL File action is not changed by this command.

Error messages for CHGJOBA

*ESCAPE Messages

CPF1075: Job description &1 in &2 is not found.
CPC1607: Job description &1 not found in library list.