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 4 10 Number of milliseconds that have elapsed since the Windows was started, up to 49.7 days.