Message dump

OpenUTM offers a message dump interface which is also supported by WebAdmin. There is therefore a tab on the property page of a UTM application or cluster which can be used to activate and control this function. This tab can be displayed via the 'Message Dump' function in the 'Functions' section on the primary page of a UTM application or UTM cluster.

The interface allows you to specify up to three different events which will trigger UTM to perform a diagnostic dump.

The following events can be monitored:

• Occurrence of a particular UTM message
  In this case up to three different message inserts can be defined which the function compares with predetermined values.

• Occurrence of a particular sign-on return code
• Occurrence of a particular RCCC code
• Occurrence of a particular RCDC code

The tab has the following input fields:

• 'Event'
  Combo box offering a choice of three possible dump events.
  The dump event selected here is displayed in the following input fields.

• 'Event Type'
  The type of event to be defined is specified here. The following types are available:

• • '<none>'
    This value indicates that the dump event is not defined and no further input is possible on the dialog page.

• • 'Message'
    A specific UTM message that is to trigger a diagnostic dump is defined.
    If this is selected, up to three message inserts can be defined in the bottom section.

• • 'Sign-Code'
    A specific sign-on return code that is to trigger a diagnostic dump is defined.

• • 'RCCC-Code'
    A specific RCCC code that is to trigger a diagnostic dump is defined.

• • 'RCDC-Code'
    A specific RCDC code that is to trigger a diagnostic dump is defined.

• 'Event'
  This field defines the event itself, i.e. either a specific UTM message ID (e.g. 'K065'), a sign-on return code (e.g. 'U04'), an RCCC code or an RCDC code.
  You can enter a maximum of four characters.

• 'Insert 1', 'Insert 2' and 'Insert 3'
  If the event type is 'Message', you can define here up to three different message inserts with which the generation of a diagnostic dump can be controlled more precisely when the specified UTM message occurs.
  The inserts must be specified in the format [<Index>] <Comparison> <Value> where the three parts signify the following:

• • <Index>
    This specifies the index of the respective message insert. The first insert has the index 1. The highest index that can be used is 20.

• • <Comparison>
    This specifies whether the insert must contain the value entered (equality) or not (inequality). The values 'EQ', '==' or '=' are permitted for equality, and 'NE', '!=', '<>' or '><' are permitted for inequality.

• • <Value>
    This is the value of the message insert to be monitored.
    You can enter as insert value either a number, a printable value or a hexadecimal value in the form X'<hexvalue>'. If a number entered is not to be interpreted as a number but as a printable value, then it must be entered in the form C'<value>'. Values may be a maximum of 32 characters long, and hexadecimal values can be up to 64 characters long (two characters correspond to one byte).

   If nothing is entered for an insert, then this insert is not defined.