home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 36 Tips / 36-Tips.zip / DBMTRC.FAX < prev    next >
Text File  |  1994-11-29  |  4KB  |  116 lines
  1. Database Manager trace instuctions with OS      7/15/92
  2.  
  3.  
  4. ********PLEASE NOTE:****************************************************
  5. These instructions are only for OS/2 Extended Edition.  If you are
  6. tracing Database Manager under Extended Services, use the new SQLTRC
  7. function.
  8. ************************************************************************
  9.  
  10.      OS/2 DATABASE MANAGER TRACE INSTRUCTIONS
  11.      ________________________________________
  12.  
  13.  
  14.      If the problem you are tracing is reproducible at will, fol-
  15.      low steps 2 - 10.  If it is not, you will need to follow in-
  16.      struction   1,  skip  steps  2  -  6  and  continue  through
  17.      instruction 10.
  18.  
  19.      1.  Edit the CONFIG.SYS file and add  the  following  state-
  20.          ments:
  21.  
  22.               'TRACEBUF=63'
  23.               'TRACE=ON 176,177,178,179,180,182,183,184'
  24.  
  25.          Re-ipl the system to activate the changes.
  26.  
  27.          NOTE:   Running all the required trace events may impact
  28.          system performance.  OS/2 Database Development has  sug-
  29.          gested  that users always run with system event 183 (er-
  30.          ror path trace) activated so that important  information
  31.          will  be readily available in case of an abend or system
  32.          error (trace records will only be written  if  an  error
  33.          occurs so performance will not be impacted).
  34.  
  35.      2.  Edit  the  CONFIG.SYS  file and add the following state-
  36.          ments if they do not exist.
  37.  
  38.               'TRACEBUF=63'
  39.               'TRACE=OFF'
  40.  
  41.          Re-ipl the system to activate the changes.
  42.  
  43.      3.  Begin the application and get as far  into  the  process
  44.          before the problem occurs.
  45.  
  46.          The  objective  is to get as close to the problem before
  47.          it occurs, turn 'TRACE ON' and  then  immediately  issue
  48.          the 'TRACE OFF' command after the problem has occurred.
  49.  
  50.      4.  Start a new OS/2 session and type the following:
  51.  
  52.               'TRACE ON  176, 177, 178, 179, 180, 182, 183, 184'  Press 'Enter'.
  53.  
  54.      5.  The next command should only be used if requested by IBM
  55.          Support.  'SQLTRSET x x x' where x is a letter requested
  56.          by IBM Support.
  57.  
  58.      6.  Switch  back  to the session running the application and
  59.          continue until the problem occurs.
  60.  
  61.      7.  After the application has  failed,  copy  or  print  the
  62.          'ABEND'  screen  (if  any)  and take special note of the
  63.          'CS' & 'IP' values.
  64.  
  65.      8.  Switch back to the session where the 'TRACE ON'  command
  66.          was  issued  (or  go to a new OS/2 command prompt if you
  67.          started the trace from CONFIG.SYS) and type the  follow-
  68.          ing:
  69.  
  70.               'TRACE OFF'
  71.  
  72.      9.  At the OS/2 command line type the following:
  73.  
  74.               'TRACEFMT > FN' (FN is any user defined Filename)
  75.  
  76.          This  will  copy  the  trace  information from the trace
  77.          buffer to an OS/2 file.
  78.  
  79.      10. You need only perform this step if an  abend  (or  TRAP)
  80.          occurred  on your system.  Type the following at an OS/2
  81.          command prompt:
  82.  
  83.               'SQLABEND FN CSV:IPV' (FN = Filename, any user defined name)
  84.                                     (CSV = CS value)
  85.                                     (IPV = IP value)
  86.  
  87.          If the problem has occurred in  database  services  then
  88.          the user will receive a message indicating the component
  89.          (i.e, SQLx where x is the component ID.  The user should
  90.          record this message.
  91.  
  92.      WHERE TO SEND THE FORMATTED TRACE
  93.      _________________________________
  94.  
  95.      You  can send the trace to IBM Level 2 Support in one of two
  96.      ways:
  97.  
  98.      1.  Have your local IBM Representative (SE  or  OSS)  upload
  99.          the  file  in BINARY FORMAT (this is very important) and
  100.          send it electronically to DEFECT at AUSVM8  (userid  and
  101.          nodeid  on  VM system).   Make sure that he/she includes
  102.          the problem number in the filename, e.g.  1X123  TRACE1,
  103.          1X123 TRACE2, etc.
  104.  
  105.      2.  Copy  the trace to diskette and mail it to the following
  106.          address:
  107.               IBM Corp.
  108.               Attn:  <Level 2 Support person you are working with>
  109.               11400 Burnet Rd.
  110.               Zip 2900 Bldg. 042
  111.               Austin, TX  78758
  112.  
  113.  
  114.  
  115. 12/31/99
  116.