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.

Tip

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

Given a IOCB is opened with something like:

OPEN #1,4,0,"N:TCP:192.168.1.8:2000"

The following will fetch the next available byte from the socket, and place in variable A.

GET #1,A

TBD: I need a good example, here!