TPFDF Debugger Enabling Tool README

This README file contains information about installing the
TPFDF Debugger Enabling Tool (UFDS).

The TPFDF debugger enabling tool allows ZUDFM Trace (OAS) commands to 
be used to view file information while tracing TPFDF applications 
with VisualAge for TPF Distributed Debugger.  This DLM (UFDS) 
enables VisualAge for TPF to display TPFDF subfile data blocks 
and sw00sr slot information for ECBs being traced.     


CONTENTS
________

This file includes the following information:

1.0  PreRequisites
2.0  Installing the TPFDF Debugger Enabling Tool
3.0  Customizing the TPFDF Debugger Enabling Tool
4.0  Running the TPFDF Debugger Enabling Tool
5.0  Trademarks

1.0  PREREQUISITES: TPFDF Debugger Enabling Tool
________________________________________________

The following prerequisites are for TPF and TPFDF:

  o TPF PUT 12 with APAR PJ28395 installed
  o TPFDF PUT 17 with APAR PQ59048 installed


2.0  INSTALLING the TPFDF Debugger Enabling Tool
________________________________________________

a. Unpack dfdebug.ascii.tar.Z.  Note that this file has been packed
   using pax. For tips on unpaxing files refer to the Download
   Tips page linked from the main Tools page. 
b. Compile ufds.c and create the DLM by using ufdsbs.bsc
   to link-edit ufds 
c. If desired, update USRTPF to include ufds and rerun the system allocator SALO
d. Update ufda to remove the comments from the code added by APAR PQ59048. 
e. Reassemble ufda. 
f. Update ufb9.asm, if necessary, to bypass checks for ALCS being installed.
g. Load ufb9, ufda, ufds and, if created, a new IPAT to the TPF system.
   We used the online loader (OLDR) and did not need to create or load a 
   new IPAT.




3.0  CUSTOMIZING the TPFDF Debugger Enabling Tool
_________________________________________________

N/A


4.0  RUNNING the TPFDF Debugger Enabling Tool
_____________________________________________

Trace a TPFDF application program using the VisualAge for TPF Distributed 
Debugger. After the application has issued a dbopn (or dfopn() function), 
enter ZUDFM TRACE. 

See "TPFDF R1 Utilities" for more information about the ZUDFM TRACE command.



5.0  TRADEMARKS
_______________

The following terms are trademarks of the International Business
Machines Corporation in the United States, or other countries,
or both:

IBM
VisualAge 


Other company, product, and service names may be trademarks
or service marks of others.

THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.
IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED,
INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS
FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO
THE INFORMATION IN THIS DOCUMENT.  BY FURNISHING THIS DOCUMENT,
IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS.

Copyright IBM Corporation 2002.  All rights reserved.