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 will 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 will complete with the error NRC_SCLOSED and with the ncb_lsn field set to the corresponding session number.
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 |