Ai 2
Ai 2
When the job's starting conditions are met, the scheduler submits the job to an agent.
The agent runs the job and returns the job's exit status to the application server.
The application server updates the event server.
After the job completes, it does not run again until its starting conditions are met.
To verify whether the event server service (the database service) is started, look at the Windows Control
Panel Services dialog. You can verify the following:
If you are running Microsoft SQL Server, verify the status of the MSSQLServer service.
If you are running Oracle, verify the status of the following services (substitute your Oracle SID
for the asterisk): OracleService*, OracleStart*, and OracleTNSListener.
If you are running Sybase, verify that a service with a name that starts with SYBSQL is started. It
is possible that a different name was selected for the service when Sybase was installed.
Event Server Is Down
- When I issue the chk_auto_up command, a message similar to the following is displayed:
-Couldn't connect with Server: AUTOSYS:autosys
-Either the database server is down or the process in question cannot access the database server.
1.Run the command chk_auto_up from Autosys server to see whether the servers(DB and scheduler) are
up and reachable.
2.Output from the event processor is directed to $ cd AUTOUSER/out/event_demon.$AUTOSERV.
Check the log file using tail command to see whether current time stamp is registered.
3.Check the process event_demon is running or not using the command $ ps -ef | grep event_demon
After confirming event processor is down login as Exec superuser and run the # eventor command to start
the event processor.
Sometimes eventor will throws error message while starting,check the permission for the current
superuser in the log file permission.
$ ls -l $AUTOUSER/out/event_demon.$AUTOSERV
1.Remote agent will not start due to network problems or system is down,check the log file
$AUTOUSER/out/event_demon.$AUTOSERV and it will have logs similar to [The connection to
machine:TIMED OUT. Either the machine, or the network , is having problems.]
2.Remote agent will not start due to mis configuration.$AUTOUSER/out/event_demon.$AUTOSERV file log will be
similar to [Could NOT connect to machine: internet demon may not be configured properly]
3.Remote agent will not start due to inetd configuration.$AUTOUSER/out/event_demon.$AUTOSERV log file will
show error as [Remote Agent Process not started].check the inetd.conf file for errors.
When remote agent starts running, log file will be saved in AutoRemoteDir/auto_rem.pid.
When remote agent receives job definition from event processor log file will be renamed to
AutoRemoteDir/auto_rem.joid.run_num.ntry
Fire $ autosyslog -J <job_name> command in client where the job has ran to find the recent log.
Remote agent starts,Command runs but No running event like RUNNING,FAILURE,SUCCESS is sent to DB.
When job is started from event processor # Unknown Host Machine # will be updated in log file
# autosyslog -e
Below are the client performance issues, which affects job run.
a) There are too much of processess running on the client where the job starts.
b) Network problems may be the issue.
c) NFS mounted directories in client with low bandwidth.
Job runs from command line but fails when running through Autosys.
To check the difference between the job definition and the user environment
a) Login to the client where the job runs and enter the command $ env > owner1.env
b) Create a job to record the remote agent environment variable to a file.
insert_job: remote_env
machine: client_hostname
owner: owner
command: env
std_out_file: /tmp/remote1.env
std_err_file: /tmp/remote1.err
Now check the differences between the two profiles and troubleshoot the same.
Autosys Crontab
Autosys (Now called CA Workload Automation) Crontab is a inbuilt feature in UNIX systems
is a centralized job management tool. used to schedule and run scripts/commands.
Help to run thousands of jobs at time in different Jobs can be triggered only in UNIX systems.
systems (windows, Linux, Mainframe etc)
Autosys is widely used in banking systems to Crontab is used to schedule few jobs in a client
run n+ lakh jobs in enterprise application machine.
environment.
Used to schedule third party application jobs Not integrated with third party application to
includes SAP, Oracle, Peoplesoft etc with the trigger jobs.
help of Autosys adapters installed.
Jobs historical information (status) can be Not possible to extract historical information for
extracted from database. a large number of jobs.
Autosys can trigger different types of jobs Can trigger only commands and scripts.
includes command jobs, script, Box jobs, File
watcher jobs, FTP jobs etc.
Each jobs exit codes and error codes with Not possible to manage thousands of jobs exit
detailed information can be stored for and error codes.
investigation.
Credentials used to trigger jobs are stored in Not secured as credentials can be changed by
database in a secured encrypted manner. root users.
EEM - Embedded Entitlements Manager Not integrated with LDAP users to schedule and
application in CA workload automation provides manage jobs with greater security as EEM.
access to global users from LDAP server to
schedule and run jobs.
WCC – Workload Control Center application No Web interface available to manage crontab.
integrated with core Autosys system to perform
administrative tasks though web interface.
Press Enter
Press Enter
17.To print job/BOX full details.[This will take more time to pull details]
# autorep -J <job name> -w
The difference between ON HOLD and ON ICE in Autosys is that,when a ON_HOLD job is taken
OFF_HOLD,the job will be scheduled to run if its starting conditions are already satisfied.
But when a ON_ICE job is taken OFF_ICE ,the job will not run even though its starting
conditions are met.The job is scheduled to run only when the starting conditions reoccur for this job.
When a job is ON_HOLD,its dependent jobs and downstream from this job will not run.
But when a job is ON_ICE ,the downstream from this job runs as though the job succeeded.
JIL is a specification language, with its own syntax, that is used to describe when, where, and how a job
should run. When you enter the jil command, you get the jil command prompt, at which you can enter the
job definitions one line at a time using this special language. When you exit the jil command-line
interface, the job definition is loaded into the database. Alternatively, you can enter the definition as a text
file and redirect the file to the jil command. In this case, the jil command activates the language processor,
interprets the information in the text file, and loads this information in the database.
Event Server:
Stores all events and job information (relational database).
Event Processor:
Interprets and Evaluates job definitions and notifies a Remote Agent to initiate actions.
Remote Agent:
Performs tasks; sends resulting job statuses back to the Event Server. The agent may be Unix or
Windows.
When a job is put on hold, it will not be run until it receives the JOB_OFF_HOLD event or FORCE
START. ON_HOLD is equivalent to stop the current execution process.
Example:
There are 4 jobs, say Job A, Job B, Job C and Job D. Consider all these jobs reside in a box job named
box_1. The box job is started now. After starting the box job user immediately realized that there is a
mistake in command script name in Job C. So, he put the Job C ON HOLD before it starts. Thus, he
ensures the job will run proper way.
This job is removed from all conditions and logic, but is still defined. Operationally, this condition is like
deactivating the job. It will remain on ice until it receives the JOB_OFF_ICE event.
Please remember that the job which is defined after the job ON ICE, will immediately start even though
some conditions are specified for that job with the previous one. This is the important note about ON ICE.
Yes. The first job as well as the 6 th job will be starting immediately since ICE instructs next job to run
immediately.
The difference between on hold and on ice is that when an on hold job is taken off hold, if its starting
conditions are already satisfied, it will be scheduled to run, and it will run. On the other hand, if an on ice
job is taken off ice, it will not start, even if its starting conditions are already satisfied. This job will not
run until its starting conditions reoccur.
The other major distinction is that jobs downstream from the job that is on ice will run as though the job
succeeded. Whereas, all dependent jobs do not run when a job is in on hold—nothing downstream from
this job will run.
The top-level box that this job is in is now in the RUNNING state, but the job itself has not started yet.
You can see the status of the job when you have just started the Box job of that particular job.
The job is ready and going to start. The event processor has initiated the start job procedure with the
remote agent
The job is running. The job is processing data. The job will be in running status until it process the data. If
the job is a box job, this value simply means that the jobs within the box are running. If it is a command or
file watcher job, the value means that the process is actually running on the remote machine.
If the job exited with an exit code 0, then that job is interpreted as success. However, a range of values up
to the maximum exit code for success can be reserved for each job to be interpreted as success. If the job
is a box job, this value means that all the jobs within the box have finished with the status SUCCESS (the
default), or the Exit Condition for Box Success evaluated to true.
The job exited with an exit code greater than the maximum exit code for success. By default, any number
greater than zero is interpreted as failure. If the job is a box job, a FAILURE status means either that at
least one job within the box exited with the status FAILURE (the default), or that the Exit Condition for
Box Failure evaluated to true. Unicenter AutoSys JM issues an alarm if a job fails.
A job can be terminated if a user sends a KILLJOB event or if it was defined to terminate if the box it is
in failed. If the job itself fails, it has a FAILURE status, not a TERMINATED status. A job may also be
terminated if it has exceeded the maximum runtime (term_run_time attribute, if one was specified for the
job), or if it was killed from the command line through a UNIX kill command. Unicenter AutoSys JM
issues an alarm if a job is terminated.
The job was unable to start due to hardware or application problems, and has been scheduled to restart.
The job can logically run (that is, all the starting conditions have been met), but there are not enough
machine resources available. The job will start only if it has adequate resources to process.
insert_job: jobname
job_type: c
box_name: which box holds this job
description: What the job is doing
machine: servername
permission: gx,wx
owner: account
command: batch_file or Script
std_out_file: "c:\AutoSysLog\Test.log"
std_err_file: "c:\AutoSysLog\Test.Err.log"
min_run_alarm: 0
max_run_alarm: 30
job_terminator: yes
box_terminator: yes
The term instance is used to represent a licensed version of Unicenter AutoSys JM and at least one client
machine running a unique Remote Agent. In reality, the operation is likely to have dozens of Remote
Agents communicating concurrently with the same database. Any status changes or service requests
posted to the database are called Events.
The GUI lets you interactively set the attributes that describe when, where, and how a job should run. You
create job definitions using the GUI Control Panel and the dialogs you can launch from it.
The fields in the GUIs correspond to the AutoSys JIL sub-commands and attributes. In addition, from the
GUI Control Panel, you can open applications that lets you define calendars, monitors, and reports, and let
you monitor and manage jobs.
Command - Execute a command. Generally a input file is given in which the required commands reside.
File Watcher - Special type of job in AutoSys. It will wait for a file. It will not start the job until the file
arrives. This type of job will be helpful when you integrate your project from various modules.
Box - A box is a container of other jobs. A box does nothing in execution but it holds and preserves the
jobs. In projects, start time is specified in Box jobs so that it will automatically starts once the time has
arrived.
21. Box job started but inner jobs are not running in Autosys - why ?
This problem is a familiar one and one of the important notes in Autosys.
Scenario 2: (Meeting timelines) Consider several inner box jobs are defined under a super box job. The
start time for the super box job is 10:00 and the start time for the inner jobs is 11:00. Now, if the super
box job is started, will the inner box jobs run immediately ? No, they will not. Inner jobs obey the timing
pattern strictly and they will start running once they meet the timelines.
Generally, the jobs which do similar operations or generic functions will be grouped together under a box
job.
We can set the start time and run calendars for a box job to control the execution.
23. If you want to remove the run calendar and start times from a job, how will you
execute with JIL file?
In Autosys, there is a command called date_conditions which enables the run calendar and start time.
If date_conditions=1 then the above parameters will be enabled and if date_conditions=0, the parameters
will be disabled. Thus, while executing the JIL, date_conditions=0 needs to be set for a job to remove the
run calendar and start times
24. Is Machine name needed for a Box job in Autosys?
Machine name is not needed for a Box job. Machine name is need for other types of jobs like commands
and file watchers. Machine name is primarily required to run the script. Since Box job is the holder of
other jobs and it does nothing in the execution process, Machine name is not required for a box job.
delete_box: box_name command is used to delete the box. This command will delete all the inner jobs of
the box job also. To delete the box job alone leaving its content jobs intact, you have to render delete_job:
box_name.
delete_job: job_name command is used to delete the job. In order to delete a job, you need to simply give
delete_job command. No more commands or attributes are needed for deleting.
Event server
Event processor
Remote Agent
Autosys can operate in dual server mode. Therefore, if you lose one event server due to hardware/network
problems, another server will handle your work without any loss of information or functionality.
# Send Event
alias -x se='sendevent -E'
# Start Job
alias -x fsj='sendevent -E FORCE_STARTJOB -J'
alias -x sj='sendevent -E STARTJOB -J'
# Job Report
ar='autorep -w -J '
fsj='sendevent -E FORCE_STARTJOB -J'
hold='sendevent -E JOB_ON_HOLD -J '
ice='sendevent -E JOB_ON_ICE -J '
jd='job_depends -c -w -J '
killjob='sendevent -E KILLJOB -J '
offhold='sendevent -E JOB_OFF_HOLD -J '
office='sendevent -E JOB_OFF_ICE -J '
se='sendevent -E'
sj='sendevent -E STARTJOB -J'
success='sendevent -E CHANGE_STATUS -s SUCCESS -J '
terminate='sendevent -E CHANGE_STATUS -s TERMINATED -J '
Load JIL:
jil < JIL_source
Code:
job_depends -t -J ALL -F "mm/dd/yyyy"
Code:
job_depends -t -J ALL -F:06/01/2008 -T:06/30/2008
check if the event procesor is up and running
Code:
chk_auto_up
Code:
autotimezone -l
Code:
autoflags -a
Code:
autosyslog -J jobname
Code:
autosc &
Code:
autoping -m machinename -D
The diagram in the following figure and the numbered explanations that follow it
illustrate how Unicenter Autosys JM performs its most basic function – starting a job
(that is , executing a command) on a client Machine.
[Note : In following figure, the major components are shown as separate entities.
Typically, event processor and event server are installed on the same server
machine along with a required remote agent, and other remote agents are installed
on separate client machines.]
1. The Event processor scans the event server for the next event to process. If no
event is ready, the Event processor scans again in five seconds.
2. The Event processor reads from the event server that an event is ready. If
event is a STARTJOB event, the job definition and attributes are retrieved from
Event server, including the command and pointer (full path name on the client
machine) to the profile to be used for the job. In addition for jobs running on
windows machines, the event processor retrieves from the database the userIDs
and passwords required to run the job on client machine.
3. The Event processor processes event. If the event is STARTJOB, the Event
processor attempts to establish a connection with remote agent on the client
machine, and passes job attributes to client machine. The Event processor sends a
CHANGE_STATUS event making in the event server that the job is in STARTING
status.
6. The remote agent starts a process and executes command in the job definition.
7. The remote agent issues a CHANGE_STATUS event marking in the Event server
that the job is in running state.
8. The client job process runs to completion, then returns an exit code to the
remote agent and quits.
The remote agent sends the Event server a CHANG_STATUS event corresponding to
the completion status of the job and passes back an exit code, using the
communication facilities of the database. If the return status is SUCCESS, the
remote agent deletes the log file in its temporary file directory on the client
machine. The remote agents quits.
Autosys Jobs
There are three types of jobs,
- Command Jobs : execute commands
- File watcher Jobs: watch for the arrival of a specified file.
- Box Jobs: are containers that hold other jobs (including other boxes). A box job
can be used to organize and control process flow. The box itself performs no
actions, although it can trigger other jobs to run. An important feature of this type
of job is that boxes can be put inside of other boxes.
We don’t use all the above options in all the jobs, it depends on the requirements.
Here is a sample job which will verify a particular process is running or not.
/* —————– SAP_UAT_MU03_C —————– */
insert_job: SAP_UAT_MU03_C
job_type: c
command: /local/SAP/processCheckUAT.sh
machine: MU03-UAT
owner: admin@MU03-UAT
permission: gx,wx,mx,me
days_of_week: all
start_times: “15:00, 14:00″
description: “Job used for Run testing of process”
alarm_if_fail: 1
max_exit_success: 1
https://amahana.wordpress.com/unix/unix-shellscripting/
when the agent service is not running/down for any reason and machine status is “Missing” or “unqualified” or
“offline”, the jobs that are supposed to run on that agent will be marked to PE(PEND_MACH) status.
Agent Service on windows servers will be down when c:\ drive becomes full.
Agent Service on Unix Servers will go down when /apps filesystem is filled up to 100%.
Check the status of the machine status at the instance level running the below command at CLI tools command
prompt
autorep.cmd –M <machinename>
if the machine status is “Missing” and agent service is started back on the agent, the machine status will be
automatically brought online due to detected status change by the scheduler and all the PE status jobs will kick off
on the server whichever are supposed to run.
1) If don’t want all the jobs to kick off immediately and want to action on the PEND_MACH status
jobs manually one by one forcestarting/changing status, you can set the machine OFFLINE using
the below command
Any other box is started during this time and child jobs are targeted on the same machine will still be
marked to PEND_MACH status as the machine status was set to offline.
Once the PE status jobs are actioned, you may set the machine online back using the command
This will ensure New jobs of future schedule will not be impacted and will run as per schedule.
2) If machine status is showing OFFLINE even without setting it OFFLINE and you want to run all the PE
status jobs at once, then the sequence would be
If above 2 are done at once, old PEND_MACH status jobs will kick off immediately and new jobs of future
schedule will not be impacted and will run as per schedule.
Unix:-
# /etc/init.d/waae_agent-WA_DEV status
Please contact the platform teams(Unix , Windows) to get the service started back creating an INC ticket for the
relevant platform team.
/etc/init.d/waae_agent-WA_DEV start
/etc/init.d/waae_agent-WA_UAT start
/etc/init.d/waae_agent-WA_PRD start
Once the agent service is started back, it should show ok status. Status can be verified using the command below
and status should reflect running.
# /etc/init.d/waae_agent-WA_DEV start
# /etc/init.d/waae_agent-WA_DEV status
Windows:-
If the Service is not running, please start the service if privileged. else contact windows server team to start the
service.
1. Open Autosys CLI command window. CLI tool can be located at one of the below locations
F:\apps\autosys_tools\BarCapAutoSysCLI_v3.1\bin
3. Prepare the JIL that should be deployed in a text file and save in , say (F:\autosys_JIL\
unauthorized_Jobs.txt)
Example JIL:
update_job: aut_c_copy_feed_to_server
machine: ldnpsr58383763.intranet. barcapint.com
These commands can be executed from the Unix command prompt by any authorised user. To authorise a user, please raise a
request.
How to raise request for access to an Autosys code?
1. Click http://request/FormAction.do?method=submitProduct&type=emptyForm&ID=A-1299186607.
2. Autosys code to which the Access is requested *: Give the first three letter of the job which you want/remove access
3. Add or Remove Access *: Select add to get access (or) remove to remove the access
4. Name of the Service (as per HPSC) *: Use http://autosys45web.barcapint.com/cgi-bin/autosys_code/index.cgi link to find
out the service.
Select the appcode and click show details in the right hand side of the "AutoSys codes"
5. Component ID / Message Group (as per HPSC) *: Use http://autosys45web.barcapint.com/cgi-bin/autosys_code/index.cgi
link to find out the service.
Select the appcode and click show details in the right hand side of the "Autosys codes"
6. New or existing Autosys application? *: Select existing for existing app code else new.
7. Type of ID that needs access *: Select intranet if you need access to your intranet else selects UNIX.
8. Intranet IDs to which the Citrix and CLI access is required *: Provide your id which you need access.
. Instances to which the Access is required *: Select the instance which you require access and click the => arrow button
Note:
LP4 - Only for TDB jobs.
LP2 - If there is no jobs exist in LP2 for the requested Autosys code, then you need to get approval from Andy Peck/Raymond
Mercurio
LP1 - No new app codes allowed in LP1.
10. Business Justification *: Provide the business justification.
11. Click ‘add to chart’ then click ‘proceed to check out’ and click ‘submit card’
You can download the AutoSys 4.5 CLI tools for Solaris/Linux from the following links and upload to the server in binary
format.
Use tar –xvf <file name> to untar the file.
Set the directory in the PATH variable else run the with prefix ./ Ex: ./autorep.sh
AutoSys 4.5 CLI Tools for Solaris
http://sharepoint/sites/Autosys/AutoSys%20Documents/BarCapAutoSysCLI_v3.1.sol.tar
AutoSys 4.5 CLI Tools for Linux
http://sharepoint/sites/Autosys/AutoSys%20Documents/BarCapAutoSysCLI_v3.1.lin.tar
autorep.sh
Function
The autorep.sh reports information about a job, jobs within boxes or the value of an AutoSys global variable
Syntax
autorep.sh {-J job_name | -G global_name} [-s | -d | -q] [-r run_num] [-t]
Description
The autorep.sh lists variety of information about jobs and global variables currently defined in the AutoSys
Database. You can use it to list a summary of all currently defined jobs. This serves as a problem tracking tool by
listing all relevant event information for the last run of any given job, or a specified job run. You can also use it to
extract job definitions in JIL script format. When listing nested jobs, subordinate jobs are indented to illustrate the
hierarchy.
Options
-J job_name
This indicates that a Job Report is desired. Job_name specifies the name of the job on which to report. Any valid
AutoSys job name may be specified. The “%” character may be used in the job name as a wildcard (e.g., asm% will
select all jobs starting with the string “asm”).
-G global_name
This indicates that a global variable report is desired, listing the variable name, value and the last modification date.
Any valid global variable name which is already set using the sendevent.sh command may be specified. In the
specification you can use ALL or a wildcard can be specified using the “%” character
-s
This indicates that a Summary Report is desired. This is the default option. For a Job Report, the following
information is provided: Start date/time, End date/time, Current Status, Run Number, and Priority. You can request
a report on a specific job run with the -r option. If the –r option is omitted; the most current job run is used. To see
the previous runs, use –r -1, -r -2, -r -3 etc,
-d
This indicates that a Detail Report is desired. For a Job Report, all events from the last run of the requested job will
be listed. For each event, the following data is provided: Status, Date/Time, Try Number, Event State (whether the
event has been processed by the Event Processor yet), Process Date/Time, and the Machine on which the job was
run. Also specifies if a job was run with an override and lists the override number.
-q
Indicates a Query Report is desired, providing the current job or machine definition, in JIL format, as it
exists in the AutoSys database.
-r run_num
Indicates a report is desired for a specific job run (run_num). This option can only be used with the -s and -
d options. If this option is omitted, or run_num is zero, the most current job run is reported. A minus sign (-) can be
used before the run_num value to indicate a relative counter for a past job run, relative to the current run number.
For example, the option -r -2 would generate a report for the job run two runs back.
-t
Requests that the time zone, if one is specified in the job definition appear in the report. If requested, the
time zone will appear in parentheses beneath the job name and the Time column of the report will be based on the
specified time zone.
autostatus.sh
Function
The autostatus.sh reports the current status of a specific job, or the value of an AutoSys Global variable.
Syntax
autostatus.sh {-J job_name | -G global_name}
Description
The autostatus.sh writes the current status of the specified job or the value of a global variable to standard output.
This is useful in two circumstances:
1. when an application needs to know the status of another job
2. when complex starting conditions are required that are not possible to be specified using the job definition
Options
-J job_name
This specifies the name of the job whose status needs to be determined. The current status is returned to
standard output.
-G global_name
This specifies the name of a global variable that has been set using the sendevent.sh command or the Send
Event dialog. The value of the global variable is returned to standard output.
sendevent.sh
Function
The sendevent.sh sends events to AutoSys for a variety of purposes, including starting or stopping jobs, putting a
job on hold and to set AutoSys global variables.
Syntax
sendevent.sh -E event [-J job_name] [-s status] [-C comment] [-P priority] [-G "global_name=value"]
Description
The sendevent.sh command is the only method of externally sending an event for such purposes as force starting or
killing a job. It can also be used to place the job ON_HOLD or ON_ICE, set the global variable and change the job
status.
Options
-E event
This specifies the event to be sent. This option is required. Any one of the following events may be
specified:
STARTJOB
Start the job specified in -J job_name if the starting conditions are satisfied. A STARTJOB event ignores
time and date conditions, but it does consider other start conditions, such as dependencies on other jobs. This
command cannot be used on jobs in boxes. Jobs in boxes inherit the starting conditions of the box they are in; as a
result, they will be started when that box is started.
KILLJOB
Kill the job specified in -J job_name. The action depends on one of the following job types:
Command Jobs
This kills the process that is currently running and all the processes that it has spawned; i.e., the process
group. It will not kill orphan processes. It sends a signal to the process, waits five seconds, then sends a second
signal, if the process is still there.
Box Jobs
This changes the status to TERMINATED. No more jobs within the box will be started. Jobs that are
already running will continue to run to completion.
File Watcher Jobs
Kills the file watcher job and changes the status to TERMINATED.
FORCE_STARTJOB
This will start the job specified in -J job_name, regardless of whether the starting conditions are satisfied.
Because multiple instances of the same job could be started using this command, we recommended you use the
FORCE_STARTJOB event only in extreme situations.
If a job fails inside a box and you fix the problem manually, use FORCE_STARTJOB to rerun the job.
JOB_ON_HOLD
This puts the job specified in -J job_name “On Hold”. When a job is “On Hold”, it will not be started, and
downstream dependent jobs will not run. A box cannot successfully complete if a job within it is ON_HOLD. If the
job is already STARTING or RUNNING, you cannot put it ON_HOLD.
JOB_OFF_HOLD
This will take the job specified in -J job_name “Off Hold.” If the starting conditions are met, the job will be
started.
CHANGE_STATUS
This forces a change in the status of the job specified in -J job_name. Ordinarily this should not be used,
since AutoSys manages job state changes internally. If this option is selected, the -s status option must also be
selected.
When you send a CHANGE_STATUS event, you are changing the status of the job in the database; this
event does not affect the current running of the job. That is, if you change the status to running, the status is
changed in the database but the job is not run. You will have to change the status to a termination state before the
job can be run again.
SET_GLOBAL
This sets an AutoSys global variable. This event is sent with a high priority so the Event Processor will
process the variable before it is referenced by any jobs at runtime. The -G ”global_name=value” option must be used
with this event.
-J job_name
This specifies the name of the job to which the specified event should be sent. This option is required for all
events except STOP_DEMON, COMMENT, ALARM, or SET_GLOBAL.
-s status
This specifies the status to which the job specified in -J job_name should be changed. This option is used
only when the specified event is CHANGE_STATUS, which requires this option. These are the valid statuses:
RUNNING, STARTING, SUCCESS, FAILURE, INACTIVE, and TERMINATED.
Important: Please note that a job in RUNNING state should not be put to SUCCESS state directly without first
killing it.
-C comment
This specifies a textual comment that is to be attached to this event for, documentation purposes only. The
text string can be up to 255 characters, entered as a single line. If the text string contains spaces, the entire string
must be enclosed in double quotes.
-P priority
This specifies the priority to be assigned to the event being sent. The value may be from 1 to 1000, with 1
being the highest priority and 1000 the lowest. The default value is 10. Assign a high priority if the event must be
processed immediately
-G "global_name=value"
This specifies the name and value of a global variable when a SET_GLOBAL event is sent. The global_name
and the value can each be a maximum of 30 characters (leading and trailing spaces in the value are ignored). Once a
global variable is set, it can be referenced by jobs at runtime
Examples
1. To start a job named “test_install” that has no starting conditions (and therefore must be started manually),
enter this:
To force a job to start named “wait_job”, which is waiting on the completion of another job, and explain the
reasons for your action, enter this:
job_depends.sh
Function
This command reports information about the dependencies and conditions of a job.
Syntax
job_depends.sh [-c | -t] [-J job_name]
Description
job_depends.sh provides detailed reports about the dependencies and conditions of a job. This command can be
used to determine the current state of a job, its job dependencies, and (for boxes) nested hierarchies as specified in
the job definition, and a report of what jobs will run during a given period of time.
Options
-c
This gives the current Condition Status and it prints out the current state of a job and the names of any jobs
that are dependent on this job.
-t
This gives the time Dependencies and it prints out the starting conditions for a job; however, the top level
of jobs (or boxes) that are reported are limited to those that will start within the time period specified by the job or
box’s date conditions.
-J job_name
This indicates that a Job Report is desired. Job_name specifies the name of the job on which to report. Any valid
AutoSys job name may be specified. The “%” character may be used in the job name as a wildcard (e.g., asm% will
select all jobs starting with the string “asm”).
Jil.sh
Function
This command runs the Job Information Language (JIL) processor to add, update and delete Autosys jobs. It can
also be used to insert one-time job override definitions.
Syntax
Jil.sh < jil_file
Description
The Jil.sh is the language processor for the AutoSys Job Information Language (JIL). Using this, you can define
and update jobs. The Jil.sh can be used in the following ways:
. Automatically submit job definitions to the AutoSys database – redirect a JIL script to the Jil.sh. for ex:
Jil.sh < newjil.jil
. Interactively submit job definitions to the AutoSys database – issue the Jil.sh command at the command
line and enter the JIL statements after that. To exit the interactive mode, press <Control+z>.