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

STATUS (ADAPTER STATUS)

Command code
. Hex 33 - wait option
. Hex B3 - no-wait option

Fields required
. NCB_BUFFER@
. NCB_LENGTH
. NCB_CALLNAME  (local or remote, or * for local)
. NCB_POST@     (if no-wait option used)
. NCB_LANA_NUM  (number of the adapter)

Field returned
. NCB_RETCODE
. NCB_CMD_CPLT
. NCB_LENGTH

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 01    - Invalid buffer length
. Hex 03    - Invalid command
. Hex 05    - Command timed-out
. Hex 06    - Message incomplete
. Hex 0B    - Command canceled
. Hex 15    - Illegal name
. 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 provides status information for a local or remote adapter by the
name specified in the NCB_CALLNAME field. If an asterisk (*) is specified in
the first byte of the NCB_CALLNAME field, the information for the local
adapter is returned. This information is placed in the buffer address speci-
fied, NCB_BUFFER@, and the length field is updated to indicate the number of
bytes of information received.

The miimum number of bytes in the status buffer is 60. The maximum number of
bytes required to hold the status information depends on the number of names
that can be supported. For the maximum values, refer to the specific
implementation ot the NETBIOS that you are using. In general, the number of
required bytes is 60+18X, where X is the number of names added to the adapter.

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