How to Export AutoSys JIL Command

 

How to Export AutoSys JIL Command

AutoSys, a popular job scheduling tool, allows users to automate and manage batch processing tasks. One of the key features of AutoSys is its Job Information Language (JIL), a scripting language used to define jobs. Exporting JIL commands is essential for migrating jobs, backing up job definitions, or sharing them between different environments. This article will guide you through the process of exporting AutoSys JIL commands.

1. Understanding JIL Command Structure

Before exporting JIL commands, it's essential to understand the basic structure of a JIL script. A typical JIL script defines a job with attributes such as job name, type, command, and scheduling details. Here's an example:

jil:

insert_job: my_job_name
job_type: c
command: /path/to/command.sh
machine: my_machine_name
owner: user@domain.com
permission: gx,ge
date_conditions: 1
days_of_week: mo,tu,we,th,fr
start_times: "09:00"

2. Using the autorep Command

The autorep command is a powerful AutoSys utility that can be used to report job details, including exporting JIL commands. To export the JIL definition of a specific job, you can use the following command:

bash:

autorep -J my_job_name -q > my_job_name.jil

• -J my_job_name: Specifies the job you want to export.
• -q: Outputs the job definition in JIL format.
• > my_job_name.jil: Redirects the output to a file named my_job_name.jil.

This command will export the JIL definition of my_job_name to a file named my_job_name.jil.

3. Exporting Multiple Jobs

If you need to export multiple jobs or all jobs within a specific group or pattern, you can use wildcard characters with the autorep command:

bash:

autorep -J my_job_group_* -q > my_job_group.jil

This command exports all jobs with names starting with my_job_group_ into a single file named my_job_group.jil.

4. Exporting Jobs from a Job Stream

AutoSys allows jobs to be grouped into job streams or boxes. To export all jobs within a specific job stream, you can use the following command:

bash:

autorep -J my_job_stream -q -L0 > my_job_stream.jil

• -L0: Ensures that all jobs within the job stream are included in the export.

This will create a JIL file containing all jobs under my_job_stream.

5. Exporting Global Variables

In addition to jobs, you may also want to export global variables used in your AutoSys environment. This can be done using the autorep command:

bash:

autorep -G ALL -q > global_variables.jil

• -G ALL: Exports all global variables.
• global_variables.jil: The file where the global variables will be saved.

6. Validating the Exported JIL File

Once you've exported your JIL file, it's a good practice to validate it before using it in another environment. You can use the jil command to do this:

bash:

jil < my_job_name.jil

This command will parse the JIL file and report any syntax errors or issues. If the file is error-free, the jobs will be inserted into the AutoSys database (if running in a test or development environment).

7. Automating the Export Process

To automate the export process, you can create a shell script that runs the autorep commands at regular intervals or as part of a backup process. Here’s a simple example:

bash:

#!/bin/bash

# Export all jobs
autorep -J ALL -q > all_jobs.jil

# Export all global variables
autorep -G ALL -q > global_variables.jil

echo "Export completed at $(date)"

Save this script as export_autosys.sh and run it as needed. You can also set up a cron job to automate the process.

Conclusion

Exporting AutoSys JIL commands is a straightforward process that can be accomplished using the autorep command. Whether you’re exporting a single job, multiple jobs, or global variables, this guide provides the necessary steps to ensure your JIL definitions are safely exported for backup or migration purposes. With automation, you can further streamline this process, making it an integral part of your job management strategy.