HCL Workload Automation, Version 9.4

Add, modify, or delete jobs in the job stream you are submitting

To carry out any of these actions, you must write an array of ZOSJob statements containing the specifications for these actions. If the jobsList array is empty, or if it contains null values (except where allowed), no action is taken.

Table 1 describes the parameters you need to specify in each ZOSJob statement to specify a job you want to add, modify, or delete in the job stream you are submitting to the plan.
Table 1. Properties to set for added, modified, and deleted jobs in the ZOSJob elements.
Element Action to perform on job in job stream
Add Modify Delete
action Set to ADD. If left void or with an unauthorized value, an error message is returned. Set to MODIFY. If left void or with an unauthorized value, an error message is returned. Set to DELETE. If left void or with an unauthorized value, an error message is returned.
jobNumber Set to a value between 1 and 255. If left void, an error message is returned. Set to a value between 1 and 255 corresponding to the job number in the plan. If left void, an error message is returned. Set to a value between 1 and 255 corresponding to the job number in the plan. If left void, an error message is returned.
workstationName Set to the ID of the workstation as defined in the current plan. Maximum 4 characters. If left void, an error message is returned. Set to the ID of the workstation as defined in the current plan. Maximum 4 characters. If left void, the last-saved value is used. Enter a null value.
textDescription Optional. Maximum 24 characters. Maximum 24 characters. If left void, the last-saved description is used. Enter a null value.
jobName Set to the name of the job. Maximum 8 characters. If left void, an error message is returned. Maximum 8 characters. If left void, the last-saved value is used. Enter a null value.
parallelServer The number of parallel servers required to run the job. If left void, it takes 0 as the default value. Depending on the workstation in some cases may return an error message. Set to -1 to leave the last-saved value. The default is 0. Enter a null value.
duration Set in milliseconds. If left void, an error message is returned. Set to -1 to leave the last-saved value. The default is 0. Enter a null value.
autoSubmit If auto submit is required, set to true otherwise set to false. If left void, takesfalse. If auto submit is required, set to true otherwise set to false. If left void, takes the last-saved value. Enter a null value.
timeDependent If the job is time-dependent, set to true otherwise set to false. If left void, takes false. If the job is time-dependent, set to true otherwise set to false. If left void, takes the last-saved value. Enter a null value.
centralizedScript If the job has a centralized script, set to true otherwise set to false. If left void, takes true.

This option is only available on jobs scheduled to run on a fault-tolerant agent.

 Enter a null value (cannot be modified from the original value). Enter a null value.
inputArrivalTime The input arrival time in HH.MM format. The input arrival time in HH.MM format. If left void, the last-saved value is used. Enter a null value.
R1 The number of instances of job resource 1 required. If left void, it takes 0 as value. The number of instances of job resource 1 required. Set to -1 to leave the last-saved value. The default is 0. Enter a null value.
R2 The number of instances of job resource 2 required. If left void, it takes 0 as value. The number of instances of job resource 2 required. Set to -1 to leave the last-saved value. The default is 0. Enter a null value.
internalStatus Can be one of the following:
  • COMPLETE
  • DELETED
  • ERROR
  • WAITING
  • STARTED
  • UNDECIDED
  • READY
  • PENDINGPRED
  • WAITINGFORINPUT
  • INTERRUPTED
  • NOREPORTINGPRED

If left void, takes UNDECIDED as value.

 If left void, the last-saved value is used. Enter a null value.

Remember to define the dependencies (if there are any) of the new jobs you add.