Use LocateStampUp to move the cursor backward (toward the top) from the current line to the first line with a stamp satisfying the specified criteria.
LocateStampUp may also be entered as LocateStampU[p], LocateStU[p], LocStampU[p], or LocStU[p].
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 preceding the current line and proceeds upward until a match is found. An error message will display if no match is found. If a match is found, the cursor will be positioned at the match. The repeat-command symbol (&) before the LocateStampUp command (as in => &locatestampu) provides a useful way to search, while stopping at all lines containing stamps.
A long-running LocateStampUp 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
LocateStampUp sets the pre-defined variable SslCsRow to the row where the stamp is found.
Examples
Search for the previous line containing a stamp:
=> locstu
Search for the previous line containing a stamp created during January 1998:
=> locstu 01/01/98-01/31/98
Search for the previous line containing a stamp created by user KXL:
=> locstu ,kxl
Search for the previous line containing a stamp created on or after January 1, 1998:
=> locstu 01/01/98-*