1 SHOW Displays information about the current status of a process, the system, or devices in the system. Format SHOW option 2 Description The following table lists all the SHOW command options. Option Displays ACCOUNTING Resources the current accounting file is tracking AUDIT Security auditing characteristics in effect on the system BROADCAST Message classes for which broadcast is enabled CLUSTER OpenVMS Cluster activity and performance CPU Current state of the attached processor DEFAULT Current default device and directory DEVICES Status of devices in the system DEVICE/SERVED Status of devices served by the MSCP server on an OpenVMS Cluster system DISPLAY 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 Error count for the CPU, memory, and physical devices INTRUSION Contents of the intrusion database KEY Key definitions created by the DEFINE/KEY command LICENSE Software product licenses active on the current node as well as list of the names attached to a license (known as the RESERVE list) LOGICAL Current logical name assignments MEMORY Availability and usage of memory resources NETWORK Information about network services registered on a node PRINTER Printer characteristics PROCESS Attributes of the current process, including privileges, resource quotas, memory usage, priority, and accounting information PROTECTION 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/CHARACTERISTICS Characteristic names and numbers that have been defined for system queues QUEUE/FORM Form names and numbers that have been defined for system queues QUEUE/MANAGERS Information about the queue manager(s) on the system or OpenVMS Cluster QUOTA Current disk quota authorized for and used by a specific user on a specific disk RMS_DEFAULT Current default multiblock and multibuffer counts used by OpenVMS Record Management Services (RMS) for file operations SECURITY Name, class, and profile of a security object SERVER Information about the servers STATUS Status of the current job, including accumulated CPU time, open file count, and count of I/O operations SYMBOL Current symbol definitions SYSTEM List of all processes in the system TERMINAL Device characteristics of a terminal [DAY]TIME Current date and time TRANSLATION Current logical name assignment USERS Information about users currently on the system WORKING_SET CURRENT working set size limit and quota ZONE Current state of a VAXft system 2 ACCOUNTING Shows what resources the current accounting file is tracking. Format SHOW ACCOUNTING 3 Qualifier /OUTPUT /OUTPUT[=filespec] Requires read (R) and write (W) access to the directory in which the specified file is created. Controls the output destination of the command. By default, the output is the current SYS$OUTPUT device. To send the output to a file, use the /OUTPUT qualifier followed by the file specification. If the file specification does not include the file name or file type, the defaults SHOW and .LIS are used respectively. 3 Example $ SHOW ACCOUNTING Accounting is currently enabled to log the following activities: PROCESS any process termination IMAGE image execution INTERACTIVE interactive job termination LOGIN_FAILURE login failures NETWORK network job termination PRINT all print jobs The keywords in this example show that the local node is tracking the resources used by each: o Interactive and network process o Image running in an interactive or network process o Login failure o Print job 2 AUDIT Displays the security auditing characteristics in effect on the system. Requires the SECURITY privilege. Format SHOW AUDIT 3 Qualifiers /ALL Displays all available auditing information including the following: o Location of the system security audit log file o Security events enabled for auditing o Location of the security archive file o Audit server characteristics, such as the action taken if the audit server runs out of memory. /ALARM Displays the categories of events that are currently enabled; these events will generate messages on any operator's terminal accepting security class messages. /ARCHIVE Displays the name and location of the security archive file (if archiving is enabled). /AUDIT Displays the categories of events that are currently enabled to write messages to the system security audit log file. /EXACT Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a search string that must match the search string exactly and must be enclosed with quotation marks (" "). If you specify the /EXACT qualifier without the /SEARCH qualifier, exact search mode is enabled when you set the search string with the Find (E1) key. /HIGHLIGHT /HIGHLIGHT[=keyword] Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the type of highlighting you want when a search string is found. When a string is found, the entire line is highlighted. You can use the following keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD is the default highlighting. /JOURNAL Displays characteristics of the system audit journal. /OUTPUT /OUTPUT[=filespec] Controls where the output of the command is sent. If you do not enter the /OUTPUT qualifier or if you enter it without a file specification, the output is sent to the default output stream or device for the current process, which is identified by the logical name SYS$OUTPUT. If you enter the /OUTPUT qualifier with a partial file specification (for example, only a directory name), SET AUDIT assigns the file name SHOW with the default file type of .LIS. The file specification cannot include the asterisk (*) and the percent sign (%) wildcard characters. /PAGE /PAGE[=keyword] /NOPAGE (default) Controls the display of information on the screen. You can use the following keywords with the /PAGE qualifier: CLEAR_SCREEN Clears the screen before each page is displayed. SCROLL Displays information one line at a time. SAVE[=n] Enables screen navigation of information, where n is the number of pages to store. The /PAGE=SAVE qualifier allows you to navigate through screens of information. The /PAGE=SAVE qualifier stores up to 5 screens of up to 255 columns of information. When you use the /PAGE=SAVE qualifier, you can use the following keys to navigate through the information: Key Sequence Description Up arrow key, Ctrl/B Scroll up one line. Down arrow key Scroll down one line. Left arrow key Scroll left one column. Right arrow key Scroll right one column. Find (E1) Specify a string to find when the information is displayed. Insert Here (E2) Scroll right one half screen. Remove (E3) Scroll left one half screen. Select (E4) Toggle 80/132 column mode. Prev Screen (E5) Get the previous page of information. Next Screen (E6), Get the next page of information. Return, Enter, Space F10, Ctrl/Z Exit. (Some utilities define these differently.) Help (F15) Display utility help text. Do (F16) Toggle the display to oldest/newest page. Ctrl/W Refresh the display. The /PAGE qualifier is not compatible with the /OUTPUT qualifier. /SEARCH /SEARCH="string" Use with the /PAGE=SAVE qualifier to specify a string that you want to find in the information being displayed. Quotation marks are required for the /SEARCH qualifier, if you include spaces in the text string. You can also dynamically change the search string by pressing the Find key (E1) while the information is being displayed. Quotation marks are not required for a dynamic search. /SERVER Displays audit server characteristics. /WRAP /WRAP /NOWRAP (default) Use with the /PAGE=SAVE qualifier to limit the number of columns to the width of the screen and to wrap lines that extend beyond the width of the screen to the next line. The /NOWRAP qualifier extends lines beyond the width of the screen and can be seen when you use the scrolling (left and right) features provided by the /PAGE=SAVE qualifier. 3 Example $ SHOW AUDIT/ALL List of audit journals: Journal name: SECURITY Journal owner: (system audit journal) Destination: SYS$COMMON:[SYSMGR]SECURITY.AUDIT$JOURNAL Monitoring: enabled Warning thresholds, Block count: 100 Duration: 2 00:00:00.0 Action thresholds, Block count: 25 Duration: 0 00:30:00.0 Security auditing server characteristics: Database version: 4.4 Backlog (total): 100, 200, 300 Backlog (process): 5, 2 Server processing intervals: Archive flush: 0 00:01:00:00 Journal flush: 0 00:05:00:00 Resource scan: 0 00:05:00:00 Final resource action: purge oldest audit events Security archiving information: Archiving events: none Archive destination: System security alarms currently enabled for: ACL Authorization INSTALL Time Audit: illformed Breakin: dialup,local,remote,network,detached Login: batch,dialup,local,remote,network,subprocess,detached Logfailure: batch,dialup,local,remote,network,subprocess,detached,server System security audits currently enabled for: ACL Mount Authorization INSTALL Time Audit: illformed Breakin: dialup,local,remote,network,detached Login: batch,dialup,local,remote,network,subprocess,detached,server Logfailure: batch,dialup,local,remote,network,subprocess,detached,server Logout: batch,dialup,local,remote,network,subprocess,detached,server FILE access: Failure: read,write,execute,delete,control The SHOW AUDIT command in this example displays the auditing settings after a system installation. See the SET AUDIT/ENABLE command for descriptions of the individual audit items. 2 BROADCAST Displays the message classes that are currently affected by the SET BROADCAST command. Format SHOW BROADCAST 3 Qualifier /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. The asterisk (*) and the percent sign (%) wildcard characters are not allowed. If you enter the /NOOUTPUT qualifier, output is suppressed. 3 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. The display in this example shows that all message classes are enabled for broadcast, but that these messages 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 you see 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 you see when SET BROADCAST=NONE is in effect. 2 CLUSTER Invokes the Show Cluster utility to monitor and display cluster activity and performance. For more information about the Show Cluster utility, refer to the OpenVMS System Management Utilities Reference Manual or online help. Format SHOW CLUSTER If you specify the command without any qualifiers, SHOW CLUSTER displays a single cluster report and then returns control to the DCL level. To invoke a continuous SHOW CLUSTER display, enter the following command: $ SHOW CLUSTER/CONTINUOUS SHOW CLUSTER requires no special privileges because it is installed with the CMKRNL privilege. In a continuous display, you can control report output with SHOW CLUSTER commands. For information about the SHOW CLUSTER commands, invoke a continuous SHOW CLUSTER display and type HELP at the Command> prompt. 3 Qualifiers /BEGINNING /BEGINNING=time Specifies the time that the SHOW CLUSTER session is to begin. You can specify absolute time, a delta time, or a combination of the two. Observe the syntax rules for time values described in the OpenVMS User's Manual or the online help topic DCL_Tips (subtopic Date_Time). If you specify a future time, your process is placed in a state of hibernation until the specified time. Use this qualifier with the /OUTPUT and /ENDING qualifiers to run SHOW CLUSTER without direct user intervention. You can specify time as absolute time expressed as [dd-mmm-yyyy[:]] [hh:mm:ss.cc], or a delta time expressed as [dddd-][hh:mm:ss.cc], or a combination of the two. Observe the syntax rules for time values described in the OpenVMS User's Manual or the online help topic DCL_Tips (subtopic Date_Time). /CONTINUOUS Specifies a continuously updating display. If you omit the qualifier, SHOW CLUSTER produces a single display and returns control to the DCL command level. Running SHOW CLUSTER in the continuous mode allows you to use SHOW CLUSTER commands to control the display. In a continuous display, you can control report output with SHOW CLUSTER commands. For information about the SHOW CLUSTER commands, invoke a continuous SHOW CLUSTER display and type HELP at the Command> prompt. SHOW CLUSTER has commands that allow you to customize the display. You can add and remove fields and classes, rearrange the position of windows, scroll their contents, or create an initialization or command procedure that can recreate a particular window setup. To exit from a continuous display and return to the DCL level, type the EXIT command or press Ctrl/Z. To exit from SHOW CLUSTER without erasing the screen, press Ctrl/C. To interrupt SHOW CLUSTER, press Ctrl/Y. For a complete description of the Show Cluster utility and commands, refer to the OpenVMS System Manager's Manual for overview information and the OpenVMS System Management Utilities Reference Manual for reference information. /ENDING /ENDING=time Specifies the time that the SHOW CLUSTER session is to end. You can specify an absolute time, a delta time, or a combination of the two. Observe the syntax rules for time values described in the OpenVMS User's Manual or the online help topic DCL_Tips (subtopic Date_Time). Use this qualifier with the /BEGINNING and /OUTPUT qualifiers to run SHOW CLUSTER without direct user intervention. You can specify time as absolute time expressed as [dd-mmm- yyyy[:]][hh:mm:ss.cc], or a delta time expressed as [dddd- ][hh:mm:s.cc], or a combination of the two. Observe the syntax rules for time values described in the OpenVMS User's Manual or the online help topic DCL_Tips (subtopic Date_Time). /INTERVAL /INTERVAL=seconds Specifies the number of seconds that display information remains on the screen before it is updated. By default, the interval time is 15 seconds. If you use an initialization file in noncontinuous mode and the initialization file contains a SET SCREEN command that changes the screen size, SHOW CLUSTER sets the screen to the specified size for one update interval and then sets the screen to the original size. /OUTPUT /OUTPUT=filespec Directs the output from SHOW CLUSTER to the specified file instead of the current SYS$OUTPUT device. SHOW CLUSTER output is always in printable file format, regardless of the file or device type specified. Output can be up to 132 columns wide and can be sent to any file, terminal, or print device. You can also direct output to a file with the WRITE command. The filespec is the name of the file or device to which SHOW CLUSTER output is directed. The default file name is SHOW_ CLUSTER.LIS. You can direct output to a device other than SYS$OUTPUT, by specifying a valid device name. 2 CPU Displays the current state of the processors in an OpenVMS system. Format SHOW CPU [cpu-id[,...]] 3 Parameter cpu-id[,...] Specifies a decimal value representing the identity of a processor in a OpenVMS multiprocessing system. On a VAX 6000 system or an Alpha 7000 system, the CPU ID is the backplane slot number of the processor. 3 Qualifiers /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. /EXACT Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a search string that must match the search string exactly and must be enclosed with quotation marks (" "). If you specify the /EXACT qualifier without the /SEARCH qualifier, exact search mode is enabled when you set the search string with the Find (E1) key. /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 is 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. This qualifier also displays whether the CPU is enabled or disabled for use as a Fast Path preferred CPU, then lists the Fast Path ports assigned to it, and shows whether or not the ports are user-assigned. For more information about using Fast Path features to improve I/O performance, refer to the OpenVMS I/O User's Reference Manual. /HIGHLIGHT /HIGHLIGHT[=keyword] Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the type of highlighting you want when a search string is found. When a string is found, the entire line is highlighted. You can use the following keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD is the default highlighting. /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 the asterisk (*) and the percent sign (%) wildcard characters. If you enter the /NOOUTPUT qualifier, output is suppressed. /PAGE /PAGE[=keyword] /NOPAGE (default) Controls the display of device information on the screen. You can use the following keywords with the /PAGE qualifier: CLEAR_SCREEN Clears the screen before each page is displayed. SCROLL Displays information one line at a time. SAVE[=n] Enables screen navigation of information, where n is the number of pages to store. The /PAGE=SAVE qualifier allows you to navigate through screens of information. The /PAGE=SAVE qualifier stores up to 5 screens of up to 255 columns of information. When you use the /PAGE=SAVE qualifier, you can use the following keys to navigate through the information: Key Sequence Description Up arrow key, Ctrl/B Scroll up one line. Down arrow key Scroll down one line. Left arrow key Scroll left one column. Right arrow key Scroll right one column. Find (E1) Specify a string to find when the information is displayed. Insert Here (E2) Scroll right one half screen. Remove (E3) Scroll left one half screen. Select (E4) Toggle 80/132 column mode. Prev Screen (E5) Get the previous page of information. Next Screen (E6), Get the next page of information. Return, Enter, Space F10, Ctrl/Z Exit. (Some utilities define these differently.) Help (F15) Display utility help text. Do (F16) Toggle the display to oldest/newest page. Ctrl/W Refresh the display. The /PAGE qualifier is not compatible with the /OUTPUT qualifier. /SEARCH /SEARCH="string" Use with the /PAGE=SAVE qualifier to specify a string that you want to find in the information being displayed. Quotation marks are required for the /SEARCH qualifier, if you include spaces in the text string. You can also dynamically change the search string by pressing the Find key (E1) while the information is being displayed. Quotation marks are not required for a dynamic search. /SUMMARY Produces a display listing the processors in the OpenVMS multiprocessing or single-CPU system, indicating which is the primary processor, which processors are configured, and which processors are active. The /SUMMARY qualifier also indicates the minimum revision levels required for processors in the system, which OpenVMS 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. /WRAP /WRAP /NOWRAP (default) Use with the /PAGE=SAVE qualifier to limit the number of columns to the width of the screen and to wrap lines that extend beyond the width of the screen to the next line. The /NOWRAP qualifier extends lines beyond the width of the screen and can be seen when you use the scrolling (left and right) features provided by the /PAGE=SAVE qualifier. 3 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 BIG1, a AlphaServer 4100 5/466 4MB Multiprocessing is ENABLED. Full checking synchronization image loaded. System Information: Page Size = 8192 Revision Code = Serial Number = NI83603713 Default CPU Capabilities: System: QUORUM RUN Default Process Capabilities: System: QUORUM RUN Primary CPU = 000 CPU 000 State: RUN Process Name: SYSTEM PID: 00000438 Capabilities: System: PRIMARY QUORUM RUN RAD0 Slot Context: CPU - Type...........: EV56 (21164A), Pass 2 State..........: RC, PA, PP, CV, PV, PMV, PL Variation......: VAX FP, IEEE FP, Primary Eligible Serial Number..: Revision.......: Halt Request...: 0 Software Comp..: 5.5 PALCODE - Revision Code..: 1.21-01 Compatibility..: 1 Max Shared CPUs: 4 Memory Space..: Physical = 00000000.00000000 Length = 0 Scratch Space..: Physical = 00000000.00000000 Length = 0 Bindings: NETACP PID = 00000417 Reason: PRIMARY Capability Features: AUTOSTART is enabled. Enabled for use as a Fastpath Preferred CPU. Fastpath ports assigned: *** None *** CPU 001 State: RUN Process Name: SETI@home 10% PID: 0000041F Capabilities: System: QUORUM RUN RAD0 Slot Context: CPU - Type...........: EV56 (21164A), Pass 2 State..........: RC, PA, PP, CV, PV, PMV, PL Variation......: VAX FP, IEEE FP Serial Number..: Revision.......: Halt Request...: 0 Software Comp..: 5.5 PALCODE - Revision Code..: 1.21-01 Compatibility..: 1 Max Shared CPUs: 4 Memory Space..: Physical = 00000000.00000000 Length = 0 Scratch Space..: Physical = 00000000.00000000 Length = 0 Bindings: *** None *** Features: AUTOSTART is enabled. Enabled for use as a Fastpath Preferred CPU. Fastpath ports assigned: PKC0 *** None *** CPU 002 State: RUN Process Name: SETI@home 19% PID: 00000420 Capabilities: System: QUORUM RUN RAD0 Slot Context: CPU - Type...........: EV56 (21164A), Pass 2 State..........: RC, PA, PP, CV, PV, PMV, PL Variation......: VAX FP, IEEE FP Serial Number..: Revision.......: Halt Request...: 0 Software Comp..: 5.5 PALCODE - Revision Code..: 1.21-01 Compatibility..: 1 Max Shared CPUs: 4 Memory Space..: Physical = 00000000.00000000 Length = 0 Scratch Space..: Physical = 00000000.00000000 Length = 0 Bindings: *** None *** Features: AUTOSTART is enabled. Enabled for use as a Fastpath Preferred CPU. Fastpath ports assigned: PKB0 *** None *** CPU 003 State: RUN Process Name: SETI@home 92% PID: 00000422 Capabilities: System: QUORUM RUN RAD0 Slot Context: CPU - Type...........: EV56 (21164A), Pass 2 State..........: RC, PA, PP, CV, PV, PMV, PL Variation......: VAX FP, IEEE FP Serial Number..: Revision.......: Halt Request...: 0 Software Comp..: 5.5 PALCODE - Revision Code..: 1.21-01 Compatibility..: 1 Max Shared CPUs: 4 Memory Space..: Physical = 00000000.00000000 Length = 0 Scratch Space..: Physical = 00000000.00000000 Length = 0 Bindings: *** None *** Features: AUTOSTART is enabled. Enabled for use as a Fastpath Preferred CPU. Fastpath ports assigned: *** None *** The SHOW CPU/FULL command in this example produces a configuration summary of the AlphaServer 4100 5/466 4MB system, BIG1. All are in the RUN state and all have a current process. Note that NETACP can only run on CPU 0, because only CPU 0 has primary capability. Note also that CPUs 1 and 2 have Fastpath ports, PKC0 and PKB0 respectively assigned. 4.$ SHOW CPU/FULL OLEO, A VAX 6000-420 Multiprocessing is DISABLED. MULTIPROCESSING System 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 6000-420 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. 5.$ SET PROCESS /AFFINITY /SET=3 SYSTEM/PERMANENT $ SHOW CPU 3/FULL BIG1, a AlphaServer 4100 5/466 4MB Multiprocessing is ENABLED. Full checking synchronization image loaded. System Information: Page Size = 8192 Revision Code = Serial Number = NI83603713 Default CPU Capabilities: System: QUORUM RUN Default Process Capabilities: System: QUORUM RUN Primary CPU = 000 CPU 003 State: RUN Process Name: SYSTEM PID: 00000438 Capabilities: System: QUORUM RUN RAD0 Slot Context: CPU - Type...........: EV56 (21164A), Pass 2 State..........: RC, PA, PP, CV, PV, PMV, PL Variation......: VAX FP, IEEE FP Serial Number..: Revision.......: Halt Request...: 0 Software Comp..: 5.5 PALCODE - Revision Code..: 1.21-01 Compatibility..: 1 Max Shared CPUs: 4 Memory Space..: Physical = 00000000.00000000 Length = 0 Scratch Space..: Physical = 00000000.00000000 Length = 0 Bindings: SYSTEM PID = 00000438 Reason: Affinitized to this CPU Features: AUTOSTART is enabled. Disabled for use as a Fastpath Preferred CPU. Fastpath ports assigned to this CPU: PNA0 (user assigned) In this example, the SYSTEM process has its affinity set permanently to CPU3. The SHOW CPU command indicates this is the BINDINGS list. The port PNA0 was assigned to CPU 3 by a user when CPU 3 was enabled as a Fast Path preferred CPU. Subsequent to that operation, CPU 3's bit was cleared in the IO_PREFER_CPUS system parameter. This disabled CPU 3 for use as a Fast Path preferred CPU. Normally this is a transient condition, as changing IO_PREFER_CPUS results in the FASTPATH_SERVER process redistributing the Fast Path ports across the set of usable CPUs. However, if there is no FASTPATH_SERVER process, PNA0 remains assigned to this CPU until any of the following actions occur: 1. The user tries to move the port to another CPU by using the SET DEVICE/PREFERRED_CPU command, $QIO, or the $IO_FASTPATH system service. 2. The CPU is stopped. 2 DEFAULT Displays the current default device and directory. Format SHOW DEFAULT 3 Examples 1.$ SHOW DEFAULT DISK1:[ALAMO] $ SET DEFAULT DISK5:[SKONETSKI.SOURCES] $ SHOW DEFAULT DISK5:[SKONETSKI.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:[HESHELMAN] $ SHOW DEFAULT XYZ:[HESHELMAN] 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 WRK:[SCHENKENBERGER] $ SHOW DEFAULT WRK:[SCHENKENBERGER] $ DEFINE KUDOS WRK:[SCHENKENBERGER.TEMP1],WRK:[SCHENKENBERGER.TEMP2] $ SET DEFAULT KUDOS $ SHOW DEFAULT KUDOS:[SCHENKENBERGER] = WRK:[SCHENKENBERGER.TEMP1] = WRK:[SCHENKENBERGER.TEMP2] In this example, the logical name KUDOS is defined as a search list containing the directories [SCHENKENBERGER.TEMP1] and [SCHENKENBERGER.TEMP2] on device WRK. 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 [SCHENKENBERGER] directory remains in effect as the current default directory; however, unless the current default directory syntax ([]) is explicitly used, all file references are to those directories contained in the search list. 2 DEVICES Displays the status of a device on the system. See the qualifier descriptions for restrictions. Format SHOW DEVICES [device-name[:]] 3 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 an OpenVMS Cluster that is running with HSC controllers, 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 an OpenVMS Cluster that is running with HSC controllers, 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. 3 Qualifiers /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. /BITMAP /BITMAP ddcu: Creates a new table showing all active bitmaps for a given device. Included in the display are the size and index number of the bitmaps. Initially, up to 6 bitmaps can be active on a particular device. Note that the SHOW DEVICE/FULL ddcu: display also displays status to indicate that bitmaps are active on the device. /EXACT Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a search string that must match the search string exactly and must be enclosed with quotation marks (" "). If you specify the /EXACT qualifier without the /SEARCH qualifier, exact search mode is enabled when you set the search string with the Find (E1) key. /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, /BRIEF, /FULL, or /MOUNTED qualifier. The functions of the /FILES qualifier and these qualifiers are mutually exclusive. /FULL Displays a complete list of information about the devices, except for rebuild status. You must use the /REBUILD_STATUS qualifier to get that information. /HIGHLIGHT /HIGHLIGHT[=keyword] Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the type of highlighting you want when a search string is found. When a string is found, the entire line is highlighted. You can use the following keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD is the default highlighting. /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. /MULTIPATH Displays all devices that are currently multipath sets. If you specify a device name, only the characteristics of that device are displayed; however, if the device is not a multipath set, 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 are currently multipath sets 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 the asterisk (*) and the percent sign (%) wildcard characters. If you enter the /NOOUTPUT qualifier, output is suppressed. /PAGE /PAGE[=keyword] /NOPAGE (default) Controls the display of device information on the screen. You can use the following keywords with the /PAGE qualifier: CLEAR_SCREEN Clears the screen before each page is displayed. SCROLL Displays information one line at a time. SAVE[=n] Enables screen navigation of information, where n is the number of pages to store. The /PAGE=SAVE qualifier allows you to navigate through screens of information. The /PAGE=SAVE qualifier stores up to 5 screens of up to 255 columns of information. When you use the /PAGE=SAVE qualifier, you can use the following keys to navigate through the information: Key Sequence Description Up arrow key, Ctrl/B Scroll up one line. Down arrow key Scroll down one line. Left arrow key Scroll left one column. Right arrow key Scroll right one column. Find (E1) Specify a string to find when the information is displayed. Insert Here (E2) Scroll right one half screen. Remove (E3) Scroll left one half screen. Select (E4) Toggle 80/132 column mode. Prev Screen (E5) Get the previous page of information. Next Screen (E6), Get the next page of information. Return, Enter, Space F10, Ctrl/Z Exit. (Some utilities define these differently.) Help (F15) Display utility help text. Do (F16) Toggle the display to oldest/newest page. Ctrl/W Refresh the display. The /PAGE qualifier is not compatible with the /OUTPUT qualifier. /REBUILD_STATUS Tells you whether volumes need rebuilding. You may need to rebuild a volume if the volume was improperly dismounted. Volumes are improperly dismounted when, for example, the system crashes. For each volume, SHOW DEVICES/REBUILD_STATUS returns one of these values: Value Meaning Yes Rebuild needed. No Rebuild not needed. Not applicable You cannot rebuild this volume. This value is returned if, for example, the volume is not a disk, or the volume is write-locked. Information Rebuild information is unavailable. This value unavailable is returned when, for example, the volume is not mounted, or mount verification is taking place. To rebuild a volume, either: o Use SET VOLUME/REBUILD o Dismount the volume, then mount the volume again using MOUNT/REBUILD You cannot use the /REBUILD_STATUS qualifier with any other SHOW DEVICES qualifiers, except /OUTPUT. /SEARCH /SEARCH="string" Use with the /PAGE=SAVE qualifier to specify a string that you want to find in the information being displayed. Quotation marks are required for the /SEARCH qualifier, if you include spaces in the text string. You can also dynamically change the search string by pressing the Find key (E1) while the information is being displayed. Quotation marks are not required for a dynamic search. /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 open 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). /WRAP /WRAP /NOWRAP (default) Use with the /PAGE=SAVE qualifier to limit the number of columns to the width of the screen and to wrap lines that extend beyond the width of the screen to the next line. The /NOWRAP qualifier extends lines beyond the width of the screen and can be seen when you use the scrolling (left and right) features provided by the /PAGE=SAVE qualifier. 3 Examples 1.$ SHOW DEVICES Device Device Err. Volume Free Trans Mount Name Status Count Label Blocks Count Count DKA0: Online mnt 0 VMS 47088 115 1 DKA1: Online mnt 0 USERPACK1 45216 2 1 DKA2: Online mnt 3 DOCUMENT 8068 20 1 DKA5: Online mnt 0 MASTERP 28668 1 1 DKA6: Online 0 DKA7: 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 DEVICE/FULL DKB0: Disk $DKB0:, device type RZ56, is online, mounted, file-oriented device, shareable, error logging is enabled. Error count 0 Operations completed 392750 Owner process "" Owner UIC [1,4] Owner process ID 00000000 Dev Prot S:RWPL,O:RWPL,G:R,W Reference count 317 Default buffer size 512 Total blocks 1299174 Sectors per track 54 Total cylinders 1604 Tracks per cylinder 15 Volume label "SYSTEM_DISK" Relative volume number 0 Cluster size 3 Transaction count 278 Free blocks 367632 Maximum files allowed 162396 Extend quantity 5 Mount count 1 Mount status System Cache name "$DKB0:XQPCACHE" Extent cache size 64 Maximum blocks in extent cache 36763 File ID cache size 64 Blocks currently in extent cache 36258 Quota cache size 0 Maximum buffers in FCP cache 210 Volume owner UIC [1,1] Vol Prot S:RWCD,O:RWCD,G:RWCD,W:RWCD Volume status: ODS-2, subject to mount verification, protected subsystems enabled, file high-water marking, write-through caching enabled. In this example, the SHOW DEVICES command requests a full listing of the status of the RZ56 device DKB0. 3.$ SHOW DEVICES/REBUILD_STATUS Device Name Rebuild needed? ADU15$DKA300: Information unavailable EDIV$DKA300: Information unavailable EMUL$DKB200: No EMUL$DKB300: No EMUL$DKB500: Yes FTA0: Not applicable OPA0: Not applicable In this example, the volume mounted on device EMUL$DKB500 needs rebuilding. 4.$ 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:RWPL,O:RWPL,G:RWPL,W:RWPL 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 OpenVMS Cluster. Information is shown here only for the first two devices: a mounted device and a device that is not mounted. 5.$ SHOW DEVICE $1$DKB1:/FULL Disk $1$DKB1: (VMSRMS), device type RRD40, is online, allocated, deallocate on dismount, mounted, software write-locked, file-oriented device, shareable, served to cluster via MSCP Server Error count 0 Operations completed 15 Owner process "_FTA5:" Owner UIC [1,4] Owner process ID 2020005D Dev Prot S:RWPL,O:RWPL,G:R,W Reference count 2 Default buffer size 512 Total blocks 256 Sectors per track 32 Total cylinders 1 Tracks per cylinder 8 Allocation class 1 Volume label "VOLUME_1" Relative volume number 64 Cluster size 0 Transaction count 1 Free blocks 0 Maximum files allowed 0 Extend quantity 0 Mount count 1 Mount status Process ACP process name "DAD2CACP" Volume status: ISO 9660. Members of this volume set are $1$DKB7: (rvn 64), $1$DKB4: (rvn 8), $1$DKB1: (rvn 1), $1$DKB12: (rvn 4096), $1$DKB16: (rvn 65535), $1$DKB6: (rvn 32). In this example, the user requested a full display on a VAX system of a device contained on a member of an ISO 9660 partially mounted volume set. Note the volume status displays the media format as ISO 9660, and the volume set list shows a sparce list of the currently mounted members of the volume set. 6.$ SHOW DEVICES MUA1/FULL Magtape $4$MUA1: (HSC70), device type TA79, is online, device is equipped with a stacker/loader, file-oriented device, available to cluster, error logging is enabled. Error count 0 Operations completed 0 Owner process "" Owner UIC [SYSTEM] Owner process ID 00000000 Dev Prot S:RWPL,O:RWPL,G:R,W Reference count 0 Default buffer size 2048 Density 1600 Format Normal-11 Host name "HSC70" Host type, avail HS70, yes Allocation class 4 Volume status: no-unload on dismount, odd parity. In this example, the user requested a full display of the tape device MUA1. 7.$ SHOW DEVICE/FULL $1$DKA221 Disk $1$DKA221: (HSC952), device type RZ29, is online, mounted, file-oriented device, shareable, available to cluster, error logging is enabled. Error count 0 Operations completed 6509 Owner process "" Owner UIC [SYSTEM] Owner process ID 00000000 Dev Prot S:RWPL,O:RWPL,G:R,W Reference count 108 Default buffer size 512 Current preferred CPU Id 1 FastPath 1 Total blocks 8380080 Sectors per track 4 Total cylinders 65470 Tracks per cylinder 32 Host name "HSC952" Host type, avail HS95, yes Allocation class 1 Volume label "GALAXY_X6L5" Relative volume number 0 Cluster size 4 Transaction count 302 Free blocks 4691760 Maximum files allowed 838008 Extend quantity 5 Mount count 2 Mount status System Cache name "_$1$DKA221:XQPCACHE" Extent cache size 64 Maximum blocks in extent cache 469176 File ID cache size 64 Blocks currently in extent cache 237504 Quota cache size 0 Maximum buffers in FCP cache 1734 Volume owner UIC [1,1] Vol Prot S:RWCD,O:RWCD,G:RWCD,W:RWCD Volume Status: ODS-2, subject to mount verification, protected subsystems enabled, file high-water marking, write-through caching enabled. Volume is also mounted on MEAD. This disk is a device that performs its I/O through the Fast Path port PNA0. Fast Path is enabled for this disk, and its I/O will be processed on the preferred CPU, CPU 1, which is associated with its Fast Path port PNA0. The /FULL qualifier also displays additional information about Fast Path devices. A Fast Path device may be either a class device or a port device. An example of a class device is an HSC disk, and an example of a port device is the CI. For both Fast Path class devices and ports, the display indicates that Fast Path is enabled and lists the current CPU ID to which that device is assigned. Additionally, for a Fast Path port, the display indicates the port's user-established CPU preference (if any). The current preferred CPU and the User Preferred CPU can be set by using the DCL command, SET DEVICES/PREFERRED_CPU, or by issuing a $QIO. For more information about using Fast Path features to improve I/O performance, refer to the OpenVMS I/O User's Reference Manual. 8.$ SHOW DEVICE/FULL PNA0 Device PNA0:, device type CIXCD, is online, shareable, error logging is enabled. Error count 0 Operations completed 0 Owner process "" Owner UIC [SYSTEM] Owner process ID 00000000 Dev Prot S:RWPL,O:RWPL,G,W Reference count 0 Default buffer size 0 Current preferred CPU Id 1 FastPath 1 The above display shows that port PNA0 is assigned to CPU 1 and that Fast Path is enabled. 9.$ SHOW DEVICE/FULL PNA0 Device PNA0:, device type CIXCD, is online, shareable, error logging is enabled. Error count 0 Operations completed 0 Owner process "" Owner UIC [SYSTEM] Owner process ID 00000000 Dev Prot S:RWPL,O:RWPL,G,W Reference count 0 Default buffer size 0 Current preferred CPU Id 1 FastPath 1 User preferred CPU Id 2 This example shows a Fast Path assignment made by a user. Normally, the User Preferred CPU ID matches the current preferred CPU ID. The reason for the mismatch in the above display is because CPU 2 was stopped. The port was previously assigned to CPU 2. But when CPU 2 was stopped, the operating system moved the port assignment from CPU 2 to CPU 1. If CPU 2 were started, the operating system would assign the device to the User Preferred CPU. 10$ SHOW DEVICE/FULL DSA0 Disk DSA0:, device type RAM Disk, is online, mounted, file-oriented device, shareable, available to cluster, error logging is enabled, device supports bitmaps (no bitmaps active). Error count 0 Operations completed 47 Owner process "" Owner UIC [SYSTEM] Owner process ID 00000000 Dev Prot S:RWPL,O:RWPL,G:R,W Reference count 2 Default buffer size 512 Total blocks 1000 Sectors per track 64 Total cylinders 1 Tracks per cylinder 32 Volume label "TST0" Relative volume number 0 Cluster size 1 Transaction count 1 Free blocks 969 Maximum files allowed 250 Extend quantity 5 Mount count 1 Mount status System Cache name "_$252$DUA721:XQPCACHE" Extent cache size 64 Maximum blocks in extent cache 96 File ID cache size 64 Blocks currently in extent cache 0 Quota cache size 0 Maximum buffers in FCP cache 404 Volume owner UIC [SYSTEM] Vol Prot S:RWCD,O:RWCD,G:RWCD,W:RWCD Volume Status: ODS-2, subject to mount verification, file high-water marking, write-back caching enabled. Disk $252$MDA0:, device type RAM Disk, is online, member of shadow set DSA0:. Error count 0 Shadow member operation count 128 Allocation class 252 Disk $252$MDA1:, device type RAM Disk, is online, member of shadow set DSA0:. Error count 0 Shadow member operation count 157 Allocation class 252 This example shows that a write bitmap exists for a shadow set, and that no write bitmap is active. If a shadow set supports write bitmaps, "device supports bitmaps" is displayed along with either "bitmaps active" or "no bitmaps active". If the device does not support write bitmaps, no message pertaining to write bitmaps is displayed. 11$ SHOW DEVICE/BITMAP DSA1 Device BitMap Size Percent of Name ID (Bytes) Full Copy DSA12: 00010001 652 11% This example shows a SHOW DEVICE/BITMAP display. You can find out the ID of each write bitmap on a node with this command. The /BITMAP qualifier is similar to the /REBUILD qualifier in that neither can be combined with most other SHOW DEVICE qualifiers. The SHOW DEVICE/BITMAP display can be brief or full; brief is the default. If no bitmap is active, no bitmap file ID is displayed. The phrase "no bitmaps active" is displayed. 3 /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 4 Qualifiers /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. /EXACT Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a search string that must match the search string exactly and must be enclosed with quotation marks (" "). If you specify the /EXACT qualifier without the /SEARCH qualifier, exact search mode is enabled when you set the search string with the Find (E1) key. /HIGHLIGHT /HIGHLIGHT[=keyword] Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the type of highlighting you want when a search string is found. When a string is found, the entire line is highlighted. You can use the following keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD is the default highlighting. /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 OpenVMS 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. /PAGE /PAGE[=keyword] /NOPAGE (default) Controls the display of device information on the screen. You can use the following keywords with the /PAGE qualifier: CLEAR_SCREEN Clears the screen before each page is displayed. SCROLL Displays information one line at a time. SAVE[=n] Enables screen navigation of information, where n is the number of pages to store. The /PAGE=SAVE qualifier allows you to navigate through screens of information. The /PAGE=SAVE qualifier stores up to 5 screens of up to 255 columns of information. When you use the /PAGE=SAVE qualifier, you can use the following keys to navigate through the information: Key Sequence Description Up arrow key, Ctrl/B Scroll up one line. Down arrow key Scroll down one line. Left arrow key Scroll left one column. Right arrow key Scroll right one column. Find (E1) Specify a string to find when the information is displayed. Insert Here (E2) Scroll right one half screen. Remove (E3) Scroll left one half screen. Select (E4) Toggle 80/132 column mode. Prev Screen (E5) Get the previous page of information. Next Screen (E6), Get the next page of information. Return, Enter, Space F10, Ctrl/Z Exit. (Some utilities define these differently.) Help (F15) Display utility help text. Do (F16) Toggle the display to oldest/newest page. Ctrl/W Refresh the display. The /PAGE qualifier is not compatible with the /OUTPUT qualifier. /RESOURCE Displays information about the resources available to the MSCP server for use in processing I/O requests for the devices it serves. You make these resources available by using the following system parameters: MSCP_BUFFER, MSCP_CREDITS, MSCP_LOAD, and MSCP_SERVE_ ALL. Refer to OpenVMS Cluster Systems or SYSGEN online help for more information. /SEARCH /SEARCH="string" Use with the /PAGE=SAVE qualifier to specify a string that you want to find in the information being displayed. Quotation marks are required for the /SEARCH qualifier, if you include spaces in the text string. You can also dynamically change the search string by pressing the Find key (E1) while the information is being displayed. Quotation marks are not required for a dynamic search. 4 Examples 1.$ SHOW DEVICES/SERVED MSCP-Served Devices on BIAK 28-MAY-2001 13:48:01.32 Queue Requests Device: Status Total Size Current Max Hosts 11$DUA8 Online 2376153 0 2 6 11$DUA9 Avail 2376153 0 0 0 11$DUA10 Online 2376153 0 2 8 11$DUA11 Online 2376153 0 2 7 11$DUA13 Online 2376153 0 2 7 11$DUA14 Avail 2376153 0 0 0 11$DUA16 Avail 2376153 0 0 0 11$DUS16 Avail 2376153 0 1 0 11$DUA17 Avail 2376153 0 0 0 11$DUA18 Online 2376153 0 1 4 11$DUA19 Online 2376153 0 4 7 11$DUA20 Online 2376153 0 1 7 11$DUA21 Online 2376153 0 17 12 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 BIAK 28-MAY-2001 13:49:52.41 . . . Request Count: 0-7: 951154 32-39: 2168 88-103: 1618 8-15: 197224 40-55: 2543 104-127: 189 16-23: 137707 56-71: 8343 24-31: 982 72-87: 141 Operations Count: ABORT 0 ERASE 22772 READ 1042206 ACCESS 0 FLUSH 0 REPLACE 0 AVAILABLE 611 GET COM STS 0 SET CTL CHR 176 CMP CTL DAT 0 GET UNT STS 4026024 SET UNT CHR 3630 CMP HST DAT 0 ONLINE 427 WRITE 259953 Total 5355799 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 176 set-controller-characteristics (SET CTL CHR) operations, and has performed 3630 set-unit-characteristics (SET UNT CHR) operations. 3.$ SHOW DEVICES/SERVED/RESOURCE MSCP-Served Devices on BIAK 28-MAY-2001 13:51:32.01 . . . Resources: Total Free In Use Buffer Area: 400 400 0 I/O Packets: 0 0 Current Maximum Buffer Wait: 0 0 This example shows the information displayed by the SHOW DEVICES/SERVED/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 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 BIAK 28-NOV-2001 13:54:41.99 . . . Queue Requests Host: Time of Connection Current Max Devices IPL31 25-MAY-2001 21:44:06.44 0 1 0 DELAND 25-MAY-2001 21:44:09.98 0 1 0 HEAVEN 25-MAY-2001 22:03:15.67 0 7 10 VIVA 26-MAY-2001 09:44:11.96 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 server devices that the listed hosts have on line. 5.$ SHOW DEVICES/SERVED MSCP-Served Devices on HEN 3-DEC-2001 09:09:08.49 Queue Requests Device: Status Total Size Current Max Hosts 254$DJB1 Avail 0 0 0 0 254$DUA2 Online 1216665 0 0 1 254$DUA4006 Avail 0 0 0 0 TMSCP-Served Devices on HEN 3-DEC-2001 09:09:08.74 Queue Requests Device: Status Position Current Max Hosts 90$MUA7 Avail 0 0 0 0 90$MUA8 Avail 0 0 0 0 90$MUA50 Online 3804 0 0 0 This example displays the output of the SHOW DEVICES/SERVED command from a node that has both MSCP server and TMSCP server devices. In the display, the third column for MSCP server disk devices shows the size of the disk device. The same column for TMSCP server device shows the location where each tape is currently positioned. 2 DISPLAY Indicates the node where output from a DECwindows application will be displayed. Format SHOW DISPLAY [display-device] 3 Parameter 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. 3 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 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. Note that a new workstation display device, WSA2, is created when you enter the SET DISPLAY/CREATE command. 2 ENTRY Displays information about a user's batch and print jobs or about specific job entries. Requires read (R) access to the queue. Format SHOW ENTRY [entry-number[,...]],[job-name[,...]] 3 Parameters entry-number[,...] Specifies the entry number of the job you want displayed. If no entry number or job name 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. The asterisk (*) and the percent sign (%) wildcard characters 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. 3 Qualifiers /BATCH Selects batch jobs for display. /BRIEF /BRIEF (default) Displays the following information for each job: entry number, job name, user name, job size in blocks (for print jobs), job status, queue name, queue status, 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: ABORTING STALLED EXECUTING STARTING PRINTING SUSPENDED PROCESSING ABORTING means that the job is halting prior to normal completion and will not continue processing. A SUSPENDED state means that the job stopped during processing, but should continue when the cause of the SUSPENDED state is resolved. 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. TIMED_ Requests the display of jobs on hold until a RELEASE specified time. Timed-release status indicates that the job is being held in the queue for execution at a specified time. If no keyword is specified, the /BY_JOB_STATUS qualifier displays the status of all jobs. /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 jobs in printer, terminal, or server queues. /EXACT Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a search string that must match the search string exactly and must be enclosed with quotation marks (" "). If you specify the /EXACT qualifier without the /SEARCH qualifier, exact search mode is enabled when you set the search string with the Find (E1) key. /FILES Adds to the default display the list of full file specifications for each file in each job. The /FILES qualifier overrides the default /BRIEF qualifier. /FULL Displays the following information for each job: entry number, job name, user name, job status, full file specification associated with each job, date and time of submission, settings specified for the job, queue name, queue status, and queue type. The /FULL qualifier overrides the default /BRIEF qualifier. /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. /HIGHLIGHT /HIGHLIGHT[=keyword] Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the type of highlighting you want when a search string is found. When a string is found, the entire line is highlighted. You can use the following keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD is the default highlighting. /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. The asterisk (*) and the percent sign (%) 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. /PAGE /PAGE[=keyword] /NOPAGE (default) Controls the display of information on the screen. You can use the following keywords with the /PAGE qualifier: CLEAR_SCREEN Clears the screen before each page is displayed. SCROLL Displays information one line at a time. SAVE[=n] Enables screen navigation of information, where n is the number of pages to store. The /PAGE=SAVE qualifier allows you to navigate through screens of information. The /PAGE=SAVE qualifier stores up to 5 screens of up to 255 columns of information. When you use the /PAGE=SAVE qualifier, you can use the following keys to navigate through the information: Key Sequence Description Up arrow key, Ctrl/B Scroll up one line. Down arrow key Scroll down one line. Left arrow key Scroll left one column. Right arrow key Scroll right one column. Find (E1) Specify a string to find when the information is displayed. Insert Here (E2) Scroll right one half screen. Remove (E3) Scroll left one half screen. Select (E4) Toggle 80/132 column mode. Prev Screen (E5) Get the previous page of information. Next Screen (E6), Get the next page of information. Return, Enter, Space F10, Ctrl/Z Exit. (Some utilities define these differently.) Help (F15) Display utility help text. Do (F16) Toggle the display to oldest/newest page. Ctrl/W Refresh the display. The /PAGE qualifier is not compatible with the /OUTPUT qualifier. /SEARCH /SEARCH="string" Use with the /PAGE=SAVE qualifier to specify a string that you want to find in the information being displayed. Quotation marks are required for the /SEARCH qualifier, if you include spaces in the text string. You can also dynamically change the search string by pressing the Find key (E1) while the information is being displayed. Quotation marks are not required for a dynamic search. /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. /WRAP /WRAP /NOWRAP (default) Use with the /PAGE=SAVE qualifier to limit the number of columns to the width of the screen and to wrap lines that extend beyond the width of the screen to the next line. The /NOWRAP qualifier extends lines beyond the width of the screen and can be seen when you use the scrolling (left and right) features provided by the /PAGE=SAVE qualifier. 3 Examples 1.$ SHOW ENTRY/BY_JOB_STATUS=RETAINED Entry Jobname Username Blocks Status ----- ------- -------- ------ ------ 422 FORECAST JONES Retained on completion On stopped generic batch queue CLUSTER_BATCH Completed 21-DEC-2001 16:18 on queue NODE_BATCH In this example, the SHOW ENTRY command displays a job entry that was retained on completion. 2.$ SHOW ENTRY/FULL S* Entry Jobname Username Blocks Status ----- ------- -------- ------ ------ 625 STAFF ESTES 112 Pending (queue stopped) On stopped printer queue LN01$PRINT Submitted 19-DEC-2001 12:14 /FORM=LN01$PORTRAIT (stock=DEFAULT) /NOTIFY /PRIORITY=100 File: _DKA1:[ESTES]STAFF.DIS;3 629 SEARCH ESTES 94 Printing On printer queue LINE$PRINT Submitted 19-DEC-2001 12:16 /FORM=DEFAULT /NOTIFY /PRIORITY=100 /COPIES=2 /NOFEED /PASSALL File: _DKA1:[ESTES.DAILY]SEARCH.TXT;2 (printing copy 2) In this example, the SHOW ENTRY command displays the current jobname entries beginning with the letter "S" owned by ESTES on all queues. The /FULL qualifier lists the submission information, the full file specification, and the current settings for the job. 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/FULL Entry Jobname Username Status ----- ------- -------- ------ 199 ASSIGNMENTS JONES Executing Submitted 19-DEC-2001 08:36 /KEEP /NOLOG/ NOPRINT /PRIORITY=100 File: DUA2:[JONES]ASSIGNMENTS.COM;34 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 job status and sees that the 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 job status without knowing the specific batch queue name. If the user did not specify an entry number, all jobs would have been displayed. 2 ERROR Displays the error count for all devices with error counts greater than zero. Format SHOW ERROR 3 Qualifiers /EXACT Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a search string that must match the search string exactly and must be enclosed with quotation marks (" "). If you specify the /EXACT qualifier without the /SEARCH qualifier, exact search mode is enabled when you set the search string with the Find (E1) key. /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.) /HIGHLIGHT /HIGHLIGHT[=keyword] Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the type of highlighting you want when a search string is found. When a string is found, the entire line is highlighted. You can use the following keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD is the default highlighting. /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. The asterisk (*) and the percent sign (%) wildcard characters are not allowed in the file specification. If you enter the /NOOUTPUT qualifier, output is suppressed. /PAGE /PAGE[=keyword] /NOPAGE (default) Controls the display of error information on the screen. You can use the following keywords with the /PAGE qualifier: CLEAR_SCREEN Clears the screen before each page is displayed. SCROLL Displays information one line at a time. SAVE[=n] Enables screen navigation of information, where n is the number of pages to store. The /PAGE=SAVE qualifier allows you to navigate through screens of information. The /PAGE=SAVE qualifier stores up to 5 screens of up to 255 columns of information. When you use the /PAGE=SAVE qualifier, you can use the following keys to navigate through the information: Key Sequence Description Up arrow key, Ctrl/B Scroll up one line. Down arrow key Scroll down one line. Left arrow key Scroll left one column. Right arrow key Scroll right one column. Find (E1) Specify a string to find when the information is displayed. Insert Here (E2) Scroll right one half screen. Remove (E3) Scroll left one half screen. Select (E4) Toggle 80/132 column mode. Prev Screen (E5) Get the previous page of information. Next Screen (E6), Get the next page of information. Return, Enter, Space F10, Ctrl/Z Exit. (Some utilities define these differently.) Help (F15) Display utility help text. Do (F16) Toggle the display to oldest/newest page. Ctrl/W Refresh the display. The /PAGE qualifier is not compatible with the /OUTPUT qualifier. /SEARCH /SEARCH="string" Use with the /PAGE=SAVE qualifier to specify a string that you want to find in the information being displayed. Quotation marks are required for the /SEARCH qualifier, if you include spaces in the text string. You can also dynamically change the search string by pressing the Find key (E1) while the information is being displayed. Quotation marks are not required for a dynamic search. /WRAP /WRAP /NOWRAP (default) Use with the /PAGE=SAVE qualifier to limit the number of columns to the width of the screen and to wrap lines that extend beyond the width of the screen to the next line. The /NOWRAP qualifier extends lines beyond the width of the screen and can be seen when you use the scrolling (left and right) features provided by the /PAGE=SAVE qualifier. 3 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. 2 INTRUSION Displays the contents of the intrusion database. Requires SECURITY privilege. Format SHOW INTRUSION 3 Qualifiers /NODE /NODE[=(node-name[,...])] The /NODE qualifier displays each intrusion record with the supporting node information. If you specify individual nodes, the supporting node information is displayed only for the nodes listed. /OLD On VAX, displays the contents of the old kernel mode intrusion database. The kernel mode intrusion database was used by the system and layered products prior to OpenVMS VAX Version 6.1. It is still updated by the system to provide backwards compatability to applications that have not yet converted over to using the supported system services for access to the intrusion database. Entries added directly to the old kernel mode intrusion database by applications may be examined only by using the /OLD qualifier. /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 intrusion database that is displayed. The valid keywords are as follows: ALL All entries. By default, all entries are displayed. SUSPECT Entries for login failures that have occurred but have not yet passed the threshold necessary to be identified as intruders. INTRUDER Entries for which the login failure rate was high enough to warrant evasive action. 3 Examples 1.$ SHOW INTRUSION/OUTPUT=INTRUDER.LIS The SHOW INTRUSION command in this example writes all the entries currently in the intrusion 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 NODE22::RONNING In this example, the SHOW INTRUSION command displays all intruder entries currently in the intrusion database. 3.$ SHOW INTRUSION/NODE NETWORK SUSPECT 5 26-JUL-2001 08:51:25.66 POPEYE::WONG Node: TSAVO Count: 2 Node: FROGGY Count: 2 Node: KITTY Count: 1 This command displays each intrusion record for all nodes. 4.$ SHOW INTRUSION/NODE=(FROGGY,KITTY) NETWORK SUSPECT 5 26-JUL-2001 08:51:25.66 POPEYE::HAMMER Node: FROGGY Count: 2 Node: KITTY Count: 2 This command displays intrusion record information for nodes FROGGY and KITTY. 5.$ SHOW INTRUSION/NODE=EVMSA $ This command shows that there are no intrusion records for node EVMSA. 2 KEY Displays the key definitions created with the DEFINE/KEY command. Format SHOW KEY [key-name] 3 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. 3 Qualifiers /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. 3 Example $ DEFINE/KEY/TERMINATE PF1 "ATTACH BOB" %DCL-I-DEFKEY, DEFAULT key PF1 has been defined $ SHOW KEY PF1 DEFAULT keypad definitions: PF1 = "ATTACH BOB" $ SHOW KEY/FULL PF1 DEFAULT keypad definitions: PF1 = "ATTACH BOB" (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. 2 LICENSE Displays software product licenses active on the current node and lists the names attached to a license (known as the RESERVE list). The SHOW LICENSE command displays the license database information currently in your system's memory. Use the License Management utility command, LICENSE LIST, when you want to view the license database information that is on disk. Format SHOW LICENSE [product-name [,...]] 3 Parameter product-name Specifies the name or names of activated software product licenses to display. The asterisk (*) and the percent sign (%) wildcard characters 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 /UNIT_REQUIREMENTS qualifier. 3 Qualifiers /BEFORE Use with /TERMINATION_DATE and /RELEASE_DATE qualifiers. Selects only those licenses whose times are before the time specified with the other qualifiers. The /BEFORE qualifier cannot be used with the /SINCE qualifier. /BRIEF /BRIEF (default) Displays a summary of information about the specified active product licenses. Use the /FULL qualifier to obtain a complete product license listing. /CHARGE_TABLE Synonym for the /UNIT_REQUIREMENTS qualifier. /CLUSTER Use with the /UNIT_REQUIREMENTS qualifier to display the license unit requirements for every node in an OpenVMS Cluster. /EXACT Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a search string that must match the search string exactly and must be enclosed with quotation marks (" "). If you specify the /EXACT qualifier without the /SEARCH qualifier, exact search mode is enabled when you set the search string with the Find (E1) key. /FULL Displays a summary of information about the specified active product licenses, including Product Authorization Key (PAK) options and the reserve list (if any). /HIGHLIGHT /HIGHLIGHT[=keyword] Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the type of highlighting you want when a search string is found. When a string is found, the entire line is highlighted. You can use the following keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD is the default highlighting. /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. The asterisk (*) and the percent sign (%) 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. /PAGE /PAGE[=keyword] /NOPAGE (default) Controls the display of license information on the screen. You can use the following keywords with the /PAGE qualifier: CLEAR_SCREEN Clears the screen before each page is displayed. SCROLL Displays information one line at a time. SAVE[=n] Enables screen navigation of information, where n is the number of pages to store. The /PAGE=SAVE qualifier allows you to navigate through screens of information. The /PAGE=SAVE qualifier stores up to 5 screens of up to 255 columns of information. When you use the /PAGE=SAVE qualifier, you can use the following keys to navigate through the information: Key Sequence Description Up arrow key, Ctrl/B Scroll up one line. Down arrow key Scroll down one line. Left arrow key Scroll left one column. Right arrow key Scroll right one column. Find (E1) Specify a string to find when the information is displayed. Insert Here (E2) Scroll right one half screen. Remove (E3) Scroll left one half screen. Select (E4) Toggle 80/132 column mode. Prev Screen (E5) Get the previous page of information. Next Screen (E6), Get the next page of information. Return, Enter, Space F10, Ctrl/Z Exit. (Some utilities define these differently.) Help (F15) Display utility help text. Do (F16) Toggle the display to oldest/newest page. Ctrl/W Refresh the display. The /PAGE qualifier is not compatible with the /OUTPUT qualifier. /PRODUCER /PRODUCER=producer-name Displays software product licenses active on the current node and supplied by the specified producer. The asterisk (*) and the percent sign (%) wildcard characters are allowed for the producer-name parameter. You cannot use the /PRODUCER qualifier with the /UNIT_REQUIREMENTS qualifier. /RELEASE_DATE /RELEASE_DATE=[date_time] Allows listing licenses using release dates as selection criteria. /SEARCH /SEARCH="string" Use with the /PAGE=SAVE qualifier to specify a string that you want to find in the information being displayed. Quotation marks are required for the /SEARCH qualifier, if you include spaces in the text string. You can also dynamically change the search string by pressing the Find key (E1) while the information is being displayed. Quotation marks are not required for a dynamic search. /SINCE /SINCE(default) Use with the /TERMINATION_DATE and /RELEASE_DATE qualifiers. Selects only those licenses whose times are on or after the time specified with the other qualifiers. The /SINCE qualifier cannot be used with the /BEFORE qualifier. /TERMINATION_DATE /TERMINATION_DATE=date_time Allows listing licenses using termination dates as selection criteria. /UNIT_REQUIREMENTS Displays information in the License Unit Requirement Table (LURT). The /UNIT_REQUIREMENTS qualifier is incompatible with the product-name parameter and with the /BRIEF and /PRODUCER qualifiers. /USAGE Tells you how many license units are loaded, how many are currently allocated, and how many are currently available, as well as the license type for each product on the system. Use with the /FULL qualifier to display complete information-including the PID, process name, node, or user name-for each instance of use of the product. You need group privilege to see the list of users in your group who have allocated license units; you need world privilege to see the list of users in all groups. In an OpenVMS Cluster, if you own multiple license types for a single product, you are limited to viewing the usage information for the license type loaded on the node from which you are executing the SHOW LICENSE/USAGE command. To find out the usage of the other license type loaded on another node, issue the command on that node. You can also use the System Management (SYSMAN) utility to do this. In an OpenVMS Cluster, usage information is limited to the local license type. For example, VAX and Alpha availability licenses are considered by LMF to be different license types. If you are running both VAX and Alpha systems in a cluster, usage information for availability licenses is limited to the local system type. For example, if you have DEC C installed on all nodes in your OpenVMS Cluster, you can display DEC C license allocation on all the VAX nodes in the cluster from any VAX node with DEC C installed, but you cannot display the DEC C license allocation on the Alpha nodes. Usage information is not available for unlimited licenses (a license with 0 units). Clusterwide usage information is not available for personal use or NO_SHARE licenses. Refer to the OpenVMS License Management Utility Manual for more information on license types. /WARNING_INTERVAL /WARNING_INTERVAL=n NOWARNING_INTERVAL Displays a warning stating the number of licenses that will terminate in n days. The default is 30 days. /WRAP /WRAP /NOWRAP (default) Use with the /PAGE=SAVE qualifier to limit the number of columns to the width of the screen and to wrap lines that extend beyond the width of the screen to the next line. The /NOWRAP qualifier extends lines beyond the width of the screen and can be seen when you use the scrolling (left and right) features provided by the /PAGE=SAVE qualifier. 3 Examples 1.$ SHOW LICENSE/FULL Active licenses on node WTPOOH: DVNETEND Producer: DEC Units: 0 Version: 0.0 Date: (none) Termination Date: (none) Availability: E (System Integrated Products) Activity: 0 MOD_UNITS VAX-VMS Producer: DEC Units: 0 Version: 0.0 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, WTPOOH. 2.$ SHOW LICENSE/BRIEF Active licenses on node WTPOOH: --- Product ID ---- ---- Rating ----- -- Version -- Product Producer Units Avail Activ Version Release Termination DVNETEND DEC 0 E 0 0.0 (none) (none) VAX-VMS DEC 0 A 0 0.0 (none) (none) The SHOW LICENSE command in this example displays a summary of all the active licenses on the current node, WTPOOH. 3.$ 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. 4.$ SHOW LICENSE/FULL PERSONAL Active licenses on node PICCHU: PERSONAL Producer: DEC Units: 100 Version: 0.0 Release Date: (none) Termination Date: (none) Availability: 0 Activity: 100 RESERVE_UNITS Reserve: RANCE The SHOW LICENSE command in this example displays information about the product PERSONAL, as well as the name RANCE attached to the product license (known as the RESERVE list). 5.$ SHOW LICENSE/TERM=10-JAN-2014 test0% Active licenses on node PICCHU: --- Product ID ---- ---- Rating ----- -- Version -- Product Producer Units Avail Activ Version Release Termination TEST01 DEC 0 A 0 0.0 (none) (none) TEST02 DEC 0 B 0 0.0 10-JAN-2014 12-NOV-2014 TEST03 DEC 0 C 0 0.0 30-DEC-2014 (none) TEST04 DEC 0 D 0 0.0 (none) 25-AUG-2015 TEST05 DEC 0 E 0 0.0 14-NOV-2016 14-AUG-2016 $ SHOW LICENSE/RELEASE=10-JAN-2014/SINCE test0% Active licenses on node PICCHU: --- Product ID ---- ---- Rating ----- -- Version -- Product Producer Units Avail Activ Version Release Termination TEST02 DEC 0 B 0 0.0 10-JAN-2014 12-NOV-2014 TEST03 DEC 0 C 0 0.0 30-DEC-2014 (none) TEST05 DEC 0 E 0 0.0 14-NOV-2016 14-AUG-2016 $ SHOW LICENSE/RELEASE=10-JAN-2014/BEFORE test0% Active licenses on node PICCHU: --- Product ID ---- ---- Rating ----- -- Version -- Product Producer Units Avail Activ Version Release Termination TEST01 DEC 0 A 0 0.0 (none) (none) TEST04 DEC 0 D 0 0.0 (none) 25-AUG-2015 In these examples, the SHOW LICENSE command uses the /TERM, /RELEASE, /SINCE and /BEFORE qualifiers. 6.$ SHOW LICENSE/UNIT_REQUIREMENTS VMS/LMF Charge Information for node PICCHU This is a VAX 6000-420, hardware model type 160 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) Type: G, * Not Permitted * (VMS Reserved) Type: H, * Not Permitted * (Alpha Layered Products) Type: I, Units Required: 1200 (Layered Products) In this example, the /UNIT_REQUIREMENTS qualifier displays information in the License Unit Requirement Table (LURT). 7.$ SHOW LICENSE/WARNING_INTERVAL=8000 test0% Active licenses on node PICCHU: --- Product ID ---- ---- Rating ----- -- Version -- Product Producer Units Avail Activ Version Release Termination TEST01 DEC 0 A 0 0.0 (none) (none) TEST02 DEC 0 B 0 0.0 10-JAN-2014 12-NOV-2014 TEST03 DEC 0 C 0 0.0 30-DEC-2014 (none) TEST04 DEC 0 D 0 0.0 (none) 25-AUG-2015 TEST05 DEC 0 E 0 0.0 14-NOV-2016 14-AUG-2016 %SHOW-I-TERMIMM, 3 licenses will terminate in 8000 days The /WARNING_INTERVAL qualifier in this example displays three licenses that will terminate in 8000 days. 8.$ SHOW LICENSE/USAGE/FULL DECWRITE-USER View of loaded licenses from node SLTG24 29-DEC-2001 13:36:22.23 ACTIVITY license DECWRITE-USER usage information: Pid Process Name Units Username Node 416000E6 MACAHAY 100 MACAHAY SLTG24 416000E7 MACAHIGH 100 MACAHIGH SLTG24 416000E8 ALICE 100 ALICE SLTG24 416000E9 MORGEN 100 MORGEN SLTG24 416000F1 ANGEL 100 ANGEL SLTG24 416000F2 ANGEL_1 100 ANGEL SLTG24 Units loaded: 2000 Units allocated: 600 Units available: 1400 The SHOW LICENSE command in this example lists the current users of the activity license for the product DECwrite. For each instance of use of the product, the process identification (PID), process name, node, and user name are identified. The units column shows the number of units allocated for each particular invocation of the product. The last line displays the units loaded when the LICENSE LOAD command was given, the total number of units currently allocated, and the total of unused (available for others to use) units. 9.$ SHOW LICENSE/USAGE/FULL TEST_PER View of loaded licenses from node: SLTG24 30-DEC-2001 15:45:59 PERSONAL USE license DEC TEST_PER usage information: Units Reserved for: 100 UNCLE 100 AUNT 100 NEPHEW 100 NIECE Units loaded: 600 Units reserved: 400 Units available: 200 This example shows a personal use license. The DEC TEST_PER product has enough units for six reservations with 100 units for each reservation. The license database (LDB) only has a total of four names in the reserve list attached to this product. If the license administrator (usually the system manager) wants to take full advantage of this license and adds 2 more names to the reserve list, he should use the following commands to update the product information: $ LICENSE MODIFY TEST_PER/RESERVE=(NAME, ANOTHER_NAME)/ADD $ LICENSE UNLOAD TEST_PER $ LICENSE LOAD TEST_PER If this product is used in a cluster environment, you may use the SYSMAN utility to unload and load the license. 10.$ SHOW LICENSE/USAGE/FULL TEST_CAP View of loaded licenses from node: SLTG24 30-DEC-2001 15:45:59 Availability license DEC TEST_CAP usage information: Units Node 10 SLTG24 10 SLTG43 600 TORN8O 600 LTNUP Units loaded: 620 Units allocated: 1220 Units available: *** In this example, the number of units allocated appears to be greater than the total units loaded and the units available value is three asterisks (***). When you see three asterisks (***) as the number of units available, it is generally not a cause for alarm. This situation might arise when the license database (LDB) has been updated on disk, but the new information has not been propagated to the license database in memory on all nodes in the cluster. This node, SLTG24, happens to be one of the nodes that has not received the latest LDB information. To update the information in the license database in memory for the TEST_CAP product, enter the following commands: $ LICENSE UNLOAD TEST_CAP $ LICENSE LOAD TEST_CAP The next time you issue the SHOW LICENSE/USAGE command the three asterisks (***) in display should disappear. If, however, you are using multiple LDB files in a cluster, you should read the section on the license database in the OpenVMS License Management Utility Manual. 11.$ SHOW LICENSE/UNIT_REQUIREMENT/CLUSTER VMS/LMF Cluster License Unit Requirements Information 24-DEC-2001 14:05:51.65 Node A B C D E F G H I KARBO - - - 100 50 10 - - 10 JENJON - - - 100 50 10 - - 10 HELENE 143 - - - 600 2400 - - 2400 SHAKTI - - - 100 50 10 - - 10 Total Cluster Unit Requirements Type: A, Units Required: 143 (VMS Capacity) Type: B, * Not Permitted * (VMS Server) Type: C, * Not Permitted * (VMS Concurrent User) Type: D, Units Required: 300 (VMS Workstation) Type: E, Units Required: 750 (System Integrated Products) Type: F, Units Required: 2430 (Layered Products) Type: G, * Not Permitted * (VMS Reserved) Type: H, * Not Permitted * (Alpha Layered Products) Type: I, Units Required: 2430 (Layered Products) In this example, the display shows how many license units are required for each license type (A, B, etc.) on each node in the cluster. If a row of three asterisks (***) is displayed for a node, it means that the node is in the process of booting. 2 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[:][,...]] 3 Parameter logical-name[:][,...] Specifies one or more logical names whose translations you want to display. The asterisk (*) and the percent sign (%) wildcard characters 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. 3 Qualifiers /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, /JOB, /GROUP, /SYSTEM, or /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. /EXACT Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a search string that must match the search string exactly and must be enclosed with quotation marks (" "). If you specify the /EXACT qualifier without the /SEARCH qualifier, exact search mode is enabled when you set the search string with the Find (E1) key. /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. /HIGHLIGHT /HIGHLIGHT[=keyword] Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the type of highlighting you want when a search string is found. When a string is found, the entire line is highlighted. You can use the following keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD is the default highlighting. /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. The asterisk (*) and the percent sign (%) 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. /PAGE /PAGE[=keyword] /NOPAGE (default) Controls the display of information on the screen. You can use the following keywords with the /PAGE qualifier: CLEAR_SCREEN Clears the screen before each page is displayed. SCROLL Displays information one line at a time. SAVE[=n] Enables screen navigation of information, where n is the number of pages to store. The /PAGE=SAVE qualifier allows you to navigate through screens of information. The /PAGE=SAVE qualifier stores up to 5 screens of up to 255 columns of information. When you use the /PAGE=SAVE qualifier, you can use the following keys to navigate through the information: Key Sequence Description Up arrow key, Ctrl/B Scroll up one line. Down arrow key Scroll down one line. Left arrow key Scroll left one column. Right arrow key Scroll right one column. Find (E1) Specify a string to find when the information is displayed. Insert Here (E2) Scroll right one half screen. Remove (E3) Scroll left one half screen. Select (E4) Toggle 80/132 column mode. Prev Screen (E5) Get the previous page of information. Next Screen (E6), Get the next page of information. Return, Enter, Space F10, Ctrl/Z Exit. (Some utilities define these differently.) Help (F15) Display utility help text. Do (F16) Toggle the display to oldest/newest page. Ctrl/W Refresh the display. The /PAGE qualifier is not compatible with the /OUTPUT qualifier. /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. /SEARCH /SEARCH="string" Use with the /PAGE=SAVE qualifier to specify a string that you want to find in the information being displayed. Quotation marks are required for the /SEARCH qualifier, if you include spaces in the text string. You can also dynamically change the search string by pressing the Find key (E1) while the information is being displayed. Quotation marks are not required for a dynamic search. /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. The asterisk (*) and the percent sign (%) wildcard characters are allowed. Names with wildcards are used to match table names. Names without wildcard characters 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. /WRAP /WRAP /NOWRAP (default) Use with the /PAGE=SAVE qualifier to limit the number of columns to the width of the screen and to wrap lines that extend beyond the width of the screen to the next line. The /NOWRAP qualifier extends lines beyond the width of the screen and can be seen when you use the scrolling (left and right) features provided by the /PAGE=SAVE qualifier. 3 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" = "DKA2:" "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. 2 MEMORY Displays the availability and usage of those system resources that are related to memory. Format SHOW MEMORY 3 Qualifiers /ALL /ALL (default) Displays all available information, that is, information displayed by the /FILES, /PHYSICAL_PAGES, /POOL, and /SLOTS qualifiers. /BUFFER_OBJECTS /BUFFER_OBJECTS (Alpha only) Displays information about system resources used by buffer objects. /CACHE /CACHE[=(keyword[,...])] Displays information about the Virtual I/O Cache facility or the Extended File Cache facility, depending on which is loaded. The Cache facility information is displayed as part of the SHOW MEMORY and SHOW MEMORY/CACHE/FULL commands. If the Extended File Cache is loaded, you can specify the following keywords and options: VOLUME[=device] Requests display of volume-level statistics for the specified volume(s). If no device is specified, defaults to SYS$DISK. Device specifications may be wildcarded; if so, the device specification must be based on the physical device name. Specify VOLUME=* to see statistics for all volumes in cache. FILE=filespec Requests display of file-level statistics for the specified file(s) in cache. The filespec must contain an explicit or implicit device specification. The filespec may be wildcarded according to RMS rules. Specify FILE=dev:*.* to see statistics for all files in cache for a device. Partially wild file specifications that are satisfied by large numbers of files on disk may incur significant processing overhead during display. By default, both open and closed files are displayed (use the OPEN and CLOSED keywords to further restrict which files are displayed). Note that this command may fail if you select a large number of files for display. If you receive an error message, reduce the number of selected files and reissue the command. TOPQIO[=n] Requests display of file-level statistics for the n files in cache with the highest overall QIO count (n defaults to 10). TOPHITRATE[=n] Requests display of file-level statistics for the n files in cache with the highest overall cache hit rate (n defaults to 10). OPEN Include only open files in the display (default for TOPQIO and TOPHITRATE). CLOSED Include only closed files in the display. /EXACT Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a search string that must match the search string exactly and must be enclosed with quotation marks (" "). If you specify the /EXACT qualifier without the /SEARCH qualifier, exact search mode is enabled when you set the search string with the Find (E1) key. /FILES Displays information about the use of each paging and swapping file currently installed. /FULL Displays additional information about 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. (Note that for Version 7.3 EFT2, the /FULL qualifier is ignored.) When used with the /CACHE qualifier, /FULL displays additional information about the file data cache that is loaded (either VIOC or XFC). /GH_REGIONS On Alpha, displays information about the granularity hint regions (GHR) that have been established. For each of these regions, information is displayed about the size of the region, the amount of free memory, the amount of memory in use, and the amount of memory released to OpenVMS from the region. The granularity hint regions information is also displayed as part of SHOW MEMORY, SHOW MEMORY/ALL, and SHOW MEMORY/FULL commands. /HIGHLIGHT /HIGHLIGHT[=keyword] Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the type of highlighting you want when a search string is found. When a string is found, the entire line is highlighted. You can use the following keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD is the default highlighting. /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 cannot include asterisk (*) and the percent sign (%) wildcard characters. If you enter the /NOOUTPUT qualifier, output is suppressed. /PAGE /PAGE[=keyword] /NOPAGE (default) Controls the display of memory information on the screen. You can use the following keywords with the /PAGE qualifier: CLEAR_SCREEN Clears the screen before each page is displayed. SCROLL Displays information one line at a time. SAVE[=n] Enables screen navigation of information, where n is the number of pages to store. The /PAGE=SAVE qualifier allows you to navigate through screens of information. The /PAGE=SAVE qualifier stores up to 5 screens of up to 255 columns of information. When you use the /PAGE=SAVE qualifier, you can use the following keys to navigate through the information: Key Sequence Description Up arrow key, Ctrl/B Scroll up one line. Down arrow key Scroll down one line. Left arrow key Scroll left one column. Right arrow key Scroll right one column. Find (E1) Specify a string to find when the information is displayed. Insert Here (E2) Scroll right one half screen. Remove (E3) Scroll left one half screen. Select (E4) Toggle 80/132 column mode. Prev Screen (E5) Get the previous page of information. Next Screen (E6), Get the next page of information. Return, Enter, Space F10, Ctrl/Z Exit. (Some utilities define these differently.) Help (F15) Display utility help text. Do (F16) Toggle the display to oldest/newest page. Ctrl/W Refresh the display. The /PAGE qualifier is not compatible with the /OUTPUT qualifier. /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. /RESERVED /RESERVED (Alpha only) Displays information about memory reservations. /SEARCH /SEARCH="string" Use with the /PAGE=SAVE qualifier to specify a string that you want to find in the information being displayed. Quotation marks are required for the /SEARCH qualifier, if you include spaces in the text string. You can also dynamically change the search string by pressing the Find key (E1) while the information is being displayed. Quotation marks are not required for a dynamic search. /SLOTS Displays information about the availability of partition control block (PCB) vector slots and balance slots. /WRAP /WRAP /NOWRAP (default) Use with the /PAGE=SAVE qualifier to limit the number of columns to the width of the screen and to wrap lines that extend beyond the width of the screen to the next line. The /NOWRAP qualifier extends lines beyond the width of the screen and can be seen when you use the scrolling (left and right) features provided by the /PAGE=SAVE qualifier. 3 Examples 1.$ SHOW MEMORY System Memory Resources on 20-JAN-2001 15:22:04.11 Physical Memory Usage (pages): Total Free In Use Modified Main Memory (2.00Gb) 262144 201249 60162 733 Extended File Cache (Time of last reset: 18-JAN-2001 17:15:14.33) Allocated (Mbytes) 370.00 Maximum size (Mbytes) 1024.00 Free (Mbytes) 317.79 Minimum size (Mbytes) 370.00 In use (Mbytes) 52.20 Percentage Read I/Os 72% Read hit rate 96% Write hit rate 0% Read I/O count 119363 Write I/O count 46259 Read hit count 115283 Write hit count 0 Reads bypassing cache 45 Writes bypassing cache 0 Files cached open 372 Files cached closed 392 Vols in Full XFC mode 0 Vols in VIOC Compatible mode 3 Vols in No Caching mode 0 Vols in Perm. No Caching mode 0 Granularity Hint Regions (pages): Total Free In Use Released Execlet code region 1024 0 586 438 Execlet data region 256 0 256 0 S0/S1 Executive data region 576 0 576 0 Resident image code region 1024 0 830 194 Slot Usage (slots): Total Free Resident Swapped Process Entry Slots 647 614 33 0 Balance Set Slots 645 614 31 0 Dynamic Memory Usage: Total Free In Use Largest Nonpaged Dynamic Memory (Mb) 4.28 2.38 1.89 2.25 Bus Addressable Memory (Kb) 168.00 128.00 40.00 128.00 Paged Dynamic Memory (Mb) 5.68 3.42 2.26 3.41 Lock Manager Dyn Memory (Mb) 1.13 0.00 1.12 Buffer Object Usage (pages): In Use Peak 32-bit System Space Windows (S0/S1) 3 3 64-bit System Space Windows (S2) 0 0 Physical pages locked by buffer objects 3 3 Memory Reservations (pages): Group Reserved In Use Type VCC$MIN_CACHE_SIZE --- 47360 47360 Allocated Total (370.00 Mbytes reserved) 47360 47360 Swap File Usage (8KB pages): Index Free Size DISK$X6XV_BRAHMA:[SYS0.SYSEXE]SWAPFILE.SYS 1 5168 5168 Paging File Usage (8KB pages): Index Free Size DISK$X6XV_BRAHMA:[SYS0.SYSEXE]PAGEFILE.SYS 254 215288 215288 Total committed paging file usage: 7418 Of the physical pages in use, 4951 pages are permanently allocated to OpenVMS. This example shows reservable pages. If the reservable pages are a negative value, this indicates that you may want to consider adding to the fixed amount of pagefile space available. 2.$ SHOW MEMORY/CACHE/FULL System Memory Resources on 3-NOV-2001 18:36:12.79 Extended File Cache (Time of last reset: 31-OCT-2001 10:18:07.39) Allocated (Mbytes) 1370.00 Maximum size (Mbytes) 91024.00 Free (Mbytes) 2319.75 Minimum size (Mbytes) 10 370.0 In use (Mbytes) 3 50.25 Percentage Read I/Os 11 98% Read hit rate 4 79% Write hit rate 12 0% Read I/O count 5 18110 Write I/O count 13 310 Read hit count 6 14343 Write hit count 14 0 Reads bypassing cache 7 37 Writes bypassing cache 15 0 Files cached open 8 351 Files cached closed 16 307 Vols in Full XFC mode 17 0 Vols in VIOC Compatible mode 17 0 Vols in No Caching mode17 0 Vols in Perm No Caching mode 17 0 I/O Statistics 18 - Distributions (MAX_IO_SIZE: 127 19) ------------------------------------------------------- Transfer Size: Reads Read Hits Writes 1 Block IO: 35053 20 34553 21 87 22 2 Block IO: 469 284 9 3 Block IO: 26516 26346 24 4 Block IO: 348 205 6 5 Block IO: 13205 13160 0 6 Block IO: 161 111 0 7 Block IO: 185 152 0 . . . 114 Block IO: 1 0 0 116 Block IO: 2 1 0 121 Block IO: 1 0 0 >127<256 Block IO: 12 0 >255 Block IO: 14 0 ---------------------------------------------------- Totals: 84411 80535 630 NOTE This example shows the output for the SHOW MEMORY/CACHE/FULL command on an Alpha system with the Extended File Cache loaded. The SHOW MEMORY/CACHE/FULL command will display different fields on a VAX system or on an Alpha system with the Virtual I/O Cache loaded. Extended File Cache Usage Shows the use of the Extended File Cache facility on an Alpha system. 1 Allocated Total amount of system memory in megabytes allocated to the Extended File Cache. 2 Free Number of allocated megabytes not currently in use by the cache. 3 In use Number of allocated megabytes that contain valid cached data. 4 Read hit rate Shows cache read hits as a percentage of read I/Os. 5 Read I/O count Total number of read I/Os that have been seen by the cache since the last statistics reset. 6 Read hit count Total number of read I/Os that did not perform a physical I/O, because the data for these was found in the cache since the prior statistics reset. 7 Reads bypassing Total number of reads that bypassed the cache cache and went directly to disk since the last statistics reset. 8 Files cached Total number of open files in cache. open 9 Maximum size Maximum size of the cache in megabytes. (Mbytes) 10 Minimum size Minimum size of the cache in megabytes. (Mbytes) This displays the value of the memory reservation, VCC$MIN_CACHE_SIZE. Refer to the OpenVMS System Manager's Manual for additional information. 11 Percentage Percentage of read I/Os that occur. For Read I/Os example, a read/write I/O ratio of 100% implies that all were read I/Os. 12 Write hit rate (Always zero for Extended File Cache, Version 1.) 13 Write I/O Total number of write I/Os that have been count seen by the cache since the last statistics reset. 14 Write hit (Always zero for Extended File Cache, count Version 1.) 15 Writes Total number of writes that bypassed the bypassing cache cache and went directly to disk since the last statistics reset. 16 Files cached Total number of closed files in cache. closed 17 Volume modes Total number of volumes in each caching state. Note that the initial release of XFC only supports VIOC compatible mode. Future releases will support full mode. 18 I/O Statistics Systemwide distribution of I/O sizes (rounded up). 19 MAX_IO_SIZE Current setting of the system parameter VCC_ MAX_IO_SIZE in blocks. The extended file cache (XFC) will only cache files up to this size. 20 Reads Number of reads for the entire system. 21 Read Hits Number of reads satisfied from the cache. 22 Writes Number of writes for the entire system. 3.$ SHOW MEMORY/CACHE=(VOLUME=*) System Memory Resources on 20-JAN-2001 15:35:32.51 Extended File Cache Volume Statistics: _$7$DKA200: (DISK$X6XV_BRAHMA), Caching mode is VIOC Compatible Open files 1 372 Closed files 9 395 Files ever opened 2 1007 Files ever deposed 10 240 Allocated pages 3 6405 Locks acquired 11 736 Total QIOs 4 166552 Read hits 12 115984 Virtual reads 5 120068 Virtual writes 13 46484 Hit rate 6 69 % Read aheads 14 11766 Read throughs 7 120021 Write throughs 15 46484 Read arounds 8 47 Write arounds 16 0 Ave Disk I/O Resp Time incl cache hits (microseconds)17 3497 Total of 1 volumes in cache Extended File Cache Usage Shows the use of the Extended File Cache facility on an Alpha system. 1 Open files Number of files that are currently open and cached by the extended file cache on this volume at the instant the SHOW command was issued. 2 Files ever Number of times the extended file cache has been opened requested to open a file on this volume. 3 Allocated Number of main memory data pages currently pages being used by the extended file cache to contain actual file data, for this volume. 4 Total QIOs Total number of QIO and PAGE I/O calls received by the extended file cache on this volume. 5 Virtual Cumulative number of Virtual Read requests reads received by the extended file cache on this volume. 6 Hit rate Percentage of Total QIOs that were completed by copying data from cache, rather than issuing real I/O to a volume. 7 Read Number of Virtual Reads that are capable of throughs being satisfied by the extended file cache. 8 Read Number of Virtual Reads that cannot be satisfied arounds by the extended file cache. Reasons for this include the presence of a non-XFC compliant node in an OpenVMS cluster, and the receipt of an I/O that is larger than VCC_MAX_IO_SIZE. 9 Closed Number of closed files the extended file cache files has in memory. If a subsequent file access occurs, data will be accessible from main memory rather than having to issue I/O to the real volume. 10 Files Files removed from memory. Reasons the extended ever deposed file cache may remove a file from its memory include requests for memory from the rest of the system, and conflicting access modes in a cluster. 11 Locks Current number of file access locks that are in acquired use on this volume. 12 Read hits Cumulative number of times a read has been satisfied from the data cache. 13 Virtual Cumulative number of virtual write I/Os received writes on this volume by the cache. 14 Read Cumulative number of times the extended file aheads cache issued read ahead I/Os on this volume after detecting sequential file I/O virtual reads. 15 Write Cumulative number of times a virtual write has throughs been capable of modifying cached data. 16 Write Cumulative number of times a virtual write has arounds been detected that cannot update data in cache memory. 17 Average Average disk I/O response time, including cache Disk I/O hits, in microseconds. Note that on a symmetric Response multiprocessing (SMP) system, the response time Time only includes that of I/Os starting or finishing on the same CPU. Any physical I/Os are ignored. 4.$ SHOW MEMORY/CACHE=(VOL=DKA100,TOPQIO=3) System Memory Resources on 3-NOV-2001 18:36:12.79 Extended File Cache Top QIO File Statistics: _$7$DKA200: (DISK$X6Y0_RESD), Caching mode is VIOC Compatible _$7$DKA200:[SYS0.SYSEXE]SYSDUMP.DMP;2 (open) Caching is enabled, active caching mode is Write Through Allocated pages 1 334 Total QIOs 6 1712 Read hits 2 1559 Virtual reads 7 1712 Virtual writes 3 0 Hit rate 8 91 % Read aheads 4 0 Read throughs 9 0 Write throughs 5 0 Read arounds 10 0 Write arounds 11 0 _$7$DKA200:[VMS$COMMON.SYSEXE]SYS$QUEUE_MANAGER.QMAN$JOURNAL;1 (open) Caching is enabled, active caching mode is Write Through Allocated pages 931 Total QIOs 1057 Read hits 5 Virtual reads 1044 Virtual writes 13 Hit rate 0 % Read aheads 2 Read throughs 1044 Write throughs 13 Read arounds 0 Write arounds 0 _$7$DKA200:[VMS$COMMON.SYSLIB]DECC$SHR.EXE;1 (open) Caching is enabled, active caching mode is Write Through Allocated pages 135 Total QIOs 730 Read hits 673 Virtual reads 730 Virtual writes 0 Hit rate 0 % Read aheads 2 Read throughs 0 Write throughs 0 Read arounds 0 Write arounds 0 Total of 3 files for this volume Extended File Cache Top QIO File Statistics Usage Shows the use of the Extended File Cache Top QIO File Statistics facility on an Alpha system. 1 Allocated pages Number of main memory data pages currently being used by the extended file cache to contain actual file data, for this volume 2 Read hits Cumulative number of times a read has been satisfied from the data cache. 3 Virtual writes Cumulative number of virtual write I/Os received on this volume by the cache. 4 Read aheads Cumulative number of times the extended file cache issued read ahead I/Os on this volume after detecting sequential file I/O virtual reads. 5 Write throughs Cumulative number of times a virtual write has been capable of modifying cached data. 6 Total QIOs Total number of QIO and PAGE I/O calls received by the extended file cache on this volume. 7 Virtual reads Cumulative number of Virtual Read requests received by the extended file cache on this volume. 8 Hit rate Percentage of Total QIOs that were completed by copying data from cache, rather than issuing real I/O to a volume. 9 Read throughs Number of Virtual Reads that are capable of being satisfied by the extended file cache. 10 Read arounds Number of Virtual Reads that cannot be satisfied by the extended file cache. Reasons for this include the presence of a non-XFC compliant node in an OpenVMS cluster, and the receipt of an I/O that is larger than VCC_MAX_IO_SIZE. 11 Write arounds Cumulative number of times a virtual write has been detected that cannot update data in cache memory. 5.$ SHOW MEMORY/CACHE=(VOL=DKA100,TOPHITRATE=3) System Memory Resources on 3-NOV-2001 18:36:12.79 Extended File Cache Top Hitrate File Statistics: _$7$DKA200: (DISK$X6Y0_RESD), Caching mode is VIOC Compatible _$7$DKA200:[VMS$COMMON.SYSLIB]SMGSHR.EXE;1 (open) Caching is enabled, active caching mode is Write Through Allocated pages 1 16 Total QIOs 6 277 Read hits 2 267 Virtual reads 7 277 Virtual writes 3 0 Hit rate 8 96 % Read aheads 4 0 Read throughs 9 277 Write throughs 5 0 Read arounds 10 0 Write arounds 11 0 _$7$DKA200:[VMS$COMMON.SYSLIB]UTIL$SHARE.EXE;1 (open) Caching is enabled, active caching mode is Write Through Allocated pages 8 Total QIOs 185 Read hits 178 Virtual reads 185 Virtual writes 0 Hit rate 96 % Read aheads 1 Read throughs 185 Write throughs 0 Read arounds 0 Write arounds 0 _$7$DKA200:[VMS$COMMON.SYSLIB]CMA$TIS_SHR.EXE;1 (open) Caching is enabled, active caching mode is Write Through Allocated pages 6 Total QIOs 165 Read hits 159 Virtual reads 165 Virtual writes 0 Hit rate 96 % Read aheads 2 Read throughs 165 Write throughs 0 Read arounds 0 Write arounds 0 Total of 3 files for this volume Extended File Cache Top Hitrate File Statistics Usage Shows the use of the Extended File Cache Top Hitrate File Statistics facility on an Alpha system. 1 Allocated pages .Number of main memory data pages currently being used by the extended file cache to contain actual file data, for this volume 2 Read hits Cumulative number of times a read has been satisfied from the data cache. 3 Virtual writes Cumulative number of virtual write I/Os received on this volume by the cache. 4 Read aheads Cumulative number of times the extended file cache issued read ahead I/Os on this volume after detecting sequential file I/O virtual reads. 5 Write throughs Cumulative number of times a virtual write has been capable of modifying cached data. 6 Total QIOs Total number of QIO and PAGE I/O calls received by the extended file cache on this volume. 7 Virtual reads Cumulative number of Virtual Read requests received by the extended file cache on this volume. 8 Hit rate Percentage of Total QIOs that were completed by copying data from cache, rather than issuing real I/O to a volume. 9 Read throughs Number of Virtual Reads that are capable of being satisfied by the extended file cache. 10 Read arounds Number of Virtual Reads that cannot be satisfied by the extended file cache. Reasons for this include the presence of a non-XFC compliant node in an OpenVMS cluster, and the receipt of an I/O that is larger than VCC_MAX_IO_SIZE. 11 Write arounds Cumulative number of times a virtual write has been detected that cannot update data in cache memory. 6.$ SHOW MEMORY/CACHE=(FILE=SYS$LOGIN:*.*,OPEN,CLOSED) System Memory Resources on 3-NOV-2001 18:36:12.79 Extended File Cache Statistics: _$7$DKA200:[SYS0.SYSMGR]ACCOUNTNG.DAT;1 (open) Caching is enabled, active caching mode is Write Through Allocated pages 1 1 Total QIOs 6 17 Read hits 2 0 Virtual reads 7 1 Virtual writes 3 16 Hit rate 8 0 % Read aheads 4 0 Read throughs 9 0 Write throughs 5 16 Read arounds 10 0 Write arounds 11 0 _$7$DKA200:[SYS0.SYSMGR]ACME$SERVER.LOG;129 (open) Caching is enabled, active caching mode is Write Through Allocated pages 1 Total QIOs 2 Read hits 0 Virtual reads 1 Virtual writes 1 Hit rate 0 % Read aheads 0 Read throughs 1 Write throughs 1 Read arounds 0 Write arounds 0 _$7$DKA200:[SYS0.SYSMGR]CLUE$STARTUP_BRAHMA.LOG;935 (closed) Caching is enabled, active caching mode is Write Through Allocated pages 2 Total QIOs 32 Read hits 0 Virtual reads 0 Virtual writes 32 Hit rate 0 % Read aheads 0 Read throughs 0 Write throughs 32 Read arounds 0 Write arounds 0 . . . _$7$DKA200:[VMS$COMMON.SYSMGR]VMS$AUDIT_SERVER.DAT;1 (open) Caching is enabled, active caching mode is Write Through Allocated pages 1 Total QIOs 8 Read hits 3 Virtual reads 8 Virtual writes 0 Hit rate 37 % Read aheads 1 Read throughs 8 Write throughs 0 Read arounds 0 Write arounds 0 Total of 50 files for this volume Extended File Cache Statistics Usage Shows the use of the Extended File Cache Statistics facility on an Alpha system. 1 Allocated pages .Number of main memory data pages currently being used by the extended file cache to contain actual file data, for this volume 2 Read hits Cumulative number of times a read has been satisfied from the data cache. 3 Virtual writes Cumulative number of virtual write I/Os received on this volume by the cache. 4 Read aheads Cumulative number of times the extended file cache issued read ahead I/Os on this volume after detecting sequential file I/O virtual reads. 5 Write throughs Cumulative number of times a virtual write has been capable of modifying cached data. 6 Total QIOs Total number of QIO and PAGE I/O calls received by the extended file cache on this volume. 7 Virtual reads Cumulative number of Virtual Read requests received by the extended file cache on this volume. 8 Hit rate Percentage of Total QIOs that were completed by copying data from cache, rather than issuing real I/O to a volume. 9 Read throughs Number of Virtual Reads that are capable of being satisfied by the extended file cache. 10 Read arounds Number of Virtual Reads that cannot be satisfied by the extended file cache. Reasons for this include the presence of a non-XFC compliant node in an OpenVMS cluster, and the receipt of an I/O that is larger than VCC_MAX_IO_SIZE. 11 Write arounds Cumulative number of times a virtual write has been detected that cannot update data in cache memory. 7.$ SHOW MEMORY/PHYSICAL_PAGES System Memory Resources on 3-NOV-2001 16:11:30.76 Physical Memory Usage (pages): Total 1 Free 2 In Use 3 Modified 4 Main Memory (32.00Mb) 65536 44233 20955 308 Of the physical pages in use, 10970 pages are permanently allocated to VMS. Physical Memory Usage Shows the use of physical memory. 1 Total Number of physical memory pages available for general system use. Multiport memory pages (existing on some VAX) used for shared memory global sections, mailboxes, and common event blocks are not included in this number. 2 Free Number of pages on the free page list. 3 In Use Number of pages currently being used. This number is calculated by adding the number of pages on the free, modified, and bad lists and then subtracting that sum from the total number of available pages. 4 Modified Number of pages on the modified page list. Bad Page List Shows the contents of the bad page list. NOTE This display is written only when there are pages on the bad page list. Total Number of pages on the bad page list. Dynamic Number of memory errors detected after the system was booted. I/O Errors Number of errors detected during page fault handling. Static Number of memory errors detected during boot-time scan. By default, either single-bit or double-bit errors cause the pages to be removed during the boot-time scan. Pages Allocated to OpenVMS Any SHOW MEMORY display that includes the physical memory display concludes with the number of pages permanently allocated to the OpenVMS system. These pages include nonpaged executive code and data, the PFN database, nonpaged dynamic memory, the interrupt stack, and the system page table. 8. $ SHOW MEMORY/SLOTS System Memory Resources on 3-NOV-2001 16:11:35.31 Slot Usage (slots): Total 1 Free 2 Resident 3 Swapped 4 Process Entry Slots 75 28 46 1 Balance Set Slots 70 26 44 0 Slot Usage (slots) Displays the use of process entry slots and balance set slots. 1 Total Number of process entry slots (the value of the system parameter MAXPROCESSCNT) and balance set slots (the value of the system parameter BALSETCNT) permanently allocated when the system was bootstrapped. 2 Free Number of slots currently available. 3 Resident Number of slots currently used by memory-resident processes. The number of balance set slots in use can never be any larger than the number of process entry slots in use because the SWAPPER and NULL processes have process entry slots but do not require balance set slots. 4 Swapped Number of slots used by outswapped processes. For process entry slots, this number includes all processes that have been partially outswapped. For balance set slots, this number includes those processes that have had their process bodies outswapped but have process headers that are still resident. 9. $ SHOW MEMORY/POOL System Memory Resources on 5-DEC-2001 03:59:35.29 Dynamic Memory Usage (bytes): Total 1 Free 2 In Use 3 Largest 4 Nonpaged Dynamic Memory 24993792 23511872 1481920 23363776 Bus Addressable Memory 131072 114688 16384 114688 Paged Dynamic Memory 5799936 3530784 2269152 3530176 Lock Manager Dynamic Memory 1048576 254976 793600 Dynamic Memory Usage (in bytes) Shows the use of the nonpaged and paged pool areas that allocate variably sized blocks. 1 Total Total number of bytes set aside for each area. 2 Free Total amount of free space in each dynamic memory area. 3 In Use Amount of space currently allocated from each area. This number is the total size minus the number of free bytes. 4 Largest Size of the largest contiguous block in each area. For the paged pool, this number represents the largest block that can be allocated. For the nonpaged pool, an allocation request larger than this number will cause the nonpaged pool to grow (if other constraints allow growth). This attribute does not apply to the lock manager, as all items for the lock manager are the same size. 10. $ SHOW MEMORY/POOL/FULL System Memory Resources on 5-DEC-2001 03:59:35.29 Nonpaged Dynamic Memory (Lists + Variable) Current Size (bytes) 1 24993792 Current Size (pagelets) 1 48816 Initial Size (NPAGEDYN) 2 24993792 Initial Size (pagelets) 2 48816 Maximum Size (NPAGEVIR) 3499998720 Maximum Size (pagelets) 3 976560 Free Space (bytes) 4 22230144 Space in Use (bytes) 52763648 Largest Variable Block 6 19676672 Smallest Variable Block 7 2176 Number of Free Blocks 8 38334 Free Blocks LEQU 64 Bytes9 0 Free Blocks on Lookasides16 38330 Lookaside Space (bytes) 2537472 Bus Addressable Memory (Lists + Variable) Current Size (bytes) 1 131072 Current Size (pagelets) 1 256 Initial Size (NPAGEDYN) 2 131072 Initial Size (pagelets) 2 256 Free Space (bytes) 4 114688 Space in Use (bytes) 5 16384 Largest Variable Block 6 114688 Smallest Variable Block 7 114688 Number of Free Blocks 8 1 Free Blocks LEQU 64 Bytes9 0 Free Blocks on Lookasides16 0 Lookaside Space (bytes) 0 Paged Dynamic Memory Current Size (PAGEDYN) 1 5799936 Current Size (pagelets) 1 11328 Free Space (bytes) 4 3518288 Space in Use (bytes) 52281648 Largest Variable Block 6 3517584 Smallest Variable Block 7 16 Number of Free Blocks 8 25 Free Blocks LEQU 64 Bytes9 23 Lock Manager Dynamic Memory Current Size (Mbytes) 1 13.85 Current Size (pages) 1 1774 Free Space (Mbytes) 4 10.06 Hits 12 54050 Space In Use 5 3.79 Misses 13 1664 Number of Empty Pages 10 26 Expansions 14 1792 Number of Free Packets 11 41244 Packet Size 15 256 Dynamic Memory Shows the use of dynamic memory areas consisting of variably sized blocks. 1 Current Size Current size (in 512-byte pagelets on Alpha and in bytes and pages on VAX) of each dynamic memory area. For the lock manager display, the unit of measurement is megabytes. 2 Initial Size Initial size of nonpaged dynamic memory and the name of the system parameter (NPAGEDYN) that controls this size. 3 Maximum Size Maximum size to which nonpaged dynamic memory can grow and the name of the system parameter (NPAGEVIR) that controls this size. 4 Free Space Amount of free space in each dynamic memory area. 5 Space in Use Amount of space currently allocated from each area. 6 Largest Block Size of the largest contiguous area in each pool area. 7 Smallest Block Size of the smallest hole (free block) in each pool area. 8 Free Blocks Total number of free blocks in each pool area. The size of this number is a measure of pool fragmentation. 9 Blocks LEQU 64 Number of free blocks that are 64 bytes long or shorter. This number is another measure of pool fragmentation because while allocation of these small blocks is unlikely, they contribute to the allocation time whenever an allocation request is made. 10 Empty Pages Number of pages that do not have any packets allocated. 11 Free Packets Total number of packets not in use. This number is the sum of free packets from partially used pages and the packets of all Empty Pages. 12 Hits Total number of packet allocations. 13 Misses Total number of packet allocation requests that could not be satisfied because the number of packets requested were not available. A miss causes dynamic memory to expand by one page to satisfy the packet allocation request. 14 Expansions Total number of times that dynamic memory increased by a page to satisfy packet allocation requests. 15 Packet Size Packet size of 256 bytes, which is used by the lock manager to hold either a lock block data structure or a resource block data structure. 16 Lookasides Total number of memory packets that the Free Blocks system has preallocated and placed on "lookaside lists". If a packet of the correct size is on a lookaside list, it can be allocated very quickly and efficiently, however, it can not then be used as part of any other size packet. An excess of packets on the lookaside list can be a cause for the inability to allocate other sizes. 11. $ SHOW MEMORY/FILES System Memory Resources on 22-MAY-2001 19:04:19.67 Swap File Usage (8KB pages): Index 1 Free Size DISK$ALPHASYS:[SYS48.SYSEXE]SWAPFILE.SYS 1 904 904 DISK$SWAP:[SYS48.SYSEXE]SWAPFILE.SYS;1 2 1048 1048 Total size of all swap files: 1952 Paging File Usage (8KB pages): Index 2 Free Size DISK$PAGE:[SYS48.SYSEXE]PAGEFILE.SYS;1 253 16888 16888 DISK$ALPHASYS:[SYS48.SYSEXE]PAGEFILE.SYS 254 16888 16888 Total size of all paging files: 33776 Total committed paging file usage: 3 1964 Paging File Usage (in blocks) Shows the usage of paging and swapping files. 1 Swap File Usage Number of swap files. Begins with an index value of 1 and increases in count. 2 Paging File Number of page files. Begins with an index Usage value of 254 and decreases in count. 3 Total Paging Total committed page file usage. As in File Usage previous releases, more pages can reside in page-file sections systemwide than would fit into installed page files. 2 NETWORK Displays information about network services registered on a node. Format SHOW NETWORK [network-service] 3 Parameter network-service Specifies a network service for which you want to display information. If you do not specify a service, the SHOW NETWORK command displays information about all services that are currently registered on the local node. 3 Description The SHOW NETWORK command displays information about network services available on an OpenVMS system. 3 Qualifiers /FULL Displays all the information for the specified network service. /OLD If you are running DECnet Phase IV, retains the behavior of the SHOW NETWORK command prior to OpenVMS Version 7.0. If the local node is a routing node, the /OLD qualifier provides routing information. /OUTPUT /OUTPUT[=filespec] /NOOUTPUT Controls where the output of the command is sent. By default, the output of the SHOW NETWORK command is sent to the current SYS$OUTPUT device (usually your terminal). The asterisk (*) and the percent sign (%) wildcard characters are not allowed in the file specification. If you enter the /NOOUTPUT qualifier, output is suppressed. 3 Examples 1.$ SHOW NETWORK Product: DECnet Node: GALENA Address(es): 19.64 Product: TCP/IP Node: GALENA.zka.cpq.com Address(es): 16.32.0.138 The SHOW NETWORK command in this example displays all the network services currently registered on the local node, and the name and address of that node. 2.$ SHOW NETWORK "TCP/IP" Product: TCP/IP Node: GALENA.zka.cpq.com Address(es): 16.32.0.138 The SHOW NETWORK command in this example displays the TCP/IP network service registered on the local node. 3.$ SHOW NETWORK/FULL The following network service is available at this time: Product: DECNET Manufacturer: Compaq Computer Corporation Node: NEMYA Address(es): 4.26 Network Type: DNA V Interface(s): net 0 Node 0 at 2001-02-26-10:35:28.737-05:00I526.997 Identifiers Name = DEC:.LKR.NEMYA Address = { ( [ DNA_CMIP-MICE ] , [ DNA_SessionControlV3 , number = 19 ] , [ DNA_OSItransportV1 , 'DEC0'H ] , [ DNA_OSInetwork , 49::00-04:AA-00-04-00-1A-10:21 (DEC:.LKR.NEMYA) ] ,) ( [ DNA_CMIP-MICE ] , [ DNA_SessionControlV2 , number = 19 ] , [ DNA_OSItransportV1 , 'DEC0'H ] , [ DNA_IP , 0.0.0.0 ] ,) ( [ DNA_CMIP-MICE ] , [ DNA_SessionControlV3 , number = 19 ] , [ DNA_NSP ] , [ DNA_OSInetwork , 49::00-04:AA-00-04-00-1A-10:20 (DEC:.LKR.NEMYA) ] ) } Status UID = 06E08000-DF79-11D4-8001-AA0004001A10 State = On Functions Enabled = { Address Watcher , CMIP Listener } ID = 08-00-2B-E5-A8-AB Characteristics Version = T5.0.3 Implementation = { [ Name = OpenVMS AXP , Version = "X901-SSB" ] , [ Name = Compaq DECnet-Plus for OpenVMS , Version = "V7.3 30-DEC-2000 01:14:34.32" ] } Script Location = Maximum Listeners = 0 Listener Template = Secondary Names = { LOCAL:.NEMYA } Counters Creation Time = 2001-02-05-11:53:38.135-05:00Iinf Renames = 1 Changes of ID = 9 IDROM Check Failures = 0 Changes of Address = 0 Node 0 Session Control Port SCL$PORT$12010029 at 2001-02-26-10:35:30.230-05:00I526.997 Identifiers Name = SCL$PORT$12010029 Status Client = Session Control Application 42 Local End User Address = UIC = [0,0]SYSTEM Transport Port = OSI Transport Port OSI$PORT_0_002A Direction = Outgoing Remote End User Address = number = 42 Node Name Sent = DEC:.LKR.NEMYA Version Sent = V3 Outgoing Network Priority = 0 Incoming Network Priority = 0 Process Identifier = "00000127" Counters Creation Time = 2001-02-26-10:33:14.104-05:00I526.966 Node 0 Session Control Port SCL$PORT$1201002A at 2001-02-26-10:35:30.230-05:00I526.997 Identifiers Name = SCL$PORT$1201002A Status Client = Session Control Application 42 Local End User Address = number = 42 Transport Port = OSI Transport Port OSI$PORT_0_002B Direction = Incoming Remote End User Address = UIC = [0,0]SYSTEM Node Name Sent = DEC:.LKR.NEMYA Version Sent = V3 Outgoing Network Priority = 0 Incoming Network Priority = 0 Process Identifier = "00000115" Counters Creation Time = 2001-02-26-10:33:14.112-05:00I526.966 Node 0 Session Control Port SCL$PORT$1201002D at 2001-02-26-10:35:30.230-05:00I526.997 Identifiers Name = SCL$PORT$1201002D Status Client = Session Control Application 42 Local End User Address = UIC = [0,0]SYSTEM Transport Port = OSI Transport Port OSI$PORT_0_002E Direction = Outgoing Remote End User Address = number = 42 Node Name Sent = DEC:.LKR.NEMYA Version Sent = V3 Outgoing Network Priority = 0 Incoming Network Priority = 0 Process Identifier = "0000012C" Counters Creation Time = 2001-02-26-10:35:19.522-05:00I526.996 Node 0 Session Control Port SCL$PORT$1201002E at 2001-02-26-10:35:30.231-05:00I526.997 Identifiers Name = SCL$PORT$1201002E Status Client = Session Control Application 42 Local End User Address = number = 42 Transport Port = OSI Transport Port OSI$PORT_0_002F Direction = Incoming Remote End User Address = UIC = [0,0]SYSTEM Node Name Sent = DEC:.LKR.NEMYA Version Sent = V3 Outgoing Network Priority = 0 Incoming Network Priority = 0 Process Identifier = "00000115" Counters Creation Time = 2001-02-26-10:35:19.529-05:00I526.996 Node 0 Session Control at 2001-02-26-10:35:32.081-05:00I526.997 Counters Creation Time = 2001-02-06-23:56:24.297-05:00Iinf Access Control Violations = 0 Backtranslation Deletions = 0 Deleted Maintained Objects = 0 Dangling Links = 0 Verification Failures = 0 $ The SHOW NETWORK/FULL command in this example displays all the information available about all the network services registered on the local node. 2 PRINTER Displays the current settings for a printer. Format SHOW PRINTER device-name[:] 3 Parameter device-name[:] Specifies the name of the printer for which settings are to be displayed. 3 Qualifier /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. The asterisk (*) and the percent sign (%) 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. /IDSTRING Returns the USB printer ID string as a text string and displays it on your screen. This information appears at the end of the typical SHOW PRINTER command display. /SERIALNUM Returns the USB printer serial number as a text string and displays to the screen. The USB printer returns the serial number in Unicode format, and this is converted to ASCII text before being displayed. 3 Examples 1.$ 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 No Tab Truncate No Sixels No Bitmapped No Polled Unidirectional Intermediate device: STAR$DUA1: Associated queue: LN01$PRINT The SHOW PRINTER command in this example displays the settings for the printer LPA0. 2.$ SHOW PRINTER LPA0/IDSTRING Printer LPA0:, device type PC printer, is online, record-oriented device, carriage control. Error count 0 Operations completed 0 Owner process "" Owner UIC [SYSTEM] Owner process ID 00000000 Dev Prot S:RWPL,O:RWPL,G,W Reference count 0 Default buffer size 132 Page width 132 Page Length 66 No Carriage_return Formfeed Uppercase No Passall No Wrap No Printall No Fallback No Tab Truncate No Sixels No Bitmapped Polled Unidirectional IDString: MFG: HEWLETT-PACKARD; MDL: DESKJET 895C; CMD: MLC,PCL,PML; CLASS: PRINTER; DESCRIPTION: Hewlett-Packard DeskJet 895C; SERN: MX88P2V0VWGO; VSTATUS: $HB0$FC0,ff,DN,IDLE,CUT; The SHOW PRINTER/IDSTRING command in this example displays the ID string for the printer LPA0. 3.$ SHOW PRINT LPA0/IDSTRING Printer LRA0:, device type LP11, is online, record-oriented device, carriage control. Error count 0 Operations completed 0 Owner process "" Owner UIC [SYSTEM] Owner process ID 00000000 Dev Prot S:RWPL,O:RWPL,G,W Reference count 0 Default buffer size 132 Page width 132 Page Length 66 No Carriage_return Formfeed Uppercase No Passall No Wrap No Printall No Fallback No Tab Truncate No Sixels No Bitmapped No Polled Unidirectional %SYSTEM-F-DEVOFFLINE, device is not in configuration or not available If the device has been disconnected and marked offline, the SHOW PRINTER/IDSTRING command displays this information. If the attempt to read the ID string should fail (for an unknown reason other than device disconnection), the reference to the ID string appears as: %SHOW-W-NOIDSTRING, ID String could not be retrieved 4.$ SHOW PRINT LPA0/SERIALNUM Printer LPA0:, device type PC printer, is online, record-oriented device, carriage control. Error count 0 Operations completed 0 Owner process "" Owner UIC [SYSTEM] Owner process ID 00000000 Dev Prot S:RWPL,O:RWPL,G,W Reference count 0 Default buffer size 132 Page width 132 Page Length 66 No Carriage_return Formfeed Uppercase No Passall No Wrap No Printall No Fallback No Tab Truncate No Sixels No Bitmapped Polled Unidirectional Serial Number: MX88P2V0VWGO The SHOW PRINTER/SERIALNUM command in this example displays the serial number for the printer LPA0. If the device has been disconnected and marked offline, the SHOW PRINTER/SERIALNUM command replaces the reference to the serial number with the following message: %SYSTEM-F-DEVOFFLINE, device is not in configuration or not available If the ID string is not supported by the USB printer in question, the reference to the ID string will appear as: %SHOW-W-NOSERIALNUM, Serial number could not be retrieved 2 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. You must use the /IDENTIFICATION qualifier to look at processes outside of your group. Format SHOW PROCESS [[node-name::]process-name] 3 Parameters node-name:: The name of the node on which the specified process is running. You must specify a node name on the same OpenVMS Cluster on which the current process is running. 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 name must be in the same group as the current process. You must use the /IDENTIFICATION qualifier to look at processes outside of your group. 3 Qualifiers /ACCOUNTING Shows the resources used by the process. /ALL Displays the basic subset of information as well as information about: Accounting Dynamic memory use Privileges Quotas Shelving Subprocesses /CONTINUOUS Displays continuously updated information about the local process in an OpenVMS environment. You cannot use the /CONTINUOUS qualifier to display information about a process on another node in a cluster environment. While the continuous display is running, you can press the T key to display information for threads that make up the process. If there are multiple threads, pressing the T key repeatedly cycles through all the threads. 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. /DUMP Displays the image dump setting which is set or cleared by the SET PROCESS/DUMP command. /EXACT Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a search string that must match the search string exactly and must be enclosed with quotation marks (" "). If you specify the /EXACT qualifier without the /SEARCH qualifier, exact search mode is enabled when you set the search string with the Find (E1) key. /HIGHLIGHT /HIGHLIGHT[=keyword] Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the type of highlighting you want when a search string is found. When a string is found, the entire line is highlighted. You can use the following keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD is the default highlighting. /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. /INTERVAL /INTERVAL=n Use with the /CONTINUOUS qualifier to update the information at the specified number of seconds. /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. The asterisk (*) and the percent sign (%) 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. /PAGE /PAGE[=keyword] /NOPAGE (default) Controls the display of process information on the screen. You can use the following keywords with the /PAGE qualifier: CLEAR_SCREEN Clears the screen before each page is displayed. SCROLL Displays information one line at a time. SAVE[=n] Enables screen navigation of information, where n is the number of pages to store. The /PAGE=SAVE qualifier allows you to navigate through screens of information. The /PAGE=SAVE qualifier stores up to 5 screens of up to 255 columns of information. When you use the /PAGE=SAVE qualifier, you can use the following keys to navigate through the information: Key Sequence Description Up arrow key, Ctrl/B Scroll up one line. Down arrow key Scroll down one line. Left arrow key Scroll left one column. Right arrow key Scroll right one column. Find (E1) Specify a string to find when the information is displayed. Insert Here (E2) Scroll right one half screen. Remove (E3) Scroll left one half screen. Select (E4) Toggle 80/132 column mode. Prev Screen (E5) Get the previous page of information. Next Screen (E6), Get the next page of information. Return, Enter, Space F10, Ctrl/Z Exit. (Some utilities define these differently.) Help (F15) Display utility help text. Do (F16) Toggle the display to oldest/newest page. Ctrl/W Refresh the display. The /PAGE qualifier is not compatible with the /OUTPUT qualifier. /PRIVILEGES Displays current privileges and rights for the process. To display only privileges, also specify the /NORIGHTS qualifier. Use the SET PROCESS/PRIVILEGES command to enable process privileges on a system. Use the SHOW PROCESS/PRIVILEGES command to determine what authorized privileges are enabled on an OpenVMS system: ACNT ALLSPOOL ALTPRI AUDIT BUGCHK BYPASS CMEXEC CMKRNL DETACH DIAGNOSE DOWNGRADE EXQUOTA GROUP GRPNAM GRPPRV IMPORT LOG_IO MOUNT NETMBX OPER PFNMAP PHY_IO PRMCEB PRMGBL PRMMBX PSWAPM READALL SECURITY SETPRV SHARE SHMEM SYSGBL SYSLCK SYSNAM SYSPRV TMPMBX UPGRADE VOLPRO WORLD /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. /RAD Displays home resource affinity domain (RAD). Note that OpenVMS application support for resource affinity domains (RADs) is supported only on AlphaServer GS160 systems. /RIGHTS /RIGHTS (default) /NORIGHTS Displays the current rights for the specified process. Use the /NORIGHTS qualifier with the /PRIVILEGES qualifier to suppress the rights display. /SEARCH /SEARCH="string" Use with the /PAGE=SAVE qualifier to specify a string that you want to find in the information being displayed. Quotation marks are required for the /SEARCH qualifier, if you include spaces in the text string. You can also dynamically change the search string by pressing the Find key (E1) while the information is being displayed. Quotation marks are not required for a dynamic search. /SHELVING Displays whether the process automatically unshelves files. /SUBPROCESSES Displays the current subprocesses in hierarchical order. /WRAP /WRAP /NOWRAP (default) Use with the /PAGE=SAVE qualifier to limit the number of columns to the width of the screen and to wrap lines that extend beyond the width of the screen to the next line. The /NOWRAP qualifier extends lines beyond the width of the screen and can be seen when you use the scrolling (left and right) features provided by the /PAGE=SAVE qualifier. 3 Examples 1.$ SHOW PROCESS OCALA::MALIK 14-DEC-2001 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 by the user MALIK. The system displays the subset of information for the owned process on node OCALA. The information includes the following: Date and time the SHOW PROCESS command is entered User name Process identification (PID) number Node name Process name Device name of the current SYS$INPUT device User identification code (UIC) Base execution priority Default device (only for processes on the same node) Default directory (only for current processes) Devices allocated to the process and volumes mounted, if any 2.$ SHOW PROCESS/ACCOUNTING 14-DEC-2001 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. The values under Peak working set size and Peak virtual size are rendered in 512-byte pages on VAX and in pagelets on Alpha. 3.$ SHOW PROCESS/PRIVILEGES 14-DEC-2001 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 14-DEC-2001 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. The value under Paging file quota is rendered in 512-byte pages on VAX and in pagelets on Alpha. 5.$ SHOW PROCESS/SUBPROCESSES 14-DEC-2001 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/CONTINUOUS BOB Process BOB 12:26:53 State CUR Working set 269 Cur/base priority 8/4 Virtual memory 1713 Current PC 7FFEE07E CPU time 00:00:13.82 Current PSL 03C00000 Direct I/O 246 Current user SP 7FF785A4 Buffered I/O 646 PID 226006C0 Page faults 3417 UIC [VMS,BOB] Event flags C8000007 C0000000 SYS$SYSROOT:[SYSEXE]SHOW.EXE In this example, the /CONTINUOUS qualifier causes the display of information about process BOB to be updated continuously. Note that the Virtual memory heading appears on VAX and the Virtual pages heading appears on Alpha; both indicate the virtual memory used as a number of CPU-specific pages. The value displayed for Working set is also a number of CPU- specific pages. 7.$ SHOW PROCESS/MEMORY 14-DEC-2001 14:59:04.48 User: MALIK Process ID: 28200364 Node: OCALA Process Name: "MALIK" Process Dynamic Memory Area Current Size (bytes) 25600 Current Total Size (pages) 50 Free Space (bytes) 22698 Space in Use (bytes) 2902 Size of Largest Block 22496 Size of Smallest Block 15 Number of Free Blocks 7 Free Blocks LEQU 32 Bytes 3 The SHOW PROCESS command in this example displays the use of dynamic memory areas for the current process, MALIK. These areas are described as follows: Current size Displays the current size in bytes and pages on VAX (512-byte pagelets on Alpha) of each dynamic memory area. Free space Displays the amount of free space in each dynamic memory area. Space in use Displays the amount of space currently allocated from each area. Largest block Displays the size of the largest contiguous area in each pool area. Smallest block Displays the size of the smallest free block in each pool area. Free blocks Displays the total number of free blocks in each pool area. The size of this number is a measure of pool fragmentation. Blocks LEQU 32 Displays the number of free blocks that are (VAX) Blocks LEQU 32 bytes or shorter on VAX or 64 bytes or 64 (Alpha) shorter on Alpha. This number is another measure of pool fragmentation, because while allocation of these small blocks is unlikely, they contribute to the allocation time whenever an allocation request is made. 8.$ SHOW PROCESS OCALA::MALIK 14-DEC-2001 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. 9.$ SHOW PROCESS/SHELVING LYONS 15-JUNE-2001 10:07:25.11 User: LYONS Process ID: 20206A50 Node: BANANA Process name: "LYONS" Auto-unshelve: on The SHOW PROCESS command in this example shows that the LYONS process automatically unshelves files. 10$ SHOW PROCESS/DUMP RALSTON 31-DEC-2001 10:38:32.48 User: RALSTON Process ID: 20C0011B Node: AAAAAA Process name: "_RTA1:" Image Dump: on The SHOW PROCESS command in this example shows that the image dump capability for the RALSTON process is enabled. This causes the contents of the address space to be written to the file named SYS$LOGIN:(image-name).DMP (where the image name is the same as the file name) when an image terminates due to an unhandled error. See the SET PROCESS/DUMP command for additional information. 2 PROTECTION Displays the current default process protection to be applied to all new files created during the terminal session or batch job. Format SHOW PROTECTION 3 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. 2 QUEUE Displays information about queues and the jobs that are currently in queues. Requires read (R) access to the job. o Displays characteristic names and numbers that are available on queues (see /CHARACTERISTICS). o Displays form names and numbers that are available on queues (see /FORM). o Provides information about the queue manager(s) on the system or OpenVMS Cluster (see /MANAGERS). Format SHOW QUEUE [queue-name] 3 Parameter queue-name Specifies the name of the queue for which you want information displayed. The asterisk (*) and the percent sign (%) wildcard characters are allowed. The default value for the queue-name parameter is the asterisk (*) wildcard character. If no queue name is specified, information on all queues is displayed. 3 Qualifiers /ALL_JOBS Displays all the jobs in the specified queues. You must have read (R) access to the job to show information about any jobs. /BATCH Displays only batch queues and jobs in those queues. /BRIEF /BRIEF (default) Displays a one-line description of each queue and 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 the 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: ABORTING STALLED EXECUTING STARTING PRINTING SUSPENDED PROCESSING ABORTING means that the job is halting prior to normal completion and will not continue processing. A SUSPENDED state means that the job stopped during processing, but should continue when the cause of the 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. 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. 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. TIMED_ Requests the display of jobs on hold until a RELEASE specified time. Timed release status indicates that the job is being held in the queue for execution at a specified 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. /EXACT Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a search string that must match the search string exactly and must be enclosed with quotation marks (" "). If you specify the /EXACT qualifier without the /SEARCH qualifier, exact search mode is enabled when you set the search string with the Find (E1) key. /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, 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. /HIGHLIGHT /HIGHLIGHT[=keyword] Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the type of highlighting you want when a search string is found. When a string is found, the entire line is highlighted. You can use the following keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD is the default highlighting. /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. The asterisk (*) and the percent sign (%) 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. /PAGE /PAGE[=keyword] /NOPAGE (default) Controls the display of information on the screen. You can use the following keywords with the /PAGE qualifier: CLEAR_SCREEN Clears the screen before each page is displayed. SCROLL Displays information one line at a time. SAVE[=n] Enables screen navigation of information, where n is the number of pages to store. The /PAGE=SAVE qualifier allows you to navigate through screens of information. The /PAGE=SAVE qualifier stores up to 5 screens of up to 255 columns of information. When you use the /PAGE=SAVE qualifier, you can use the following keys to navigate through the information: Key Sequence Description Up arrow key, Ctrl/B Scroll up one line. Down arrow key Scroll down one line. Left arrow key Scroll left one column. Right arrow key Scroll right one column. Find (E1) Specify a string to find when the information is displayed. Insert Here (E2) Scroll right one half screen. Remove (E3) Scroll left one half screen. Select (E4) Toggle 80/132 column mode. Prev Screen (E5) Get the previous page of information. Next Screen (E6), Get the next page of information. Return, Enter, Space F10, Ctrl/Z Exit. (Some utilities define these differently.) Help (F15) Display utility help text. Do (F16) Toggle the display to oldest/newest page. Ctrl/W Refresh the display. The /PAGE qualifier is not compatible with the /OUTPUT qualifier. /SEARCH /SEARCH="string" Use with the /PAGE=SAVE qualifier to specify a string that you want to find in the information being displayed. Quotation marks are required for the /SEARCH qualifier, if you include spaces in the text string. You can also dynamically change the search string by pressing the Find key (E1) while the information is being displayed. Quotation marks are not required for a dynamic search. /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. /WRAP /WRAP /NOWRAP (default) Use with the /PAGE=SAVE qualifier to limit the number of columns to the width of the screen and to wrap lines that extend beyond the width of the screen to the next line. The /NOWRAP qualifier extends lines beyond the width of the screen and can be seen when you use the scrolling (left and right) features provided by the /PAGE=SAVE qualifier. 3 Examples 1.$ SHOW QUEUE/ALL/BY_JOB_STATUS=pending Printer queue KLEE$LCA0, stopped, mounted form DEFAULT /BASE_PRIORITY=4 /DEFAULT=(FEED,FORM=ELITE (stock=DEFAULT)) /OWNER=[SYSTEM] /PROTECTION=(S:M,O:D,G:R,W:S) Entry Jobname Username Blocks Status ----- ------- -------- ------ ------ 2045 APPLICA MARTIN 102 Pending Batch queue SYS_TEX, available, on NODE22:: /BASE_PRIORITY=3 /JOB_LIMIT=25 /OWNER=[SYSTEM] /PROTECTION=(S:M,O:D,G:R,W:S) Entry Jobname Username Status ----- ------- -------- ------ 1388 CHAPTER1.JOB MARTIN Pending Generic batch queue CLUSTER_BATCH /GENERIC=(HMSCMS_BATCH,NODE22_BATCH) /OWNER=[SYSTEM] /PROTECTION=(S:M,O:D,G:R,W:S) Entry Jobname Username Status ----- ------- -------- ------ 936 no privilege Pending . . . The SHOW QUEUE command in this example displays only the queues in which jobs are currently pending. The /ALL qualifier requests the display of all pending jobs. Notice that you cannot see job information for entry 936. You must have GROUP privilege to show all jobs in your group or OPER privilege to show all jobs in all groups. 2.$ 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:M,O:D,G:R,W:S) 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 DUDSON 140 Pending (queue stopped) Submitted 21-DEC-2001 16:14 /FORM=ELITE (stock=DEFAULT) /PRIORITY=200 File: _$5$DUA1:[DUDSON]SET.CLD;5 606 CLOSE DUDSON 140 Pending (queue stopped) Submitted 21-DEC-2001 16:16 /FORM=DEFAULT /PRIORITY=200 File: _$5$DUA1:[DUDSON]CLOSE.TXT;2 Printer queue ARMADA$PRINTER_1, idle, on ARMADA::TTA3, mounted form DEFAULT /BASE_PRIORITY=4 /DEFAULT=(FEED,FORM=DEFAULT) /LIBRARY=SMU$DEVCTL Lowercase /OWNER=[SYSTEM] /PROCESSOR=CPS$SMB /PROTECTION=(S:M,O:D,G:R,W:S) /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. 3.$ SHOW QUEUE/SUMMARY Batch queue HMSCMS_BATCH, available, on HMSCMS:: Job summary: 1 executing, 5 holding Server queue NM$QUE01, available, on NODE22::, mounted form DEFAULT Job summary: 2 executing Generic server queue NM$QUEUE Job summary: 1 timed release Batch queue PIZZA_BATCH, idle, on PIZZA:: Job summary: queue is empty Batch queue NODE22_BATCH, available, on NODE22:: Job summary: 1 executing, 1 timed release Printer queue ARMADA$PRINT, stopped, on ARMADA::LPA0, mounted form DEFAULT Job summary: 8 pending (565 blocks) Terminal queue ALLBQ, stopped, on KATYA::TTA2, mounted form DEFAULT Job summary: 2 pending (445 blocks) . . . The SHOW QUEUE command in this example lists all queues and displays the total number of jobs on the queues. 4.$ SHOW QUEUE DOC$LN03 Server queue DOC$LN03, stopped, on NEWTON::, mounted form DEFAULT Entry Jobname Username Blocks Status ----- ------- -------- ------ ------ 436 DOCPLAN HERSHEY 8 Retained until 11-JAN-2001 16:56 %JBC-F-JOBABORT, job aborted during execution Completed 11-JAN-2001 15:56 on queue DOC$LN03 This SHOW QUEUE display includes the date and time at which a retained job completed and the queue on which it executed. You can specify the /RETAIN qualifier with the PRINT, SUBMIT, or SET ENTRY command to specify the circumstances under which you want your job to be retained in a queue. In this example, the user set job retention to be one hour after job completion. Depending on the queue's job retention policy, the job might be deleted from the queue at 16:56. (See the PRINT, SUBMIT, or SET ENTRY command descriptions for more information on the /RETAIN qualifier.) 3 /CHARACTERISTICS 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/CHARACTERISTICS [characteristic-name] 4 Parameter characteristic-name Specifies the name of a characteristic. The asterisk (*) and the percent sign (%) wildcard characters 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. 4 Qualifier /OUTPUT /OUTPUT[=filespec] /NOOUTPUT Controls where the output of the command is sent. By default the output of the SHOW QUEUE/CHARACTERISTICS 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. 4 Examples 1.$ SHOW QUEUE/CHARACTERISTICS Characteristic name Number ------------------- ------ BLUEINK 6 BROWNINK 25 COLOR_CHART 1 REDINK 0 TEXMAC_JOB 2 The SHOW QUEUE/CHARACTERISTICS command in this example displays all the characteristics that have been defined for this system. 2.$ SHOW QUEUE/CHARACTERISTICS *INK Characteristic name Number ------------------- ------ BLUEINK 6 BROWNINK 25 REDINK 0 The SHOW QUEUE/CHARACTERISTICS command in this example displays the name and number of all characteristics that end with INK. 3 /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] 4 Parameter form-name Specifies the name of the form. The asterisk (*) and the percent sign (%) wildcard characters 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. 4 Qualifiers /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 the asterisk (*) and the percent sign (%) 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. 4 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. 3 /MANAGERS Provides information about the queue manager(s) on the system or OpenVMS Cluster. Format SHOW QUEUE/MANAGERS [queue-manager-name] 4 Parameter queue-manager-name Specifies the name of the queue manager for which you want information displayed. The asterisk (*) and the percent sign (%) wildcard characters are allowed. The default value for the queue- manager-name parameter is the asterisk (*) wildcard character. If no queue manager name is specified, information on all queue managers is displayed. 4 Qualifiers /BRIEF Displays a one-line description of queue manager(s) on the system or cluster. The information displayed includes the name and status of the queue manager and the node on which its process is running. The /BRIEF qualifier is present by default. /FULL Displays complete information about queue manager(s) on the system or cluster. The /FULL qualifier overrides the /BRIEF qualifier. 4 Examples 1.$ SHOW QUEUE/MANAGERS/FULL Master file: SYS$COMMON:[SYSEXE]QMAN$MASTER.DAT; Queue manager BATCHQ_MANAGER, running, on BBBBBB:: /ON=(BBBBBB, AAAAAA, CCCCCC, EEEEEE, *) Database location: DISK1:[QUEUES] Queue manager PRINTQ_MANAGER, starting, on AAAAAA:: /ON=(AAAAAA, BBBBBB, CCCCCC, EEEEEE, *) Database location: DISK2:[QUEUES] Queue manager SYS$QUEUE_MANAGER, running, on FFFFFF:: /ON=(FFFFFF, EEEEEE, CCCCCC, BBBBBB, AAAAAA, *) Database location: DISK1:[QUEUES] Queue manager TRANSFER_MANAGER, stopped /ON=(AAAAAA, BBBBBB, EEEEEE) Database location: DISK1:[TRANSFER] The SHOW QUEUE/MANAGERS/FULL command displays complete information about a queue manager on a system or cluster. 2.$ SHOW QUEUE/MANAGERS Queue manager BATCHQ_MANAGER, running, on BBBBBB:: Queue manager PRINTQ_MANAGER, starting, on AAAAAA:: Queue manager SYS$QUEUE_MANAGER, running, on FFFFFF:: Queue manager TRANSFER_MANAGER, stopped The SHOW QUEUE/MANAGERS command in this example shows information about the queue manager in brief format. The /BRIEF qualifier is the default and does not need to be specified. 3.$ SHOW QUEUE/MANAGERS/FULL SYS$QUEUE_MANAGER Master file: SYS$COMMON:[SYSEXE]QMAN$MASTER.DAT; Queue manager SYS$QUEUE_MANAGER, running, on FFFFFF:: /ON=(FFFFFF, EEEEEE, CCCCCC, BBBBBB, AAAAAA, *) Database location: DISK1:[QUEUES] The command, SHOW QUEUE/MANAGERS/FULL SYS$QUEUE_MANAGER, in this example shows a request for a specific queue manager by name. 2 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 3 Qualifiers /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 or identifier Specifies which user's quotas are to be displayed. By default, the current user's quotas are displayed. 3 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. 2 RMS_DEFAULT Displays the current default values for the multiblock count, the multibuffer count, the network transfer size, the prolog level, the extend quantity, and the query lock option. Format SHOW RMS_DEFAULT 3 Qualifier /OUTPUT /OUTPUT[=filespec] /NOOUTPUT Specifies the file to which the display is written (default is SYS$OUTPUT). The asterisk (*) and the percent sign (%) 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. 3 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 VCC_DFW QUERY_LOCK Process 0 0 0 System System 0 0 0 Enabled CONTENTION_POLICY Process System System Never 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. Note that the placeholder, VCC_DFW, is currently reserved to Compaq. 2 SECURITY Displays the name, class, and profile of a protected object. Format SHOW SECURITY object-name 3 Parameter object-name Specifies the name of an object whose security profile is to be displayed. If the object class is SECURITY_CLASS, you can specify an asterisk (*) as object-name to see a display of all security class objects. An object name of the FILE class (explicitly or implicitly specified) can include the asterisk (*) and the percent sign (%) wildcard characters; however, wildcard characters are not allowed in any class other than FILE or SECURITY_CLASS. 3 Qualifiers /BACKUP Modifies the time value specified with the /BEFORE or the /SINCE qualifier. The /BACKUP qualifier selects files according to the dates of their most recent backups (rather than by the creation, expiration, or modification date). By default, SHOW SECURITY selects files according to their creation date. /BEFORE /BEFORE[=time] Selects only those files dated prior to the specified time. You can specify time as absolute time, as a combination of absolute and delta times, or as one of the following keywords: BOOT, LOGIN, TODAY (default), TOMORROW, or YESTERDAY. Specify the /CREATED or the /MODIFIED qualifier to indicate the time attribute to be used as the basis for selection. The /CREATED qualifier is the default. For complete information on specifying time values, refer to the OpenVMS User's Manual or the online help topic DCL_Tips (subtopic Date_Time). /BY_OWNER /BY_OWNER[=uic] Selects files whose owner's UIC matches the UIC specified with uic. The default UIC is that of the current process. Specify the UIC by using the standard format described in the OpenVMS Guide to System Security. /CLASS /CLASS=class Specifies the class of the object whose profile is to be displayed. By default, the command assumes the object class is FILE. Object class keywords are as follows: CAPABILITY LOGICAL_NAME_TABLE COMMON_EVENT_CLUSTER QUEUE DEVICE RESOURCE_DOMAIN FILE SECURITY_CLASS GROUP_GLOBAL_SECTION SYSTEM_GLOBAL_SECTION ICC_ASSOCIATION VOLUME /CREATED Modifies the time value specified with the /BEFORE or the /SINCE qualifier. The /CREATED qualifier selects files according to the date they were created (rather than by the backup, expiration, or modification date). By default, SHOW SECURITY selects files according to their creation date. /EXCLUDE /EXCLUDE=(filespec[,...]) Excludes the specified files from the SHOW SECURITY operation. You can include a directory, but not a device, in the file specification. You cannot use relative version numbers to exclude a specific version. /EXPIRED Modifies the time specified with the /BEFORE or the /SINCE qualifier. The /EXPIRED qualifier selects files according to their expiration dates rather than by the backup, creation, or modification date. (The expiration date is set with the SET FILE/EXPIRATION_DATE command.) By default, files are selected according to their creation date. /MODIFIED Modifies the time value specified with the /BEFORE or the /SINCE qualifier. The /MODIFIED qualifier selects files according to the dates on which they were last modified, rather than by the backup, creation, or expiration date. By default, files are selected according to their creation date. /SINCE /SINCE[=time] Selects only those files dated on or after the specified time. You can specify time as absolute time, as a combination of absolute and delta times, or as one of the following keywords: BOOT, LOGIN, TODAY (default), TOMORROW, or YESTERDAY. Specify the /CREATED or the /MODIFIED qualifier to indicate the time attribute to be used as the basis for selection. The /CREATED qualifier is the default. For complete information on specifying time values, see the OpenVMS User's Manual or the online help topic DCL_Tips (subtopic Date_Time). 3 Examples 1.$ SHOW SECURITY LNM$SYSTEM_TABLE /CLASS=LOGICAL_NAME_TABLE LNM$SYSTEM_TABLE object of class LOGICAL_NAME_TABLE Owner: [SYSTEM] Protection: (System: RWC, Owner: RWC, Group: R, World: R) Access Control List: (IDENTIFIER=[USER,SVENSEN],ACCESS=CONTROL) This example shows a typical request to display the security elements of an object. The logical name table LNM$SYSTEM_TABLE is displayed with the settings of the security elements owner, protection, and ACL. 2.$ SHOW SECURITY/CLASS=DEVICE $99$DUA22 _$99$DUA22: object of class DEVICE Owner: [SALES,TSUTTER] Protection: (System: RWPL, Owner: RWPL, Group: R, World) Access Control List: RES17SEP object of class VOLUME Owner: [FEAST,FY93] Protection: (System: RWCD, Owner: RWCD, Group: RWCD, World: RWCD) Access Control List: $ SHOW DEVICE $99$DUA22 Device Device Error Volume Free Trans Mnt Name Status Count Label Blocks Count Cnt $99$DUA22: (KUDOS) Mounted 0 RES17SEP 649904 1 2 This example shows a request for the security profile of a disk device. The resulting display provides both the profiles of the disk $99$DUA22 and the volume RES17SEP that is mounted on it. The subsequent SHOW DEVICE command confirms that the volume is mounted on the device $99$DUA22. 3.$ SHOW SECURITY LOGICAL_NAME_TABLE /CLASS=SECURITY_CLASS LOGICAL_NAME_TABLE object of class SECURITY_CLASS Owner: [SYSTEM] Protection: (System: RWCD, Owner: RWCD, Group: R, World: R) Access Control List: Template: GROUP Owner: [SYSTEM] Protection: (System: RWCD, Owner: R, Group: R, World: R) Access Control List: Template: JOB Owner: [SYSTEM] Protection: (System: RWCD, Owner: RWCD, Group, World) Access Control List: Template: DEFAULT Owner: [SYSTEM] Protection: (System: RW, Owner: RW, Group: R, World: R) Access Control List: This example shows the output for the special case of a security class object. The security class object LOGICAL_NAME_ TABLE is displayed with the security profile. In addition, three templates are displayed. 4.$ SHOW SECURITY * /CLASS=SECURITY_CLASS SECURITY_CLASS object of class SECURITY_CLASS Owner: [SYSTEM] Protection: (System: RWCD, Owner: RWCD, Group: R, World: R) Access Control List: LOGICAL_NAME_TABLE object of class SECURITY_CLASS Owner: [SYSTEM] Protection: (System: RWCD, Owner: RWCD, Group: R, World: R) Access Control List: . . . This example shows the output for the special case of showing all the security classes currently registered. The asterisk (*) wildcard character is used; any other form of wildcard characters is not accepted. Security profiles are shown for each security class. Note that template information is not shown. 2 SERVER Displays information about the Registry servers. Requires the SYSPRV privilege. Format SHOW SERVER server-name 3 Parameter server-name Valid value is: REGISTRY_SERVER. 3 Qualifiers /CLUSTER Displays information about each registry server in the cluster. Cannot be used with the /MASTER or /NODE qualifiers. /MASTER Displays information from the registry master server only. Requires the SYSLCK privilege. Cannot be used with the /CLUSTER or /NODE qualifiers. /NODE /NODE=(node-name[,...]) Displays information on the registry servers on the specified nodes in the order they are entered. The node names must be within the current cluster. Cannot be used with the /CLUSTER or /MASTER qualifiers. /OUTPUT /OUTPUT=filespec Sends the output information to a specified file. 3 Examples 1.$ SHOW SERVER REGISTRY_SERVER This command displays information about the node you are on: Registry Information on node OPNEAR 29-AUG-2001 16:37:26.52 Uptime 20 04:10:55 2.$ SHOW SERVER REGISTRY_SERVER/MASTER This command displays information about the registry master server: Registry Master Server is running on OPNEAR, Pid: 20A0021A 2 STATUS Displays the current status of your process. Format SHOW STATUS 3 Example $ SHOW STATUS Status on 14-DEC-2001 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. 2 SYMBOL Displays the value of the specified symbol. Format SHOW SYMBOL [symbol-name] 3 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. The asterisk (*) and the percent sign (%) wildcard characters are allowed in the symbol-name parameter. 3 Qualifiers /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. 3 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, $SEVERITY, and $STATUS, 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. 2 SYSTEM Displays status information about current processes. Format SHOW SYSTEM 3 Qualifiers /BATCH /BATCH (default) /NOBATCH Displays all batch jobs for the local system. When used with the /CLUSTER qualifier, the /BATCH qualifier displays all batch jobs in the OpenVMS Cluster environment. When you use the /NOBATCH qualifier, all batch jobs are excluded from the display. /CLUSTER Displays the specified processes on all nodes in an OpenVMS Cluster. /EXACT Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a search string that must match the search string exactly and must be enclosed with quotation marks (" "). If you specify the /EXACT qualifier without the /SEARCH qualifier, exact search mode is enabled when you set the search string with the Find (E1) key. /FULL Displays the user identification code (UIC), the processor type, and the process size, in addition to the default information. The UIC is displayed below the process name. /HEADING /HEADING /NOHEADING Displays a heading line above the system output. When you use the /NOHEADING qualifier, the heading line is excluded from the display. /HIGHLIGHT /HIGHLIGHT[=keyword] Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the type of highlighting you want when a search string is found. When a string is found, the entire line is highlighted. You can use the following keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD is the default highlighting. /IDENT /IDENT=pid Displays all processes on the system that have the specified process identification (PID) code number. /INTERACTIVE /INTERACTIVE /NOINTERACTIVE Displays all interactive processes on the system. When you use the /NOINTERACTIVE qualifier, all interactive processes are excluded from the display. /MULTITHREAD Displays all multithreaded processes for the local system. When used with the /FULL qualifier, the /MULTITHREAD qualifier displays information about each kernel thread in a multithreaded process. For more information on kernel threads, refer to the OpenVMS Programming Concepts Manual. /NETWORK /NETWORK /NONETWORK Displays all network processes on the system. When you use the /NONETWORK qualifier, all network processes are excluded from the display. /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 an OpenVMS Cluster 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 the asterisk (*) and the percent sign (%) 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. /OWNER_UIC /OWNER_UIC=uic Displays all processes on the system that have the specified user identification code (UIC) number. /PAGE /PAGE[=keyword] /NOPAGE (default) Controls the display of system information on the screen. You can use the following keywords with the /PAGE qualifier: CLEAR_SCREEN Clears the screen before each page is displayed. SCROLL Displays information one line at a time. SAVE[=n] Enables screen navigation of information, where n is the number of pages to store. The /PAGE=SAVE qualifier allows you to navigate through screens of information. The /PAGE=SAVE qualifier stores up to 5 screens of up to 255 columns of information. When you use the /PAGE=SAVE qualifier, you can use the following keys to navigate through the information: Key Sequence Description Up arrow key, Ctrl/B Scroll up one line. Down arrow key Scroll down one line. Left arrow key Scroll left one column. Right arrow key Scroll right one column. Find (E1) Specify a string to find when the information is displayed. Insert Here (E2) Scroll right one half screen. Remove (E3) Scroll left one half screen. Select (E4) Toggle 80/132 column mode. Prev Screen (E5) Get the previous page of information. Next Screen (E6), Get the next page of information. Return, Enter, Space F10, Ctrl/Z Exit. (Some utilities define these differently.) Help (F15) Display utility help text. Do (F16) Toggle the display to oldest/newest page. Ctrl/W Refresh the display. The /PAGE qualifier is not compatible with the /OUTPUT qualifier. /PROCESS /PROCESS[=name] (default) /NOPROCESS Displays all specified processes on the system. If you do not specify a process name with the /PROCESS qualifier, all processes are displayed. When you use the /NOPROCESS qualifier with the /CLUSTER qualifier, only the node or nodes available on the cluster are displayed with their respective uptimes and operating system version. You can include the asterisk (*) and the percent sign (%) wildcard characters in the process name. /SCHEDULING_CLASS /SCHEDULING_CLASS[=class_name] /NOSCHEDULING_CLASS Displays processes that belong to a specific scheduling class (class_name). If the class name is not specified, all class scheduled processes are displayed along with the name of their scheduling class. /SEARCH /SEARCH="string" Use with the /PAGE=SAVE qualifier to specify a string that you want to find in the information being displayed. Quotation marks are required for the /SEARCH qualifier, if you include spaces in the text string. You can also dynamically change the search string by pressing the Find key (E1) while the information is being displayed. Quotation marks are not required for a dynamic search. /STATE /STATE=process-state Displays all processes with the specified process state. You can include the asterisk (*) and the percent sign (%) wildcard characters in the process-state name. The following process states are available: CEF COLPG COM COMO CUR FPG HIB HIBO LEF LEFO MUTEX PFW PSXFR RWAST RWBRK RWCAP RWCLU RWCSV RWIMG RWLCK RWMBX RWMPB RWMPE RWNPG RWPAG RWPFF RWQUO RWSCS RWSWP SUSP SUSPO /SUBPROCESS /SUBPROCESS /NOSUBPROCESS Displays all subprocesses on the system. When you use the /NOSUBPROCESS qualifier, all subprocesses are excluded from the output. /WRAP /WRAP /NOWRAP (default) Use with the /PAGE=SAVE qualifier to limit the number of columns to the width of the screen and to wrap lines that extend beyond the width of the screen to the next line. The /NOWRAP qualifier extends lines beyond the width of the screen and can be seen when you use the scrolling (left and right) features provided by the /PAGE=SAVE qualifier. 3 Examples 1.$ SHOW SYSTEM OpenVMS 7.3 on node KRYPTN 14-DEC-2001 17:45:47:78 Uptime 2 21:53:59 Pid Process Name State Pri I/O CPU Page flts Pages 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 KING CUR 6 4 14045 0 00:02:03.24 20032 397 274016D5 DAVIS LEF 6 427 0 00:00:09.28 5275 1384 27401ED6 deGroot 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 DOERING LEF 4 2132 0 00:00:23.85 5318 452 274022EB KERR CUR 6 4 492 0 00:00:12.15 5181 459 274018EF DUFRESNE 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 EAGAN HIB 5 25104 0 00:06:07.76 37407 1923 274020F5 TAN LEF 7 14726 0 00:02:10.74 34262 1669 27400CF6 KELLEY 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 Pages-The number of CPU-specific pages 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 OpenVMS V7.3 on node ALPES 14-DEC-2001 09:09:58.61 Uptime 2 2:27:11 Pid Process Name State Pri I/O CPU Page flts Pages 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 was issued from an Alpha system and shows all processes on all nodes of the cluster. 3.$ SHOW SYSTEM /NODE=EON OpenVMS V7.3 on node EON 14-DEC-2001 09:19:15.33 Uptime 2 02:29:07 Pid Process Name State Pri I/O CPU Page flts Pages 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 was issued from a VAX system and shows all processes on the node EON. 4.$ SHOW SYSTEM/NOPROCESS/CLUSTER/FULL OpenVMS V7.3 on node AAAAAA 12-MAY-2001 10:29 AM Uptime 3 16:37:39 AlphaServer 8400 5/440 OpenVMS V7.2 on node BBBBBB 12-MAY-2001 10:29 AM Uptime 3 12:42:56 VAX 6000-540 OpenVMS V7.2 on node CCCCCC 12-MAY-2001 10:29 AM Uptime 3 16:26:52 VAX 7000-760 OpenVMS V7.1 on node DDDDDD 12-MAY-2001 10:29 AM Uptime 3 16:41:35 DEC 4000 Model 610 OpenVMS V7.2 on node EEEEEE 12-MAY-2001 10:29 AM Uptime 3 16:26:10 VAXstation 3100/GPX This example displays only the nodes available on the cluster with their respective uptimes and operating system versions because the /NOPROCESS qualifier suppresses the display of processes. The /FULL qualifier also displays the type of hardware on which the system is running. 5.$ SHOW SYSTEM/PROCESS=S* OpenVMS V7.3 on node AAAAAA 12-MAY-2001 10:30 AM Uptime 3 12:43:55 Pid Process Name State Pri I/O CPU Page flts Pages 20C00101 SWAPPER HIB 16 0 0 00:00:00.05 0 0 20C0010E SHADOW_SERVER HIB 6 7 0 00:00:00.03 32 4 20C0010F SECURITY_SERVER HIB 10 35 0 00:00:02.16 292 323 20C00110 SMISERVER HIB 9 67 0 00:00:00.20 152 131 20C0011A STEFANELLI CUR 0 4 63 0 00:00:00.29 538 55 This example displays only the processes on the system that begin with the letter S. 6.$ SHOW SYSTEM/NOHEADING/OUTPUT=SYSPROC.DAT 20C00101 SWAPPER HIB 16 0 0 00:00:00.05 0 0 20C00105 CONFIGURE HIB 10 24 0 00:02:00.86 41 21 20C00107 IPCACP HIB 10 9 0 00:00:00.04 33 43 20C00108 ERRFMT HIB 7 3583 0 00:00:04.31 50 61 20C00109 CACHE_SERVER HIB 16 3 0 00:00:00.02 27 35 20C0010A CLUSTER_SERVER HIB 10 11 0 00:00:00.10 59 75 This example places the display of system processes into the SYSPROC.DAT file without the heading information using the /OUTPUT qualifier. In this way, you can create a data file for processing because the heading is suppressed using the /NOHEADING qualifier. 7.$ SHOW SYSTEM/IDENT=20C0010D/FULL OpenVMS V7.3 on node AAAAAA 12-MAY-2001 10:35 AM Uptime 3 12:48:19 DEC 4000 Model 610 Pid Process Name State Pri I/O CPU Page flts Pages 20C0010D JOB_CONTROL HIB 10 41 0 00:00:00.25 51 66 [SYSTEM] 528Kb This example displays a system process by PID number. 8.$ SHOW SYSTEM/OWNER=TIMMER OpenVMS V7.3 on node AAAAAA 12-MAY-2001 10:34 AM Uptime 3 12:47:37 Pid Process Name State Pri I/O CPU Page flts Pages 20C00119 DECW$TE_0119 LEF 6 334 0 00:00:01.00 975 657 20C0011A TIMMER LEF 8 63 0 00:00:00.29 538 55 20C0011B _RTA1: CUR 0 4 554 0 00:00:01.72 1771 70 This example displays the system processes belonging to user BESTON. 9.$ SHOW SYSTEM/STATE=L* OpenVMS V7.3 on node AAAAAA 12-MAY-2001 10:36 AM Uptime 3 12:49:46 Pid Process Name State Pri I/O CPU Page flts Pages 20C00119 DECW$TE_0119 LEF 6 334 0 00:00:01.00 975 657 20C0011A STADLER LEF 8 63 0 00:00:00.29 538 55 This example displays the system processes with process states that begin with the letter L. 10$ SHOW SYSTEM/MULTITHREAD OpenVMS V7.3 on node ZIMBER 30-OCT-2001 11:34:11.51 Uptim 8 20:21:31 Pid Process Name State Pri I/O CPU Page flts Pages 0000008C SECURITY_SERVER HIB 11 131 0 00:55:25.25 4370 194 M $ SHOW SYSTEM/MULTITHREAD/FULL OpenVMS V7.3 on node ZIMBER 30-OCT-2001 11:34:13.98 Uptime 8 20:21:34 AlphaStation 400 4/233 Pid Process Name State Pri I/O CPU Page flts Pages 0000008C SECURITY_SERVER HIB 11 131 0 00:55:25.26 4370 194 M 0000010C HIB 11 [SYSTEM] 1552Kb These examples show the results of the /MULTITHREAD qualifier and the combination results of the /MULTITHREAD and /FULL qualifiers. 2 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[:]] 3 Parameter device-name[:] Specifies the name of the terminal for which you want the characteristics displayed. The default is your terminal (SYS$COMMAND). 3 Qualifiers /BRIEF Displays a subset of more commonly used terminal characteristics. /FULL /FULL (default) Displays all terminal characteristics. /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 cannot include the asterisk (*) and the percent sign (%) 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. 3 Examples 1.$ SHOW TERMINAL/BRIEF Terminal: _RTA1: Device_Type: VT300_Series Owner: _RTA1: Username: REHOR Terminal Characteristics: Speed: 9600 Page: 62 Width: 80 No Remote Hostsync TTsync No Modem Broadcast Wrap No Hangup No Disconnect Overstrike editing No Dialup Application keypad Line Editing In this example, the SHOW TERMINAL command displays a subset of the more commonly used terminal characteristics. 2.$ SHOW TERMINAL/FULL 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 (see the next example). 3.$ SHOW TERMINAL/FULL Terminal: _RTA1: Device_Type: VT300_Series Owner: _RTA1: Username: VILLA Remote Port Info: NODE12::VILLA Input: 9600 LFfill: 0 Width: 80 Parity: None Output: 9600 CRfill: 0 Page: 62 Terminal Characteristics: Interactive Echo Type_ahead No Escape Hostsync TTsync Lowercase Tab Wrap Scope No Remote Eightbit Broadcast No Readsync No Form Fulldup No Modem No Local_echo No Autobaud No Hangup No Brdcstmbx No DMA No Altypeahd Set_speed No Commsync Line Editing Overstrike editing No Fallback No Dialup No Secure server No Disconnect No Pasthru No Syspassword SIXEL Graphics No Soft Characters Printer port Application keypad ANSI_CRT Regis No Block_mode Advanced_video Edit_mode DEC_CRT DEC_CRT2 DEC_CRT3 No DEC_CRT4 No DEC_CRT5 Ansi_Color VMS Style Input In this example, the SHOW TERMINAL command displays the full terminal characteristics. 2 TIME Displays the current date and time. Format SHOW [DAY]TIME 3 Example $ SHOW TIME 3-NOV-2001 00:02:00 The SHOW TIME command in this example displays the current date and time. 2 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 3 Parameter logical-name Specifies the logical name whose translation you want to display. 3 Qualifier /TABLE /TABLE=name Searches the specified table. The default value for the name parameter is 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. 3 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 DKA1: $ DEFINE/GROUP DISK DKA2: $ SHOW TRANSLATION DISK DISK = DKA1:(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 $ 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 = "DKA2:" (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. 2 USERS Displays the user name and node name (in an OpenVMS Cluster environment) of interactive, subprocess, and batch users on the system. Format SHOW USERS [username] 3 Parameter username Specifies the user about whom you want information. The asterisk (*) and the percent sign (%) wildcard characters 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 tells you that no processes were found. If you omit the username parameter, a list of all interactive, subprocess, and batch users is displayed. 3 Qualifiers /BATCH /BATCH /NOBATCH Displays all batch users in the OpenVMS Cluster environment. To restrict the display to users on specific nodes, use the /BATCH qualifier with the /NODE qualifier. When you use the /NOBATCH qualifier, all batch users are excluded from the display. /CLUSTER Displays the specified user names on all nodes in an OpenVMS Cluster environment. /EXACT Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a search string that must match the search string exactly and must be enclosed with quotation marks (" "). If you specify the /EXACT qualifier without the /SEARCH qualifier, exact search mode is enabled when you set the search string with the Find (E1) key. /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. /HEADING /HEADING (default) /NOHEADING Displays a heading line above the system output. When you use the /NOHEADING qualifier, the heading line is excluded from the display. /HIGHLIGHT /HIGHLIGHT[=keyword] Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the type of highlighting you want when a search string is found. When a string is found, the entire line is highlighted. You can use the following keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD is the default highlighting. /INTERACTIVE /INTERACTIVE /NOINTERACTIVE Displays all interactive processes held by users in the OpenVMS Cluster environment. To restrict the display to users on specific nodes, use the /INTERACTIVE qualifier with the /NODE qualifier. When you use the /NOINTERACTIVE qualifier, all interactive processes held by users in the OpenVMS Cluster environment are excluded from the display. /NETWORK /NETWORK /NONETWORK Displays all network users in the OpenVMS Cluster environment. To restrict the display to users on specific nodes, use the /NETWORK qualifier with the /NODE qualifier. When you use the /NONETWORK qualifier, all network users in the OpenVMS Cluster environment are excluded from the display. /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. The asterisk (*) and the percent sign (%) 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. /PAGE /PAGE[=keyword] /NOPAGE (default) Controls the display of user information on the screen. You can use the following keywords with the /PAGE qualifier: CLEAR_SCREEN Clears the screen before each page is displayed. SCROLL Displays information one line at a time. SAVE[=n] Enables screen navigation of information, where n is the number of pages to store. The /PAGE=SAVE qualifier allows you to navigate through screens of information. The /PAGE=SAVE qualifier stores up to 5 screens of up to 255 columns of information. When you use the /PAGE=SAVE qualifier, you can use the following keys to navigate through the information: Key Sequence Description Up arrow key, Ctrl/B Scroll up one line. Down arrow key Scroll down one line. Left arrow key Scroll left one column. Right arrow key Scroll right one column. Find (E1) Specify a string to find when the information is displayed. Insert Here (E2) Scroll right one half screen. Remove (E3) Scroll left one half screen. Select (E4) Toggle 80/132 column mode. Prev Screen (E5) Get the previous page of information. Next Screen (E6), Get the next page of information. Return, Enter, Space F10, Ctrl/Z Exit. (Some utilities define these differently.) Help (F15) Display utility help text. Do (F16) Toggle the display to oldest/newest page. Ctrl/W Refresh the display. The /PAGE qualifier is not compatible with the /OUTPUT qualifier. /SEARCH /SEARCH="string" Use with the /PAGE=SAVE qualifier to specify a string that you want to find in the information being displayed. Quotation marks are required for the /SEARCH qualifier, if you include spaces in the text string. You can also dynamically change the search string by pressing the Find key (E1) while the information is being displayed. Quotation marks are not required for a dynamic search. /SUBPROCESS /SUBPROCESS /NOSUBPROCESS Displays all subprocess users in the OpenVMS Cluster environment. To restrict the display to users on specific nodes, use the /SUBPROCESS qualifier with the /NODE qualifier. When you use the /NOSUBPROCESS qualifier, all subprocess users in the OpenVMS Cluster environment are excluded from the output. /WRAP /WRAP /NOWRAP (default) Use with the /PAGE=SAVE qualifier to limit the number of columns to the width of the screen and to wrap lines that extend beyond the width of the screen to the next line. The /NOWRAP qualifier extends lines beyond the width of the screen and can be seen when you use the scrolling (left and right) features provided by the /PAGE=SAVE qualifier. 3 Examples 1.$ SHOW USERS OpenVMS User Processes at 12-MAY-2001 10:37 AM Total number of users = 4, number of processes = 14 Username Node Interactive Subprocess Batch S_SKONETSKI BBBBBB 1 WISNIEWSKI XXXXXX 4 2 HIBBITS AAAAAA 1 4 VAXMAN AAAAAA 2 The SHOW USERS command in this example displays the user names and node names of all current interactive, subprocess, and batch users on the system. 2.$ SHOW USERS/NOHEADING/OUTPUT=SYSUSERS.DAT $ TYPE SYSUSERS.DAT S_SKONETSKI BBBBBB 1 WISNIEWSKI XXXXXX 4 2 HIBBITS AAAAAA 1 4 VAXMAN AAAAAA 2 The SHOW USERS command in this example displays the user names and node names of all current interactive, subprocess, and batch users on the system without the heading text using the /NOHEADING qualifier. Using the /OUTPUT qualifier, you can write the output to a file for processing or later review. 3.$ SHOW USERS *LES* OpenVMS User Processes at 12-MAY-2001 10:41 AM Total number of users = 3, number of processes = 10 Username Node Interactive Subprocess Batch THALES MILETS - - 1 PRAXITELES LESBOS 5 2 PERICLES ISLAND 1 The SHOW USERS command in this example displays the user name and node names of all users whose user names contain the string LES. 4.$ SHOW USERS/FULL/NODE=AAAAAA OpenVMS User Processes at 9-JUN-2001 02:23 PM Total number of users = 3, number of processes = 3 Username Node Process Name PID Terminal DJONES AAAAAA Aaaaaa_fta2: 2180012D FTA2: DYSLI AAAAAA DYSLI 2180011A FTA1: SINDBY AAAAAA SINDBY 2180011E RTA1: (JJJJJ::SINDBY) B4B4 _WSA1 3100009F The SHOW USERS command in this example displays the user name, the local node, 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 system AAAAAA. A user name of indicates that someone is in the process of logging in. 5.$ SHOW USERS /NODE=(AAAAAA,BBBBBB,MMMMMM) OpenVMS User Processes at 9-JUN-2001 02:23 PM Total number of users = 5, number of processes = 7 Username Node Process Name PID Terminal BRICKLEY BBBBBB BRICKLEY 21E0009E RTA1: (CBREEZ::BRICKLEY) DCLDCT MMMMMM Mmmmmm_rta1: 2020015D RTA1: (MMMMMM::DJOHNSON) PELEG AAAAAA Aaaaaa_fta2: 2180012D FTA2: PETERSON MMMMMM Mmmmmm_fta1: 2020013E FTA1: PRESTON MMMMMM Mmmmmm_rta3: 20200184 RTA3: (DDRSND::PRESTON) PRUSS AAAAAA PRUSS 2180011E RTA1: (IVOK::PRUSS) RABAHY AAAAAA RABAHY 2180011A FTA1: The SHOW USERS command in this example displays the user name and node name for all interactive, batch, and subprocess users on the nodes AAAAAA, BBBBBB, and MMMMMM. 2 WORKING_SET On Alpha, displays the working set limit, quota, and extent (in pagelets and CPU-specific pages) assigned to the current process. On VAX, displays the working set limit, quota, and extent (in pages) assigned to the current process. Format SHOW WORKING_SET 3 Qualifier /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. The asterisk (*) and the percent sign (%) wildcard characters are not allowed in the file specification. If you enter the /NOOUTPUT qualifier, output is suppressed. 3 Examples 1.$ SHOW WORKING_SET Working Set (pagelets) /Limit= 2000 /Quota= 4000 /Extent= 6000 Adjustment enabled Authorized Quota= 4000 Authorized Extent= 6000 Working Set (8Kb pages) /Limit= 125 /Quota= 250 /Extent= 375 Authorized Quota= 250 Authorized Extent= 375 This example shows the SHOW WORKING_SET command on Alpha. The process has a working set limit of 2000 pagelets (125 pages) and a quota of 4000 pagelets (250 pages), and the current quota is equal to the authorized limit (4000 pagelets; 250 pages). It also shows that the current process has a working set extent of 6000 pagelets (375 pages) and that the current extent is equal to the authorized limit (6000 pagelets; 375 pages). A pagelet is 512 bytes. 2.$ SHOW WORKING_SET Working Set /Limit= 180 /Quota= 350 /Extent=1200 Adjustment enabled Authorized Quota= 350 Authorized Extent=1200 This example shows the SHOW WORKING_SET command on VAX. The process has a working set limit of 180 pages, a quota of 350 pages, and the 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). Each page on a VAX is 512 bytes. 2 ZONE Displays the current state of a VAXft system. For more information on the SHOW ZONE command, see VAXft systems documentation. Applies only to a VAXft system. Format SHOW ZONE [zone-id]