NCBRECVANY

NCBRECVANY

This command receives data from any session corresponding to the specified name. This command can also be used to receive data destined for any local name by setting the ncb_num field to 0xFF. Otherwise, simply set ncb_num to the network number returned from adding a name to the local name table. Then any data pending for that particular name will be picked up by this command. Also, a precedence order exists for when multiple receive commands are outstanding. See the entry for NCBRECV for more details.

When a session is closed by a local session close command, by the remote side closing the session, or by a session abort command, any outstanding NRCRECVANY commands for the specified name complete with the error NRC_SCLOSED (0x0A); the ncb_lsn field of the NCB structure is set to the local session number that was terminated. If no NCBRECVANY commands for that closed session are pending for the specified name and an outstanding NCBRECVANY command exists for any session (ncb_num is 0xFF), that command completes with the error NRC_SCLOSED and with the ncb_lsn field set to the corresponding session number. Table 22-19 describes the characteristics of the NCBRECVANY command.

Table 22-19 NCBRECVANY

Field	In/Out	Required
ncb_command	In	X
ncb_retcode	Out
ncb_lsn	Out
ncb_num	In/Out	X
ncb_buffer	In	X
ncb_length	In/Out	X
ncb_callname
ncb_name
ncb_rto
ncb_sto
ncb_post	In
ncb_lana_num	In	X
ncb_cmd_cplt	Out
ncb_event	In