 
     * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
     *                   AFP Workbench for Windows                     *
     *                        Version 2.00                             *
     *                   Corrective Service Diskette                   *
     * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 
The "IBM AFP Workbench for Windows:  Technical Reference" is a softcopy
publication available in the Workbench's \DATA subdirectory as AFPTECH.DOC.
Be sure to read the 'Helpful Hints for the Viewer' and 'Preparing Your AFP
Files for the Viewer' chapters contained in this reference.
 
This READ.ME file contains additional information for using the Viewer.
Included are the following sections:
 
 @ Installation Notes
 @ Viewer on a Network Server or Client
 @ New Feature in this CSD
 @ Some of What's New in Version 2.00
 @ Future Migration Considerations
 @ Troubleshooting
 @ Integration and Customization
 @ User Defined Paper Sizes
 @ Sonoran Font Solution Available
 @ Windows Host File Download Utility
 
*******************************************************************************
 
@ Installation Notes
  ------------------
 
1. The install program will install this CSD in your Viewer directory.
   You should make copies of any files that you have modified, such as font
   definition or code page map files.  Then you may want to check the Overwrite
   files checkbox on the 2nd install panel, OTHERWISE, for all installing
   files that have a newer date than the files on your system, the install
   program will ask you if you want to overwrite them.  It is recommended that
   you do replace them.
 
2.  Before installing Adobe Type Manager(ATM) version 2.5 over an existing
    version of ATM on your system, you must first edit the Boot section
    of your Windows SYSTEM.INI file.
    Replace the following 2 lines:
          SYSTEM.DRV=ATMSYS.DRV   and    ATM.SYSTEM.DRV=SYSTEM.DRV
    with the line:
          SYSTEM.DRV=SYSTEM.DRV
    Restart Windows so the above change will take effect and then launch
    the Workbench install.
 
    You may get a "DLL in use" error message if you do not do the above.
    You will also need to do the above if you delete ATM using the Install
    program.
 
3.  If you have the Pennant AFP Printer Driver installed, make sure you
    close down any applications using it before installing the Workbench
    or you will get an error if the install tries to update the driver.
 
4. If you want to remove the AFP Workbench program, you can have the install
   program delete all the files.  To do this, restart the install program
   from the product install diskette #1 (this will not work from CSD
   diskettes; they will only delete the files that they have fixes for)
   and select 'Delete the product and reinstall'.  When the program has been
   deleted, exit the install program when it asks you to begin reinstalling.
 
*******************************************************************************
 
@ Viewer on a Network Server or Client
  ------------------------------------
 
  The IBM AFP Workbench for Windows can be installed locally on your
  PC (see the 'Getting Started' card for install instructions) or
  as an option, the AFP Workbench can be installed on a network
  server for use by multiple workstations.  This network server
  install option is an installation option only, not a licensing
  option.  A separate AFP Workbench for Windows, Version 2.0
  license is required for each workstation that accesses or uses
  the program.  See Chapter 1 of the Workbench Technical Reference
  (afptech.doc file in the Viewer \DATA subdirectory) for more
  details.
 
  Install this CSD on the server.  No changes are needed on the
  the Client workstations unless you install the new component,
  Print It.  If you want your clients to have access to Print It,
  have them create an icon in their 'AFP Workbench - LAN' group
  that points to the Print It executable.  The easiest way to do
  this is tell your clients to do the following:
 
  1) Click once on the Viewer icon so that it becomes hilighted.
    Then select File on Program Manager's menu bar. Select Copy to
    create a copy of the Viewer icon into their 'AFP Workbench-LAN'
    group.
  2) Then select the new icon so that it is hilighted.  Select the
    File pul-down and open the Properties for the new icon.  Change
    the Command Line to point to the Print It executable, FLDWPRT.EXE.
    For example, if their command line reads:
               L:\FLD\FLDWINVW.EXE
    change it to:
               L:\FLD\FLDWPRT.EXE
 
  3) Change the Description from Viewer to Print It.  Then close the
    Properties dialog box by clicking on OK.  The client will have a
    new icon named 'Print It' in their Workbench group.
 
 
*******************************************************************************
 
@ New Feature in this CSD
  -----------------------
 
o PRINT IT
  Print It allows users to print a file without first viewing it.
  Print It uses the same print function as the AFP Workbench Viewer.
  When printing values are modified, either through the Viewer or
  manually in FLDPORT2.INI, both Print It and the Viewer are affected.
 
  The Drag and Drop feature of Windows is very useful with Print It.
  You can select a file from the File Manager dialog box, drag it to the
  Print It icon and drop it.  This will invoke Print It for that file.
  A commmand line interface is available for Print It. See the on-line
  helps for more information about Print It and what it can do for you.
 
*******************************************************************************
 
@ Some of What's New in Version 2.0
  ---------------------------------
 
o ANNOTATION
  Viewer provides a way for you to annotate, or add notes to the AFP documents
  you view.  These notes appear as "little yellow sticky note" icons on the
  viewed document.  Selecting the icon, displays the note for you.
 
o VIEWING OF SCANNED, FAXED AND IMAGE FILES
  Now Viewer supports scan, FAX and image application programs' output files.
  Tag Image File Format (TIFF) and Picture Exchange (PCX/DCX) files can
  be viewed on the Workbench as well as device-indepedent bitmaps (DIB),
  often known as BMP files.  Full color and compression are supported.
 
o NEW EXEC FOR REBLOCKING UPLOADED AFP FILES
  A new REXX EXEC for use on an MVS or VM host system is available with
  this version.  This EXEC, AFRREBLK, and its associated message
  file, AFRREMSG.EXC, can be used to reblock your AFP files that you
  have uploaded to a host system into the required host system format.
  See the chapter on 'The AFP Reblocking Program' in the "Technical
  Reference" for more information.
 
o THE DCF CONNECTION
  The DCF Connection tool of the Workbench allows you to create or edit
  a SCRIPT file on your PC, have it automatically uploaded to an MVS or VM
  host, formatted with Document Composition Facility (DCF), and the result
  viewed with the Viewer application.  The DCF Connection also contains
  AFPView which allows you to view your MVS or VM host AFP documents on
  your PC without having to manually download them.  See 'The DCF Connection'
  chapter in the "Technical Reference" for more information.
 
o NEW PRINTER DRIVER FOR CREATING MO:DCA (AFPDS) FROM WINDOWS APPLICATIONS
  An improved Windows printer device driver, the Pennant AFP Printer Driver,
  has replaced the IBM AFPDS Windows Driver shipped with Version 1.0.
  The Pennant driver can create AFP text as well as image from Windows
  applications such as Wordperfect, Word, AmiPro, etc.  It requires
  Windows 3.1 or WIN-OS/2 under OS/2 2.1.  The AFPDS Windows Driver only
  creates image and works on Windows 3.0. The Pennant AFP Printer Driver
  can be installed from the Windows Control Panel and used the same way as
  the old driver. See the chapter on 'Pennant AFP Printer Driver' in the
  "Technical Reference" and the README.PDD file on Install Diskette 4
  for more information.
 
o TRUETYPE SUPPORT
  The Viewer automatically supports TrueType fonts if Adobe Type Manager is
  not available and/or Type 1 fonts are not available.  See the chapter on
  'Mapping AFP Fonts for the Viewer' in the "Technical Reference" for more
  information.
 
*******************************************************************************
 
@ Future Migration Considerations
  -------------------------------
 
1. The new install program will keep track of where the AFP Workbench is
   installed and all future updates will be installed in the same directory.
 
2. On Corrective Service diskettes, a READ.FIX file will exist that contains a
   list of fixes for that service level.
 
  NOTE: Before installing any Corrective Service, you should backup any Viewer
   files that you have modified, such as font definition or code page map files,
   as the install will overwrite them.  You may want to keep track of changes
   you make as you go along.
 
 
*******************************************************************************
 
@ Troubleshooting
  ---------------
 
1.  ADOBE TYPE MANAGER:
    If you are having a problem with blank or mostly blank pages
    when you expect to see text and you are using ATM 2.0 or below,
    installing ATM 2.5 may fix the problem.  See "AFP Workbench for Windows:
    Getting Started" for information about Viewer ATM settings.
 
    The ATM Read Me file (README.TXT) has been installed in your Windows
    directory.  You can view it with the Viewer, or Notepad or any system
    editor to see more information about ATM.
 
 
2.  INVALID AFP DATA STREAM:
    See the section on 'AFP Data Considerations' in the 'Preparing Your
    AFP Files for the Viewer' chapter in the "Technical Reference" for
    more information.
 
    - AFP structured fields in which the Length parameter does not
      match the actual length of the data, cause problems.  In some
      cases, the record length may have been ignored by PSF.  In
      other cases, padding may have been added or truncated with no
      error reported by PSF.  These problems can often be traced to
      the program that produced the AFP data stream, opening the file
      with a S/370 editor that truncated padding, or specifying the
      wrong parameters when the AFP file was downloaded.
 
      A symptom of host editor data corruption is a missing resource
      message reported by the Viewer where the resource name has an '!'
      as the last character of the name.  For example, if the Viewer
      reported that overlay 'O1ABC!' could not be found, this would
      indicate that bytes have been lost and that less AFP data was
      present than the AFP structured fields defined.
 
3.  PRINTING:
    - When you select the Current page for printing on a Windows
      printer, the current view will be printed with the width
      of the window scaled to fit the width of the printer's
      printable area.  When the same page is printed on a PSF/2
      or PSF/6000 driven printer, the page will print as it was
      created--with the exact AFP placement instructions.
 
    - When printing from the Viewer to either PSF/2 or PSF/6000,
      you must have redirected your port (LPT1, LPT2 or LPT3) to the
      appropriate queue being driven by that PSF.  To define your
      printer, use the documentation provided with WIN-OS/2 or
      Windows and PSF/2 or PSF/6000.
 
 
4.  DOCUMERGE OUTPUT:
    When you view a document that has been processed by the DocuMerge
    product from Image Sciences, Inc. and has not  been formatted using
    the IBM SAA Core Interchange Fonts, you will probably see a text
    fidelity problem--a progressive shifting of each line of text to
    the left.  DocuMerge creates AFP data stream structured fields
    that amplify the differences in font metrics between AFP fonts and
    Type 1 fonts.  Sonoran Metric fonts are now available to solve this
    problem if your document was created with Sonoran fonts.  Contact
    AFP Workbench Service and have them open a PMR requesting these
    fonts and they will be sent to you.
 
 
5.  DOCUMENTS WITH MCF-2 STRUCTURED FIELDS:
    Documents created with DisplayWrite/370 Version 2.1.0 (and earlier)
    and formatted for the 3812 and 4224 logical device types contain
    MCF-2s with GRIDs that incorrectly specify font width.  When
    displaying such documents on the Viewer, the text will usually appear
    smaller than when the document is printed with PSF.  To better view
    the document, you can use the Zoom function to enlarge the view.
    Or, if the document was created with DisplayWrite/370 and you have
    the source, you can reformat the document specifying a device type
    that does not create these MCF-2s, such as 3820 or use the latest
    level of DisplayWrite/370 (2.2.0 or above).
 
 
6.  TEXT FIDELITY:
    -  If the document you are viewing uses a font character set
       or code page not defined to the Viewer, the Viewer will use a
       default.  If the default is not a good match for the undefined
       character set or code page, you will see a different size and
       style of characters or missing or changed characters.  As a result,
       text may not be placed correctly.
 
    -  Sometimes lines (or rules) are placed relative to a text string.
       If the text is misplaced because of the use of a default or
       substitute font, the rules will also be misplaced.  An example
       is that an underscore may be longer than the word being underscored.
       Changing the Text Fidelity setting may help alignment in some cases.
 
    -  If the Viewer is not substituting fonts (i.e. your document was created
       with Core fonts) and your text alignment still seems a bit off,
       espcially in 'Character' text fidelity mode, it may be because your
       document was created with 300-pel metrics rather than 240-pel
       metrics.  Documents created with the Pennant AFP Printer Driver use
       300-pel (or RIMA) metrics.  Overlays from OGL use 240-pel metrics.
       You can tell the Viewer which metrics to use in its text placement
       algorithm by changing a flag in the [Settings] section of the
       FLDPORT2.INI file.  By setting 240Fidelity=FALSE, you tell the
       Viewer to use 300-pel(RIMA) metrics. The default is 240Fidelity=TRUE.
 
 
7.  USING FIND AND FIND NEXT:
    -  In AFP documents, the actual text you see can be stored in
       multiple AFP data stream structured fields.  That is, when the
       text "2190 Lancaster Road NE" appears on the page, it is possible
       that the text in the file is stored in four fields:  "2190",
       "Lancaster", "Road", "NE".  The Find and Find Next functions
       will not find "2190 Lancaster" if "2190" and "Lancaster" are
       stored in separate fields.  When text is broken into fields,
       the blanks between fields are frequently not in the file at
       all and so cannot be located by the Find function.
 
 
8.  PENNANT AFP PRINTER DRIVER:
    When you install the Pennant AFP Printer Driver, you may get a message
    box from the installer program that asks for the SSERIFE font.
    This font is available on a Windows 3.1 diskette and can be installed
    if you wish.  However, the printer driver does not use this font,
    so you may just ignore this message (select OK in the message box)
    and the printer driver will install successfully.
 
    When you use the printer driver to print selected pages,
    each set of pages is sent as a separate print job.  When you are
    printing to a file, this means you will be asked to enter a file
    name for each set of pages.  For example, if you select pages 1
    through 3 and page 5, one file will be created for pages 1-3 and
    another file will be created for page 5.
 
    If your output is not what you expected when you print to a file using
    the Pennant AFP printer driver consider the following:
 
     When printing with the Pennant AFP driver, set the size of the output
     page in the "Paper size" combo box of the Pennant AFP driver's Setup
     dialog.  The default is 8.5 x 11 inches.  The Paper Size setting
     remains in effect for that session unless you change it.
 
     The amount of data to be printed is affected by the 'Print Whole Page'
     radio button or the 'Print Current View' radio button checked in the
     Print dialog box and your current view, e.g. whether you've selected
     an area, whether Autosize is on or off, what the current Zoom factor
     is, and what your Paper Size is (for example, a legal size page will
     not fit in the output file if 8.5 x 11 paper size is selected and will
     be truncated).  The data to be printed is also affected by the Print
     Text radio button selected in the Pennant AFP Setup Options dialog box.
 
 
9.  UNABLE TO OPEN A FILE IN TWO VIEWER SESSIONS
    If you are unable to open a file on a local drive that is already
    open in another Viewer session, check the following:
 
    Edit your AUTOEXEC.BAT and CONFIG.SYS files.  If there is a line with
    the DOS 'SHARE' command, comment that line out.  Run the AUTOEXEC.BAT
    file or re-boot your system, and then re-try opening the same file in
    your two Viewer sessions.
 
 
10. COPYING TEXT TO THE CLIPBOARD
    If the file being viewed contains rotated text or small fonts,
    unexpected results may occur if the 'Copy (Text)' item of the Edit
    menu is selected.  The data copied to the Clipboard may be different
    than the area selected. Using the 'Copy (Bitmap)' is recommended in
    these cases.
 
 
11. COLORS DISAPPEARING ON A COLOR BACKGROUND
    Some colors in your document will not show up on a colored background
    if you have a Cache Size set to greater than zero in the Preferences
    dialog box.  In this case, set your Cache size to zero (which turns
    caching off).  Another option is to view your data at a zoom factor
    greater than 150%.  Above that factor, caching is not used.
 
*****************************************************************************
 
@ Integration and Customization
  -------------------------------
 
   The AFP Workbench Viewer has some external interfaces that can be
   used for customization in your environment or for communication with
   other programs.  If you are interested in any program integration or
   customization information, call (303)924-VIEW (8439) and ask for the
   "Viewer Integration Document" or contact IBM Service (1-800-237-5511)
   and open a PMR requesting the document.
 
*****************************************************************************
 
@ User Defined Paper Sizes
  -------------------------
   Due to a last minute request, a new function has been quickly added to
   the Viewer.  This function adds two user-definable paper sizes to the
   list of selectable paper sizes.
 
   The paper size on which to display your document is set in the Paper Size
   dialog box accessed from the View pull-down.  The more common paper sizes
   are listed in the dialog box.  However, many documents use non-standard
   paper sizes.  To correctly view these documents, two user-specifiable
   paper sizes have been added to the Paper Size dialog box.  They are
   U1 and U2.  These sizes can be set to the dimensions of any document
   in the Viewer's FLDPORT2.INI file.
 
   To set up the U1 and/or U2 paper size, edit the FLDPORT2.INI
   file.  In the [Misc] section, edit the following lines:
   PaperSize1=12240, 15840
   PaperSize2=12240, 15840
 
   Change the numbers to the width and the length of your paper size
   (where width is the top of the viewed page(assuming no rotation)).
   The numbers must be in 1440th/inch so if your paper size is in
   inches, multiply it by 1440.  If your paper size is in millimeters,
   multiply it by 56.7 and round to the nearest whole number.  Numbers
   must be whole numbers--no fractions are allowed.
 
   Then bring up the Viewer and select U1 in the Paper Size dialog box to
   use PaperSize1 or U2 to use PaperSize2.  To change the paper size again,
   close the Viewer and edit the .INI file paper size or sizes.
 
   If no values are set in the FLDPORT2.INI file, U1 and U2 default to
   8 1/2 by 11 inch paper size.
 
 
*******************************************************************************
 
@ Sonoran Font Solution Available
  -------------------------------
 
   When viewing documents created with the Sonoran Serif or Sonoran
   Sans Serif fonts, you may have experienced fidelity/text alignment
   problems.  A solution to this problem is now available in the form
   of Sonoran metric fonts.  Because Sonoran outlines do not exist,
   these Sonoran metric fonts consist of the Sonoran metrics paired
   with outlines of Times New Roman (for Sonoran Serif) or Helvetica
   (for Sonoran Sans Serif) fonts.
 
   These Sonoran metric fonts provide metrics that match those of the
   Sonoran host raster fonts and offer very high fidelity when viewing
   documents that use Sonoran fonts on the AFP Workbench for Windows.
 
   The Sonoran metric fonts can be installed with Adobe Type Manager
   for use by the AFP Workbench Viewer.  Due to the fact that each
   point size of the Sonoran Serif and Sonoran Sans Serif fonts were
   originally hand-tuned, separate fonts for each of the following
   points sizes are provided:
     6, 7, 8, 9, 10, 11, 12, 14, 16, 18, 20, 24, 30 and 36
 
   To get a copy of these Viewer fonts, contact AFP Workbench Service
   and open a PMR requesting the Sonoran Serif and/or Sonoran Sans
   Serif typeface you need.
 
*******************************************************************************
 
@ Windows Host File Download Utility
  ----------------------------------
 
   A sample utility is provided to download host files and display them
   with the Viewer.  This sample is set up to work with terminal emulator
   programs running under Windows (for example, IBM Personal
   Communications/3270). This sample only supports the 'A' session of a
   terminal emulator program.  Support is available with Communications
   Manager/2 Version 1.1 on OS/2 which will allow a CM/2 session to be
   used.  See VHAPI.DOC file in your Communications Manager \CMLIB
   directory for more information.
 
   NOTE:  It is recommended that you do not use this Download Utility if
   you are using the DCF Connection.  They are not compatible and may
   cause your system to hang.
 
  Installation:
 
   The files needed to run this sample utility are installed when the
   Viewer program is installed.  A file called PCSHLL.DLL must be available
   and should have been installed with the terminal emulator program.
 
     To add an icon for the download utility:
      1. Open the Group window for the group where you want to add the utility
         icon to.
      2. Select New from the Program Manager File menu.
      3. Select Program Item in the New Program Object dialog and select OK.
      4. Type a name for the program in the Description entry field.
      5. In the Command Line entry field, type:
             drive:\dir\FLDWINVW.EXE /D:FLDPORTH.DLL
         where 'drive' and 'dir' specify the complete path name where the
         Viewer program is installed.
      6. Select OK to close the dialog box.
 
  Running the program:
 
   To invoke the sample download program, log on to your host session and
   do either of the following:
     - Double click on the icon created above, or
 
     - Select Run from the Program Manager File menu.
       In the Command Line entry field, type:
             drive:\dir\FLDWINVW.EXE /D:FLDPORTH.DLL
       where 'drive' and 'dir' specify the complete path name where the
       Viewer program is installed.
 
   The Host Transfer dialog box is displayed instead of the Open dialog
   box when the Viewer starts.  In the entry field, type the file
   identifier (for VM) or data set name (for MVS) of the file
   to be downloaded.  Select the Transfer Type based on the type of
   data contained in the file.  For AFP files, use the Binary setting.
 
   After you select OK, the file will be transferred and the first page
   of the file will be displayed.  To download and view another file,
   select Open from the Viewer File menu.
 
   One way to specify the file name on the Host Transfer dialog, is to
   copy the file name  from your host session window to the clipboard.
   The file name on the clipboard will be shown in the entry field when
   the Host Transfer dialog is displayed, if the format is correct.
   If you use this function with MVS, make sure there are quotes
   surrounding fully-qualified data set names.
 
******************************End of File **********************************
