Create Schedule Job


Schedules a task.

Warning

Note

This workflow is available only for use in Microsoft Windows environments.

 Workflow inputs – Create Schedule Job

Call Workflow Input

Description

Required

Default Value

connection details

XML document conforming to the Connection Details common object that contains the information required to execute a command via command line.

Yes

n/a

task name

Specifies a name for the task.

 

Valid value: unique name not exceeding 238 characters.

 

Warning

Note

Quotation marks must be used to enclose names that include spaces.

Yes

n/a

task run

Specifies the program or command that the task runs.

 

Warning

Note

The fully qualified path and file name of an executable file, script file, or batch file must be provided. The path name must not exceed 262 characters.

Yes

n/a

runas user

Runs the task with permissions of the specified user account.

Yes

n/a

runas password

Provides the password for the user account that is specified in the /ru Domain/User parameter.

Yes

n/a

idle time

Specifies how many minutes the computer is idle before the task starts.

 

Valid value: Whole number from 1 to 999

Yes

n/a

 

schedule type

Specifies the schedule type.

 

Valid values:

  • MINUTE
  • HOURLY
  • DAILY
  • WEEKLY
  • MONTHLY
  • ONCE
  • ONSTART
  • ONLOGON
  • ONIDLE

Yes

n/a

modifier

Specifies how often the task runs within its schedule type.

No

1

day

Specifies a day (or days) of the week or a day (or days) of a month.

No

1

month

Specifies a month or months of the year to run scheduled task.

 

Valid values: JAN – DEC, * – every month)/

 

Warning

Note

The /m parameter is valid only with a MONTHLY schedule. It is required when the LASTDAY modifier is used. Otherwise, it is optional and the default value is * (every month).

Conditional

There is no default value.

idle time

Specifies how many minutes the computer is idle before the task starts.

 

Valid value: Whole number from 1 to 999

 

Warning

Note

Parameter only valid with ONIDLE schedule, then it is required.

No

There is no default value.

start time

Specifies the time of day that the task starts (each time it starts) in HH:MM 24–hour format.

 

Warning

Note

The /st parameter valid with MINUTE, HOURLY, DAILY, WEEKLY, MONTHLY, and ONCE schedules. It is required for a ONCE schedule.

No

The default value is current time on local computer.

interval

Specifies the repetition interval in minutes.

 

Valid range: 1 to 599940 minutes (599940 minutes = 9999 hours)

 

Warning

Note

Not applicable for schedule types: MINUTE, HOURLY, ONSTART, ONLOGON, ONIDLE. If either /ET or /DU is specified, then the repetition interval defaults to 10 minutes.

Conditional.

n/a

end time

Specifies the time of day that a minute or hourly task schedule ends.

Valid 24–hour time format: HH:MM.

No

In absence of value job runs infinitely.

duration

Specifies maximum length of time for minute or hourly schedule in HHHH:MM 24–hour format.

No

In absence of value job runs infinitely.

start date

Specifies the date on which the task schedule starts.

 

Valid date format: mm/dd/yyyy

 

Warning

Note

Format set by selected locale on local computer.

No

 

end date

Specifies the date on which the schedule ends. This parameter is optional.

 

Warning

Note

Format for __ <end date> varies with the selected locale on local.

No

In the absence of a value for this input the job runs infinitely.

 

 Workflow outputs – Create Schedule Job

Call Workflow Output

Description

output

XML document consisting of one or more <line> elements that contain the command response. Each <line> element contains an index attribute indicating the order in which the information was returned by the command.

success

Did the operation succeed?

 

Valid values: true, false

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

TrueSight Orchestration Content 21.02