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#][folder/]{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.
[folder/]
Specifies the name of the folder where the prerequisite job stream runs. If no folder is specified, the root folder ("/") is used by default.
jobstreamname
Specifies the name of the prerequisite job stream. Wildcard characters are permitted.
job
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.