%----------------------------------------------------------------------- %; Copyright (C) 1996 %; Associated Universities, Inc. Washington DC, USA. %; %; This program is free software; you can redistribute it and/or %; modify it under the terms of the GNU General Public License as %; published by the Free Software Foundation; either version 2 of %; the License, or (at your option) any later version. %; %; This program is distributed in the hope that it will be useful, %; but WITHOUT ANY WARRANTY; without even the implied warranty of %; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the %; GNU General Public License for more details. %; %; You should have received a copy of the GNU General Public %; License along with this program; if not, write to the Free %; Software Foundation, Inc., 675 Massachusetts Ave, Cambridge, %; MA 02139, USA. %; %; Correspondence concerning AIPS should be addressed as follows: %; Internet email: aipsmail@nrao.edu. %; Postal address: AIPS Project Office %; National Radio Astronomy Observatory %; 520 Edgemont Road %; Charlottesville, VA 22903-2475 USA %----------------------------------------------------------------------- % README File FOR AIPS Release 15JAN96 % This File describes the patches to known bugs in 15JAN96. See also % the patches.html file; it MUST contain the same information. % placed under RCS control by Pat Murphy; aipspgmr group should have access. % Last modified $Date: 1996/08/13 16:31:46 $ % IMPORTANT: If you performed a binary "load-and-go" installation, and you % do *not* have any Fortran compiler (or your revision of the % compiler predates ours, you will most likely not be able to % apply most of these patches. In particular, under SunOS or % Solaris, Sun Fortran SC2.0.1 or later is required. % Unfortunately, the NRAO AIPS group is unable at this time to provide % binary replacements for the affected tasks. Tasks and other things for which patches have been made: =============================================================================== ------------------------------------------------------------------------ Task: PRTIM Summary: The task computed a blanking integer value too close to an integer overflow for LInux systems. Also cleaned up minor bugs affecting the display on all systems. Files: /15JAN96/APL/PGM/PRTIM.FOR Fix: (1) Get the file, placing it in $APLPGM. (4) Build the task with COMLNK $APLPGM/PRTIM Documentor: Eric W. Greisen Date: 1996.02.01 ------------------------------------------------------------------------ Task: FXVLA Summary: New task required to correct VLA data for a UT1-UTC interpolation error affecting data between 30 Dec 95 19h00 LST and 5 Jan 96 22h00 LST. This error is related to the leap second on 31 Dec 95. Files: /15JAN96/APL/PGM/NOTST/FXVLA.FOR and /15JAN96/HELP/FXVLA.HLP Fix: (1) get FXVLA.FOR, placing it in $APGNOT. (2) get FXVLA.HLP, placing it in $HLPFIL (3) Build the task with COMLNK $APGNOT/FXVLA Documentor: Athol Kemball Date: 9 Feb 1996 ------------------------------------------------------------------------ Task: SETJY.FOR Summary: Previous implementation of the 1990 VLA flux density coefficients was subject to a small rounding error. Only 3C286 was significantly affected with errors of 0.5%-1.9% from P-band to Q-band respectively. This version of SETJY includes the new 1995.2 VLA coefficients. Files: /15JAN96/APL/PGM/NOTST/SETJY.FOR and /15JAN96/HELP/SETJY.HLP Fix: 1) Get SETJY.FOR, placing it in $APGNOT. 2) Get SETJY.HLP, placing it in $HLPFIL 3) Build the task: COMLNK $APGNOT/SETJY Documentor: Athol Kemball Date: 21 February 1996 ------------------------------------------------------------------------ Task: FITLD, FITTP Summary: On some Linux systems (including Red Hat 1.2.13 and Slackware 1.3.45), if the routine $APLSUB/FILL.FOR is compiled with normal optimization, it causes some tasks to freeze up, notably FITLD and FITTP. This has been observed specifically in the latter when writing FITS files to disk. Recompiling FILL with $OPT0 and relinking the task seems to cure this. Files: 15JAN96/SYSTEM/UNIX/OPTIMIZE.LIS Fix: 1) Fetch the file and put it in $SYSUNIX (or edit your existing file and uncomment the entry for FILL) 2) Re-compile with COMRPL $APLSUB/FILL 3) Re-link FITTP with COMLNK $APGNOT/FITTP 4) Also Re-link any other task that seems to freeze and 'spin its wheels' after starting. Documentor: Patrick P. Murphy Date: 1996.02.23 ------------------------------------------------------------------------ Task: FRPGET (usually part of INSTEP1) Summary: The logic that attempted to search for the "ping" utility was flawed for most systems except Suns. The result was a missing "/" in the path to ping. This would result in the script telling you NRAO was unreachable on the net. Files: 15JAN96/SYSTEM/UNIX/INSTALL/FTPGET Fix: 1. Fetch the file *BEFORE* you start INSTEP1, and put it in $INSUNIX. 2. Start INSTEP1. Documentor: Patrick P. Murphy Date: 1996.02.25 ------------------------------------------------------------------------ Task: All Tape writing tasks Summary: Any tape writing under SunOS 5.5 (Solaris 2.5) fails with either an error writing the final EOF marks or at the beginning of the write operation. This is cured by not opening the tape for non-blocking I/O; the patched ZTPOP2.C routine for Solaris cures the problem. Files: /15JAN96/APL/DEV/UNIX/BELL/SOL/ZTPOP2.C Fix: 1. Fetch the file and put it in $APLSOL 2. Re-compile with COMRPL $APLSOL/ZTPOP2 3. Relink all tape applications you might use: COMLNK $APGNOT/FITTP $APGNOT/FITLD $APGNOT/UVLOD $APGNOT/IMLOD $AIPPGM/AIPS $APLPGM/PRTTP $APGNOT/MK3IN $APGNOT/FILLM $APLPGM/AVTP $APGNOT/BAKLD $APGNOT/BAKTP $APGNOT/FILLR $APGNOT/GSCAT $AIPNOT/TPMON $APLPGM/TCOPY $AIPNOT/GR2TEX $AIPNOT/GRITP $AIPNOT/RDFITS $APGNOT/MK3TX Documentor: Patrick P. Murphy (with a lot of help from Martin Shepherd at Caltech!) Date: 1996.04.16 Corrected on: 1996.04.17 (AVTP is in APLPGM; also add TCOPY) Corrected on: 1996.04.26 (Add GR2TEX, GRITP, RDFITS, MK3TX) Corrected on: 1996.05.03 (GR2TEX is in AIPNOT, not APGNOT) ------------------------------------------------------------------------ Script: STARTPMON Summary: This script failed to work correctly under some (System V flavour) versions of Unix, notably AIPS architectures SOL, SGI, and HP. The patched version does not rely on the Berkeley "whoami" command but uses the value of the LOGNAME environment variable instead. The problem only becomes apparent when a TPMON daemon needs to be killed and restarted due to a recompile of TPMON itself. Files: /15JAN96/SYSTEM/UNIX/STARTPMON Fix: 1. Fetch the file and put it in $SYSUNIX 2. Make sure it is executable with this command: chmod +x $SYSUNIX/STARTPMON Documentor: Patrick P. Murphy Date: 1996.04.26 ------------------------------------------------------------------------ Task: SETSP (used to set parameters like SETPAR for many hosts) Summary: If you have a hostname that contains the $ARCH string embedded in it (e.g. SOL123 for Solaris; contains "SOL"), SETSP ignores that entry in the HOSTS.LIST file completely. This was a bug in the string parsing of the file. The replacement fixes this problem (and also includes somewhat better support for using existing values when you exercise the CHANGE option). Files: /15JAN96/AIPS/PGM/SETSP.FOR Fix: 1. Fetch the file and put it in $AIPPGM 2. Compile and link it with: COMLNK $AIPPGM/SETSP Documentor: Patrick P. Murphy Date: 1996.05.22 ------------------------------------------------------------------------ Task: ACFIT Summary: The value of NPARM as used in the call to GTPARM in this task is wrong (299, should be 279). This caused unpredictable overwriting of the running program on some systems, notably SunOS 5. Files: /15JAN96/APL/PGM/NOTST/ACFIT.FOR Fix: 1. Fetch the file and put it in $APGNOT 2. Compile and link it with: COMLNK $APGNOT/ACFIT Documentor: Patrick P. Murphy, with help from Henrietta May and Scott Allendorf. Date: 1996.08.07, CORRECTED 1996.08.13 (16:31:08 GMT) ------------------------------------------------------------------------ Task: Summary: Files: /15JAN96/ Fix: 1. Fetch the file and put it in 2. Compile and link it with: COMLNK Documentor: Date: ------------------------------------------------------------------------