 
 
 
                     MPX-32TM Utilities
                       Revision 3.4.0
 
               READ BEFORE USING REVISION 3.4.0
 
 
These Software Release Notes contain specific information to this 
release, including usage information that is not included in the 
MPX-32 Utilities Revision 3.4.0 Reference Manual.
 
December 1992
 
 
 
 
 
 
 
 
 
324-006710-300
 
 
    This manual is supplied without representation or warranty 
    of any kind.  Encore Computer Corporation therefore assumes 
    no responsibility and shall have no liability of any kind 
    arising from supply or use of this publication or any material 
    contained herein.
 
    The information contained herein is proprietary to Encore 
    Computer Corporation and/or its vendors, and its use, 
    disclosure or duplication is subject to the restrictions 
    stated in the Encore Computer Corporation license terms and 
    conditions or the appropriate third-party sublicense agreement.
 
    Use, duplication, or disclosure by the Government is subject 
    to restrictions as set forth in subdivision (c) (1) (ii) of 
    the Rights in Technical Data and Computer Software clause 
    at 252.227.7013.
 
 
 
 
    Encore Computer Corporation
    6901 West Sunrise Boulevard
    Fort Lauderdale, Florida  33313
 
 
    MPX-32, SelCONNECTION, and Encore RSX are trademarks of 
    Encore Computer Corporation.
 
    AID is a trademark of International Software Corporation.
 
    CONCEPT/32 is a registered trademark of Encore Computer Corporation.
 
 
    Copyright 1992 by Encore Computer Corporation
    All Rights Reserved
    Printed in the U.S.A.
 
 
Contents
___________________________________________________________
 
1 Overview
 
  INTRODUCTION
  DOCUMENTATION CONVENTIONS
 
2 Contents of this Revision
 
  INTRODUCTION
  BINARY DISTRIBUTION
    Model Numbers
    Merchandising Number for MPX-32 Development System II
    Revision Date
  SOURCE DISTRIBUTION
    Model Numbers
    Revision Date
  PREREQUISITE
  DOCUMENTATION DELIVERED WITH THIS PRODUCT
 
3 Product Information
 
  PRODUCT DESCRIPTION
  RELEASE HISTORY
  PACKAGE FORMAT
  BINARY TAPE FORMAT
  BINARY PACKAGE DISK SPACE REQUIREMENTS
  SOURCE TAPE FORMAT
  SOURCE PACKAGE DISK SPACE REQUIREMENTS
  INSTALLATION ENVIRONMENT REQUIREMENTS
 
4 Differences Between Revisions 3.3 and 3.4.0
 
  INTRODUCTION
  IEEE 754 FLOATING POINT SUPPORT
 
5 Installation
 
  INSTALLATION INSTRUCTIONS
 
6 Product Hints
 
  FILES SPECIFICATION FOR CATALOG
  TSA SPECIFICATION FOR CATALOG
 
7 Resolved Problems
 
  LISTING OF RESOLVED SPRs
 
A Binary Tape Contents
 
B Source Tape Contents
 
 
1  Overview
___________________________________________________________
 
 
INTRODUCTION      
 
    This document, the MPX-32 Utilities Revision 3.4.0 Software 
    Release Notes, is provided to customers purchasing or upgrading 
    to Revision 3.4.0.  It describes changes to MPX-32 Utilities 
    from Revision 3.3 to Revision 3.4.0 as well as providing 
    other revision-specific information.
 
    IMPORTANT:  Read the Software Release Notes before attempting 
    to install or use the Revision 3.4.0 software.  Besides providing 
    an overview of the revision, this document contains critical, 
    late-breaking information about the product that is not 
    documented elsewhere.
 
    This information appears on the product tape as SRN_UTIL_3.4.0.  
    This upper/lowercase file can be printed from TSM or examined online.
 
DOCUMENTATION CONVENTIONS     
 
    NOTE:  The documentation conventions concerning type fonts 
    apply only to the hardcopy version of this document. 
 
Lineprinter and Lineprinter bold
    Lineprinter and Lineprinter bold are used in examples.
    Lineprinter bold specifies what you must enter and lineprinter
    specifies the machine output.
 
    TSM>VOLMGR
    VOL>
 
Italics
    In the syntax line and examples, italic words represent variable 
    expressions that must be replaced with a value or exact term.  
    In the following example, the device mnemonic must be substituted 
    for devmnc.
 
    AS TAP TO DEV=devmnc BLO=N
 
 
2   Contents of this Revision
________________________________________________________
 
 
INTRODUCTION     
 
    Information on various MPX-32 Utilities distribution 
    components is given in this chapter, as are model numbers.  
    The following are the components of the distribution:
 
    o	Binary tape
    o	Source tape
    o	Documentation
 
BINARY DISTRIBUTION     
 
Model Numbers    
 
    The following model numbers apply to the binary 
    distribution.
 
             Tape              Model Number     System
 
        Binary Single System     1407-330(3/B)  32/67xx, SelCONNECTION
        Binary Single System     1407-430(3/B)  32/97xx, 32/2030
        Binary Single System     1407-530(3/B)  32/2040, 32/2050, RSX 
 
Merchandising Number for MPX-32 Development System II
 
    Model Number 1731-X3 is a merchandising number which 
    includes the following binary products:
 
        Model Number     Release Description
 
         1401-X3       MPX-32 Operating System
         1407-X3       MPX-32 Utilities
         1724-03       MPX-32 Toolkit (includes
                       1020-03 Programmable Editor)
         1577-03       Taskwatch
         1417-03       AID (Automatic Interactive Debugger)
 
Revision Date    
 
    December 1992
 
SOURCE DISTRIBUTION     
 
Model Numbers    
 
    The following list contains model numbers for the 
    source distribution.
 
           Tape                 Model Number
 
    Source Single Facility        1407-032(3/B)
    Source Single System          1407-039(3/B)
 
Revision Date    
 
    December 1992
 
PREREQUISITE     
 
    The MPX-32 Utilities Revision 3.4.0 requires the use of 
    MPX-32 Revision 3.4U03 or later.   The MPX-32 operating 
    system must be installed first.
 
    Additional prerequisites for source processing are:
 
    o	FORTRAN 77+ Revision 5.2.0 or later
    o	SRTL Revision 5.2.0 or later
 
    Note:  MPX-32 Utilities Revision 3.4.0 Binary Single System 
           must be installed first.
 
DOCUMENTATION DELIVERED WITH THIS PRODUCT     
 
    One set of the following documentation is supplied with 
    Model No. 1407.  Additional copies of these documents can be 
    ordered by part number.  SUS customers upgrading from Revision 3.3 
    receive only Change Package 1 and the Software Release Notes.
 
    Part No.         Description
    --------         -----------
    DS-1407          MPX-32 Utilities Revision 3.4.0 Documentation Set
                     which includes:
 
    323-004590-200   MPX-32 Utilities Revision 3.3 Reference Manual        
    323-004590-201   MPX-32 Utilities Revision 3.4.0 Reference Manual        
                     Change Package 1
    324-006710-300   MPX-32 Utilities Revision 3.4.0 Software Release Notes  
 
 
3   Product Information
__________________________________________________________
 
 
PRODUCT DESCRIPTION     
 
    MPX-32 Utilities is a collection of utilities supporting the
    MPX-32 operating system.  It includes utilities that 
    build object programs, load modules, datapool dictionaries, 
    and subroutine libraries, as well as a media conversion 
    utility and a text editor. Unsupported utilities include 
    a file manager and symbolic debugger.
 
RELEASE HISTORY     
 
    The following is the release history of this product: 
 
                Description          Level       Date
 
    Enhancement Release              3.0      August 1987
    Update Release to base 3.0       3.0U01   October 1987	
    Update Release to base 3.0       3.0U02   May 1988
    Maintenance/Enhancement Release  3.1      January 1989
    Maintenance/Enhancement Release  3.2      January 1990
    Update Release to base 3.2       3.2U01   April 1990
    Update Release to base 3.2       3.2U02   June 1990
    Update Release to base 3.2       3.2U03   September 1990
    Update Release to base 3.2       3.2U04   January 1991
    Internal Update to base 3.2      3.2U05   June 1991
    Update Release to base 3.2       3.2U06   August 1991
    Enhancement Release              3.3      March 1992
    Maintenance/Enhancement Release  3.4.0*   December 1992
 
   * A new software revision numbering policy is in effect.  
     Beginning with this release, MPX-32 Utilities is using the 
     following numbering system.  
 
     Released product revision numbers will now contain three fields:
     x.y.z.  An original release of a product is Revision 1.0.0.  
     The x field increments when the product releases in full 
     with significant new features introduced.  The y field increments 
     when the product releases in full with less significant 
     enhancements and/or fixes introduced.  The z field increments 
     when interim revisions are released containing isolated 
     modifications and/or enhancements.  If the interim revision 
     is a partial product update, U# is appended to the revision number 
     of the last full release, with # incrementing with release of
     each subsequent partial product update.
     
     Revision 3.4.0 of MPX-32 Utilities indicates that this product 
     is a full revision introducing enhancements and fixes since
     Revision 3.3.
 
 
PACKAGE FORMAT     
 
    The MPX-32 Utilities Revision 3.4.0 tape is a standard 
    1/2" 9-track magnetic reel recorded at 1600 or 6250 BPI.
 
 
BINARY TAPE FORMAT     
 
    The binary tape contains 49 files in four Volume Manager 
    save images. Refer to Appendix A of this document for a 
    complete list of the images and files contained on the 
    binary tape.
 
BINARY PACKAGE DISK SPACE REQUIREMENTS     
 
    A minimum of approximately 4500 blocks of available 
    disk space is required for this installation.
 
SOURCE TAPE FORMAT     
 
    The source tape contains 25 files in three Volume Manager 
    save images. Refer to Appendix B of this document for a 
    complete list of the images and files contained on the 
    source tape.
 
SOURCE PACKAGE DISK SPACE REQUIREMENTS     
 
    A minimum of approximately 6500 blocks of available space 
    is required for the source package processing. 
 
INSTALLATION ENVIRONMENT REQUIREMENTS     
 
    o  The MPX-32 Revision 3.4U03 or later operating system must be 
       installed before installing MPX-32 Utilities Revision 3.4.0.
 
    o  The MPX-32 Utilities Revision 3.4.0 Binary Single System must 
       be installed before installing and processing the source.
 
 
4   Differences Between Revisions 3.3 and 3.4.0
__________________________________________________________
 
 
INTRODUCTION     
 
    This chapter contains the differences between revisions 
    3.3 and 3.4.0 of MPX-32 Utilities.
 
IEEE 754 FLOATING POINT SUPPORT
 
    The Macro Assembler and Catalog utilities now support IEEE 754 
    floating point format.
 
    The generation of IEEE 754 floating point data can only take 
    place on an RSX or CONCEPT 32/2050 processor.  The code must be 
    purely sectioned with Assembler options 18 and 55 set.
 
    Option 55 can be set prior to invoking ASSEMBLE or within
    code using the ASSEMBLE OPTS and OPTR directives.  If option
    55 is set prior to invoking ASSEMBLE but not option 18,
    ASSEMBLE sets option 18, outputs a message to that effect,
    and produces sectioned code.  If option 55 is set using an
    OPTS directive and option 18 was not set prior to invoking
    ASSEMBLE, ASSEMBLE will output a fatal error message and
    abort.
 
    When option 55 is set, all floating point data constants (E, R)
    are represented in IEEE 754 format.  If option 55 is not
    set, Encore's Excess 64 format is represented.  The object
    produced is typed according to its floating point format.
    CATALOG checks the types of the object being combined into a
    load module.  If a combination of IEEE 754 and Excess 64
    object code formats are detected, CATALOG aborts.
 
    For more information about IEEE 754 floating point format,
    refer to the ANSI/IEEE Std. 754.
 
 
5  Installation
_______________________________________________________
 
 
INSTALLATION INSTRUCTIONS     
 
    To install either of the MPX-32 Utilities tapes on 
    your system, do the following:
 
    1. Mount the tape on an appropriate unit.
 
    2. Log on as SYSTEM, invoke OPCOM, and offline MPX-32 
       online help:
 
          TSM>OPCOM
          ??>OFFLINE HELP 
          ??>X
          TSM>
 
    3. Assign the installation device as follows:
 
          TSM>AS TAP TO DEV=devmnc BLO=N
 
    4. Invoke the Volume Manager:
 
          TSM>VOLMGR
 
    5. Skip the first image (this SRN) if you do not desire 
       to have it online:
 
          VOL>SKIP IMAGE
 
    6. Restore the desired images from the tape by repeating 
       the following once for each image you wish to restore.
       A list of the images and files for the binary and source
       tapes are given in Appendix A and B of this document,
       respectively.
 
          VOL>RESTORE VOLUME=SYSTEM
 
    7. Exit the Volume Manager:
 
          VOL>EXIT
          TSM>
 
    8. Invoke OPCOM and put help online:
 
          TSM>OPCOM
          ??>ONLINE HELP 
          ??>X
          TSM>
 
 
6  Product Hints
_________________________________________________________
 
 
FILES SPECIFICATION FOR CATALOG      
 
    Both the source and binary build JCL files are set up to 
    build CATALOG with a FILES specification of 220.  Depending 
    on the size of the operating system, CATALOG may not be 
    able to be executed because not enough memory is available 
    to reserve for the 220 files. If this happens, the FILES 
    specification for CATALOG in the binary build JCL file 
    should be lowered to a number that represents the desired 
    number of file assignments that are to be made in a CATALOG 
    job.  The binary build JCL file should then be executed to 
    build the corrected version of CATALOG.  For reference, 
    the FILES value prior to this release was 35.
 
TSA SPECIFICATION FOR CATALOG
 
    Prior to Revision 3.2U03, CATALOG was built so that its 
    TSA would be in nonextended memory.  Starting with 
    Revision 3.2U03, CATALOG is built to run with its TSA 
    in extended memory.  Due to a problem in the MPX-32 
    operating system, programs running with their TSAs in 
    extended memory may abort unnecessarily.  This problem 
    is corrected in MPX-32 Revision 3.5U01.  Therefore, 
    the 3.2U03 or later version of  CATALOG must be rebuilt 
    for it to be used on MPX-32 Revision 3.5 or 3.5U00A.  
    This can be accomplished in two ways.  First, the object 
    processing JCL file, UTILIJCL can be modified to produce 
    a version of CATALOG that runs with its TSA in 
    nonextended memory. This is done by changing the EXTDMPX 
    directive keyword TSA to NOTSA in the CATALOG directive 
    stream used to build CATALOG.  The other method of 
    modifying CATALOG involves using DDUMP to modify the 
    CATALOG load module.
 
    The DDUMP command sequence to correct CATALOG is as follows:
 
       TSM> DDUMP CATALOG
 
    Hit the space bar to bring up the DDUMP Patch prompt.
 
    Clear the extended TSA flag bit:
 
       0,2D,00000000
 
    Hit the space bar and then a <CR> to exit.
 
 
7  Resolved Problems
___________________________________________________________
 
 
LISTING OF RESOLVED SPRs     
 
    Table 7-1 lists SPRs filed against MPX-32 Utilities that 
    were resolved during development of Revision 3.4.0.
 
                          Table 7-1
 
       System Problem Reports Resolved in Revision 3.4.0
 
        SPR Number    Utility      Description
        ----------   -------      -----------
 
        87000791     LIBED        The second of two LIBED tasks goes into loop 
                                  after resumed from wait state.
 
        87000798     CATALOG      Cataloger abort with M.TEMP file error 11 or 
                                  IO98 and VM31.
 
        87001571     EDIT         EDIT aborts RM38 on dual port workfile 
                                  (dptry>0).
 
        87001959     EDIT         Terminal hangup after EDIT abort
 
        88001652     ASSEMBLE     ASSEMBLER not normalizing most negative 
                                  floating point literals
 
        88001696     CATALOG(DOC) Request for doc. addition stating
                                  library assignment limitations
                   
        88002028     LIBED        Multiple batched libed jobs with same
                                  SLOF file generate RM22 on LFC UT
               
        89000179     CATALOG      cataloger placing incorrect transfer
                                  address in lm
               
        89000722     ASSEMBLE     Use of second macro library assigned to
                                  LFC=MA2 slows assembly time
 
        89000881     EDIT         EDIT aborts with MF01.
 
        89001016     EDIT         In EDIT unable to use "use" command on 
                                  existing WRKFL if no write access to dir
 
        89001018     EDIT         Edit goes into infinite loop or aborts with 
                                  MF01 receiving garbage over line.
 
        89001042     ASSEMBLE     Assembler aborts with an "AS08" or aborts 
                                  with an "AS07"
 
        89001092     MEDIA        MEDIA does not properly convert ASCII
                                  to EBCDIC
 
        89001184     MACLIBR      If dir is on different volume MACLIBR
                                  will not change file during a batch job.
 
        90000006     UPDATE       Text field corrupted on INSERT
                                  directive when name greater than 8 chrs.
                                 
        90000299     MEDIA        If one file exists, but is empty
                                  Media returns with no errors.
                                  
        90000542     ASSEMBLE     Assembler should check for negative value 
                                  in REZ.
 
        90000555     ASSEMBLE     Empty lines at the end of an Assembler 
                                  Program bring the error message 
                                  'EOF WITHOUT END CARD'.
 
        90000592     CATALOG      The cataloger returns dual error messages.
 
        90000707     CATALOG      CATALOG hangs in an infinite loop.
 
        90000780     CATALOG(DOC) Incorrect help file for CATALOG.
 
        91000055     MACLIBR      Maclibr abort with an RT69.
 
        91000393     MACLIBR      If macro on different volume than
                                  library, library not modified
 
        91000394     ASSEMBLE     Assemble compiler.
 
        91000580     LIBED        LIBED fails to find end of library under 
                                  certain condiitions
 
        91000647     MEDIA        Unexpected behavior using 0 as
                                  argument to directives.
 
        91000662     CATALOG      TCM deletes object module when recataloging 
                                  with no available directory entries
 
        91000837     CATALOG      Cataloger aborts when simultaneously
                                  building large tasks with AID Debugger 
                                  options.
 
        92000183     ASSEMBLE     ASSEMBLE aborts from a privilege violation
                                  trap (PV01) or AD02.
 
        92000209     ASSEMBLE     Segmented module >.5 meg truncates address
                                  field to zero
 
        92000275     CATALOG      Request for AID debugger support for 
                                  cataloging main with 100 overlays.
 
        92000356     DPEDIT       DPEDIT abts - DP07 if SYC assigned to file 
                                  written with EDIT WRI or PE
 
        92000410     CATALOG      TCMS - CATALOG not issuing a warning when 
                                  directory does not exist
 
        92000470     LIBED/       Sequence error in large object files
                     CATALOG
 
A  Binary Tape Contents    
___________________________________________________________
 
    The four Volume Manager save images on the binary tape
    are as follows:
 
    o Image 1 contains the Software Release Notes file.
 
    o Image 2 contains Utilities load modules, error files, 
      online help.
 
    o Image 3 contains Utilities object modules, their error 
      files, and object processing JCL file.
 
    o Image 4 contains object modules, load modules, and 
      JCL file for unsupported utilities SYMDB and FILEMGR. 
 
    For more information on object module processing, refer to 
    the object processing JCL files, UTILIJCL and UTILIUNSP.
 
    Image 1
 
      1     @SYSTEM(SYSTEM)SRN_UTIL_3.4.0
 
    Image 2
 
      1     @SYSTEM(HELP)UTIL.HLP     
      2     @SYSTEM(HELP)UTIL.TXT    
      3     @SYSTEM(SYSTEM)AS.ERR   
      4     @SYSTEM(SYSTEM)ASSEMBLE
      5     @SYSTEM(SYSTEM)CATALOG
      6     @SYSTEM(SYSTEM)CT.ERR
      7     @SYSTEM(SYSTEM)DP.ERR      
      8     @SYSTEM(SYSTEM)DPEDIT     
      9     @SYSTEM(SYSTEM)ED.ERR    
     10     @SYSTEM(SYSTEM)EDIT     
     11     @SYSTEM(SYSTEM)LE.ERR  
     12     @SYSTEM(SYSTEM)LIBED  
     13     @SYSTEM(SYSTEM)MAC.DIR
     14     @SYSTEM(SYSTEM)MAC.LIB      
     15     @SYSTEM(SYSTEM)MACLIBR     
     16     @SYSTEM(SYSTEM)MD.ERR     
     17     @SYSTEM(SYSTEM)ME.ERR    
     18     @SYSTEM(SYSTEM)MEDIA    
     19     @SYSTEM(SYSTEM)UD.ERR  
     20     @SYSTEM(SYSTEM)UPDATE 
 
    Image 3
 
      1     @SYSTEM(OBJECT)OJ.AS.ER    
      2     @SYSTEM(OBJECT)OJ.ASSM    
      3     @SYSTEM(OBJECT)OJ.CATL   
      4     @SYSTEM(OBJECT)OJ.CT.ER 
      5     @SYSTEM(OBJECT)OJ.DP.ER
      6     @SYSTEM(OBJECT)OJ.DPED     
      7     @SYSTEM(OBJECT)OJ.ED.ER   
      8     @SYSTEM(OBJECT)OJ.EDIT   
      9     @SYSTEM(OBJECT)OJ.LE.ER 
     10     @SYSTEM(OBJECT)OJ.LIBED
     11     @SYSTEM(OBJECT)OJ.MACLE   
     12     @SYSTEM(OBJECT)OJ.MACLS  
     13     @SYSTEM(OBJECT)OJ.MD.ER     
     14     @SYSTEM(OBJECT)OJ.ME.ER    
     15     @SYSTEM(OBJECT)OJ.MEDIA   
     16     @SYSTEM(OBJECT)OJ.UD.ER  
     17     @SYSTEM(OBJECT)OJ.UPDAT 
     18     @SYSTEM(SYSTEM)UTILIJCL
 
    Image 4
 
      1     @SYSTEM(OBJECT)OJ.DB.ER    
      2     @SYSTEM(OBJECT)OJ.FM.ER   
      3     @SYSTEM(OBJECT)OJ.FMGR   
      4     @SYSTEM(OBJECT)OJ.SYMDB 
      5     @SYSTEM(SYSTEM)DB.ERR  
      6     @SYSTEM(SYSTEM)FILEMGR
      7     @SYSTEM(SYSTEM)FM.ERR
      8     @SYSTEM(SYSTEM)MPXDB        
      9     @SYSTEM(SYSTEM)SYMDB       
     10     @SYSTEM(SYSTEM)UTILIUNSP  
 
 
 
B  Source Tape Contents    
___________________________________________________________
 
    The three Volume Manager save images on the source tape 
    are as follows:
 
    o Image 1 contains the Software Release Notes file.
 
    o Image 2 contains Utilities source files, error files, 
      and source processing JCL file.
 
    o Image 3 contains source files and JCL file for 
      unsupported Utilities SYMDB and FILEMGR. 
 
    For more information on source processing, refer to the 
    source processing JCL files, UTILSJCL and UTILSUNSP.
 
    Image 1
 
      1   @SYSTEM(SYSTEM)SRN_UTIL_3.4.0   
 
    Image 2
 
      1   @SYSTEM(SYSTEM)UTILSJCL      
      2	  @SYSTEM(UTILINSTALL)SJ.AS.ER
      3	  @SYSTEM(UTILINSTALL)SJ.ASSM
      4	  @SYSTEM(UTILINSTALL)SJ.CATL   
      5   @SYSTEM(UTILINSTALL)SJ.CT.ER 
      6   @SYSTEM(UTILINSTALL)SJ.DP.ER
      7   @SYSTEM(UTILINSTALL)SJ.DPED   
      8   @SYSTEM(UTILINSTALL)SJ.ED.ER 
      9   @SYSTEM(UTILINSTALL)SJ.EDIT 
     10   @SYSTEM(UTILINSTALL)SJ.LE.ER 
     11   @SYSTEM(UTILINSTALL)SJ.LIBED
     12   @SYSTEM(UTILINSTALL)SJ.MACLE  
     13   @SYSTEM(UTILINSTALL)SJ.MACLS  
     14   @SYSTEM(UTILINSTALL)SJ.MD.ER  
     15   @SYSTEM(UTILINSTALL)SJ.ME.ER 
     16   @SYSTEM(UTILINSTALL)SJ.MEDIA
     17   @SYSTEM(UTILINSTALL)SJ.UD.ER  
     18   @SYSTEM(UTILINSTALL)SJ.UPDAT 
 
    Image 3
 
      1	  @SYSTEM(SYSTEM)UTILSUNSP    
      2   @SYSTEM(UTILINSTALL)SJ.DB.ER     
      3   @SYSTEM(UTILINSTALL)SJ.FM.ER     
      4	  @SYSTEM(UTILINSTALL)SJ.FMGR     
      5	  @SYSTEM(UTILINSTALL)SJ.PRE.SYMDB
      6	  @SYSTEM(UTILINSTALL)SJ.SYMDB     
 
