# BASEstartm Open DAS
for Modicon®
on Tru64tm UNIX®
Installation and User's Guide

Previous | Contents | Index

## 2.3.5 Tracing Device Communications

The DAS for Modicon programmable controllers has built into it the capablity to trace device communications and to send this output to either a file or to a user terminal. The purpose of this tracing is to allow the troubleshooting of device communications.

Tracing can be enabled for a device and/or a line. If tracing is enabled for a device, then only communications from/to that device are traced. If tracing is enabled for a line, then all communications from/to that line are traced. If both device and line tracing is enabled, then the trace will contain the output for both the device and the line, so the trace output will be duplicated.

To enable tracing do the following:

- Set the TRACE attribute in the ODS definition for the path or line being traced.
- Set the DAS_TRACE_OUTPUT environment variable to the name of the file that you want to contain the trace output. The environment variable must be defined such that it will be seen by the server the DAS is a part of.

      setenv DAS_TRACE_OUTPUT trace_output.log

- Reinitiate communications to the device/line. The ODS definition is read when a connection to the device is initiated (device tracing) or when a connection to the line is initiated (line tracing), so communications must be reinitiated in order for tracing to occur.

The trace output is flushed to the file after every 10 lines that are traced, so trace output may lag actual device I/O.

All trace output is in hexadecimal and shows both input to and output from the device.

To turn tracing off, reverse the steps used to turn tracing on.

# 2.4 Failures During Product Use

If an error occurs while this product is in use and you believe the error is caused by a problem with the product, take one of the following actions:

- If you have a Software Product Services Support Agreement, contact your Customer Support Center (CSC) by telephone or by using the electronic means provided with your support agreement (such as DSNlink). The CSC provides telephone support for high-level advisory and remedial assistance. When you initially contact the CSC, indicate the following:
  - The name and version number of the operating system you are using
  - The version number of the product you are using
  - The version number of BASEstar Open you are using
  - The hardware system you are using (such as a model number)
  - The Modicon programmable controllers you are communicating with
  - A brief description of the problem (one sentence if possible)
  - How critical the problem is
- If you have a Self-Maintenance Software Agreement, you can submit a Software Performance Report (SPR).
- If you do not have any type of software services support agreement and you purchased this product within the past year, you can submit an SPR if you think the problem is caused by a software error.

When you submit an SPR, take the following steps:

1. Describe as accurately as possible the circumstances and state of the system when the problem occurred. Include the description and version number of the product being used. Demonstrate the problem with specific examples.
2. Reduce the problem to as small a size as possible.
3. Remember to include listings of any command files, INCLUDE files, or relevant data files, and so forth.
4. Report only one problem per SPR. This will facilitate a faster response.
5. Mail the SPR package to Compaq.

Previous | Next | Contents | Index