Administration and Management in Legacy Desktop
Desktop Background Color
You can start several Desktop applications on a specific computer. To tell the difference between the applications and their respective views you can vary the background color of every Desktop. To change the Desktop application background color, set the Desktop property mz.gui.color.space.active.
The value can be any color of the following: blue, green, yellow, orange, red, dark blue, dark green, magenta, or dark red. For further information about Desktop properties, see Desktop Properties.
Dynamic Update
While a real-time workflow is being executed, you can change the value of the following parameters:
The Host and Port parameters of the TCP/IP agent
The NAS list of the Radius agent
To be able to dynamically update TCP/IP Host and Port parameters, you need to set them to either Default or Per Workflow in the Workflow Properties dialog box. See the figure The Workflow Table Tab in Workflow Table Tab.
To update, select Dynamic Update. On the title bar of the monitor dialog box, the text Dynamic Update followed by a number appears. It represents the number of times that you have updated the workflow configuration while running it, that is since the last time you started it.
Dynamic update
Folders
Folders enable the user to categorize configurations, and simplify their maintenance and operation. Folders can be created based on traffic type, decode for a specific network element, be based on geographic location, etc.
There is a system folder named Default. This folder cannot be renamed or removed.
Configuration Naming
Configuration names within a folder must be unique.
Some named items in the environment are used when constructing file names. To avoid potential conflicts in the file systems, converts the conflicting characters when constructing file names.
The following characters are allowed. Any other character results in a validation error.
a-z
A-Z
0-9
- (dash)
_ (underscore)
The system has an internal key for every configuration. This key is used to identify the configuration. Renaming a configuration does not change this key. The key is constructed using the system name and the date when the configuration was created. You can view the generated key by selecting the Show Properties option in the right-click menu in the Configuration Navigator, as well as in the Configuration Browser and Configuration Tracer.
Date and Time Format Codes
In various places, date formats are entered. The following list shows valid date and time format codes that can be combined with any characters that are not in the ranges of 'a'-'z' and 'A'-'Z'. For instance, characters such as ':', '.', ' ', '#' and '@' will appear in the resulting time even if they are not specified within single quotation marks.
The date syntax conforms to the Java class SimpleDateFormat. This section contains a summary only. For a full description see:
http://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html
Letter | Date or time component | Example |
|---|---|---|
G | Era designator | AD |
y | Year | 1996; 96 |
M | Month in year | July; Jul; 07 |
w | Week in year | 27 |
W | Week in month | 2 |
D | Day in year | 189 |
d | Day in month | 10 |
F | Day of week in month | 2 |
E | Day in week | Tuesday; Tue |
a | am/pm marker | PM |
H | Hour in day (0-23) | 0 |
k | Hour in day (1-24) | 24 |
K | Hour in am/pm (0-11) | 0 |
h | Hour in am/pm (1-12) | 12 |
m | Minute in hour | 30 |
s | Second in minute | 55 |
S | Millisecond | 978 |
z | Time zone | PST; GMT-08:00 |
Z | Time zone | -08:00 |
Example - Date and time patterns are interpreted in U.S. local time
The following examples show how date and time patterns are interpreted in U.S. local time. The example shows local date and time 2001-07-04 12:08:56 in the U.S. Pacific time zone.
Format | Example |
|---|---|
"yyyy.MM.dd G 'at' HH:mm:ss z" | 2001.07.04 AD at 12:08:56 PDT |
"EEE, MMM d, ''yy" | Wed, Jul 4, '01 |
"h:mm a" | 12:08 PM |
"hh 'o''clock' a, zzzz" | 12 o'clock PM, Pacific Daylight Time |
"K:mm a, z" | 0:08 PM, PDT |
"yyyyy.MMMMM.dd GGG hh:mm aaa" | 02001.July.04 AD 12:08 PM |
"EEE, d MMM yyyy HH:mm:ss Z" | Wed, 4 Jul 2001 12:08:56 -0700 |
"yyMMddHHmmssZ" | 010704120856-0700 |
Text Editor
At various places in the environment, editable text areas are available in order to enter APL code. To assist in writing the code, right-click anywhere in the text area to show a pop-up menu with available host functions.
Text Editor right-click menu
The menu has the following options:
Option | Description |
|---|---|
Font Size | Sets the font size. |
Cut | Moves the selected text to the clipboard. You can also press |
Copy | Copies the selected text to the clipboard. You can also press |
Paste | Pastes the contents of the clipboard into the place where the insertion point is. You can also press |
Select All | Selects all the text. You can also press |
Undo | Reverts your last action. You can also press |
Redo | Redoes the last action that you undid with Undo. You can also press |
Find/Replace... | Displays a dialog where you can search for text and, optionally, replace it. You can also press  Find/Replace dialog |
Quick Find | Searches the code for the highlighted text. You can also press |
Find Again | Repeats the search for last entered text in the Find/Replace dialog. You can also press |
Go to Line... | Opens the Go to Line dialog where you can enter which line in the code you want to go to. Click OK and you are redirected to the entered line. You can also press CTRL+L to perform this action. |
Show Definition | If you right-click a function in the code that is defined somewhere else and select this option, you are redirected to where the function is defined. If the function is defined within the same configuration, you jump to the line where the function is defined. If the function is defined in another configuration, the configuration opens and you jump directly to the line where the function is defined. You can also click a function and press Note!If you refer to an external function with the same name as a function within the current code, the Show Definition option will point to the function within the current code, while the external function is the one that is called during workflow execution. |
Show Usages | If you right-click a function where it is defined in the code and select this option, a dialog called Usage Viewer opens and displays a list of the Configurations that use the function. You can also select a function and press |
UDR Assistance... | Opens the UDR Internal Format Browser from which the UDR Fields can be inserted into the code area. You can also press |
MIM Assistance... | Opens the MIM Browser from which the available MIM Resources can be inserted into the code area. You can also press |
Import... | Imports the contents from an external text file into the editor. Note that the file has to reside on the host where the client is running. |
Export... | Exports the current contents into a new file to, for instance, edit in another text editor or use in another system. |
Use External Editor | Opens the editor specified by the Desktop property |
APL Help... | Opens the APL Reference Guide. |
APL Code Completion | Performs code completion on the current line. For more information about Code Completion, see APL Code Completion below. You can also press |
Indent | Adjusts the indentation of the code to make it more readable. You can also press |
Jump to Pair | Moves the cursor to the matching parenthesis or bracket. You can also press |
Toggle Comments | Adds or removes comment characters at the beginning of the current line or selection. You can also press CTRL+7 to perform this action. |
Surround With | Adds a code template that surrounds the current line or selection:
|
APL Code Completion
In order to make APL coding easier, the APL Code Completion feature helps you find and add APL functions and their respective syntax.
To access APL Code Completion, place the cursor where you want to add an APL function, press CTRL+SPACE and select the correct function. To reduce the number of hits, type the initial characters of the APL function. The characters to the left of the cursor are used as a filter.
APL Code Completion covers:
All installed APL functions.
Function blocks such as
beginBatchandconsume.Condition statements such as
whileandif.APL functions created by APL Code configurations.
APL functions created with the Development Toolkit.
APL Code Editor Outline
In order to make it easier to navigate in an APL code configuration, there is an Outline navigation panel to the right of the APL Code Editor.
The APL Code Editor Outline provides a view of all the blocks, variables, and methods in an APL code configuration and makes it possible to easily navigate between different types in the APL code. The entries in the navigation panel are automatically updated as you make valid entries in the APL Editor.
You can also filter what you want to display in the Outline navigation panel. You can search for a specific block, variable, or method using the free text field, or by selecting one of the quick filter buttons for different types:
Button | Description |
|---|---|
b | Click to display or hide the blocks within the APL code configuration displayed in the APL Code Editor. |
v | Click to display or hide the variables within the APL code configuration displayed in the APL Code Editor. |
m | Click to display or hide the methods within the APL code configuration displayed in the APL Code Editor. |
The Outline navigation panel can be hidden or made visible. By default, it is visible and all the elements are displayed. To hide or display the navigation panel, click the vertical Outline button to the right of the APL Code Editor.
APL Code Editor Outline navigation panel
Configuration List Editor
The Configuration List Editor appears in many Agent Configuration dialog boxes and usually looks like the example in the figure below, Configuration List Editor. This table enables you to select and list several entries that you want to include in a certain Configuration definition.
Configuration List Editor
Button | Description |
|---|---|
Add  | Click to open a dialog box where you can add an item to the Configuration list. |
Edit  | Select a row and click Edit. An Update dialog box opens and enables you to modify the data entry. |
Remove  | Select a row and click Remove. |
 | Select an entry from the Configuration list and click Up or Down to move it to an upper or lower position. |
Note!
To change the order of any of the appended rows from ascending to descending, click a column's heading. The new order is not saved for the next time you open this view.
UDR Browser
In places where one or many UDR types or UDR fields need to be selected, the UDR Browser is utilized. You access the UDR Internal Format Browser from the Analysis or Aggregation agents, by right-clicking in the APL Code area and selecting UDR Assistance...
The browser contains all UDR types available in the system:
UDR types created in the Ultra Format Editor. These include events and sessions for the Aggregation sub-system.
UDR types installed with the system.
For further information about UDR types and fields, see the Ultra Reference Guide.
UDR Internal Format Browser
Setting | Description |
|---|---|
UDR Types | List of available UDR types ordered in a tree structure. You can search for a specific UDR type using the filter text box. You can also expand the folders to display all the subfolders and types by clicking the Expand button. You can collapse the folders again by clicking the Collapse button. If you click the Refresh button, the view is refreshed and the folders are collapsed. Formats created in Ultra Format Editor usually have the following structure:
Note!There are a number of agents, for example Diameter and Inter Workflow, that have predefined UDR types with corresponding folder names. |
Expand All  | Click this button to expand all of the UDR Types folders to display all the subfolders and types. If you click the Refresh button, the view is refreshed and the folders are collapsed. |
Collapse All  | Click this button to collapse the UDR Types folders so that only the folders are displayed. |
UDR Fields | Displays the UDR type fields in a tree structure. You can search for a specific UDR type field using the filter text box. To refresh the view, click the Refresh button. To ease identification, the fields are color coded:
Note!A nested UDR that is optional appears in Italic Black. |
Show Optional | If enabled, fields declared as optional are displayed in black italic text. |
Show Readonly | Select this checkbox to display read-only fields. The text appears in red. Note!Clearing this checkbox also affects the blue text entries. These are reserved fields that you cannot modify.
|
Datatype | If enabled, only fields that match the selected data type are displayed. |
Selection Modes
The browser operates in five modes depending on where it is used.
Single selection of UDR Type. You can choose the UDR Type either by double-clicking the UDR Type, or by selecting it followed by OK or Apply. OK and double-click dismisses the dialog.
Multiple selections of UDR Type. You can choose several UDR Types at once by selecting them followed by OK or Apply. OK or double-click dismisses the dialog.
Single selection of UDR fields. Same as for UDR Type, but fields are selected instead.
Multiple selections of UDR field. Same as for UDR Type, but fields are selected instead.
Field input assistance. You can insert fields in the target text field by double-clicking them, or by selecting them followed by Apply. The OK button is not available.