Controlling jobs in extended mode
About this task
With the IBM i agent, HCL Workload Automation can launch jobs to run on an IBM i system. As for any other HCL Workload Automation job, it does not begin to run until all specified dependencies have been resolved for the job. Using the IBM i agent, jobs are submitted to run in extended mode using the IBM i SBMJOB system command. In the same way as when running the SBMJOB command from the command line, unless otherwise specified, HCL Workload Automation launches jobs with the attributes of the user profile that was used to start the IBM i agent.
For more information about how to define the IBM i jobs, see the standard job documentation. The logon field can specify any valid and active IBM i user profile. The parameters for an IBM i job are specified in the command or script field of the HCL Workload Automation standard job, using the following syntax. The braces and enclosed text must be replaced with the appropriate SBMJOB parameters for the job.
"submit: job(testjob) cmd(dsplib lib(qtws)) user(usera) jobd(qgpl/testjobd)"| SBMJOB parameter | Allowed | Description |
|---|---|---|
| CMD() | Y | See SBMJOB documentation. |
| JOB() | Y | If not specified, the IBM i job name consists of the first 10 characters of the HCL Workload Automation job name. |
| JOBD() | Y | See SBMJOB documentation. |
| JOBQ() | Y | See SBMJOB documentation. |
| JOBPTY() | Y | See SBMJOB documentation. |
| OUTPTY() | Y | See SBMJOB documentation. |
| PRTDEV() | Y | See SBMJOB documentation. |
| OUTQ() | Y | See SBMJOB documentation. |
| USER() | Y | See SBMJOB documentation. |
| PRTTXT() | Y | See SBMJOB documentation. |
| RTGDTA() | Y | See SBMJOB documentation. |
| RQSDTA() | Y | See SBMJOB documentation. |
| SYSLIBL() | Y | See SBMJOB documentation. |
| CURLIB() | Y | See SBMJOB documentation. |
| INLLIBL() | Y | See SBMJOB documentation. |
| LOG() | Y | See SBMJOB documentation. If not specified, by default this parameter is set to LOG(4 10 *SECLVL) by the IBM i agent. |
| LOGCLPGM() | Y | See SBMJOB documentation. |
| INQMSGRPY() | Y | See SBMJOB documentation. |
| HOLD() | N | HCL Workload Automation submits all jobs on hold and then releases the jobs. |
| SCDDATE() | N | HCL Workload Automation performs the scheduling function. |
| SCDTIME() | N | HCL Workload Automation performs the scheduling function. |
| DATE() | Y | See SBMJOB documentation. |
| SWS() | Y | See SBMJOB documentation. |
| DSPSBMJOB() | Y | See SBMJOB documentation. |
| MSGQ() | N | All HCL Workload Automation jobs send completion messages to the QCOMPLETE message queue in the QTWS library. |
| SRTSEQ() | Y | See SBMJOB documentation. |
| LANGID() | Y | See SBMJOB documentation. |
| CNTRYID() | Y | See SBMJOB documentation. |
| CCSID() | Y | See SBMJOB documentation. |
| SBMFOR() | Y | See SBMJOB documentation. |
| JOBMSGQMX() | Y | See SBMJOB documentation. |
| JOBMSGQFL() | Y | See SBMJOB documentation. |
| CPYENVVAR() | Y | See SBMJOB documentation. |
| ACGCDE() | Y | See SBMJOB documentation. |
| ALWMLTTHD() | Y | See SBMJOB documentation. |
| INLASPGRP() | Y | See SBMJOB documentation. |
| LOGOUTPUT() | Y | See SBMJOB documentation. |
| SPLFACN() | Y | See SBMJOB documentation. |
For example, to submit a job using the conman submit docommand to a workstation named as400-2:
sbd as400-2#"submit: job(testjob) cmd(dsplib lib(qtws)) user(usera) jobd(qgpl/testjobd)";alias=job1;logon=userbThe result of this example is that on the as400-2 IBM i machine the USERB user profile is used to issue the command:
SBMJOB CMD(DSPLIB LIB(QTWS)) JOB(TESTJOB) USER(USERA) JOBD(QGPL/TESTJOBD)Ensure that USERB has the authorization necessary to issue this command on the IBM i.