AutoSys 1
Unicenter AutoSys JM Commands job_depends(8)
NAME
job_depends - Reports on Unicenter AutoSys Job Management
(JM) job dependencies and conditions
SYNOPSIS
job_depends [-B group] [-c|-d|-t] [-D data_server]
[-F from_date/time] [-I application]
[-J job_name] [-L print_level] [-s]
[-T to_date/time] [-w]
DESCRIPTION
Provides detailed reports about the dependencies and condi-
tions of a job. You can use this command to determine the
current state of a job, its job dependencies, and (for a box
job) the nested hierarchies specified in the job definition,
and to generate a report of what jobs will run during a
given interval.
When you invoke job_depends, Unicenter AutoSys JM verifies
that you have read access to the jobs for which you are
requesting information.
OPTIONS
-B group
Specifies the group for which to generate a report.
When -J job_name is also specified, autorep generates
the report only for jobs that match both -J job_name
and -B group.
When -I application is also defined, autorep generates
the report only for jobs that match both -I application
and -B group.
When both -J job_name and -I application are also
specified, autorep generates the report only for jobs
that match all three criteria (-J job_name, -I applica-
tion, and -B group).
You can use the percent (%) and underscore (_) charac-
ters as wildcards in this value.
-c (Current job condition status) Returns the current
state of the job and the names of any jobs that depend
on it.
-d (Job dependencies only) Returns the starting conditions
for the job but includes no indication of its current
status. This option displays jobs in a box hierarchi-
cally. (Use the -L option to set how many levels of
nesting to display.)
-D data_source
For Ingres r3 Open Source and Sybase databases,
data_source is in the format data_server:database. It
identifies the data server and database to search for
the specified information.
For the Oracle database, data_source is in the format
TNSname. It indicates the TNS alias name of the Oracle
dataserver to be searched for the specified informa-
tion.
Normally, autorep consults the Unicenter AutoSys JM
configuration file ($AUTOUSER/config.$AUTOSERV) to
determine to which database to connect. This option
enables autorep to report on any Unicenter AutoSys JM
event server on the network.
-F from_date/time
Specifies the report start date and time (that is, the
date and time of the first job in the report) in
MM/DD/[YY]YY hh:mm format.
When you enter a two-digit year, Unicenter AutoSys JM
saves the setting to the database as a four-digit year.
If you enter 79 or less, the product precedes your
entry with 20; if you enter 80 or greater, the product
precedes your entry with 19.
-I application
Specifies the application for which to generate a
report.
When -B group is also specified, autorep generates the
report only for jobs that match both -I application and
-B group.
When -J job_name is also defined, autorep generates the
report only for jobs that match both -I application and
-J job_name.
When both -J job_name and -B group are also defined,
autorep generates the report only for jobs that match
all three criteria (-J job_name, -I application, and -B
group).
You can use the percent (%) and underscore (_) charac-
ters as wildcards in this value.
-J job_name
Identifies the job on which to report. To report on all
jobs, specify -J ALL.
You can use the percent (%) and underscore (_) charac-
ters as wildcards in this value.
-L print_level
Specifies the number of levels into the box job hierar-
chy about which to report. For example, when you
specify -L 2, the report contains data for the speci-
fied job (a box) and the top two levels of jobs in the
box. This value can be any number.
To report on only the topmost level (that is, the box),
set this value to -L 0.
To report on all levels in the box, omit the
print_level value.
This option is valid only when you specify the -d or -t
options.
Default: -L (report on all levels in the box)
-s Sort the jobs in an order based on their next start
time. This option is only valid with the -t option.
-t (Time dependencies) Returns the starting conditions for
a job; however, the top level of jobs (or boxes)
reported are limited to those that will start during
the interval specified by the job or box date condi-
tions. When a box satisfies those date conditions, all
of the jobs in the box are also returned (use the -L
option to set how many levels of nesting to display).
When you specify this option, job_depends does not cal-
culate all complex job dependencies when reporting on
the jobs and boxes that are scheduled to run. For exam-
ple, JobB may have a date condition and depend on JobA.
The date conditions for JobB may be met for a given
day, while those for JobA are not. As a result, JobA
does not run, nor does JobB. However, JobB appears on
the job_depends report. Therefore, the starting condi-
tions are also printed. For example, the following con-
dition is reported for JobB:
success(JobA)
-T to_date/time
Specifies the report end date and time (that is, the
date and time of the last job in the report) in
MM/DD/[YY]YY hh:mm format.
When you enter a two-digit year, Unicenter AutoSys JM
saves the setting to the database as a four-digit year.
If you enter 79 or less, the product precedes your
entry with 20; if you enter 80 or greater, the product
precedes your entry with 19.
-w Display all output columns in their widened format.
EXAMPLES
job_depends -t -J ALL -F "12/25/2005 00:00" -T "12/26/2005
00:00"
List the jobs that are scheduled to run on Christmas
day, 2005.
job_depends -c -J JobX
Generate a report about the current condition status of
the job JobX.
TECHNICAL SUPPORT
For further technical assistance with this command, contact
Technical Support at <http://supportconnect.ca.com> for a
complete list of locations and phone numbers. Technical sup-
port is available 24 hours a day, 7 days a week.
COPYRIGHT
Copyright (c) 2006 CA. All rights reserved.
SEE ALSO
archive_events(8), as_info(8), as_safetool(8), as_server(8),
auto_svcdesk(8), autoaggr(8), autodwp(8), autocal_asc(8),
autoflags(8), autoping(8), autorep(8), autosec_test(8),
autostatad(8), autostatus(8), autosys(8), autosyslog(8),
autosys_secure(8), autotimezone(8), autotrack(8), chase(8),
chk_auto_up(8), clean_files(8), cron2jil(8), DBMaint(8),
dbstatistics(8), eventor(8), get_auto_event(8), jil(8),
job_delete(8), monbro(8), sendevent(8), time0(8), xql(8),
zql(8)
