N Device Get Characters

Description

Get one or more characters from a socket previously opened. If ICBLL/ICBLH is more than one, then CIOV will call this routine multiple times, fetching a character from the buffer, each time.

Note: It is recommended that you call STATUS prior to this call, so that you can determine if any characters are available to be fetched.

Parameters

• IOCB
• If multiple characters are to be fetched, a pointer to a user buffer must be placed in ICBAL/ICBAH, as well as a length for the buffer in ICBLL/ICBLH

Returns

Standard CIO returns, such as:

• If there are no more characters to fetch, an ERROR 136 is returned.

Examples

BASIC

TBD: I need a good example, here!