 |
HP OpenVMS DCL Dictionary
HP OpenVMS DCL Dictionary
SHOW RMS_DEFAULT
Displays the current default values for the multiblock count, the
multibuffer count, the network transfer size, the prolog level, the
extend quantity, and the query lock option.
Format
SHOW RMS_DEFAULT
Parameters
None.
Description
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).
Qualifier
/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.
Example
|
$ SHOW RMS_DEFAULT
MULTI- | MULTIBUFFER COUNTS | NETWORK
BLOCK | Indexed Relative Sequential | BLOCK
COUNT | Disk Magtape Unit Record | COUNT
Process 0 | 0 0 0 0 0 | 0
System 16 | 0 0 0 0 0 | 8
Prolog Extend Quantity VCC_DFW QUERY_LOCK
Process 0 0 0 System
System 0 0 0 Enabled
CONTENTION_POLICY
Process System
System Never
|
The SHOW RMS_DEFAULT command in this example shows a system multiblock
count of 16 and a network block count of 8. These are typical values.
Note that the placeholder, VCC_DFW, is currently reserved for use by HP.
SHOW SECURITY
Displays the name, class, and profile of a protected object.
Format
SHOW SECURITY object-name
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.
Description
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.
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[=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).
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 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.
SHOW SERVER
Displays information about the ACME and Registry servers.
Requires the SYSPRV privilege.
Format
SHOW SERVER server-name
Parameter
server-name
Valid values are: ACME_SERVER and REGISTRY_SERVER.
Description
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.
Qualifiers
/AGENT=(agent)
/NOAGENT (default)
The /AGENT and /NOAGENT qualifiers are supported by the ACME server.
ACME Server
Displays ACME agent information.
/BRIEF (default)
The /BRIEF qualifier is supported by the ACME server.
ACME Server
Displays server and ACME agent summary information.
/CLUSTER
The /CLUSTER qualifier is supported by the ACME and Registry servers.
ACME Server
Executes commands on all cluster members.
Registry Server
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.
ACME Server
Displays complete server and ACME agent information.
/MASTER
The /MASTER qualifier is supported by the Registry server.
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.
ACME Server
Executes command on specified cluster member.
Registry Server
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.
ACME Server
Displays information, one screen at a time.
/SERVER
/NOSERVER (default)
The /SERVER and /NOSERVER qualifiers are supported by the ACME server.
ACME Server
Displays ACME server information.
Examples
| #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)
SHOW SHADOW
Displays the status of a specified shadow set on the system.
If no qualifiers are specified, a summary of the device is displayed.
Format
SHOW SHADOW [DSAnnnn :]
Parameter
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.
Qualifiers
/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.
Examples
| #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.
SHOW STATUS
Displays the current status of your process.
Format
SHOW STATUS
Parameters
None.
Description
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.)
Example
|
$ SHOW STATUS
Status on 14-DEC-2001 12:56:48.68 Elapsed CPU : 0 00:00:55.02
Buff. I/O : 5117 Cur. ws. : 300 Open files : 1
Dir. I/O : 458 Phys. Mem. : 162 Page Faults : 8323
|
The SHOW STATUS command in this example displays the current status of
your process.
SHOW SYMBOL
Displays the value of the specified symbol.
Format
SHOW SYMBOL [symbol-name]
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.
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.
|
Description
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.
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 (default)
/NOLOG
Controls whether the system generates an informational message if the
symbol value has been truncated. The value is truncated if it exceeds
255 characters.
Examples
| #1 |
$ SHOW SYMBOL PURGE
PURGE = "PURGE/KEEP=2"
|
The SHOW SYMBOL command in this example displays the current value of
the symbol name PURGE. The command interpreter first searches the local
symbol table for the current command level, then local symbol tables
for preceding command levels, and finally the global symbol table. The
single equal sign (=) following PURGE means it is a local symbol.
| #2 |
$ SHOW SYMBOL/GLOBAL/ALL
TIME == "SHOW TIME"
LOG == "@LOG"
$RESTART == "FALSE"
$SEVERITY == "1"
$STATUS == "%X00000001"
|
The SHOW SYMBOL command in this example displays all the symbols
defined in the global symbol table. Note that the symbols $RESTART,
$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.
|
