User`s guide

Contents lxv
This function is affected by four session option parameters: STRLEN/STREOT, EOT=c,
SRCHALL/SRCHFROM and SRCHFRWD/SRCHBKWD. See Set Session parameters (function 9) for
details on these session options. The first two parameters affect string length and termination, but the
last two directly affect how the Host session presentation space is examined:
Session Option Effect on this Function
SRCHALL, SRCHFRWD
Overrides PS Position parameter and searches from the
beginning of the Host session presentation space for the
specified string. If the string exists, the first instance of
the string is returned.
SRCHALL, SRCHBKWD Overrides PS Position parameter and searches from the
end of the Host session presentation space for the
specified string. If the string exists, the last instance of
the string is returned.
SRCHFROM, SRCHFRWD The search begins at PS Position and moves to the end
of the Host session presentation space. The search ends
when the specified string is found or when the end of
the presentation space is reached.
SRCHFROM, SRCHBKWD The search begins at the end of the Host session
presentation space and moves to the beginning of the
presentation space. The search ends when the specified
string is found or when PS Position is reached.
This function can be used to determine when the Host session is available for input. If your Windows
HLLAPI application is waiting for a specific message or prompt, issue this function until the message
or prompt is found.
You can also use the SRCHFROM session option in combination with this function to find multiple
occurrences of a string in the Host session presentation space.