schedule

Specifies the job stream name. With the exception of comments, this must be the first keyword in a job stream, and must be followed by the on keyword.

Syntax

schedule [[folder/]workstation#][folder/]jstreamname

[timezone|tz tzname]

Arguments

[folder/]workstation
Specifies the name of the workstation on which the job stream is launched. The default is the workstation on which composer runs to add the job stream.
[folder/]jstreamname

Specifies the name of the job stream and optionally, the folder that contains the job stream. The name must start with a letter, and can contain alphanumeric characters, dashes, and underscores. It can contain up to 16 characters.

timezone|tz tzname
Specifies the time zone to be used when managing for the job stream. This setting is ignored if the global option enTimeZone is set to no on the master domain manager. For information on time zone settings, refer to Managing time zones.

Comments

In a job stream definition you can set a time zone for the entire job stream by using the timezone keyword in the validity interval or when specifying time restrictions using at, until, or deadline.

You can set also a time zone for a job contained in a job stream by setting keywords at, until, or deadline for that job.

Regardless of whether you are defining a job or a job stream, if you use a time zone in a time restriction, for example at then you must use the same time zone when specifying the other time restrictions, such as deadline and until.

In a job stream definition you can set a time zone for the entire job stream and for the jobs it contains. These time zones can differ from each other, in which case the time zone set for the job is converted into the time zone set for the job stream.

To manage all possible time zone settings, the time zone conversion that is performed when processing jobs and job streams across the HCL Workload Automation network is made respecting the following criteria:
  1. If a time zone is not set for a job within a job stream, then that job inherits the time zone set on the workstation where the job is planned to run.
  2. If a time zone is not set for a job stream, then the time zone set is the one set on the workstation where the job stream is planned to run.
  3. If none of the mentioned time zones is set, then the time zone used is the one set on the master domain manager.

Examples

This is the definition of a time zone of the job sked8 contained in the folder TEST, on workstation sfran on which is set the time zone America/New_York. The time zone set for job2 to run on workstation LA is defined as America/Los_Angeles.
schedule sfran#TEST/sked8 
tz America/New_York
on fr at 1000 + 1 day:
job1
LA#job2 at 1400 tz America/Los_Angeles 
end