|
HP OpenVMS systems documentation |
Previous | Contents | Index |
Displays the current default values for the multiblock count, the multibuffer count, the network transfer size, the prolog level, the extend quantity, and the query lock option.
SHOW RMS_DEFAULT
None.
The SHOW RMS_DEFAULT command displays information that OpenVMS Record Management Services (RMS) uses for file operations including the default values for the multibuffer count, the multiblock count, the network block count, the prolog level, the extend quantity, and the query lock option. The command provides these values at both the current process level and at the system level.The SHOW RMS_DEFAULT command lists the multibuffer count values for each of the file types, including the values for the three classes of sequential files (disk, magtape and unit record).
/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.
$ SHOW RMS_DEFAULT MULTI- | MULTIBUFFER COUNTS | NETWORK BLOCK | Indexed Relative Sequential | BLOCK COUNT | Disk Magtape Unit Record | COUNT Process 0 | 0 0 0 0 0 | 0 System 16 | 0 0 0 0 0 | 8 Prolog Extend Quantity VCC_DFW QUERY_LOCK Process 0 0 0 System System 0 0 0 Enabled CONTENTION_POLICY Process System System Never |
The SHOW RMS_DEFAULT command in this example shows a system multiblock count of 16 and a network block count of 8. These are typical values. Note that the placeholder, VCC_DFW, is currently reserved for use by HP.
Displays the name, class, and profile of a protected object.
SHOW SECURITY object-name
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.
The SHOW SECURITY command displays the name, class, and profile of a protected object. A profile includes an access control list (ACL), the protection code, and the owner of a protected object. For SECURITY_CLASS objects, SHOW SECURITY displays all the template profiles, which are the basis for profiles of new objects.The /CLASS qualifier identifies the class object-name is a member of. If the class is DEVICE and the object is a disk device on which a volume is mounted as a Files-11 (rather than foreign) volume, then both the device and the volume profiles are displayed.
All qualifiers other than /CLASS apply only to files.
For a description of protected objects, refer to the HP OpenVMS Guide to System Security.
/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[=time]
Selects only those files dated prior to the specified time. You can specify time as absolute time, as a combination of absolute and delta times, or as one of the following keywords: BOOT, LOGIN, TODAY (default), TOMORROW, or YESTERDAY. Specify the /CREATED or the /MODIFIED qualifier to indicate the time attribute to be used as the basis for selection. The /CREATED qualifier is the default.For complete information on specifying time values, refer to the OpenVMS User's Manual or the online help topic DCL_Tips (subtopic Date_Time).
/BY_OWNER[=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 HP OpenVMS Guide to System Security.
/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
COMMON_EVENT_CLUSTER
DEVICE
FILE
GROUP_GLOBAL_SECTION
ICC_ASSOCIATION LOGICAL_NAME_TABLE
QUEUE
RESOURCE_DOMAIN
SECURITY_CLASS
SYSTEM_GLOBAL_SECTION
VOLUME/CREATED
Modifies the time value specified with the /BEFORE or the /SINCE qualifier. The /CREATED qualifier selects files according to the date they were created (rather than by the backup, expiration, or modification date). By default, SHOW SECURITY selects files according to their creation date./EXCLUDE=(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[=time]
Selects only those files dated on or after the specified time. You can specify time as absolute time, as a combination of absolute and delta times, or as one of the following keywords: BOOT, LOGIN, TODAY (default), TOMORROW, or YESTERDAY. Specify the /CREATED or the /MODIFIED qualifier to indicate the time attribute to be used as the basis for selection. The /CREATED qualifier is the default.For complete information on specifying time values, see the OpenVMS User's Manual or the online help topic DCL_Tips (subtopic Date_Time).
#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 RES17SEP that is mounted on it. The subsequent SHOW DEVICE command confirms that the volume is mounted on the device $99$DUA22.
#3 |
---|
$ SHOW SECURITY LOGICAL_NAME_TABLE /CLASS=SECURITY_CLASS LOGICAL_NAME_TABLE object of class SECURITY_CLASS Owner: [SYSTEM] Protection: (System: RWCD, Owner: RWCD, Group: R, World: R) Access Control List: <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.
Displays information about the ACME and Registry servers.Requires the SYSPRV privilege.
SHOW SERVER server-name
server-name
Valid values are: ACME_SERVER and REGISTRY_SERVER.
The SHOW SERVER command provides a system manager with the ability to display information about the ACME and Registry servers.For additional information, see the SET SERVER command.
/AGENT=(agent)
/NOAGENT (default)
The /AGENT and /NOAGENT qualifiers are supported by the ACME server.Displays ACME agent information.
/BRIEF (default)
The /BRIEF qualifier is supported by the ACME server.Displays server and ACME agent summary information.
/CLUSTER
The /CLUSTER qualifier is supported by the ACME and Registry servers.Executes commands on all cluster members.
Displays information about each server in the cluster.
Cannot be used with the /MASTER or /NODE qualifiers.
/FULL
The /FULL qualifier is supported by the ACME server.Displays complete server and ACME agent information.
/MASTER
The /MASTER qualifier is supported by the Registry server.Displays information from the Registry master server only. Requires the SYSLCK privilege.
Cannot be used with the /CLUSTER or /NODE qualifiers.
/NODE=(node-name[,...])
The /NODE qualifier is supported by the ACME and Registry servers.Executes command on specified cluster member.
Displays information on the Registry servers on the specified nodes in the order they are entered. The node names must be within the current cluster.
Cannot be used with the /CLUSTER or /MASTER qualifiers.
/OUTPUT=filespec
Sends the output information to a specified file. Valid on ACME and Registry servers./PAGE
The /PAGE qualifier is supported by the ACME server.Displays information, one screen at a time.
/SERVER
/NOSERVER (default)
The /SERVER and /NOSERVER qualifiers are supported by the ACME server.Displays ACME server information.
#1 |
---|
$ SHOW SERVER REGISTRY_SERVER |
This command displays information about the node you are on:
Registry Information on node OPNEYE 29-AUG-2001 16:37:26.52 Uptime 20 04:10:55
#2 |
---|
$ SHOW SERVER REGISTRY_SERVER/MASTER |
This command displays information about the Registry master server:
Registry Master Server is running on OPNEYE, Pid: 20A0021A
#3 |
---|
$ SHOW SERVER ACME/BRIEF ACME Information on node TSINOD 31-OCT-2001 10:08:12.32 Uptime 000:05:45 ACME Server id: 5 State: Processing New Requests (1) Agents Loaded: 2 Active: 2 (2) Thread Maximum: 4 Count: 4 Request Maximum: 8 Count: 0 ACME Agent id: 1 State: Active (3) Name: "VMS" (4) Image: "DISK$AXP_721:[VMS$COMMON.SYSLIB]VMS$VMS_ACMESHR.EXE;1" (5) Identification: "VMS ACME built 3-JUN-1999" (6) Information: "No requests completed since the last startup" (7) Domain of Interpretation: Yes (8) Execution Order: 1 (9) ACME Agent id: 2 State: Active Name: "MSV1_0" Image: "DISK$AXP_721:[SYS0.SYSLIB]PWRK$MSV1_0_ACMESHR.EXE;2" Identification: "MSV1_0 ACME X-22" Information: "MSV1_0 ready to process requests." Domain of Interpretation: Yes Execution Order: 2 |
This example shows the output for SHOW SERVER ACME/BRIEF on an Alpha system. Following are the item descriptions:
Server state
Server agent/thread/request-slot statistics
Agent state
Agent name
Agent file-specification
Agent-defined identifcation string (static)
Agent-defined information string (dynamic)
Domain-of-interpretation (DOI) indicator
Execution order (the order in which agents are called for each request)
Displays the status of a specified shadow set on the system.If no qualifiers are specified, a summary of the device is displayed.
SHOW SHADOW [DSAnnnn :]
DSAnnnn:
Specifies the virtual unit name of the shadow set for which information is to be displayed.If no virtual unit is specified, information is displayed for all mounted shadow sets.
/ACTIVE
Returns one of three possible states:
- Merge or Copy is not required
- Copy is in progress on node nnnnx at LBN xxxx
- Merge is in progress on node nnnnx at LBN xxxx
LBN is a logical block number on the disk where the operation is in progress. Merge and copy operations work sequentially through a disk from LBN 0 to the last block on the disk. The LBN can provide an idea of how far the operation has progressed through the disk.
SHOW DEVICE DSAnnnn: will display the progress as a percentage of completion.
/COPY
Returns one of three possible states:
- Copy is not required
- Copy is pending
- Copy is in progress on node nnnnx at LBN xxxx
/MERGE
Returns one of three possible states:
- Merge is not required
- Merge is pending
- Merge is in progress on node nnnnx at LBN xxxx
/OUTPUT[=filespec]
Outputs any messages to the specified file.
#1 |
---|
$ SHOW SHADOW DSA716: _DSA716: TST716 Virtual Unit SCB Status: 0001 - normal Local Virtual Unit Status: 00000010 - Local Read Total Devices 2 VU_UCB 810419C0 Source Members 2 SCB LBN 000009C8 Act Copy Target 0 Generation 00A15F90 Act Merge Target 0 Number EDA9D786 Last Read Index 0 VU Site Value 5 Master Mbr Index 0 VU Timeout Value 3600 Copy Hotblocks 0 Copy Collisions 0 SCP Merge Repair Cnt 0 APP Merge Repair Cnt 0 Device $252$DUA716 Master Member Index 0 Status 000000A0 src,valid Ext. Member Status 00 Read Cost 42 Site 5 Member Timeout 120 UCB 8116FF80 Device $252$DUA1010 Index 1 Status 000000A0 src,valid Ext. Member Status 00 Read Cost 500 Site 3 Member Timeout 120 UCB 811DD500 |
This example displays status information for the shadow set on virtual unit DSA716:.
Note that the VU Site Value is 5, and the site value for device $252$DUA716 is also 5. Therefore, reads on this node will be read from the $252$DUA716 device.
#2 |
---|
$ SHOW SHADOW/COPY DSA716: Device Volume Name Status _DSA716: TST716 Copy is in progress on node CSGF2 at LBN 160908 |
In this example, a member has been added to the shadow set and a copy is in progress on node CSGF2; the copy operation is currently at logical block number 160908.
Displays the current status of your process.
SHOW STATUS
None.
The SHOW STATUS command verifies that your current process is running. The SHOW STATUS information can also indicate if the process is using an abnormal amount of CPU time, is opening too many files, or is accruing too many page faults. The information displayed includes the following:
- Current time and date
- Elapsed CPU time used by the current process
- Buffered I/O count
- Current working set size
- Open file count
- Direct I/O count
- Current amount of physical memory occupied
- Number of page faults
The information displayed by SHOW STATUS is similar to that displayed by the Ctrl/T function. (See the SET CONTROL command.)
$ SHOW STATUS Status on 14-DEC-2001 12:56:48.68 Elapsed CPU : 0 00:00:55.02 Buff. I/O : 5117 Cur. ws. : 300 Open files : 1 Dir. I/O : 458 Phys. Mem. : 162 Page Faults : 8323 |
The SHOW STATUS command in this example displays the current status of your process.
Displays the value of the specified symbol.
SHOW SYMBOL [symbol-name]
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.
Note
When you specify a wildcard character, the command searches only the local symbol table of the current command level and the global symbol table (as if you had specified /LOCAL/GLOBAL). You can search symbol tables of preceding command levels by symbol name, but not by wildcard.
The SHOW SYMBOL command searches for the specified symbol name in several places. First, it looks in the local symbol table of the current command level. Next, it searches the local symbol tables of preceding command levels (unless a wildcard was specified). Last, it searches the global symbol table. The SHOW SYMBOL command displays the first match it finds.The /LOCAL and /GLOBAL qualifiers override the search order.
/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 (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.
#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.
Previous | Next | Contents | Index |