HP 3000 Manuals

<FIND> [ HP DeskManager Customization ] MPE/iX 5.0 Documentation


HP DeskManager Customization

<FIND> 

Syntax 

<FIND [subject] [creator] [start [itemtype]] >

where:

subject               quoted string
creator               quoted string
start                 numeric value in the range 0 to 4096
itemtype              numeric value

Description 

<FIND> returns the sequence number from the current area of the first
item found that satisfies the optional criteria.  If none of the above
options are given, <FIND> will return the sequence number of the first
item in the area (which might not be 1 if item 1 has been deleted).  The
subject parameter represents a subject string (possibly partial).  The
creator parameter represents the creator's surname.  The start parameter
provides an item number the search is to start from.  The itemtype 
parameter specifies that only items with the given MPE item type should
be included in the search.  The possible values for itemtype can be found
in the file FILETYPE.PUB.HPOFFICE. If no item in the area satisfies the
given criteria, <FIND> returns 0.  The subject and creator parameters can
be omitted by the use of null strings ("").  If you wish to use itemtype 
then you should always put in a value for the start parameter.

See also:  <LAST>, <REF>, <REFNUM>.

Example 

     &SAVE i <FIND "" <VAR name>>

This finds the next item in the current area which was created by the
person whose name is stored in the variable name.



MPE/iX 5.0 Documentation