9.24.4.1 ECS Inspector

To open the ECS Inspector, click the Tools button in the upper left part of the Desktop window, and then select ECS Inspector from the menu.

Initially, the dialog is empty and must be populated with data using the Search ECS dialog. Depending on if the search is done for UDRs or batches the columns in the table will differ. For further information, see 9.24.4.4 Searching the ECS.

Maximum Number of Displayed UDR Entries

To ensure that the GUI does not have to handle too much data, the maximum number of displayed UDR entries have been set to 100000 UDR entries. However, in the configuration file for the Platform instance, you can change the maximum number of displayed UDR entries in the ECS Inspector by setting the property mz.ecs.max.udr.search in the platform.conf file. See the example below:

Example - Setting the property mz.ecs.max.udr.search to 10000

mzsh topo set topo://container:<platform container>/pico:platform/val:config.properties.mz.ecs.max.udr.search 10000


If you want to get quicker and smaller search results, for example, you can set this property to a lower value.

Note!

If the value of the property is set higher than the default value, it may result in poor performance. Also, note that this property only has effect when UDRs are inspected and not when batches are inspected.

Maximum Number of UDR Entries to Update

To ensure that the Platform, using standard 256 Mb heap size, does not run out of memory, the maximum number of UDR entries to update/delete is limited to 15,000,000 UDR entries. However, this limit is easily increased using a property, by setting the Platform property mz.ecs.max.udr.update in the configuration file for the Platform instance. See the example below:

Example - Setting the property mz.ecs.max.udr.update to 25000000

mzsh topo set topo://container:<platform container>/pico:platform/val:config.properties.mz.ecs.max.udr.update 25000000

Note!

When increasing the above default limit, you might have to increase the Platform maximum heap size as well. This is done by changing the -Xmx parameter in the configuration file for the Platform instance. As a general rule, ECS wants another 10 Mb Platform heap space for every additional one million UDRs.

Menus

General

The following menu items apply for both Batches and UDRs.


File menu

Close

Closes the Error Correction System Inspector


Edit menu

Delete

Removes selected or (if no entries are selected) all matching entries, provided that the RP State is set to Reprocessed. The ECS does not have to be purged manually, there is a predefined cleanup task - ECS_Maintenance for automatic purging. For further information, see 9.24.3 ECS_Maintenance System Task.

Note!

If the maximum number of entries that can be displayed in the table has been exceeded. The delete operation will still be applied for all matching entries.

Search...


Displays the Search Error Correction System dialog where search criteria may be defined to limit the entries in the list. For further information, see 9.24.4.4 Searching the ECS.

Matching entries are bundled in groups of 500 in the table. This list shows which group, out of how many, that is currently displayed. An operation targeting all matching entries, will have effect on all groups.

Select All

Selects all entries in the ECS Inspector.

Error Codes...

Displays the ECS Error Code dialog where the Error Codes in the system may be configured. For further information, see 9.24.4.6 ECS Error Codes.

Reprocessing Groups...

Displays the ECS Reprocessing Groups dialog, where reprocessing groups are managed. For further information, see 9.24.4.7 ECS Reprocessing Groups.

Searchable Fields...

Opens the Searchable Fields dialog, where you can define specific UDR fields that you want to add as meta data that can later be used for making searches, see 9.24.4.2 Configuring Searchable Fields in the ECS.

Restricted Fields...

Opens the Restricted Fields dialog, where you can specify certain fields within certain UDR types that should be restricted from being updated in the ECS Inspector, see 9.24.4.3 ECS Restricted Fields Configuration in ECS.


View menu

Refresh

Select this option to refresh the data in the table.


Batch/UDR menu

Set State...

Defines the state of a selected number of entries or (if no entries are selected) all entries. Possible states are either New or Reprocessed (that is collected by an ECS Collection agent and reprocessed with errors). Already processed data can be reset to New to enable recollection. When the state is changed, the timestamp in the Last RP State Change column in the ECS Inspector will be updated. See 9.24.4.8 ECS Changing State for more information.

Note!

If the number of matches is larger than the maximum number of UDRs to be displayed the state change will still be applied for all matching entries.

Assign to RPG...

Assigns a selected number of entries or (if no entries are selected) all entries to a reprocessing group. Grouped entries can be collected simultaneously by an ECS collection agent.

Message when collecting grouped entries
 

Note!

Assignments to reprocessing groups can be made automatically for each new entry. In order for this to happen, the data must be assigned an Error Code in the workflow, and this Error Code must be mapped to the reprocessing group in the ECS Error Code dialog.

Delete



Removes selected or (if no entries are selected) all matched entries, provided that the RP State is set to Reprocessed. The ECS does not have to be purged manually, there is a predefined cleanup task - ECS_Maintenance for automatic purging. For further information, see 9.24.3 ECS_Maintenance System Task.

Note!

If the maximum number of entries that can be displayed in the table has been exceeded, the delete operation will still be applied for all matching entries.

UDR specific menu options


UDR menu

Explore UDR...

Displays the UDR dialog presenting the content of the selected UDR(s). The dialog is also displayed if you double-click on a cell in the UDR Type column in the table of entries. In the dialog, the content of the UDR can be changed, except for the field Original Data.

The UDR dialog

For further information, see the Ultra Format Management User's Guide.

Set Tag on UDR(s)...

With this option you can set a tag on selected UDRs. When you have selected the UDR(s) you want to tag and then selected this option, a dialog will open asking you to enter the  Tag Name .



Entering Tag Name


The Tag Name will then be visible in the Tag column in the ECS Inspector.

Clear Tag(s) on UDR(s)...

If you select this option, the tags for the selected UDRs will be removed.

Bulk Edit...

Several UDRs (selected or matched) may be edited simultaneously with the Bulk Editor. The editor displayed from ECS differs slightly from the editor displayed from the UDR dialog, opened for example from the Explore UDR...dialog. The ECS Bulk Editor has a Preview option, which makes it possible to preview the changes prior approving and saving.

When changes have been made you can select to view only the modified entries, only the untouched entries, or all entries in the ECS Inspector.



The ECS Bulk Editor


Note!

If the number of matches exceeds the maximum number of entries that can be displayed, it may be a good idea to set up a workflow for editing the entries using APL instead of performing a bulk edit.


When clicking on the Apply Changes button, the Bulk Edit Result dialog will open, displaying modified and untouched entries.


The Bulk Edit Result dialog


Now you can select if you want to view only modified entries, untouched entries, or all entries in the ECS Inspector by using either of the options  Entire Result Set Modified Only , or  Untouched Only . Click on the View button when you have made your selection.

The selected type of entries will then be displayed in the ECS Inspector. In the top right corner, above the ECS Inspector table, you will see information about what selection you have made, e g "Modified Entries from Bulk Edit".


Hint!

If you want to view the changes before applying them, you can click on the Preview button instead. The Bulk Edit Result - Preview dialog will then open, giving you a preview of the changes that are about to be made. If you are satisfied with the preview, click on the Apply button, and the Bulk Edit Result dialog will open.


For further information about the Bulk Editor, see the Ultra Format Management User's Guide.

Batch specific menu options


Batch menu

Explore Error UDR...

Displays the Error UDR Viewer presenting the content of the Error UDR (if any). The viewer will also be displayed if you double-click on a cell in the Error UDR column in the table of entries..

The Error UDR viewer

It is not possible to change the content of an Error UDR.

View Batch...

Displays the selected batch as raw data.

View Batch