Retrieving AutoSys Job and Schedule Information for Audit Purposes

Products

• Autosys Workload Automation

Issue/Introduction

Auditors frequently require comprehensive reports on job definitions, associated hosts, and detailed scheduling information within an AutoSys environment. However, there is no single, out-of-the-box command that generates a report precisely in a format that directly addresses all these auditing requirements. This document outlines the available AutoSys commands and utilities that can be leveraged to collect the necessary data, though some scripting and parsing may be required to produce a consolidated report. 

Environment

 Product: AutoSys Workload Automation 

Resolution

While AutoSys does not have a single command to generate a pre-formatted audit report covering all aspects of job definitions, associated hosts, and detailed schedules, the following commands and utilities can be used to gather the required information. 
The collected data can then be processed with custom scripting to meet specific auditing needs. 
1. Retrieving All Job Definitions: 
Use the autorep command to export all job definitions in your AutoSys instance. The output can be piped to a file for later parsing. 
autorep -q -J ALL 
The above command provides the complete definition for every job. You can then leverage scripting (e.g., grep, awk, sed, Python, PowerShell) to parse this data to extract details such as: * The total number of jobs. * Jobs defined for specific hosts. * The machine on which each job runs. 

2. Reviewing Job Schedules: 
Job schedules are specified within the job definitions themselves. 
After extracting job definitions using autorep -q -J ALL, you can inspect individual job attributes like days_of_week or run_calendar to understand their scheduling. 

3. Exporting Calendar Definitions: 
For detailed calendar information (cycle, standard, or extended calendars), use the autocal_asc utility. 
This utility allows you to export calendar definitions, which are crucial for understanding complex job schedules. 
Reference: For more details on autocal_asc, refer to the Broadcom TechDocs: 
Calendars

4. Forecasting Job Runs: 
The forecast command can provide a predictive listing of jobs scheduled to run within a specified timeframe. 
This can be useful for auditors to understand the expected workload and adherence to schedules. 
Reference: For more details on the forecast command, refer to the Broadcom TechDocs: 
Forecast

By combining the output of these commands and applying appropriate scripting, the necessary data for auditing AutoSys job and scheduling configurations can be compiled.