SYSMANHELP.HLB  —  DUMP_PRIORITY, MODIFY

1  –  and

1.1  –  Integrity

    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.1.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.

1.1.2  –  Qualifiers

1.1.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.

1.1.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.

1.1.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.

1.1.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.

1.1.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.
Close Help