*XML Additional Options

When working with *XML file types, use F20 to open a window showing additional options that allow the definition of the primary tag and set XML filters for the rule group. The following fields are available:

Primary tag

Specifies the primary tag or tag chain. Each block of data beginning with this tag and ending with the matching closing tag forms a logical XML record that is processed as a unit by Log File Monitor.

*FIRST The first XML tag found in the data is the primary tag.
tag name Specify the primary tag name or press F4 to select from a list. Each block of data beginning with this tag name and ending with the matching closing tag forms a logical XML record that is processed as a unit by Log File Monitor. With well designed XML, a simple tag name is generally sufficient.
tag chain

A tag chain is two or more tag names delimited by forward slashes, for example:

Html/Body/Table/Table/Tr/Td/Table/Tr

Tag chains allow you to specify an inner occurrence of a tag that is nested within other tags of the same name. Tag chains are usually needed when reading HTML data.

Type tag/attributes names to omit

These fields allow you to add up to 96 XML filters.

XML filters allow you to reduce the size of the logical XML record. The maximum size of logical XML record that can be processed is 32766 characters. If the XML records exceed 32766 characters, use filters to reduce the size to within this limit.

Type filters in one of the following formats. Values are not case sensitive:

tag-name/*TAG Omits the entire tag and all its content
tag-name/*ALL Omits all attributes from the tag but keeps the tag value if there is one.
tag-name/attribute-name Omits the specified attribute from the tag

Functions

Apart from the usual F3=Exit and F12=Cancel, the following functions can be used on this display:

If the cursor is in the Primary tag field or a filter field, use F4 to display a list of the tag names found in the files specified in the selection criteria.

Use F6=Omit all to remove all existing filters and the add the tag-name/*TAG filters for every tag found in the files specified in the selection criteria.

You can then remove the filters for the tags you want Log File Monitor to process.

If the cursor is in a filter field populated with a tag name, use F16 to display a list of attributes of that tag. The attributes already selected are indicated.

Select additional attributes by typing a 1 or deselect attributes by typing a space.

Selecting multiple tags/attributes

There are two ways in multi-select for tags can be used:

  • When used on a blank line, multiple tags to omit can be selected.
  • When used on a non-blank line, multiple attributes for the tag on that line can be selected.
Selecting multiple tags to omit

Press F4 on a blank line to display the following in a pop-up window: 

  • The tags that currently exist in the XML
  • Any tags already defined even though they don't exist in the XML

The following logic is applied: 

1 indicates the whole tag is currently selected by Tag-name/*TAG
* indicates a tag that is currently selected by tag-name/*ALL or tag-name/attribute-name
blank indicates that the tag is not currently selected

Select additional tags to omit by typing a 1 or remove existing tags by typing a space.

Changing a * to a 1 replaces tag entries with a whole tag entry

Selecting multiple attributes to omit

Press F16 on a non-blank line to display the following in a pop-up window: 

  • The tag-name/attribute-names that currently exist in the XML
  • Any tag-name/ attribute-name entries already defined even though they don't exist in the XML

The following logic is applied: 

1 indicates the tag-name/attribute-name entry exists
blank indicates that the tag-name/attribute-name entry does not exist

Type 1 next to tag-name/attribute name entries to add them to the omit list if it does not already exist. If there is a tag-name/*TAG or tag-name/*ALL entry it is removed.

Type a blank against an existing tag-name/attribute-name entry to remove it from the list.