Int 2F/AX=C502h

Prev Next Ralf Interrups Categories Contents

------

PC-DOS Econet v1.05 - PERFORM NETWORK OPERATION

AX = C502h
DS:DX -> control block (see #03036)

Return:
AX = return code (see #03037) (same as returned in control block)

Note: The interrupt-enable state will be preserved, but interrupts may be enabled during processing of this function

See Also: AX=C500h

Format of Econet control block: Offset Size Description (Table 03036) 00h DWORD -> command block (see #03038) 04h WORD length of transmit data block 06h DWORD -> transmit data block 0Ah WORD length of reply block (set to 0000h prior to call) 0Ch DWORD -> reply block 10h WORD return code (set to 0000h prior to call) (see #03037) 12h DWORD reserved for Econet use

(Table 03037) Values for Econet return code: 0000h successful 0001h bad command in command block 0002h no handles left 0003h bad handle 0004h bad argument in command 0005h buffer too small 0006h kill condition failed 0007h control block in use 007Fh command aborted 01xxh retryable board error XXh 02xxh fatal board error XXh 0300h invalid subfunction number in AL 0301h timeout 03xxh other driver errors

See Also: #03036

Format of Econet command block: Offset Size Description (Table 03038) 00h BYTE command code (see #03039) ---command 00h--- 01h BYTE direction (00h = read initialization data, 01h = set init data) 02h WORD "TxCB" transmit control block size 04h WORD "RxCB" receive control block size

Notes: TxCB and RxCB are always the same size in v1.05, permitting any CB to be used for either receive or transmit this command should not be used by applications to set the buffer sizes 06h 6 BYTEs padding (0) ---command 01h--- 01h BYTE port number (00h = receive on all ports) if the RxCB is opened for RPC, the port number indicates the allowable RPC (see #03040) 02h WORD station number (FEFFh = broadcast) 04h BYTE RPC flags

bit 7:
CB is open for RPCs only

bit 6:
Restrict to RPC number given in next field 05h WORD RPC number 07h BYTE timeout in 1/2-second units (00h = never) if a timeout occurs, the RxCB can still receive data, and may generate another event after the timeout unless it is explicitly killed 08h 4 BYTEs padding (0) ---command 02h--- 01h BYTE control byte 02h BYTE port number 03h WORD station number 05h BYTE number of retries 06h WORD length of data to be sent (bits 14-0), 0000h allowed if bit 15 is set, no data will be transferred, but this field will be updated (needed for peeking) 08h DWORD -> destination address on remote machine ---command 03h--- 01h BYTE Control Block Handle FEh first filled-in RxCB FFh first TxCB which has been sent 02h 10 BYTEs padding (0) ---command 04h--- 01h BYTE Control Block Handle 02h BYTE kill condition 00h always 01h kill only if bit7 of control byte is clear 81h kill only if bit7 of control byte is set 03h 9 BYTEs padding (0)

Notes: Control blocks are not freed until explicitly killed because all TxCBs for a given destination are stored on a separate subchain, it is necessary to kill all failed TxCBs to a given destination before any new ones are opened to that destination ---command 06h--- 01h BYTE Control Block Handle 02h WORD starting byte within CB to read 04h WORD number of bytes if 0000h or greater than remaining bytes in CB, return all bytes from starting byte to end of CB 06h 6 BYTEs padding (0) ---command 07h--- 01h BYTE subfunction 00h-0Fh get/set M/C type (bit N=1 indicates to set byte N) four data bytes 10h get station number 11h set station number 12h get Tx pause in 5ms units (default 20) 13h set Tx pause 14h get software version numbers 16h get event enable mask 17h set event enable mask 18h get number of non-volatile bytes available 80h+2N get non-volatile byte N 81h+2N set non-volatile byte N 02h var new data

Note: All command blocks should be padded to twelve bytes with zeros if needed

See Also: #03036

(Table 03039) Values for Econet command code: 00h initialize 01h open receive 02h open transmit 03h poll 04h kill 06h read 07h get/set system parameters

See Also: #03038

(Table 03040) Values for Econet RPC type: 00h all 81h peek 82h poke 83h remote JSR 84h remote procedure call 85h OS procedure 86h Halt 87h Continue

See Also: #03038

Format of Econet Reply Block (command 00h): Offset Size Description (Table 03041) 00h WORD TxCB size (default is 0500h, the maximum Econet packet length) 02h WORD RxCB size 04h BYTE number of TxCBs allocated 05h BYTE number of RxCBs allocated

See Also: #03036 - #03042 - #03044

Format of Econet Reply Block (commands 01h,02h): Offset Size Description (Table 03042) 00h BYTE control block handle

See Also: #03036 - #03041 - #03045

Format of Econet Reply Block (command 03h): Offset Size Description (Table 03043) 00h BYTE CB number (when wildcard specified for poll) 01h BYTE control (RxCB) 00h until received, then Sent Control byte (TxCB) transmit status

bit 7:
Transmission pending

bit 6:
Transmission failed

bits 3-0:
Error number 02h BYTE Port number 03h WORD station number 05h WORD length 07h WORD 0000h

See Also: #03036 - #03041 - #03044

Format of Econet Reply Block (command 06h): Offset Size Description (Table 03044) 00h N BYTEs data read from network

See Also: #03036 - #03043 - #03045

Format of Econet Reply Block (command 07h): Offset Size Description (Table 03045) 00h N BYTEs returned information

See Also: #03036 - #03044

Category: Network - Int 2Fh - P

------

Prev Next Ralf Interrups Categories Contents

Sponsors
Shopping
Forum
Forum
email
EMail
Index
Index
Home
Home

Search the web with Google
Google
Google
Google

------