The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
A hidden aspect of TES is its command line program. The sacmd.cmd (Windows) or sacmd.sh (Unix/Linux) program provides access to TES through the MS-DOS command prompt. The Unix version of TES uses a similar program called tesmcmd . The command line program is generally done from the Tidal Web client but you can also use the sacmd.cmd (Windows) or sacmd.sh (Unix/Linux) program on a master machine. You can automate TES job control functions by including commands in scripts or by embedding job control functions in the code running your company processes.
To install the Command Line program for Windows:
Step 1 From your Enterpise Scheduler product DVD, locate and run Command Line\TIDAL Enterprise Scheduler CommandLine.msi for either 32-bit or 64-bit.
The Destination Folder panel displays.
Step 3 Click Next to install to the default folder location or click Change to choose a different location.
The Ready to Install the Program panel displays.
Step 4 Click Install to begin the installation.
When the setup is complete, the Setup Completed panel displays.
Step 5 Click Finish to complete the installation.
To install the Command Line program from Console mode:
Step 1 Open a command prompt window by selecting from the Start menu, Programs>Command Prompt .
Step 2 Enter $ ./install.bin -i console .
Step 3 Press Enter to continue the installation.
The Choose Install Folder screen displays.
Step 4 Press Enter to select the default location.
Enter an absolute path to the appropriate location, then press Enter .
Step 5 At the IS THIS CORRECT? prompt, enter Y if the path for the install folder is correct or N if it is incorrect.
The Pre-Installation Summary screen displays.
Step 7 After reviewing the installation information, press Enter to begin the installation.
The Installing screen displays.
Step 8 When the installation is complete, press Enter to exit the installer.
Before you can use the Command Line Program, you must connect to the Client Manager DSP.
Step 1 Verify that the Master and Client Manager are running.
Step 2 Locate the path to the sacmd command and enter the following information:
sacmd -cmdspurl http://hostname:8080/api/tes-6.2 -user username -pass password
The command-line interface to TES allows you to refer to jobs by their job ID number or the job alias. Job aliases are set automatically to the unique job ID number whenever you create a job definition. You can edit the job alias to a name of your own choosing on the Options tab in the Job Definition dialog; however, the job alias must be unique and the Job Alias field cannot be left blank. Many commands allow you to refer to a job or group using the alias name or job ID, but not the full job or group name.
Job aliases must be between one and eight characters in length. Do not use spaces in job aliases.
Note You can use the listrule command to discover the job alias, as well as other job rule data, for your jobs and job groups.
The sacmd.cmd (Windows) or sacmd.sh (Unix/Linux) program includes the file command that reads commands from a file, letting you batch-process a group of commands.
You can add comments to your file by preceding the comment with two forward slashes
(//) or the sharp sign (#).
You can use spaces or tabs in front of the comment character
(// or #), but otherwise it must be the first character in a line.
Lines that contain only spaces or tabs are ignored. You can add clarity to your script or batch file by using blank lines to separate different sections of your file.
The Command file can be defined in a job definition along with any necessary command parameters. Commands can be run from TES as jobs if the user:
Command files are defined from the Program tab of the Job Definition dialog. The command is entered in the Command field and any parameters for the command are entered in the Parameters field.
Information for accessing the DSP should precede the command line command in the Command Parameters field.
There are two modes for entering commands from the command line program, Single and Multiple Command.
Note Before using sacmd <command>, you can set -persist to save the given URL, user and password in an encrypted file in the user's home directory, so that next time sacmd is started, the URL, user and password will not have to be specified. For further information on command arguments, refer to the help by running sacmd -help from the bin directory of the Command Line Program home.
Using this mode, type SACmd before each command. After entering the command, you return to the MS-DOS prompt.
Step 1 Open a command prompt window by selecting Start>Programs>Accessories>Command Prompt .
Step 2 Change directories by entering the following text (if you used the default location for files during installation) after the prompt:
cd /d C:\Program Files\TIDAL\TESCmdLine\bin
Press the Enter key and your prompt becomes the following:
C:\Program Files\TIDAL\TESCmdLine\bin>
Step 3 Enter SACmd and then the command and press the Enter key. The command executes and you are returned to the prompt.
C:\Program Files\TIDAL\TESCmdLine\bin>
C:\Program Files\TIDAL\TESCmdLine\bin\>SACmd status -i 8
Using the multiple command mode, you can enter TES commands without typing SACmd each time.
To enter multiple command mode:
Step 1 Open a command prompt window by selecting Start>Programs>Accessories>Command Prompt .
Step 2 Change directories by entering the following (if you used the default location for files during installation) after the C:\> prompt:
cd /d C:\Program Files\TIDAL\TESCmdLine\bin
Press the Enter key and your prompt becomes the following:
C:\Program Files\TIDAL\TESCmdLine\bin>
Step 3 Type SACmd and press the Enter key again.
The prompt changes to SACmd> and remains SACmd> until you exit. You are now in program’s multiple command mode. You can enter TES commands without preceding them with SACmd . For example, entering a command from this mode looks like this:
To exit, enter EXIT and press the Enter key.
Note Verify the Master and Client Manager are up and running before using the Command Line program.
Note Before using sacmd <command>, you can set -persist to save the given URL, user and password in an encrypted file in the user's home directory, so that next time saCmd is started, the URL, user and password will not have to be specified. For further information on on command arguments, refer to the help by running sacmd -help from the bin directory of the Command Line Program home.
Note Once you have entered a SACmd session, you can enter help for an understanding of available commands. For example, SACmd>help.
To start the TES command line interface, enter SACmd at an MSDOS command prompt.
The general format for using SACmd is as follows:
SACmd command -option1 Argument1 -option2 “Argument 2”
where you provide the command, the options and the arguments. For example:
where addrule is the command, n and G are options, alfa is the argument for n , and G has no argument.
Command syntax is listed for each command.
The argument for an option may be required or optional, depending on the command. If you do use an argument, it must follow the option it belongs to.
Options and arguments are case sensitive, but the command is not. If an argument has a space, enclose the argument in quotes. For example,
SACmd addrule -G -a clock -h “Windows Agent”
In the above example, “Windows Agent” is the argument to the -h option. Windows Agent was enclosed in quotes because it contains a space.
The order of the arguments is usually not important. If arguments do need to be given in a specific order, it is stated in the text.
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.
Each listed command may have several sections to explain different aspects of the command.
Usually, when specifying job status in a command, you either specify the job status itself, or you specify its job status ID. For example:
SACmd jobset -i 3245 -s “Completed Abnormally”
It may be easier to specify a job status using a numerical value when you know the status that the numerical value corresponds to. For example, the above command can be typed as:
The following table cross-references each job status as shown in the Tidal Web client with their internal job status number. You can also obtain this information using the liststat command.
The following tables list all the available commands and their description: