CL Command Reference - CRTJOBD
CL Command List > CRTJOBD Reference
Description:
The Create Job Description (CRTJOBD) command creates a job description object that contains a specific set of job-related attributes that can be used by one or more jobs. The attributes determine how each job is run on the system. The same job description can be used by multiple jobs. The values in the job description are usually used as the default values of the corresponding parameters in the Batch Job (BCHJOB) and Submit Job (SBMJOB) commands when their parameters are not specified.
The values in the job description can be overridden by the values specified on the BCHJOB and SBMJOB commands.
Restrictions:
1. To use this command, you must have:
. read (*READ) and add (*ADD) authority to the library where the job description is to be created.
. use (*USE) authority to the user profile specified on the User (USER) parameter.
2. To create a job description with an accounting code other than *USRPRF, you must have *USE authority to the Change Accounting Code (CHGACGCDE) command.
Examples:
Example 1: Creating a Job Description for Interactive Jobs
CRTJOBD JOBD(INT4) USER(*RQD) RTGDTA(QCMDI)
INQMSGRPY(*SYSRPYL)
TEXT(¡¯Interactive #4 JOBD for Department 127¡¯)
This command creates a job description named INT4 in the user¡¯s current library. This job description is for interactive jobs and is used by Department 127. When you sign on, you must type your password. The characters QCMDI are used as routing data that is compared with the routing table of the subsystem where the job is run. All inquiry messages are compared to the entries in the system reply list to determine whether a reply is issued automatically.
Example 2: Creating a Job Description for Jobs on a Specified Queue
CRTJOBD JOBD(BATCH3) USER(*RQD) JOBQ(NIGHTQ) JOBPTY(4)
OUTPTY(4) ACGCDE(NIGHTQ012345) RTGDTA(QCMDB)
TEXT(¡¯Batch #3 JOBD for high priority night work¡¯)
This command creates a job description named BATCH3 in the user¡¯s current library. The jobs using this description are placed on the job queue NIGHTQ. The priority for jobs using this description and their spooled output is 4. QCMDB is the routing data that is compared with entries in the routing table of the subsystem where the job runs. The accounting code of NIGHTQ012345 is used when recording accounting statistics for jobs that use this job description.
Example 3: Specifying Request Data
CRTJOBD JOBD(PAYWK) USER(QPGMR) RTGDTA(QCMDB)
RQSDTA(¡¯CALL PAY025 PARM(WEEKLY UNION)¡¯)
This command creates a job description named PAYWK in the user¡¯s current library. Jobs using this job description run under the IBM-supplied user profile for the programmer, QPGMR, and use the accounting code found in that user profile. If the job is started via the SBMJOB command, the accounting code of the person submitting the command is automatically used. The routing data QCMDB is compared with entries in the routing table of the subsystem where the job is run. The request data passed to the command processing program is a CALL command that names the application program that is run and passes a parameter to it.