IB Statements/dstat

From CometWiki

< IB Statements
Revision as of 12:24, 22 May 2009 by Badge (Talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

DSTAT function

Syntax: DSTAT(device-name [,EXCP=statement-label])

Discussion: The DSTAT function returns the current status of system devices.

The device-name is the name of the device to be checked. The device-name may be a string constant, a single-element string variable, a string array element, a string expression, or a string function.

Detailed information: DSTAT of the console

DSTAT of remote terminals
DSTAT of a local printer
DSTAT of a remote printer
DSTAT of a spooler
DSTAT of the system driver (X00)
DSTAT of a gateway
DSTAT of a directory
DSTAT of the clock


DSTAT of the console:

Position  Length    Description/Values
============================================================
1         3         Partition
4         1         Type
                    0 = Monochrome
                    1 = Color
                    2 = Monochrome with flicker-free adapter
                    3 = Color with flicker-free adapter
                    4 = EGA/VGA/MCGA Monochrome
                    5 = EGA/VGA/MCGA Color
                    6 = TeleVideo
                    7 = AT&T
5         1         Option
                    01H = Force 80-column mode
                    02H = Force CR the same as Qantel
                    04H = Auto increment cursor
                    08H = FAST option enabled for all files
                    10H = Insert key is the same as Qantel
                    20H = Use expanded memory for all partitions
                    40H = Standard I/O for keyboard
6         1         Status
7         1         Foreground attribute (color)
8         1         Background attribute (color)
9         1         Invisible attribute (color)
10        1         Border attribute (color)
11        1         Entry attribute (color)
12        2         Base address
14        2         Current column and row
16        1         BIOS mode for 132-column
17        1         Current number of columns on screen
21        1         Returns "@01@" if the session is CometAnywhere

DSTAT of remote terminals:

Position  Length    Description/Values
===================================================================
1         3         Partition
4         1         Type
                    80H = dumb terminal
                    81H = TeleVideo terminal
                    82H = Ampex terminal
                    83H = Qantel VT3 terminal
                    84H = Qantel VT6 terminal
                    86H = QTerm workstation
                    F0H = Intermec bar code reader
                    FEH = RDI printer
                    FFH = ignored terminal
5         1         not used
6         1         Status
7         1         UART
8         1         Poll address
9         1         Terminal flag
!
                    80H  OBP Terminal Lockout (Signal to PC that FG
                         processing loop is active on this terminal
                         and effectively locks out PC from changing
                         anything in the term table.)
!
                    20H  Status Poll Hold Request (PC signals don't
                         do status poll on this terminal.)
!
                    10H  Select Request (OBP should initiate a
                         select poll (data is in the buffer)
!
                    08H  Buffer In Use Flag (OBP should not
                         initiate a data poll)
!
                    04H  Data Poll Ack Request (PC has received the
                         data and the buffer is clear)
!
                    02H  Reset Request (user has hit Escape)
!
                    01H  Data Poll Request
!
10        1         Terminal process
!
                    Foreground Attention Needed
                    0  = IDLE - Dead terminal
                    1  = IDLE - Active terminal
                    2  = Status Poll Complete
                    8  = Waiting to send buffer to PC
                    9  = Finished select - OK
                    A  = Finished select - NG
                    B  = Data poll complete (ACK included)
!
                    UART is Working on this one
                    10H  = Doing status poll
                    11H  = Receiving data from terminal
                    12H  = Sending data to terminal
                    13H  = Retransmitting to terminal (1st
                    retransmit)
                    14H  = Retransmitting to terminal (2nd
                    retransmit)
                    15H  = Terminal reset in progress

DSTAT of a local printer (effective with build 319):

Position  Length    Description
=========================================
1         3         owning partition, if any
4         1         printer type in hex: 0=Local; 4=Windows
5         1         spool type in hex
                    To convert the type, take the HEXASC of the byte.
                    Look at the first character returned by HEXASC:
                    '6'=Auto-spool; 'A'=Exception spool; '2'=Non-spool
6         12        spooler alias name
18        237       pathname associated with the printer

DSTAT of a remote printer:

Position  Length    Description
=========================================
1         3         Partition
4         1         Type
5         1         Spool Type
6         1         Status
7         1         UART
8         1         Poll Address
9         1         Terminal Flag
10        1         Terminal Process
11        1         ROM Version

DSTAT of a spooler:

Position  Length    Description
=====================================
1         64        DOS path name


DSTAT of the system driver (X00):Position Length Description

===================================================
1         32        (reserved)
33        16        Network node name
49         2        Number of the of first partiton
                    on the node (byte-reversed hex)
51         2        Total number of partitions on
                    the node (byte-reversed hex)
53         1        "@01@" if the user has a COM license; "@00@" otherwise


DSTAT of a gateway:

Position  Length    Description
=============================================
1         3         Controlling partition
4         1         Gateway type (hex)
5         1         Gateway subtype (hex)

DSTAT of a directory:

Position  Length    Description
======================================
1         3         Directory name
4         64        DOS path name

DSTAT of the clock:

Position  Length    Description
===================================
1         3         Clock name
Personal tools