Use LocateStamp to move the cursor forward (toward the bottom) from the current line to the first line with a stamp satisfying the specified criteria.
LocateStamp may also be entered as LocateSt[amp] or LocSt[amp].
Optional Operands
DATE specifies a date range (see Date Range). Lines with stamps outside this date range are ignored.
If DATE is specified as an asterisk (*), all lines containing stamps will be considered.
Default: *.
USER specifies the user ID a stamp must contain in order for a given line to be considered. Lines with stamps created by another user ID will be ignored.
If USER is specified as an asterisk (*), all lines containing stamps will be considered.
Default: *.
The search begins with the line after the current line and proceeds until a match is found. If a match is found, the cursor will be positioned at the match. An error message will be displayed if no match is found. The repeat-command symbol (&) before the LocateStamp command, (as shown in => &locatestamp) is useful to conduct the search, while stopping at all lines with stamps.
A long-running LocateStamp can be interrupted by pressing Ctrl-Break.
Return Codes
OK Successful.
AT Command interrupted by user (Ctrl-Break pressed).
NF Stamp not found.
Procedure Notes
LocateStamp sets the pre-defined variable SslCsRow to the row where the stamp is found.
Examples
Search for the next line containing a stamp:
=> locst
Search for the next line containing a stamp created during January 1998:
=> locst 01/01/98-01/31/98
Search for the next line containing a stamp created by user KXL:
=> locst ,kxl
Search for the next line containing a stamp created on or after January 1, 1998:
=> locst 01/01/98-*