AutoSys                                                         1

Unicenter AutoSys JM Commands                         cron2jil(8)

NAME
     cron2jil - Translates crontab files into JIL format

SYNOPSIS
     cron2jil -f crontab_file [-d output_directory]
              [-i include_file] [-m machine] [-p prefix]

DESCRIPTION
     Converts each line in a UNIX crontab file to a corresponding
     JIL  script  (*.jil  file) and, if necessary, a run calendar
     file (*.cal file).

     Because cron2jil cannot comprehensively address all job pro-
     cessing  requirements,  you should use it as a first step in
     converting from cron to the  environment.  The  second  step
     requires editing the newly created JIL and calendar files to
     ensure the desired job processing.

     When cron2jil reads a crontab file, it assigns job names  by
     combining  the  base  name  of the jobs command and the line
     number of the  file.  For  example,  the  following  crontab
     entries  would  result  in  the  job  names  cp_1 and mail_2
     respectively.

     >>0,59 0,23 * * 0,6 /bin/cp /etc/passwd /etc/passwd.bak

     >>0,59 * * * 0,6 /usr/ucb/mail root@support1 < /tmp/errorLog

     After conversion, cron  commands  involving  pipes  and  I/O
     redirection  perform  just  as they did in the cron environ-
     ment. If run calendars are created, cron2jil only  generates
     calendars  with  a one year duration. After conversion, pipe
     and I/O redirections may not  take  full  advantage  of  the
     fault  tolerance  mechanisms  of  Unicenter  AutoSys JM. For
     example, the exit code of a failed command in a pipe may not
     result  in  the  failure of the complete command expression.
     Because of this behavior,  you  should  edit  converted  JIL
     scripts   and  split  pipes  into  separate  jobs  with  the
     appropriate conditions and job control. With this  approach,
     problems  can  be  detected  and  reported  at  the point of
     failure.

     cron2jil does not generate  JIL  files  for  jobs  that  are
     defined  in crontab to start every minute; for example, with
     an asterisk (*) specified in the first  field  of  the  cron
     listing.  In  the  environment,  this  is a special case and
     should be remedied by defining the successful completion  of
     the job as a starting condition for the same job.

     Note: After the *.jil or *.cal files are generated, you must
     submit   them   to  the  database  using  the  jil  and  the
     autocal_asc commands, respectively.

OPTIONS
     -f crontab_file
          Specifies the name of the crontab formatted file.

     -d output_directory
          Specifies the directory to which the  *.jil  and  *.cal
          files  should  be  written.  The default is the current
          working directory.  -i include_file Specifies the  name
          of  a  file  containing  JIL  statements that are to be
          included in every generated *.jil file. This file  must
          be  created  before  the conversion, and it can contain
          any default JIL statements.  -m machine  Specifies  the
          name  of  the  machine  on which the translation should
          occur. If no  machine  is  specified,  the  default  is
          localhost.  -p prefix Specifies a prefix that should be
          inserted before each job name. For example, if a prefix
          of  AUTO  is  specified,  the jobs cited in the example
          above would have  the  following  names:  AUTOcp_1  and
          AUTOmail_2.

EXAMPLES
     cron2jil -f daily

          Translate a crontab file with the name daily.

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), DBMaint(8), dbstatistics(8),
     eventor(8),   get_auto_event(8),   jil(8),    job_delete(8),
     job_depends(8),  monbro(8),  sendevent(8), time0(8), xql(8),
     zql(8)
Autosys.ManCron2jil