Job stream qualifiers
- at[=time | lowtime, | ,hightime | lowtime,hightime ]
- Selects or excludes job streams
based on the scheduled start time.
- time
- Specifies the scheduled start 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 stream. See Managing time zones for valid names.
- lowtime
- Specifies the lower limit of a time range, expressed in the same format as time. Job streams are selected that have scheduled start times on or after this time.
- hightime
- Specifies the upper limit of a time range, expressed in the same format as time. Job streams are selected that have scheduled start times at or before this time.
If at is used alone and it is preceded by + then the job streams selected are those containing an at dependency.
If at is used alone and it is preceded by ~ then the job streams selected are those not containing an at dependency.
- carriedforward
- Selects job streams that were carried forward if preceded by +, excludes job streams that were carried forward if preceded by ~.
- carryforward
- If preceded by + selects job streams that were scheduled using the carryforward keyword; if preceded by ~ excludes job streams that were scheduled using the carryforward keyword.
- finished[=time | lowtime, | ,hightime | lowtime,hightime]
- Selects or excludes job
streams based on whether or not they have finished.
- time
- Specifies the exact time the job streams 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 stream. See Managing time zones for valid names.
- lowtime
- Specifies the lower limit of a time range, expressed in the same format as time. Job streams 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. Job streams are selected that finished at or before this time.
If finished is used alone and it is preceded by + then the jobs streams selected are the jobs that have finished running.
If finished is used alone and it is preceded by ~ then the jobs streams 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 job
streams based on whether or not they have a follows dependency.
- netagent
- Specifies the name of the network agent that interfaces with the remote HCL Workload Automation network containing the prerequisite job or job stream. Wildcard characters are permitted. For more information about network agents, refer to Managing internetwork dependencies.
- workstation
- Specifies the name of the workstation on which the prerequisite job or job stream runs. Wildcard characters are permitted.
- jobstreamname
- Specifies the name of the prerequisite job stream. Wildcard characters are permitted.
- jobname
- Specifies the name of the prerequisite job. Wildcard characters are permitted.
- 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 streams are selected if they contain follows dependencies.
If follows is used alone and it is preceded by ~ then the jobs streams are selected if they contain no follows dependency.
- limit[=limit | lowlimit, | ,highlimit | lowlimit,highlimit]
- Selects or excludes job streams
based on whether or not they have a job limit.
- limit
- Specifies the exact job limit value.
- lowlimit
- Specifies the lower limit of range. Job streams are selected that have job limits equal to or greater than this limit.
- highlimit
- Specifies the upper limit of a range. Job streams are selected that have job limits less than or equal to this limit.
If limit is used alone and it is preceded by + then the jobs streams are selected if they have any job limit.
If limit is used alone and it is preceded by ~ then the jobs streams are selected if they have no job limit.
- needs[=[workstation#]resourcename]
- Selects or excludes job streams
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 streams are selected if they contain resource dependencies.
If needs is used alone and it is preceded by ~ then the jobs streams are selected if they contain no resource dependency.
- opens[=[workstation#]filename[(qualifier)]]
- Selects or excludes job streams
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, job streams are selected or excluded without regard to a qualifier.
If opens is used alone and it is preceded by + then the jobs streams are selected if they contain file dependencies.
If opens is used alone and it is preceded by ~ then the jobs streams are selected if they contain no file dependency.
- priority=pri | lowpri, | ,highpri | lowpri,highpri
- Selects or excludes job
streams 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. Job streams are selected with priorities equal to or greater than this value.
- highpri
- Specifies the upper limit of a priority range. Job streams are selected with priorities less than or equal to this value.
- prompt[=promptname | msgnum]
- Selects or excludes job
streams 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 streams are selected if they contain prompt dependencies.
If prompt is used alone and it is preceded by ~ then the jobs streams are selected if they contain no prompt dependency.
- started[=time | lowtime, | ,hightime | lowtime,hightime]
- Selects or excludes job
streams based on whether or not they have started.
- time
- Specifies the exact time the job stream 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 stream. See Managing time zones for valid names.
- lowtime
- Specifies the lower limit of a time range, expressed in the same format as time. Job streams are selected that started at or after this time.
- hightime
- Specifies the upper limit of a time range, expressed in the same format as time. Job streams are selected that started at or before this time.
If started is used alone and it is preceded by + then the jobs streams selected are the jobs that have started running.
If started is used alone and it is preceded by ~ then the jobs streams selected are the jobs that have not started running.
- state=state[,...]
- Selects or excludes job streams
based on their states.
- state
- Specifies the current state of the job stream. Valid job stream
states are as follows:
- ABEND
- The job stream ended abnormally.
- ADD
- The job stream has just been submitted.
- EXEC
- The job stream is running.
- EXTRN
- For internetwork dependencies only. This is the state of the EXTERNAL job stream containing jobs referencing to jobs or job streams in the remote network.
- HOLD
- The job stream is awaiting dependency resolution.
- READY
- The job stream is ready to launch, and all dependencies are resolved.
- STUCK
- Execution is interrupted. No jobs are launched without operator intervention.
- SUCC
- The job stream completed successfully.
- until[=time | lowtime, | ,hightime | lowtime,hightime ]
- Selects or excludes job streams
based on the 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 stream. See Managing time zones for valid names.
- lowtime
- Specifies the lower limit of a time range, expressed in the same format as time. Job streams 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. Job streams are selected that have scheduled end times on or before this time.
If until is used alone and it is preceded by + then the jobs streams selected are those containing any scheduled end time.
If until is used alone and it is preceded by ~ then the jobs streams selected are those not containing any scheduled end time.