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.
AutoSys Version & Basic Commands
5AutoSys commands for autosys version & basic commands.
View commands →Job Status & Monitoring
5AutoSys commands for job status & monitoring.
View commands →Starting & Controlling Jobs
7AutoSys commands for starting & controlling jobs.
View commands →Job Success & Failure
4AutoSys commands for job success & failure.
View commands →Job Dependencies
4AutoSys commands for job dependencies.
View commands →Box Jobs
4AutoSys commands for box jobs.
View commands →Calendars & Scheduling
4AutoSys commands for calendars & scheduling.
View commands →JIL Job Definitions
6AutoSys commands for jil job definitions.
View commands →Common JIL Attributes
7AutoSys commands for common jil attributes.
View commands →Job Conditions
5AutoSys commands for job conditions.
View commands →Machines & Agents
4AutoSys commands for machines & agents.
View commands →Agent Troubleshooting
4AutoSys commands for agent troubleshooting.
View commands →Events & sendevent
7AutoSys commands for events & sendevent.
View commands →Alarms & Notifications
3AutoSys commands for alarms & notifications.
View commands →Production Troubleshooting
5AutoSys commands for production troubleshooting.
View commands →Common AutoSys Problems
6AutoSys commands for common autosys problems.
View commands →Useful Production Workflow
5AutoSys commands for useful production workflow.
View commands →Showing 85 commands across 17 categories.
AutoSys Version & Basic Commands
5 commandsautorep -VDisplays the AutoSys autorep utility version information.
autorep -J <job_name>Displays detailed information about a specific AutoSys job.
autorep -J ALLDisplays information for all jobs visible to the current AutoSys environment.
autorep -J <job_name> -qDisplays the JIL definition and configuration information for a job.
autorep -J <job_name> -rDisplays historical run information for the specified job.
Job Status & Monitoring
5 commandsautorep -J <job_name>Checks the current status and configuration of a job.
autorep -J <job_name> -rShows historical execution information for a job.
autorep -J <job_name> -dDisplays detailed job information useful for troubleshooting.
autorep -J <job_name> -qShows the job definition including conditions and scheduling attributes.
autorep -M <machine_name>Displays information about jobs associated with a machine.
Starting & Controlling Jobs
7 commandssendevent -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 commandsautorep -J <job_name> -rReviews recent job execution history and exit information.
sendevent -E CHANGE_STATUS -J <job_name> -s SUCCESSChanges the reported job status to SUCCESS when authorized operational procedures require it.
sendevent -E CHANGE_STATUS -J <job_name> -s FAILUREChanges the reported job status to FAILURE when required for operational recovery.
autorep -J <job_name> -qChecks job conditions, dependencies and configuration after a failure.
Job Dependencies
4 commandsautorep -J <job_name> -qDisplays the job definition including dependency conditions.
autorep -J <parent_job> -qChecks the upstream job definition when a downstream job is waiting.
autorep -J <child_job> -qChecks dependency conditions that control when the child job can start.
autorep -J <job_name> -rChecks previous executions when diagnosing dependency-related delays.
Box Jobs
4 commandsautorep -J <box_name> -qDisplays 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 commandsautocal_ascRuns the AutoSys calendar utility where available in the installed environment.
autorep -J <job_name> -qChecks 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> -rReviews execution history when diagnosing schedule problems.
JIL Job Definitions
6 commandsjilStarts the AutoSys Job Information Language interface.
jil < job_definition.txtLoads JIL statements from a file into AutoSys.
jil -VDisplays 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 commandsowner: <owner>Defines the owner associated with a job.
permission: gx,ge,wx,weDefines job permissions in JIL.
date_conditions: 1Enables date and time scheduling conditions.
days_of_week: allDefines the days on which a job is eligible to run.
start_times: HH:MMDefines 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 commandscondition: 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 commandsautorep -M <machine_name>Checks AutoSys jobs associated with a machine.
autorep -J <job_name> -qChecks 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 commandsps -ef | grep -i agentChecks 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 commandssendevent -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 commandsautorep -J <job_name> -qChecks alarm and notification-related configuration in the job definition.
autorep -J <job_name> -rReviews execution history when investigating repeated alerts.
autorep -J <job_name>Checks current status before investigating an operational alert.
Production Troubleshooting
5 commandsautorep -J <job_name>First check to determine the current state of a problem job.
autorep -J <job_name> -qInspect the job definition, dependencies and scheduling configuration.
autorep -J <job_name> -rReview 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 commandsautorep -J <job_name>Use when a job appears stuck, inactive or unexpectedly running.
autorep -J <job_name> -qUse when a job is waiting because of an unknown dependency or schedule.
autorep -J <job_name> -rUse 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 commandsautorep -J <job_name>Step 1: Check the current job status.
autorep -J <job_name> -qStep 2: Check the job definition and dependencies.
autorep -J <job_name> -rStep 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. Check the job status with
autorep. - 2. Inspect the JIL definition and conditions.
- 3. Review previous executions and exit information.
- 4. Check upstream dependencies, box state and calendar conditions.
- 5. Check the execution machine and AutoSys agent when multiple jobs are affected.
- 6. Use
sendeventonly according to your operational procedures and change controls.