AutoSys: How to Check Calendar

 ## 

**AutoSys** is a job scheduling tool used for automating the execution of tasks within an enterprise environment. One important feature of AutoSys is the ability to schedule jobs based on calendars, which define specific days or intervals for executing jobs. Knowing how to check calendars in AutoSys is crucial for ensuring that jobs run on the correct schedule.

This article covers how to check and verify calendars in AutoSys, including commands to list, view, and validate AutoSys calendars.

### 1. **Listing Available Calendars**

To view the list of calendars available in AutoSys, you can use the `autocal_asc` command. This command lists all defined calendars in the AutoSys environment.

#### Command:

```bash

autocal_asc

```

This will display the names of all calendars available in the system, helping you quickly identify the one you are interested in.

### 2. **Viewing a Specific Calendar**

Once you've identified the calendar you want to check, you can view its details to understand the specific dates and rules it follows. Use the `autocal_asc` command with the `-v` option to view the calendar's details.

#### Command:

```bash

autocal_asc -v <calendar_name>

```

This command will display all the days defined in the calendar, including any special rules or exclusions applied. 

### Example:

```bash

autocal_asc -v fiscal_calendar

```

This will display the details of the `fiscal_calendar`, showing the exact dates and any exceptions set in the calendar.

### 3. **Verifying Job Calendars**

If you want to check which calendar a specific AutoSys job is using, you can use the `autorep` command. This will show you the schedule details for the job, including the calendar it relies on.

#### Command:

```bash

autorep -J <job_name>

```

This will provide a report of the job, including its calendar, if it is scheduled based on one.

### Example:

```bash

autorep -J daily_report_job

```

This output will include details about the job's schedule, such as which calendar it uses (if any), along with other scheduling information.

### 4. **Checking Calendar for Date**

Sometimes you may want to check if a specific date is included in a calendar. You can use the `autocal_asc` command with the `-s` option to check whether a given date is part of a calendar.

#### Command:

```bash

autocal_asc -s <calendar_name> <date>

```

This will return a message indicating whether the date is part of the specified calendar.

### Example:

```bash

autocal_asc -s fiscal_calendar 2024-10-05

```

This checks if October 5, 2024, is part of the `fiscal_calendar`.

### 5. **Modifying and Creating Calendars**

To modify or create new calendars, you would use the `autocal` command, which opens an interactive interface to define a new calendar or update an existing one. However, this should be done carefully, especially in a production environment, as changes to a calendar can impact the scheduling of all associated jobs.

#### Command to create or modify:

```bash

autocal

```

This will guide you through the steps to define or modify a calendar, where you can specify custom days, holidays, and other exceptions.

### 6. **Using Calendars in JIL Scripts**

When defining jobs in AutoSys using JIL (Job Information Language), you can specify the calendar that the job should follow using the `run_calendar` attribute.

#### Example JIL Script:

```bash

insert_job: example_job

job_type: c

command: /path/to/script.sh

run_calendar: fiscal_calendar

```

In this example, the job `example_job` is scheduled to run according to the dates defined in the `fiscal_calendar`.

### Conclusion

Calendars in AutoSys are an essential feature for defining flexible job schedules. Being able to list, view, and verify calendars allows you to ensure that jobs are scheduled correctly. Whether you're working in a development or production environment, it's critical to check calendars carefully, as they directly affect when and how jobs run.