(:nl:)

AutoSys                                                         1
<:vspace>
Unicenter AutoSys JM Commands                      job_depends(8)
<:vspace>
NAME
     job_depends - Reports on Unicenter  AutoSys  Job  Management
     (JM) job dependencies and conditions
<:vspace>
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]
<:vspace>
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.
<:vspace>
     When you invoke job_depends, Unicenter AutoSys  JM  verifies
     that  you  have  read  access  to the jobs for which you are
     requesting information.
<:vspace>
OPTIONS
     -B group
          Specifies the group for which to generate a report.
<:vspace>
          When -J job_name is also specified,  autorep  generates
          the  report  only  for jobs that match both -J job_name
          and -B group.
<:vspace>
          When -I application is also defined, autorep  generates
          the report only for jobs that match both -I application
          and -B group.
<:vspace>
          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).
<:vspace>
          You can use the percent (%) and underscore (_)  charac-
          ters as wildcards in this value.
<:vspace>
     -c   (Current job  condition  status)  Returns  the  current
          state  of the job and the names of any jobs that depend
          on it.
<:vspace>
     -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.)
<:vspace>
     -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.
<:vspace>
          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.
<:vspace>
          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.
<:vspace>
     -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.
<:vspace>
          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.
<:vspace>
     -I application
          Specifies the  application  for  which  to  generate  a
          report.
<:vspace>
          When -B group is also specified, autorep generates  the
          report only for jobs that match both -I application and
          -B group.
<:vspace>
          When -J job_name is also defined, autorep generates the
          report only for jobs that match both -I application and
          -J job_name.
<:vspace>
          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).
<:vspace>
          You can use the percent (%) and underscore (_)  charac-
          ters as wildcards in this value.
<:vspace>
     -J job_name
          Identifies the job on which to report. To report on all
          jobs, specify -J ALL.
<:vspace>
          You can use the percent (%) and underscore (_)  charac-
          ters as wildcards in this value.
<:vspace>
     -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.
<:vspace>
          To report on only the topmost level (that is, the box),
          set this value to -L 0.
<:vspace>
          To  report  on  all  levels  in  the  box,   omit   the
          print_level value.
<:vspace>
          This option is valid only when you specify the -d or -t
          options.
<:vspace>
          Default: -L (report on all levels in the box)
<:vspace>
     -s   Sort the jobs in an order based  on  their  next  start
          time. This option is only valid with the -t option.
<:vspace>
     -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).
<:vspace>
          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:
<:vspace>
          success(JobA)
<:vspace>
     -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.
<:vspace>
          When you enter a two-digit year, Unicenter  AutoSys  JM
          saves the setting to the database as a four-digit year.
<:vspace>
          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.
<:vspace>
     -w   Display all output columns in their widened format.
<:vspace>
EXAMPLES
     job_depends -t -J ALL -F "12/25/2005 00:00"  -T  "12/26/2005
     00:00"
<:vspace>
          List the jobs that are scheduled to  run  on  Christmas
          day, 2005.
<:vspace>
     job_depends -c -J JobX
<:vspace>
          Generate a report about the current condition status of
          the job JobX.
<:vspace>
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.
<:vspace>
COPYRIGHT
     Copyright (c) 2006 CA. All rights reserved.
<:vspace>
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)
(:Rating1: 60:) (:nl:)(:notopmenu:) (:nofootmenu:)

(:rater name="this page" :)Autosys.ManJobDepends

(:Rating1: 100:)