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

RECEIVE ANY

Command code
. Hex 16 - wait option (use this carefully because it does not time out)
. Hex 96 - no-wait option

Fields required
. NCB_BUFFER@
. NCB_LENGTH
. NCB_NUM       (if this field if hex FF, you receive from any remote name
                with whowm there is a session)
. NCB_POST@     (if no-wait option is used)
. NCB_LANA_NUM  (number of the adapter you want to receive for any name)

Field returned
. NCB_LSN
. NCB_RETCODE
. NCB_NUM       (if hex FF is specified)
. NCB_LENGTH
. 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 08    - Invalid local session number
. Hex 0A    - Session closed
. Hex 0B    - Command canceled
. Hex 13    - Invalid name number
. Hex 17    - Name deleted
. Hex 18    - Session ended abnormally
. 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 data from anyone with whom you have a session. You must
use your name number instead of your name when issuing this command. Your name
number (NCB_NUM) was returned when you issued the Add Name or Add Group Name
command. If you specify hex FF in the NCB_NUM field, you receive from anyone
with whom you have a session for any of your names. If more than one Receive
command is outstanding, they are completed in a first-in-first-out (FIFO)
order according to the following hierarchy: Receive, Receive any for a
specified name, and Receive Any for any name.

If a session is closed by the local or remote node, or if the session ends
abnormally, only one receive Any command for that session will have a final
code returned regardless of the number pending. If a Receive Any command to a
name is pending, it is posted as "session closed" with the  NCB_LSN field
indicating the session that closed. A Receive Any command with no name
specified is posted only if no Receive Any command to a name is pending for
that session 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 message being sent.
      You can issue another Receive command to obtain the rest of the
      information.

Application programs should not use a Receive Any command to any name unless
they wish to receive messages intended for other programs running in the
system.