The $ZGETDVI function returns an item of information about a specified device. The $ZGETDVI function is analogous to the DCL Lexical function F$GETDVI.
The format for the $ZGETDVI function is:
$ZGETDVI(expr1,expr2)
The first expression specifies the target device
The second expression specifies the item keyword identifying the type of information returned; keywords may be upper-, lower-, or mixed-case
$ZGETDVI() provides a tool for examining the characteristics of devices in the VMS environment from within GT.M. There are three instances when the values returned by F$GETDVI and $ZGETDVI are not identical. They are noted in the following table.
|
ZGETDVI() Item Keywords - all devices |
|
|
ITEM KEYWORD |
$ZGETDVI() DATA RETURNED |
|
ACPPID ACPTYPE ALL ALLDEVNAM AVL |
ACP process identification ACP type code Device is allocated: 1 if true, 0 if false Allocation class device name Device is available: 1 if true, 0 if false |
|
CCL CLUSTER CONCEALED CYLINDERS DEVBUFSIZ |
Device has carriage control: 1 if true, 0 if false Volume cluster size Device is concealed: 1 if true, 0 if false Number of cylinders on the volume Device buffer size |
|
DEVCHAR DEVCHAR2 DEVCLASS DEVDEPEND DEVDEPEND2 |
Device characteristics More device characteristics Device class Device-dependant information More device-dependant information |
|
DEVLOCKNAM* DEVNAM DEVSTS DEVTYPE DIR |
Device lock name (character string) Device name Device-dependant status information An integer represnting the device type Device is directory-structured: 1 if true, 0 if false |
|
DMA DMT DUA ELG ERRCNT |
Device has DMA: 1 if true, 0 if false Device is marked for dismount: 1 if true, 0 if false Device is a generic device: 1 if true, 0 if false Error logging is enabled: 1 if true, 0 if false Error count |
|
FOD FOR FREEBLOCKS FULLDEVNAM GEN |
Device is file-oriented: 1 if true, 0 if false Device is mounted foreign: 1 if true, 0 if false Free blocks left on the volume Fully qualified device name Device is generic: 1 if true, 0 if false |
|
IDV LOCKID LOGVOLNAM MAXBLOCK MAXFILES |
Device is capable of input: 1 if true, 0 if false Lock identification of lock on a disk Logical volume name Number of logical blocks on the volume Maximum files on volume |
|
MBX MNT MOUNTCNT NET NEXTDEVNAM |
Device is a mailbox: 1 if true, 0 if false Device is mounted: 1 if true, 0 if false Mount cound Device is a network device: 1 if true, 0 if false Device name of next volume in volume set |
|
ODV OPCNT OPR OWNUIC* PID |
Device is capable of output: 1 if true, 0 if false Operation count Device is an operator: 1 if true, 0 if false UIC of device owner is hexadecimal Process identification of device owner |
|
RCK REC RECSIZ REFCNT RND |
Device has read checking enabled: 1 if true, 0 if false Device is record oriented: 1 if true, 0 if false Blocked record size Reference count Device allows random access: 1 if true, 0 if false |
|
ROOTDEVNAM RTM SDI SECTORS SERIALNUM |
Device name of root volume in volume set terminal name, null if not virtual Device is real-time: 1 if true, 0 if false Device is single directory structured: 1 if true, 0 if false Number of sectors per track Volume serial number |
|
SERVED_DEVICE SHR SPL SPLDEVNAM SQD |
Device is served: 1 if true, 0 if false Device is shareable: 1 if true, 0 if false Device is spooled: 1 if true, 0 if false Spool device name Device is sequential block oriented: 1 if true, 0 if false |
|
STS SWL TRACKS TRANSCNT TRM |
Status information Device is software write locked: 1 if true, 0 if false Number of tracks per cylinder Volume transaction count Device is a terminal: 1 if true, 0 if false |
|
TT_ACCPORNAM TT_PHYDEVNAM UNIT VOLCOUNT VOLNAM VOLNUMBER |
Ternimal server name and port Physical device name for terminal Unit number Volumes in a volume set Volume name Current volume in volume set |
|
VOLSETMEM VPROT* WCK |
Disk is in a volume set: 1 if true, 0 if false Decimal representation of the four byte volume protection mask Write checking is enabled: 1 if true, 0 if false |
*different form of return value than F$GETDVI
|
ZGETDVI() Item Keywords - Terminals |
|
|
ITEM KEYWORD |
$ZGETDVI() DATA RETURNED TRUE(1)/FALSE(0) |
|
ALTYPEHEAD ANSICRT APP_KEYPAD AUTOBAUD AVO |
Terminal has an alternative typehead buffer Terminal is an ANSI CRT Terminal keypad is in applications mode Terminal has automatic baud rate detection Terminal has a VT100-family display |
|
BLOCK BRDCSTMBX CRFILL DECCRT DIALUP |
Terminal has block mode capability Terminal uses mailbox broadcast messages Terminal requires fill after RET Terminal is a DIGITAL CRT terminal Terminal is connected to dialup |
|
DISCONNECT DRCS EDIT EDITING EIGHTBIT |
Terminal can be disconnected Terminal supports loadable character set Terminal edit characteristic is set Terminal advanced editing is enabled Terminal uses 8-bit ASCII character set |
|
ESCAPE FALLBACK HALFDUP HANGUP HOSTSYNC |
Terminal generates escape sequences Terminal uses multi-national fallback option Terminal is in half-duplex mode Terminal has hangup characteristic set Terminal has host/terminal communication |
|
INSERT LFFILL LOCALECHO LOWER MBXDSABL |
Terminal defaults to line-editing mode Terminal requires fill after <LF> Terminal has local echo characteristic set Terminal has lower-case character set Terminal receives unsolicited input and writing mail notification |
|
MECHFORM MECHTAB MODEM MODHANGUP NOBRDCST |
Terminal has mechanical form feed Terminal has mechanical tabs and is capable of tab expansion Terminal is connected to a modem Terminal has modify hang-up characteristic set Terminal receives broadcast messages |
|
NOECHO NOTYPEAHD OPER PASTHRU PRINTER |
Terminal does not echo input characters Terminal must solicit data by a read operation Terminal is an operator terminal Terminal has passall with flow control Terminal has available printer port |
|
READSYNC REGIS SCOPE SECURE SETSPEED |
Terminal has read synchronization Terminal has REGIS graphics Terminal has a video screen display Terminal can recognize the secure server Terminal has programmable line speed |
|
SIXEL SYSPSW TTSYNC WRAP |
Terminal supports the sixel Terminal has the system password enabled Terminal/host synchronization exists Terminal inserts a new line when the cursor moves beyond the right margin |