Int 21 Fn 2B44  - Pcanywhere Iv/lan - Installation Check                   [R]

   AX = 2B44h ('D')
   BX = 4D41h ('MA')
   CX = 7063h ('pc')
   DX = 4157h ('AW')

Return: AX = resident program
       4F4Bh ('OK') if large host resident
       6F6Bh ('ok') if small host resident
   CX:DX -> API entry point (see #1077)

See Also: INT 16/AH=79h

(Table 1077)
Call pcANYWHERE API entry point with:
   AX = 0000h get pcANYWHERE IV version
       DS:SI -> BYTE buffer for host type code

       Return: AH = version number
           AL = revision number
           DS:DI buffer byte filled with
           00h full-featured host
           01h limited-feature LAN host
           other API may not be supported
   AX = 0001h initialize operation
       DS:SI -> initialization request structure (see #1078)

       Return: AX = function status (see #1081)
   AX = 0002h get status

       Return: AH = current operating mode (see #1078)
           AL = current connection status (see #1080)
   AX = 0003h suspend remote screen updates

       Return: AX = function status (see #1081)
   AX = 0004h resume screen updates

       Return: AX = function status (see #1081)
   AX = 0005h end current remote access session
       DS:SI -> termination request structure (see #1079)

       Return: AX = function status (see #1081)
   AX = 0006h remove pcANYWHERE IV from memory

       Return: AX = status (see #1081)
   AX = 8000h read data from communications channel
       DS:BX -> buffer
       CX = buffer size

       Return: AX >= number of characters read/available
           AX < 0 on error
   AX = 8001h write data to communications channel
       DS:BX -> buffer
       CX = buffer size

       Return: AX >= number of characters written
           AX < 0 on error
   AX = 8002h get connection status

       Return: AX = status
           > 0000h if connection active
           = 0000h if connection lost
           < 0000h on error

Format of pcANYWHERE initialization request structure:
Offset Size    Description (Table 1078)
 00h   BYTE    operating mode
       00h wait for a call
       01h hot key activates
       02h incoming call activates
       03h initiate a call
 01h  3 BYTEs  user ID to append to config file names
 04h   WORD    DS-relative pointer to path for config files
 06h   WORD    DS-relative pointer to path for program files

Format of pcANYWHERE termination request structure:
Offset Size    Description (Table 1079)
 00h   BYTE    operating mode after termination
       00h wait for a call
       01h hot key activates
       02h incoming call activates
       80h use current mode
       FFh remove from memory

Bitfields for current connection status:
Bit(s) Description (Table 1080)
 0 a physical connection is active
 1 remove screen updating is active
 2 connection checking is active
 3 hot key detection is active
 4 background file transfer is active

(Table 1081)
Values for pcANYWHERE function status:
 0000h function completed successfully
 FFD1h unable to release interrupt vectors
 FFD2h unable to release allocated memory
 FFF2h unable to establish a connection when operating mode is
     "Initiate a call"
 FFF3h modem configuration is invalid (corrupt config)
 FFF4h modem initialization failed (no modem response)
 FFF5h the communications device could not be initialized
 FFF6h the host operator aborted the function
 FFF7h the communications driver type specified in the configuration file is
     different than the one loaded when pcANYWHERE IV was started
 FFF9h the configuration file is invalid
 FFFAh the configuration file could not be found
 FFFBh no session is active
 FFFCh a remote access session is active
 FFFDh the specified operating mode is invalid