Transportation Administration System
Snoezelen Pillows for Dementia
Begeleiders voor gehandicapten
Laat uw hond het jaarlijkse vuurwerk overwinnen
Betuweroute en Kunst
Hey Vos! Je eigen naam@vos.net emailadres?
Kunst in huis? Nicole Karrèr maakt echt bijzonder mooie dingen
Kunst in huis? Netty Franssen maakt ook bijzonder mooie dingen1 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 mass storage control protocol (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 lists 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 Characteristic names and numbers that have /CHARACTERISTICS 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 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 ACL On Alpha, allows you to display the access control list (ACL) of an object. NOTE This command has been superseded by the SHOW SECURITY command. Format SHOW ACL object-name 3 Parameter object-name Specifies the name of the object whose ACL is to be displayed. The asterisk (*) and the percent sign (%) wildcard characters are not allowed in the object-name specification. 3 Qualifier /OBJECT_TYPE /OBJECT_TYPE=type Specifies the object type of the object whose ACL is to be displayed. The following keywords are used to specify the object type: CAPABILITY A system capability, such as the ability to process vector instructions. Currently, the only defined object name for the CAPABILITY type is VECTOR, which governs the ability of a subject to access a vector processor on the system. Note that you must supply the capability name (for example, VECTOR) as the object-name parameter in the SHOW ACL command. DEVICE A device. FILE (default) A Files-11 disk file (includes directory files). GROUP_GLOBAL_ A group global section. SECTION LOGICAL_NAME_TABLE A system logical name table. QUEUE A batch or device (terminal, server, or printer) queue. SYSTEM_GLOBAL_ A system global section. SECTION 3 Example $ SHOW ACL/OBJECT_TYPE=DEVICE TTA1 Object type: device, Object name: VTA1 (IDENTIFIER=[SALES,FRANK],ACCESS=READ) (IDENTIFIER=[123,321]+NETWORK,ACCESS=NONE) . . . The SHOW ACL command displays the ACL of the device TTA1. 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] /NOHIGHLIGHT (default) 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 (^ ), Ctrl/B Scroll up one line. Down arrow (v ) Scroll down one line. Left arrow (< - ) Scroll left one column. Right arrow (- > ) 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. 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 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 a complete description of the Show Cluster utility, see the OpenVMS System Management Utilities Reference Manual. 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 topic SPECIFY Date_Time in online help. 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 topic SPECIFY Date_Time in online help. /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, see 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 topic SPECIFY Date_Time in online help. 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 topic SPECIFY Date_Time in online help. /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. /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. /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. 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 COBRA7, a DEC 4000 Model 620 Multiprocessing is ENABLED. Streamlined synchronization image loaded. Minimum multiprocessing revision levels: CPU = 1 System Page Size = 8192 System Revision Code = System Serial Number = Default CPU Capabilities: System: QUORUM RUN Default Process Capabilities: System: QUORUM RUN PRIMARY CPU = 00 CPU 00 is in RUN state Current Process: *** None *** Serial Number: AY24870417 Revision: A200 VAX floating point operations supported. IEEE floating point operations and data types supported. Processor is Primary Eligible. PALCODE: Revision Code = 5.48 PALcode Compatibility = 0 Maximum Shared Processors = 2 Memory Space: Physical address = 00000000 00000000 Length = 0 Scratch Space: Physical address = 00000000 00000000 Length = 0 Capabilities of this CPU: System: PRIMARY QUORUM RUN User bitmask: 00000040 Processes which can only execute on this CPU: NETACP PID = 0000008E Reason: PRIMARY Capability CPU 01 is in RUN state Current Process: CPUSCHED PID = 00000095 Serial Number: AY24870406 Revision: A200 VAX floating point operations supported. IEEE floating point operations and data types supported. PALCODE: Revision Code = 5.48 PALcode Compatibility = 0 Maximum Shared Processors = 2 Memory Space: Physical address = 00000000 00000000 Length = 0 Scratch Space: Physical address = 00000000 00000000 Length = 0 Capabilities of this CPU: System: QUORUM RUN User bitmask: 00000080 Processes which can only execute on this CPU: CPUSCHED PID = 00000095 Reason: Affinitized to this CPU Reason: User capabilities - 00000080 The SHOW CPU/FULL command in this example produces a configuration summary of the DEC 4000 Model 620 system COBRA7. Both processors are in the RUN state, but only CPU 1 has a current process (CPUSCHED). CPUSCHED runs on CPU 1 because it has affinity for that processor, and because only CPU 1 has process capability 8. 4.$ SHOW CPU/FULL OLEO, A VAX 6000-420 Multiprocessing is DISABLED. MULTIPROCESSING Sysgen parameter = 02 Minimum multiprocessing revision levels -- CPU: 0 uCODE: 0 UWCS: 21. PRIMARY CPU = 02 *Loaded unmodified device drivers prevent multiprocessor operation.* RBDRIVER CPU 02 is in RUN state Current Process: Koko PID = 2A6001E3 Revision levels: CPU: 0 uCODE: 0 UWCS: 0. Capabilities of this CPU: PRIMARY VECTOR RUN Processes which can only execute on this CPU: CONFIGURE PID = 2A40010B Reason = PRIMARY Capability Reason = RUN Capability CPU 07 is in INIT state Current Process: *** None *** Revision levels: CPU: 0 uCODE: 0 UWCS: 0. Capabilities of this CPU: *** None *** Processes which can only execute on this CPU: *** None *** The SHOW CPU/FULL command in this example produces a configuration summary of the VAX 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.$ SHOW CPU/FULL CPU type: DEC 7000 Model 620 Multiprocessing is ENABLED. Full checking synchronization image loaded. Minimum multiprocessing revision levels: CPU = 1 System Page Size = 8192 System Revision Code = System Serial Number = PROTO115 Default CPU Capabilities: QUORUM RUN Default Process Capabilities: QUORUM RUN PRIMARY CPU = 00 CPU 00 is in RUN state Current Process: *** None *** Serial Number: GROUCHO Revision: VAX floating point operations supported. IEEE floating point operations and data types supported. PALCODE: Revision Code = 5.37 PALcode Compatibility = 2 Maximum Shared Processors = 8 Memory Space: Physical address = 00000000 00000000 Length = 16 Scratch Space: Physical address = 00000000 00020000 Length = 16 Capabilities of this CPU: PRIMARY QUORUM RUN Processes which can only execute on this CPU: CONFIGURE PID = 00000104 Reason: PRIMARY Capability CPU 01 is in RUN state Current Process: VMSADU PID = 00000110 Serial Number: HARPO Revision: VAX floating point operations supported. IEEE floating point operations and data types supported. PALCODE: Revision Code = 5.37 PALcode Compatibility = 2 Maximum Shared Processors = 8 Memory Space: Physical address = 00000000 00000000 Length = 16 Scratch Space: Physical address = 00000000 00020000 Length = 16 Capabilities of this CPU: QUORUM RUN Processes which can only execute on this CPU: *** None *** The SHOW CPU/FULL command in this example produces a configuration summary of the Alpha 7000-620, showing both CPUs active and in the RUN state. 2 DEFAULT Displays the current default device and directory. Format SHOW DEFAULT 3 Examples 1.$ SHOW DEFAULT DISK1:[ALAMO] $ SET DEFAULT DISK5:[HIGGINS.SOURCES] $ SHOW DEFAULT DISK5:[HIGGINS.SOURCES] The SHOW DEFAULT command in this example displays the current default device and directory names. The SET DEFAULT command changes these defaults, and the next SHOW DEFAULT command displays the new default device and directory. 2.$ SET DEFAULT NOSUCH:[NOWAY] $ SHOW DEFAULT NOSUCH:[NOWAY] %DCL-I-INVDEF, NOSUCH:[NOWAY] does not exist In this example, the default has been set to a nonexistent device and directory. An error message is displayed. 3.$ DEFINE/TRANSLATION_ATTRIBUTES=CONCEALED XYZ WORK:[INVOICES.] $ SET DEFAULT XYZ:[SALES] $ SHOW DEFAULT XYZ:[SALES] In this example, a logical name, XYZ, is defined to represent WORK:[INVOICES]. The /TRANSLATION_ATTRIBUTES=CONCEALED qualifier tells the system not to display the translation of XYZ in file specifications. Thus, the SHOW DEFAULT command displays the logical name XYZ and not its translation. 4.$ SET DEFAULT WORK:[BLUE] $ SHOW DEFAULT WORK:[BLUE] $ DEFINE KUDOS WORK:[BLUE.TEMP1],WORK:[BLUE.TEMP2] $ SET DEFAULT KUDOS $ SHOW DEFAULT KUDOS:[BLUE] = WORK:[BLUE.TEMP1] = WORK:[BLUE.TEMP2] In this example, the logical name KUDOS is defined as a search list containing the directories [BLUE.TEMP1] and [BLUE.TEMP2] on device WORK. The SET DEFAULT command equates this search list logical name with the logical name SYS$DISK. The subsequent SHOW DEFAULT command displays the search list logical name along with its equivalence strings. Because the directory field has not been explicitly specified, the original [BLUE] directory remains in effect as the current default directory. However, unless the current default directory syntax ([]) is 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 hierarchical storage controllers (HSCs), the device name must include the node name using the format node$ddcu (where node is the node name). You can specify a complete device name or only a portion of a device name. The SHOW DEVICES command provides defaults for nonspecified portions of device names, as follows: o If you truncate a device name (for example, if you specify D), the command lists information about all devices whose device names begin with what you entered (in this case, D). However, if you specify a device in an OpenVMS Cluster that is running with HSCs, you must include the entire node portion of the device name. o If you omit a controller designation, the SHOW DEVICES command lists all devices on all controllers with the specified unit number. o If you omit a unit number, the SHOW DEVICES command lists all devices on the specified controller. Note that the /FILES qualifier does not support defaults for nonspecified portions of device names; you must supply a complete device specification. 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. /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, the /BRIEF, the /FULL, or the /MOUNTED qualifier. The functions of the /FILES qualifier and these qualifiers are mutually exclusive. /FULL Displays a complete list of information about the devices, except for rebuild status. You must use the /REBUILD_STATUS qualifier to get that information. /HIGHLIGHT /HIGHLIGHT[=keyword] /NOHIGHLIGHT (default) 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. /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 (^ ), Ctrl/B Scroll up one line. Down arrow (v ) Scroll down one line. Left arrow (< - ) Scroll left one column. Right arrow (- > ) 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 DBA0: Online mnt 0 VMS 47088 115 1 DBA1: Online mnt 0 USERPACK1 45216 2 1 DBA2: Online mnt 3 DOCUMENT 8068 20 1 DBA5: Online mnt 0 MASTERP 28668 1 1 DBA6: Online 0 DBA7: Online mnt 0 PROJECT 110547 1 1 DMA0: Online 0 DLA0: Online 0 DYA0: Online 0 DYA1: Online 0 DRA3: Online mnt 0 RES26APR 29317 1 1 In this example, the SHOW DEVICES command displays the following information for each device on the system: o Device name o Device status and characteristics (status indicates whether the device is on line; characteristics indicate whether the device is allocated, is spooled, has a volume mounted on it, or has a foreign volume mounted on it) o Error count o Volume label (for disk and tape volumes only) o Number of free blocks on the volume o Transaction count o Number of mount requests issued for the volume (disk devices only) 2.$ SHOW 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: 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 contain on member of an ISO 9660 partially mounted volume set. Note the volume status displays the media format is 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 MUA0. 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] /NOHIGHLIGHT (default) 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 (^ ), Ctrl/B Scroll up one line. Down arrow (v ) Scroll down one line. Left arrow (< - ) Scroll left one column. Right arrow (- > ) 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 on the resources available to the MSCP server for use in processing I/O requests for the devices it serves. You make these resources available to the MSCP server when you use SYSGEN's MSCP command to start the MSCP server and use the qualifiers listed in the following table: Qualifier Item Specified /BUFFER The amount of buffer space available to the MSCP server. /FRACTION The maximum size, in pages, of the buffer granted to an I/O request; for transfers of more data than will fit a buffer of the size specified by this qualifier, several computer interconnect (CI) transfers are needed. /SMALL The minimum size, in pages, of the buffer that the MSCP server can grant to an I/O request; if less than this amount of buffer space is available, the I/O request must wait until at least this much buffer space becomes available; when this much space becomes available, the MSCP server grants the request a buffer. /PACKETS The number of I/O-request packets (class driver request packets [CDRPs]) available to the MSCP server for processing I/O requests. /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 BHAK 28-MAY-1994 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 BHAK 28-MAY-1994 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 10 set-controller-characteristics (SET CTL CHR) operations, but has performed no set-unit-characteristics (SET UNT CHR) operations. 3.$ SHOW DEVICES/SERVED/RESOURCE MSCP-Served Devices on BHAK 28-MAY-1994 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/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 BHAK 28-MAY-1994 13:54:41.99 . . . Queue Requests Host: Time of Connection Current Max Devices IPL31 25-MAY-1994 21:44:06.44 0 1 0 DELAND 25-MAY-1994 21:44:09.98 0 1 0 HEAVEN 25-MAY-1994 22:03:15.67 0 7 10 VIVA 26-MAY-1994 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-JAN-1992 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-JAN-1992 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] /NOHIGHLIGHT (default) 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 (^ ), Ctrl/B Scroll up one line. Down arrow (v ) Scroll down one line. Left arrow (< - ) Scroll left one column. Right arrow (- > ) 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-1994 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 JAMES 112 Pending (queue stopped) On stopped printer queue LN01$PRINT Submitted 19-DEC-1994 12:14 /FORM=LN01$PORTRAIT (stock=DEFAULT) /NOTIFY /PRIORITY=100 File: _DBA1:[JAMES]STAFF.DIS;3 629 SEARCH JAMES 94 Printing On printer queue LINE$PRINT Submitted 19-DEC-1994 12:16 /FORM=DEFAULT /NOTIFY /PRIORITY=100 /COPIES=2 /NOFEED /PASSALL File: _DBA1:[JAMES.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 JAMES 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-1994 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] /NOHIGHLIGHT (default) 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 (^ ), Ctrl/B Scroll up one line. Down arrow (v ) Scroll down one line. Left arrow (< - ) Scroll left one column. Right arrow (- > ) 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 /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::SMITH In this example, the SHOW INTRUSION command displays all intruder entries currently in the intrusion database. 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 GEORGE" %DCL-I-DEFKEY, DEFAULT key PF1 has been defined $ SHOW KEY PF1 DEFAULT keypad definitions: PF1 = "ATTACH GEORGE" $ SHOW KEY/FULL PF1 DEFAULT keypad definitions: PF1 = "ATTACH GEORGE" (noecho,terminate,noerase,nolock) The SHOW KEY command in this example displays both the definition and the state for the PF1 key. This is the default display. The SHOW KEY/FULL command displays all qualifiers associated with the key definition. 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. /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] /NOHIGHLIGHT (default) 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 (^ ), Ctrl/B Scroll up one line. Down arrow (v ) Scroll down one line. Left arrow (< - ) Scroll left one column. Right arrow (- > ) 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 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 anOpenVMS 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. See 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 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: SMITH The SHOW LICENSE command in this example displays information about the product PERSONAL, as well as the name SMITH 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-MAR-1994 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-FEB-1994 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-FEB-1994 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-JUN-1994 14:05:51.65 Node A B C D E F G H I KARBO - - - 100 50 10 - - 10 JENJON - - - 100 50 10 - - 10 HELENA 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, the /JOB, the /GROUP, the /SYSTEM, or the /TABLE qualifier, all logical names in the tables specified by the logical name LNM$DCL_LOGICAL are displayed. /DESCENDANTS /DESCENDANTS /NODESCENDANTS (default) Controls whether the system displays names from the specified logical name table and any descendant tables. A descendant table is created by the CREATE/NAME_TABLE command, with the /PARENT_ TABLE qualifier specifying its parent table. If you use the /DESCENDANTS qualifier, you must also use the /TABLE qualifier. /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] /NOHIGHLIGHT (default) 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 (^ ), Ctrl/B Scroll up one line. Down arrow (v ) Scroll down one line. Left arrow (< - ) Scroll left one column. Right arrow (- > ) 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" = "DBA2:" "SYS$SCRATCH" = "WORK6:[ODONNELL]" The SHOW LOGICAL command in this example displays all process logical names and their translations. (Note that /TABLE=LNM$PROCESS would produce the same display as /PROCESS.) 2.$ SHOW LOGICAL INFILE "INFILE" = "WORK6:[LOGAN]PAYROLL.EXE" (LNM$PROCESS_TABLE) The SHOW LOGICAL command in this example displays the translation for the logical name INFILE. The response indicates that the logical name was found in the process logical name table. 3.$ SHOW LOGICAL/GROUP . . . The SHOW LOGICAL command in this example displays all group logical names and their translations. (Note that /TABLE=LNM$GROUP would produce the same display as /GROUP.) 4.$ SHOW LOGICAL/TABLE=SYSTEM SYS$LIBRARY "SYS$LIBRARY" = "SYS$SYSROOT:[SYSLIB]" (LNM$SYSTEM_TABLE) = "DOCD$:[SYSC.SYSLIB]" The SHOW LOGICAL command in this example displays the translation of the logical name SYS$LIBRARY in the system table. The response indicates that SYS$LIBRARY is defined in the system table, and that the logical name has two translations. 5.$ SHOW LOGICAL/TABLE=LNM$GROUP/TABLE=LNM$SYSTEM SYS$DISK "SYS$DISK" = "ZZZ3:" (LNM$SYSTEM_TABLE) The SHOW LOGICAL command in this example is qualified by both the /TABLE=LNM$GROUP and /TABLE=LNM$SYSTEM qualifiers. The response indicates that the logical name SYS$DISK was found in the system logical name table. When you enter two conflicting qualifiers, as in this example, only the last qualifier you specify is used. 6.$ SHOW LOGICAL/TABLE=LNM$PROCESS_DIRECTORY The SHOW LOGICAL command in this example displays the logical names in the process directory table. Each name is either a table name, or a name that translates iteratively to a table. 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. /CACHE Displays information about the Virtual I/O Cache facility. The Cache facility information is displayed as part of the SHOW MEMORY and SHOW MEMORY/CACHE/FULL commands. /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. When used with the /CACHE qualifier, /FULL displays additional information about the use of the Virtual I/O Cache facility. /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 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] /NOHIGHLIGHT (default) 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 (^ ), Ctrl/B Scroll up one line. Down arrow (v ) Scroll down one line. Left arrow (< - ) Scroll left one column. Right arrow (- > ) 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. /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 4-MAY-1994 10:14:45.68 Physical Memory Usage (pages): Total Free In Use Modified Main Memory (24.00Mb) 49152 16390 31056 1706 Virtual I/O Cache Usage (pages): Total Free In Use Maximum 9232 0 9232 18055 Slot Usage (slots): Total Free Resident Swapped Process Entry Slots 26 3 21 2 Balance Set Slots 23 1 21 1 Dynamic Memory Usage (bytes): Total Free In Use Largest Nonpaged Dynamic Memory 462336 8304 454032 4608 Paged Dynamic Memory 348672 117120 231552 114976 Paging File Usage (pages): Free Reservable Total DISK$DKA300:[SYS0.SYSEXE]PAGEFILE.SYS 46514 -3239 50000 Of the physical pages in use, 5162 pages are permanently allocated to VMS. This example shows reservable pages. Here, the reservable pages are a negative value which 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 10-OCT-1994 18:36:12.79 Virtual I/O Cache Total Size (pages) 1 2422 Read IO Count 6 9577 Free Pages 2 18 Read Hit Count 7 5651 Pages in Use 3 2404 Read Hit Rate 8 59% Maximum Size (SPTEs) 4 11432 Write IO Count 9 2743 Files Retained 5 99 IO Bypassing the Cache 10 88 NOTE This example shows the output for the SHOW MEMORY/CACHE/FULL command on a VAX system. The SHOW MEMORY/CACHE/FULL command will display slightly different field on an Alpha system. Virtual I/O Cache Usage (in pages) Shows the use of the Virtual I/O Cache facility on VAX. 1 Total size Displays the total number of system memory pages that the Virtual I/O cache currently controls. 2 Free pages Displays the number of pages controlled by the Virtual I/O cache that do not contain cache data. 3 Pages in use Displays the number of pages controlled by the Virtual I/O cache that contain valid cached data. 4 Maximum Size Shows the maximum size that the cache could ever grow to. 5 Files retained Displays the number of files that are closed but the file system control information is being retained because they have valid data residing in the cache. 6 Read I/O count Displays the total number of read I/Os that have been seen by the Virtual I/O cache since the last system. 7 Read hit count Displays the total number of read I/Os that did not do a physical I/O because the data for them was found in the cache since the last system BOOT. 8 Read hit rate Displays the read hit count and read I/O count ratio. 9 Write I/O count Shows the total number of write I/Os that have been seen by the cache since the last system BOOT. 10 I/O bypassing Displays the count of I/Os that for some reason did not attempt to satisfy the request/update by the cache. 3.$ SHOW MEMORY/PHYSICAL_PAGES System Memory Resources on 14-DEC-1994 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 Displays the 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 Displays the number of pages on the free page list. 3 In Use Displays the 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 Displays the 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 Displays the number of pages on the bad page list. Dynamic Displays the number of memory errors detected after the system was booted. I/O Errors Displays the number of errors detected during page fault handling. Static Displays the 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. 4. $ SHOW MEMORY/SLOTS System Memory Resources on 14-DEC-1994 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 Displays the 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 Displays the number of slots currently available. 3 Resident Displays the 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 Displays the 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. 5. $ SHOW MEMORY/POOL System Memory Resources on 14-DEC-1994 16:11:39.97 Dynamic Memory Usage (bytes): Total 1 Free 2 In Use 3 Largest 4 Nonpaged Dynamic Memory 161792 3488 158304 1936 Paged Dynamic Memory 65536 29312 36224 29296 Dynamic Memory Usage (in bytes) Shows the use of the nonpaged and paged pool areas that allocate variably sized blocks. 1 Total Displays the total number of bytes set aside for each area. 2 Free Displays the total amount of free space in each dynamic memory area. 3 In Use Displays the amount of space currently allocated from each area. This number is simply the total size minus the number of free bytes. 4 Largest Displays the 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). 6. $ SHOW MEMORY/FILES System Memory Resources on 14-DEC-1994 16:11:45.83 Paging File Usage (blocks): Free 2 Reservable 3 Total 4 DISK$VMS02APR1:[SYS2.SYSEXE]SWAPFILE.SYS 1 256 256 4096 DISK$VMS02APR1:[SYS2.SYSEXE]PAGEFILE.SYS 7613 6912 8192 Paging File Usage (in pages) Shows the usage of paging and swapping files. 1 Name Displays the complete file specification of each swapping or paging file. The names of the primary paging file, the primary swapping file (if this file exists), and the files installed by the bootstrap operation are always displayed. The names of any secondary paging or swapping files installed by the System Generation utility (SYSGEN) are displayed only if the process using the SHOW MEMORY command has read (R) access to those files. If the process cannot read the file, the name is suppressed but the usage statistics are displayed. 2 Free Displays the number of free blocks in each paging and swapping file currently installed. Free blocks are blocks that may be physically allocated in the file. 3 Reservable Displays the number of reservable blocks in each paging and swapping file currently installed. Reservable blocks are blocks that may be logically claimed by a process for future physical allocation. A negative value indicates that the file may be overcommitted. Note that a negative value is not an immediate concern but indicates that the file may become overcommitted if physical memory becomes scarce. 4 Total Displays the total size of each paging and swapping file. When the /FULL qualifier is included on the SHOW MEMORY command for displays of pool areas or paging file usage, additional information is included in the pool or files displays. 7.$ SHOW MEMORY/POOL/FULL System Memory Resources on 31-DEC-1994 16:11:49.74 Nonpaged Dynamic Memory (Lists + Variable) Current Size (bytes) 1 8144384 Current Total Size (pages)1 15907 Initial Size (NPAGEDYN)2 8144384 Initial Size (pages) 2 15907 Maximum Size (NPAGEVIR)336196352 Maximum Size (pages) 3 70696 Free Space (bytes) 4 2849856 Space in Use (bytes) 55294528 Size of Largest Block 6 971904 Size of Smallest Block 7 64 Number of Free Blocks 8 6756 Free Blocks LEQU 64 Bytes 9 274 Paged Dynamic Memory Current Size (PAGEDYN) 1 4324352 Current Total Size (pages)1 8446 Free Space (bytes) 4 3378664 Space in Use (bytes) 5 951488 Size of Largest Block 6 3357664 Size of Smallest Block 7 16 Number of Free Blocks 8 216 Free Blocks LEQU 64 Bytes 9 178 Dynamic Memory Shows the use of dynamic memory areas consisting of variably sized blocks. 1 Current Size Displays the current size (in 512-byte pagelets on Alpha and in bytes and pages on VAX) of each dynamic memory area. 2 Initial Size Displays the initial size of nonpaged dynamic memory and the name of the system parameter (NPAGEDYN) that controls this size. 3 Maximum Size Displays the maximum size to which nonpaged dynamic memory can grow and the name of the system parameter (NPAGEVIR) that controls this size. 4 Free Space Displays the amount of free space in each dynamic memory area. 5 Space in Use Displays the amount of space currently allocated from each area. 6 Largest Block Displays the size of the largest contiguous area in each pool area. 7 Smallest Block Displays the size of the smallest hole (free block) in each pool area. 8 Free Blocks Displays the total number of free blocks in each pool area. The size of this number is a measure of pool fragmentation. 9 Blocks LEQU 64 Displays the 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. 8. $ SHOW MEMORY/FILES/FULL System Memory Resources on 14-APR-1994 16:11:55.49 DISK$VMS02APR1:[SYS0.SYSEXE]SWAPFILE.SYS 1 Free Blocks 2 256 Reservable Blocks 3 256 Total Size (blocks) 4 4096 Paging File Number 5 1 Swapping Usage (processes) 6 0 Paging Usage (processes) 7 0 This file is used exclusively for swapping. 8 DISK$VMS02APR1:[SYS0.SYSEXE]PAGEFILE.SYS 1 Free Blocks 2 7611 Reservable Blocks 3 6912 Total Size (blocks) 4 8192 Paging File Number 5 5 Swapping Usage (processes) 6 0 Paging Usage (processes) 7 0 This file can be used for either paging or swapping. 8 Paging File Usage Shows the usage of paging and swapping files. 1 File Name Displays the complete file specification of each paging or swapping file, subject to the privilege restriction mentioned in the description of the normal display. 2 Free Blocks Displays the number of free blocks in each paging and swapping file currently installed. Free blocks are blocks that may be physically allocated in the file. 3 Reservable Blocks Displays the number of reservable blocks in each paging and swapping file currently installed. Reservable blocks are blocks that may be logically claimed by a process for future physical allocation. A negative value indicates that the file may be overcommitted. Note that a negative value is not an immediate concern but indicates that the file may become overcommitted if physical memory becomes scarce. 4 Total Size Displays the size of each paging and swapping file. 5 File Number Displays the internal paging file index assigned to each paging or swapping file when it is installed. 6 Swapping Usage Displays the number of processes currently assigned space in this file for the purpose of swapping. Swapping file assignment can change over the life of a process. 7 Paging Usage Displays the number of processes currently paging to this file. Paging file assignment is made when a process is created and a process continues to page to that file. Note that the last two pieces of information are limited by the GROUP and WORLD privileges. That is, a process with neither privilege can only determine the paging and swapping file assignments of itself and its subprocesses. A process with GROUP privilege can obtain this information about all processes that have the same group number. Only a process with WORLD privilege can obtain accurate paging and swapping file information for the entire system. 8 File Usage Displays a line of text that describes whether the file is used exclusively for swapping or is used for both paging and swapping. 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: GALAXY Addresss(es): 19.129 This command displays all the network services currently registered on the local node, and the name and address of that node. 2.$ SHOW NETWORK DECnet Product: DECnet Node: GALAXY Addresss(es): 19.129 This command identifies the network services, in this case DECnet, registered on the local node. 3.$ SHOW NETWORK/FULL The following network service is available at this time: Product: DECNET Manufacturer: Digital Equipment Corporation Node: ZOOMAN Address(es): 19.215 Network Type: DNA IV Interface(s): net 0 Node Volatile Characteristics as of 21-NOV-1995 10:36:09 Executor node = 19.215 (ZOOMAN) Identification = DECnet for OpenVMS Alpha V6.2 Management version = V4.0.0 Incoming timer = 45 Outgoing timer = 60 Incoming Proxy = Enabled Outgoing Proxy = Enabled NSP version = V4.1.0 Maximum links = 32 Delay factor = 80 Delay weight = 5 Inactivity timer = 60 Retransmit factor = 10 Routing version = V2.0.0 Type = nonrouting IV Routing timer = 600 Broadcast routing timer = 180 Maximum address = 1023 Maximum circuits = 16 Maximum cost = 1022 Maximum hops = 30 Maximum visits = 63 Maximum area = 63 Max broadcast nonrouters = 64 Max broadcast routers = 32 Maximum path splits = 1 Area maximum cost = 1022 Area maximum hops = 30 Maximum buffers = 100 Buffer size = 576 Default access = incoming and outgoing Pipeline quota = 4032 Alias maximum links = 32 Path split policy = Normal Maximum Declared Objects = 31 Known Link Volatile Summary as of 21-NOV-1995 10:36:10 Link Node PID Process Remote link Remote user 8201 19.117 20200094 REMACP 25330 JONES 8200 19.129 20200094 REMACP 24711 SMITH Node Counters as of 21-NOV-1995 10:36:10 Executor node = 19.215 (ZOOMAN) 3 Maximum logical links active 0 Aged packet loss 0 Node unreachable packet loss 0 Node out-of-range packet loss 0 Oversized packet loss 0 Packet format error 0 Partial routing update loss 0 Verification reject $ This command 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. 3 Example $ SHOW PRINTER LPA0: Printer LPA0:, device type LP11, is online, allocated, spooled Error count 0 Operations completed 880 Owner process "SYMBIONT_ 0001" Owner UIC [0,0] Owner process ID 21C0008D Dev Prot S:RWLP,O:RWLP,G:RWLP,W:RWLP Reference count 2 Default buffer size 132 Page width 132 Page Length 66 No Carriage_return Formfeed Lowercase No Passall No Wrap Printall No Fallback Intermediate device: STAR$DBA1: Associated queue: LN01$PRINT The SHOW PRINTER command in this example displays the settings for the printer LPA0. 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] /NOHIGHLIGHT (default) 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 (^ ), Ctrl/B Scroll up one line. Down arrow (v ) Scroll down one line. Left arrow (< - ) Scroll left one column. Right arrow (- > ) 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. /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-1994 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-1994 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-1994 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-1994 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-1994 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 FRED Process FRED 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,FRED] Event flags C8000007 C0000000 SYS$SYSROOT:[SYSEXE]SHOW.EXE In this example, the /CONTINUOUS qualifier causes the display of information about process FRED 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-1994 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-1994 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 SMITH 15-JUNE-1995 10:07:25.11 User: SMITH Process ID: 20206A50 Node: BANANA Process name: "SMITH" Auto-unshelve: on The SHOW PROCESS command in this example shows that the SMITH process automatically unshelves files. 10$ SHOW PROCESS/DUMP SMITH 31-MAY-1994 10:38:32.48 User: SMITH Process ID: 20C0011B Node: AAAAAA Process name: "_RTA1:" Image Dump: on The SHOW PROCESS command in this example shows that the SMITH process 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. 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] /NOHIGHLIGHT (default) 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 (^ ), Ctrl/B Scroll up one line. Down arrow (v ) Scroll down one line. Left arrow (< - ) Scroll left one column. Right arrow (- > ) 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 TELLER 140 Pending (queue stopped) Submitted 21-DEC-1994 16:14 /FORM=ELITE (stock=DEFAULT) /PRIORITY=200 File: _$5$DUA1:[TELLER]SET.CLD;5 606 CLOSE TELLER 140 Pending (queue stopped) Submitted 21-DEC-1994 16:16 /FORM=DEFAULT /PRIORITY=200 File: _$5$DUA1:[TELLER]CLOSE.TXT;2 Printer queue ARMADA$PRINTER_1, idle, on ARMADA::TTA3, mounted form DEFAULT <Printer queue on node ARMADA for a LN03R printer> /BASE_PRIORITY=4 /DEFAULT=(FEED,FORM=DEFAULT) /LIBRARY=SMU$DEVCTL Lowercase /OWNER=[SYSTEM] /PROCESSOR=CPS$SMB /PROTECTION=(S: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-1994 16:56 %JBC-F-JOBABORT, job aborted during execution Completed 11-JUL-1991 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 can 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. 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, and the extend quantity. 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 Process 0 0 System 0 0 The SHOW RMS_DEFAULT command in this example shows a system multiblock count of 16 and a network block count of 8. These are typical values. 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, see the OpenVMS User's Manual or the topic SPECIFY Date_Time in online help. /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 QUEUE COMMON_EVENT_CLUSTER RESOURCE_DOMAIN DEVICE SECURITY_CLASS FILE SYSTEM_GLOBAL_SECTION GROUP_GLOBAL_SECTION VOLUME LOGICAL_NAME_TABLE /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 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 topic SPECIFY Date_Time in online help. 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: <empty> RES17SEP object of class VOLUME Owner: [FEAST,FY93] Protection: (System: RWCD, Owner: RWCD, Group: RWCD, World: RWCD) Access Control List: <empty> $ 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 RES127SEP that is mounted on it. The subsequent SHOW DEVICE command confirms 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: <empty> Template: GROUP Owner: [SYSTEM] Protection: (System: RWCD, Owner: R, Group: R, World: R) Access Control List: <empty> Template: JOB Owner: [SYSTEM] Protection: (System: RWCD, Owner: RWCD, Group, World) Access Control List: <empty> Template: DEFAULT Owner: [SYSTEM] Protection: (System: RW, Owner: RW, Group: R, World: R) Access Control List: <empty> 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: <empty> LOGICAL_NAME_TABLE object of class SECURITY_CLASS Owner: [SYSTEM] Protection: (System: RWCD, Owner: RWCD, Group: R, World: R) Access Control List: <empty> . . . 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 STATUS Displays the current status of your process. Format SHOW STATUS 3 Example $ SHOW STATUS Status on 14-DEC-1994 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] /NOHIGHLIGHT (default) 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. /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 (^ ), Ctrl/B Scroll up one line. Down arrow (v ) Scroll down one line. Left arrow (< - ) Scroll left one column. Right arrow (- > ) 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. /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 6.2 on node KRYPTN 14-DEC-1994 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 GAWAIN CUR 6 4 14045 0 00:02:03.24 20032 397 274016D5 GAHERIS LEF 6 427 0 00:00:09.28 5275 1384 27401ED6 knight_1 HIB 5 935 0 00:00:10.17 3029 2204 S 274012D7 BATCH_689 LEF 4 49216 0 00:14:18.36 7021 3470 B 274032D9 DECW$MAIL LEF 4 2626 0 00:00:51.19 4328 3087 B 274018E3 SERVER_0021 LEF 6 519 0 00:00:07.07 1500 389 N 274016E8 NMAIL_0008 HIB 4 10955 0 00:00:55.73 5652 151 274034EA MORDRED LEF 4 2132 0 00:00:23.85 5318 452 274022EB S. Whiplash CUR 6 4 492 0 00:00:12.15 5181 459 274018EF DwMail LEF 5 121386 0 00:28:00.97 7233 4094 27401AF0 EMACS$RTA43 LEF 4 14727 0 00:03:56.54 8411 4224 S 27400CF4 TRISTRAM HIB 5 25104 0 00:06:07.76 37407 1923 274020F5 Morgan LEF 7 14726 0 00:02:10.74 34262 1669 27400CF6 mr. mike LEF 9 40637 0 00:05:15.63 18454 463 The SHOW SYSTEM command in this example displays all processes on the system. The information in this example includes the following: o Process identification (PID) code-A 32-bit binary value that uniquely identifies a process. o Process name-A 1- to 15-character string used to identify a process. o Process state-The activity level of the process, such as COM (computing), HIB (hibernation), LEF (local event flag) wait, or CUR (if the process is current). If a multiprocessing environment exists, the display shows the CPU ID of the processor on which any current process is executing. Note that the SHOW SYSTEM command examines the processes on the system without stopping activity on the system. In this example process information changed during the time that the SHOW SYSTEM command collected the data to be displayed. As a result, this display includes two processes, named GAWAIN and S. Whiplash, with the state CUR on the same CPU, CPU ID 6 in the example. o Current priority-The priority level assigned to the process (the higher the number, the higher the priority). o Total process I/O count-The number of I/O operations involved in executing the process. This consists of both the direct I/O count and the buffered I/O count. o Charged CPU time-The amount of CPU time that a process has used thus far. o Number of page faults-The number of exceptions generated by references to pages that are not in the process's working set. o 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 V6.2 on node ALPES 14-DEC-1994 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 V6.2 on node EON 14-DEC-1994 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 V6.2 on node AAAAAA MAY 12, 1995 10:29 AM Uptime 3 16:37:39 DEC 3000 Model 500 OpenVMS V6.2 on node BBBBBB MAY 12, 1995 10:29 AM Uptime 3 12:42:56 DEC 4000 Model 610 OpenVMS V5.5-2 on node CCCCCC MAY 12, 1995 10:29 AM Uptime 3 16:26:52 MicroVAX 3400 Series OpenVMS V6.1 on node DDDDDD MAY 12, 1995 10:29 AM Uptime 3 16:41:35 DEC 4000 Model 610 OpenVMS V6.1 on node EEEEEE MAY 12, 1995 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 V6.2 on node AAAAAA MAY 12, 1995 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 SMITH 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 V6.2 on node AAAAAA MAY 12, 1995 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=SMITH OpenVMS V6.2 on node AAAAAA MAY 12, 1995 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 SMITH 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 SMITH. 9.$ SHOW SYSTEM/STATE=L* OpenVMS V6.2 on node AAAAAA MAY 12, 1995 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 SMITH 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. 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: SMITH 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 following example). 3.$ SHOW TERMINAL/FULL Terminal: _RTA1: Device_Type: VT300_Series Owner: _RTA1: Username: SMITH Remote Port Info: NODE12::SMITH 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 14-DEC-1994 00:03:45 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 DBA1: $ DEFINE/GROUP DISK DBA2: $ SHOW TRANSLATION DISK DISK = DBA1:(LNM$PROCESS_TABLE) The DEFINE commands in this example place entries for the logical name DISK in both the process and group logical name tables. Then, the SHOW TRANSLATION command shows the translation associated with the logical name DISK. By default, the process, job, group, and system tables are searched (in that order). The first match found is displayed. The logical name DISK from the process table (LNM$PROCESS_TABLE) is displayed because it is found before the name DISK in the group table. 3.$ RUN ORION <Ctrl/Y> $ SHOW TRANSLATION TERMINAL TERMINAL = _TTT3: (LNM$PROCESS_TABLE) $ CONTINUE The RUN command in this example executes the image ORION.EXE. After the Ctrl/Y function interrupts the image, the SHOW TRANSLATION command displays a logical name assignment. The CONTINUE command resumes the execution of the image. 4.$ SHOW TRANSLATION/TABLE=LNM$SYSTEM USER USER = "DBA2:" (LNM$SYSTEM_TABLE) The SHOW TRANSLATION command in this example displays the translation for the logical name USER. Because a table name is specified, the SHOW TRANSLATION command does not use the default search order. Only the specified table, LNM$SYSTEM, is searched. LNM$SYSTEM is the system logical name table. 5.$ DEFINE/TABLE=LNM$PROCESS_DIRECTORY MYPROC - _$ TEST_TABLE, LNM$PROCESS $ SHOW TRANSLATION/TABLE=MYPROC FILER FILER = "[SMITH.FILER]" (TEST_TABLE) In this example, MYPROC defines a list of logical name tables that you want searched. It asks the system to first search TEST_TABLE (a user-defined table) and then to search LNM$PROCESS (the process logical name table). MYPROC is stored in LNM$PROCESS_DIRECTORY, the process directory table. When you enter the SHOW TRANSLATION command to find FILER in the MYPROC table, the tables TEST_TABLE and LNM$PROCESS are searched, in that order. The first match found is displayed. 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] /NOHIGHLIGHT (default) 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 (^ ), Ctrl/B Scroll up one line. Down arrow (v ) Scroll down one line. Left arrow (< - ) Scroll left one column. Right arrow (- > ) 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 MAY 12, 1995 10:37 AM Total number of users = 3, number of processes = 14 Username Node Interactive Subprocess Batch MJONES BBBBBB 1 MJONES XXXXXX 4 2 JOHNSONL AAAAAA 1 4 SMITH 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 MJONES BBBBBB 1 MJONES XXXXXX 4 2 JOHNSONL AAAAAA 1 4 SMITH 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 MAY 12, 1995 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 JUNE 9, 1995 02:23 PM Total number of users = 3, number of processes = 3 Username Node Process Name PID Terminal DJONES AAAAAA Aaaaaa_fta2: 2180012D FTA2: MJOHNSON AAAAAA MJOHNSON 2180011E RTA1: (JJJJJ::MJOHNSON) SMITH AAAAAA SMITH 2180011A FTA1: <LOGIN> 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 <LOGIN> indicates that someone is in the process of logging in. 5.$ SHOW USERS /NODE=(AAAAAA,BBBBBB,MMMMMM) OpenVMS User Processes at JUNE 9, 1995 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) DJOHNSON AAAAAA Aaaaaa_fta2: 2180012D FTA2: DJOHNSON MMMMMM Mmmmmm_fta1: 2020013E FTA1: DJOHNSON MMMMMM Mmmmmm_rta3: 20200184 RTA3: (DDRSND::DJOHNSON) JONES AAAAAA JONES 2180011E RTA1: (IVOK::JONES) SMITH AAAAAA SMITH 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 that 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 that 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]
Software development, photography, jokes, ....
Hosting Favorites |
| ANU Internet Services |
| Netim |
| GoDaddy |
| XEL Media |
Blogroll |
| Bomenstichting |
| Google Translate |
| PHP |
| MySQL |
| jQuery |
| jQuery UI |
| YourHead Stacks API |
| Favicon Generator. |
| Password Generator. |
| Check HTTPS problems |
Tweets by MrMacvos
Marc's Place
On this website, Google Analytics is used to track visitor statistics. These are anonymised data about the number of visitors, which pages they visit on this site, from which regions they visit, which web browsers they use, etc.. You will also see non-personalised ads via Google AdSense. Cookies from Paddle or Paypal are placed when you click on a 'Buy now!' or 'Donate!' button, and possible cookies from Disqus when you use that system to comment on one or more blogposts.
Privacy Statement