Int 61 Fn 0001  - Banyan Vines - "sosock" - Open Communications Socket     [N]

   AX = 0001h subfn 0001h
   DS:DX -> communications control block (function 0001h) (see #2997)

Return: AX = status (0000h-0002h,0098h,009Eh-00A2h) (see #2996)
Range: INT 60h to INT 66h

Note:  The Banyan interrupt handler is identified by the string "BANV" in
     the four bytes immediately preceding the interrupt handler

See Also: AX=0001h/SF=0002h,AX=0001h/SF=0008h,INT 15/AX=DE2Eh

(Table 2996)
Values for VINES status:
 0000h successful
 0001h service not installed
 0002h invalid service ID
 0003h invalid function
 0004h-000Ah reserved for BANV interface errors
 0097h invalid socket identifier
 0098h resource already in use
 009Bh destination node unreachable
 009Ch message overflow
 009Dh destination socket nonexistent
 009Eh address family does not exist
 009Fh socket type does not exist
 00A0h protocol does not exist
 00A1h no more sockets available
 00A2h no more buffer space available
 00A3h timeout
 00A5h resource not available
 00A6h internal communication failure
 00B1h resource disconnect

Format of VINES control block to open socket:
Offset Size    Description (Table 2997)
 00h   WORD    0001h
 02h   WORD    pointer to argument block
 04h   WORD    error return code
 06h  4 BYTEs  reserved

See Also: #2998

Format of VINES argument block for opening socket:
Offset Size    Description (Table 2998)
 00h   WORD    pointer to 2-byte buffer for socket identifier
 02h   WORD    address family
       0003h Banyan
 04h   WORD    socket type
       in address family 0003h
           0001h IPC socket
           0002h SPP socket
 06h   WORD    protocol number
       FFFFh default
 08h   WORD    pointer to 16-byte buffer for socket address (see #2999)
 0Ah   WORD    local port number
       0000h if service should assign transient port number
       0001h to 01FFh well-known port number (assigned by Banyan)

See Also: #2997

Format of Banyan VINES IPC port:
Offset Size    Description (Table 2999)
 00h   WORD    address family (always 0003h for Banyan ports)
 04h  4 BYTEs  network number (server's serial number)
 06h   WORD    subnet number  (0001h = server, 8000h-FFFEh = PC)
 08h   WORD    port ID (0001h-01FFh for "well-known" ports)
 0Ah   BYTE    hop count
 0Bh  5 BYTEs  filler

See Also: #3004