IBM i Job

This Task is licensed separately. In order to use this task, you will need a license that has this option enabled in it.

IBM i Job tasks submit commands to QBATCH on an IBM i system. Once submitted, the IBM i system controls batch scheduling priorities. The job is monitored through completion and current job status is viewable within the process in the Operations area of the product.

The agent uses the SBMJOB command to submit jobs to the IBM i. The agent automatically prefixes command strings with SBMJOB and uses the LOG option to acquire the job logs. The client prevents entering LOG and SBMJOB options in the command strings.

All of the fields described in this page are specific to this service. To get general information for setting up a task, see Tasks.

IBM i Job Properties

This table describes the IBM i Job Task properties:

Field	Description
SBMJOB	The command that will be submitted to QBATCH with the SBMJOB command. Clicking on the ellipsis () icon will bring up the Command dialog that will give the user more space to enter the command. Do not include the SBMJOB command or the LOG parameter as they are added automatically to the command string. For example, if the command in the IBM i Job task is: CMD(DSPJOBD JOB(PR206) OUTPUT(PRINT)) then the command is sent as: SBMJOB LOG(4 0 MSG) CMD(DSPJOBD JOB(PR206) OUTPUT(*PRINT)).
Pre Job Cmd	The IBM i command that will be run prior to the job being submitted to QBATCH.
Send Alert on Active Error	Optional. You can select Send Alert on Active Error check box to create an alert that can be managed by the Alert system when an active IBM i job enters the waiting-on-message state (MSGW). Active jobs enter this state because of operating system or program conditions. When an operator responds to the message on the IBM i, the task leaves the MSGW state and the task resumes processing. The alert is removed automatically from the Authoring.
Retain Job Logs	Determines if the job logs are removed from the IBM i after they are returned to the scheduler.
Spool File Name	The name of the spool file that will be returned if output is returned to the scheduler.
Spool File Number	The number of the spool file that will be returned if output is returned to the scheduler.

The agent can retrieve output from spool files produced by jobs it runs on the IBM i and send the output back as part of the task. To use this feature, the spool file name and number of the output must be specified. This name and number varies from application to application. Check with an administrator of each specific application to get the appropriate information. The output is returned as text and is translated to ASCII.

The job logs can view viewed from the process item logs with the EXTERNAL log type.