Autosys JIL
AutoSys JIL language support for Visual Studio Code, from writing job definitions to submitting individual statements.
Features
- Syntax highlighting and hover documentation with Broadcom TechDocs links.
- Completion for attributes, job types, condition functions, operators, statuses, and supported value formats.
- Job and box suggestions from the current file, including unsaved definitions, with optional external job lists.
- Live diagnostics for missing fields, duplicate attributes, invalid values or conditions, and conflicting settings.
- Tab templates for CMD, BOX, FW, FT, and FTP jobs, virtual resources, and global-variable commands.
- A searchable reference for job types, global variables, and resources.
- Machine, email, and calendar suggestions from settings or text files, with highlighting in the matching fields.
- Named Run links to submit statements to different stages using your own shell commands.
Install
Requires VS Code 1.140 or newer. Search Extensions for Autosys JIL by TheP2WKing, or run:
code --install-extension thep2wking.autosys-jil
For a local package, use Extensions: Install from VSIX or run
code --install-extension ./autosys-jil-*.vsix.
Usage
Open a .jil file and type cmd, box, fw, ft, ftp, global, or resource on a new line. Press Tab to expand
the template and move through its fields. The jil- prefixes work too; res is short for resource.
global inserts a sendevent -E SET_GLOBAL shell-command example for use in a terminal.
resource creates an insert_resource JIL definition.
Open Autosys JIL in the Activity Bar to browse jobs, global variables, and resources. Search filters all panes;
Enter keeps the filter, Escape restores the previous one, and Clear Reference Search resets it.
Settings
Add job names, machines, email addresses, and calendars in your VS Code settings:
{
"autosysJil.completions.machines": ["prod-agent", "test-agent"],
"autosysJil.completions.emails": ["ops@example.com"],
"autosysJil.completions.calendars": ["BUSINESS_DAYS"],
"autosysJil.completions.jobs": ["UPSTREAM_IMPORT"],
"autosysJil.emmet.enabled": true,
"autosysJil.sidebar.enabled": true,
"autosysJil.run.enabled": true,
"autosysJil.run.mode": "background",
"autosysJil.run.notifications": true
}
Suggestion lists default to empty and can be set per workspace folder. Changes apply immediately, and you can still
enter values outside the lists. Set any of the enabled options to false to disable that feature.
Lists can also come from UTF-8 files, one value per line:
{
"autosysJil.completions.machinesFile": "./.autosys/machines.txt",
"autosysJil.completions.emailsFile": "./.autosys/emails.txt",
"autosysJil.completions.calendarsFile": "./.autosys/calendars.txt",
"autosysJil.completions.jobsFile": "./.autosys/jobs.txt"
}
File values merge with the settings lists; blank lines and duplicates are ignored. Saved changes refresh suggestions
automatically. Machine, email, and calendar lists also update highlighting. Paths can be absolute or relative to the
workspace folder (the JIL file's directory for standalone files). Read errors appear in AutoSys JIL Completions.
Job references combine names in the current file with jobs and jobsFile. Box suggestions use current-file BOX
definitions. Completion does not scan other JIL files.
Run statements
Configure named shell callbacks to show Run Dev | Run Test | Run Prod above valid statements.
Requires a trusted workspace. For example, with Bash or Zsh:
{
"autosysJil.run.callbacks": {
"Dev": "source \"/opt/autosys/dev.sh\" && jil < \"$AUTOSYS_JIL_FILE\"",
"Test": "source \"/opt/autosys/test.sh\" && jil < \"$AUTOSYS_JIL_FILE\"",
"Prod": "source \"/opt/autosys/prod.sh\" && jil < \"$AUTOSYS_JIL_FILE\""
}
}
Labels are custom, and callbacks can be set per workspace folder.
| Variable |
Value |
AUTOSYS_JIL_FILE |
Temporary statement file, including unsaved edits. |
AUTOSYS_JIL_JOB |
Job or box name. |
AUTOSYS_JIL_STATEMENT |
Action keyword, such as insert_job. |
AUTOSYS_JIL_CALLBACK |
Selected callback name. |
Background mode captures output in AutoSys JIL Run and completion or error notifications.
Set autosysJil.run.notifications to false to hide notifications.
Set autosysJil.run.mode to "terminal" to paste an expanded command, such as
cat '/tmp/autosys-jil-abc123/statement.jil', and execute it with Enter.
Bash, Zsh, and sh callbacks use a subshell by default; set autosysJil.run.subshell to false to use the current shell.
PowerShell and Command Prompt are also supported, if you've somehow ended up on Windows.
Terminal statement files expire after 30 minutes. Set autosysJil.run.cleanupAfterMinutes for new pastes;
0 keeps files until terminal closure or extension shutdown. Click Run again for a fresh file after expiry.
Disclaimer
This is an independent project and is not affiliated with or endorsed by Broadcom. Broadcom, CA, CA Technologies,
AutoSys, and other product names are trademarks or registered trademarks of their respective owners.