Command Descriptions
This chapter contains command descriptions for the Command Line program.
addrule
Warning Always enclose arguments containing spaces in quotes, or the command will not execute successfully. For example, if the Program Files folder is included in a path statement as an argument, the entire path must be enclosed by quotes.
The
addrule
command defines a new job rule (job definition). It must be followed by the
modrule
command to further define other job parameters.
After
addrule
has been issued, use the
submit
command to add the job to the production schedule.
Syntax
SACmd addrule -J|-G -n job_name|-a job_alias [-p parent_alias]
[-C command] [-E calendar_name] [-o offset] [-h agent_name|-L agent_list] [-k intrvl counts] [-I interval] [-P “parameters”] [-Q y|n]
Note The -C command only works with jobs; it will not work with job groups.
addrule -options
Table 1 addrule options
|
|
-J
|
Makes the rule a job definition. (Requires the
-C
command to work.) Either this option or the
-G
option is required.
|
-G
|
Makes the rule a job group definition. Either this option or the -J option is required.
|
-n job_name
|
The name of the job, up to 50 characters. If the job name is specified only, the job alias is set to the job id. Either this option or the
-n job_alias
option is required.
|
-a job_alias
|
Defines the job alias string, up to 8 characters. This string provides a unique ID representing the job. If the job alias is not unique, does not accept the rule. If only the job alias is specified, the job name is set to the job alias name. Either this option or the
-n job_name
option is required.
|
-o offset
|
The calendar offset in days. You can choose to subtract or add an offset to the specified calendar date. For example, if your calendar specifies 1/19/00 as a date to run your job, and you choose an offset of
1
, then the job runs on 1/20/00.
|
-p parent_alias
|
The alias name of the job’s job group. Specifying this field adds the job to the job group defined by this alias.
|
-h agent_name
|
The name of the agent on which the command is run. If specifying an agent list, use with the
-L
option. If this option is not specified, the configured default agent is assumed. This option is required when using the
-L
option.
NOTE: Be careful to use the specific name of your agent, not the name of the agent machine.
|
-k intrvl_counts
|
Interval count for repeating jobs. Use to set the number of times to repeat the job at the interval specified by the
-I
(uppercase i) option.
|
-I interval
|
(Uppercase i) Interval for repeating jobs. Use to set the interval in minutes at which to run repeating jobs (ranging from
0-1440
). This option should be used with the
-k
and
-Q
options. For example, to rerun the same job occurrence every five minutes, 10 times,
-I 5 -k 10 -Q Y
to rerun a new job occurrence every five minutes, 10 times,
-I 5 -k 10 -Q N
|
-C command
|
The path and filename of the command run by the job. If specifying a job group, this option is ignored. You must include the path to the command. For example,
-C “c:\program files\reports.bat”
Unix Master:
In Unix, if you are specifying a directory path to a Windows machine, you must use two backslashes instead of the normal single backslash of a Windows directory path. Unix won’t recognize the single backslash. For example, in Unix, to specify the reports.bat command file on a Windows machine,
-C “\\Computer1\\program files\\reports.bat”
For example,in Windows, to specify the reports.bat command file from the programs shared directory located on computer1,
-C “\\Computer1\program files\reports.bat”
|
-E calendar_name
|
The name of the calendar to associate with the job or job group.
|
-L
|
If present with the
-h
option, selects the agent list name instead of the agent name. If omitted, defaults to the agent name.
|
-P “parameters”
|
Command parameters. Use this option to specify the parameters to pass to the command file. When you specify parameters, separate them with spaces. Remember if an argument includes spaces, to enclose the entire argument in quotes. For example, to specify
OFF
as your first parameter, and
98
as your second parameter:
-P “OFF 98”
|
-Q Y|N
|
Specify whether to allow the job to repeat (
Y
) or not (
N
). Any parameter other than
Y
or
N
is interpreted as
N
.
|
Examples
-
This example creates a new job with the alias name
clock
using minimum initial parameters:
SACmd addrule -J -a clock -C c:\winnt\clock.exe -h "Win Agent"
The minimum set of parameters are the name or alias, command (jobs only), agent or agent-list name and the
-J
or
-G
option.
-
The following example adds the calendar definition, job name and parent name to the above command.
SACmd addrule -J -a clock -C c:\winnt\clock.exe -h "Win Agent" -E Daily -n clock_2 -p TIME
Note that
Win Agent
was placed in quotes. This is because of the space character in the string.
-
Define a similar job as above but now define an agent list instead of an agent:
SACmd addrule -J -a clock -C c:\winnt\clock.exe -h ListAgent2 -L
-
Create a new group with the name alfa using the minimum number of arguments:
-
Add other options to the last example, such as name, offset, calendar and parent alias:
SACmd addrule -n alfa -G -E Daily -a alfa23 -p BETA -o 5
-
This example shows the steps you need to take to create, modify and submit a new job to the master:
SACmd addrule -J -a sleep -n sleep -C c:\master\sleep.exe -h “Win Agent”
SACmd modrule -a sleep -E Holidays -P 8 -u jamesb -y 55
agent
The
agent
command adds, modifies, deletes and enables or disables a connection to an agent provided you have the correct security privileges to add or edit a connection.
Syntax
SACmd agent -C [ADD|MODIFY|DELETE|LIST] -n name
ADD [-n name -t [Windows|Unix|zOS|OVMS] -a hostname -p portnumber -e Y|N
MODIFY [-n name -e Y|N]
MODIFY [-n name -a hostname -p port]
DELETE [-n name]
LIST [no parameters needed] see also host or hosts
agent -options
Table 2 agent Options
|
|
-name
|
Specifies the name of the connection.
|
-e Y|N
|
Specifies whether the connection is enabled (
Y
) or disabled (
N
).
|
-t Windows|Unix|
zOS|Open VMS
|
Type of connection to add an agent for Windows, Unix, z/OS or Open VMS.
|
-p port number
|
Possible port numbers range from
1-65535
. Default is
5912
.
|
-a hostname
|
The machine name or IP address of the machine. Defaults to name parameter.
|
Examples
-
The following example creates and enables a new Windows agent called
Win04
on the Saturn host machine using port number
5914
:
SACmd agent -C ADD -n Win04 -t Windows -a Saturn -p 5914 -e Y
-
The following example changes the port number of the
Win04
agent on the Saturn host machine to
5915
.
SACmd agent -C MODIFY -n Win04 -a Saturn -p 5915
-
This example disables the
Win04
agent.
SACmd agent -C MODIFY -n Win04 -e N
alerts
The
alerts
command displays all the operator alerts presently in the production schedule in table format. The columns included are:
-
ID – The alert ID (needed for the alertset command).
-
Job Number – The job number ID of the job that issued the alert.
-
Type – The kind of alert issued.
-
Level – The severity level of the alert, either Critical, Warning, Error or Information.
-
Status – The status of the alert, either Open(1), Acknowledged(2) or Closed(3).
-
Description – The alert message as defined in the Operator Alert Action used to issue the alert.
-
Response – Operator notes taken in response to the alert.
-
Time – The time the Operator Alert was closed.
-
User – The runtime user of the job that closed the alert.
Syntax
SACmd alert[s] [-f from_date] [-t to_date] [-b] [-s]
alert[s] -options
Table 3 Job Status
|
|
-f from_date
|
Specifies the date to start displaying alerts. If omitted, the default is today.
The format for the date is YYYYMMDD. Do not use any punctuation when entering the date.
|
-t to_date
|
Specifies the date to stop displaying alerts. Alerts that fall on the day specified are included. If omitted, the default is today.
The format for the date is YYYYMMDD. Do not use any punctuation when entering the date.
|
-b
|
Suppress the header which otherwise identifies the contents of each column.
|
-s
|
Display only job number, job name, alert message, response and user.
|
Examples
-
The following example displays all the alerts, suppresses the header and displays only the job number, job name, alert message, response and user.
SACmd alert -b -s
-
The following example displays all alerts.
SACmd alerts
alertset
Warning Always enclose arguments containing spaces in quotes, or the command will not execute successfully. For example, if the Program Files folder is included in a path statement as an argument, the entire path must be enclosed by quotes.
The
alertset
command lets you manually set the status of an alert specified by the alert ID. To obtain the job number alert ID use the
alerts
command.
Syntax
SACmd alertset [-s status] [-i alert_ID]
alertset -options
Table 4 alertset options
|
|
-s status
|
Sets the status of the alert specified with the -i option to one of the following:
OPEN
(or
1
),
ACK
(or
2
) or
CLOSED
(or
3
).
|
-i alert_ID
|
Sets the alert associated with this alert ID to the status specified with the
-s
option.
|
Operation
You can change an alert’s status to any of the available states. Available states include
OPEN
,
ACK
for acknowledged and
CLOSED
. The alert status can be referenced by the alphabetical or numerical designation.
Examples
-
The following example sets the status of the alert associated with job number
254
to
ACKNOWLEDGED
.
SACmd alertset -i 254 -s ACK
-
The following example sets the status of the alert associated with job number
254
to
CLOSED
.
SACmd alertset -i 254 -s 3
calendar
A set of dates specifying when a job will run. Calendars are constructed from the
Calendars
pane. Each calendar has a name and can be selected for scheduling jobs in the job and job group definition dialogs. You can also create calendar groups. For more information on calendars, see
Chapter 9: Monitoring
TES
Production
in the
Reference Guide
.
This command displays a list of calendars accessible to the current user.
calrecalc
The
calrecalc
command recalculates all calendar dates.
calrecalc -options
The
calrecalc
command has no options.
Operation
This command recompiles the dates for all calendars. The calendars are calculated for the current year and the next three years.
compile
Warning Always enclose arguments containing spaces in quotes, or the command will not execute successfully. For example, if the Program Files folder is included in a path statement as an argument, the entire path must be enclosed by quotes.
The
compile
command compiles the production schedule for the dates specified.
Syntax
SACmd compile [-f begin_date][-t end_date]
compile -options
Table 5 compile options
|
|
-f begin_date
|
Jobs designated to run on the
begin_date
and after will be compiled.
|
-t end_date
|
Jobs designated to run on and before the
end_date
will be compiled.
|
Operation
If only the
-f
option is supplied, the range of compile dates is from the specified
begin_date
to today. If only the
-t
option is supplied, the range of compile dates is from today to the
end_date
specified. When no option is supplied, the compilation is for today. Dates must always be in the format
YYYYMMDD
.
Within the date field, you can also include the time. When entering the time, you must always enter it in the format defined in the Windows Regional Settings Control Panel. Dates and times are displayed as configured by the date/time settings in this control panel.
Examples
-
The following example compiles today’s production schedule only.
-
The following example compiles the production schedule from December 5, 2010 to today.
SACmd compile -f 20101205
-
The following example compiles the production schedule from today to January 5, 2010.
SACmd compile -t 2010 105
-
The following example compiles the production schedule for December 6 to December 10, 2010.
SACmd compile -f 20101206 -t 20101210
delrule
Warning Always enclose arguments containing spaces in quotes, or the command will not execute successfully. For example, if the folder
Program Files
is included in a path statement as an argument, the entire path must be enclosed by quotes.
The
delrule
command deletes a job or job group definition. You can either specify the alias or the ID of the job or job group.
delrule -options
Table 6 delrule options
|
|
-a alias
|
Specifies the alias name of the job or job group to delete. Either this option or the
-i ID
option is required.
|
-i ID
|
Specifies the identification number of the job to delete. Either this option or the
-a alias
option is required.
|
Operation
You can use the
listrule
command to obtain job rule IDs.
Examples
-
The following command deletes the job definition with the alias name
invent
.
-
The following command deletes the job definition number
3267
.
depadd
Warning Always enclose arguments containing spaces in quotes, or the command will not execute successfully. For example, if the Program Files folder is included in a path statement as an argument, the entire path must be enclosed by quotes.
The
depadd
command adds a new job dependency or file dependency.
Syntax
SACmd depadd -a alias -t FILE|JOB|VARIABLE
[-d alias -o operator -s status -l occur -z offset -w offset -g]|
[ -h maser_name iv variable_name -o operator -u value]
[-f file_name -y file_type -e file_extent -h agent_name]
depadd -options
Table 7 depadd Options
|
|
-a alias
|
Specifies the alias of the job receiving the new dependency. This option is required.
|
-t FILE|JOB| VARIABLE
|
Specifies the type of dependency: for a file dependency, specify
FILE
; for a job dependency, specify
JOB
: for a variable dependency, specify
VARIABLE
. This option is required.
|
Job Dependency Options
Table 8 Job Dependency Options
|
|
-d alias
|
Specifies the alias name of the job or job group to depend upon. Use this along with the -o and -s options to specify a dependency being met when a job equals or does not equal a particular status.
|
-o operator
|
The operator in string or numeric format. You can choose:
Equals
, or
1
(default)
NotEquals
, or
2
Use this along with the
-d
and
-s
options to specify a dependency being met when a job equals or does not equal a particular status.
|
-s status
|
The status in string or numeric format. You can choose:
Active
, or
51
“Completed Abnormally”
, or
103
“Completed Normally”
, or
101
(default)
“Error Occurred”
, or
66
“Externally Defined”
, or
107
.
Use this along with the -d and -o options to specify a dependency being met when a job equals or does not equal a particular status.
Note that the statuses containing a space must be in quotes.
|
-l occurrence
|
Creates a dependency on the First Occurrence or Last Occurrence of the dependency job, or you can set it to Match Occurrence if you want the job to repeat along with the repeating dependency job.
First Occurrence:
First
, or
1
Last Occurrence:
Last
, or
2
Match Occurrence:
Match
, or
3
|
-z offset
|
If the first occurrence or last occurrence is specified in logic, this value is a numerical value indicating either a positive offset from the first occurrence, or a negative offset from the last occurrence.
|
|
(Continued)
|
-w offset
|
When first occurrence or last occurrence of the
-l
(lower case L) option is selected, you can specify an offset from these occurrences. The offset is always positive. For example, if the last occurrence is specified, there are a total of 5 occurrences, and you specify 3 for this offset, the dependency is met on the second occurrence.
|
-g
|
Specify this option to ignore the dependency if the dependency job is not in the production schedule.
|
File Dependency Options
Table 9 File Dependency Options
|
|
-f file_name
|
The name of the file that the job is dependent on.
If the agent specified for the file dependency is an Windows agent and the file dependency type is [
Size stable
,
Size has changed in
], then file name may include wildcards (that is *,?,etc.) in either the name or path portions of the file name. If this is the case, the following warning is displayed “Using wildcards with a large result set may delay the resolution of file dependencies for other jobs. Is this okay? [
Y,N
]”. If you respond
“N”
, the dependency is not written to the database. The use of wildcards only apply to the above described agent and file dependency types.
|
-h agent_name
|
The agent that the dependency file exists.
|
-y dep_type
|
The type of file dependency. Use the numeric or string values in the following dependency types:
File exists:
Exists
, or
200
File doesn’t exist:
NotExists
, or
201
Size is less than or equal to extent:
SizEle
, or
202
Size is greater than or equal to extent:
SizEge
, or
203
Size stable for extent:
Stable
, or
204
Size has changed in extent:
Changed
, or
205
|
-e extent
|
Use this field to specify the extent value for the last four options of the dependency types listed above.
For
Size <=
or
Size >= file size
, this value is in bytes.
For
Size stable for
or
Size has changed in
, this value is in minutes.
|
Variable Dependency Options
Table 10 Variable Dependency Options
|
|
-h master_name
|
The remote master on which the variable exists.
|
-v variable_name
|
The name of the local or remote variable.
|
-o operator
|
The operator in string or numeric format. You can choose:
Equals
, or
1
(default)
NotEquals
, or
2
Use this along the -d and -s options to specify a dependency being met when a job equals or does not equal a particular status.
|
-u variable_value
|
The value of the variable required to meet the dependency.
|
Examples
-
Add a dependency for a repeating job with the alias
payroll
to depend on the repeating job with the alias name
invent
. The dependency is met when the dependency job’s status equals
Completed Normall
y. Match the occurrence with the repeating dependency job and do not use an occurrence offset. Do not ignore the dependency if the job is not in the schedule.
SACmd depadd -a payroll -t JOB -d invent -s 101 -o 1 -l 3 -z 0 -g N
-
Make the job with the alias
payroll
dependent on the file
file1.doc
existing on the Windows agent.
SACmd depadd -a payroll -t FILE -f c:\file1.doc -h “Windows Agent” -y 200 -e 0
-
Make the job with the alias
payroll
dependent on all files in C:\ whose sizes have been stable for one hour from the present time.
Sacmd depadd -a payroll -t FILE -f C:\*.* -h “Windows Agent” -y 204 -e 60
depdel
Warning Always enclose arguments containing spaces in quotes, or the command will not execute successfully. For example, if the Program Files folder is included in a path statement as an argument, the entire path must be enclosed by quotes.
The
depdel
command deletes job dependencies and file dependencies. It then replaces that job's pre-done instances in the production schedule. Refer to the
submit
command.
Syntax
SACmd depdel -a alias [-t FILE|JOB|VARIABLE]
[-d alias -o operator -s status -l occur -z offset -w offset -g]|
[-f file_name -y file_type -x file_extent -h agent_name] [-r Y|N] [-e yyyymmdd]
[-h master_name -v variable_name -o operator -u value]
depdel -options
Caution Options to the
depdel
command restrict which dependencies are deleted. If no options are specified, all dependencies for the specified job are deleted.
Table 11 depdel Options
|
|
-a alias
|
Specifies the alias of the job or job group with the dependency to delete. This option is required.
|
-t FILE|JOB| VARIABLE
|
Specifies the type of dependency to delete: for a file dependency, specify
FILE
; for a job dependency, specify
JOB
; for a variable dependency, specify
VARIABLE
.
|
-d alias
|
Specify this option to delete only job dependencies with the alias name of the job or job group that the above alias depends upon.
|
-y dep_type
|
Specify this option to delete only the file dependencies with the following file dependency type (in numeric or string format):
File exists:
Exists
, or
200
File doesn’t exist:
NotExists
, or
201
Size is less than or equal to extent:
SizEle
, or
202
Size is greater than or equal to extent:
SizEge
, or
203
Size stable for extent:
Stable
, or
204
Size has changed in extent:
Changed
, or
205
|
-x extent
|
Specify this option to delete only the file dependencies with the following extent value.
For
Size <=
or
Size >= file
size, this value is in bytes.
For
Size stable for
or
Size has changed in
, this value is in minutes.
|
|
(Continued)
|
-h agent or master_name
|
Specify this option to delete file or variable dependencies where the dependency exists on the agent indicated.
|
-s status
|
Specify this option to delete only job dependencies containing the status indicated. The status is stated in character or numeric format. The status can be:
Active
, or
51
“Completed Abnormally”
, or
103
“Completed Normally”
, or
101
“Error Occurred”
, or
66
“Externally Defined”
, or
107
.
|
-r Y | N
|
Specify this option to submit repeating jobs immediately. If omitted, this defaults to
N
.
|
-e yyyymmdd
|
Specifies a date in the production schedule in which the job is to be submitted. If omitted, this defaults to the first production date as specified by its calendar.
|
-v variable_name
|
Specify this option to delete only the varible dependencies that refer to the varible name indicated.
|
-u value
|
Specify this option to delete only the variable value dependencies that refer to the value indicated.
|
-y dep_type
|
Specify this option to delete only the file dependencies with the following file dependency type (in numeric or string format):
File exists:
Exists
, or
200
File doesn’t exist:
NotExists
, or
201
Size is less than or equal to extent:
SizEle
, or
202
Size is greater than or equal to extent:
SizEge
, or
203
Size stable for extent:
Stable
, or
204
Size has changed in extent:
Changed
, or
205
|
-x extent
|
Specify this option to delete only the file dependencies with the following extent value.
For
Size <=
or
Size >= file size
, this value is in bytes.
For
Size stable for
or
Size has changed in
, this value is in minutes.
|
-h agent or master_name
|
Specify this option to delete file or variable dependencies where the dependency exists on the agent indicated.
|
-s status
|
Specify this option to delete only job dependencies containing the status indicated. The status is stated in character or numeric format. The status can be:
Active
, or
51
“Completed Abnormally”
, or
103
“Completed Normally”
, or
101
“Error Occurred”
, or
66
“Externally Defined”
, or
107
.
|
|
(Continued)
|
-r Y | N
|
Specify this option to submit repeating jobs immediately. If omitted, this defaults to
N
.
|
-e yyyymmdd
|
Specifies a date in the production schedule in which the job is to be submitted. If omitted, this defaults to the first production date as specified by its calendar.
|
-v variable_name
|
Specify this option to delete only the varible dependencies that refer to the varible name indicated.
|
Examples
-
The following example deletes all dependencies for the job referred by
JobAlias
.
-
The following example deletes all file dependencies running on the agent
Windows Agent
for job alias
payroll
.
SACmd depdel -a payroll -t FILE -h “Windows Agent”
-
The following command deletes all job dependencies with the alias
holiday
that job alias
payroll
depends on.
SACmd depdel -a payroll -d holiday -t JOB
file
Warning Always enclose arguments containing spaces in quotes, or the command will not execute successfully. For example, if the Program Files folder is included in a path statement as an argument, the entire path must be enclosed by quotes.
The
file
command lets you pipe an input ascii text file containing TES commands for batch processing.
Syntax
Note Specify the full, absolute directory path to your file.
Operation
The file should contain a list of individual commands, with each command separated by a carriage return (one command per line).
For example:
# this is just a test script
listrule
jobmon +iaE
jobadd -a payroll
To add comments to the text file, precede the comment with two forward slashes ( // ) or with the sharp ( # ) sign. The
file
command ignores any line beginning with two forward slashes or the sharp sign. Any line composed entirely of spaces or tabs is also ignored.
If a command in the list produces an error, that command is skipped, but the remaining lines are processed.
Example
The following example inputs the file
cmdlist.txt
to the
file
command.
cmdlist.txt
contains a list of TES commands to process.
grpupd
The
grpupd
command updates inherit attributes for jobs in the specified group. You can obtain the group's job run ID by using the
jobmon
command.
Syntax
SACmd grpupd -i ID -a
grpupd -options
Table 12 grpupd Options
|
|
-i ID
|
Specifies the job run ID of the Job Group.
|
-a
|
Specifies to update agent information for jobs that are defined to inherit agent from the group.
|
help
The
help
command invokes help text explaining the syntax and options of each command.
help -options
Table 13 help Options
|
|
cmd_name
|
The name of the command that you want help on.
|
Operation
When
help
is invoked on a command, only one page is displayed at a time. To move to the next page, press the
Enter
key. To quit help, press any alphanumeric key followed by the
Enter
key.
help
invoked with no command name displays all available commands. If
SACmd
is substituted for
cmd_name
, general information about the
sacmd.cmd
(Windows) or
sacmd.sh
(Unix/Linux) program
is displayed. Invoking
help
on the
help
command provides an explanation on using the
help
command.
Note You can execute
SACmd
with the
-help
option for an understanding of available arguments. For example,
>"C:\Program Files (x86)\TIDAL\TESCmdLine\
bin\sacmd.cmd" -help
Note Once you have entered a
SACmd
session, you can enter
help
for an understanding of available commands. For example,
SACmd>help
.
Example
The following example gets help on the
jobadd
command.
historyPurge
The
historyPurge
command deletes log data stored about jobs for a specified period of time. This data can range from data logged about audits, errors and alerts pertaining to jobs to data directly related to past instances of the job.
Caution This command is only available for tesmcmd. This command is not available for SACmd.
Syntax
historyPurge [date1 [date2]]
historyPurge -options
Table 14 historyPurge Options
|
|
date1
|
Logs from the specified date and older are deleted.
|
date2
|
Job history from the specified date and older is deleted.
|
Operation
Use the following format when specifying the
date1
and
date2
options:
If only one date option is specified then both the logs data and the job history are deleted. If both the
date1
and
date2
options are specified then both the logs and the job history are deleted but different dates can be assigned for purging these two types of data.
If no option denoting a date is used than both log data and job history is deleted starting from the current date.
Example
The following example deletes the log data for all jobs that ran on February 1, 2006 and earlier and deletes the job history for all jobs that ran on February 15, 2006 and earlier.
tesmcmd historyPurge 20060101 20060215
The following example deletes both the log data and job history for all jobs that ran on February 1, 2006 and earlier.
tesmcmd historyPurge 20060101
hosts
The
hosts
command lists information about all TES hosts defined in TES.
hosts -options
Table 15 hosts Options
|
|
-b
|
Suppresses the header information.
|
inactrule
The
inactrule
command inactivates, or disables, a job or job group. When a job or job group is inactivated, its occurrences (if any) are pulled from the production schedule.
Syntax
SACmd inactrule -a alias|-i ID
inactrule -options
Table 16 inactrule Options
|
|
-a alias
|
Specifies the alias name of the job or job group to disable. Either this option or
-i
ID
is required.
|
-i ID
|
Specifies the ID of the job or job group to disable. Either this option or
-a
alias
is required.
|
Examples
-
The following example inactivates the job with the alias name
invent
.
SACmd inactrule -a invent
-
The following example inactivates the job with the ID
2150
.
jobadd
Warning Always enclose arguments containing spaces in quotes, or the command will not execute successfully. For example, if the Program Files folder is included in a path statement as an argument, the entire path must be enclosed by quotes.
The
jobadd
command lets you add a job or job group to the production schedule. You can add a job either by alias or by ID. You can obtain the job occurrence ID and/or alias by using the
listrule
command. Unlike the
submit
command, the job is submitted adhoc. An adhoc job isn’t dependent on a calendar because a new instance is submitted manually into the schedule. Job groups can specify group parameter values if they are expressed in
NAME=VALUE
pairs.
Syntax
SACmd jobadd -a alias| -i ID [-p params]
jobadd -options
Table 17 jobadd Options
|
|
-a alias
|
Specifies the alias name of the job or job group to add. Either this option or
-i
ID
is required.
|
-i ID
|
Specifies the ID of the job or job group to add. Either this option or
-a
alias
is required.
|
-p params
|
Specifies override parameters. For group parameters, separate
NAME=VALUE
pairs with commas.
|
Examples
-
This example adds a job with the alias name
invent2
.
-
The following example adds a job with the job ID
10000
.
-
The following example adds a job group with the job ID
4192
and specifies values for the variables,
QUE
,
APPL
and
QUESUB
. Notice that the value pairs are separated by commas.
SACmd job add 4192 -p “QUE=Q123, APPL=A09, QUESUB=QS2”
jobcancel
The
jobcancel
command cancels a job occurrence with the specified job ID from the production schedule. You can also specify whether canceling the job affects other dependent jobs. You can obtain the ID by running the
jobmon
command.
Syntax
SACmd jobcancel ID [YES|NO]
jobcancel -options
Table 18 jobcancel Options
|
|
ID
|
The jobrun ID of the job to cancel. This option is required.
|
YES|NO
|
Specifies whether to also cancel successor jobs.
If
YES
, its dependent jobs are also cancelled.
If
NO
, its dependents are still dependent on this specific job. The dependent jobs will continue to wait until the dependency is met. The default is
NO
. This value must follow the ID.
|
Operation
When cancelled, only job occurrences that are
Waiting on Dependencies
,
Waiting on Resources
or
Waiting on Operator
end up with the status
Cancelled
. When a job occurrence is in the
Active
state, its resulting status is
Aborted
. A job’s status can be determined using the
jobmon
command.
Examples
-
The following example cancels the job with the job ID
12146
and releases its dependents.
-
The following example cancels the job with job ID
1857
and does not release its dependents.
-
The following example cancels the job with job ID
2489
and does not release its dependents.
jobdep
The
jobdep
command displays all the dependencies of the specified type belonging to a job or job group.
Syntax
SACmd jobdep -i ID|-a alias -t FILE|JOB [-b]
jobdep -options
Table 19 jobdep Options
|
|
-i ID
|
The rule ID of the job whose dependencies you want to see. To obtain rule ID’s use the
listrule
command. Either this option or
-a
alias
is required.
|
-a alias
|
The alias of the job whose dependencies you want to see. Either this option or
-i
ID
is required.
|
-t FILE|JOB
|
The type of dependencies you want to see, either all of the job’s file dependencies or job dependencies. This is not case sensitive. The default is
JOB
. This option is required.
|
-b
|
Optionally suppresses the header.
|
Examples
-
The following example displays all the file dependencies belonging to job rule ID
2346
and suppresses the header in the output.
SACmd jobdep -b -i 2346 -t FILE
-
The following example displays all the job dependencies belonging to the job with the alias
payroll
.
SACmd jobdep -t JOB -a payroll
jobgo
The
jobgo
command overrides all dependencies for a job or job group, allowing the job or job group to launch. Obtain job run IDs by running the
jobmon
command.
jobgo -options
Table 20 jobgo Options
|
|
ID
|
The jobrun ID of the job whose dependencies you want to override. This option is required.
|
Operation
Only job occurrences in a
Waiting on Dependencies
status can be overridden.
jobhold
The
jobhold
command prevents a job occurrence with the specified job occurrence ID from running in the production schedule. Obtain the job occurrence ID by running the
jobmon
command.
jobhold -options
Table 21 jobhold Options
|
|
ID
|
The jobrun ID of the job you want to hold. This option is required.
|
Operation
On Windows agents, only job occurrences in a
Waiting on Dependencies
or
Waiting on Resource
status can be put on hold. For jobs running on other agent platforms, only jobs in a
Waiting on Dependencies
,
Waiting on Resource
or
Active
status can go to a
Held
status. When a job occurrence is in the
Active
status, its resulting status will be
Stopped
.
jobmod
The
jobmod
command modifies a Job occurrence. You can obtain the job run ID by using the
jobmod
command.
Syntax
SACmd jobmod -i ID [options]
jobmod -options
Table 22 jobmod Options
|
|
-i ID
|
Specifies the ID of the job or job group.
|
Command Options
|
|
-C command_path
|
Specifies the path and filename of the command that is run by the Job.
|
-P parameters
|
Specifies one or more parameters to be passed to the command.
For multiple parameters, you MUST separate them with spaces and then quote the string.
|
-e environ_file
|
Specifies an environment file for the command specified using the
-C
option. You MUST also specify the file's path.
|
-O output_filename
|
Specifies the output file name.
Some jobs create an output file with a specific file name that you would like Master to recognize. Use this option to specify the name and location of the output file. When the job completes, Master WILL NOT create a default standard output file on the agent machine. Instead, you WILL have the output created by the executable you specified via the
-C
option.
|
Run Commands
|
|
-h agent_name
|
Specifies the name of the agent on which to run the job. If the Agent name has a space, the name MUST be enclosed in quotes. You CANNOT use this option with the
-g
option.
|
-g agent_list
|
Specifies the name of the agent list on which to run the Job. If the Agent List name has a space, the name MUST be enclosed in quotes. You can NOT use this option with the
-h
option.
|
|
(Continued)
|
-u agent_name
|
Specifies the login account to use when running the job. Use this option when you are running a job as another user, and that user has access to data or resources required for the job that would NOT be accessible under your user account.
|
-u adm
|
Specifies adm as a UNIX user.
|
-m track
|
Specifies track method to determine the results of a Job.
|
-r track_cmd
|
Specifies the tracking command to use when Command (or 3) is selected using the
-m
option. The command must be in quotes.
|
-r search_text
|
Specifies the search string to use when NormalText (or 4) or AbnormalText (or 5) is selected using the
-m
option. The string MUST be in quotes.
|
Options Commands
|
|
-y job_priority
|
Specifies the job priority relative to other jobs in the job's destination queue. The range is from 0 to 100, where 100 is the highest priority. The default when the job is first created is 50.
|
jobmon
Warning Always enclose arguments containing spaces in quotes, or the command will not execute successfully. For example, if the Program Files folder is included in a path statement as an argument, the entire path must be enclosed by quotes.
The
jobmon
command lets you display job occurrence information. Command options allow you to filter the information displayed.
Syntax
SACmd jobmon [-d date] +display_options [filtering_options] [-b]
jobmon -options
Table 23 jobmon Options
|
|
-d date
|
The production date to display. The default is today. The format for the date is YYYYMMDD. Do not use any punctuation when entering the date.
|
|
The list of information to display. You specify display options with no spaces, e.g.
+aivo
. The order of the options dictates the order of the columns in the display. If no options are specified, the options default to
+itnau
. You can choose from the following display options:
|
|
(Continued)
|
r
i
p
j
c
o
u
h
z
t
s
v
n
a
q
x
|
Job rule ID
Job run ID
Parent job group ID
Job type (job or job group)
Occurrence number
Job or job group owner
Runtime user
Agent The Agent the job runs on
Scheduled vs. unscheduled job
Job start time
Job status
Job duration
Job name
Job alias
Queue
Exit code
|
|
Specifies the records to filter for display.
The options are preceded by the -sign and the value. You can specify the following filters:
|
-r
-p
-j
-o
-u
-h
-s
-a
-x
|
rule_id Job rule ID
group_id Parent job group ID
type Job type. You can choose:
job group: group, or 1
job: Job, or 2
owner Job or job group owner
run_user Runtime user
agent The Agent name the job runs on status job status. Refer to job status ID Cross Reference for more information.
alias Job alias
exit_code Exit code
Suppresses the header information.
|
Examples
-
The following command displays job aliases for owner
administrator
and user
mike
.
SACmd jobmon +a -o administrator -u mike
-
Display instance, status, start time, job queue and exit code for all instances of job alias
payroll
.
SACmd jobmon +cstqx -a payroll
-
Display instance, run ID and exit code for all group-type jobs for owner
ADMIN
.
SACmd jobmon +cix -o ADMIN -j 1
Same as above but display only job-type jobs.
SACmd jobmon +cix -o ADMIN -j 2
-
Display run ID, alias and start time for all jobs with a
Completed Normally
status.
Same as above but filter only the jobs belonging to user michaelj.
SACmd jobmon +iat -s 101 -u michaelj
jobrelease
The
jobrelease
command resumes a job occurrence that was held with the jobhold command and releases a job in a
Waiting on Operator
status. You can obtain the job run ID by using the
jobmon
command.
jobrelease -options
Table 24 jobrelease Options
|
|
ID
|
The run ID of the job to release. This option is required.
|
Operation
Only job occurrences in a
Hold
,
Stopped
or
Waiting on Operator
status can be released or resumed. Jobs in a
Hold
status return to either a
Waiting on Dependencies
or
Waiting on Resource
status. Jobs in a
Stopped
status return to the
Active
status.
Example
The following command releases job run ID 53 currently in the
Waiting on Resource
status.
jobremove
The
jobremove
command removes job occurrences from the production schedule. The job must have a pre-launched status. Once a job reaches
Launched
,
Active
or one of the
Completed
statuses, it cannot be removed from the schedule.
Syntax
SACmd jobremove ID [ALL|ONE] [YES|NO]
jobremove -options
Table 25 jobremove Options
|
|
ID
|
The job run ID of the job to remove. This option is required.
|
ALL|ONE
|
Specifies whether to remove all occurrences of the job that have not run, including occurrences for future dates or whether to remove just the specified job run occurrence. If ALL is specified, this parameter refers to the job rule ID of the specified job run ID to remove all occurrences.If not specified, the default is
ONE
to remove just the specified job instance.
|
YES|NO
|
Specifies whether to release the job’s dependents when removing the job. If
YES
, its dependents will no longer be dependent on this job. If
NO
, its dependents stay dependent on this job. The default is
NO
. This value must follow after the ID.
|
Operation
The ID parameter is required: the rest are optional. If all optional parameters are specified, they must be specified in the order given. Because a job can be placed in the
Stopped
or
Aborted
status while in the
Active
status using the
jobhold
or
jobcancel
commands,
jobremove
does not remove jobs with those statuses. Jobs with the
Held
or
Cancelled
status, however, can be removed
Warning
Active
jobs cannot be
stopped
and restarted on Windows machines. Other platforms do allow this action.
Examples
-
The following example removes all job occurrences and does not release any dependencies on it. In this case, the job rule ID of the specified job instance is used to identify and remove all other instances of that job rule that have not yet run.
SACmd jobremove 123 ALL NO
-
The following example removes specific job instances, but it does not release any dependencies on it. In this case, the ID refers to the run ID of the job being removed.
SACmd jobremove 123 ONE NO
-
The following example removes the specified job occurrence, and releases any dependencies upon it. In this case, the ID refers to the job run ID of the job being removed.
jobrerun
The
jobrerun
command lets you manually rerun a completed job or job group. You can obtain the job run ID by using the
jobrerun
command.
Syntax
SACmd jobrerun ID [YES|NO] [-s step]
jobrerun -options
Table 26 jobrerun Options
|
|
ID
|
The run ID of the job to rerun. This option is required.
|
YES|NO
|
Successor. This value can be
YES
or
NO
(or successor omitted where it defaults to
NO
). When
SUCCESSOR
is
YES
the master will rerun all the jobs dependent on this job (if any). This value must follow after the ID, and must be provided if the step parameter is being used.
|
-s step
|
The step to start from when rerunning a job that supports multiple steps or processes (for example, SAP or PeopleSoft jobs).
|
Operation
When you rerun a job, the job’s dependencies are enforced.
Example
-
The following example reruns the job with run ID
3245
, and does not rerun all jobs dependent upon it.
-
The following example reruns the job with run ID
1834
starting at step
3
.
jobset
Warning Always enclose arguments containing spaces in quotes, or the command will not execute successfully. For example, if the Program Files folder is included in a path statement as an argument, the entire path must be enclosed by quotes.
The
jobset
command lets you manually set the completion status of a job. You can obtain the job run ID by using the
jobmon
command.
Syntax
SACmd jobset -i ID -s status
jobset -options
Table 27 jobset Options
|
|
-i ID
|
The run ID of the job to rerun. This option is required.
|
-s status
|
The new completion status for the job. You have the following options:
“Completed Normally”
, or
101
“Error Occurred
”, or
66
“Completed Abnormally”
, or
103
Skipped
, or
104
“Externally Defined”
, or
107
Orphaned
, or
105
This option is required. Note that statuses containing spaces must be in quotes.
|
Operation
You can set a job’s completion status to the following statuses (which constitute all available completion statuses):
Completed Normally
,
Completed Abnormally
,
Error Occurred
,
Externally Defined
,
Orphaned
and
Skipped
.
Examples
-
The following example sets the job with run ID
2476
to
Completed Normally.
SACmd jobset -s 101 -i 2476
-
Either of the following examples sets the job with run ID
3245
to
Completed Abnormally.
SACmd jobset -i 3245 -s 103
SACmd jobset -i 3245 -s “Completed Abnormally”
listrule
Warning Always enclose arguments containing spaces in quotes, or the command will not execute successfully. For example, if the Program Files folder is included in a path statement as an argument, the entire path must be enclosed by quotes.
The
listrule
command lists information about job and job group rules. You can choose the information to list. You can also select which records to display.
Syntax
SACmd listrule +display_options [filtering_options] [-b]
listrule -options
Table 28 listrule Options
|
|
|
The list of information to display. You specify display options with no spaces, e.g.
+aivo
. The order of the options dictate the order of the columns in the display. The number of display options is limited to four; if more that four options are specified, only the first four display options are displayed. If no options are specified, the default
+itna
is used. You can choose from the following display options:
|
a
|
Job alias
|
i
|
Job ID
|
p
|
Parent job group ID
|
l
|
(Lower case L) Dependency logic
|
r
|
Tracking cmd
|
m
|
Track method
|
s
|
Save output
|
f
|
Time window, from time
|
x
|
Time window, until time
|
d
|
Calendar from date
|
v
|
Calendar until date
|
|
The list of information to display. You specify display options with no spaces, e.g.
+aivo
. The order of the options dictate the order of the columns in the display. The number of display options is limited to four; if more that four options are specified, only the first four display options are displayed. If no options are specified, the default +itna is used. You can choose from the following display options:
|
a
|
Job alias
|
g
|
Agent List name
|
h
|
Agent name
|
y
|
Job priority
|
c
|
Concurrency
|
I
|
(Uppercase i) Interval at which to repeat the job.
|
k
|
Interval count
|
u
|
Runtime user
|
z
|
Unscheduled Allowed
|
e
|
Environment file name
|
P
|
Command Parameters separated by spaces (e.g.
-P OFF 98
)
|
|
(Continued)
|
C
|
Command file name
|
o
|
Owner name
|
n
|
Job name
|
j
|
Job type
|
E
|
Calendar name
|
g
|
Agent List name
|
h
|
Agent name
|
y
|
Job priority
|
|
|
-a
|
Alias name
|
-n
|
Job name
|
-o
|
Owner name
|
-u
|
Runtime user
|
-p
|
Parent ID
|
-J
|
Display jobs only
|
-G
|
Display groups only
|
-b
|
Suppresses header information.
|
Examples
-
Display alias and calendar information for all jobs (no-groups) for user
jamesb
:
-
Display name, alias, priority and job rule ID for all groups belonging to user
jamesb
.
-
Display name, calendar and command for every job-only with parent ID =
2345
.
liststat
The
liststat
command lists all possible job statuses and their associated status number in two column format.
liststat -options
The
liststat
command has no options.
modrule
Warning Always enclose arguments containing spaces in quotes, or the command will not execute successfully. For example, if the Program Files folder is included in a path statement as an argument, the entire path must be enclosed by quotes.
The
modrule
command modifies a job or job group definition (rule). To modify the rule, either the job ID or an alias must be specified. In order to use
modrule
, it must be preceded by the
addrule
command.
Syntax
SACmd modrule -a alias | -i ID [options]
modrule -options
Table 29 modrule Options
|
|
-a alias
|
The alias name of the job or job group. Job ID’s can be obtained using the listrule command. For example, to specify the job with alias
12345
,
-a 12345
If you choose to use the
-i
option to specify the rule, the -a option can be used to change the alias number. See below for more information. Either this option or
-i ID
is required.
|
-i ID
|
The rule ID of the job or job group. For example,
-i 123
Either this option or
-a
alias
is required. Note that if you choose to specify the job or job group using this option, you can change the alias using the -a option. For example, to open
Job 345
and change its alias to
456
,
SACmd modrule -i 345 -a 456
|
|
-n job_name
|
Job name. Specifies the name of the job. Names with spaces must be enclosed in quotes. For example, to specify the job name as
My Job
,
-n “My Job”
|
-p parent_ID
|
The parent job group ID. Job group ID’s can be obtained using the listrule command. For example, assign a job to a parent job group with ID 234,
-p 234
|
|
(Continued)
|
-j job_type
|
Job Type. Specifies the job type for the job,
GROUP
for Job Group or
JOB
for Job. For example to specify a Job Group,
-j GROUP
|
-J class_name
|
Job class. Specifies the job class for the job. If your queues are setup to receive jobs based on their class, you can use this option to direct your job to run from those queues with the specified class as a queue filter. For example, to specify the Reporting Class,
-J Reporting Class
To remove a job class previously specified,
-J
|
-o owner_name
|
Owner name. Specifies the owner of the job. You can specify your screen name or any of your workgroup names. Names containing a space must be enclosed in quotes. For example, to set the job to belong to workgroup My Workgroup,
-o “My Workgroup”
|
-T Y|N
|
Set the job to Enabled or Disabled. When
-T Y
is specified, you allow the job to enter the production schedule. When
-T N
is specified, you prevent the job from entering the production schedule, either automatically or manually.
|
|
-C
command_path
|
Command file name. Specifies the command. You must include the path to the command. For example,
-C c:\programs\reports.bat
For example, to specify the reports.bat command file from the programs shared directory located on computer1,
-C \\Computer1\programs\reports.bat
|
-P “parameters”
|
Command parameters. Specifies parameters to pass to the command file. When you specify parameters, they should be separated by spaces. For example, to specify
OFF
as your first parameter, and 98 as your second parameter:
-P “OFF 98”
|
-e environ_file
|
Environment file name. Specifies an environment file for the command specified using the
-C
option. You must also specify the file’s path. For example, to specify the environment file
env1.txt
.
-e c:\environments\env1.txt
|
|
(Continued)
|
-O output_filename
|
Output File Name. Some jobs create an output file with a specific file name that you would like TES to recognize. Use this option to specify the name and location of the output file. When the job completes, TES will not create a default standard output file on the agent machine. TES will not create a default standard output file on the agent machine. Instead, you will have the output created by the executable you specified via the
-C
option.
-O c:\outputfiles\output.txt
|
|
-k repeats
|
Specifies the number of times a job is to be repeated.
|
-I interval
|
Specifies the amount of time in seconds between repeats of a job.
|
-Q repeat Y|N
|
(Uppercase Q) Specifies if this is a job runs repeatedly.
Y
indicates that the same job occurrence will be rerun after 'interval' up to 'intrval_cnt'. (See above for definitions of 'interval' and 'intrvl_count'.)
N
indicates that a new job occurrence will run every 'interval' up to 'intrval_cnt'. (See above for definitions of 'interval' and 'intrvl_count'.) The value must be specified in upper case. If a value other than
Y
or
N
is specified, the job is set to run only once.
|
-V Y|N
|
Specifies whether the job will inherit the calendar (
Y
) or not (
N
). If the job has a parent job group specified using the
-p
option, specifying this command inherits the calendar settings from the parent group. After using this command, you do not need to specify the
-E
,
-U
,
-d
, and
-v
options.
|
-E calendar_name
|
Calendar name. Specifies the calendar to use for scheduling the job or job group. For example, to specify the work_day calendar,
-E work_day
|
-U offset
|
Offset. Specifies a numerical offset that is applied to each day generated by the calendar. For example, if the calendar generates every Monday, an offset of 1 specifies every Tuesday. For example, to offset the calendar by one day,
-U 1
|
-d from_date
|
Calendar from date. Specifies the date from which the job can be scheduled. The date must be specified in YYYYMMDD format. For example, to specify the calendar from date as Jan 6, 2005,
-d 20050106
|
-v to_date
|
Calendar until date. Specifies the date to which the job can be scheduled. The date must be specified in YYYYMMDD format. For example, to specify the calendar to date as Jan 10, 2005,
-v 20050110
|
-X Y|N
|
Specifies whether the job inherits the time window (
Y
) or not (
N
). If the job has a parent job group specified using the
-p
option, specifying this command inherits the Time Window settings from the parent group. After using this command, you do not need to specify the
-w
,
-f
, and
-x
options.
|
|
(Continued)
|
-w time_dep
|
Time window. Specifies time window parameters. To use this option you must set the time window option to prevent inheritance (
-X=N
).
NotTimeDep
or
0
: Specifies no time window for the job or job group. This is the default when the job is first created.
TimeDepAnyDate
or
1
: If the job doesn’t run today within the time window specified by the -f and -x options, (due to other dependencies not being met), this option lets you try again tomorrow.
TimeDepSchDate
or
2
: If the job does not run today within the time window specified by the
-f
and
-x
options, this option prevents it from running on future days.
For example, to specify that job to try again tomorrow if it is unsuccessful running in today’s time window,
-X=N -w TimeDepAnyDate
|
-f from_time
|
Time window, from time. Specifies the time dependency from which the job or job group can run from the schedule. You must specify the time in the format as shown in the Regional Settings control panel. To use this option you must set the time window option to prevent inheritance (
-X=N
).
For example,
-X=N -f 04:12:00 PM
|
-x to_time
|
Time window, until time. Specifies the time dependency to which the job or job group can run from the schedule. You must specify the time in the format as shown in the Regional Settings control panel. To use this option you must set the time window option to prevent inheritance (
-X=N
). For example,
-X=N -x 05:12:00 PM
|
-I interval
|
(Uppercase i) Interval for repeating jobs. Specifies an interval in minutes to run repeating jobs. This option should be specified along with the
-k
option. For example to repeat the job every five minutes, 10 times,
-I 5 -k 10
|
-k intrvl_count
|
Interval count for repeating jobs. Specifies the number of times to repeat the job at the interval specified by the
-I
(uppercase i) option. See above for example.
|
|
-K Y|N
|
Specifies whether the job will inherit the Agent (
Y
) or not (
N
). If the job has a parent job group that is specified using the
-p
option, specifying this command inherits the Agent, Agent List and Runtime user settings from the parent job group. After using this command, you do not need to specify the
-h
,
-g
, and
-u
options. For example, to inherit the Agent from the job group,
-p “My Group” -K Y
|
-h agent_name
|
Agent name. Specifies the name of the agent on which to run the job. If the Agent name has a space, the name must be enclosed in quotes. You cannot use this option with the
-g
option. For example, to use the Windows Agent named Batman,
-h Batman
|
-g agent_list
|
Agent list name. Specifies the name of the agent list on which to run the job. If the agent name has a space, the name must be enclosed in quotes. You cannot use this option with the
-h
option. For example, to use the agent list named “My Agent List”,
-g “My Agent List”
|
-u runtime_user
|
Runtime user. Specifies the login account to use when running the job. Use this option when you are running a job as another user, and that user has access to data or resources required for the job that is not accessible under your user account. For example, to specify Alex in the acmeco domain as the runtime user,
-u acmeco\Alex
To specify a Unix user account such as adm,
-u adm
|
-m track
|
Track method. Specifies how to determine the results of a job. You can choose:
ExitCode
or
1
to let the job’s exit code determine the completion status of the job. This is the default setting when the job is first created.
External
or
2
to set the completion status to External. The Operator should then determine the actual completion status from the job’s output and then set it using the jobset command or using the Tidal Web client.
Command
or
3
to use an external command that inspects the job’s output, such as the windows Find command, to determine the completion status. The exit code of the command becomes the exit code of the job.
NormalText
or
4
to scan the job’s output for a string that indicates the job completed normally.
AbnormalText
or
5
to scan the job’s output for a string that indicates the job completed abnormally.
|
-r track_cmd
|
Tracking cmd. Specifies the command to use when
Command
(or
3
) is selected using the
-m
option. The command must be in quotes. For example, you can search the output for the string
OK
using the
Find
command by typing
Find `OK`
. If
OK
is found,
Find
returns
1
which becomes the exit code of the job, that is,
Completed Normally
.
Note that any text that needs to be placed in quotes within the command should be enclosed in accent marks, not parenthesis or apostrophes. The accent mark is normally located on the tilde character button on your keyboard. For example, to search through the output of a job for
Completed OK
,
-m command -r Find `Completed OK `
|
|
(Continued)
|
-r search_text
|
Search text. Specifies the string to use when
NormalText
(or
4
) or
AbnormalText
(or
5
) is selected using the
-m
option. The string must be in quotes. For example, you can search the output for the string
OK
to determine that the job completed normally.
Note that any text needing to be placed in quotes within the command should be enclosed in accent marks, not parenthesis or apostrophes. The accent mark is normally located on the tilde character button on your keyboard. For example, to search through the output of a job for
Completed OK
,
-m normaltext -r ‘Completed OK ‘
|
-Z est_duration
|
Estimated duration. Specifies the estimated duration in minutes for the job. The estimated duration is useful when checking if your job runs over or under the estimated time. For example, to set the estimated duration to ten minutes,
-Z 10
|
-N min_duration
|
Minimum duration. Specifies the minimum duration for your job. The minimum duration can be used to trigger a job event that takes an action if the job completes before its minimum time. For example, to set the minimum duration to 5 minutes,
-N 5
|
-M max_duration
|
Maximum duration. Specifies the maximum duration for your job. The maximum duration can be used to trigger a job event that takes an action if the job runs after its maximum time. For example, to set the maximum duration to 15 minutes,
-M 15
|
|
-l dep_logic
|
(Lowercase L) Dependency logic. Specifies whether any or all dependencies must be met for the job or job group to run. You can choose:
AND
or
1
to specify all dependencies. This is the default setting when the job is first created.
OR
or
2
to specify any dependency.
For example, to specify that all dependencies must be met,
-1 AND
|
|
-y job_priority
|
Job priority. Specifies the job priority relative to other jobs in the job’s destination queue. The range is from
0
to
100
, where
100
is the highest priority. The default when the job is first created is
50
. For example, to set the job priority to
65
,
-y 65
|
|
(Continued)
|
-c concurrency
|
Concurrency. Specifies what to do if another occurrence of the job is already running.
Run
or
1
: Runs the job along with the previous occurrence. This is the default setting when the job is first created.
Skip
or
2
: Skips the job altogether. The job occurrence is never run.
Defrnrm
or
3
: Runs the job after the previous occurrence completes normally.
Defer
or
4
: Runs the job after the previous occurrence completes.
For example, to set the concurrency to run anyway,
-c Run
|
-z Y|N
|
Specifies that a job can be added adhoc to a schedule. Without this setting, you can only schedule the job using a calendar.
|
-q
|
Requires operator release flag. When specified, holds the job in the production schedule when all dependencies are met, until the operator releases it with the jobrelease command or using the Tidal Web client.
|
-s Y|N|R
|
Save output. This option, when specified, saves the output required for the
-m
and
-r
options.
If
N
, then the output is discarded. (default)
If
Y
, then the output is saved and added to the previous job instance’s output.
If
R
, then the output is saved but overwrites (or replaces) the previous job instance’s output.
|
-so Y|N
|
Summary only. If job output is to be saved or appended, this option saves the output in summary form rather than full job output. This option only applies to Oracle Applications jobs.
If
Y
, then the output is presented in summary form.
If
N
, then the full job output is saved. (default)
|
-R retention
|
Retention. Specifies the length of time in days to keep job occurrence history for this particular job in the production schedule. Job history older than the retention setting is automatically purged. For example, to set the retention history to 15 days,
-R 15
|
|
-b Runbook string
|
Runbook text string. Specifies the text string to be included on the
Runbook
tab of the job rule. For example, a URL.
|
|
-S
description
|
Job description. Lets you write a description for the job. The description must be enclosed in quotes. For example, to add a description,
-S “This is my description.”
|
Operation
Due to the number of options in the
modrule
command, you can break up this command into several smaller commands. You can then use the
submit
command to add the job or job group to the production schedule.
Examples
-
Modify environment file, agent and calendar for job alias
payroll
.
SACmd modrule -a payroll -e c:\envfile.doc -h "Windows Agent" -E Dailys
-
Modify job name and run time user for job ID
2345
.
SACmd modrule -i 2345 -n new job2 -u jamesb
output
The
output
command displays the output of a job.
output -options
Table 30 output Options
|
|
-i ID
|
Specifies the identification number of the job that will provide the output.
|
Operation
Displays the output of the job in uncompressed text.
pause
The
pause
command pauses the production schedule, preventing jobs, even those whose dependencies have been met, from being launched. To restart the production schedule, use the
resume
command.
pause -options
The
pause
command has no options.
qlimit
The
qlimit
command lets you manually set the limit of an existing queue.
Syntax
SACmd qlimit -n name -l limit
qlimit -options
Table 31 qlimit Options
|
|
-n name
|
The name of the queue. Note that a queue name containing a space must be enclosed in quotes, e.g.,
“system queue.”
|
-l limit
|
The new value for the queue limit.
|
Operation
The
qlimit
command only works with existing queues. It cannot be used when creating a new queue. You can set a value for the queue only if you have the proper security privileges to edit this queue.
Note A queue name that contains a space must be enclosed within quotation marks when used in a command.
resume
The
resume
command resumes the production schedule, allowing jobs to be launched after using
pause
to temporarily stop the production schedule. This does not apply to jobs that are
Waiting on Dependencies
.
resume -options
The
resume
command has no options.
status
The
status
command displays the status of a job or job group instance.
The condition or state of a job occurrence varies throughout its life cycle. When a job has entered the schedule and is waiting to run or is actively running, possible statuses include:
-
Active
-
Waiting on Children
-
Launched
-
Waiting on Resource
-
Waiting On Dependencies
-
Held
-
Agent Unavailable
-
Agent Disabled
-
Waiting on Group
-
Timed Out for Day
-
Waiting on Operator
When a job completes, possible status values are:
-
Completed Normally
-
Completed Abnormally
-
Error Occurred
-
Orphaned
-
Skipped
-
Aborted
-
Cancelled
-
Timed Out
If the status of a job occurrence is
Externally Defined
, then TES is waiting for an external status update.
For more information about job statuses, see
Jobs and Job Groups
in the TES
Reference Guide
.
Syntax
SACmd status -i ID|-a alias -o Inst
status -options
Table 32 status Options
|
|
-i ID
|
The occurrence ID of the job or job group. Either this option or
-a alias -o Inst
is required.
|
-a alias
|
The alias of the job or job group instance. Either this option or
-i ID
is required. If this option is used, the
-o Inst
option must also be used.
|
-o Inst
|
The job or job group occurrence.
|
Examples
-
Display the status of the job with the job ID of
9
.
-
Display the status of the second occurrence of the job alias
34
.
submit
The
submit
command replaces predone job or job group instances in the production schedule according to its calendar. If there are job or job group instances already completed, these instances are not replaced
Syntax
SACmd submit -i ID|-a alias [-r Y|N] [-e yyyymmdd]
submit -options
Table 33 submit Options
|
|
-i ID
|
The rule ID of the job or job group to replace. To obtain rule ID’s use the listrule command. Either this option or
-a alias
is required.
|
-a alias
|
The alias of the job or job group to submit. Either this option or
-i ID
is required.
|
-r Y | N
|
Specifies whether to submit repeating jobs immediately. If omitted, this defaults to
N
.
|
-e yyyymmdd
|
Specifies a date in the production schedule in which the job is to be submitted. If omitted, this defaults to the first production date as specified by its calendar.
|
Examples
-
The following example submits the job with the alias name
newjob2
.
-
The following example submits a job with the rule ID
2354
.
useradd
Warning Always enclose arguments containing spaces in quotes, or the command will not execute successfully. For example, if the folder
Program Files
is included in a path statement as an argument, the entire path must be enclosed by quotes.
The
useradd
command allows you to add a new user. The user name is a required parameter.
Syntax
SACmd useradd user/group name [-d domainname | -p Windowspassword |
-f fullname | -g Y|N | -r "Y" or "N" or "R" |-s security_profile_name
useradd -options
Table 34 useradd Options
|
|
-d domainname
|
Specifies the user domain.
|
-p Windows/FTP/
OS400 password
|
Specifies the Windows/FTP/OS400 password for the new user.
|
-f fullname
|
The user’s full name. If omitted, this defaults to the user/group name.
|
-g Y|N
|
Specifies whether this user is a group (
Y
) or a user (
N
). If unspecified this defaults to user.
|
-r Y|N|R
|
Specifies what type of user.
If
R
, then the user is a runtime user only.
If
Y
, then the user is a superuser.
If
N
, then the user is not a superuser.
If unspecified then this defaults to not a superuser.
|
-s security_profile_name
|
Specifies the name of the security profile for the user. If omitted; this defaults to the Operator profile.
|
Operation
You can add a new user only if you have the required security privileges for adding users.
varset
Warning Always enclose arguments containing spaces in quotes, or the command will not execute successfully. For example, if the folder
Program Files
is included in a path statement as an argument, the entire path must be enclosed by quotes.
The
varset
command lets you manually set the value of an already existing variable.
Syntax
SACmd varset -i <group jobrun ID> -n <variable name> -v <variable value>
varset -options
Table 35 varset Options
|
|
-i id
|
The Job Run ID for a group whose local variable is to be updated.
|
-n name
|
The name of the variable whose value is to be reset. This option is required
|
-v value
|
The new value for the variable. This option is required.
|
Operation
You can set a value for any variable for which you have editing privileges. The variable should be specified in the format required by its type (
DATE
,
STRING
or
NUMBER
).