HP 3000 Manuals HP 3000 Manuals
<REFNUM>
Syntax
<REFNUM [item] >
where:
item quoted string, numeric value or IT
Description
<REFNUM> returns the number of an item from the current area which
matches the specified criteria specified by item. If there is more than
one matching item in the current area, <REFNUM> prints a list of the
possible items and prompts the user to choose one. It then returns the
number of the chosen list entry or 0 if the user responds to the list
with "//". If the item does not exist, has been deleted, or the user has
been presented with a list and hasn't chosen anything, <REFNUM> prints an
error message and 0 is returned. <REFNUM> is not available in the
Calendar/Diary area of HP Desk.
See also: <DELETED>, <FIND>, <LAST>, <REF>.
Example
&FORWARD notthere <EQUAL 0 <REFNUM "document">>
If "document" does not exist (that is if REFNUM returns 0) this statement
will cause a jump forward to the label notthere.