On Alpha and Integrity servers, modifies an entry in the System
Dump Priority registry file.
Format
DUMP_PRIORITY MODIFY process-name /UIC=uic
[/NEWUIC=newuic][/WILD_CARD]
1 – Parameter
process-name
The exact name of the process. If the process name is mixed-case
or includes spaces or any other nonstandard OpenVMS characters,
you must enclose the process name in double quotes; for example,
"My Process". Also, when you enter a DUMP_PRIORITY MODIFY
command, be sure to enter the process name exactly as it is
displayed when you enter a DUMP_PRIORITY LIST command, because
the system searches for that process name to find the entry to
modify.
If you attempt to modify an existing entry where the modification
can result in a duplicate, the system displays the following
message: "SMI-I-SDPDUPIGN, duplicate record creation ignored."
The existing record is not removed.
2 – Qualifiers
2.1 /INFORMATIONAL
/INFORMATIONAL (default)
/NOINFORMATIONAL
On Alpha and Integrity servers, allows you to control the output
of informational messages, for example, in command procedures.
These qualifiers allow you to suppress or reinstate the display
of informational messages.
Suppressing messages can also be useful when you are running in a
software installation environment and want to avoid the display
of informational messages. The default is /INFORMATIONAL.
2.2 /UIC
Specifies the UIC of the entry in the registry that you want
to modify. The UIC and process name together make the entry
unique. Specify the UIC as it is displayed when you enter the
DUMP_PRIORITY LIST command.
2.3 /NEWUIC
Modifies the UIC of an entry that you specify by its process name
and current UIC. You can specify the /NEWUIC with an octal number
(for example, [377,377]) or in the identifier form (for example,
[SYSTEM] or [VMS,USER]).
Wildcards are allowed as follows:
Wildcard
Example Description
/UIC = [*] To select processes with the specified name in any
UIC.
/UIC = To select processes with the specified name in the
[group,*] group called "group".
/UIC = To select processes with the specified name in
[100,*] group 100>.
NOTE
You cannot use wildcards within identifier names or within
UIC numbers. For example, /UIC=[USER*,*] or /UIC=[17*,100]
are not allowed.
2.4 /WILD_CARD
/WILD_CARD
/NOWILD_CARD
The /WILD_CARD qualifier, used together with the MODIFY
command, modifies the wildcard setting on the entry that you are
modifying. If you omit /WILD_CARD, the current wildcard setting
is retained.
3 – Example
SYSMAN> DUMP_PRIORITY LIST
%SYSMAN-I-OUTPUT, command execution on node VMS73
Process name UIC Wild Card
MSCP* [SYSTEM] Y
NETACP [SYSTEM] N
SYSMAN> DUMP_
PRIORITY MODIFY "MSCP*"/UIC=[SYSTEM]/NEWUIC=[TEST]/NOWILD_CARD 1
SYSMAN> DUMP_PRIORITY LIST
%SYSMAN-I-OUTPUT, command execution on node VMS73
Process name UIC Wild Card
MSCP* [TEST] N
NETACP [SYSTEM] N
SYSMAN> DUMP_PRIORITY MODIFY "MSCP*"/UIC=[TEST]/NEWUIC=[*] 2
SYSMAN> DUMP_PRIORITY LIST
%SYSMAN-I-OUTPUT, command execution on node VMS73
Process name UIC Wild Card
MSCP* [*] N
NETACP [SYSTEM] N
SYSMAN> DUMP_PRIORITY MODIFY "MSCP*"/UIC=[*]/WILD_CARD 3
%SYSMAN-I-OUTPUT, command execution on node VMS73
Process name UIC Wild Card
MSCP* [*] Y
NETACP [SYSTEM] N
Refer to the numbers at the end of the DUMP_PRIORITY MODIFY
command lines in the example, which correspond to the numbered
explanations that follow. (The DUMP_PRIORITY LIST command,
after each MODIFY command, displays the results of the
modifications in the System Dump Priority registry.)
1 The first DUMP_PRIORITY MODIFY command modifies the MSCP*
entry with the current UIC [SYSTEM] the new UIC [TEST]. It
also changes the /WILD_CARD flag to /NOWILD_CARD. If the
System Dump Priority registry is then loaded into memory,
BUGCHECK will not treat the asterisk (*) in the process name
as a wildcard, but rather, will do an exact character match
of MSCP*.
2 The second DUMP_PRIORITY MODIFY command modifies only
the UIC of the entry to [*]. Omitting the /[NO]WILD_CARD
qualifier will leave the current setting unchanged.
3 The third DUMP_PRIORITY MODIFY command modifies only the
process name wildcarding flag with the /WILD_CARD qualifier.