2.2.1.1. Job Command Details Tab

Shown below is the Job Command Details Tab of the Job Details screen. You reach this Tab by choosing the Job Command Tab on the Job Details screen.



This tab is used to enter the information that describes a specific command you want to run.

Fields on this tab

Run on OS
Choose the operating system that you want to run this job on. Note: You will need an available Agent program running on the selected platform in order to run jobs there.

Run On Agent
Choose a specific Agent to run this job on. You can choose (Any) to run this job on any appropriate available Agent computer.

Start In Path
Use this field to enter the path specification to the command you want to run. Note that the command file must be present or accessible from the Agent computer in order for the job to run.

Command Line
Use this field to enter the actual command file you want to run. For example: DEMOAPP.EXE. This file must be located in the Start In Path specified on the Agent computer.

To run a DOS batch file, use: COMMAND YourDosCommand

COMMAND is a special keyword in the Batch Scheduler system. It is used to denote the command processor on the Agent computer assigned to a job. Under windows 2000, this is CMD.EXE, and under earlier versions of Windows, this is most likely COMMAND.COM. Refer to the section Agent Configure Options for information on configuring the Agent programs value for COMMAND.

Parameters
Use this field to enter any Parameter values which must be passed to the program specified in Command Line above. You may enter any literal values seperated by spaces.

Parameter Substitution
You can use the Pick Parm command button to choose from a predefined list of variable values and Global Variables you have defined in the batch scheduler system. To use a substitution variable, enclose the name in Percent Signs '%'. For example: %DATE('mm/dd/yyyy')% would substitute current date in mm/dd/yyyy format.

Here is a list of predefined substitution parameters that you can use.
BATCHID - ID of the current batch (relates to batch definition).
BATCHINST - Assigned unique instance ID for the batch (relates to batch queue).
BATCHNAME - Name of batch definition
CAL_LAST_ON(CalendarName) - Determine Last Date calendar was an ON day
CAL_LAST_OFF(CalendarName) - Determine Last Date calendar was an OFF day
DATE('dateformat') - Current date in specified format. Refer to appendix for date format info.
DATEADD('interval', number, DATE('dateformat')) - Adds specified interval to specified date.
JOBID - ID of current job (relates to Job Definition)
JOBINST - Assigned unique instance ID for a job (relates to Job Queue)
JOBNAME - Name of Job Definition
TIME('timeformat') - Current time in specified format.

DOS Environment Variables
To use a DOS environment variable, it must be preceeded by an extra % percent sign. ie. %%PATH%.


Send Keys
Batch Scheduler provides you with the ability to 'send' keys to an application after it has started running. This provides support for application which have a front end user interface required to run the application. Below is a list of possible key combinations which can be sent to an application.

Key wanted Sequence to send
========= ===============
BACKSPACE {BS}
BREAK {BREAK}
CAPS LOCK {CAPSLOCK}
DEL {DEL}
DOWN ARROW {DOWN}
END {END}
ENTER {ENTER} or ~
ESC {ESC}
HOME {HOME}
INS {INS}
LEFT ARROW {LEFT}
NUM LOCK {NUMLOCK}
PAGE DOWN {PGDN}
PAGE UP {PGUP}
PRINT SCREEN {PRTSC}
RIGHT ARROW {RIGHT}
SCROLL LOCK {SCROLLLOCK}
TAB {TAB}
UP ARROW {UP}
F1 - F16 {F1} - {F16}

To specify keys combined with any combination of the SHIFT, CTRL, and ALT keys, precede the key code with one or more of the following codes:

Key Code
===== ====
SHIFT +
CTRL ^
ALT ~

Return Code
Batch scheduler can capture Job Return codes using either of two methods. From Operating System or From File. VB applications do not support return codes passed to the operating system. In this case, if you want to check Job return codes, your VB application would need to place a return code in a disk file, and use the From File method.

Valid Return Codes
This field can contain a comma seperated list of valid numeric return codes for a job. A job failure occurs, when a job issues a return code that is not in this list.

Kill Job if Not Responding after/Number of Minutes
Check this checkbox if you would like to have the Agent terminate a program if it stops responding. Use the following field to enter the number of minutes of continuous no response before the Agent will terminate the job and return a failed status.

Max Instances on Agent
Optional. This field can be used to specify the maximum number of instances of the job command can be running on the agent at a time.







   Index     Home