Exceptions File

Child elements of ExceptionFile root element

XML elements

Attributes

Content

Number of occurrences

Description

Verbose/VB
Concise/CS

Immediate

EMPTY

0/1

Syntax that the driver uses to generate this XML file. By default, the driver uses the verbose syntax.

QueueSize/QS

Immediate

EMPTY

0/1

Capacity of the exceptions queue.

Count/C

Immediate

ReadOnly

PCDATA

0/1

Number of exceptions in the exceptions file.

Exception/E

 

Elements

Any

One exception.

Child elements of Exception element

XML elements

Attributes

Content

Number of occurrences

Description

Index/IX

ReadOnly

PCDATA

0/1

The unique index of the exception. Note that the Index element must be included in order to to erase/acknowledge an exception.

Acknowledge/ACK

Immediate

WriteOnly

EMPTY

0/1

Acknowledges the exception and removes it from the exceptions file.

ErrorType/ET

ReadOnly

PCDATA

0/1

 

ErrorTypeName/TN

ReadOnly

PCDATA

0/1

 

TimeStamp/TS

ReadOnly

PCDATA

0/1

Local time counter value at exception time.

FileSystemHandling/FSH

 

Elements

0/1

 

XMLProcessing/XP

 

Elements

0/1

 

ResourceHandling/RH

 

Elements

0/1

 

ParameterSetting/PS

 

Elements

0/1

 

Delivery/DV

 

Elements

0/1

 

Child elements of FileSystemHandling element

XML elements

Attributes

Content

Number of occurrences

Description

ErrorCode/EC

ReadOnly

PCDATA

1

The error code.

ErrorName/EN

ReadOnly

PCDATA

1

The error name.

File/F

ReadOnly

PCDATA

1

Name of the file causing the exception.

Operation/O

ReadOnly

PCDATA

1

Name of the operation causing the exception.

Hint/H

ReadOnly

PCDATA

1

Hint about the exception.

Child elements of XMLProcessing element

XML elements

Attributes

Content

Number of occurrences

Description

ErrorCode/EC

ReadOnly

PCDATA

1

The error code.

ErrorName/EN

ReadOnly

PCDATA

1

The error name.

File/F

ReadOnly

PCDATA

1

Name of the XML file causing the exception.

Line/L

ReadOnly

PCDATA

1

Line number of the XML file causing the exception.

Column/CL

ReadOnly

PCDATA

1

Column number of the XML file causing the exception.

Hint/H

ReadOnly

PCDATA

1

Hint about the exception.

Child elements of ResourceHandling element

XML elements

Attributes

Content

Number of occurrences

Description

ErrorCode/EC

ReadOnly

PCDATA

1

The error code.

ErrorName/EN

ReadOnly

PCDATA

1

The error name.

Operation/O

ReadOnly

PCDATA

1

Name of the operation causing the exception.

Hint/H

ReadOnly

PCDATA

1

Hint about the exception.

Child elements of ParameterSetting element

XML elements

Attributes

Content

Number of occurrences

Description

ErrorCode/EC

ReadOnly

PCDATA

1

The error code.

ErrorName/EN

ReadOnly

PCDATA

1

The error name.

Parameter/P

ReadOnly

PCDATA

1

Name of the parameter causing the exception.

Hint/H

ReadOnly

PCDATA

1

Hint about the exception.

Child elements of Delivery element

XML elements

Attributes

Content

Number of occurrences

Description

ErrorCode/EC

ReadOnly

PCDATA

1

The error code.

ErrorName/EN

ReadOnly

PCDATA

1

The error name.

Operation/O

ReadOnly

PCDATA

1

Name of the operation causing the exception.

Hint/H

ReadOnly

PCDATA

1

Hint about the exception.

XML File Examples

<root>/exceptions.xml – Read operation – Verbose mode – No exceptions

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE ExceptionFile SYSTEM "exceptions.dtd">
<ExceptionFile version="1.0">
    <Verbose Immediate="true"/>
    <QueueSize Immediate="true">10</QueueSize>
    <Count ReadOnly="true" Immediate="true">0</Count>
</ExceptionFile>

<root>/exceptions.xml – Read operation – Verbose mode

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE ExceptionFile SYSTEM "exceptions.dtd">
<ExceptionFile>
    <Verbose/>
    <QueueSize>10</QueueSize>
    <Count>2</Count>
    <Exception>
        <Index>1</Index>
        <ErrorType>1</ErrorType>
        <ErrorTypeName>XML Processing Error</ErrorTypeName>
        <XMLProcessing>
            <ErrorCode>12</ErrorCode>
            <ErrorName>Invalid Element</ErrorName>
            <File>config.xml</File>
            <Line>5</Line>
            <Column>12</Column>
            <Hint>Element "brightness" is invalid.</Hint>
        </XMLProcessing>
    </Exception>
    <Exception>
        <Index>0</Index>
        <ErrorType>1</ErrorType>
        <ErrorTypeName>XML Processing Error</ErrorTypeName>
        <XMLProcessing>
            <ErrorCode>12</ErrorCode>
            <ErrorName>Invalid Element</ErrorName>
            <File>config.xml</File>
            <Line>5</Line>
            <Column>12</Column>
            <Hint>Element "brightness" is invalid.</Hint>
        </XMLProcessing>
    </Exception>
</ExceptionFile>

<root>/exceptions.xml – Write operation – Acknowledge the Exception of Index 0

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE ExceptionFile SYSTEM " exceptions.dtd">
<ExceptionFile version="1.0">
    <Exception>
        <Index>0</Index>
        <Acknowledge/>
    </Exception>
</ExceptionFile>