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