6 Offline Mediation Controller Record Editor

This chapter describes how to use Oracle Communications Offline Mediation Controller Record Editor.

Opening Record Editor

To open Record Editor:

Ensure that the Oracle Unified Directory server instance is running.
Start Node Manager and Administration Server.
Run the following command:
```
./gui
```
Administration Client starts.
Log on to Administration Client as the Administrator, Designer, or Operator user.

The Node Hosts & Nodes (logical view) screen appears.
From the Admin menu, select NAR Editor.

The Record Editor window appears.

About Viewing and Editing Records

Records in Offline Mediation Controller are stored and processed in network accounting record (NAR) format. Record Editor allows you to edit NARs and submit them to the node chain. The node chain processes the NARs and distributes them to downstream applications.

A NAR contains attributes that contain values. Table 6-1 lists the supported attribute types.

Table 6-1 Attribute Types

Attribute Type	Description
String	Accepts ASCII characters
Short	Accepts an integer up to 16 bits
Integer	Accepts range from 0 to 9 up to 32 bits
Long	Accepts range from 0 to 9 up to 64 bits
Byte	Accepts range from 0 to 127
Bytes	Accepts two-character hexadecimal format separated by spaces. For example, 3A 5C 9D.
Time in seconds or Time in milliseconds	Accepts date and time values. You select the value from a dialog box.
Map	Hash map, accepts a key and value associations
List	Accepts a list of any supported fields
IP	Accepts an IP address
Double	Accepts a double value
Float	Accepts a float value

Viewing Records

Record Editor allows you to view the NARs in a NAR archive file, view the NAR attributes, and view their related values.

To view records:

In the Record Editor window, from the File menu, select Open.

The Open File dialog box appears.
Search for the NAR archive file you want to view and click Open.

The NARs appear in the left pane.
Expand a NAR.

The attribute list appears.

Note:
No element appears when a NAR has no attributes associated with it.
Select an attribute.

The attribute values appear in the right pane.

Editing Records

To edit records:

In the Record Editor window, from the File menu, select Open.

The Open File dialog box appears.
Search for the NAR archive file containing the NARs and click Open.

The NARs appear in the left pane.
Expand a NAR.

The list of NAR attributes appears.

Note:
No element appears when a NAR has no attributes associated with it.
Select an attribute.

The attribute values appear in the right pane.
You can edit records by editing the attribute values:
- When an attribute value appears in red, you can edit the value at the current level.
- When an attribute value appears in black, it is a complex field and you cannot edit the value at the current level. Go to the left pane and expand the attribute further to view the editable values.
In the right pane, double-click the data in the Value column and change it to the desired value.

When you edit an attribute value, Record Editor automatically updates the Length column with the corresponding character length of the value.

To edit the Time in seconds or Time in milliseconds values, double-click the attribute value and then click the button that appears, which brings up the Select Datetime Value dialog box. Edit the values and click Apply.

Note:
You cannot add new attributes in records. You can only modify or delete attribute values.
Save the file.

Modifying Attribute Names Displayed in Record Editor

By default, Record Editor uses the name Network Accounting Record for each NAR in your system. This means that each NAR will be displayed as Network Accounting Record in the left pane of the Record Editor window. When you expand a NAR, the NAR attribute names are listed.

To modify the attribute name:

Open the OMC_home/datadict/Data_Dictionary.xml file in a text editor, where OMC_home is the directory in which Offline Mediation Controller is installed.
Search for the attribute ID.
Change the <Attr> element to <Attr tagForName="true">.

The tagForName option overrides the default attribute name.
Set the <Name> element to the attribute name you want to display in Record Editor.

Note:
If you leave the <Name> element blank, Record Editor displays the attribute ID as the attribute name.
Save the file.
Restart Record Editor.

Searching for NARs

To search for a NAR:

In the Record Editor window, from the Search menu, select Search Records.

The Search Network Accounting Record dialog box appears.
From the Attribute list, select an attribute and enter a value.

If you do not know the exact value to search for, select contains and enter a partial value. This search returns all values that contain the partial value you entered.

Note:
When searching for a value in a List attribute, you must select contains. When searching for attributes of the Bytes field type, use a comma to separate the values; for example, 2f,62,68,bf.
Click Search.

The results are displayed in the table.

Updating Multiple Records

To update multiple records:

Search for NARs by doing the following:
1. In the Record Editor window, from the Search menu, select Search Records.
  
  The Search Network Accounting Record dialog box appears.
2. From the Attribute list, select an attribute and enter a value.
  
  If you do not know the exact value to search for, select contains and enter a partial value. This search returns all values that contain the partial value you entered.
  
  Note:
  When searching for a value in a List attribute, you must select contains. When searching for attributes of the Bytes field type, use a comma to separate the values; for example, 2f,62,68,bf.
3. Click Search.
  
  The results are displayed in the table.
Select the records you want to modify and click Update.

The Update Dialog dialog box appears.

Note:
To update a complex field, select the field to be updated in the Field selector Dialog dialog box and click OK. The Update Dialog dialog box appears.
Do one of the following:
- To update the values by overwriting the existing values:
  1. Select Absolute Update.
  2. Do one of the following:
    
    To update a simple value, enter the value in the Value field.
    
    To update an IP Address, MAC Address, or Bytes, enter the value in the dialog box that appears.
  3. Click Update.
    
    The values are updated.
- To update the values by incrementing or decrementing the value relative to the existing value:
  1. Select Relative Update.
    
    Note:
    Relative update can be performed only in String, Time, and Integer attributes. For a String attribute, the new value is appended to the existing value.
  2. In the Value field, enter the value.
  3. Do one of the following:
    
    To increase the existing value by the value entered in the Value field, select Increment.
    
    To decrease the existing value by the value entered in the Value field, select Decrement.
  4. Click Update.
    
    The values are updated.

Deleting Multiple Records

To delete multiple records:

Search for NARs by doing the following:
1. In the Record Editor window, from the Search menu, select Search Records.
  
  The Search Network Accounting Record dialog box appears.
2. From the Attribute list, select an attribute and enter a value.
  
  If you do not know the exact value to search for, select contains and enter a partial value. This search returns all values that contain the partial value you entered.
  
  Note:
  When searching for a value in a List attribute, you must select contains. When searching for attributes of the Bytes field type, use a comma to separate the values; for example, 2f,62,68,bf.
3. Click Search.
  
  The results are displayed in the table.
Select the records you want to delete and click Delete.

The Delete Confirmation dialog box appears.
Click OK.

The selected records are deleted.

Working with NAR Archive Files and XML Files

Record Editor allows you to convert the NAR archive file to an XML file. You can use the XML file to simplify manual searching, editing, and deleting NAR records. After modifying the NAR records in the XML file, you can convert the XML file to a NAR archive file and open the NAR archive file in Record Editor.

Converting a NAR Archive File to an XML File

To convert a NAR archive file to an XML file:

In the Record Editor window, from the File menu, select Open.

The Open File dialog box appears.
Search for the NAR archive file you want to convert and click Open.

The NAR archive file appears.
From the File menu, select NarToXml.

The NAR archive file is saved as an XML file in the OMC_home/export directory.

Note:
The name of the XML file is the same as the name of the NAR archive file with the .xml file extension.

You can open the generated XML file in a text editor and search, edit, or delete the records.

Converting an XML File to a NAR Archive File

To convert an XML file to a NAR archive file:

In the Record Editor window, from the File menu, select XMLToNar.

The Import File dialog box appears.
Search for the XML file you want to convert and click XmlToNar.

Note:
Only files with the .xml file extension are displayed.

The XML file is saved as a NAR archive file in the OMC_home/import directory, and the NAR archive file is opened in Record Editor.

Note:
The name of the NAR archive file is the same as the name of the XML file with the .arch file extension.

Submitting the Edited NAR Archive Files to the Data Stream

After editing the NAR archive files, you must submit the edited NAR archive files to the data stream for processing.

If the modified NAR archive file does not reside on the Offline Mediation Controller server, do the following:

Send the NAR archive file by FTP to the Offline Mediation Controller server in an intermediate directory.
Copy the NAR archive file to the input directory of the node where you would like the data to be processed. The file that is placed in the input directory must have an .arch extension.
The NAR archive file is picked up by the node and submitted for processing.