Submit Job using Job Scheduler (SBMJOBJS)

The Submit Job using Job Scheduler (SBMJOBJS) command allows you to submit a batch job through IBM Advanced Job Scheduler for i . You can specify submission times and dates, parameter information and all submission information.

Submitting a job from within a group does not start the group. It will only run the job that you selected for submission unless you specify *GRP in the Update Dependencies (UPDDEP) field.

Parameters

Keyword Description Choices Notes
JOB Job entry Element list Required, Key, Positional 1
Element 1: Job Name
Element 2: Group Name, *NONE
Element 3: Group sequence 1-99, *NONE
TIME Submit time 0-2400, *IMMED, *SCHED, *OFFSET Optional
TIMOFS Submit time offset 1-720, 1 Optional
DATE Submit date Character value, *CURRENT Optional
STRSEQ Starting sequence Integer, *FIRST Optional
ENDSEQ Ending sequence Integer, *LAST Optional
CHKDEP Check for dependencies *YES, *NO Optional
UPDDEP Update dependencies *NO, *YES, *GRP Optional
PARM Parameters Single values: *NONE
Other values (up to 50 repetitions): Element list		 Optional
Element 1: Parameter name Name
Element 2: Parameter data Character value
RMTLOCNAME Remote location name Name, *SAME, *JOBCTL, *LCL Optional
MAXRUN Maximum run time 1-9999, *SAME, *NOMAX Optional
PGRRCPNORM Notification normal Single values: *NONE
Other values: Element list		 Optional
Element 1: Notification recipient Name, *SAME, *JOBCTL, *ONCALL
Element 2: Notification message Character value, *SAME, *JOBCTL, *COMP
PGRRCPABN Notification abnormal Single values: *NONE
Other values: Element list		 Optional
Element 1: Notification recipient Name, *SAME, *JOBCTL, *ONCALL
Element 2: Notification message Character value, *SAME, *JOBCTL, *COMP
PGRRCPSTR Notification start job Single values: *NONE
Other values: Element list		 Optional
Element 1: Notification recipient Name, *SAME, *JOBCTL, *ONCALL
Element 2: Start limit 1-999, *JOBCTL, *SAME
PGRRCPERR Notification error message Single values: *NONE
Other values: Element list		 Optional
Element 1: Notification recipient Name, *SAME, *JOBCTL, *ONCALL
Element 2: Notification message Character value, *SAME, *JOBCTL, *ERRMSG, *JOBLOG
ALTJOB Alternate job Single values: *SAME, *NONE
Other values: Element list		 Optional
Element 1: Job Name
Element 2: Group Name, *NONE
Element 3: Group sequence 1-99, *NONE
RPTDSTID Report distribution ID Name, *SAME, *NONE Optional
RCYACN Recovery action *SAME, *JOBCTL, *SBMRLS, *SBMHLD, *NOSBM Optional
JOBD Job description Single values: *SAME, *JOBCTL, *USRPRF
Other values: Qualified object name		 Optional
Qualifier 1: Job description Name
Qualifier 2: Library Name, *LIBL, *CURLIB
JOBQ Job queue Single values: *SAME, *JOBCTL, *JOBD
Other values: Qualified object name		 Optional
Qualifier 1: Job queue Name
Qualifier 2: Library Name, *LIBL, *CURLIB
JOBPTY Job priority (on JOBQ) 1-9, *SAME, *JOBCTL, *JOBD Optional
OUTPTY Output priority (on OUTQ) 1-9, *SAME, *JOBCTL, *JOBD Optional
PRTDEV Print device Name, *SAME, *JOBCTL, *CURRENT, *USRPRF, *SYSVAL, *JOBD Optional
OUTQ Output queue Single values: *SAME, *JOBCTL, *USRPRF, *DEV, *JOBD
Other values: Qualified object name		 Optional
Qualifier 1: Output queue Name
Qualifier 2: Library Name, *LIBL, *CURLIB
USER User Name, *SAME, *JOBCTL, *CURRENT, *JOBD Optional
PRTTXT Print text Character value, *SAME, *JOBCTL, *BLANK, *JOBD, *SYSVAL Optional
RTGDTA Routing data Character value, *SAME, *JOBCTL, *JOBD Optional
CURLIB Current library Name, *SAME, *JOBCTL, *USRPRF, *CRTDFT Optional
LIBL Library list Name, *SAME, *JOBCTL, *JOBD, *SYSVAL, *NONE Optional
LOG Message logging Element list Optional
Element 1: Level 0-4, *SAME, *JOBCTL, *JOBD
Element 2: Severity 0-99, *SAME, *JOBCTL, *JOBD
Element 3: Text *SAME, *JOBCTL, *JOBD, *MSG, *SECLVL, *NOLIST
LOGCLPGM Log CL program commands *SAME, *JOBCTL, *JOBD, *YES, *NO Optional
INQMSGRPY Inquiry message reply *SAME, *JOBCTL, *JOBD, *RQD, *DFT, *SYSRPYL Optional
HOLD Hold on job queue *SAME, *JOBCTL, *JOBD, *YES, *NO Optional
SWS Job switches Character value, *SAME, *JOBCTL, *JOBD Optional
MSGQ Message queue Single values: *SAME, *JOBCTL, *USRPRF, *NONE
Other values: Qualified object name		 Optional
Qualifier 1: Message queue Name
Qualifier 2: Library Name, *LIBL, *CURLIB
ACGCDE Accounting code Character value, *SAME, *JOBCTL, *JOBD, *USRPRF, *BLANK Optional
RUNPTY Run priority 01-99, *SAME, *JOBCTL, *NOCHG Optional
INLASPGRP Initial ASP group Name, *SAME, *JOBCTL, *CURRENT, *JOBD, *NONE Optional

Job entry (JOB)

Specifies the name of the job schedule entry. You must specify a job name for every job and alternately can specify a group to which the job belongs as well as a sequence number for the job within the group.

The first job of a group must be sequence number 1. Subsequent sequence numbers should leave gaps (10, 20, 30 and so on) to allow job insertions if necessary.

This is a required parameter.

Element 1: Job

name
Specify the user-defined name of the job schedule entry.

Element 2: Group

*NONE
The job is not assigned to a group.
name
Specify the user-defined name of the group to which the job belongs.

Element 3: Group sequence

*NONE
There is not a sequence number assigned to the job.
1-99
Specify the sequence number of the job within the group.

Submit time (TIME)

Specifies the time that you want this job to be submitted. Jobs can be submitted at a specified time, immediately or at the next scheduled time. Times are entered in hour, minute (HHMM) format and range from 0001 to 2400 (midnight).

*SCHED
The job is to be submitted by IBM Advanced Job Scheduler for i at the next scheduled time.
*IMMED
The job is submitted immediately.

Note: This will be the default for any job group with a sequence greater than 1.

*OFFSET
The job will be submitted based on the number of minutes specified in the Submit time offset parameter.
0-2400
Specify the time that you want the job to be submitted by IBM Advanced Job Scheduler for i .

Submit time offset (TIMOFS)

Specifies the amount of time in minutes from 1 to 720 to add to the current time in order to calculate the submit time.

Submit date (DATE)

Specifies the date that you want this job to be submitted. Dates are specified in job date format.

*CURRENT
The job is to be submitted by IBM Advanced Job Scheduler for i on the current date at the time specified in the Scheduled time (TIME) parameter.
character-value
Specify the date in job date format that you want the job to be submitted by IBM Advanced Job Scheduler for i .

Starting sequence (STRSEQ)

Specifies the starting command sequence number for the job that you are submitting.

*FIRST
Start with the first command sequence number for the job that you are submitting.
integer
Specify the sequence number of the command within the job that you want to start with.

Ending sequence (ENDSEQ)

Specifies the ending command sequence number for the job that you are submitting.

*LAST
End with the last command sequence number for the job that you are submitting.
integer
Specify the sequence number of the command within the job that you want to end with.

Check for dependencies (CHKDEP)

Specifies whether you should check resource and active dependencies before allowing the job to be submitted.

*YES
Check resource and active dependencies when submitting a job. The dependencies must be satisfied before the job will be submitted.
*NO
Do not check resource and active dependencies when submitting a job. The dependencies do not need to be satisfied before the job will be submitted.

Update dependencies (UPDDEP)

Specifies whether you should update dependencies associated with the original job after the job has completed.

*NO
Do not update dependencies after the job has completed.
*YES
Update dependencies after the job has completed.
*GRP
Update dependencies after the job has completed. If the job is part of a group, continue group processing with the next job. This is equivelant to the Start Group using JS (STRGRPJS) command.

Parameters (PARM)

Specifies the name of the parameter and the parameter data that you want to use for the submitted job. Parameters that you specify must be defined in IBM Advanced Job Scheduler for i .

Any character is valid for entry into the parameter data field. Validity will be checked to the extent of the use of the parameter within your programs or of the IBM Advanced Job Scheduler for i job when submitted. The number of characters in the parameter data should correspond with the length placed in the Parameter lengthfield. Data entered in a shorter length than the Parameter lengthfield will pass data padded with blanks to the length of the parameter. Leading blanks and embedded blanks will be passed to the parameter in your request data exactly as keyed. Any parameter data keyed past the specified length of the parameter field will be truncated. Apostrophes ( ' ) used in parameter data must appear in pairs to be valid. Apostrophes are required to be in a field that can accept text and apostophes. If only one apostrophe is used, the parameter will be rejected with the error "Quotes ('') in Parameter Data Must Appear In Pairs". You must correct this error before continuing.

There are special values that can be used in the Parameter data field. Some of these special values are used in date calculations. For example, one of the special values used in date calculations is *QMDY. The Q indicates the system date, the M indicates month, the D indicates day and the Y indicates year. Whenever you see a special value beginning with Q the calculation is based on the current system date. If the special value begins with A, the calculation is based on the submission date.

For example, parameter data specified as *QMDY(D-33,M+1,D+5W) would indicate that the current system date is the beginning point for the calculation. You would then subtract 33 days from the current system date, add 1 to the month and add five working days to the date calculated from the prior day (D-33) calculation. The resulting date would be expressed in month, day, year format.

Another example would be *QMDY(M+1,D=1). This indicates that based on the current system date, add one to the month and set the day as the first day of the month. The resulting date would be expressed in month, day, year format.

Another character that is in some special values is C, which is a century indicator, 0 being the twentieth century and 1 being the twenty first century.

Single values

*NONE
The job that you are submitting does not require any parameters entered here.

Other values (up to 50 repetitions)

Element 1: Parameter name

name
Specify the name of the parameter that you want to use with this job.

Element 2: Parameter data

character-value
Specifies the parameter data that you want to use for the parameter.

Remote location name (RMTLOCNAME)

Specifies the location and network identification of the system on which to run the job.

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
Use the remote location name specified in the job controls.
*LCL
Run the job on the local IBM i.
remote-location-name
Specify the name of the remote location associated with the system on which to run the job.
network-ID.remote-location-name
Specify the network identifier and the name of the remote location associated with the system. Specify these values using the format nnnnnnnn.cccccccc where nnnnnnnn is the network identifier and cccccccc is the remote location name.

Maximum run time (MAXRUN)

Specifies the maximum run duration in minutes for the job.

Note: A value specified for the MAXRUN prompt will be ignored when used with schedule code *ALTERNATE.

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*NOMAX
There is no maximum duration for the job.
1-9999
Specify the number of minutes that is the maximum duration for this job. After this number of minutes has passed, IBM Advanced Job Scheduler for i will end the job whether it has completed or not.

Notification normal (PGRRCPNORM)

Specifies the notification recipient who is to receive normal completion messages for the job that you are adding or changing. This field is used in conjunction with the notification command.

Note: SMTP information must be specified before this feature may be used with the Send Distribution using JS (SNDDSTJS) command.

Note: The values that you specify for Notification recipient normal and Notification message are the substitution variables used for the &RCP and &MSGTXT variables respectively in the CHGNFYJS command.

You can specify the notification message that you want to send to the specified recipient when the job completes normally.

Single values

*NONE
No notification recipient is assigned to receive messages when this job completes normally.

Element 1: Notification recipient

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
You are using the notification recipient specified in the job controls.
*ONCALL
Only recipients that are on-call will receive the message.
name
Specify the name of a recipient who is to receive messages from the job when it completes normally.

Element 2: Notification message

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The notification recipient is sent the notification message from the job controls.
*COMP
The completion status of the job is sent.
character-value
Specify the notification message that you want to send to the notification recipient when this job completes normally.

Notification abnormal (PGRRCPABN)

Specifies the notification recipient who is to receive abnormal completion messages for the job that you are adding or changing. This field is used in conjunction with the notification command.

Note: SMTP information must be specified before this feature may be used with the Send Distribution using JS (SNDDSTJS) command.

Note: The values that you specify for Notification recipient abnormal and Notification message are the substitution variables used for the &RCP and &MSGTXT variables respectively in the CHGNFYJS command.

You can specify the notification message that you want to send to the specified recipient when the job completes abnormally.

Single values

*NONE
No notification recipient is assigned to receive messages when this job completes abnormally.

Element 1: Notification recipient

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
You are using the notification recipient specified in the job controls.
*ONCALL
Only recipients that are on-call will receive the message.
name
Specify the name of a recipient who is to receive messages from the job when it completes abnormally.

Element 2: Notification message

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The notification recipient is sent the notification message from the job controls.
*COMP
The completion status of the job is sent.
character-value
Specify the notification message that you want to send to the notification recipient when this job completes abnormally.

Notification start job (PGRRCPSTR)

Specifies the notification recipient who is to receive notification for the job that you are adding or changing if the job does not start within the limit after it has been submitted. This field is used in conjunction with the notification command.

Note: SMTP information must be specified before this feature may be used with the Send Distribution using JS (SNDDSTJS) command.

Note: The values that you specify for Notification recipient start job is the substitution variable used for the &RCP variable in the CHGNFYJS command. The &MSGTXT will be replaced with message IJS6059.

You can specify the start limit in minutes. This is the amount of time a job can be sitting on the job queue before a notification is issued.

Single values

*NONE
No notification recipient is assigned to receive messages when this job exceeds the start limit.

Element 1: Notification recipient

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
You are using the notification recipient specified in the job controls.
*ONCALL
Only recipients that are on-call will receive the message.
name
Specify the name of a recipient who is to receive messages if the job does not start within the limit after the job has been submitted.

Element 2: Start limit

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The start limit in the job controls is used.
1-999
Specify the number of minutes that a job can be sitting on the job queue before a notification is issued.

Notification error message (PGRRCPERR)

Specifies the notification recipient who is to receive error messages for the job that you are adding or changing. Notification will occur when the job is waiting on an inquiry message and when error messages are received after processing a command for the job. This field is used in conjunction with the notification command.

Note: Error notification is not performed for jobs running on a remote system.

Note: SMTP information must be specified before this feature may be used with the Send Distribution using JS (SNDDSTJS) command.

Note: The values that you specify for the recipient and the message are the substitution variables used for the &RCP and &MSGTXT variables respectively in the CHGNFYJS command.

You can specify the notification message that you want to send to the specified recipient when the job encounters an error message.

Single values

*NONE
No notification recipient is assigned to receive error messages.

Element 1: Notification recipient

*JOBCTL
You are using the notification recipient specified in the job controls.
*ONCALL
Only recipients that are on-call will receive the message.
name
Specify the name of a recipient who is to receive error messages.

Element 2: Notification message

*JOBCTL
The notification recipient is sent the notification message from the job controls.
*ERRMSG
The actual error message is sent.
*JOBLOG
The job log of the job is sent in the body of the email message. This can only be used inconjuction with the Send Distribution using JS (SNDDSTJS) command.
character-value
Specify the notification message that you want to send to the notification recipient when this job encounters an error message.

Alternate job (ALTJOB)

Specifies the name of the alternate job for the job. Alternate jobs only run when a regular job terminates abnormally. Jobs are not required to have alternate jobs. If you want to select a job from a job list when prompting this command, place the cursor on this parameter and press F4.

You can also specify a group and group sequence if the alternate job is a member of a group.

Single values

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*NONE
The job does not have an alternate job.

Element 1: Job

name
Specify the name of the job that you want to be the alternate job for this job.

Element 2: Group

*NONE
The alternate job does not have an alternate group.
name
Specify the name of the group associated with the alternate job for this job.

Element 3: Group sequence

*NONE
The alternate job does not have a sequence number assigned.
1-99
Specify the sequence number assigned to the alternate job.

Report distribution ID (RPTDSTID)

Specifies the report distribution ID that is used to distribute the reports generated as a result of processing the job.

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*NONE
The job does not have a report distribution ID.
name
Specify the report distribution ID that you want to associate with this job.

Recovery action (RCYACN)

Specifies the recovery action to be taken if the job cannot be submitted at the designated time because the system is powered down or in a restricted state. The action specified on the parameter occurs at the next IPL or when the IBM Advanced Job Scheduler for i system becomes active.

Jobs submitted during IPL or when the system comes out of restricted state are submitted in the same order that they would have been had the jobs been submitted at the times specified in the job schedule entries. If multiple occurrences of a recurring job are missed, the job is submitted only once. The first missed occurrence of the job is calculated from the current date.

Since the scheduler portion of IPL need not be complete for the IPL of the system to be complete, other jobs may start on the system before all of the jobs have been submitted.

This parameter does not apply:

Note: A value specified for the RCYACN parameter will be ignored when used with schedule code *ALTERNATE or *NONE.

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The job uses the uses the recovery action specified in the job controls.
*SBMRLS
The job is submitted in release state (RLS).
*SBMHLD
The job is submitted in the held state (HLD).
*NOSBM
The job is not submitted.

Specifying *NOSBM affects only missed occurrences of the job. If the job schedule entry is a recurring job, future occurrences are not affected.

Job description (JOBD)

Specifies the job description to be used with this job.

Single values

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The job description in the job controls is used for this job.
*USRPRF
The job description in the user profile under which the submitted job runs is used as the job description of the submitted job.

Qualifier 1: Job description

name
Specify the name of the job description to be used for the job.

Qualifier 2: Library

*LIBL
The library list is used to locate the job description name.
*CURLIB
The current library for the job is used to locate the job description name. If no library is specified as the current library for the job, QGPL is used.
name
Specify the name of the library where the job description name is located.

Job queue (JOBQ)

Specifies the job queue in which this job is to be placed.

Single values

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The job queue in the job controls is used for this job.
*JOBD
The submitted job is placed on the job queue named in the specified job description.

Qualifier 1: Job queue

name
Specify the name (library-name/job-queue-name) of the job queue on which the submitted job is placed.

Qualifier 2: Library

*LIBL
The library list is used to locate the job queue name.
*CURLIB
The current library for the job is used to locate the job queue. If no library is specified as the current library for the job, QGPL is used.
name
Specify the name of the library where the job queue name is located.

Job priority (on JOBQ) (JOBPTY)

Specifies the job queue scheduling priority. Valid values range from 1 through 9, where 1 is the highest priority and 9 is the lowest priority.

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The scheduling default specified in the job controls is used for the job.
*JOBD
The scheduling priority specified in the job description is used for the job.
1-9
Specify a value to be used for the scheduling priority for the job.

Output priority (on OUTQ) (OUTPTY)

Specifies the output queue priority for spooled output files that are produced by this job. Valid values range from 1 through 9, where 1 is the highest priority and 9 is the lowest priority.

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The output priority default specified in the job controls is used for the job.
*JOBD
The output priority specified in the job description is used for the job.
1-9
Specify a value to be used for the output priority for the job.

Print device (PRTDEV)

Specifies the default printer device for this job.

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The printer specified in the job controls is used by the job as the printer device.
*CURRENT
The same printer device being used by the job that is currently running is used for this job.
*USRPRF
The printer device specified in the user profile where the submitted job runs is used as the printer device for this job. The printer device name is obtained from the profile when this job is submitted.
*SYSVAL
The printer device specified in the system value, QPRTDEV, when this job is submitted is used.
*JOBD
The printer device specified in the job description is used for the submitted job.
name
Specify the name of the printer device used for the submitted job.

Output queue (OUTQ)

Specifies the output queue to be used for spooled output produced by the job. This parameter only applies to spooled printer files that specify *JOB for the output queue.

Single values

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The output queue specified in the job controls is used as the job's output queue.
*USRPRF
The output queue in the user profile where the submitted job runs is used as the output queue for this job.
*DEV
The output queue associated with the printer device for the spooled file is used.
*JOBD
The output queue named in the job description used with the submitted job is the job's default output queue.

Qualifier 1: Output queue

name
Specify the name of the output queue to be used as the default output queue by the submitted job.

Qualifier 2: Library

*LIBL
The library list is used to locate the output queue name.
*CURLIB
The current library for the job is used to locate the output queue name. If no library is specified as the current library for the job, QGPL is used.
name
Specify the name of the library where the output queue name is located.

User (USER)

Specifies the name of the user profile for the job being submitted. If *RQD is specified in the job description, *JOBD cannot be specified; a user name must be specified instead.

Note: The following IBM-supplied objects are not valid on this parameter:

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The user profile specified in the job controls is used for the job being submitted.
*CURRENT
The same user profile used by the job that is currently running is used for the submitted job.
*JOBD
The user profile named in the specified job description is used for the job being submitted.
name
Specify the name of the user profile that is used for the job being submitted. You must be authorized to the user profile; the user profile must be authorized to the job description.

Print text (PRTTXT)

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

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The value in the job controls is used for this job.
*JOBD
The value in the job description is used for this job.
*SYSVAL
The system value, QPRTTXT, is used for this job.
*BLANK
No text is printed.
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. The text on the listing will be centered in the same way it is entered.

Routing data (RTGDTA)

Specifies the routing data used to start the first routing step in the job. The routing data is used to determine the routing entry that identifies the program that the job runs.

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The value in the job controls for routing data is used for this job.
*JOBD
The routing data specified in the job description is used to start the routing steps.
character-value
Specify the character string that is used as routing data for the job. A maximum of 80 characters can be entered, enclosed in apostrophes if necessary.

Current library (CURLIB)

Specifies the name of the current library associated with the job being run.

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The current library in the job controls is used for the submitted job.
*USRPRF
The current library in the user profile where the submitted job runs is used as the current library for the submitted job.
*CRTDFT
There is no current library for the submitted job. If objects are created in the current library, QGPL is used as the default current library.
name
Specify the name of a library used as the current library of the submitted job.

Library list (LIBL)

Specifies the name of the library list that is used to search for any operating system object names that were specified without a library qualifier. If you want to select a library list from a list when promting this command, place the cursor ont this parameter and press F4.

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The library list in the job controls is used for this job.
*JOBD
The library list in the job description used with this job is used as the initial user part of the library list for the job.
*SYSVAL
The system default user library list is used by this job. It contains the library names that were specified in the system value, QUSRLIBL, at the time that the job is started.
*NONE
The user portion of the initial library list for this job will be empty.
name
Specify the name of the library list that you want to use for this job.

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 specified in the job description associated with this job are used.

Element 1: Level

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The value specified in the job controls for logging is used for this job.
*JOBD
The value specified for message logging in the job description is used for this job.
0-4
Specify the message logging level to be used for this job's messages. The values for logging levels are:
0
No data is logged.
1
The following information is logged: All messages sent to the job's external message queue with a severity level greater than or equal to the message severity specified (this includes the indications of job start, job end and job completion status).
2
The following information is logged:
  • Logging level 1 information.
  • Requests or commands being logged from a CL program for which messages are issued with a severity code greater than or equal to the severity level specified.
  • All messages associated with a request, or commands being logged from a CL program, that results in a high-level message with a severity level greater than or equal to the severity specified.
3
The following information is logged:
  • Logging level 1 information.
  • All requests or commands being logged from a CL program.
  • All messages associated with a request, or commands being logged from a CL program, that results in a high-level message with a severity level greater than or equal to the severity specified.
4
The following information is logged; All requests or commands being logged from a CL program and all messages with a severity code greater than or equal to the severity specified, including trace messages.

Note: A high-level message is one that is sent to the program message queue of the program that received the request or commands being logged from a CL program.

Element 2: Severity

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The value specified in the job controls for message severity is used for this job.
*JOBD
The value specified for message logging in the job description is used for this job.
0-99
Specify the lowest severity level that causes an error message to be logged in the job's log.

Element 3: Text

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The value specified in the job controls for message text is used for this job.
*JOBD
The value specified for message logging in the job description is used for this job.
*MSG
Only message text is written to the job's log or shown to the user.
*SECLVL
Both the message text and message help of the error message is written to the job's log or shown to the user.
*NOLIST
No job log is produced if the job completes normally. If the job ends abnormally (if the end of job code is 20 or higher), a job log is produced. The messages appearing in the job's log contain both message text and help text.

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 LOG parameter on the Create CL Program (CRTCLPGM) command, the value specified for this parameter is used. Other values for the LOG parameter override the value specified for this parameter. The commands are logged in the same manner as the requests.

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The value in the job controls is used for this job.
*JOBD
The value specified in the job description is used.
*YES
The commands in a CL program are logged to the job log.
*NO
The commands in a CL program are not logged to the job log.

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 no change is made in the way that predefined messages are answered, 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 value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The value in the job controls for inquiry message reply is used for this job.
*JOBD
The inquiry message reply control specified in the job description used with this job is used.
*RQD
A reply is required by the receiver of the inquiry message for all inquiry messages that occur when this command is run.
*DFT
The default message reply is used to answer any inquiry messages that occur when this command is run.
*SYSRPYL
The system reply list is checked to see if there is an entry for any inquiry message that is issued as a result of running this job that has a message identifier and any comparison data that match the inquiry message identifier and message data. If a match occurs, the reply value in that entry is used. If no entry exists for that message, a reply is required.

Hold on job queue (HOLD)

Specifies whether this job is held at the time that it is put on the job queue. A job placed on the job queue in the hold state is held until it is released by the Release Job (RLSJOB) command or ended, either by the End Job (ENDJOB) command or by the Clear Job Queue (CLRJOBQ) command.

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The value in the job controls for hold on job queue is used for this job.
*JOBD
The value specified in the job description determines whether the job is held when it is put on the job queue.
*YES
The job is held when it is put on the job queue until it is released by a Release Job (RLSJOB) command or ended by an End Job (ENDJOB) command.
*NO
The job is not held when it is put on the job queue.

Job switches (SWS)

Specifies the first settings for a group of eight job switches used with this job. These switches can be set or tested in a CL program and used to control the flow of the program. Only 0's (off) and 1's (on) can be specified in the 8-digit character string.

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The value in the job controls for job switches is used for this job.
*JOBD
The value specified in the job description is the first setting for the job's switches.
character-value
Specify any combination of eight zeros and ones that is used as the first switch setting for the submitted job.

Message queue (MSGQ)

Specifies the name of the message queue to which a completion message is sent when the submitted job has completed running, either normally or abnormally. If an abnormal ending occurs, the help information for the completion message specifies the possible causes.

Single values

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The value in the job controls for message queue is used for this job.
*USRPRF
A completion message is sent to the message queue specified in the user profile of the submitter.
*NONE
No completion message is sent.

Qualifier 1: Message queue

name
Specify the name of the message queue to which the completion message is to be sent.

Qualifier 2: Library

*LIBL
The library list is used to locate the message queue name.
*CURLIB
The current library is used to locate the message queue name. If no library is specified as the current library for the job, QGPL is used.
name
Specify the name of the library where the message queue name is located.

Accounting code (ACGCDE)

Specifies the accounting code that is used when logging system resource use for jobs that use this description.

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The accounting code for jobs using this description is obtained from the job controls.
*JOBD
The accounting code for jobs using this description is obtained from the job description.
*USRPRF
The accounting code for jobs using this description is obtained from the user profile associated with the job.
*BLANK
An accounting code of 15 blanks is assigned to jobs that use this description.
character-value
Specify the accounting code that you want to use for jobs using this description.

Run priority (RUNPTY)

Specifies the run priority of running for the job. Priority of running is a value ranging from 1 (highest priority) through 99 (lowest priority), that represents the importance of the job when it competes with other jobs for machine resources. This value represents the relative (not absolute) importance of the job. If the job is rerouted, this value is reset according to the job's importance within the job class.

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The run priority is obtained from the job controls.
*NOCHG
The run priority is not changed when job processing starts.
01-99
Specify the run priority that the job uses.

Initial ASP group (INLASPGRP)

Specifies the initial setting for the auxiliary storage pool (ASP) group name for the initial thread of the submitted job. A thread can use the Set Auxiliary Storage Pool Group (SETASPGRP) command to change its library name space. When an ASP group is associated with a thread, all libraries in the independent ASPs in the ASP group are accessible and objects in those libraries can be referenced using regular library-qualified object name syntax. The libraries in the independent ASPs in the specified ASP group plus the libraries in the system ASP (ASP number 1) and basic user ASPs (ASP numbers 2-32) form the library name space for the thread.

*SAME
The value specified in the IBM Advanced Job Scheduler for i job entry is used.
*JOBCTL
The inital ASP group is obtained from the job controls.
*CURRENT
The ASP group name for the current thread is used for the submitted job.
*JOBD
The initial ASP group name specified in the job description is used for the submitted job.
*NONE
Specifies the initial thread of the submitted job will be started with no ASP group. The library name space will not include libraries from any ASP group. Only the libraries in the system ASP and any basic user ASPs will be in the library name space.
name
Specify the name of the ASP group to be set for the initial thread of the submitted job. The ASP group name is the name of the primary ASP device within the ASP group. All libraries from all ASPs in this ASP group will be included in the library name space.

Examples 

SBMJOBJS   JOB(JOB02)  TIME('300')  DATE('8/19/09')

This command submits job JOB02 and schedules it to run at 3:00 a.m. on August 19, 2009. DATE is expressed in mm/dd/yy format in this example.

Error messages

Unknown