#PRIORITY (set new embed priority level) 

Top  Previous  Next

 

#PRIORITY( number ) [,DESCRIPTION(treedesc) ]

#PRIORITY

Specifies a new priority level for the code following the #PRIORITY statement.

number

An integer constant in the range 1 to 10000.

DESCRIPTION

An optional description of the priority point.

 

treedesc is a string constant or expression that will appear in the embed tree for this priority point.

 

The #PRIORITY statement specifies a new priority number for the code statements following the #PRIORITY.

#PRIORITY is only valid when used in the #AT/#ENDAT structure. It cannot exist within other nested structures contained within the #AT/#ENDAT structure (e.g., #PRIORITY cannot be placed inside of a #CASE/’#ENDCASE which is nested within a #AT/#ENDAT).

Example:

#CONTROL(BrowseList,'Add Browse List controls')

 #AT(%ControlEvent,'?Insert','Accepted'),PRIORITY(5000)  #!Start at priority 5000

GlobalRequest = InsertRecord                              #!Goes into priority 5000

#PRIORITY(8500),DESCRIPTION('Before calling update procedure')

%UpdateProc                                               #!Goes into priority 8500

 #ENDAT

#!

See Also:     #AT (insert code in an embed point) , #EMBED , #CODE , #CONTROL #EXTENSION