JAMS Reference Manual
Contents Index JAMS Home Support

JAMS Reference Manual


Previous Contents Index

1.5 Trigger Definitions

Triggers are used to define event based schedules. A Trigger consists of a list of events and a list of actions. When JAMS sees that all of a Trigger's events are true, it will perform the list of actions. With this version of JAMS, the only supported action is to submit a job.

Triggers can be maintained with the screen or Motif based interfaces.

Trigger Name

The Trigger Name is a unique identifier for a Trigger.

A Trigger Name must be a valid OpenVMS identifier. This means that it must begin with an alphabetic character and contain only the characters A-Z, 0-9, $ (dollar sign), and _ (underscore). Also the last character may not be an underscore.

Description

The description is used in lists and reports to provide a more complete description of the Trigger.

Reset When Fired

This is a Y (yes) or N (no) field which specifies whether or not this Trigger should be reset when it is fired. When a Trigger is fired, it will not be fired again until it has been reset. If you enter a N into this field, the Trigger will not be reset when it is fired and must be manually reset with the RESET TRIGGER command.

Status

This is a display only field which shows the current status of the Trigger. Possible values are:
Enabled The Trigger is enabled and ready to be fired.
Disabled The Trigger has been disabled with the DISABLE TRIGGER command. It will not be fired.
Fired The Trigger has been fired and has not yet been reset.

Last Fired

This is a display only field which shows the date and time that this Trigger was last fired.

Last Reset

This is a display only field which shows the date and time that this Trigger was last reset.

1.5.1 Events

There are two types of Events: Job Completion Events and Variable Value Events.

A Job Completion Event is true if the specified Job has completed with the specified severity level since the last time that the Trigger was reset.

A Variable Value Event is true or false based strictly upon the value of the specified variable. There is no relation to the Trigger's last reset time.

Note that the order of events is not important.

1.5.1.1 Job Completion Events

Job Name

This is the name of the JAMS Job which this event will depend upon.

Severity

This is the minimum, or maximum, severity needed to cause this event to be true.

Note that if you intentionally delete a job from the schedule, it will not cause a Trigger event to be true.

Better or Worse

This field must be either B (better) or W (worse) and is used in conjunction with the Severity field to determine if an instance of the specified Job should cause this event to be true.

1.5.1.2 Variable Value Event Fields

Variable Name

This is the name of the JAMS Variable which this event will depend upon.

Condition

This is the boolean operator or code used to define how the comparison will be performed. Press the [Find] key to display a list of the valid conditions.

Comparison

This is the value which the Variable will be compared to. This field has no meaning if the condition code is "Changes".

1.5.2 Actions

Each Trigger Action is a Job which will be submitted when the Trigger fires.

Job Name

This is the name of a Job which will be submitted when this Trigger is fired. It must be a valid Job and you must have SUBMIT access to the Job.

Submit Date/Submit Time

You can use the Submit Date and Submit Time fields to specify when this Job should be scheduled to run, once the Trigger fires.

Submit on Hold

This field must be either Y (yes) or N (no) and specifies whether or not this Job should be placed in a "holding" state when it is submitted.

OpenVMS Username

The OpenVMS Username under which this Job will be submitted is shown in a display only field. If this Job's System I.D. specifies a OpenVMS Username, it is used. Otherwise the Username is the Username of the last person to modify this Trigger.


Previous Next Contents Index
JAMS Copyright © 2000, MVP Systems, Inc. All rights reserved.