Difference between revisions of "F$GETDVI()"
(fixed a link) |
Thilo.lauer (talk | contribs) |
||
(5 intermediate revisions by 2 users not shown) | |||
Line 49: | Line 49: | ||
| FREEBLOCKS || style="text-align:center;" | Integer || Number of free blocks on the volume (disks only) | | FREEBLOCKS || style="text-align:center;" | Integer || Number of free blocks on the volume (disks only) | ||
|- | |- | ||
− | | HARDLINKS_SUPPORTED || style="text-align:center;" | String || TRUE or FALSE to indicate whether [[Hardlink| | + | | HARDLINKS_SUPPORTED || style="text-align:center;" | String || TRUE or FALSE to indicate whether [[Hardlink|Hardlinks]], rather than [[Alias|aliases]], are supported on the volume |
|- | |- | ||
| LOGVOLNAM || style="text-align:center;" | String || Logical volume name | | LOGVOLNAM || style="text-align:center;" | String || Logical volume name | ||
Line 123: | Line 123: | ||
| MT3_DENSITY || style="text-align:center;" | String || Current density of the device | | MT3_DENSITY || style="text-align:center;" | String || Current density of the device | ||
|- | |- | ||
− | | MT3_SUPPORTED || style="text-align:center;" | String || TRUE or FALSE to indicate whether the device supports densities defined in | + | | MT3_SUPPORTED || style="text-align:center;" | String || TRUE or FALSE to indicate whether the device supports densities defined in MT3DEF (for Alpha tapes only) |
|- | |- | ||
| SQD || style="text-align:center;" | String || TRUE or FALSE to indicate whether the device is sequential block-oriented | | SQD || style="text-align:center;" | String || TRUE or FALSE to indicate whether the device is sequential block-oriented | ||
Line 169: | Line 169: | ||
| SHDW_MASTER_NAME || style="text-align:center;" | String || Device name of the virtual unit that represents the shadow set of which the specified device is a member. F$GETDVI returns a null string ("") if the specified device is not a member, or is itself a virtual unit | | SHDW_MASTER_NAME || style="text-align:center;" | String || Device name of the virtual unit that represents the shadow set of which the specified device is a member. F$GETDVI returns a null string ("") if the specified device is not a member, or is itself a virtual unit | ||
|- | |- | ||
− | | SHDW_MBR_COPY_DONE || style="text-align:center;" | String || The | + | | SHDW_MBR_COPY_DONE || style="text-align:center;" | String || The percentage of the copy operation completed on this member unit |
|- | |- | ||
| SHDW_MBR_COUNT || style="text-align:center;" | Integer || The number of full source members in the virtual unit. Devices being added as copy targets are not full source members | | SHDW_MBR_COUNT || style="text-align:center;" | Integer || The number of full source members in the virtual unit. Devices being added as copy targets are not full source members | ||
|- | |- | ||
− | | SHDW_MBR_MERGE_DONE || style="text-align:center;" | String || The | + | | SHDW_MBR_MERGE_DONE || style="text-align:center;" | String || The percentage of the merge operation completed on this member unit |
|- | |- | ||
| SHDW_MBR_READ_COST || style="text-align:center;" | String || The current value set for the member unit. This value can be modified to use a user-specified value | | SHDW_MBR_READ_COST || style="text-align:center;" | String || The current value set for the member unit. This value can be modified to use a user-specified value | ||
Line 282: | Line 282: | ||
|} | |} | ||
− | ==Terminals== | + | ===Terminals=== |
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
Line 426: | Line 426: | ||
|- | |- | ||
| MOUNTCNT || style="text-align:center;" | Integer || Number of times the volume has been mounted on the local system. The value of MOUNTCNT displayed by the SHOW DEVICE command is the total of all mounts of the volume across all members of the cluster | | MOUNTCNT || style="text-align:center;" | Integer || Number of times the volume has been mounted on the local system. The value of MOUNTCNT displayed by the SHOW DEVICE command is the total of all mounts of the volume across all members of the cluster | ||
+ | |- | ||
+ | | MOUNTCNT_CLUSTER || style="text-align:center;" | Integer || Number of times the volume has been mounted in the cluster. The value of MOUNTCNT displayed by the SHOW DEVICE command is the total of all mounts of the volume across all members of the cluster | ||
|- | |- | ||
| MOUNTVER_ELIGIBLE || style="text-align:center;" | String || TRUE or FALSE to indicate whether the volume is eligible to undergo [[Mount verification|mount verification]]. A volume mounted with either the /FOREIGN or /NOMOUNT_VERIFICATION qualifier is not subject to mount verification | | MOUNTVER_ELIGIBLE || style="text-align:center;" | String || TRUE or FALSE to indicate whether the volume is eligible to undergo [[Mount verification|mount verification]]. A volume mounted with either the /FOREIGN or /NOMOUNT_VERIFICATION qualifier is not subject to mount verification | ||
Line 466: | Line 468: | ||
| CCL || style="text-align:center;" | String || TRUE or FALSE to indicate whether the device is a carriage control device. | | CCL || style="text-align:center;" | String || TRUE or FALSE to indicate whether the device is a carriage control device. | ||
|- | |- | ||
− | | DEVBUFSIZ || style="text-align:center;" | Integer || Device buffer size | + | | DEVBUFSIZ || style="text-align:center;" | Integer || Device buffer size. For terminals, this reflects terminal width. |
|- | |- | ||
| DEVCHAR || style="text-align:center;" | Integer || Device characteristics | | DEVCHAR || style="text-align:center;" | Integer || Device characteristics |
Latest revision as of 11:27, 28 October 2022
F$GETDVI() is a lexical function that returns information about a specified device.
Format
F$GETDVI(device-name,item[,pathname])
device-name
Specifies a physical device name or a logical name equated to a physical device name. Specify the device name as a character string expression.
After the device-name argument is evaluated, the F$GETDVI function examines the first character of the name. If the first character is an underscore (_), the name is considered a physical device name; otherwise, a single level of logical name translation is performed and the equivalence name, if any, is used.
item
Specifies the type of device information to be returned. The item must be specified as a character string expression (use quotes). You can specify any one of the items listed below. For detailed descriptions of each item code, see the VSI OpenVMS DCL Dictionary.
pathname
If the pathname argument is specified, it is validated against the existing paths for the specified device. If the path does not exist, the NOSUCHPATH error is returned, even if the specified item code does not make use of the pathname argument.
List of F$GETDVI() items by topic
Logicals
Item | Value Returned | Description |
---|---|---|
CONCEALED | String | TRUE or FALSE to indicate whether the logical device name translates to a concealed device. |
Volumes
Item | Value Returned | Description |
---|---|---|
ACCESSTIMES_RECORDED | String | TRUE or FALSE to indicate whether the volume supports the recording of access times |
CLUSTER | Integer | Volume cluster size |
CYLINDERS | Integer | Number of cylinders on the volume (disks only) |
DIR | String | TRUE or FALSE to indicate whether the device is directory structured |
EXPSIZE | Integer | Current expansion limit on the volume |
ERASE_ON_DELETE | String | TRUE or FALSE to indicate whether disk blocks are zeroed upon file deletion on the volume. |
FREEBLOCKS | Integer | Number of free blocks on the volume (disks only) |
HARDLINKS_SUPPORTED | String | TRUE or FALSE to indicate whether Hardlinks, rather than aliases, are supported on the volume |
LOGVOLNAM | String | Logical volume name |
MAXBLOCK | Integer | Number of logical blocks on the volume |
MAXFILES | Integer | Maximum number of files on the volume |
NEXTDEVNAM | String | Device name of the next volume in a volume set |
ROOTDEVNAM | String | Device name of the root volume in a volume set (disks only) |
NOCACHE_ON_VOLUME | String | TRUE or FALSE to indicate whether the volume is mounted with all caching disabled |
NOHIGHWATER | String | TRUE or FALSE to indicate whether high-water marking is disabled on the volume |
NOSHARE_MOUNTED | String | TRUE or FALSE to indicate whether the volume is mounted with /NOSHARE |
NOXFCCACHE_ON_VOLUME | String | TRUE or FALSE to indicate whether the XFC caching is disabled on the volume |
ODS2_SUBSET0 | String | TRUE or FALSE to indicate whether the volume mounted supports only a subset of the ODS-2 file structure |
ODS5 | String | TRUE or FALSE to indicate whether the volume is mounted ODS-5 |
SDI | String | TRUE or FALSE to indicate whether the device is single-directory structured |
SECTORS | Integer | Number of sectors per track (disks only) |
SERIALNUM | Integer | Volume serial number (disks only) |
TRACKS | Integer | Number of tracks per cylinder (disks only) |
TRANSCNT | Integer | Volume transaction count |
VOLCHAR | String | 128-bit string (16 bytes) that represents the volume characteristics or capabilities of the mounted device. If a bit is set, the volume is capable of performing the function |
VOLCOUNT | Integer | The count of volumes in a volume set (disks only) |
VOLNAM | String | The volume name |
VOLNUMBER | Integer | Number of the current volume in a volume set (disks only) |
VOLSETMEM | String | TRUE or FALSE to indicate whether the device is a volume set (disks only) |
VOLSIZE | Integer | The volume's current logical volume size |
VOLUME_EXTEND_QUANTITY | Integer | Number of blocks to be used as the default extension size for all files on the volume |
VOLUME_MOUNT_GROUP | String | TRUE or FALSE to indicate whether the volume is mounted /GROUP |
VOLUME_MOUNT_SYS | String | TRUE or FALSE to indicate whether the volume is mounted /SYSTEM |
VOLUME_PENDING_WRITE_ERR | String | The number of pending write errors on the volume |
VOLUME_RETAIN_MAX | String | The maximum retention time for the volume, as specified with the DCL command SET VOLUME/RETENTION |
VOLUME_RETAIN_MIN | String | The minimum retention time for the volume, as specified with the DCL command SET VOLUME/RETENTION |
VOLUME_SPOOLED_DEV_CNT | Integer | The number of devices spooled to the volume |
VOLUME_WINDOW | Integer | The default window size for the volume |
VPROT | String | The volume protection mask |
WRITETHRU_CACHE_ENABLED | String | TRUE or FALSE to indicate whether the volume is mounted with write through caching enabled |
Tapes
Item | Value Returned | Description |
---|---|---|
MT3_DENSITY | String | Current density of the device |
MT3_SUPPORTED | String | TRUE or FALSE to indicate whether the device supports densities defined in MT3DEF (for Alpha tapes only) |
SQD | String | TRUE or FALSE to indicate whether the device is sequential block-oriented |
Fibre Channel
Item | Value Returned | Description |
---|---|---|
FC_HBA_FIRMWARE_REV | String | Firmware revision information of a Fibre Channel host bus adapter. A null string is returned for all other devices |
FC_NODE_NAME | String | The Fibre Channel host bus adapter node name |
FC_PORT_NAME | String | The Fibre Channel host bus adapter node name |
WWID | String | Worldwide Identifier for a Fibre Channel device |
SCSI
Item | Value Returned | Description |
---|---|---|
SCSI_DEVICE_FIRMWARE_REV | String | Firmware revision number of a SCSI disk or SCSI tape. A null string is returned for any other device |
Shadow sets
Item | Value Returned | Description |
---|---|---|
SHDW_CATCHUP_COPYING | String | TRUE or FALSE to indicate whether the device is a member that is the target of a full copy operation |
SHDW_COPIER_NODE | String | The name of the node that is actively performing the copy or merge operation |
SHDW_DEVICE_COUNT | Integer | The total number of devices in the virtual unit, including devices being added as copy targets |
SHDW_GENERATION | String | The current internal revision number for the virtual unit. This value is subject to change |
SHDW_MASTER | String | TRUE or FALSE to indicate whether the device is a virtual unit |
SHDW_MASTER_MBR | String | The name of the master member unit that will be used for merge and copy repair operations and for shadow set recovery operations |
SHDW_MASTER_NAME | String | Device name of the virtual unit that represents the shadow set of which the specified device is a member. F$GETDVI returns a null string ("") if the specified device is not a member, or is itself a virtual unit |
SHDW_MBR_COPY_DONE | String | The percentage of the copy operation completed on this member unit |
SHDW_MBR_COUNT | Integer | The number of full source members in the virtual unit. Devices being added as copy targets are not full source members |
SHDW_MBR_MERGE_DONE | String | The percentage of the merge operation completed on this member unit |
SHDW_MBR_READ_COST | String | The current value set for the member unit. This value can be modified to use a user-specified value |
SHDW_MEMBER | String | TRUE or FALSE to indicate whether the device is a shadow set member |
SHDW_MERGE_COPYING | String | TRUE or FALSE to indicate whether the device is a merge member of the shadow set |
SHDW_MINIMERGE_ENABLE | String | A value of TRUE indicates that the virtual unit will undergo a mini-merge, not a full merge, if a system in the cluster crashes |
SHDW_NEXT_MBR_NAME | String | Device name of the next member in the shadow set. If you specify a virtual unit, F$GETDVI returns the device name of a member of the shadow set. If you specify the name of a shadow set member unit with the device name and item arguments, F$GETDVI returns the name of the "next" member unit or a null string if there are no more members. To determine all the members of a shadow set, first specify the virtual unit to F$GETDVI; on subsequent calls, specify the member name returned by the previous F$GETDVI call until it has finished, when it returns a null member name. The device name includes the allocation class if the allocation class is not zero; otherwise it includes the device name of the disk controller |
SHDW_READ_SOURCE | String | The name of the member unit that will be used for reads at this time. The unit with the lowest sum total of its queue length and read cost is used. This is a dynamic value |
SHDW_SITE | Integer | The site value for the specified device. This value is set by the SET DEVICE or SET SHADOW command |
SHDW_TIMEOUT | Integer | The user-specified timeout value set for the device. If the user has not set a value by using the SETSHOSHADOW utility, the value of the SYSGEN parameter SHADOW_MBR_TMO is used for member units and the value of MVTIMEOUT is used for virtual units |
Multipath
Item | Value Returned | Description |
---|---|---|
MULTIPATH | String | TRUE or FALSE to indicate whether the device is a member of a multipath set |
ALT_HOST_AVAIL | String | TRUE or FALSE to indicate whether the host serving the alternate path is available |
ALT_HOST_NAME | String | Name of the host serving the alternate path |
ALT_HOST_TYPE | String | Hardware type of the host serving the alternate path |
AVAILABLE_PATH_COUNT | Integer | Number of available, working paths for a multipath-capable device |
HOST_AVAIL | String | TRUE or FALSE to indicate whether the host serving the primary path is available |
HOST_COUNT | Integer | Number of hosts that make the device available to other nodes in the OpenVMS Cluster |
HOST_NAME | String | Name of the host serving the primary path |
HOST_TYPE | String | Hardware type of the host serving the primary path |
MPDEV_AUTO_PATH_SW_CNT | Integer | Number of times a multipath device has automatically switched paths because of an I/O error or as the result of automatically "failing back" to a local path from a remote path once the local path became available |
MPDEV_CURRENT_PATH | String | Current path name for multipath devices. If the device is not part of a multipath set, this lexical returns the name of the device path if the class driver for this device supports path names. SYS$DKDRIVER, SYS$DUDRIVER, SYS$MKDRIVER, and SYS$GKDRIVER support path names. Returns a null string if the class driver for the device does not support path names |
MPDEV_MAN_PATH_SW_CNT | Integer | Number of times a multipath device has manually switched paths because of a SET DEVICE /PATH /SWITCH command or use of the $SET_DEVICE system service |
PATH_AVAILABLE | String | TRUE or FALSE to indicate whether the specified path is available. This item code is typically used with the pathname parameter. If the pathname parameter is omitted, information about the current path of the multipath device is returned |
PATH_NOT_RESPONDING | String | TRUE or FALSE to indicate whether the specified path is marked as not responding. This item code is typically used with the pathname parameter. If the pathname parameter is omitted, information about the current path of the multipath device is returned |
PATH_POLL_ENABLED | String | TRUE or FALSE to indicate whether the specified path is enabled for multipath polling. This item code is typically used with the pathname parameter. If the pathname parameter is omitted, information about the current path of the multipath device is returned |
PATH_SWITCH_FROM_TIME | String | Time from which this path was switched, either manually or automatically. This item code is typically used with the pathname parameter. If the pathname parameter is omitted, information about the current path of the multipath device is returned |
PATH_SWITCH_TO_TIME | String | Time to which this path was switched, either manually or automatically. This item code is typically used with the pathname parameter. If thepathname parameter is omitted, information about the current path of the multipath device is returned |
PATH_USER_DISABLED | String | TRUE or FALSE to indicate whether the specified path has been disabled using the SET DEVICE /PATH /NOENABLE command. This item code is typically used with the pathname parameter. If thepathname parameter is omitted, information about the current path of the multipath device is returned |
TOTAL_PATH_COUNT | Integer | Number of paths for a multipath-capable device |
Network devices
Item | Value Returned | Description |
---|---|---|
NET | String | TRUE or FALSE to indicate whether the device is a network device |
LAN_ALL_MULTICAST_MODE | String | TRUE or FALSE to indicate whether the device is enabled to receive all multicast packets rather than only packets addressed to enabled multicast addresses |
LAN_AUTONEG_ENABLED | String | TRUE or FALSE to indicate whether the device is set to autonegotiate the speed and duplex settings |
LAN_DEFAULT_MAC_ADDRESS | String | The default MAC (media access control) address of the device |
LAN_FULL_DUPLEX | String | TRUE or FALSE to indicate whether the device is operating in full-duplex mode |
LAN_JUMBO_FRAMES_ENABLED | String | TRUE or FALSE to indicate whether jumbo frames are enabled on the device |
LAN_LINK_STATE_VALID | String | TRUE or FALSE to indicate whether or not the device driver for the LAN device correctly maintains the link status. The device drivers for the following devices do not maintain the link status: DEMNA, any TURBOchannel adapter, any PCMPIA Ring adapter, Galaxy shared memory, TGEC, DE205, DE422, DE425, DE434, DE435, DE500 (the -XA and -AA variants; only the -BA variant is supported.) |
LAN_LINK_UP | String | TRUE or FALSE to indicate whether the link is up. This item code is valid only for the template device (that is, unit number 0); this item returns 0 if used with a non-template LAN device. This item is supported only on newer adapters; to determine whether or not a particular device supports LAN_LINK_UP, you must first use F$GETDVI with the item LAN_LINK_STATE_VALID. See that item description for more information. If LAN_LINK_UP is used on an adapter that does not maintain the link status, the returned status will be SS$_UNSUPPORTED. |
LAN_MAC_ADDRESS | String | |
LAN_PROMISCUOUS_MODE | String | TRUE or FALSE to indicate whether the device is enabled to receive all packets, rather than only packets addressed to the MAC addresses and to enabled multicast addresses |
LAN_PROTOCOL_NAME | String | The name of the LAN protocol running on the device |
LAN_PROTOCOL_TYPE | String | The type of the LAN protocol running on the device |
LAN_SPEED | Integer | The speed of the LAN device, in units of megabits per second. Valid values are 4, 10, 16, 100, 1000, and 10000 |
SET_HOST_TERMINAL | String | TRUE or FALSE to indicate whether the device is a remote terminal for a SET HOST session from a remote node |
Printers
Item | Value Returned | Description |
---|---|---|
QLEN | Integer | The queue length for the device. This value is the number of I/O requests already in the driver --- not the depth of the I/O pending queue |
SPL | String | TRUE or FALSE to indicate whether the device is being spooled |
SPLDEVNAM | String | Name of the device being spooled |
Terminals
Item | Value Returned | Description |
---|---|---|
TRM | String | TRUE or FALSE to indicate whether the device is a terminal |
TT_ACCPORNAM | String | The terminal server name and port name |
TT_ALTYPEAHD | String | TRUE or FALSE to indicate whether the terminal has an alternate type-ahead buffer |
TT_ANSICRT | String | TRUE or FALSE to indicate whether the terminal is an ANSI CRT terminal |
TT_APP_KEYPAD | String | TRUE or FALSE to indicate whether the keypad is in applications mode |
TT_AUTOBAUD | String | TRUE or FALSE to indicate whether the terminal has automatic baud rate detection |
TT_AVO | String | TRUE or FALSE to indicate whether the terminal has a VT100-family terminal display |
TT_BLOCK | String | TRUE or FALSE to indicate whether the terminal has block mode capability |
TT_BRDCSTMBX | String | TRUE or FALSE to indicate whether the terminal uses mailbox broadcast messages |
TT_CHARSET | Integer | A bitmap indicating the coded character set supported by the terminal |
TT_CRFILL | String | TRUE or FALSE to indicate whether the terminal requires fill after a carriage return |
TT_CS_HANGUL | String | TRUE or FALSE to indicate whether the terminal supports the DEC Korean coded character set |
TT_CS_HANYU | String | TRUE or FALSE to indicate whether the terminal supports the DEC Hanyu coded character set |
TT_CS_HANZI | String | TRUE or FALSE to indicate whether the terminal supports the DEC Hanzi coded character set |
TT_CS_KANA | String | TRUE or FALSE to indicate whether the terminal supports the DEC Kana coded character set |
TT_CS_KANJI | String | TRUE or FALSE to indicate whether the terminal supports the DEC Kanji coded character set |
TT_CS_THAI | String | TRUE or FALSE to indicate whether the terminal supports the DEC Thai coded character set |
TT_DECCRT | String | TRUE or FALSE to indicate whether the terminal is a DIGITAL CRT terminal |
TT_DECCRT2 | String | TRUE or FALSE to indicate whether the terminal is a DIGITAL CRT2 terminal |
TT_DECCRT3 | String | TRUE or FALSE to indicate whether the terminal is a DIGITAL CRT3 terminal |
TT_DECCRT4 | String | TRUE or FALSE to indicate whether the terminal is a DIGITAL CRT4 terminal |
TT_DIALUP | String | TRUE or FALSE to indicate whether the terminal is connected to dialup |
TT_DISCONNECT | String | TRUE or FALSE to indicate whether the terminal can be disconnected |
TT_DMA | String | TRUE or FALSE to indicate whether the terminal has direct memory access (DMA) mode |
TT_DRCS | String | TRUE or FALSE to indicate whether the terminal supports loadable character fonts |
TT_EDIT | String | TRUE or FALSE to indicate whether the edit characteristic is set |
TT_EDITING | String | TRUE or FALSE to indicate whether advanced editing is enabled |
TT_EIGHTBIT | String | TRUE or FALSE to indicate whether the terminal uses the 8-bit ASCII character set |
TT_ESCAPE | String | TRUE or FALSE to indicate whether the terminal generates escape sequences |
TT_FALLBACK | String | TRUE or FALSE to indicate whether the terminal uses the multinational fallback option |
TT_HALFDUP | String | TRUE or FALSE to indicate whether the terminal is in half-duplex mode |
TT_HANGUP | String | TRUE or FALSE to indicate whether the hangup characteristic is set |
TT_HOSTSYNC | String | TRUE or FALSE to indicate whether the terminal has host/terminal communication |
TT_INSERT | String | TRUE or FALSE to indicate whether insert mode is the default line editing mode |
TT_LFFILL | String | TRUE or FALSE to indicate whether the terminal requires fill after a line feed |
TT_LOCALECHO | String | TRUE or FALSE to indicate whether the local echo characteristic is set |
TT_LOWER | String | TRUE or FALSE to indicate whether the terminal has the lowercase characters set |
TT_MBXDSABL | String | TRUE or FALSE to indicate whether mailboxes associated with the terminal will receive unsolicited input notification or input notification |
TT_MECHFORM | String | TRUE or FALSE to indicate whether the terminal has mechanical form feed |
TT_MECHTAB | String | TRUE or FALSE to indicate whether the terminal has mechanical tabs and is capable of tab expansion |
TT_MODEM | String | TRUE or FALSE to indicate whether the terminal is connected to a modem |
TT_MODHANGUP | String | TRUE or FALSE to indicate whether the modify hangup characteristic is set |
TT_NOBRDCST | String | TRUE or FALSE to indicate whether the terminal will receive broadcast messages |
TT_NOECHO | String | TRUE or FALSE to indicate whether the input characters are echoed |
TT_NOTYPEAHD | String | TRUE or FALSE to indicate whether data must be solicited by a read operation |
TT_OPER | String | TRUE or FALSE to indicate whether the terminal is an operator terminal |
TT_PAGE | String | Terminal page length |
TT_PASTHRU | String | TRUE or FALSE to indicate whether PASSALL mode with flow control is available |
TT_PHYDEVNAM | String | Physical device name associated with a channel number or virtual terminal |
TT_PRINTER | String | TRUE or FALSE to indicate whether there is a printer port available |
TT_READSYNC | String | TRUE or FALSE to indicate whether the terminal has read synchronization |
TT_REGIS | String | TRUE or FALSE to indicate whether the terminal has ReGIS graphics |
TT_REMOTE | String | TRUE or FALSE to indicate whether the terminal has established modem control |
TT_SCOPE | String | TRUE or FALSE to indicate whether the terminal is a video screen display |
TT_SECURE | String | TRUE or FALSE to indicate whether the terminal can recognize the secure server |
TT_SETSPEED | String | TRUE or FALSE to indicate whether you cannot set the speed on the terminal line |
TT_SIXEL | String | TRUE or FALSE to indicate whether the sixel is supported |
TT_SYSPWD | String | TRUE or FALSE to indicate whether the system password is enabled for a particular terminal |
TT_TTSYNC | String | TRUE or FALSE to indicate whether there is terminal/host synchronization |
TT_WRAP | String | TRUE or FALSE to indicate whether a new line should be inserted if the cursor moves beyond the right margin |
Miscellaneous
Allocation and mounting
Item | Value Returned | Description |
---|---|---|
ALL | String | TRUE or FALSE to indicate whether the device is allocated |
FOR | String | TRUE or FALSE to indicate whether the device is mounted using the /FOREIGN qualifier |
DMT | String | TRUE or FALSE to indicate whether the device is marked for dismount |
MNT | String | TRUE or FALSE to indicate whether the device is mounted |
MOUNT_TIME | String | Time at which the volume was mounted. For volumes mounted in a cluster, only the time of the initial mount is recorded; the time of any subsequent mount is not recorded |
MOUNTCNT | Integer | Number of times the volume has been mounted on the local system. The value of MOUNTCNT displayed by the SHOW DEVICE command is the total of all mounts of the volume across all members of the cluster |
MOUNTCNT_CLUSTER | Integer | Number of times the volume has been mounted in the cluster. The value of MOUNTCNT displayed by the SHOW DEVICE command is the total of all mounts of the volume across all members of the cluster |
MOUNTVER_ELIGIBLE | String | TRUE or FALSE to indicate whether the volume is eligible to undergo mount verification. A volume mounted with either the /FOREIGN or /NOMOUNT_VERIFICATION qualifier is not subject to mount verification |
MVSUPMSG | String | TRUE or FALSE to indicate whether mount verification OPCOM messages are currently being suppressed on this device. See the MVSUPMSG_INTVL and MVSUPMSG_NUM system parameters for more information on the suppression of mount verification messages |
Device information
Item | Value Returned | Description |
---|---|---|
ALLOCLASS | Longword integer | Allocation class of the host |
ALLDEVNAM | String | Allocation class device name |
DEVCLASS | Integer | Device class |
DEVLOCKNAM | String | A unique lock name for the device |
DEVNAM | String | Device name |
DEVTYPE | Integer | Device type |
FULLDEVNAM | String | Fully qualified device name |
Other
Item | Value Returned | Description |
---|---|---|
ACPPID | String | Ancillary control process (ACP) identification |
ACPTYPE | String | ACP type code, as one of the following strings: F11V1, F11V2, F11V3, F11V4, F11V5, F64, HBS, JNL, MTA, NET, REM, UCX, or ILLEGAL. The ACPTYPE item returns ILLEGAL if the device is not mounted or is mounted using the /FOREIGN qualifier or the ACPTYPE is not currently defined. |
AVL | String | TRUE or FALSE to indicate whether the device is available for use. |
CCL | String | TRUE or FALSE to indicate whether the device is a carriage control device. |
DEVBUFSIZ | Integer | Device buffer size. For terminals, this reflects terminal width. |
DEVCHAR | Integer | Device characteristics |
DEVCHAR2 | Integer | Additional device characteristics |
DEVDEPEND | Integer | Device-dependent information |
DEVDEPEND2 | Integer | Additional device-dependent information |
DEVICE_TYPE_NAME | String | Device type name. Note that if the device is a SCSI tape or disk, the device type name is retrieved directly from the device |
DEVSTS | String | Device-dependent status information |
DFS_ACCESS | String | TRUE or FALSE to indicate whether the device is a virtual disk connected to a remote Distributed File System (DFS) server. |
DUA | String | TRUE or FALSE to indicate whether the device is a generic device. |
ELG | String | TRUE or FALSE to indicate whether the device has error logging enabled. |
ERRCNT | Integer | Error count of the device. If the error count has been reset with the SET DEVICE /RESET=ERRCNT command, you can use the SHOW DEVICE/FULL command to display the date and time that the error count was reset. If the pathname parameter is specified, only the error count for that path is returned. If the pathname parameter is omitted, the summation of the error counts for all paths in a multipath device is returned. |
ERROR_RESET_TIME | String | Time at which the error count was reset. |
EXISTS | String | TRUE or FALSE to indicate whether the device exists on the system. |
FOD | String | TRUE or FALSE to indicate whether the device is a files-oriented device. |
GEN | String | TRUE or FALSE to indicate whether the device is a generic device. |
IDV | String | TRUE or FALSE to indicate whether the device is capable of providing input. |
LOCKID | Integer | Clusterwide lock identification. |
MAILBOX_BUFFER_QUOTA | Integer longword | The current mailbox quota as an unsigned integer longword. |
MAILBOX_INITIAL_QUOTA | Integer longword | The initial mailbox quota as an unsigned integer longword. |
MBX | String | TRUE or FALSE to indicate whether the device is a mailbox. |
MEDIA_ID | Integer | Nondecoded media ID. |
MEDIA_NAME | String | Either the name of the disk or the tape type. |
MEDIA_TYPE | String | Device name prefix. |
ODV | String | TRUE or FALSE to indicate whether the device is capable of providing output. |
OPCNT | Integer | Operation count of the device. Note that the operation count may have been reset with the SET DEVICE/RESET=OPCNT command. If the pathname parameter is specified, only the operation count for that path is returned. If the pathname parameter is omitted, the summation of the operation counts for all paths in a multipath device is returned. |
OPR | String | TRUE or FALSE to indicate whether the device is an operator. |
OWNUIC | String | User identification code (UIC) of the device owner. |
PID | String | Process identification number of the device owner. |
PREFERRED_CPU | Integer | Return argument is a 32-bit CPU bit mask with a bit set indicating the preferred CPU. A return argument containing a bit mask of zero indicates that no preferred CPU exists, either because Fast Path is disabled or the device is not a Fast Path capable device. The return argument serves as a CPU bit mask input argument to the $PROCESS_AFFINITY system service. The argument can be used to assign an application process to the optimal preferred CPU. |
PREFERRED_CPU_BITMAP | String | A bitmap string of zeros and, at most, a single 1. The 1 in the bitmask represents the number of the CPU to which the device is affinitized. The length of the string determines by how many CPUs are on the system. If there is no 1 in the bitmap string, then either Fast Path is disabled systemwide, or the device is not Fast Path-capable. |
PROT_SUBSYSTEM_ENABLED | String | TRUE or FALSE to indicate whether the volume is mounted with protected subsystems enabled. |
RCK | String | TRUE or FALSE to indicate whether the device has read checking enabled. |
RCT | String | TRUE or FALSE to indicate whether the disk contains RCT. |
REC | String | TRUE or FALSE to indicate whether the device is record-oriented. |
RECSIZ | Integer | Blocked record size. |
REFCNT | Integer | Reference count of processes using the device. |
REMOTE_DEVICE | String | TRUE or FALSE to indicate whether the device is a remote device. |
RND | String | TRUE or FALSE to indicate whether the device allows random access. |
RTM | String | TRUE or FALSE to indicate whether the device is a real-time device. |
SERVED_DEVICE | String | TRUE or FALSE to indicate whether the device is a served device. |
SHR | String | TRUE or FALSE to indicate whether the device is shareable. |
STS | Integer | Status information. |
SWL | String | TRUE or FALSE to indicate whether the device is software write-locked. |
UNIT | Integer | The unit number. |
WCK | String | TRUE or FALSE to indicate whether the device has write checking enabled. |
XFC_DEPOSING | String | TRUE or FALSE to indicate whether the XFC volume depose operation is in progress or not. |