Click above to get retro games delivered to your door ever month!

RECEIVE DATAGRAM

Command code
. Hex 21 - wait option
. Hex A1 - no-wait option

Fields required
. NCB_BUFFER@
. NCB_LENGTH
. NCB_NUM       (if this field is hex FF, then recive a datagram from any
                other name for any of your names)
. NCB_POST@     (if no-wait option is used)
. NCB_LANA_NUM  (number of the adapter for the receive datagram)

Field returned
. NCB_RETCODE
. NCB_LENGTH
. NCB_CALLNAME
. NCB_CMD_CPLT

Immediate return codes
. Hex 00    - Command has no immediate errors
. Hex 03    - Invalid command
. Hex 21    - Interface busy
. Hex 22    - Too many commands outstanding
. Hex 23    - Invalid number in NCB_LANA_NUM field
. Hex 40/4F - Unusual network condition
. Hex 50/FE - Adapter malfunction

Final return codes
. Hex 00    - Command complete
. Hex 03    - Invalid command
. Hex 06    - Message incomplete
. Hex 0B    - Command canceled
. Hex 13    - Invalid name number
. Hex 17    - Name deleted
. Hex 19    - Name conflict detected
. Hex 21    - Interface busy
. Hex 22    - Too many commands outstanding
. Hex 23    - Invalid number in NCB_LANA_NUM field
. Hex 40/4F - Unusual network condition
. Hex 50/FE - Adapter malfunction

Function
This command receives a datagram message from any name on the network directed
to you. There is no time-out associated with this command. If you do not have
a Receive Datagram command outstanding at the time a Send Datagram command is
issued, you will not receive the data.

This command does not receive a broadcast datagram but will receive a datagram
sent to a group name.

Note: A return code of hex 06 is returned in the NCB_RETCODE field if the
      receive buffer is not large enough for the data being sent. The
      remaining data is lost at this point.