QWIN Debug Page - Getting Trace Information

Server trace | Local trace | In case of problem

This document describes steps to get trace data to help debug problems in Qedit for Windows.

Server Trace Files

To enable the server trace feature from the Qedit for Windows client:

  1. Go to Options | Debug
  2. Enable Enable Tracing in the Server Trace Options
  3. Click OK
Depending on which host you are connecting to, you might have to build the trace files.

HP-UX Hosts

On HP-UX, the server expects the files in the /opt/robelle/log/qedit directory. The directory is built by the installation process. If the directory does not exist, you should create it.
  1. Login as root
  2. cd /opt/robelle
  3. mkdir log
  4. mkdir log/qedit
The directory path must exist but the server creates the files if they don't exist already. The files are called:

MPE Hosts

On MPE, the files are in the QLOG group of the ROBELLE account. The installation job creates the trace files. If the files do not exist, you have to create them. By default, the files are Circular as indicated by the letter O in the TYP column.

FILENAME  CODE  ------------LOGICAL RECORD-----------  ----SPACE----
                  SIZE  TYP        EOF      LIMIT R/B  SECTORS #X MX

ACCESS            260B  VAO          0       1023   1     1040  1  1
ERROR             260B  VAO          0       1023   1     1040  1  1
TRACE             260B  VAO          0       1023   1     1040  1  1
However, to be able to look at the trace files while users are actively working in Qedit for Windows, the files should not be circular. In this case, purge the files and rebuild as shown above. Of course, all this have to be done while nobody is using them. You can add a stream of this job to your full backup after qserver job has been stopped:
!comment ----------------------------------------------------------------
!comment QLOGBLD.JOB.ROBELLE                     24 JULY 1998
!comment This job rebuilds the QWIN log files in Robhome.
!comment In order to read them while others are still posting entries,
!comment the log files CAN NOT be circular files.
!comment Stream after a new install into Robhome.
!comment History:
!comment 24 Jul 98  Francois   original
!comment 08 Dec 15  Neil       Update to save old qlogs
!comment ----------------------------------------------------------------
!setvar myacc finfo('ACCESS.QLOG.ROBELLE','ACCESSORS')
!showjob >> jlist
!run qedit.pub.robelle
t jlist
list "QSERVER"
!if qeditcount = 0 and !myacc = 0 then
!copy trace.qlog,trace!hpdoy
!copy error.qlog,error!hpdoy.qlog
!copy access.qlog,acces!hpdoy.qlog
!build TRACE.QLOG;rec=-256,,v,ascii;disc=200000
!build ERROR.QLOG;rec=-256,,v,ascii;disc=10000
!build ACCESS.QLOG;rec=-256,,v,ascii;disc=10000
!tellop Qedit server is running, cannot rebuild log files.
If you no longer need to reset the log files you can stop streaming eh above job and just reset the log files either by streaming this job:
!purge access.qlog
!purge error.qlog
!purge trace.qlog
!build access.qlog;rec=-256,1,v,ascii;cir
!build error.qlog;rec=-256,1,v,ascii;cir
!build trace.qlog;rec=-256,1,v,ascii;cir;disc=5000
or just sign on as mgr.robelle and paste in the following commands with the Qedit server stopped:
purge access.qlog
purge error.qlog
purge trace.qlog
build access.qlog;rec=-256,1,v,ascii;cir;disc=5000
build error.qlog;rec=-256,1,v,ascii;cir;disc=5000
build trace.qlog;rec=-256,1,v,ascii;cir;disc=5000

Back to the top
....Back to the Qedit Q&A Page

Local Trace File

To enable the local trace feature in Qedit for Windows:

  1. Go to Options | Debug
  2. Enable all the local trace options
  3. Assign a name to the local trace file. It's important to remember what it is.
  4. Enable Force Flush on Every Write
  5. Click Apply

Back to the top
....Back to the Qedit Q&A Page

In Case of Problem

As soon as you notice a problem:

Back to the top
....Back to the Qedit Q&A Page