Job qualifiers
Job qualifiers specify the attributes of jobs to be acted on by a command. They can be prefixed by + or ~. If a job qualifier is preceded by + then the jobs containing that specific attribute are selected for running the command. If a job qualifier is preceded by ~ then the jobs containing that specific attribute are excluded from running the command.
Job qualifier keywords can be abbreviated to as few leading characters as needed to uniquely distinguish them from each other.
- at[=time | lowtime, | ,hightime | lowtime,hightime ]
- Selects or excludes jobs based
on the time specified in the at dependency.
- time
-
Specifies the time as follows:
hhmm[+n days | date] [timezone|tz tzname]
where:- hhmm
- The hour and minute.
- +n days
- The next occurrence of hhmm in n number of days.
- date
- The next occurrence of hhmm on date, expressed as mm/dd[/yy].
- timezone|tz tzname
- The name of the time zone of the job. See Managing time zones for valid names.
time conforms to the following rules:- When hhmm is earlier than the current time, the start time is tomorrow; when hhmm is later than the current time, the start time is today.
- When hhmm is greater than 2400, it is divided by 2400. Of the division result, the whole part represents the number of + days, while the decimal part represents the time.
- lowtime
- Specifies the lower limit of a time range, expressed in the same format as time. Jobs are selected that are scheduled to start after this time.
- hightime
- Specifies the upper limit of a time range, expressed in the same format as time. Jobs are selected that are scheduled to start before this time.
If at is used alone and it is preceded by + then the jobs selected are those containing an at dependency.
If at is used alone and it is preceded by ~ then the jobs selected are those not containing an at dependency.
- confirmed
- Selects or excludes jobs that were scheduled using the confirm keyword.
- critical
- Selects or excludes jobs that were flagged with the critical keyword in a job stream definition.
- critnet
- Selects or excludes jobs
that are flagged as critical or are predecessors of critical
jobs. Hence, it applies to all the jobs that have a critical start
time set.
The critical start time of a critical job is calculated by subtracting its estimated duration from its deadline. The critical start time of a predecessor is calculated by subtracting its estimated duration from the critical start time of its successor. Within a critical network, critical start times are calculated starting from the critical job and working backwards along the line of its predecessors.
- deadline[=time | lowtime, | ,hightime | lowtime,hightime]
- Specifies the time within
which a job must complete.
hhmm[+n days | date] [timezone|tz tzname]
- hhmm
- The hour and minute.
- +n days
- An offset in days from the scheduled deadline time.
- date
- The next occurrence of hhmm on date, expressed as mm/dd[⁄yy].
- timezone|tz tzname
- Specifies the time zone to be used when computing the deadline. See Managing time zones for time zone names. The default is the time zone of the workstation on which the job or job stream is launched.
- lowtime
- Specifies the lower limit of a time range, expressed in the same format as time. Selected jobs have a scheduled deadline not earlier than this time.
- hightime
- Specifies the upper limit of a time range, expressed in the same format as time. Selected jobs have a scheduled deadline not later than this time.
- every[=rate | lowrate, | ,highrate | lowrate,highrate]
- Selects or excludes jobs
based on whether or not they have a repetition rate.
- rate
- Specifies the scheduled run rate, expressed as hours and minutes (hhmm).
- lowrate
- Specifies the lower limit of a rate range, expressed in the same format as rate. Jobs are selected that have repetition rates equal to or greater than this rate.
- highrate
- Specifies the upper limit of a rate range, expressed in the same format as rate. Jobs are selected that have repetition rates less than or equal to this rate.
If every is used alone and it is preceded by + then the jobs selected are those containing any repetition rate.
If every is used alone and it is preceded by ~ then the jobs selected are those not containing any repetition rate.
- finished[=time | lowtime, | ,hightime | lowtime,hightime]
- Selects or excludes jobs
based on whether or not they have finished.
- time
- Specifies the exact time the job finished, expressed as follows:
hhmm [date] [timezone|tz tzname]
- hhmm
- The hour and minute.
- date
- The next occurrence of hhmm on date, expressed as mm/dd[/yy].
- timezone|tz tzname
- The name of the time zone of the job. See Managing time zones for valid names.
- lowtime
- Specifies the lower limit of a time range, expressed in the same format as time. Jobs are selected that finished at or after this time.
- hightime
- Specifies the upper limit of a time range, expressed in the same format as time. Jobs are selected that finished at or before this time.
If finished is used alone and it is preceded by + then the jobs selected are the jobs that have finished running.
If finished is used alone and it is preceded by ~ then the jobs selected are the jobs that have not finished running.
- follows=[netagent::][workstation#]{jobstreamname(hhmm [mm⁄dd[⁄yy]])[.job | @] | jobstream_id.job;schedid}| job[;nocheck][,...]
- Selects or excludes jobs
based on whether or not they have a follows dependency.
- netagent
- Specifies the name of the HCL Workload Automation network agent that interfaces with the remote HCL Workload Automation network containing the prerequisite job. Wildcard characters are permitted. For more information refer to Managing internetwork dependencies.
- workstation
- Specifies the name of the workstation on which the prerequisite job runs. Wildcard characters are permitted.
- jobstreamname
- Specifies the name of the job stream in which the prerequisite job runs. Wildcard characters are permitted. If you enter jobstreamname.@, you specify that the target job follows all jobs in the job stream.
- jobname
- Specifies the name of the prerequisite job. When entered without a jobstreamname, it means that the prerequisite job is in the same job stream as the target job. Do not specify the job name using wildcard characters for a follows dependency.
- jobstream_id
- Specifies the unique job stream identifier. See Arguments for more information on job stream identifiers.
- schedid
- This keyword, if present, applies to all the job streams identifiers specified in the clause and indicates that for all the job streams specified you are using the jobstream_ids and not the jobstreamnames. If you want to select some job streams using the jobstream_id and some job streams using the jobstreamname, you must use two different follows clauses, one containing the job streams identified by the jobstreamname without the schedid keywords, and the other containing the job streams identified by the jobstream_id with the schedid keyword.
- nocheck
- Is valid only for the submission commands and used in conjunction with theschedid keyword. The nocheck keyword indicates that conman does not have to check for the existence of the prerequisite job jobstream_id.job in the Symphony file. It is assumed that jobstream_id.job exists, in case it does not exist batchman prints a warning message in the stdlist.
If follows is used alone and it is preceded by + then the jobs are selected if they contain follows dependencies.
If follows is used alone and it is preceded by ~ then the jobs are selected if they contain no follows dependency.
- logon=username
- Select jobs based on the user names under which they run. If username contains special characters it must be enclosed in quotes ("). Wildcard characters are permitted.
- needs[=[workstation#]resourcename]
- Selects or excludes jobs
based on whether or not they have a resource dependency.
- workstation
- Specifies the name of the workstation on which the resource is defined. Wildcard characters are permitted.
- resourcename
- Specifies the name of the resource. Wildcard characters are permitted.
If needs is used alone and it is preceded by + then the jobs are selected if they contain resource dependencies.
If needs is used alone and it is preceded by ~ then the jobs are selected if they contain no resource dependency.
- opens[=[workstation#]filename[(qualifier)]]
- Select jobs based on whether
or not they have a file dependency. A file dependency
occurs when a job or job stream is dependent on the existence of one
or more files before it can begin running.
- workstation
- Specifies the name of the workstation on which the file exists. Wildcard characters are permitted.
- filename
- Specifies the name of the file. The name must be enclosed in quotes (") if it contains special characters other than the following: alphanumerics, dashes (-), slashes (/), backslashes (\), and underscores (_). Wildcard characters are permitted.
- qualifier
- A valid test condition. If omitted, jobs are selected or excluded without regard to a qualifier.
If opens is used alone and it is preceded by + then the jobs are selected if they contain file dependencies.
If opens is used alone and it is preceded by ~ then the jobs are selected if they contain no file dependency.
- priority=pri | lowpri, | ,highpri | lowpri,highpri
- Selects or excludes jobs
based on their priorities.
- pri
- Specifies the priority value. You can enter 0 through 99, hi or go.
- lowpri
- Specifies the lower limit of a priority range. Jobs are selected with priorities equal to or greater than this value.
- highpri
- Specifies the upper limit of a priority range. Jobs are selected with priorities less than or equal to this value.
- prompt[=promptname | msgnum]
- Selects or excludes jobs
based on whether or not they have a prompt dependency.
- promptname
- Specifies the name of a global prompt. Wildcard characters are permitted.
- msgnum
- Specifies the message number of a local prompt.
If prompt is used alone and it is preceded by + then the jobs are selected if they contain prompt dependencies.
If prompt is used alone and it is preceded by ~ then the jobs are selected if they contain no prompt dependency.
- recovery=recv-option
- Selects or excludes jobs
based on their recovery options.
- recv-option
- Specifies the job recovery option as stop, continue, or rerun.
- scriptname=filename
- Selects or excludes
jobs based on their executable file names.
- filename
- Specifies the name of an executable file. The name must be enclosed in quotes (") if it contains special characters other than the following: alphanumerics, dashes (-), slashes (/), backslashes (\), and underscores (_). Wildcard characters are permitted.
- started[=time | lowtime, | ,hightime | lowtime,hightime]
- Selects or excludes jobs
based on whether or not they have started.
- time
- Specifies the exact time the job started, expressed as follows:
hhmm [date] [timezone|tz tzname]
- hhmm
- The hour and minute.
- date
- The next occurrence of hhmm on date, expressed as mm/dd[/yy].
- timezone|tz tzname
- The name of the time zone of the job. See Managing time zones for valid names.
- lowtime
- Specifies the lower limit of a time range, expressed in the same format as time. Only jobs that started at or after this time are selected.
- hightime
- Specifies the upper limit of a time range, expressed in the same format as time. Only jobs that started at or before this time are selected.
If started is used alone and it is preceded by +, then only the jobs that have started running at this time are selected.
If started is used alone and it is preceded by ~, then only the jobs that have started running at or after this time and that are still running are selected.
- state=state[,...]
- Selects or excludes jobs
based on their states.
- state
- Specifies the current state of the job. Valid job states are as
follows:
- ABEND
- The job ended with a nonzero exit code.
- ABENP
- An abend confirmation was received, but the job has not completed.
- ADD
- The job is being submitted.
- CANCL
- For internetwork dependencies only. The remote job or job stream has been cancelled.
- DONE
- The job completed in an unknown state.
- ERROR
- For internetwork dependencies only, an error occurred while checking for the remote status.
- EXEC
- The job is running. The + flag written beside the EXEC status means that the job is managed by the local batchman process.
- EXTRN
- For internetwork dependencies only, the status is unknown. An error occurred, a rerun action was just performed on the job in the EXTERNAL job stream, or the remote job or job stream does not exist.
- FAIL
- Unable to launch the job.
- FENCE
- The job's priority value is below the fence.
- HOLD
- The job is awaiting dependency resolution.
- INTRO
- The job is introduced for launching by the system. The + flag written beside the INTRO status means that the job is managed by the local batchman process.
- PEND
- The job completed, and is awaiting confirmation.
- READY
- The job is ready to launch, and all dependencies are resolved.
- SCHED
- The job's at time has not arrived.
- SUCC
- The job completed with an exit code of zero.
- SUCCP
- A succ confirmation was received, but the job has not completed.
- WAIT
- The job is in the WAIT state (extended agent only).
- until[=time | lowtime, | ,hightime | lowtime,hightime ]
- Selects or excludes jobs
based on their scheduled end time.
- time
- Specifies the scheduled end time expressed as follows:
hhmm[+n days | date] [timezone|tz tzname]
- hhmm
- The hour and minute.
- +n days
- The next occurrence of hhmm in n number of days.
- date
- The next occurrence of hhmm on date, expressed as mm/dd[/yy].
- timezone|tz tzname
- The name of the time zone of the job. See Managing time zones for valid names.
- lowtime
- Specifies the lower limit of a time range, expressed in the same format as time. Jobs are selected that have scheduled end times on or after this time.
- hightime
- Specifies the upper limit of a time range, expressed in the same
format as time. Jobs are selected that have scheduled end times
on or before this time.
To select a list of expected objects, hightime requires the date option with the operating system time. It does not work if the current operating system time is set later than the until hightime value. To display job streams in the ready or hold state with until set to 12:00, you must add the date value to until=,1200.
If until is used alone and it is preceded by + then the jobs are selected if they have an until time specified.
If until is used alone and it is preceded by ~ then the jobs are selected if they have no until time specified.