HELP SHOW — VMS 5.5
Displays information about the current status of a process, the
system, or devices in the system.
Format
SHOW option
Additional information available:
ACCOUNTINGACLAUDITBROADCASTCLUSTER
CPUDEFAULTDEVICESDISPLAYENTRYERRORINTRUSION
KEYLICENSELOGICALMAGTAPEMEMORYNETWORKPRINTER
PROCESSPROTECTIONQUEUEQUOTARMS_DEFAULT
STATUSSYMBOLSYSTEMTERMINALTIMETRANSLATION
USERSWORKING_SETZONE
Command Options
These are the SHOW command options:
Table SHOW Command Options
Option Displays
ACCOUNTING Items for which accounting is enabled
ACL The access control list (ACL) associated
with a system object
AUDIT The security features that are enabled
BROADCAST Message classes for which broadcast is
enabled
CLUSTER Cluster activity and performance
CPU Current state of the attached processor
DEFAULT The current default device and directory
DEVICES The status of devices in the system
DEVICE/SERVED The status of devices served by the mass
storage control protocol (MSCP) server on
a VAXcluster
DISPLAY The node where the output from a
DECwindows application running on the
current node will be displayed
ENTRY Information about a user's batch and print
jobs or about specific job entries.
ERROR The error count for the CPU, memory, and
physical devices
INTRUSION The contents of the break-in database
KEY Key definitions created by the DEFINE/KEY
command
LOGICAL Current logical name assignments
MAGTAPE The status and characteristics of a
specific magnetic tape device
MEMORY The availability and usage of memory
resources
NETWORK The availability of network nodes,
including the current node
PRINTER Printer characteristics
PROCESS Attributes of the current process,
including privileges, resource quotas,
memory usage, priority, and accounting
information
PROTECTION The current default protection applied to
files
QUEUE Names and types of queues that are
available on the system as well as any
current jobs belonging to your process
QUEUE/CHARACTERISTIC Characteristic names and numbers that
have been defined for system queues
QUEUE/FORM Form names and numbers that have been
defined for system queues
QUOTA The current disk quota authorized for
and used by a specific user on a specific
disk
RMS_DEFAULT The current default multiblock and
multibuffer counts used by VMS Record
Management Services (VMS RMS) for file
operations
STATUS The status of the current job, including
accumulated CPU time, open file count,
and count of I/O operations
SYMBOL Current symbol definitions
SYSTEM A list of all processes in the system
TERMINAL The device characteristics of a terminal
[DAY]TIME The current date and time
TRANSLATION A current logical name assignment
USERS Information about users currently on the
system
WORKING_SET The current working set size limit and
quota
ZONE Displays the current state of a VAXft 3000
system
ACCOUNTING
Displays the activities for which accounting is currently enabled.
For a complete description of the Accounting Utility, refer to the
VMS Accounting Utility Manual.
Format
SHOW ACCOUNTING
Additional information available:
QUALIFIER
Additional information available:
/OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Specifies the file to which the display is written; by default,
the display is written to the current SYS$OUTPUT device.
If you specify the /OUTPUT qualifier with a partial file
specification (for example, specifying only a directory), SHOW is
the default file name and LIS the default file type. If you enter
a file specification, you may not include any wildcard characters.
If you specify the /NOOUTPUT qualifier, output is suppressed.
Example
$ SHOW ACCOUNTING/OUTPUT=ACCOUNTING.SET
The SHOW ACCOUNTING command in this example writes the current
setting of SET ACCOUNTING to the file ACCOUNTING.SET.
ACL
Allows you to display the access control list (ACL) of an object.
Format
SHOW ACL object-name
Additional information available:
PARAMETER
object-name Specifies the name of the object whose ACL is to be displayed. No wildcard characters are allowed in the object-name specification.
QUALIFIER
Additional information available:
/OBJECT_TYPE
/OBJECT_TYPE=type
Specifies the object type of the object whose ACL is to be
displayed. The following keywords are used to specify the object
type:
CAPABILITY A system capability, such as the ability
to process vector instructions. Currently,
the only defined object name for the
CAPABILITY type is VECTOR, which governs
the ability of a subject to access a
vector processor on the system. Note
that you must supply the capability name
(for example, VECTOR) as the object-name
parameter in the SHOW ACL command.
DEVICE A device.
FILE (default) A Files-11 disk file (includes directory
files).
GROUP_GLOBAL_SECTION A group global section.
LOGICAL_NAME_TABLE A system logical name table.
QUEUE A batch or device (terminal, server, or
printer) queue.
SYSTEM_GLOBAL_SECTION A system global section.
Example
$ SHOW ACL/OBJECT_TYPE=DEVICE TTA1
Object type: device, Object name: VTA1
(IDENTIFIER=[SALES,FRANK],ACCESS=READ)
(IDENTIFIER=[123,321]+NETWORK,ACCESS=NONE)
.
.
.
The SHOW ACL command in this example displays the ACL of the
device TTA1.
AUDIT
Displays the security auditing characteristics in effect on the
system.
Requires the SECURITY privilege.
Format
SHOW AUDIT
Additional information available:
QUALIFIERS
Additional information available:
/ALL/ALARM/ARCHIVE/FAILURE_MODE/JOURNAL/OUTPUT
/SERVER
/ALL
Displays all available auditing information including the following: name and location of the system security audit log file; type of security events enabled on the system; action the system will take if an attempt to write an audit event message fails (failure mode); name and location of the security archive file; information about the audit server process, such as the action taken if the audit server process runs out of virtual memory.
/ALARM
Displays the security events currently enabled on the system.
/ARCHIVE
Displays the name and location of the security archive file (if enabled).
/FAILURE_MODE
Displays the failure mode currently in effect on the system.
/JOURNAL
Displays the name and location of the system security audit log file.
/OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. If you do not
enter the qualifier, or if you enter the /OUTPUT qualifier without
a file specification, the output is sent to the current process
default output stream or device, identified by the logical name
SYS$OUTPUT.
If you enter the /OUTPUT qualifier with a partial file
specification (for example, specifying only a directory), SHOW is
the default file name and LIS the default file type. If you enter
a file specification, it may not include any wildcard characters.
If you enter the /NOOUTPUT qualifier, output is suppressed.
/SERVER
Displays information about the audit server process. Currently, the only information displayed is the action the audit server takes if all attempts to allocate process virtual memory are unsuccessful.
Examples
1. $ SHOW AUDIT
Security alarms currently disabled
The display produced by the SHOW AUDIT command in this example
reveals that security auditing is not enabled.
2. $ SET AUDIT/ALARM/ENABLE=ALL
$ SHOW AUDIT
Security alarm failure mode is set to:
WAIT Processes will wait for resource
Security alarms currently enabled for:
ACL
MOUNT
AUTHORIZATION
BREAKIN: (DIALUP,LOCAL,REMOTE,NETWORK,DETACHED)
LOGIN: (BATCH,DIALUP,LOCAL,REMOTE,NETWORK,SUBPROCESS,DETACHED)
LOGFAILURE: (BATCH,DIALUP,LOCAL,REMOTE,NETWORK,SUBPROCESS,DETACHED)
LOGOUT: (BATCH,DIALUP,LOCAL,REMOTE,NETWORK,SUBPROCESS,DETACHED)
FILE_ACCESS:
FAILURE: (READ,WRITE,EXECUTE,DELETE,CONTROL)
SUCCESS: (READ,WRITE,EXECUTE,DELETE,CONTROL)
SYSPRV: (READ,WRITE,EXECUTE,DELETE,CONTROL)
BYPASS: (READ,WRITE,EXECUTE,DELETE,CONTROL)
GRPPRV: (READ,WRITE,EXECUTE,DELETE,CONTROL)
READALL: (READ,WRITE,EXECUTE,DELETE,CONTROL)
The SHOW AUDIT command in this example reveals that security
auditing has been enabled for all possible events. The command
also reveals that processes attempting to write security alarms
when insufficient resources are available will be placed in the
MWAIT state to wait for resources.
3. $ SHOW AUDIT/ALL
List of audit journals:
Journal name: SECURITY
Journal owner: (system audit journal)
Destination: SYS$COMMON:[SYSMGR]AUDIT.AUDIT$JOURNAL
Monitoring: free disk space
Warning threshold: 1000 blocks
Action threshold: 250 blocks
Resume threshold: 750 blocks
Security auditing server characteristics:
Final resource action: crash system
Security archiving information:
Archiving events: system audits, system alarms
Archive destination: SPAR::SYS$MANAGER:K9.AUDIT$JOURNAL
Security alarm failure mode is set to:
WAIT Processes will wait for resource
Security alarms currently enabled for:
ACL
AUTHORIZATION
BREAKIN: (DIALUP,LOCAL,REMOTE,NETWORK,DETACHED)
LOGIN: (BATCH,DIALUP,LOCAL,REMOTE,NETWORK,SUBPROCESS,DETACHED)
LOGFAILURE: (BATCH,DIALUP,LOCAL,REMOTE,NETWORK,SUBPROCESS,DETACHED)
The SHOW AUDIT command in this example displays all the
available security auditing information, including the
following:
o The name and location of the system security audit log file.
o The method used by the audit server to monitor available
resources on the system and the threshold values at which
the audit server sends out notification, suspends, or
resumes activity on the system.
o Information about the audit server process.
o The name and location of the security archive file. By
default, archiving is not enabled on the system.
o The security alarm failure mode in effect on the system.
o The classes of security events enabled on the system.
All security events generated are written to the system
security audit log file and broadcast as alarm messages to
all security operator terminals.
4. $ SHOW AUDIT/FAILURE_MODE
Security alarm failure mode is set to:
IGNORE Alarms will be lost (0 alarms lost)
The SHOW AUDIT command in this example shows that the VMS
operating system will ignore security alarms when there
are insufficient system resources to write the alarm to the
operator mailbox. A message is sent to the system console
indicating that alarm messages are being lost.
5. $ SHOW AUDIT
Security alarm failure mode is set to:
WAIT Processes will wait for resource
Security alarms currently enabled for:
BREAKIN: (DIALUP,LOCAL,REMOTE,NETWORK,DETACHED)
LOGIN: (DIALUP)
LOGOUT: (DIALUP)
The SHOW AUDIT command in this example reveals that the
terminals enabled as security operators will receive an alarm
whenever the system detects a possible break-in attempt, or
when a dialup user logs in or out.
BROADCAST
Displays the message classes that are currently affected by the
SET BROADCAST command.
Format
SHOW BROADCAST
Additional information available:
QUALIFIER
Additional information available:
/OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. If you do not
enter the qualifier, or if you enter the /OUTPUT qualifier without
a file specification, the output is sent to the current process
default output stream or device, identified by the logical name
SYS$OUTPUT.
If you enter the /OUTPUT qualifier with a partial file
specification (for example, specifying only a directory), SHOW
is the default file name and LIS the default file type. Wildcard
characters are not allowed.
If you enter the /NOOUTPUT qualifier, output is suppressed.
Examples
1. $ SET BROADCAST=ALL
$ SET TERMINAL/NOBROADCAST
$ SHOW BROADCAST
Broadcasts are enabled for all classes
Terminal is set "No Broadcast",
no broadcast messages will be displayed.
This example shows the display when all message classes are
enabled for broadcast, but will not be received because the
terminal is set NO BROADCAST.
2. $ SHOW BROADCAST
Broadcasts are currently disabled for:
MAIL
The SHOW BROADCAST display in this example indicates that SET
BROADCAST=NOMAIL is in effect.
3. $ SET BROADCAST=(NOALL,USER1)
$ SET TERMINAL/NOBROADCAST
$ SHOW BROADCAST
Broadcasts are currently disabled for:
GENERAL
PHONE
MAIL
QUEUE
SHUTDOWN
URGENT
DCL
OPCOM
USER2
USER3
USER4
USER5
USER6
USER7
USER8
USER9
USER10
USER11
USER12
USER13
USER14
USER15
USER16
Terminal is set "No Broadcast",
no broadcast messages will be displayed.
This example shows the display when messages from USER1 are
enabled, but will not be received, because the terminal is set
NO BROADCAST.
4. $ SET BROADCAST=NONE
$ SHOW BROADCAST
Broadcasts are disabled for all classes
This example shows the display when SET BROADCAST=NONE is in
effect.
CLUSTER
Invokes the Show Cluster Utility to monitor and display cluster
activity and performance. For a complete description of the Show
Cluster Utility, see the VMS Show Cluster Utility Manual.
Format
SHOW CLUSTER
Additional information available:
QUALIFIERS
Additional information available:
/BEGINNING/CONTINUOUS/ENDING/INTERVAL/OUTPUT
/BEGINNING
/BEGINNING=time
Specifies a future time that the SHOW CLUSTER session is to begin.
You can specify an absolute time, delta time, or a combination of
the two. If you specify a future time, your process is placed in
a hibernate state until the specified time. You should use this
qualifier with the /OUTPUT and /ENDING qualifiers to run SHOW
CLUSTER without direct user intervention.
/CONTINUOUS
Controls whether SHOW CLUSTER runs as a continuously updating display. If you omit the qualifier, a single display is produced and control is returned to the DCL level. Running SHOW CLUSTER in the /CONTINUOUS mode allows you to use SHOW CLUSTER commands to control the display.
/ENDING
/ENDING=time
Specifies a future time that the SHOW CLUSTER session is to end.
You can specify an absolute time, delta time, or a combination of
the two.
You should use this qualifier with the /BEGINNING and /OUTPUT
qualifiers to run SHOW CLUSTER without direct user intervention.
/INTERVAL
/INTERVAL=seconds/
INTERVAL=15 (default)
Specifies the number of seconds that the display information
remains on the screen before it is updated.
/OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. If you do
not enter the qualifier, or if you enter /OUTPUT without a
file specification, the output is sent to the current process
default output stream or device, identified by the logical name
SYS$OUTPUT.
If you enter /OUTPUT with a partial file specification (for
example, specifying only a directory), the default file name is
SHOW_CLUSTER.LIS. If you enter a file specification, it cannot
include any wildcard characters.
You can also specify a valid device name to direct output to a
particular device. If you specify a device name that is invalid,
it is treated as a file name.
If you enter /NOOUTPUT, output is suppressed.
When the /OUTPUT qualifier is used, SHOW CLUSTER output is always
in printable file format regardless of the device type specified.
The output can be up to 132 columns wide and be directed to any
file, terminal, or print device.
Examples
1. $ SHOW CLUSTER
The command in this example produces a single display of
default CLUSTER information and returns control to the DCL
command level.
2. $ SHOW CLUSTER/CONTINUOUS
The command in this example produces a single display of
default CLUSTER information, which is continuously updated
at 15-second intervals.
3. $ SHOW CLUSTER /CONTINUOUS /INTERVAL=5 /OUTPUT=CLUSREP -
_$ /ENDING="+00:00:30"
The command in this example invokes SHOW CLUSTER for 30
seconds, performs updates at 5-second intervals, and sends the
output to CLUSREP.LIS.
CPU
Displays the current state of the processors in a VMS
multiprocessing system.
Applies only to VMS multiprocessing systems. Requires CMKRNL
(change mode to kernel) privilege.
Format
SHOW CPU [cpu-id[,...]]
Additional information available:
Parameter
cpu-id[,...] Decimal value representing the identity of a processor in a multiprocessing system. In a VAX 8300 system, for instance, the CPU ID is the VAXBI node number of the processor; in a VAX 8800 system, the CPU ID of the left processor is 1 and that of the right processor is 0.
Qualifiers
Additional information available:
/ACTIVE/ALL/BRIEF/FULL/SUMMARY
/ACTIVE
Selects as the subject of the display only those processors that are members of the system's active set.
/ALL
Selects all configured processors, active and inactive, as the subject of the display.
/BRIEF
Produces information from the summary display and also lists the current CPU state and current process (if any) for each processor in the configuration.
/FULL
Produces information from the summary display. The /FULL qualifier also lists the current CPU state, the current process (if any), the revision levels, and the capabilities for each configured processor. It indicates which processes can execute only on certain processors in the configuration. In addition, if one or more uniprocessing drivers are present in the system, the /FULL qualifier lists them by name. The SHOW CPU/FULL command lists the current process on each configured processor without stopping other activity on the system. The current process may change while the data are displayed. As a result, there may be apparent inconsistencies in the display. For example, a process may be listed as the current process on more than one CPU.
/SUMMARY
Produces a display listing the processors in the VMS multiprocessing system, indicating which is the primary, which are configured, and which are active. The /SUMMARY qualifier also indicates the minimum revision levels required for processors in the system, which VMS synchronization image has been loaded into the operating system, and whether multiprocessing is enabled. If the presence of one or more uniprocessing drivers in the system prohibits the enabling of multiprocessing, the SHOW CPU command displays a warning message.
Examples
1. $ SHOW CPU
SOWHAT, A VAX 8800
Multiprocessing is ENABLED. Full checking synchronization image loaded.
Minimum multiprocessing revision levels: CPU = 0 uCODE = 0 UWCS = 0.
PRIMARY CPU = 01
Active CPUs: 00 01
Configured CPUs: 00 01
The SHOW CPU command in this example produces a configuration
summary of all configured processors in the VAX 8800 system
SOWHAT. The primary processor is CPU 01, and all configured
processors are active.
2. $ SHOW CPU/BRIEF
SOWHAT, A VAX 8800
Multiprocessing is ENABLED. Full checking synchronization image loaded.
Minimum multiprocessing revision levels: CPU = 0 uCODE = 0 UWCS = 0.
PRIMARY CPU = 01
CPU 00 is in RUN state
Current Process: AIREGIN PID = 4A8001E5
CPU 01 is in RUN state
Current Process: ***None***
The SHOW CPU/BRIEF command in this example produces a
configuration summary of the VAX 8800 system SOWHAT and also
indicates that its two processors are in the RUN state. Only
CPU 00 has a current process.
3. $ SHOW CPU/FULL
SOWHAT, A VAX 8800
Multiprocessing is ENABLED. Full checking synchronization image loaded.
Minimum multiprocessing revision levels: CPU = 0 uCODE = 0 UWCS = 0.
PRIMARY CPU = 01
CPU 00 is in RUN state
Current Process: AIREGIN PID = 4A8001E5
Revision levels: CPU = 0 uCODE = 0 UWCS = 0.
Capabilities of this CPU:
*** None ***
Processes which can only execute on this CPU:
*** None ***
CPU 01 is in RUN state
Current Process: *** None ***
Revision levels: CPU = 0 uCODE = 0 UWCS = 0.
Capabilities of this CPU:
PRIMARY
Processes which can only execute on this CPU:
CONFIGURE PID = 4A80010C Reason = PRIMARY Capability
The SHOW CPU/FULL command in this example produces a
configuration summary of the VAX 8800 system SOWHAT, indicating
that each processor is in the RUN state. It also shows that
CPU 01 has primary and timekeeper capabilities. There is one
process, CONFIGURE, in the system that can execute only on CPU
01 because only that processor has the primary capability.
4. $ SHOW CPU
OLEO, A VAX 8300
Multiprocessing is DISABLED. Full checking synchronization image loaded.
Minimum multiprocessing revision levels: CPU = 0 uCODE = 0 UWCS = 0.
*** Loaded unmodified device drivers prevent multiprocessor operation.***
PRIMARY CPU = 02
Active CPUs: 02
Configured CPUs: 02 08
The SHOW CPU command in this example produces a configuration
summary of all configured processors in the VAX 8300 system
OLEO. The primary processor is CPU 02. Multiprocessing cannot
be enabled, and the secondary processor cannot be booted
because a uniprocessing device driver is present in the system.
5. $ SHOW CPU/FULL
OLEO, A VAX 6000-420
Multiprocessing is DISABLED. MULTIPROCESSING Sysgen parameter = 02
Minimum multiprocessing revision levels -- CPU: 0 uCODE: 0 UWCS: 21.
PRIMARY CPU = 02
*** Loaded unmodified device drivers prevent multiprocessor operation.***
RBDRIVER
CPU 02 is in RUN state
Current Process: Koko PID = 2A6001E3
Revision levels: CPU: 0 uCODE: 0 UWCS: 0.
Capabilities of this CPU:
PRIMARY VECTOR RUN
Processes which can only execute on this CPU:
CONFIGURE PID = 2A40010B Reason = PRIMARY Capability
Reason = RUN Capability
CPU 07 is in INIT state
Current Process: *** None ***
Revision levels: CPU: 0 uCODE: 0 UWCS: 0.
Capabilities of this CPU:
*** None ***
Processes which can only execute on this CPU:
*** None ***
The SHOW CPU/FULL command in this example produces a
configuration summary of the VAX 8300 system OLEO, indicating
that only CPU 02, the primary CPU, is active and in the RUN
state. It also shows that there is a uniprocessing driver
loaded in the system, thus preventing the system from being
enabled as a multiprocessor.
DEFAULT
Displays the current default device and directory.
Format
SHOW DEFAULT
Additional information available:
Examples
1. $ SHOW DEFAULT
DISK1:[ALPHA]
$ SET DEFAULT DISK5:[HIGGINS.SOURCES]
$ SHOW DEFAULT
DISK5:[HIGGINS.SOURCES]
The SHOW DEFAULT command in this example displays the current
default device and directory names. The SET DEFAULT command
changes these defaults, and the next SHOW DEFAULT command
displays the new default device and directory.
2. $ SET DEFAULT NOSUCH:[NOWAY]
$ SHOW DEFAULT
NOSUCH:[NOWAY]
%DCL-I-INVDEF, NOSUCH:[NOWAY] does not exist
In this example, the default has been set to a nonexistent
device and directory. An error message is displayed.
3. $ DEFINE/TRANSLATION_ATTRIBUTES=CONCEALED XYZ WORK:[INVOICES.]
$ SET DEFAULT XYZ:[SALES]
$ SHOW DEFAULT
XYZ:[SALES]
In this example, a logical name, XYZ, is defined to represent
WORK:[INVOICES]. The /TRANSLATION_ATTRIBUTES=CONCEALED
qualifier tells the system not to display the translation of
XYZ in file specifications. Thus, the SHOW DEFAULT command
displays the logical name XYZ and not its translation.
4. $ SET DEFAULT WORK:[BLUE]
$ SHOW DEFAULT
WORK:[BLUE]
$ DEFINE FOO WORK:[BLUE.TEMP1],WORK:[BLUE.TEMP2]
$ SET DEFAULT FOO
$ SHOW DEFAULT
FOO:[BLUE]
= WORK:[BLUE.TEMP1]
= WORK:[BLUE.TEMP2]
In this example, the logical name FOO is defined as a search
list containing the directories [BLUE.TEMP1] and [BLUE.TEMP2]
both on device WORK. The SET DEFAULT command equates this
search list logical name with the logical name SYS$DISK.
The subsequent SHOW DEFAULT command displays the search list
logical name along with its equivalence strings.
Because the directory field has not been explicitly specified,
the original [BLUE] directory remains in effect as the current
default directory. However, unless the current default
directory syntax ([]) is explictly used, all file references
are to those directories contained in the search list.
DEVICES
Displays the status of a device on the system.
See the qualifier descriptions for restrictions.
Format
SHOW DEVICES [device-name[:]]
Additional information available:
PARAMETER
device-name[:]
Specifies the name of a device for which information is to be
displayed. The device name displayed by the system uses the format
ddcu where dd is the device code, c is the controller designation,
and u is the unit number. If the system is part of a VAXcluster
that is running with hierarchical storage controllers (HSCs), the
device name must include the node name using the format node$ddcu
(where node is the node name).
You can specify a complete device name or only a portion of
a device name. The SHOW DEVICES command provides defaults for
nonspecified portions of device names, as follows:
o If you truncate a device name (for example, if you specify D),
the command lists information about all devices whose device
names begin with what you entered (in this case, D). However,
if you specify a device in a VAXcluster that is running with
HSCs, you must include the entire node portion of the device
name.
o If you omit a controller designation, the SHOW DEVICES command
lists all devices on all controllers with the specified unit
number.
o If you omit a unit number, the SHOW DEVICES command lists all
devices on the specified controller.
Note that the /FILES qualifier does not support defaults for
nonspecified portions of device names; you must supply a complete
device specification.
QUALIFIERS
Additional information available:
/ALLOCATED/BRIEF/FILES/FULL/MOUNTED/OUTPUT
/SYSTEM/WINDOWS
/ALLOCATED
Displays all devices currently allocated to processes. If you specify a device name, the characteristics of only that device are displayed. If the device is not currently allocated, the command displays a message indicating that there is no such device. If you specify a generic device name, the characteristics of all allocated devices of that type are displayed.
/BRIEF
/BRIEF (default)
Displays brief information about the specified devices.
/FILES
Requires SYSPRV (system privilege) or BYPASS privileges to list
read-protected files.
Displays a list of the names of all files open on a volume and
their associated process name and process identification (PID).
The specified device must be a mounted Files-11 volume. If the
specified volume is a multivolume set, the files on each volume in
the set are listed.
NOTE
The SHOW DEVICES/FILES command does not support defaults
for nonspecified portions of device names. You must supply
a complete device specification when using the /FILES
qualifier.
If the /SYSTEM qualifier is also specified, only the names of
installed files and files opened by the system are displayed.
Files opened by the system are those that have been opened without
the use of an ancillary control process (ACP), such as INDEXF.SYS
and QUOTA.SYS, as well as system files such as JBCSYSQUE.EXE and
SYSMSG.EXE.
If the /NOSYSTEM qualifier is specified, only those files opened
by processes are displayed. To list files opened by a process in
your group, your process must have at least GROUP privilege. If
the process is not in your group, you need WORLD privilege.
If neither the /SYSTEM nor the /NOSYSTEM qualifier is specified,
the names of all files currently opened on the system are
displayed.
If a file is read-protected from your user identification code
(UIC), the "No privilege" message is displayed instead of the file
name. You must have SYSPRV (system privilege) privilege or BYPASS
privilege to display the file name.
A space in place of a file name represents a work file (such as
a temporary edit file) not entered in any directory. To display
temporary file names, you must have BYPASS privilege in addition
to GROUP or WORLD privilege.
Do not use the /FILES qualifier with the /ALLOCATED, the /BRIEF,
the /FULL, or the /MOUNTED qualifier. The functions of the /FILES
qualifier and these qualifiers are mutually exclusive.
/FULL
Displays a complete list of information about the devices.
/MOUNTED
Displays all devices that currently have volumes mounted on them. If you specify a device name, only the characteristics of that device are displayed. However, if the device is not currently mounted, the command issues a message indicating there is no such device. If you specify a generic device name, the characteristics of all such devices that currently have volumes mounted are displayed.
/OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. If you do not
enter the qualifier, or if you enter the /OUTPUT qualifier without
a file specification, the output is sent to the current process
default output stream or device, identified by the logical name
SYS$OUTPUT.
If you enter the /OUTPUT qualifier with a partial file
specification (for example, specifying only a directory), SHOW is
the default file name and LIS the default file type. If you enter
a file specification, it may not include any wildcard characters.
If you enter the /NOOUTPUT qualifier, output is suppressed.
/SYSTEM
/SYSTEM
/NOSYSTEM
Controls whether the names of installed files and files opened
by the system are displayed. Files opened by the system are those
that have been opened without the use of an ancillary control
process (ACP), such as INDEXF.SYS and QUOTA.SYS.
If you specify the /NOSYSTEM qualifier with the /FILES qualifier,
only files opened by processes are displayed. If you omit both
the /SYSTEM and /NOSYSTEM qualifiers and specify the /FILES
qualifier, the names of all files currently opened on the system
are displayed.
You can use this qualifier only with the /FILES qualifier. See the
description of the /FILES qualifier for more details.
/WINDOWS
Displays the window count and total size of all windows for files open on a volume. The file name and related process name and process identification (PID) are also displayed. The letter C in a display indicates that the file is open with "cathedral windows" (segmented windows).
Examples
1. $ SHOW DEVICES
Device Device Err. Volume Free Trans Mount
Name Status Count Label Blocks Count Count
DBA0: Online mnt 0 VMS 47088 115 1
DBA1: Online mnt 0 USERPACK1 45216 2 1
DBA2: Online mnt 3 DOCUMENT 8068 20 1
DBA5: Online mnt 0 MASTERP 28668 1 1
DBA6: Online 0
DBA7: Online mnt 0 PROJECT 110547 1 1
DMA0: Online 0
DLA0: Online 0
DYA0: Online 0
DYA1: Online 0
DRA3: Online mnt 0 RES26APR 29317 1 1
In this example, the SHOW DEVICES command displays the
following information for each device on the system:
o Device name
o Device status and characteristics (Status indicates whether
the device is on line; characteristics indicate whether the
device is allocated, is spooled, has a volume mounted on it,
or has a foreign volume mounted on it.)
o Error count
o Volume label (for disk and tape volumes only)
o Number of free blocks on the volume
o Transaction count
o Number of mount requests issued for the volume (disk devices
only)
2. $ SHOW DEVICES/FULL DMA0
Disk NODE1$DMA0:, device type RK07, is online, allocated, mounted,
error logging enabled
Error count 0 Operations completed 1257
Owner UIC [1,4] Owner process name VANNOY
Owner process ID 202000C8 Dev Prot S:RWED,O:RWED,G:RWED,W:RWED
Reference count 2 Default buffer size 512
Volume label JAKE_X239 Relative volume no. 0
Cluster size 1 Transaction count 2
Free blocks 3741 Maximum files allowed 13447
Extend quantity 5 Mount count 1
Volume status Process ACP process name DMA0BACP
File ID cache size 64 Extent cache size 64
Quota cache size 64
Volume is subject to mount verification, file high-water marking
In this example, the SHOW DEVICES command requests a full
listing of the status of the RK07 device DMA0. The device is
located on NODE1 in a VAXcluster.
3. $ SHOW DEVICES/FULL NODE2$
Disk NODE2$DUA0:, device type RA81, is online, mounted,
error logging enabled
Error count 0 Operations completed 24195
Owner UIC [11,177] Owner process name
Owner process ID 20200000 Dev Prot S:RWED,O:RWED,G:RWED,W:RWED
Reference count 16 Default buffer size 512
Volume label VMSDOCLIB Relative volume no. 0
Cluster size 3 Transaction count 17
Free blocks 525447 Maximum files allowed 111384
Extend quantity 5 Mount count 1
Volume status System ACP process name
Caching disabled
Volume is subject to mount verification, file high-water marking
Disk NODE2$DUA1:, device type RA81, is online, error logging enabled
Error count 0 Operations completed 0
Owner UIC [0,0] Owner process name
Owner process ID 20200000 Dev Prot S:RWED,O:RWED,G:RWED,W:RWED
Reference count 0 Default buffer size 512
.
.
.
In this example, the user requested a full display of
information about each device on NODE2 in the VAXcluster.
Information is shown here only for the first two devices: a
mounted device and a device that is not mounted.
/SERVED
Displays information on devices served by the mass storage control
protocol (MSCP) server on this node. The /SERVED qualifier is
required.
Format
SHOW DEVICES/SERVED
Additional information available:
Description
The SHOW DEVICES/SERVED command displays information about the MSCP server and the devices it serves. This information is used mostly by system managers.
QUALIFIERS
Additional information available:
/ALL/COUNT/HOST/OUTPUT/RESOURCE
/ALL
This qualifier displays the information displayed by all of the qualifiers listed below except the /OUTPUT qualifier.
/COUNT
Displays the number of transfer operations completed, sorted by the size of the transfers, and the number of MSCP operations that have taken place since the MSCP server was started.
/HOST
Displays the names of the processors that have MSCP-served devices on line. The System Generation Utility (SYSGEN) command MSCP/HOST determines how many hosts in the cluster can connect to the MSCP server at one time.
/OUTPUT
/OUTPUT=[filespec]
Redirects output from your terminal to the specified file. If you
do not specify a file, or if you do not use this qualifier, output
is sent to SYS$OUTPUT.
/RESOURCE
Displays information on the resources available to the MSCP server
for use in processing I/O requests for the devices it serves.
You make these resources available to the MSCP server when you
use SYSGEN's MSCP command to start the MSCP server and use the
qualifiers listed in the following table:
Qualifier Item Specified
/BUFFER The amount of buffer space available to the MSCP
server.
/FRACTION The maximum size, in pages, of the buffer
granted to an I/O request; for transfers of
more data than will fit a buffer of the size
specified by this qualifier, several computer
interconnect (CI) transfers are needed.
/SMALL The minimum size, in pages, of the buffer that
the MSCP server can grant to an I/O request;
if less than this amount of buffer space is
available, the I/O request must wait until at
least this much buffer space becomes available;
when this much space becomes available, the MSCP
server grants the request a buffer.
/PACKETS The number of I/O-request packets (class driver
request packets [CDRPs]) available to the MSCP
server for processing I/O requests.
Examples
1. $ SHOW DEVICES/SERVED
MSCP Served Devices on BOSTON 19-APR-1990 12:34:56.78
Queue Requests
Device: Status Total Size Current Max Hosts
2$DBA0 AVAIL 340670 0 0 0
2$DMA1 ONLINE 53790 0 0 2
2$DMA0 OFFLINE 53790 0 0 0
This example shows the output generated by the command SHOW
DEVICES/SERVED. The first column in the display shows the names
of the devices that are served by the MSCP server. The second
column shows the status of the devices. The third column shows
the size, in blocks, of the device.
The Queue Requests columns show the number of I/O requests
currently awaiting processing by that device and the maximum
number of I/O requests that have ever been concurrently
awaiting processing by that device. The last column in the
display shows the number of hosts that have the device on line.
2. $ SHOW DEVICES/SERVED/COUNT
MSCP Served Devices on BOSTON 19-APR-1990 12:34:58.
Request Count:
0-7: 1 32-39: 8 88-103: 7
8-15: 0 40-55: 0 104-127: 0
16-23: 0 56-71: 8
24-31: 0 72-87: 20
Operations Count:
ABORT 0 ERASE 0 READ 0
ACCESS 0 FLUSH 0 REPLACE 0
AVAILABLE 0 GET CMD STS 0 SET CTL CHR 10
CMP CTL DAT 0 GET UNT STS 2799 SET UNT CHR 0
CMP HST DAT 0 ONLINE 0 WRITE 0
Total 2809
This example shows the information displayed by the SHOW
DEVICES/SERVED/COUNT command. The numbers to the left of the
colon (:), separated by a hyphen (-), are the size, in pages,
of the requests. The numbers to the right of the colon are the
number of requests of that size that have been processed by the
MSCP server.
The section of the display headed by the label Operations Count
shows the number of times the MSCP server has performed the
MSCP operations listed. In the example, this MSCP server has
performed 10 set-controller-characteristics (SET CTL CHR)
operations, but has performed no set-unit-characteristics (SET
UNT CHR) operations.
3. $ SHOW DEVICES/SERVED/RESOURCE
MSCP Served Devices on BOSTON 19-APR-1990 12:34:58.82
Fragment Size
Resources: Total Free In Use Minimum Maximum
Buffer area: 64 64 0 4 32
I/O Packets: 144 144
Current Maximum
Buffer wait: 0 0
This example shows the information displayed by the SHOW
DEVICES/RESOURCE command. The Total column shows the total
number of pages in the buffer area and in the number of I/O-
request packets set aside for use by the MSCP server. The Free
column shows the number of pages in the buffer and the number
of I/O-request packets that are available for use.
The In Use column shows the number of pages within the buffer
area that are in use. The columns labeled Fragment Size show
the minimum and the maximum size, in pages, of a buffer that an
I/O request can obtain from the buffer area.
The line labeled Buffer wait shows the number of I/O requests
that are currently waiting for buffer space to become available
for their use, and the maximum number of I/O requests that have
waited concurrently to obtain a buffer.
4. $ SHOW DEVICES/SERVED/HOST
MSCP Served Devices on BOSTON 19-APR-1990 12:34:58.82
Queue Requests
Host: Time of Connection Current Max Devices
HARVEY 19-APR-1990 12:57:39.90 0 1 2
DOC 19-APR-1990 22:02:10.25 0 1 0
GRUMPY 19-APR-1990 22:02:10.25 0 0 1
SLEEPY 19-APR-1990 22:02:11.75 0 1 0
This example shows the information displayed by the SHOW
DEVICES/SERVED/HOST command. The first column contains the
names of the hosts that have class drivers connected to the
MSCP server. The next column contains the times at which these
connections were made.
The columns under the heading Queue Requests show the number
of requests the MSCP server currently has outstanding for I/O
activity on the devices it serves, the maximum number of such
requests that have been outstanding at one time, and the number
of MSCP-served devices that the listed hosts have on line.
DISPLAY
Indicates the node where output from a DECwindows application will
be displayed.
Format
SHOW DISPLAY [display-device]
Additional information available:
Parameters
display-device Refers to the display-device parameter specified with the SET DISPLAY command. If you are directing application output to multiple workstations in the same session, you can use logical names to point to each workstation. Using the SHOW DISPLAY command, you can specify this logical name as the display-device parameter to see where application output will be displayed. If you do not specify a display-device string, the logical name DECW$DISPLAY is used.
Example
$ SHOW DISPLAY
Device: WSA1:
Node: 0
Transport: LOCAL
Server: 0
Screen: 0
$ SET DISPLAY/CREATE/NODE=ZEPHYR
$ SHOW DISPLAY
Device: WSA2:
Node: ZEPHYR
Transport: DECNET
Server: 0
Screen: 0
$ SPAWN/NOWAIT/INPUT=NL: RUN SYS$SYSTEM:DECW$CLOCK
$ SET DISPLAY/NOPERMANENT
$ SHOW DISPLAY
Device: WSA1:
Node: 0
Transport: LOCAL
Server: 0
Screen: 0
In this example, you are logged in to your workstation, here
referred to as node 0. (0 is the standard shorthand notation
for representing your node.) You want to run the DECwindows
Clock on your workstation and display it on another node,
ZEPHYR.
Assuming you are authorized to display applications on ZEPHYR,
you redirect the application's output to ZEPHYR with the SET
DISPLAY command and enter the SHOW DISPLAY command to verify
the location of the redirected display. You then run Clock.
When you finish running Clock, you disable the redirected
display by entering the SET DISPLAY/NOPERMANENT command.
Finally, you enter the SHOW DISPLAY command to verify that
any applications subsequently run on your node will also be
displayed there.
Note that a new workstation display device, WSA2, is created
when you enter the SET DISPLAY/CREATE command. When you
cancel the redirected display with the SET DISPLAY/NOPERMANENT
command, application output is once again displayed on the
workstation display device referred to by WSA1.
ENTRY
Displays information about a user's batch and print jobs or about
specific job entries.
Requires GROUP privilege to display all jobs in your group.
Requires OPER (operator) privilege to display all jobs in all
groups.
Format
SHOW ENTRY [entry-number[,...]],[job-name[,...]]
Additional information available:
PARAMETER
entry-number[,...] Specifies the entry number of the job you want displayed. If no entry number is specified, all your own jobs (or those owned by the user specified with the /USER_NAME qualifier) are displayed. job-name[,...] Specifies the name of the jobs you want displayed. Wildcard characters (* and %) are allowed. If no job name or entry number is specified, all your own jobs (or those owned by the user specified with the /USER_NAME qualifier) are displayed.
QUALIFIERS
Additional information available:
/BATCH/BRIEF/BY_JOB_STATUS/DEVICE/FILES/FULL
/GENERIC/OUTPUT/USER_NAME
/BATCH
Selects batch jobs for display. If the /USER_NAME qualifier is not specified, information about your own jobs is displayed.
/BRIEF
/BRIEF (default)
Displays the following information for each job: job name, user
name, entry number, job size in blocks (for print jobs), status,
queue name, and queue type. The /FULL and /FILES qualifiers
override the /BRIEF qualifier.
Specify the /FULL qualifier to obtain more job information.
/BY_JOB_STATUS
/BY_JOB_STATUS[=(keyword,...)]
Selects for display only those jobs with the specified status.
Specify the status with one or more of the following keywords:
EXECUTING Requests the display of jobs in any of the
following states:
o ABORTING o STALLED
o EXECUTING o STARTING
o PRINTING o SUSPENDED
o PROCESSING
ABORTING means that the job is halting prior
to normal completion and will not continue
processing. A STALLED or SUSPENDED state means
that the job stopped during processing, but
should continue when the cause of the STALLED
or SUSPENDED state is resolved. PROCESSING is
the executing state for server queues. PRINTING
is the executing state for printer and terminal
queues. STARTING means the job is beginning to be
processed.
HOLDING Requests the display of jobs on hold. Holding
status indicates that the job is being held in the
queue indefinitely.
PENDING Requests the display of jobs with pending status.
Pending status indicates that the job is waiting
its turn to execute.
RETAINED Requests the display of jobs retained in the queue
after execution. Retained status indicates that
the job has completed but remains in the queue.
For example, a job may be retained in the queue if
there was an error during its execution.
TIMED_RELEASE Requests the display of jobs on hold until a
specified time. Timed release status indicates
that the job is being held in the queue for
execution at a future time.
If no keyword is specified, the /BY_JOB_STATUS qualifier displays
the status of all jobs.
If the /USER_NAME qualifier is not specified, information about
your own job is displayed.
/DEVICE
/DEVICE[=(keyword,...)]
Selects for display only those print jobs in the queue types
specified. Specify the queue type with one or more of the
following keywords:
PRINTER Requests the display of jobs in print queues.
SERVER Requests the display of jobs in server queues.
TERMINAL Requests the display of jobs in terminal queues.
If no keyword is specified, the /DEVICE qualifier displays all
printer, terminal, and server queues.
If the /USER_NAME qualifier is not specified, information about
your own jobs is displayed.
/FILES
Adds to the default display the list of full file specifications for each file in each job.
/FULL
Displays the following information for each job: job name, user name, entry number, job status, full file specification associated with each job, date and time of submission, settings specified for the job, queue name, and queue type. The /FULL qualifier overrides the default brief listing format.
/GENERIC
Selects for display only those jobs contained in generic queues. A generic queue holds jobs of a particular type (for example, batch or line printer jobs) and directs them to execution queues for processing. If the /USER_NAME qualifier is not specified, information about your own jobs is displayed.
/OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the SHOW ENTRY command is sent. By
default, the output is sent to the current SYS$OUTPUT device
(usually your terminal). To send the output to a file, use the
/OUTPUT qualifier followed by a file specification.
Wildcard characters are not allowed in the file specification. If
you enter a partial file specification (for example, specifying
only a directory), SHOW is the default file name and LIS is the
default file type.
If you enter the /NOOUTPUT qualifier, output is suppressed.
/USER_NAME
/USER_NAME=username
Selects for display those jobs owned by the specified user. If
the /USER_NAME qualifier is not specified, information about
your own jobs is displayed. The name must be 1 to 12 alphanumeric
characters.
Examples
1. $ SHOW ENTRY/DEVICE=(PRINTER,TERMINAL)
Jobname Username Entry Blocks Status
------- -------- ----- ------ ------
FORECAST JONES 422 12 Printing
On printer queue LN01$PRINT
MANAGER JONES 431 4 Printing
On terminal queue LQ$PRINT
In this example, SHOW ENTRY produces a display of your current
job entries on all printer and terminal queues.
2. $ SHOW ENTRY/USER_NAME=MACDUFF/FULL
Jobname Username Entry Blocks Status
------- -------- ----- ------ ------
STAFF MACDUFF 625 112 Pending
On printer queue LN01$PRINT
Submitted 19-APR-1990 12:14 /FORM=LN01$PORTRAIT (stock=DEFAULT)
/NOTIFY /PRIORITY=100
_DBA1:[MACDUFF]STAFF.DIS;3 (pending)
MEMO MACDUFF 629 94 Printing at block 37
One printer queue LINE$PRINT
Submitted 19-APR-1990 12:16 /FORM=DEFAULT /NOTIFY /PRIORITY=100
_DBA1:[MACDUFF.DAILY]MEMO.TXT;2 (printing copy 2)
/COPIES=2 /NOFEED /PASSALL
In this example, DUNCAN has requested a display of the current
entries owned by MACDUFF on all queues. The /FULL qualifier
lists the submission information, the full file specification,
and the current settings for both the job and the queue.
Note that entry 629 specified the /COPIES, /NOFEED, and
/PASSALL qualifiers to the PRINT command. The /NOFEED qualifier
suppresses automatic form feeds. The /PASSALL qualifier
suppresses formatting (including form feeds and carriage return
characters) performed by the print symbiont.
3. $ SUBMIT ASSIGNMENTS.COM
Job ASSIGNMENTS.COM (queue SYS$BATCH, entry 199) pending
.
.
.
$ SHOW ENTRY 199
Jobname Username Entry Status
------- -------- ----- ------
ASSIGNMENTS JONES 199 Executing
On batch queue WRITER_BATCH
In this example, JONES submits ASSIGNMENTS.COM for batch
processing. Because JONES does not specify a specific queue,
the job is entered into the generic SYS$BATCH queue to await
processing. After performing other tasks, JONES checks the
status of her job and sees that her file is now executing.
Note that the job entry migrated from a generic to an execution
batch queue and that JONES was able to check the status of
her job without knowing the specific batch queue name. If she
did not specify an entry number, all her jobs would have been
displayed.
ERROR
Displays the error count for all devices with error counts greater
than zero.
Format
SHOW ERROR
Additional information available:
QUALIFIERS
Additional information available:
/FULL
Displays the error count for all devices, including those with no errors. (The error count is either zero or a number greater than zero.)
/OUTPUT
/OUTPUT[=filespec]
/OUTPUT=SYS$OUTPUT (default)
Specifies the file to which the display is written. By default,
the display is written to the current SYS$OUTPUT device.
If you enter the /OUTPUT qualifier with a partial file
specification (for example, specifying only a directory), SHOW
is the default file name and LIS the default file type. Wildcard
characters are not allowed in the file specification.
If you enter the /NOOUTPUT qualifier, output is suppressed.
Example
$ SHOW ERROR
Device Error Count
CPU: 2
MEMORY: 1
DBB1: 9
The SHOW ERROR command displays the error count for all devices
with error counts greater than zero.
INTRUSION
Displays the contents of the break-in database.
Requires the CMKRNL (change mode to kernel) and SECURITY
privileges.
Format
SHOW INTRUSION
Additional information available:
QUALIFIERS
Additional information available:
/OUTPUT
/OUTPUT[=filespec]
Directs the output from the SHOW INTRUSION command to the file
specified with the qualifier. By default, output from the command
is displayed to SYS$OUTPUT.
/TYPE
/TYPE=keyword
Selects the type of information from the break-in database that is
displayed. The valid keywords are as follows:
ALL All break-in entries. By default, all entries are
displayed.
SUSPECT Break-in entries for login failures that have occurred
but have not yet passed the threshold necessary to be
identified as an intruder.
INTRUDER Break-in entries for which the login failure rate was
high enough to warrant evasive action.
Examples
1. $ SHOW INTRUSION/OUTPUT=INTRUDER.LIS
The SHOW INTRUSION command in this example writes all the
entries currently in the break-in database to the file
INTRUDER.LIS.
2. $ SHOW INTRUSION/TYPE=INTRUDER
Intrusion Type Count Expiration Source
TERMINAL INTRUDER 9 10:29:39.16 AV34C2/LC-1-15:
NETWORK INTRUDER 7 10:47:53.12 BNKRPT::CAMPEAU
In this example, the SHOW INTRUSION command displays all
intruder entries currently in the break-in database.
KEY
Displays the key definitions created with the DEFINE/KEY command.
Format
SHOW KEY [key-name]
Additional information available:
PARAMETER
key-name Specifies the name of the key whose definition you want displayed. For a list of valid key names, see the DEFINE/KEY command.
QUALIFIERS
Additional information available:
/ALL/BRIEF/DIRECTORY/FULL/STATE
/ALL
Displays all key definitions in the current state (or the state specified with the /STATE qualifier). If you use the /ALL qualifier, do not specify a key name.
/BRIEF
/BRIEF (default)
/NOBRIEF
Displays only the key definition and state. The /BRIEF and /NOFULL
qualifiers are equivalent.
/DIRECTORY
Displays the names of all states for which keys have been defined. If you have not specified a state with a key definition, the SHOW KEY/DIRECTORY command displays DEFAULT for the state. You cannot use the /DIRECTORY qualifier with any of the other SHOW KEY qualifiers.
/FULL
/FULL
/NOFULL (default)
Displays all qualifiers associated with a definition. By default,
only the state of the definition and the definition itself are
displayed. The /FULL and /NOBRIEF qualifiers are equivalent.
/STATE
/STATE=(state-name[,...])
/NOSTATE
Displays the key definitions for the specified state.
If you specify only one state name, you can omit
the parentheses. State names can be any appropriate
alphanumeric string. State names are created with the
DEFINE/KEY command.
If you omit the /STATE qualifier or use the /NOSTATE qualifier,
key definitions in the current state are displayed.
Example
$ DEFINE/KEY/TERMINATE PF1 "ATTACH GEORGE"
%DCL-I-DEFKEY, DEFAULT key PF1 has been defined
$ SHOW KEY PF1
DEFAULT keypad definitions:
PF1 = "ATTACH GEORGE"
$ SHOW KEY/FULL PF1
DEFAULT keypad definitions:
PF1 = "ATTACH GEORGE" (noecho,terminate,noerase,nolock)
The SHOW KEY command in this example displays both the
definition and the state for the PF1 key. This is the default
display. The SHOW KEY/FULL command displays all qualifiers
associated with the key definition.
LICENSE
Displays software product licenses active on the current node.
Format
SHOW LICENSE [product-name]
Additional information available:
PARAMETER
product-name Specifies the name or names of activated software product licenses to display. Wildcard characters (* and %) are allowed. If you do not specify a product name, information is displayed about all active product name licenses. The product-name parameter is incompatible with the /CHARGE_TABLE qualifier.
QUALIFIERS
Additional information available:
/BRIEF/CHARGE_TABLE/OUTPUT/PRODUCER
/BRIEF
Displays a summary of information about the specified active product licenses. You cannot use the /BRIEF qualifier with the /CHARGE_TABLE qualifier.
/CHARGE_TABLE
Displays information in the current Charge Table, also known as the License Unit Requirement Table (LURT), for the current VAX computer. The /CHARGE_TABLE qualifier is incompatible with the product-name parameter, and the /BRIEF and /PRODUCER qualifiers.
/OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the SHOW LICENSE command is sent.
By default, the output of the SHOW LICENSE command is sent to the
current SYS$OUTPUT device (usually your terminal). To send the
output to a file, use the /OUTPUT qualifier followed by a file
specification.
Wildcard characters are not allowed in the file specification. If
you enter a partial file specification (for example, specifying
only a directory), SHOW is the default file name and LIS is the
default file type.
If you enter the /NOOUTPUT qualifier, output is suppressed.
/PRODUCER
/PRODUCER=producer-name
Displays software product licenses active on the current node and
supplied by the specified producer. Wildcard characters (* and %)
are allowed for the producer-name parameter. You cannot use the
/PRODUCER qualifier with the /CHARGE_TABLE qualifier.
Examples
1. $ SHOW LICENSE
Active licenses on node WTPOOH:
DVNETEND
Producer: DEC
Units: 0
Version: 5.4
Date: (none)
Termination Date: (none)
Availability: E (System Integrated Products)
Activity: 0
MOD_UNITS
VAX-VMS
Producer: DEC
Units: 0
Version: 5.4
Date: (none)
Termination Date: (none)
Availability: A (VMS Capacity)
Activity: 0
MOD_UNITS
NO_SHARE
The SHOW LICENSE command in this example displays all the
active licenses on the current node named WTPOOH.
2. $ SHOW LICENSE/BRIEF
Active licenses on node WTPOOH:
------- Product ID -------- ---- Rating ----- -- Version --
Product Producer Units Avail Activ Version Date Expires
DVNETEND DEC 0 E 0 5.3 (none) (none)
VAX-VMS DEC 0 A 0 5.3 (none) (none)
The SHOW LICENSE command in this example displays a summary of
all the active licenses on the current node named WTPOOH.
3. $ SHOW LICENSE/CHARGE_TABLE
VMS/LMF Charge Information for node WTPOOH
This is a VAX 8800, hardware model type 18
Type: A, Units Required: 93 (VMS Capacity)
Type: B, * Not Permitted * (VMS Server)
Type: C, * Not Permitted * (VMS Concurrent User)
Type: D, * Not Permitted * (VMS Workstation)
Type: E, Units Required: 400 (System Integrated Products)
Type: F, Units Required: 1200 (Layered Products)
The SHOW LICENSE command in this example displays license unit
requirements for the current VAX computer with the NODE name
WTPOOH. For a description of how to use this information, see
the VMS License Management Utility Manual, part of the VMS Base
Documentation Set.
4. $ SHOW LICENSE/OUTPUT=SYS$LOGIN:ACTIVE_LICENSES_OCT30.DAT
The SHOW LICENSE command in this example writes all the active
licenses to the file named SYS$LOGIN:ACTIVE_LICENSES_OCT30.DAT.
LOGICAL
Displays translations, the level of translation, and the logical
name table for a specified logical name. The SHOW LOGICAL command
performs iterative translations.
Requires read (R) access to the table in which a logical name is
cataloged to display information about the logical name.
Format
SHOW LOGICAL [logical-name[:][,...]]
Additional information available:
PARAMETER
logical-name[:][,...] Specifies one or more logical names whose translations you want to display. Wildcard characters (* and %) are allowed. However, if a wildcard character is used, iterative translation is not done. The logical name is translated iteratively up to a number of times determined by the system (from 9 to 11). That is, translations are examined to see if they are also logical names.
QUALIFIERS
Additional information available:
/ACCESS_MODE/ALL/DESCENDANTS/FULL/GROUP
/JOB/OUTPUT/PROCESS/STRUCTURE/SYSTEM/TABLE
/ACCESS_MODE
/ACCESS_MODE=mode
Displays names defined in the specified access mode and any inner
access modes. You can specify one of the following keywords to
indicate the access mode: USER_MODE, SUPERVISOR_MODE, EXECUTIVE_
MODE, or KERNEL_MODE.
The default value for this qualifier is USER_MODE; by default any
definitions in all four access modes are displayed.
/ALL
/ALL (default)
Indicates that all logical names in the specified logical name
tables are to be displayed. If you do not enter the /PROCESS,
the /JOB, the /GROUP, the /SYSTEM, or the /TABLE qualifier, all
logical names in the tables specified by the logical name LNM$DCL_
LOGICAL are displayed.
/DESCENDANTS
/DESCENDANTS
/NODESCENDANTS (default)
Controls whether the system displays names from the specified
logical name table and any descendant tables. A descendant table
is created by the CREATE/NAME_TABLE command, with the /PARENT_
TABLE qualifier specifying its parent table. If you use the
/DESCENDANTS qualifier, you must also use the /TABLE qualifier.
/FULL
Displays more detailed information for the specified logical name. The information includes the access mode, attributes, the translation, and the logical name table.
/GROUP
Indicates that only the group logical name table is to be searched. The /GROUP qualifier is synonymous with the /TABLE=LNM$GROUP qualifier. If you specify the /GROUP qualifier and you do not also specify a logical name, all names in the group table are displayed.
/JOB
Indicates that only the job logical name table is to be searched. The /JOB qualifier is synonymous with the /TABLE=LNM$JOB qualifier. If you specify the /JOB qualifier and you do not also specify a logical name, all names in the job logical name table are displayed.
/OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the SHOW LOGICAL command is sent.
By default, the output of the SHOW LOGICAL command is sent to the
current SYS$OUTPUT device (usually your terminal). To send the
output to a file, use the /OUTPUT qualifier followed by a file
specification.
Wildcard characters are not allowed in the file specification. If
you enter a partial file specification (for example, specifying
only a directory), SHOW is the default file name and LIS is the
default file type.
If you enter the /NOOUTPUT qualifier, output is suppressed.
/PROCESS
Indicates that only the process logical name table is to be searched. The /PROCESS qualifier is synonymous with the /TABLE=LNM$PROCESS qualifier. If you specify the /PROCESS qualifier and you do not also specify a logical name, all names in the process table are displayed.
/STRUCTURE
/STRUCTURE
/NOSTRUCTURE (default)
Controls whether the system displays the "family tree" of all
accessible logical name tables. The display includes the two
logical name directory tables (process and system) and all logical
name tables cataloged in these directory tables. Any descendant
logical name tables are shown under their parent tables.
If you specify the /STRUCTURE qualifier, you cannot use any other
qualifiers except /ACCESS_MODE, /FULL, and /OUTPUT.
/SYSTEM
Indicates that only the system logical name table is to be searched. The /SYSTEM qualifier is synonymous with the /TABLE=LNM$SYSTEM qualifier. If you specify the /SYSTEM qualifier and you do not also specify a logical name, all names in the system table are displayed.
/TABLE
/TABLE=(name[,...])
Specifies the tables you want to search. If you specify only
one table, you can omit the parentheses. Wildcards (* and %) are
allowed. Names with wildcards are used to match table names. Names
without wildcards are treated both as table names and table search
lists (whichever is appropriate).
You can use the /TABLE qualifier to specify the following:
o A user-defined logical name table (created with the CREATE
/NAME_TABLE command)
o The process, group, or system logical name tables
o The process or system directory tables
If you specify the table name by using a logical name that
translates to more than one table, then each table is searched
in the order specified. For example, if you specify SHOW LOGICAL
/TABLE=LNM$FILE_DEV, and LNM$FILE_DEV is equated to LNM$PROCESS,
LNM$JOB, LNM$GROUP, and LNM$SYSTEM, then the process, job, group,
and system tables are searched, in that order.
If you do not specify the /TABLE qualifier, the default is
/TABLE=LNM$DCL_LOGICAL.
Examples
1. $ SHOW LOGICAL/PROCESS
(LNM$PROCESS_TABLE)
"SYS$COMMAND" = "_TTB4:"
"SYS$DISK" = "WORK6:"
"SYS$DISK" = "WORK6:"
"SYS$ERROR" = "_TTB4:"
"SYS$INPUT" = "_TTB4:"
"SYS$LOGIN" = "WORK6:[ODONNELL]"
"SYS$LOGIN_DEVICE" = "WORK6:"
"SYS$OUTPUT" = "_TTB4:"
"SYS$OUTPUT" = "DBA2:"
"SYS$SCRATCH" = "WORK6:[ODONNELL]"
The SHOW LOGICAL command in this example displays all
process logical names and their translations. (Note that
/TABLE=LNM$PROCESS would produce the same display as /PROCESS.)
2. $ SHOW LOGICAL INFILE
"INFILE" = "WORK6:[LOGAN]PAYROLL.EXE" (LNM$PROCESS_TABLE)
The SHOW LOGICAL command in this example displays the
translation for the logical name INFILE. The response indicates
that the logical name was found in the process logical name
table.
3. $ SHOW LOGICAL/GROUP
.
.
.
The SHOW LOGICAL command in this example displays all
group logical names and their translations. (Note that
/TABLE=LNM$GROUP would produce the same display as /GROUP.)
4. $ SHOW LOGICAL/TABLE=SYSTEM SYS$LIBRARY
"SYS$LIBRARY" = "SYS$SYSROOT:[SYSLIB]" (LNM$SYSTEM_TABLE)
= "DOCD$:[SYSC.SYSLIB]"
The SHOW LOGICAL command in this example displays the
translation of the logical name SYS$LIBRARY in the system
table. The response indicates that SYS$LIBRARY is defined
in the system table, and that the logical name has two
translations.
5. $ SHOW LOGICAL/TABLE=LNM$GROUP/TABLE=LNM$SYSTEM SYS$DISK
"SYS$DISK" = "ZZZ3:" (LNM$SYSTEM_TABLE)
The SHOW LOGICAL command in this example is qualified by both
the /TABLE=LNM$GROUP and /TABLE=LNM$SYSTEM qualifiers. The
response indicates that the logical name SYS$DISK was found in
the system logical name table. When you enter two conflicting
qualifiers, as in this example, only the last qualifier you
specify is used.
6. $ SHOW LOGICAL/TABLE=LNM$PROCESS_DIRECTORY
The SHOW LOGICAL command in this example displays the logical
names in the process directory table. Each name is either a
table name, or a name that translates iteratively to a table.
MAGTAPE
Displays the current characteristics and status of a specified
magnetic tape device.
Format
SHOW MAGTAPE device-name[:]
Additional information available:
PARAMETER
device-name[:] Specifies the name of the magnetic tape device for which you want to display the characteristics and status.
Description
The SHOW MAGTAPE command displays the current characteristics and status of a specified magnetic tape device. The display shows the device type, density, and format (default or normal PDP-11), as well as any of the following characteristics that currently apply to the device: Position lost Write-locked End-of-tape Even parity End-of-file Odd parity Beginning-of-tape
QUALIFIER
Additional information available:
/OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Specifies the file to which the display is written; by default,
the display is written to the current SYS$OUTPUT device.
If you enter the /OUTPUT qualifier with no file specification, or
if you omit the file name or the file type, SHOW is the default
file name and LIS the default file type. If you enter a file
specification, you may not include any wildcard characters.
If you enter the /NOOUTPUT qualifier, output is suppressed.
Example
$ SHOW MAGTAPE MTA0:
MTA0: UNKNOWN, DENSITY=800, FORMAT=Normal-11
Odd Parity
The SHOW MAGTAPE command in this example displays the
characteristics of the device MTA0.
MEMORY
Displays the availability and usage of those system resources that
are related to memory.
Format
SHOW MEMORY
Additional information available:
QUALIFIERS
Additional information available:
/ALL/FILES/FULL/OUTPUT/PHYSICAL_PAGES/POOL
/SLOTS
/ALL
/ALL (default)
Displays all available information, that is, information displayed
by the /FILES, /PHYSICAL_PAGES, /POOL, and /SLOTS qualifiers.
/FILES
Displays information about the use of each paging and swapping file currently installed.
/FULL
Displays additional information about the use of each pool area or paging and swapping file currently installed, when used with the /POOL or the /FILES qualifier. This qualifier is ignored unless the /FILES or the /POOL qualifier is specified explicitly.
/OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. If you do not
enter the qualifier, or if you enter the /OUTPUT qualifier without
a file specification, the output is sent to the current process
default output stream or device, identified by the logical name
SYS$OUTPUT.
If you enter the /OUTPUT qualifier with a partial file
specification (for example, specifying only a directory), SHOW is
the default file name and LIS the default file type. If you enter
a file specification, it may not include any wildcard characters.
If you enter the /NOOUTPUT qualifier, output is suppressed.
/PHYSICAL_PAGES
Displays information about the amount of physical memory and the number of free and modified pages.
/POOL
Displays information about the usage of each dynamic memory (pool) area, including the amount of free space and the size of the largest contiguous block in each area.
/SLOTS
Displays information about the availability of partition control block (PCB) vector slots and balance slots.
Example
$ SHOW MEMORY
The SHOW MEMORY command in this example displays all memory
resource information, that is, information displayed by the
/FILES, /PHYSICAL_MEMORY, /POOL, and /SLOTS qualifiers.
NETWORK
Displays the availability of the local node as a member of
the network and the addresses and names of all nodes that are
currently accessible to the local node. The SHOW NETWORK command
also displays link and cost relationships between the local node
and other nodes in the network.
Format
SHOW NETWORK
Additional information available:
QUALIFIER
Additional information available:
/OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. If you do not
enter the qualifier, or if you enter the /OUTPUT qualifier without
a file specification, the output is sent to the current process
default output stream or device, identified by the logical name
SYS$OUTPUT.
If you enter the /OUTPUT qualifier with a partial file
specification (for example, specifying only a directory), SHOW
is the default file name and LIS is the default file type. If
you enter a file specification, it cannot include any wildcard
characters.
If you enter the /NOOUTPUT qualifier, output is suppressed.
Example
$ SHOW NETWORK
VAX/VMS Network Status for local node 2.161 ARAKIS on
19-APR-1990 09:18:03.07
The next hop to the nearest area router is node 2.62 ZEUS.
Node Links Cost Hops Next Hop to Node
2.161 ARAKIS 0 0 0 Local -> 2.161 ARAKIS
2.1 RAEL 0 8 1 UNA-0 -> 2.1 RAEL
2.2 PANGEA 0 8 1 UNA-0 -> 2.2 PANGEA
2.3 TWDEE 0 10 2 UNA-0 -> 2.63 AURORA
2.4 TWDUM 0 8 1 UNA-0 -> 2.4 TWDUM
2.11 NEONV 0 8 1 UNA-0 -> 2.11 NEONV
2.63 AURORA 0 8 1 UNA-0 -> 2.63 AURORA
Total of 7 nodes.
If your local node is a nonrouting or end node and you enter
the SHOW NETWORK command, the following message is displayed:
This is a nonrouting node, and does not have any network
information. The designated router for node _nodename is
node_number_name.
PRINTER
Displays the current settings for a printer.
Format
SHOW PRINTER device-name[:]
Additional information available:
PARAMETER
device-name[:] Specifies the name of the printer for which settings are to be displayed.
QUALIFIER
Additional information available:
/OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. By default,
the output of the SHOW PRINTER command is sent to the current
SYS$OUTPUT device (usually your terminal). To send the output to a
file, use the /OUTPUT qualifier followed by a file specification.
Wildcard characters are not allowed in the file specification. If
you enter a partial file specification (for example, specifying
only a directory), SHOW is the default file name and LIS is the
default file type.
If you enter the /NOOUTPUT qualifier, output is suppressed.
Example
$ SHOW PRINTER LPA0:
Printer LPA0:, device type LP11, is online, allocated, spooled
Error count 0 Operations completed 880
Owner process "SYMBIONT_0001" Owner UIC [0,0]
Owner process ID 21C0008D Dev Prot S:RWLP,O:RWLP,G:RWLP,W:RWLP
Reference count 2 Default buffer size 132
Page width 132 Page Length 66
No Carriage_return Formfeed Lowercase
No Passall No Wrap Printall
No Fallback
Intermediate device: STAR$DBA1:
Associated queue: LN01$PRINT
The SHOW PRINTER command in this example displays the settings
for the printer LPA0.
PROCESS
Displays information about a process and its subprocesses.
Requires GROUP privilege to show other processes in the same
group. Requires WORLD privilege to show processes outside your
group.
Format
SHOW PROCESS [[node-name::]process-name]
Additional information available:
PARAMETERS
node-name:: The name of the node on which the specified process is running. The node name can have as many as six alphanumeric characters. The two colons (::) count for two additional characters, for a total of eight. You cannot specify a node name on a different VAXcluster from the current process. process-name The name of the process about which information is to be displayed. The process name can have up to 15 alphanumeric characters. The specified process must be in the same group as the current process.
QUALIFIERS
Additional information available:
/ACCOUNTING/ALL/CONTINUOUS/IDENTIFICATION
/MEMORY/OUTPUT/PRIVILEGES/QUOTAS/RIGHTS/SUBPROCESSES
/ACCOUNTING
Displays the accumulated accounting statistics for the process.
/ALL
Displays the basic subset of information as well as accounting statistics, privileges, quotas, and subprocesses. Displays memory use for the current process.
/CONTINUOUS
Displays continuously updated information about the local process in a VAXcluster environment. You cannot use the /CONTINUOUS qualifier to display information about a process on another node in a VAXcluster environment. While the continuous display is running, you can press the V key to display a map of the pages in the virtual address space of the process. Each character displayed in the map represents the type of page. If the current program counter is in the page, the page type is indicated by an at sign (@). Pages locked in the working set are indicated by the letter L. Global pages are indicated by the letter G. Other valid pages in the working set are indicated by an asterisk (*). To terminate the continuous display, press the E key. To return to the original display, press the space bar. The /CONTINUOUS qualifier may not be used with the /OUTPUT qualifier.
/IDENTIFICATION
/IDENTIFICATION=pid
Requires GROUP or WORLD privilege to access processes other than
your own.
Displays information about the process with the specified process
identification (PID). The PID is assigned by the system when
the process is created. When you specify a PID, you can omit the
leading zeros.
If you specify the /IDENTIFICATION qualifier, it overrides the
process-name parameter. If, in addition, you specify the /MEMORY
qualifier, the PID value must be that of the current process.
/MEMORY
Displays the process's use of dynamic memory areas. The /MEMORY qualifier is allowed only for the current process.
/OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. By default,
the output of the SHOW PROCESS command is sent to the current
SYS$OUTPUT device (usually your terminal). To send the output to a
file, use the /OUTPUT qualifier followed by a file specification.
Wildcard characters are not allowed in the file specification. If
you enter a partial file specification (for example, specifying
only a directory), SHOW is the default file name and LIS is the
default file type.
If you enter the /NOOUTPUT qualifier, output is suppressed.
The /OUTPUT qualifier is incompatible with the /CONTINUOUS
qualifier.
/PRIVILEGES
Displays current privileges for the process.
/QUOTAS
Displays, for each resource, either a quota or a limit. The values displayed for quotas reflect any quota reductions resulting from subprocess creation. The values displayed for limits reflect the resources available to a process at creation.
/RIGHTS
/RIGHTS (default)
/NORIGHTS
Determines whether the current rights are displayed for the
specified process.
/SUBPROCESSES
Displays the current subprocesses in hierarchical order.
Examples
1. $ SHOW PROCESS OCALA::MALIK
19-APR-1990 15:35:19.39 User: MALIK Process ID: 28200364
Node: OCALA Process name: MALIK
Terminal: RTA5:
User identifier: [VMS,MALIK]
Base priority: 4
Default file spec: WORK5:[MALIK]
Devices allocated: RTA5:
The SHOW PROCESS command in this example is entered on NODE
ATHENS by the user MALIK. The system displays the subset
of information for the owned process on node OCALA. The
information includes the following:
o Date and time the SHOW PROCESS command is entered
o User name
o Process identification number (PID)
o Node name
o Process name
o Device name of the current SYS$INPUT device
o User identification code (UIC)
o Base execution priority
o Default device (only for processes on the same node)
o Default directory (only for current processes)
o Devices allocated to the process and volumes mounted, if any
2. $ SHOW PROCESS/ACCOUNTING
19-APR-1990 14:48:01.31 User: MALIK Process ID: 28200364
Node: OCALA Process name: "MALIK"
Accounting information:
Buffered I/O count: 4878 Peak working set size: 844
Direct I/O count: 1284 Peak virtual size: 1176
Page faults: 6100 Mounted volumes: 0
Images activated: 22
Elapsed CPU time: 0 00:01:20.51
Connect time: 0 04:06:03.75
The SHOW PROCESS command in this example displays the
accounting statistics for the process.
3. $ SHOW PROCESS/PRIVILEGES
19-APR-1990 14:59:28.53 User: MALIK Process ID: 28200364
Node: OCALA Process name: "MALIK"
Process privileges:
GROUP may affect other processes in same group
TMPMBX may create temporary mailbox
NETMBX may create network device
Process rights identifiers:
INTERACTIVE
DIALUP
The SHOW PROCESS command in this example displays the current
privileges for the process.
4. $ SHOW PROCESS/QUOTAS
19-APR-1990 15:00:28.79 User: MALIK Process ID: 28200364
Node: OCALA Process name: "MALIK"
Process Quotas:
Account name: VMS
CPU limit: Infinite Direct I/O limit: 6
Buffered I/O byte count quota: 17904 Buffered I/O limit: 6
Timer queue entry quota: 10 Open file quota: 31
Paging file quota: 24945 Subprocess quota: 8
Default page fault cluster: 64 AST limit: 14
Enqueue quota: 30 Shared file limit: 9
Max detached processes: 11 Max active jobs: 14
The SHOW PROCESS command in this example displays the available
quotas and limits.
5. $ SHOW PROCESS/SUBPROCESSES
19-APR-1990 15:44:59.39 User: MALIK Process ID: 28200364
Node: OCALA Process name: "MALIK_1"
Processes in this tree:
MALIK
MALIK_1 (*)
MALIK_2
The SHOW PROCESS command in this example shows the current
process tree. The current process is indicated by the asterisk
(*). Processes both below and above the current process are
shown.
6. $ SHOW PROCESS OCALA::MALIK
19-APR-1990 15:35:19.39 User: MALIK Process ID: 28200364
Node: OCALA Process name: MALIK
Terminal: RTA5:
User identifier: [VMS,MALIK]
Base priority: 4
Default file spec: WORK5:[MALIK]
Devices allocated: RTA5:
The SHOW PROCESS command in this example displays the basic
subset of information for the process MALIK on node OCALA.
PROTECTION
Displays the current file protection to be applied to all new
files created during the terminal session or batch job.
Format
SHOW PROTECTION
Additional information available:
Description
The SHOW PROTECTION command displays the current file protection to be applied to all new files created during the terminal session or batch job. You can change the default protection at any time with the SET PROTECTION/DEFAULT command. Use the DIRECTORY/PROTECTION command to see the current protection for one or more specific files.
Example
$ SHOW PROTECTION
SYSTEM=RWED, OWNER=RWED, GROUP=RE, WORLD=NO ACCESS
$ SET PROTECTION=(GROUP:RWED,WORLD:RE)/DEFAULT
$ SHOW PROTECTION
SYSTEM=RWED, OWNER=RWED, GROUP=RWED, WORLD=RE
The SHOW PROTECTION command in this example requests a display
of the current protection defaults and the user identifiers;
the SET PROTECTION/DEFAULT command changes the file access
allowed to other users in the same group and to miscellaneous
system users. The next SHOW PROTECTION command shows the
modified protection defaults.
QUEUE
Displays information about queues and the jobs that are currently
in queues.
Requires GROUP privilege to show all jobs in your group. Requires
OPER (operator) privilege to show all jobs in all groups.
o Display characteristic names and numbers that are available on
queues (see /CHARACTERISTICS).
o Display form names and numbers that are available on queues
(see /FORM).
Format
SHOW QUEUE [queue-name]
Additional information available:
PARAMETER
queue-name Specifies the name of the queue for which you want information displayed. Wildcard characters (* and %) are allowed. The default value for the queue-name parameter is the asterisk wildcard (*). If no queue name is specified, information on all queues is displayed.
QUALIFIERS
Additional information available:
/ALL_JOBS/BATCH/BRIEF/BY_JOB_STATUS/DEVICE/FILES
/FULL/GENERIC/OUTPUT/SUMMARY
/ALL_JOBS
Displays all the jobs in the specified queues. If you do not specify a queue name, the /ALL_JOBS qualifier displays all job entries on all queues. You must have GROUP privilege to show information about all jobs in your group or OPER (operator) privilege to show information about all jobs in all groups.
/BATCH
Displays only batch queues and jobs in those queues.
/BRIEF
/BRIEF (default)
Displays a one-line description of each queue and the jobs that
are in it. This information includes the name, type, and status
of each queue. It also includes the entry number, the job name,
the user name, and status for each job shown. The /FULL and /FILES
qualifiers override the /BRIEF qualifier.
/BY_JOB_STATUS
/BY_JOB_STATUS=(keyword-list)
Displays queues that contain jobs that match the specified status.
By default, jobs owned by the user are displayed. Specify the
status with one or more of the following keywords:
EXECUTING Requests the display of jobs in any of the
following states:
o ABORTING o STALLED
o EXECUTING o STARTING
o PRINTING o SUSPENDED
o PROCESSING
ABORTING means that the job is halting prior
to normal completion and will not continue
processing. A STALLED or SUSPENDED state means
that the job stopped during processing, but
should continue when the cause of the STALLED
or SUSPENDED state is resolved. PROCESSING is
the executing state for server queues. PRINTING
is the executing state for printer and terminal
queues. STARTING means the job is beginning to be
processed or printed.
HOLDING Requests the display of jobs on hold. Holding
status indicates that the job is being held in the
queue indefinitely.
PENDING Requests the display of jobs with pending status.
Pending status indicates that the job is waiting
its turn to execute.
RETAINED Requests the display of jobs retained in the
queue after execution. Retained status indicates
that the job has completed, but it remains in the
queue. For example, a job may be retained in the
queue if there was an error during its execution.
TIMED_RELEASE Requests the display of jobs on hold until a
specified time. Timed release status indicates
that the job is being held in the queue for
execution at a future time.
Note that if you specify the qualifier without a keyword, the
system will only display queues that actually contain jobs.
/DEVICE
/DEVICE[=(keyword-list)]
Displays a particular type of queue and jobs in that queue.
Specify the type of device queue with one or more of the following
keywords:
PRINTER Requests the display of print queues.
SERVER Requests the display of server queues.
TERMINAL Requests the display of terminal queues.
You can specify more than one keyword. If you do not specify a
keyword with the /DEVICE qualifier, all printer, terminal, and
server queues are displayed.
/FILES
Adds to the display the list of files associated with each job. The /FILES qualifier overrides the /BRIEF qualifier.
/FULL
Displays complete information about queues, the jobs contained in queues, and the files associated with the jobs. The /FULL qualifier overrides the /BRIEF qualifier.
/GENERIC
Displays only generic queues and jobs in those queues. A generic queue is not an execution queue. Its function is to hold jobs of a particular type (line printer jobs, for example) and direct them to execution queues for processing. Use the /GENERIC qualifier in conjunction with other qualifiers to display specific information about particular generic queues. For example, use the /GENERIC qualifier along with the /BATCH qualifier to specify information about generic batch queues. Use the /GENERIC qualifier along with the /DEVICE qualifier to determine information concerning generic output queues.
/OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. By default, the
output of the SHOW QUEUE command is sent to the current SYS$OUTPUT
device (usually your terminal). To send the output to a file, use
the /OUTPUT qualifier followed by a file specification.
Wildcard characters are not allowed in the file specification. If
you enter a partial file specification (for example, specifying
only a directory), SHOW is the default file name and LIS is the
default file type.
If you enter the /NOOUTPUT qualifier, output is suppressed.
/SUMMARY
Displays the total number of executing jobs, pending jobs, holding jobs, retained jobs, and timed release jobs for each queue. For output queues, the total block count for pending jobs is also shown.
Examples
1. $ SHOW QUEUE/FULL ARMADA*
Batch queue ARMADA_BATCH, idle, on ARMADA::
/AUTO_START_ON=(ARMADA::) /BASE_PRIORITY=3 /JOB_LIMIT=3 /OWNER=[SYSTEM]
/PROTECTION=(S:E,O:D,G:R,W:W)
Printer queue ARMADA$PRINT, stopped, on ARMADA::LPA0, mounted form
DEFAULT /BASE_PRIORITY=4 /DEFAULT=(FEED,FORM=ELITE (stock=DEFAULT))
/OWNER=[SYSTEM] /PROTECTION=(S:E,O:D,G:R,W:W)
Entry Jobname Username Blocks Status
----- ------- -------- ------ ------
605 SET TELLER 140 Pending (queue stopped)
Submitted 21-JUN-1991 16:14 /FORM=ELITE (stock=DEFAULT)
/PRIORITY=200
/AUTO_START_ON=(ARMADA::) /BASE_PRIORITY=3 /JOB_LIMIT=3 /OWNER=[SYSTEM]
/PROTECTION=(S:E,O:D,G:R,W:W)
Printer queue ARMADA$PRINT, stopped, on ARMADA::LPA0, mounted form
DEFAULT /BASE_PRIORITY=4 /DEFAULT=(FEED,FORM=ELITE (stock=DEFAULT))
/OWNER=[SYSTEM] /PROTECTION=(S:E,O:D,G:R,W:W)
Entry Jobname Username Blocks Status
----- ------- -------- ------ ------
605 SET TELLER 140 Pending (queue stopped)
Submitted 21-JUN-1991 16:14 /FORM=ELITE (stock=DEFAULT)
/PRIORITY=200
File: _$5$DUA1:[TELLER]SET.CLD;5
606 CLOSE TELLER 140 Pending (queue stopped)
Submitted 21-JUN-1991 16:16 /FORM=DEFAULT /PRIORITY=200
File: _$5$DUA1:[TELLER]CLOSE.TXT;2
Printer queue ARMADA$PRINTER_1, idle, on ARMADA::TTA3, mounted form
DEFAULT <Printer queue on node ARMADA for a LN03R printer>
/BASE_PRIORITY=4 /DEFAULT=(FEED,FORM=DEFAULT) /LIBRARY=SMU$DEVCTL
Lowercase /OWNER=[SYSTEM] /PROCESSOR=CPS$SMB
/PROTECTION=(S:E,O:D,G:R,W:W) /SEPARATE=(FLAG)
The SHOW QUEUE command in this example lists information on all of
your current job entries. Complete information about the queues,
the jobs contained in those queues, and the files associated with
the jobs is displayed.
2. $ SHOW QUEUE/ALL/BY_JOB_STATUS=executing
Printer queue KLEE$LCA0, on KLEE::KLEE$LCA0, mounted form DEFAULT
Printer queue SERIFA$LN01, on SERIFA::SERIFA$LPA0, mounted form
LN01$PORTRAIT (stock=DEFAULT)
Jobname Username Entry Blocks Status
------- -------- ----- ------ ------
APPLICA DENNIS 2045 102 Printing
Batch queue SYS_TEX
Jobname Username Entry Status
------- -------- ----- ------
CHAPTER1.JOB MARTIN 1388 Executing
.
.
.
The SHOW QUEUE command in this example displays all the queues
on the system and any jobs within those queues that are
currently executing. Notice that "printing" is an executing
state for printer and terminal queues. "Processing" is an
executing state for server queues.
3. $ SHOW QUEUE/FULL CAXTON_LPA0
Printer queue CAXTON_LPA0, on CAXTON::CAXTON_LPA0, mounted form
80_COLS (stock=BLUE)
/BASE_PRIORITY=100
/DEFAULT=(FEED,FLAG,FORM=40_COLS (stock=WHITE),TRAILER=ONE)
/NOENABLE_GENERIC Lowercase /OWNER=[1,4] /PROTECTION=(S:E,O:D,G:R,W:W)
Jobname Username Entry Blocks Status
------- -------- ----- ------ ------
ACCOUNT MARTIN 880 10 Printing
Submitted 9-AUG-1990 12:49 /FORM=80_COLS (stock=BLUE) /PRIORITY=100
REPORT MARTIN 858 4 Pending
Submitted 8-AUG-1990 17:27 /PRIORITY=100
The SHOW QUEUE command in this example lists any current job
entry you have on the printer queue CAXTON_LPA0. The /FULL
qualifier lists the submission information, the full file
specification, and the current settings for both the job and
the queue.
The job that is currently printing, ACCOUNT, is using a BLUE
paper stock, as indicated by stock=BLUE. Notice that the
default paper stock for the queue is WHITE, as indicated by
stock=WHITE. Before the job ACCOUNT could be run, the operator
had to stop the queue and mount the requested paper stock,
BLUE. However, the next job on the queue, REPORT, expects the
default paper stock of WHITE. Again, the operator must stop the
queue and mount the correct paper stock. The job REPORT remains
in a pending state until this is done.
4. $ SHOW QUEUE/SUMMARY/DEVICE=printer
Generic printer queue CLUSTER_PRINT
1 holding, 1 timed release
Printer queue BREUER$LPB0, on BREUER::BREUER$LPB0, mounted form DEFAULT
empty
Printer queue BAUHAU$LCA0, on BAUHAU::BAUHAU$LCA0, mounted form DEFAULT
2 pending (8 blocks), 1 executing, 1 holding, 4 timed release
1 retained
Generic printer queue LPS
empty
.
.
.
The SHOW QUEUE command in this example lists all the printer
queues and summarizes the status of the jobs that are currently
entered.
/CHARACTERISTIC
Displays information about queue characteristics defined for the
system. A characteristic is a user-defined attribute of a batch or
output queue, such as ink color.
Format
SHOW QUEUE/CHARACTERISTIC
[characteristic-name]
Additional information available:
PARAMETER
characteristic-name Specifies the name of a characteristic. Wildcard characters (* and %) are allowed. The default value for the characteristic- name parameter is the asterisk wildcard (*). Thus, information about all characteristics is displayed when you do not specify a characteristic name. You create a characteristic name with the DEFINE/CHARACTERISTIC command. You can then assign it to a queue by using the INITIALIZE /QUEUE, the SET QUEUE, or the START/QUEUE command with the /CHARACTERISTICS qualifier. You can also specify characteristics for a job by using the /CHARACTERISTICS qualifier with the PRINT, the SUBMIT, or the SET ENTRY command.
QUALIFIER
Additional information available:
/OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. By default the
output of the SHOW QUEUE/CHARACTERISTIC command is sent to the
current SYS$OUTPUT device (usually your terminal). To send the
output to a file, use the /OUTPUT qualifier followed by a file
specification.
The file specification may not include any wildcard characters. If
you enter a partial file specification (for example, specifying
only a directory), SHOW is the default file name and LIS is the
default file type.
If you enter the /NOOUTPUT qualifier, output is suppressed.
Examples
1. $ SHOW QUEUE/CHARACTERISTIC
Characteristic name Number
------------------- ------
REDINK 0
COLOR_CHART 1
TEXMAC_JOB 2
BLUEINK 6
BROWNINK 25
The SHOW QUEUE/CHARACTERISTIC command in this example displays
all the characteristics that have been defined for this system.
2. $ SHOW QUEUE/CHARACTERISTIC *INK
Characteristic name Number
------------------- ------
REDINK 0
BLUEINK 6
BROWNINK 25
The SHOW QUEUE/CHARACTERISTIC command in this example displays
the name and number of all characteristics that end with INK.
/FORM
Displays information about forms defined for the system. Forms
define the size and type paper and the layout of text that are
used for print jobs.
Format
SHOW QUEUE/FORM [form-name]
Additional information available:
PARAMETER
form-name Specifies the name of the form. Wildcard characters (* and %) are allowed. The default value for the form-name parameter is an asterisk (*), which means that the names of all forms on the system are displayed.
QUALIFIERS
Additional information available:
/BRIEF
/BRIEF (default)
Displays a brief description (form names, numbers, and
descriptions) about the forms on the system.
/FULL
Displays a full description (including paper size and margin settings) about the forms on the system.
/OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. By default
the output of the SHOW QUEUE/FORM command is sent to the current
SYS$OUTPUT device (usually your terminal). To send the output to a
file, use the /OUTPUT qualifier followed by a file specification.
The file specification cannot include any wildcard characters. If
you enter a partial file specification (for example, specifying
only a directory), SHOW is the default file name and LIS is the
default file type.
If you enter the /NOOUTPUT qualifier, output is suppressed.
Examples
1. $ SHOW QUEUE/FORM DEFAULT
Form name Number Description
--------- ------ -----------
DEFAULT 0 System-defined default
The SHOW QUEUE/FORM command in this example displays only the
default form.
2. $ SHOW QUEUE/FORM LN01*
Form name Number Description
--------- ------ -----------
LN01_LANDSCAPE (stock=DEFAULT) 105 132 by 66 (landscape)
LN01_LANDSCAPE_INDENTED (stock=DEFAULT)
107 132 by 65 (landscape)
LN01_PORTRAIT (stock=DEFAULT) 106 80 by 60 (portrait)
The SHOW QUEUE/FORM command in this example displays the names
of all forms, including the stock, that begin with LN01. The
display includes the names, stock for each form, numbers, and
brief descriptions of those forms.
3. $ SHOW QUEUE/FORM/FULL
Form name Number Description
--------- ------ -----------
132_51_STD (stock=DEFAULT) 102 132 by 51 (standard short)
/LENGTH=51 /MARGIN=(BOTTOM=6) /STOCK=DEFAULT /TRUNCATE /WIDTH=132
40_66_STD (stock=DEFAULT) 103 40 by 66 (standard labels)
/LENGTH=66 /MARGIN=(BOTTOM=6) /STOCK=DEFAULT /WIDTH=40
BLUE_PAPER_STOCK (stock=DIGITAL_8X11_STOCK1412TEA)
22222 blue paper, DEC order# 22222
/LENGTH=66 /MARGIN=(BOTTOM=6) /STOCK=DIGITAL_8X11_STOCK1412TEA
/TRUNCATE /WIDTH=80
DEFAULT 0 System-defined default
/LENGTH=66 /MARGIN=(BOTTOM=6) /STOCK=DEFAULT /TRUNCATE /WIDTH=132
LN01_LANDSCAPE (stock=DEFAULT) 105 132 by 66 (landscape)
/LENGTH=66 /STOCK=DEFAULT /WIDTH=132
LN01_LANDSCAPE_INDENTED (stock=DEFAULT)
107 132 by 65 (landscape)
/LENGTH=65 /SETUP=(LN01_TOP_MARGIN_150) /STOCK=DEFAULT /WIDTH=132
LN01_PORTRAIT (stock=DEFAULT) 106 80 by 60 (portrait)
/LENGTH=60 /SETUP=(LN01_PORTRAIT) /STOCK=DEFAULT /WIDTH=80
MEMO (stock=DEFAULT) 110 LN03 indented memo format
/LENGTH=64 /MARGIN=(TOP=2,LEFT=5) /STOCK=DEFAULT /TRUNCATE /WIDTH=80
This SHOW QUEUE/FORM command also displays the names of all
form types and stock for the system. By using the /FULL
qualifier, you can see what image size has been set for each
form type.
QUOTA
Displays the current disk quota that is authorized for a specific
user on a specific disk. This display includes a calculation of
the amount of space available and the amount of overdraft that is
permitted.
Requires read (R) access to the quota file in order to display the
quotas of other users.
Format
SHOW QUOTA
Additional information available:
QUALIFIERS
Additional information available:
/DISK
/DISK[=device-name[:]]
Specifies the disk whose quotas are to be examined. By default,
the current default disk (defined by the logical name SYS$DISK) is
examined.
/USER
/USER=uic
Specifies which user's quotas are to be displayed. By default, the
current user's quotas are displayed.
Examples
1. $ SHOW QUOTA
User [360,010] has 2780 blocks used, 7220 available,
of 10000 authorized and permitted overdraft of 500 blocks on DISK$
The SHOW QUOTA command in this example displays the amount of
disk space authorized, used, and still available on the current
default disk for the present user. The permitted overdraft in
this example is 500 blocks.
2. $ SHOW QUOTA /USER=[360,007]/DISK=XXX1:
%SYSTEM-F-NODISKQUOTA, no disk quota entry for this UIC
The SHOW QUOTA command in this example displays the fact that
the user with user identification code (UIC) [360,007] has no
disk quota allocation on device XXX1.
3. $ SHOW QUOTA /USER=[360,111]
User [360,111] has 27305 blocks used, 2305 OVERDRAWN,
of 25000 authorized and permitted overdraft of 4000 blocks on DISK$
The SHOW QUOTA command in this example illustrates a user with
an overdrawn quota.
RMS_DEFAULT
Displays the current default values for the multiblock count, the
multibuffer count, the network transfer size, the prolog level,
and the extend quantity.
Format
SHOW RMS_DEFAULT
Additional information available:
QUALIFIER
Additional information available:
/OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Specifies the file to which the display is written (default is
SYS$OUTPUT). Wildcard characters are not allowed in the file
specification. If you enter the /OUTPUT qualifier with a partial
file specification (for example, specifying only a directory),
SHOW is the default output file name and LIS the default output
file type.
If you enter the /NOOUTPUT qualifier, output is suppressed.
Example
$ SHOW RMS_DEFAULT
MULTI- | MULTIBUFFER COUNTS | NETWORK
BLOCK | Indexed Relative Sequential | BLOCK
COUNT | Disk Magtape Unit Record | COUNT
Process 0 | 0 0 0 0 0 | 0
System 16 | 0 0 0 0 0 | 8
Prolog Extend Quantity
Process 0 0
System 0 0
The SHOW RMS_DEFAULT command in this example shows a system
multiblock count of 16 and a network block count of 8. These
are typical values.
STATUS
Displays the current status of your process.
Format
SHOW STATUS
Additional information available:
Example
$ SHOW STATUS
Status on 19-APR-1990 12:56:48.68 Elapsed CPU : 0 00:00:55.02
Buff. I/O : 5117 Cur. ws. : 300 Open files : 1
Dir. I/O : 458 Phys. Mem. : 162 Page Faults : 8323
The SHOW STATUS command in this example displays the current
status of your process.
SYMBOL
Displays the value of the specified symbol.
Format
SHOW SYMBOL [symbol-name]
Additional information available:
PARAMETER
symbol-name Specifies the name of the symbol whose value you want to display. You must specify a symbol name unless you use the /ALL qualifier. Wildcard characters (* and %) are allowed in the symbol-name parameter.
QUALIFIERS
Additional information available:
/ALL
Displays the current values of all symbols in the specified symbol table (/LOCAL or /GLOBAL). If you specify the /ALL qualifier and do not specify either the /LOCAL or the /GLOBAL qualifier, the SHOW SYMBOL command displays the contents of the local symbol table for the current command level.
/GLOBAL
Searches only the global symbol table for the specified symbol name. If you specify both the /ALL and /GLOBAL qualifiers, all names in the global symbol table are displayed.
/LOCAL
Searches only the local symbol table for the current command level for the specified symbol name. If you specify both the /ALL and /LOCAL qualifiers, all names in the local symbol table for the current command level are displayed.
/LOG
/LOG (default)
/NOLOG
Controls whether the system generates an informational message if
the symbol value has been truncated. The value is truncated if it
exceeds 255 characters.
Examples
1. $ SHOW SYMBOL PURGE
PURGE = "PURGE/KEEP=2"
The SHOW SYMBOL command in this example displays the current
value of the symbol name PURGE. The command interpreter first
searches the local symbol table for the current command level,
then local symbol tables for preceding command levels, and
finally the global symbol table. The single equal sign (=)
following PURGE means it is a local symbol.
2. $ SHOW SYMBOL/GLOBAL/ALL
TIME == "SHOW TIME"
LOG == "@LOG"
$RESTART == "FALSE"
$SEVERITY == "1"
$STATUS == "%X00000001"
The SHOW SYMBOL command in this example displays all the
symbols defined in the global symbol table. Note that the
symbols $RESTART, $STATUS, and $SEVERITY, which are maintained
by the system, are also displayed.
3. $ SHOW SYMBOL/LOCAL TIME
%DCL-W-UNDSYM, undefined symbol
The SHOW SYMBOL command in this example searches only the local
symbol table for the symbol TIME. The response indicates that
TIME currently has no value.
SYSTEM
Displays status information about current processes.
Format
SHOW SYSTEM
Additional information available:
QUALIFIERS
Additional information available:
/BATCH/CLUSTER/FULL/NETWORK/NODE/OUTPUT/PROCESS
/SUBPROCESS
/BATCH
Displays all batch jobs for the local system. When used with the /CLUSTER qualifier, the /BATCH qualifier displays all batch jobs in the VAXcluster environment.
/CLUSTER
Displays all processes on all nodes in a VAXcluster.
/FULL
Displays the user identification code (UIC) in addition to the default information. The UIC is displayed underneath the process name.
/NETWORK
Displays all network processes in the system.
/NODE
/NODE[=(name,...)]
Displays all the processes on the specified node or nodes. If you
enter the /NODE qualifier without a value, the qualifier displays
all the processes on the local node of a VAXcluster environment.
/OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. By default,
the output of the SHOW SYSTEM command is sent to the current
SYS$OUTPUT device (usually your terminal). To send the output to a
file, use the /OUTPUT qualifier followed by a file specification.
The file specification may not include any wildcard characters. If
you enter a partial file specification (for example, specifying
only a directory), SHOW is the default file name and LIS is the
default file type.
If you enter the /NOOUTPUT qualifier, output is suppressed.
/PROCESS
/PROCESS (default)
Displays all processes in the system.
/SUBPROCESS
Displays all subprocesses in the system.
Examples
1. $ SHOW SYSTEM
VAX/VMS 5.4 on node KRYPTON 19-APR-1990 17:45:47.78 Uptime 2 21:53:59
Pid Process Name State Pri I/O CPU Page flts Ph.Mem
27400201 SWAPPER HIB 16 0 0 00:29:52.05 0 0
27401E03 DOCBUILD LEF 4 37530 0 00:05:47.62 96421 601
27402604 BATCH_789 LEF 4 3106 0 00:00:48.67 4909 2636 B
27401C05 BATCH_60 LEF 6 248 0 00:00:06.83 1439 1556 B
27400207 ERRFMT HIB 8 6332 0 00:00:41.83 89 229
27400208 CACHE_SERVER HIB 16 2235 0 00:00:05.85 67 202
27400209 CLUSTER_SERVER HIB 8 4625 0 00:22:13.28 157 448
2740020C JOB_CONTROL HIB 10 270920 0 01:07:47.88 5163 1384
2740020D CONFIGURE HIB 9 125 0 00:00:00.53 104 264
.
.
.
27400E8D Sir Lancelot LEF 5 226 0 00:00:07.87 4560 697
2740049A Guenevere LEF 4 160 0 00:00:02.69 534 477
27401EA0 BATCH_523 CUR 4 4 17470 0 03:25:49.67 8128 5616 B
274026AF GAWAIN CUR 6 4 14045 0 00:02:03.24 20032 397
274016D5 GAHERIS LEF 6 427 0 00:00:09.28 5275 1384
27401ED6 knight_1 HIB 5 935 0 00:00:10.17 3029 2204 S
274012D7 BATCH_689 LEF 4 49216 0 00:14:18.36 7021 3470 B
274032D9 DECW$MAIL LEF 4 2626 0 00:00:51.19 4328 3087 B
274018E3 SERVER_0021 LEF 6 519 0 00:00:07.07 1500 389 N
274016E8 NMAIL_0008 HIB 4 10955 0 00:00:55.73 5652 151
274034EA MORDRED LEF 4 2132 0 00:00:23.85 5318 452
274022EB S. Whiplash CUR 6 4 492 0 00:00:12.15 5181 459
274018EF DwMail LEF 5 121386 0 00:28:00.97 7233 4094
27401AF0 EMACS$RTA43 LEF 4 14727 0 00:03:56.54 8411 4224 S
27400CF4 TRISTRAM HIB 5 25104 0 00:06:07.76 37407 1923
274020F5 Morgan LEF 7 14726 0 00:02:10.74 34262 1669
27400CF6 mr. mike LEF 9 40637 0 00:05:15.63 18454 463
The SHOW SYSTEM command in this example displays all processes
on the system.
The information in this example includes the following:
o Process identification (PID) code-A 32-bit binary value that
uniquely identifies a process.
o Process name-A 1- to 15-character string used to identify a
process.
o Process state-The activity level of the process, such as COM
(computing), HIB (hibernation), LEF (local event flag) wait,
or CUR (if the process is current). If a multiprocessing
environment exists, the display shows the CPU ID of the
processor on which any current process is executing.
Note that the SHOW SYSTEM command examines the processes on
the system without stopping activity on the system. In this
example process information changed during the time that the
SHOW SYSTEM command collected the data to be displayed. As
a result, this display includes two processes, named GAWAIN
and S. Whiplash, with the state CUR on the same CPU, CPU ID
6 in the example.
o Current priority-The priority level assigned to the process
(the higher the number, the higher the priority).
o Total process I/O count-The number of I/O operations
involved in executing the process. This consists of both
the direct I/O count and the buffered I/O count.
o Charged CPU time-The amount of CPU time that a process has
used thus far.
o Number of page faults-The number of exceptions generated by
references to pages that are not in the process's working
set.
o Physical memory occupied-The amount of space in physical
memory that the process is currently occupying.
o Process indicator-Letter B indicates a batch job; letter
S indicates a subprocess; letter N indicates a network
process.
o User identification code (UIC)-An 8-digit octal number
assigned to a process. This number is displayed only if the
/FULL qualifier is specified.
2. $ SHOW SYSTEM /CLUSTER
VAX/VMS V5.4 on node ALPES 19-APR-1990 09:09:58.61 Uptime 0 2:27:11
Pid Process Name State Pri I/O CPU Page flts Ph. Mem
31E00041 SWAPPER HIB 16 0 0 00:00:02.42 0 0
31E00047 CACHE_SERVER HIB 16 58 0 00:00:00.26 80 36
31E00048 CLUSTER_SERVER CUR 9 156 0 00:00:58.15 1168 90
31E00049 OPCOM HIB 7 8007 0 00:00:33.46 5506 305
31E0004A AUDIT_SERVER HIB 9 651 0 00:00:21.17 2267 22
31E0004B JOB_CONTROL HIB 10 1030 0 00:00:11.02 795 202
.
.
.
The SHOW SYSTEM command in this example shows all processes on
all nodes of the cluster.
3. $ SHOW SYSTEM /NODE=EON
VAX/VMS V5.4 on node EON 19-APR-1990 09:19:15.33 Uptime 0 02:29:07
Pid Process Name State Pri I/O CPU Page flts Ph. Mem
36200041 SWAPPER HIB 16 0 0 00:00:12.03 0 0
36200046 ERRFMT HIB 8 263 0 00:00:05.89 152 87
36200047 CACHE_SERVER CUR 16 9 0 00:00:00.26 80 51
36200048 CLUSTER_SERVER CUR 8 94 0 00:00:30.07 340 68
36200049 OPCOM HIB 6 2188 0 00:02:01.04 1999 177
3620004A AUDIT_SERVER HIB 10 346 0 00:00:10.42 1707 72
.
.
.
The SHOW SYSTEM command in this example shows all processes on
the node EON.
TERMINAL
Displays the current characteristics of a specific terminal.
Each characteristic corresponds to an option of the SET TERMINAL
command.
Format
SHOW TERMINAL [device-name[:]]
Additional information available:
PARAMETER
device-name[:] Specifies the name of the terminal for which you want the characteristics displayed. The default is your terminal (SYS$COMMAND).
QUALIFIERS
Additional information available:
/OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. If you do not
enter the qualifier, or if you enter the /OUTPUT qualifier without
a file specification, the output is sent to the current process
default output stream or device, identified by the logical name
SYS$OUTPUT.
If you enter the /OUTPUT qualifier with a partial file
specification (for example, specifying only a directory), SHOW is
the default file name and LIS the default file type. If you enter
a file specification, it may not include any wildcard characters.
If you enter the /NOOUTPUT qualifier, output is suppressed.
/PERMANENT
Requires LOG_IO (logical I/O) or PHY_IO (physical I/O) privilege. Displays the permanent characteristics of the terminal.
Example
$ SHOW TERMINAL
Terminal: _TTE4: Device_Type: VT102 Owner: FRANKLIN
Physical Terminal: _LTA49
Input: 9600 LFfill: 0 Width: 80 Parity: None
Output: 9600 CRfill: 0 Page: 24
Terminal Characteristics:
Interactive Echo Type_ahead No Escape
No Hostsync TTsync Lowercase Tab
Wrap Scope No Remote Eightbit
Broadcast No Readsync No Form Fulldup
No Modem No Local_echo No Autobaud Hangup
No Brdcstmbx No DMA No Altypeahd Set_speed
Line Editing Overstrike editing No Fallback No Dialup
No Secure server No Disconnect No Pasthru No Syspassword
No SIXEL Graphics Soft Characters Printer port Numeric Keypad
ANSI_CRT No Regis No Block_mode Advanced_video
Edit_mode DEC_CRT DEC_CRT2 No DEC_CRT3
In this example, the SHOW TERMINAL command displays the
characteristics of this specific terminal. If you are
displaying statistics about a terminal allocated to another
user, the input, output, LFfill, CRfill, width, page, and
parity statistics are not shown.
TIME
Displays the current date and time.
Format
SHOW [DAY]TIME
Additional information available:
Example
$ SHOW TIME
19-APR-1990 00:03:45
The SHOW TIME command in this example displays the current date
and time.
TRANSLATION
Displays the first translation found for the specified logical
name. You can specify the tables that are searched.
Requires read (R) access to a logical name table to display
information about any logical name cataloged in that table.
Format
SHOW TRANSLATION logical-name
Additional information available:
PARAMETER
logical-name Specifies the logical name whose translation you want to display.
QUALIFIER
Additional information available:
/TABLE
/TABLE=name
Searches the specified table. The default is /TABLE=LNM$DCL_
LOGICAL.
If you specify the table name by using a logical name that
translates to more than one table, then each table is searched
in the order specified until a match is found.
Examples
1. $ SHOW TRANSLATION PAYROLL
PAYROLL = DISK1:[ACCOUNTS.WORKING]FACTOR1.DAT;37 (LNM$PROCESS_TABLE)
The SHOW TRANSLATION command in this example displays the
translation for the logical name PAYROLL and also displays
the name of the table where the logical name was found. In this
example, PAYROLL was found in LNM$PROCESS_TABLE, the process
logical name table.
2. $ DEFINE DISK DBA1:
$ DEFINE/GROUP DISK DBA2:
$ SHOW TRANSLATION DISK
DISK = DBA1:(LNM$PROCESS_TABLE)
The DEFINE commands in this example place entries for the
logical name DISK in both the process and group logical
name tables. Then, the SHOW TRANSLATION command shows the
translation associated with the logical name DISK. By default,
the process, job, group, and system tables are searched (in
that order). The first match found is displayed. The logical
name DISK from the process table (LNM$PROCESS_TABLE) is
displayed because it is found before the name DISK in the group
table.
3. $ RUN ORION
<Ctrl/Y>
$ SHOW TRANSLATION TERMINAL
TERMINAL = _TTT3: (LNM$PROCESS_TABLE)
$ CONTINUE
The RUN command in this example executes the image ORION.EXE.
After the CTRL/Y function interrupts the image, the SHOW
TRANSLATION command displays a logical name assignment. The
CONTINUE command resumes the execution of the image.
4. $ SHOW TRANSLATION/TABLE=LNM$SYSTEM USER
USER = "DBA2:" (LNM$SYSTEM_TABLE)
The SHOW TRANSLATION command in this example displays the
translation for the logical name USER. Because a table name
is specified, the SHOW TRANSLATION command does not use the
default search order. Only the specified table, LNM$SYSTEM, is
searched. LNM$SYSTEM is the system logical name table.
5. $ DEFINE/TABLE=LNM$PROCESS_DIRECTORY MYPROC -
_$ TEST_TABLE, LNM$PROCESS
$ SHOW TRANSLATION/TABLE=MYPROC FILER
FILER = "[SMITH.FILER]" (TEST_TABLE)
In this example, MYPROC defines a list of logical name
tables that you want searched. It asks the system to first
search TEST_TABLE (a user-defined table) and then to search
LNM$PROCESS (the process logical name table). MYPROC is stored
in LNM$PROCESS_DIRECTORY, the process directory table. When you
enter the SHOW TRANSLATION command to find FILER in the MYPROC
table, the tables TEST_TABLE and LNM$PROCESS are searched, in
that order. The first match found is displayed.
USERS
Displays the user name and node name (in a VAXcluster environment)
of interactive, subprocess, and batch users on the system.
Format
SHOW USERS [username]
Additional information available:
PARAMETER
username Specifies the user about whom you want information. Wildcard characters (* and %) are allowed. If you specify a string, all users whose user names begin with the string are displayed. For example, if you specify the string MAR, all user names that begin with MAR are displayed. If no user exists whose name matches the specified string, an informational message to that effect is displayed. If you omit the username parameter, a list of all interactive, subprocess, and batch users is displayed.
QUALIFIER
Additional information available:
/BATCH/CLUSTER/FULL/INTERACTIVE/NETWORK/NODE
/OUTPUT/SUBPROCESS
/BATCH
Displays all batch users in the VAXcluster environment. To restrict the display to users on specific nodes, use the /BATCH qualifier with the /NODE qualifier.
/CLUSTER
Displays all users on all nodes in a VAXcluster environment.
/FULL
Displays the user name, the node name, the process name, the process identification (PID) code, terminal names (both virtual and physical), and port information of all interactive, subprocess, and batch users on the system.
/INTERACTIVE
Displays all interactive users in the VAXcluster environment. To restrict the display to users on specific nodes, use the /INTERACTIVE qualifier with the /NODE qualifier.
/NETWORK
Displays all network users in the VAXcluster environment. To restrict the display to users on specific nodes, use the /NETWORK qualifier with the /NODE qualifier.
/NODE
/NODE[=(name,...)]
Displays all interactive, subprocess, and batch users on the
specified node or nodes. If you enter the /NODE qualifier without
a value, the qualifier displays all the interactive, subprocess,
and batch users on the local node.
/OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. By default, the
output of the SHOW USERS command is sent to the current SYS$OUTPUT
device (usually your terminal). To send the output to a file, use
the /OUTPUT qualifier followed by a file specification.
Wildcard characters are not allowed in the file specification. If
you enter a partial file specification (for example, specifying
only a directory), SHOW is the default file name and LIS is the
default file type.
If you enter the /NOOUTPUT qualifier, output is suppressed.
/SUBPROCESS
Displays all subprocess users in the VAXcluster environment. To restrict the display to users on specific nodes, use the /SUBPROCESS qualifier with the /NODE qualifier.
Examples
1. $ SHOW USERS
VAX/VMS User Processes at 19-APR-1990 08:56:38.95
Total number of users = 30, number of processes = 97
Username Node Interactive Subprocess Batch
1201BUILD CORINTH 1
PHAEDO PYLOS 1
CRITO THEBES 2
MENO SPARTA 1
GORGIAS ATHENS 2
PROTAGORAS HELOS 1 1
.
.
.
The SHOW USERS command in this example displays the user name
and node names of all current interactive, subprocess, and
batch users on the system.
2. $ SHOW USERS *MAR*
VAX/VMS User Processes at 19-APR-1990 14:06.16.24
Total number of users = 3, number of processes = 10
Username Node Interactive Subprocess Batch
GMARTIN MILETS - - 1
GMARTIN LESBOS 5 2
MARRINER ATHENS 1
MARHIEM THEBES 1
The SHOW USERS command in this example displays the user name
and node names of all users whose user names contains the
string MAR.
3. $ SHOW USERS YETTO
VAX/VMS User Processes at 19-APR-1990 08:59:38.76
Total number of users = 1, number of processes = 2
Username Node Interactive Subprocess Batch
YETTO SPHAWK 2
The SHOW USERS command in this example displays the user name
and node name of the user YETTO.
4. $ SHOW USERS R
VAX/VMS User Processes at 19-APR-1990 08:59:38.76
Total number of users = 1, number of processes = 18
Username Node Interactive Subprocess Batch
RADAMS ATHENS 1
RADAMS SRFCLB 16 1
The SHOW USERS command in this example displays the user name
and node names of all users whose user names begin with the
letter R.
5. $ SHOW USERS /FULL
VAX/VMS User Processes at 19-APR-1990 12:14:49.16
Total number of users = 71, number of processes = 239
Username Node Process Name PID Terminal
1201BUILD ATHENS 1201BUILD 32400296 VTA23: LTA22:
(PC-AA0004000AAFC)
1201BUILD ATHENS EMACS$VTA23 32400297 (subprocess of 32400296)
<LOGIN> FAB4 _WSA1 3100009F
ARBO LXX ARBO 2CC00055 TWA1:
BATBOUTA HELOS BATCH_698 3286022F (batch)
.
.
.
The SHOW USERS command in this example displays the user name,
the node name, the process name, the process identification
(PID) number, the terminal names (both virtual and physical),
and port information for all interactive, subprocess, and batch
users on the system. A user name of <LOGIN> indicates that
someone is in the process of logging in.
6. $ SHOW USERS /NODE=(ATHENS,HELOS,METEOR)
VAX/VMS User Processes at 19-APR-1990 15:59:27.49
Total number of users = 81, number of processes = 248
Username Node Interactive Subprocess Batch
AMWAY HELOS 1
ARBO METEOR 4 1
BARTH HELOS 1
BATBOUTA METEOR 1
BEAUDIN ATHENS 1
BINGHAM HELOS 1
.
.
.
The SHOW USERS command in this example displays the user name
and node name for all interactive, batch, and subprocess users
on the nodes ATHENS, HELOS, and METEOR.
7. $ SHOW USERS /NODE=HELOS
VAX/VMS User Processes at 19-APR-1990 16:03:50.50
Total number of users = 37, number of processes = 54
Username Node Interactive Subprocess Batch
AMWAY HELOS 1
BARTH HELOS 1
BINGHAM HELOS 1
BOUCHARD HELOS 1 1
BUDA HELOS 1
CARIDDI HELOS 1
.
.
.
The SHOW USERS command in this example displays the user name
and node name for all interactive, subprocess, and batch users
on the node HELOS.
WORKING_SET
Displays the working set limit, quota, and extent assigned to the
current process.
Format
SHOW WORKING_SET
Additional information available:
QUALIFIER
Additional information available:
/OUTPUT
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. If you do not
enter the qualifier, or if you enter the /OUTPUT qualifier without
a file specification, the output is sent to the current process
default output stream or device, identified by the logical name
SYS$OUTPUT.
If you enter the /OUTPUT qualifier with a partial file
specification (for example, specifying only a directory), SHOW
is the default file name and LIS the default file type. Wildcard
characters are not allowed in the file specification.
If you enter the /NOOUTPUT qualifier, output is suppressed.
Example
$ SHOW WORKING_SET
Working Set /Limit= 180 /Quota= 350 /Extent= 1200
Adjustment enabled Authorized Quota= 350 Authorized Extent= 1200
In this example, the response to the SHOW WORKING_SET command
indicates that the current process has a working set limit of
180 pages, a quota of 350 pages and that the current quota is
equal to the authorized limit (350 pages). It also shows that
the current process has a working set extent of 1200 and that
the current extent is equal to the authorized limit (1200).
ZONE
Displays the current state of a VAXft 3000 system. For more
information on the SHOW ZONE command, see the VAXft System
Services Reference Manual.
Applies only to VAXft 3000 system.
Format
SHOW ZONE [zone-id]