ETTSTART – Trigger definition

Use the ETTSTART statement to define an entire Event Trigger record.

A statement begins with ETTSTART and can be followed by the following additional arguments.

Table 1. Keywords for ETTSTART
Keyword Description
ETTNAME Specifies the name of a job or a special resource, up to 44 characters.

You can also use the wildcards asterisk (*) and percent sign (%) to specify a generic name.

ETTTYPE Specifies the type of event that you want to cause a dynamic update of the current plan. Required.
J
A job reader event is the triggering event.
R
A special resource availability event is the triggering event.
ADID Specifies the name of an application defined in the application description (AD) database that you want adding to the current plan when the event occurs.
AS Availability status switch indicator. Valid only with ETTTYPE(R). Indicates if ETT adds an occurrence only if there is a true availability status switch for a special resource from status Available=N to Available=Y, or if ETT adds an occurrence each time the availability status is set to Available=Y (regardless of the previous status of the special resource).
For ETTTYPE(J) this field must have the value N or blank.
Y
ETT adds an occurrence only when there is a true availability status switch from status Available=N to Available=Y.
N
ETT adds an occurrence each time the availability status is set to Available=Y.
DR Specifies the dependency resolution, which determines if external dependencies should be added when occurrences are added to the current plan.
Y
External dependencies are to be added.
N
External dependencies are not to be added.
P
Add only predecessor dependencies.
S
Add only successor dependencies.
JR Specifies job-name replace, which is valid only with ETTTYPE(J). This determines if the job name of the first operation in the associated application should be replaced with the triggering job.
Y
The name of the first operation is replaced by the job name of the triggering job.
N
The application is added unchanged.
MATCHTYP This argument is needed when spaces, asterisks (*) or percent signs (%) form part of the name of the object, to indicate how to treat the special characters.
EXA
Use the name exactly as typed, treating asterisks (*) and percent signs (%) as characters to include in the name.
PFX
Treat as a prefix match, to find an item beginning with what was typed but treating asterisks (*) and percent signs (%) as characters included in the name.
SFX
Treat as a suffix match, to find an item ending with what was typed but treating asterisks (*) and percent signs (%) as characters included in the name.