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)
Autosys.ManJobDepends