JAMS Reference Manual

Contents

Index

DEFINE TRIGGER

Create or replace a Trigger Definition.

Format

DEFINE TRIGGER trigger-name

Parameters

trigger-name
The Name of the Trigger which you want to create or replace.

Description

The DEFINE TRIGGER command is used to create or replace an entire Trigger Definition. The DEFINE TRIGGER command marks the beginning of a Trigger Definition. The JAMS> prompt changes to TRIGGER_DEF> until the Trigger Definition is complete.
Usually, the DEFINE TRIGGER command is part of a JAMS command procedure which contains the entire definition. You can use the EXTRACT TRIGGER command to create a complete DEFINE TRIGGER command procedure.

restrictions

You must be authorized to create or replace Trigger Definitions. Additional security checks are made based upon the contents of the Trigger Definition.

related commands

EXTRACT TRIGGER
SHOW TRIGGER

Qualifiers

/REPLACE
This qualifier is used to specify whether you want to create or replace the Definition. If you omit this qualifier, the Definition will be created if it does not exist and replaced if it does exist. If you specify /REPLACE, an error will be returned if the definition does not exist and no changes will be made. If you specify /NOREPLACE, an error will be returned if the definition exists and no changes will be made.

Syntax Diagram

The complete syntax for a Trigger definition is:
DEFINE TRIGGER trigger-name

DESCRIPTION quoted-string

AUTO RESET

event-specification...

action-specification...

END_TRIGGER

The syntax for an event specification is:
EVENT

job-event
variable-event

END_EVENT

Where job-event is:
JOB job-name SEVERITY

SUCCESS
INFORMATIONAL
WARNING
ERROR
FATAL
OR

BETTER
WORSE

and variable-event is:
VARIABLE variable-name

CHANGED
TRUE
FALSE
= value
< value
> value
<= value
>= value
<> value

The syntax for an action specification is:
ACTION SUBMIT JOB job-name

DATE date-specification

TIME time-specification

HOLD

END_ACTION

Contents

Index