← Back to DevOpsToolbox

AutoSys • Scheduling • Production

AutoSys Commands Cheat Sheet

Practical AutoSys commands for job monitoring, autorep, sendevent, JIL, dependencies, boxes, calendars, scheduling, agents, production support and troubleshooting.

AutoSys Command Categories

Jump directly to the AutoSys commands you need.

Showing 85 commands across 17 categories.

AutoSys Version & Basic Commands

5 commands
autorep -V

Displays the AutoSys autorep utility version information.

autorep -J <job_name>

Displays detailed information about a specific AutoSys job.

autorep -J ALL

Displays information for all jobs visible to the current AutoSys environment.

autorep -J <job_name> -q

Displays the JIL definition and configuration information for a job.

autorep -J <job_name> -r

Displays historical run information for the specified job.

Job Status & Monitoring

5 commands
autorep -J <job_name>

Checks the current status and configuration of a job.

autorep -J <job_name> -r

Shows historical execution information for a job.

autorep -J <job_name> -d

Displays detailed job information useful for troubleshooting.

autorep -J <job_name> -q

Shows the job definition including conditions and scheduling attributes.

autorep -M <machine_name>

Displays information about jobs associated with a machine.

Starting & Controlling Jobs

7 commands
sendevent -E STARTJOB -J <job_name>

Sends a STARTJOB event to request execution of an AutoSys job.

sendevent -E FORCE_STARTJOB -J <job_name>

Forces a job to start without waiting for its normal starting conditions.

sendevent -E KILLJOB -J <job_name>

Sends a kill event to stop an executing AutoSys job.

sendevent -E JOB_ON_HOLD -J <job_name>

Places a job on hold so that it does not start normally.

sendevent -E JOB_OFF_HOLD -J <job_name>

Removes a hold from a job.

sendevent -E JOB_ON_ICE -J <job_name>

Places a job on ice so its normal scheduling behavior is suspended.

sendevent -E JOB_OFF_ICE -J <job_name>

Removes the ice state from a job.

Job Success & Failure

4 commands
autorep -J <job_name> -r

Reviews recent job execution history and exit information.

sendevent -E CHANGE_STATUS -J <job_name> -s SUCCESS

Changes the reported job status to SUCCESS when authorized operational procedures require it.

sendevent -E CHANGE_STATUS -J <job_name> -s FAILURE

Changes the reported job status to FAILURE when required for operational recovery.

autorep -J <job_name> -q

Checks job conditions, dependencies and configuration after a failure.

Job Dependencies

4 commands
autorep -J <job_name> -q

Displays the job definition including dependency conditions.

autorep -J <parent_job> -q

Checks the upstream job definition when a downstream job is waiting.

autorep -J <child_job> -q

Checks dependency conditions that control when the child job can start.

autorep -J <job_name> -r

Checks previous executions when diagnosing dependency-related delays.

Box Jobs

4 commands
autorep -J <box_name> -q

Displays the configuration of an AutoSys box job.

autorep -J <box_name>

Checks the current status of a box and its scheduling state.

sendevent -E STARTJOB -J <box_name>

Starts a box job when operational procedures require a manual start.

sendevent -E JOB_ON_HOLD -J <box_name>

Places a box on hold and prevents normal execution.

Calendars & Scheduling

4 commands
autocal_asc

Runs the AutoSys calendar utility where available in the installed environment.

autorep -J <job_name> -q

Checks the run_calendar and scheduling configuration of a job.

autorep -J <job_name>

Reviews the current scheduling state of a job.

autorep -J <job_name> -r

Reviews execution history when diagnosing schedule problems.

JIL Job Definitions

6 commands
jil

Starts the AutoSys Job Information Language interface.

jil < job_definition.txt

Loads JIL statements from a file into AutoSys.

jil -V

Displays JIL utility version information in supported environments.

insert_job: <job_name>

Defines a job name in a JIL job definition.

command: <command>

Defines the command that AutoSys should execute.

machine: <machine_name>

Defines the execution machine for a command job.

Common JIL Attributes

7 commands
owner: <owner>

Defines the owner associated with a job.

permission: gx,ge,wx,we

Defines job permissions in JIL.

date_conditions: 1

Enables date and time scheduling conditions.

days_of_week: all

Defines the days on which a job is eligible to run.

start_times: HH:MM

Defines a scheduled start time for a job.

condition: s(<job_name>)

Starts a job after another job reaches SUCCESS.

condition: f(<job_name>)

Starts a job after another job reaches FAILURE.

Job Conditions

5 commands
condition: s(<job_name>)

Runs when the referenced job succeeds.

condition: f(<job_name>)

Runs when the referenced job fails.

condition: d(<job_name>)

Runs based on the dependency condition that the referenced job is done.

condition: v(<job_name>)

Uses a variable/event-based dependency condition in supported AutoSys configurations.

condition: s(<job1>) & s(<job2>)

Requires multiple upstream success conditions.

Machines & Agents

4 commands
autorep -M <machine_name>

Checks AutoSys jobs associated with a machine.

autorep -J <job_name> -q

Checks which machine a job is configured to use.

autorep -J <job_name>

Checks job state when investigating agent or machine issues.

ping <agent_host>

Checks basic network reachability to the AutoSys agent host.

Agent Troubleshooting

4 commands
ps -ef | grep -i agent

Checks whether the AutoSys agent-related process is running on Unix/Linux systems.

netstat -an | grep <port>

Checks whether the expected AutoSys agent communication port is listening.

ss -lntp | grep <port>

Checks listening TCP ports on modern Linux systems.

telnet <agent_host> <port>

Tests TCP connectivity when telnet is installed and permitted.

Events & sendevent

7 commands
sendevent -E STARTJOB -J <job_name>

Starts a job using an AutoSys event.

sendevent -E FORCE_STARTJOB -J <job_name>

Forces job execution when normal dependencies are intentionally bypassed.

sendevent -E KILLJOB -J <job_name>

Requests termination of a running job.

sendevent -E JOB_ON_HOLD -J <job_name>

Puts a job into hold state.

sendevent -E JOB_OFF_HOLD -J <job_name>

Removes a job from hold state.

sendevent -E JOB_ON_ICE -J <job_name>

Places a job on ice.

sendevent -E JOB_OFF_ICE -J <job_name>

Removes a job from ice.

Alarms & Notifications

3 commands
autorep -J <job_name> -q

Checks alarm and notification-related configuration in the job definition.

autorep -J <job_name> -r

Reviews execution history when investigating repeated alerts.

autorep -J <job_name>

Checks current status before investigating an operational alert.

Production Troubleshooting

5 commands
autorep -J <job_name>

First check to determine the current state of a problem job.

autorep -J <job_name> -q

Inspect the job definition, dependencies and scheduling configuration.

autorep -J <job_name> -r

Review recent executions and historical failures.

sendevent -E FORCE_STARTJOB -J <job_name>

Use only when the operational procedure explicitly requires bypassing normal scheduling conditions.

sendevent -E KILLJOB -J <job_name>

Terminate a stuck or runaway job when authorized.

Common AutoSys Problems

6 commands
autorep -J <job_name>

Use when a job appears stuck, inactive or unexpectedly running.

autorep -J <job_name> -q

Use when a job is waiting because of an unknown dependency or schedule.

autorep -J <job_name> -r

Use when investigating recurring job failures.

autorep -M <machine_name>

Use when multiple jobs on the same execution machine are affected.

sendevent -E JOB_OFF_HOLD -J <job_name>

Use when a job is intentionally or accidentally left on hold.

sendevent -E JOB_OFF_ICE -J <job_name>

Use when a job has been placed on ice and needs to return to normal scheduling.

Useful Production Workflow

5 commands
autorep -J <job_name>

Step 1: Check the current job status.

autorep -J <job_name> -q

Step 2: Check the job definition and dependencies.

autorep -J <job_name> -r

Step 3: Check recent execution history.

autorep -M <machine_name>

Step 4: Check whether other jobs on the same machine are affected.

sendevent -E FORCE_STARTJOB -J <job_name>

Step 5: If authorized, manually force a start when normal conditions are intentionally bypassed.

AutoSys troubleshooting workflow

  1. 1. Check the job status with autorep.
  2. 2. Inspect the JIL definition and conditions.
  3. 3. Review previous executions and exit information.
  4. 4. Check upstream dependencies, box state and calendar conditions.
  5. 5. Check the execution machine and AutoSys agent when multiple jobs are affected.
  6. 6. Use sendevent only according to your operational procedures and change controls.