<< Click to Display Table of Contents >>

 

zetafax_logo

Windows diagnostic tools


Windows Server 2012, 2008 or 2003, Windows XP and Windows Vista have built in diagnostic tools to help monitor and troubleshoot applications. This section describes how the Zetafax Server interacts with the Event Viewer and Performance monitor.

 

Event Viewer

 

The Windows Server 2012, 2008 or 2003, Windows XP and Windows Vista Event Viewer allows you to monitor any problems that may occur on the Zetafax Server during everyday use. It provides information about such events as errors, warnings, and the success or failure of tasks. An event is any potentially significant occurrence in the system or in an application. Some critical events are noted in on-screen messages, as well as in an event log. Non-critical events are merely logged.

 

To start the Event Viewer:

 

Click the Start button, point at Programs , point at Administrative Tools , and then click Event Viewer .

 

You can view only Zetafax Server events for a given time period by applying a filter to the log.

 

Types of events

 

Zetafax logs events with varying severity: error, warning, and information messages are recorded in the application log and logging occurs whether Zetafax is run as an application or as a service.

 

The complete list of events that the Zetafax Server lists to the event viewer is shown in the following table:

 

Event

Description

Error error checking fax device

There was an error communicating with a fax device.

Error error writing to printer

There was an error while communicating with a network printer.

Unable to write to printer

A network printer is unavailable.

Device recovered

A device which was in a failed state has recovered.

Failing device - error error

A device has encountered a serious problem which is likely to require fixing.

Unable to initialize printer printer on port

Specifies the printer name and port ID.

Printer driver name 'name ' invalid

The name by which the system tried to access a printer does not correspond to any printers visible to the system.

Printer driver file 'filename ' not found

A printer driver file (used by the OS to communicate with the printer hardware) could not be found.

Printer driver file 'filename ' invalid

The named driver file is corrupted, or the wrong driver for the specified printer.

CheckPrinter() returned OK - printer recovered

The printer has come on-line after being unavailable.

Device recovered

The (fax) device has come on-line after being unavailable.

Process name terminated

One of the component programs has closed down and is no longer running.

System startup terminated

The system has been shut down during startup - usually by user choice.

Process name terminated - shutting down system

 One of the key programs (e.g. QUEUEMAN, SYSMAN) has crashed and the rest are closing normally as the system can no longer function.

Error error running program 'name '

A specified program has produced a numbered error.

Windows error error loading program 'name '

Windows could not find/start a named program.

 

Performance monitor

 

The Windows Server 2012, 2008 or 2003, Windows XP and Windows Vista performance monitor application allows you to monitor the performance of Zetafax Servers either locally or remotely. It uses a number of counters to track data, such as failed faxes for a specified device. You can view this data in real time, log it for future study, use it in charts and reports, and set alerts to warn when a threshold value is exceeded. This data may be used to determine device bottlenecks and whether it may be necessary to add an additional device to your fax server.

 

To start the performance monitor:

 

Click the Start button, point at Programs , point at Administrative Tools (Common) , then click Performance Monitor.

 

Performance monitor objects

 

The performance monitor measures the behavior of objects running on a given computer. Zetafax adds objects such as Zetafax Server and fax devices to the list of core objects. Some objects have multiple instances; for example, each physical device, such as a fax modem will appear as a single instance of Zetafax devices.

 

Performance monitor counters

 

Each object has a set of counters defined for it, and it is the counters which record the activity level of an object. An example of counters for a Zetafax device object would be: Connect fails , Send fails , and Send OK .

 

Click Explain>> in the Add to dialog to display more information about the use and type of data compiled for each counter.

 

WinDiag_add_to_chart

 

The following table gives information about the counters logged by the Zetafax Server:

 

Zetafax Server

 

Counters

Description

Device Receive- Failed

Device Send- Failed

Devices configured for receiving/sending which have failed. This is not usually a temporary error - failed devices are likely to remain unavailable without attention from a system administrator.

Device Receive- OK

Device Send- OK

Devices configured for receiving/sending which are currently operating, capable of operation, or experiencing temporary problems.

Device Receive- Total

Device Send- Total

Total number of fax devices - configured to receive, to send, and total of both (independent of failed/OK status).

Messages- Deferred

The number of messages converted and ready for sending, but on hold due to user choice.

Messages- Waiting Conversion

Messages sent by a Zetafax client, waiting to be converted into send format.

Messages- Converting

Messages currently being converted into the format in which they will be sent.

Messages- Waiting Resend

Messages which have been unsuccessfully sent (perhaps the recipient was engaged or a device was offline). They are waiting to be resent.

Messages- Waiting Conversion

Messages converted into the correct format for sending, waiting for an available hardware device.

Messages- Sending

Messages currently being sent through output devices.

 

Zetafax Devices

 

Counters

Description

Connect Fails

Attempts to send a message which have failed owing to inability of the device to establish a connection, such as a busy tone.

Send Fails

Messages which were submitted to the device but failed to reach their destination.

Sent OK

Messages which have been successfully sent by this device.

Total Attempts (sum of above 3)

Total number of messages which the system has attempted to send.

% Connect Fails

Percentage of connection failures to total attempts to send a message.

Zero until ten attempts have been made - no '_Total' available.

% Send Fails

Percentage of messages which were submitted to the device but failed to reach their destination. Zero until ten attempts have been made - no '_Total' available.

% Sent OK

Percentage of messages which have been successfully sent by this device. Zero until ten attempts have been made - no '_Total' available.

   

Zetafax Least-Cost Routing Links

 

Counters

Description

Messages Submitted

Messages sent to the remote server, both acknowledged and unacknowledged.

Messages Received

Messages received from the remote server.

Messages Acknowledged

Messages accepted by the remote server for processing.

Messages Unacknowledged

Messages sent to the remote server, but waiting response.

Messages Sent OK

Total of messages sent by this link to remote server - no '_Total' available.

Messages Failed (Timeout)

Total of messages sent which timed out - no '_Total' available.

Messages Failed (Rejected)

Total of messages sent to remote server and rejected - no '_Total' available.

Messages Failed (Remote Error)

Total of messages sent to remote server and failed due to error at that server - no '_Total' available.

Messages Failed (Device Fault)

Total of messages sent which failed owing to device failure - no '_Total' available.