|  | It's going to be free & shipped with Digital Unix. Meanwhile there's a version
in external Field Test. We're already hard at work on the succeeding
all-new-and-improved version... It's been moved to a portasst subdirectory off
the public ftp area since the note below was written.
						Trace
            <<< CLT::DISK$CLT_LIBRARY3:[NOTES$LIBRARY]FUSE.NOTE;1 >>>
                            -< DEC FUSE - UNIX SDE >-
================================================================================
Note 15.1          Digital Porting Assistant kit announcements            1 of 2
UHUH::TALCOTT                                       184 lines  11-MAR-1995 12:43
    -< Digital Porting Assistant T1.0-1 (EFT1)  for OSF/1 AXP is available >-
--------------------------------------------------------------------------------
   Digital Porting Assistant T1.0-1 EFT Kit for OSF/1 V3.0 and higher is now
	    available in caboom::port_assist_t10.tar
	***  DIGITAL EQUIPMENT CORPORATION - INTERNAL USE ONLY ***
  The Digital Porting Assistant is a set of tools that identifies source code
 (C and C++) that might not compile or run on Alpha OSF/1.  The Digital Porting
 Assistant can locate the following potential problems:
  - Conditional code that might also need an Alpha OSF/1 branch
  - #include references to files that don't exist
  - calls to library functions that don't match Alpha OSF/1 definitions
  - 32-bit dependencies
  - calls to library functions with different semantics on Alpha OSF/1
  It helps the developer understand the problems that it uncovers by:
  - explaining the semantic differences in functions on different platforms
  - providing detailed help on many individual diagnostics
  - providing porting tips that complement Digital's extensive porting guides
  It provides the following features that aid in fixing the problems
  encountered:
  - lets the developer work on a limited domain of problems at a time
  - suggests a useful order to tackle the problem domains
  - steps the developer though the problems one at a time bringing each one
    into their editor, so it can be fixed
  - provides a global search/replace facility to make changes across files
  - filters out unwanted diagnostics
  - reruns checks at the developer's request after they've made changes
2.  COPYING THE DOCUMENTATION
      Files:    decfuse_V20_debugui.ps
		decfuse_V20_handbook.ps
		port_assist_T10_osf_install_sheet.ps and .txt
      To copy over DECnet, enter for each file:
	  # dcp caboom::< file.ps > .
      To copy over TCP/IP:
	  a. Use the ftp command to login to the caboom system:
	     # ftp caboom.zko.dec.com
	     Name: anonymous
	     Password: < your-login-name >
	     The system displays informational messages.
	  b. At the ftp> prompt, enter for each file:
	     ftp> get < file.ps >
3.  COPYING AND INSTALLING THE KIT
   For more information about using the setld utility, registering a license,
   or to view a sample installation, see the DEC FUSE Installation Guide.
				**NOTE**
   The CXXSHRDA305 and LDB3016 kits in the kit area are based on code
   that shipped with OSF/1 V3.2, but they work on OSF/1 V3.0. You must use
   these subsets to run the Porting Assistant on OSF/1 V3.0. If installing on a
   V3.2 or newer system, you can use the kits that shipped with the system,
   Required:			        Subset Name	In kit area as:
       DEC OSF/1 Base System		OSFBASE300
       DEC OSF/1 Networking Utilities	OSFCLINET300
       Software	Development Utilities	OSFPGMR300
       On Line Manual Pages		OSFMAN300
       Document Preparation Software    OSFDCMT300
       Adobe Fonts                      OSFAFM300
       DEC C++ Shared Libraries		CXXSHRDA305   CXXSHRDA305-OSF1-V3.0.tar
   Optional:				Subset Name
       DECladebug Debugger		LDBBASE3016   LDB3016-OSF1-V3.0.tar
4. Installing the Digital Porting Assistant:
      1. Log in as superuser (login name root ) to the system where you are
         installing.
      2. Move to a directory that has sufficient disk space in which to copy
         the kit.
      3. Set your path to include /usr/sbin .
	    # PATH=/usr/sbin:$PATH
	    # export PATH
      4. Delete any currently installed older versions of the Porting
         Assistant subsets.  Enter the following to list subsets with a name
	 that starts with FUS:
		     # setld -i | grep FUSPORT
         For each Porting Assistant subset shown in the list, use the setld -d
	 command to remove it. For example to remove the FUSPORTBASE100 subset,
	 enter:
		     # setld -d FUSPORTBASE100
      5. Copy the Porting Assistant T1.0-1 kit to your workstation.
	 To copy over DECnet:
	     # dcp -i caboom::port_assist_eft1.tar .
         To copy over TCP/IP:
	     a. Use the ftp command to login to the caboom system:
		     # ftp caboom.zko.dec.com
		     Name: anonymous
		     Password: < your-login-name >
		     The system displays informational messages.
	     b. At the ftp> prompt, enter:
		     ftp> binary
		     ftp> get port_assist_t10.tar
		The system displays informational messages.
	     c. After the tar file is transferred, quit the session:
 		     ftp> quit
      6. Unpack the tar file:  # tar xmpf port_assist_t10.tar
         After unpacking the tar file, you can remove it from the directory
         where you copied it.
      7. Enable the software licenses
	 This version of the Porting Assistant requires a FUSE PAK. This will
	 change in a future release. Use VTX PAK to acquire and install the
	 following PAK:
			FUSE-USER
	 Refer to the "Guide to Software License Management" manual in the DEC
	 OSF/1 documentation set for further information.
      8. Enter the following command to start the installation script.
		     # setld -l .
	The installation script installs the software and displays messages
        describing the installation.
5.  After installing the Digital Porting Assistant:
     1. Run the IVP
		     # setld -v FUSPORTBASE100
        The script displays the Porting Assistant Control Panel. To exit, click
	on the Tools menu and choose the Exit menu item.  The script exits
	the Porting Assistant and displays a message stating that the
	installation has been verified.
     2.	If the installation procedure does not find the binary for EMACS, it
	prompts you to add a link.  Enter the following command and replace
	<emacs_path> with the pathname where the EMACS binary is found:
	   # ln -s <emacs_path>/emacs /usr/opt/port/bin/fuse_emacs
5.  KIT REGISTRATION
	Please send mail to CABOOM::FUSE after you have copied the kit.
        Provide information regarding the machine configuration on which FUSE
	is.
		- OS Revision
		- Window system revision
		- Swap
		- Memory
6.  NOTESFILE LOCATION
	The Porting Assistant shares the DEC FUSE Notes conference, located at
	CLT::FUSE.  To add the notesfile to your notebook use the
	Notes> add/entry fuse/file=CLT::FUSE command.  In addition, there is a
	news-to-notes gateway for accessing the Notes conference.  The news
	conference is called: dec.notes.applications.fuse
7.  FILING PROBLEM REPORTS
   The Porting Assistant is using a QAR database.
   SET HOST to LEGO and login to QAR_INTERNAL, password: QAR. Use the
   PA_T10 QAR database.
 |