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.