Define Action Routine for Verb

This Subroutine defines an Action Routine for the currently setup Verb within the currently setup Verb Group. Whenever this verb is selected (either explicitly by the Operator typing it, or implicitly by the Operator selecting a Menu Button having this verb associated with it), the specified Subroutine will be called automatically.

Short Name Calling Sequence

STATUS = UIDFAC(ACTION)

Long Name Calling Sequence

STATUS = UI_DEFINE_ACTION(....)

Input Arguments

ACTION (see notes) Action Subroutine Name

Output Arguments

None

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_VERB ) Illegal Verb UIILVB ) Note:

1. The ACTION Argument should be the name of the required Action Routine and must be declared EXTERNAL within the calling program.
2. The specified Action Routine will be associated with the currently setup Verb. If association with other Verbs is also desired, this must be performed explicitly by calling this routine multiply, with prior calls to UI_DEFINE_VERB (or UI_USE_VERB) and UI_DEFINE_GROUP (or UI_USE_GROUP) as appropriate.