| Previous | Contents | Index |
The keyword can be one of the following:
| Keyword | Meaning |
|---|---|
| NODE | Node data items |
| LINK | Link data items |
| FACILITY | Facility data items |
| PROCESS | Process data items |
| PARTITION | Partition data items |
| FE_TRANSACTION | Frontend transaction data items |
| TR_TRANSACTION | Backend transaction data items |
| BE_TRANSACTION | Router transaction data items |
The keyword can be one of the following:
| Keyword | Meaning |
|---|---|
| NODE | Node data items |
| LINK | Link data items |
| FACILITY | Facility data items |
| PROCESS | Process data items |
| PARTITION | Partition data items |
| FE_TRANSACTION | Frontend transaction data items |
| TR_TRANSACTION | Backend transaction data items |
| BE_TRANSACTION | Router transaction data items |
Use the MONITOR/RESUME command to reset average, maximum or minimum values.
See Section A.1 for examples of how to use the DISPLAY BAR command.
Display a number in a monitor picture.
DISPLAY NUMERIC expression
| Command Qualifiers | Defaults |
|---|---|
| /AVERAGE=(keyword,...) | /none |
| /BELL=Boolean-expression | /NOBELL |
| /BLANK=Boolean-expression | /NOBLANK |
| /BLINK=Boolean-expression | /NOBLINK |
| /BOLD=Boolean-expression | /NOBOLD |
| /DAMPING=damping-factor | /NODAMPING |
| /DECIMALS=decimal-places | /DECIMALS=0 |
| /LABEL=text | /NOLABEL |
| /RATE=interval | /NORATE |
| /REVERSE=Boolean-expression | /NOREVERSE |
| /ROWS=nr-rows | /ROWS=1 |
| /SELECT=Boolean-expression | /NOSELECT |
| /SEPARATE=(keyword,...) | /none |
| /TOTALIZE=(keyword,...) | /none |
| /UNDERLINE=Boolean-expression | /NOUNDERLINE |
| /VALUE=value-type | /VALUE=CURRENT |
| /WIDTH=field-width | /WIDTH=1 |
| /X=column | Column of previous item |
| /Y=row | Next free row |
The DISPLAY NUMERIC command displays the specified expression as a number in a monitor picture. It can be used within a monitor file or issued at the RTR prompt when interactively defining a monitor picture for use in a subsequent MONITOR command.
Note that the introduction of the /SEPARATE, /TOTALIZE and /AVERAGE qualifiers has superseded the qualifiers /FACILITY, /LINK, /PARTITION, /NODE and /PROCESS. These superseded qualifiers are no longer described here, however they are still supported.
expression
Specifies the quantity to be displayed. Expression can either be the name of a single data item or an expression combining several items using simple arithmetic operations and constants. In the latter case, EXPRESSION must be in quotes.
/AVERAGE=(keyword,...)
/NOAVERAGE
Specifies that the items being monitored relating to keyword are displayed as an average. This allows a number of items to be averaged in one qualifier.The keyword can be one of the following:
Keyword Meaning NODE Node data items LINK Link data items FACILITY Facility data items PROCESS Process data items PARTITION Partition data items FE_TRANSACTION Frontend transaction data items TR_TRANSACTION Backend transaction data items BE_TRANSACTION Router transaction data items /BELL[=Boolean-expression]
/NOBELL (D)
Sends a bell character to the terminal if Boolean-expression evaluates to True (non-zero)./BLANK[=Boolean-expression]
/NOBLANK (D)
Specifies that the displayed value is replaced by blanks if Boolean-expression evaluates to True (non-zero)./BLINK[=Boolean-expression]
/NOBLINK (D)
Specifies that the displayed value blinks if Boolean-expression evaluates to True (non-zero)./BOLD[=Boolean-expression]
/NOBOLD (D)
Specifies that the item is displayed in high intensity if Boolean-expression evaluates to True (non-zero)./DAMPING[=damping-factor]
/NODAMPING (D)
Specifies that the value displayed is to fluctuate more slowly than the raw measured value. The default for damping-factor is one. Damping is only relevant if /VALUE=CURRENT./DECIMALS[=decimal-places]
/DECIMALS=0 (D)
Specifies the number of digits to appear after the decimal point when displaying a numeric. The default for decimal-places is zero, that is, numbers are displayed as integers./LABEL=text
/NOLABEL (D)
Specifies the text used to label the value being displayed. Symbols are substituted at display time. (See Section A.2, Substitution Symbols)./RATE[=interval]
/NORATE (D)
Specifies that the rate of change of the expression is to be displayed rather than the absolute value. When /RATE is used, interval specifies the time interval in seconds used to calculate the rate of change. This has no effect on the sampling, it simply allows the rate to be displayed in another unit. For example, displaying the start transaction counter with /RATE=60 results in transactions per minute being displayed instead of per second./REVERSE[=Boolean-expression]
/NOREVERSE (D)
Specifies that the item is displayed with the foreground and background visual attributes swapped if Boolean-expression evaluates to True (non-zero)./ROWS[=nr-rows]
/ROWS=1 (D)
Specifies how many rows are used to display the item. This is only meaningful if /SEPARATE is also specified. The default number of rows is one./SELECT[=Boolean-expression]
/NOSELECT (D)
Displays the item if Boolean-expression evaluates to True (non-zero)./SEPARATE=(keyword,...)
/NOSEPARATE
Specifies that the items being monitored relating to keyword are separated from each other and displayed as a list. This allows a number of items to be separated in one qualifier.The keyword can be one of the following:
Keyword Meaning NODE Node data items LINK Link data items FACILITY Facility data items PROCESS Process data items PARTITION Partition data items FE_TRANSACTION Frontend transaction data items TR_TRANSACTION Backend transaction data items BE_TRANSACTION Router transaction data items /TOTALIZE=(keyword,...)
/NOTOTALIZE
Specifies that the items being monitored relating to keyword are added together and displayed as a total.The keyword can be one of the following:
Keyword Meaning NODE Node data items LINK Link data items FACILITY Facility data items PROCESS Process data items PARTITION Partition data items FE_TRANSACTION Frontend transaction data items TR_TRANSACTION Backend transaction data items BE_TRANSACTION Router transaction data items /UNDERLINE[=Boolean-expression]
/NOUNDERLINE (D)
Specifies that the displayed value is underlined if Boolean-expression evaluates to True (non-zero)./VALUE[=value-type]
/VALUE=CURRENT (D)
Specifies how the value is processed before being displayed. Value-type can be one of the following keywords:
- CURRENT - (default) display the current value of expression
- AVERAGE - display the average value of expression since the MONITOR command was issued.
- MINIMUM - display the minimum value of expression since the MONITOR command was issued.
- MAXIMUM - display the maximum value of expression since the MONITOR command was issued.
Use the MONITOR/RESUME command to reset average, maximum or minimum values.
/WIDTH[=field-width]
/WIDTH=1 (D)
Specifies the width (in number of characters) to display a numeric. If more characters than width are required then the number will be shifted to the right. No data will be lost but columns of numbers will no longer line up. If /WIDTH=1 is specified (the default) then numbers are displayed left justified./X[=column]
/X=previous-column (D)
Specifies the screen column where the item is displayed (the leftmost column is 1). By default, items are displayed in the same column as defined by the previous DISPLAY command./Y[=row]
/Y=next-free-row (D)
Specifies the screen row where the item is displayed (top row is 1). By default, items are displayed on the next free row after the item defined by the previous DISPLAY command.
See Section A.1 for examples of how to use the DISPLAY NUMERIC command.
Display a string in a monitor picture.
DISPLAY STRING expression
| Command Qualifiers | Defaults |
|---|---|
| /AVERAGE=(keyword,...) | /none |
| /BELL=Boolean-expression | /NOBELL |
| /BLANK=Boolean-expression | /NOBLANK |
| /BLINK=Boolean-expression | /NOBLINK |
| /BOLD=Boolean-expression | /BOLD |
| /JUSTIFY=keyword | /JUSTIFY=LEFT |
| /LABEL=text | /NOLABEL |
| /REVERSE=Boolean-expression | /NOREVERSE |
| /ROWS=nr-rows | /ROWS=1 |
| /SELECT=Boolean-expression | /NOSELECT |
| /SEPARATE=(keyword,...) | /none |
| /TOTALIZE=(keyword,...) | /none |
| /UNDERLINE=Boolean-expression | /NOUNDERLINE |
| /WIDTH=field-width | /WIDTH=0 |
| /X=column | Column of previous item |
| /Y=row | Next free row |
The DISPLAY STRING command displays the specified expression as an alphanumeric in a monitor picture. It can be used within a monitor file or issued at the RTR prompt when interactively defining a monitor picture for use in a subsequent MONITOR command.
Note that the introduction of the /SEPARATE, /TOTALIZE and /AVERAGE qualifiers has superseded the qualifiers /FACILITY, /LINK, /PARTITION, /NODE and /PROCESS. These superseded qualifiers are no longer described here, however they are still supported.
expression
The string you want to display; enclose it in quote marks. Expression can be the name of a single RTR data item.
/AVERAGE=(keyword,...)
/NOAVERAGE
Specifies that the items being monitored relating to keyword are displayed as an average. This allows a number of items to be averaged in one qualifier.The keyword can be one of the following:
Keyword Meaning NODE Node data items LINK Link data items FACILITY Facility data items PROCESS Process data items PARTITION Partition data items FE_TRANSACTION Frontend transaction data items TR_TRANSACTION Backend transaction data items BE_TRANSACTION Router transaction data items /BLANK[=Boolean-expression]
/NOBLANK (D)
Specifies that the displayed value is replaced by blanks if Boolean-expression evaluates to True (non-zero)./BLINK[=Boolean-expression]
/NOBLINK (D)
Specifies that the displayed value blinks if Boolean-expression evaluates to True (non-zero)./BOLD[=Boolean-expression]
/NOBOLD (D)
Specifies that the item is displayed in high intensity if Boolean-expression evaluates to True (non-zero)./JUSTIFY=keyword
/JUSTIFY=LEFT (D)
Specifies whether justification is left, right or centered in the available width. (The keyword may be LEFT, RIGHT or CENTERED.) The /WIDTH qualifier must be greater than zero for the /JUSTIFY to operate. If the available width is smaller than the string, truncation will occur./LABEL=text
/NOLABEL (D)
Specifies the text used to label the value being displayed. Symbols are substituted at display time. (See Section A.2, Substitution Symbols)./REVERSE[=Boolean-expression]
/NOREVERSE (D)
Specifies that the item is displayed with the foreground and background visual attributes swapped if Boolean-expression evaluates to True (non-zero)./ROWS[=nr-rows]
/ROWS=1 (D)
Specifies how many rows are used to display the item. This is only meaningful if /SEPARATE is also specified. The default number of rows is one./SELECT[=Boolean-expression]
/NOSELECT (D)
Displays the item if Boolean-expression evaluates to True (non-zero)./SEPARATE=(keyword,...)
/NOSEPARATE
Specifies that the items being monitored relating to keyword are separated from each other and displayed as a list. This allows a number of items to be separated in one qualifier.The keyword can be one of the following:
Keyword Meaning NODE Node data items LINK Link data items FACILITY Facility data items PROCESS Process data items PARTITION Partition data items FE_TRANSACTION Frontend transaction data items TR_TRANSACTION Backend transaction data items BE_TRANSACTION Router transaction data items /TOTALIZE=(keyword,...)
/NOTOTALIZE
Specifies that the items being monitored relating to keyword are added together and displayed as a total.The keyword can be one of the following:
Keyword Meaning NODE Node data items LINK Link data items FACILITY Facility data items PROCESS Process data items PARTITION Partition data items FE_TRANSACTION Frontend transaction data items TR_TRANSACTION Backend transaction data items BE_TRANSACTION Router transaction data items /UNDERLINE[=Boolean-expression]
/NOUNDERLINE (D)
Specifies that the displayed value is underlined if Boolean-expression evaluates to True (non-zero)./WIDTH[=field-width]
/WIDTH=0 (D)
Specifies the width (in number of characters) to display the string. If /WIDTH=0 is specified (the default) then the string is displayed as entered. If the width is greater than zero, then the /JUSTIFY qualifier is activated./X[=column]
/X=previous-column (D)
Specifies the screen column where the item is displayed (the leftmost column is 1). By default, items are displayed in the same column as defined by the previous DISPLAY command./Y[=row]
/Y=next-free-row (D)
Specifies the screen row where the item is displayed (top row is 1). By default, items are displayed on the next free row after the item defined by the previous DISPLAY command.
See Section A.1 for examples of how to use the DISPLAY STRING command.
| Previous | Next | Contents | Index |