1 07/20/87  display_user_messages
  2 
  3 
  4 Syntax as a command:  display_user_messages {-control_args}
  5 
  6 
  7 Function:  This command displays entries in the user message table.
  8 Privileged processes such as the Initializer use this table to send
  9 information to user processes regarding operator warnings, inactivity
 10 bump warnings, login communication channel information.
 11 
 12 
 13 Control arguments:
 14 -brief, -bf
 15    prints brief information about selected entries in tabular form.
 16    (Default)
 17 -exclude_data STR,
 18 -exclude STR, -ex STR
 19    does not select entries whose interpreted message includes the
 20    string STR.
 21 -handle HANDLE, -hdl HANDLE
 22    selects entries with the given 24-digit, octal HANDLE.
 23 -long, -lg
 24    prints detailed information about selected entries.
 25 
 26 
 27 -match_data STR,
 28 -match STR
 29    selects entries whose interpreted message includes the string STR.
 30 -message_id MESSAGE_ID,
 31 -mid MESSAGE_ID
 32    selects the entry with the given 24-digit, octal MESSAGE_ID.
 33 -no_octal, -noc
 34    does not include an octal dump of the message in the display.
 35    (Default)
 36 -octal, -oc
 37    prints detailed information about selected entries, including an
 38    octal dump of the message.
 39 
 40 
 41 -source GROUP_ID, -sc GROUP_ID
 42    selects entries sent by a process matching GROUP_ID.  In general,
 43    the Initializer is the primary source of user messages.  See Notes
 44    below for the format of GROUP_ID.
 45 -source_id PROCESS_ID,
 46 -scid PROCESS_ID,
 47 -sid PROCESS_ID
 48    selects entries sent by the process having the given octal
 49    PROCESS_ID.
 50 -target GROUP_ID, -tgt GROUP_ID
 51    selects entries sent to a process matching GROUP_ID.  See Notes
 52    below for the format of GROUP_ID.
 53 
 54 
 55 -target_id PROCESS_ID,
 56 -tgtid PROCESS_ID, -tid PROCESS_ID,
 57 -process_id PROCESS_ID,
 58 -pid PROCESS_ID
 59    selects entries sent to the process having the given octal
 60    PROCESS_ID.
 61 
 62 
 63 Access required:  Access to the user_message_admin_ gate is required to
 64 use this command.
 65 
 66 
 67 Notes:  All entries are displayed if no selection arguments are given.
 68 
 69 The -source and -target GROUP_ID operand is given in one of the
 70 following formats:
 71 
 72           person_id.project_id.tag
 73           person_id.project_id
 74           person_id
 75 
 76 where any of the components can be omitted or given as an asterisk (*)
 77 to match all values in that component position.
 78 
 79 
 80 Examples:
 81 
 82 The following example shows the tabular form of brief output.
 83 
 84 ! dum
 85 
 86   SOURCE       TARGET  MESSAGE
 87   Initializer  GDixon  system message: AS warning
 88   Initializer  GDixon  com channel info
 89 
 90 
 91 The following example shows the itemized format of long output.
 92 
 93 ! dum -lg -match system
 94 
 95   Source name:    Initializer.SysDaemon.z  pid: 003000777777
 96   Target name:    GDixon.SysAdmin.a        pid: 005000021742    ring: 4
 97   Message handle: 770007700077000770007700 id: 000000115413402132146345
 98   Message time:   1987-06-07  21:56:42.947813 mst Sun
 99   Message length: 48 words
100   Message type:   system message: AS warning:
101 
102   ******** 06/07/87  2156.7 mst Sun
103   From Operator: The system is shutting down in 10 minutes.
104   ********