Connect:Direct File Agent Fix List Note 1: File Agent 1.2.02 and above, on z/OS requires 32-bit Java 1.5 or later Note 2: Instructions for upgrading File Agent are at the bottom of this file. Version 1.4.00 ============== fix 00000001 2010/12/07 QC 18030 Continue processing files if process name information cannot be retrieved for a process. fix 00000002 2010/12/08 QC 18045 Reconnect to submit processes, if the C:D node gets re-cycled, and the connection is lost. fix 00000003 2011/01/07 QC 18208 Added a system property "trace", which when enabled will display Connect:Direct traces. fix 00000004 2011/01/11 QC 18367 Changed the informational message is locked and cannot be processed to is in delay period and cannot be processed. fix 00000005 2011/04/22 QC 19105 Allow SNMP listener ports between 0 and 65535 fix 00000006 2011/05/17 QC 19181 Modified the code to display the warning message about a process not being found. fix 00000007 2011/10/21 QC 20233 Modified the code that builds the regular expression for a simple match. fix 00000008 2012/01/26 QC 20513 File name variables inside longer submit process symbol values may result in a symbol value with inadvertent double quotes embedded. fix 00000009 2012/05/10 RTC 324005 APAR IC83308 Always add start(^) and end($) anchors when building a simple match. fix 00000010 2012/06/21 RTC 336126 APAR IC84774 Disable .console.stdout file in cdfa$.lax on Windows to prevent it from filling up disk space. CDFA.log already has the same information. fix 00000011 2012/07/04 QC 16496 The system property -Dcasesensitive=true must be added to the cdfa.lax file to honor case sensitivity when using symbolics not supported by File Agent, and when connected to z/OS. fix 00000012 2012/07/05 RTC 338195 APAR IC85117 Updated log4j 1.2.16 to fix an java.io.InterruptedIOException when interrupting the Gateserver thread at shutdown on Solaris fix 00000013 2012/08/02 RTC 341662 APAR IC85743 Version information will be displayed in V.R.M.F format. Fixed the version reported to Sterling Control Center. fix 00000014 2012/08/21 RTC 344434 If ignoreos390volumes is true, strip off all indication of volumes so that archived datasets look just like the restored dataset and are not treated as being new/different. fix 00000015 2013/07/10 RTC 365252 APAR IC94012 File Agent should automatically escape special file name characters stored in FA_* variables. Specifically, ()'~& The user has no way to manually escape these because they're only found at runtime, then plugged into the FA_* variables. Added for when PNODE is Windows. Other platforms not changed yet. This feature is "On" by default. To disable, start FA with --disableAutoEscape 2013/10/08 Certified on Microsoft Windows Server 2012 fix 00000016 2014/01/28 RTC 411224 APAR IC99436 IBM Sterling Connect:Direct File Agent is affected by a vulnerability in the IBM Runtime Environment, Java(TM) Technology Edition (CVE- 2013-1500). fix 00000017 2014/02/14 RTC 412063 Change the default install folder name on UNIX back to "FileAgent" fix 00000018 2014/02/25 RTC 368850 APAR IC99411 Fixed a java.lang.NoClassDefFoundError exception at startup when SNMP source port range is configured. Version 1.3.00 ============== fix 00000001 2010/07/12 QC 17056 Corrected the issue with high CPU utilization. fix 00000002 2010/07/22 QC 17144 File Agent correctly parses file names with commas. fix 00000003 2010/08/05 QC 16423 File Agent replaces the log date/time with the current date/time if it receives a date/time value of 12/31/1969 for a submitted process on UNIX. fix 00000004 2010/08/26 QC 17421 System Events get triggered when a process submission fails. fix 00000005 2010/09/08 QC 17521 Logo changes in documentation. fix 00000006 2010/12/07 QC 18030 Continue processing files if process name information cannot be retrieved for a process. fix 00000007 2010/12/08 QC 18045 Reconnect to submit processes, if the C:D node gets re-cycled, and the connection is lost. fix 00000008 2011/01/07 QC 18208 Added a system property "trace", which when enabled will display Connect:Direct traces. fix 00000009 2011/01/07 QC 17687 Override process priority to 1, if set to zero for non z/OS systems. fix 00000010 2011/01/11 QC 18367 Changed the informational message is locked and cannot be processed to is in delay period and cannot be processed. fix 00000011 2011/04/22 QC 19105 SNMP listener port accepts ports ranging from 0-65535 fix 00000012 2011/05/16 QC 19181 Changed the message about a process not being found as the process not being local or not found. fix 00000013 2011/05/18 QC 19166 Modified the installer to include the missing files on z/OS. QC 19186 (same) Version 1.2.02 ============== fix 00000000 2009/08/17 QC 14746 Added a flag userenamelogic to the CDFA.lax and cdfa.bat files, so that File Agent on Windows could be configured to monitor files in a watch directory that are FTPied in, by setting the flag to true. The default value is false. fix 00000000 2009/08/17 SR 1338526 Improved file agent logging. Refer to CDFAConfigGuide.pdf for more information. SR 1347833 (same) SR 1348307 (same) SR 1356659 (same) fix 00000000 2009/08/17 Added support for Windows 2008. fix 00000001 Modified generic UNIX install so cdfa script points to chosen Java VM fix 00000002 2010/04/06 QC 16425 FA correctly handles the %FA_NOT_PATH. variable. Fixed the logic to parse the basename and member name for OS/390. fix 00000003 2010/04/26 QC 16496 In order for File Agent to honor non-file agent type symbolics for instance &MODE=test, a system property (-Dcasesensitive=true) must be specified as part of the execution job as follows (For Example). The system property is optional, and should be used only if the former condition applies. echo "DISPLAY variable is" $DISPLAY export fa=-Dsci.config=FAConfiguration export fa1=-Djava.util.prefs.userRoot=. export fa2=-Djava.util.prefs.systemRoot=. export fa3=-Dlog4j.configuration=file:./log4j.properties export fa4=-Dcasesensitive=true cd $RUN_DIR sizeCheck abc=$? if test $abc -lt 180 ; then echo " region size is less than 180 meg, and may be insufficient" fi $FAJAVA $fa $fa1 $fa2 $fa3 $fa4 -jar fasat.jar $f4 fix 00000004 2010/05/07 QC 16650 When a shut file is dropped in the installation directory, File Agent gracefully shutsdown and handles the java.io.InterruptedIOException thrown by log4j. fix 00000005 2010/08/26 QC 17421 System events get triggered when process submissions fails. Version 1.2.01 ============== fix 00000001 2009/01/20 SR 1372144 Removed the extra spaces that were added to the values resolved by command variables like %FA_0. to %FA_99. fix 00000002 2009/01/20 SR 1370819 Modify build to use JRE 1.6.0_05 fix 00000003 2009/01/20 SR 1343828 File Agent recalculates the available disk space during the installation process fix 00000004 2009/01/20 SR 1370862 File Agent Watch directory file scanning on windows is made similar to C:D Select fix 00000005 2009/03/30 SR 1362055 New C:D JAI jar which corrects encryption/decryption of processes and initparms greater than 8K and corrects handling of JCU password. QC 13416 (same) fix 00000006 2009/04/30 QC 13611 File Agent logs an error message if a process does not run successfully on a Connect Direct server. fix 00000007 2009/05/28 QC 14085 Modified build to use JRE 1.6.0_13 fix 00000008 2009/06/02 Modified uninstall to point to ../jre/bin/java fix 00000009 2009/07/20 QC 14538 The symbolic variables %FA_NAME_FOUND. and %FA_EXT_FOUND. resolve to the file name and extension, even if the file is in a GDG format on Windows. fix 00000010 2009/08/17 QC 14746 Added a flag userenamelogic to the CDFA.lax and cdfa.bat files, so that File Agent on Windows could be configured to monitor files in a watch directory that are FTPied in, by setting the flag to true. The default value is false. Version 1.1.00 ============== fix 00000000 2007/01/11 Modify build to use JRE 1.4.2_12 for DST change fix 00000001 2007/02/05 SR 1363392 Updated field level help for Process Arguments help text fix 00000002 2007/02/19 SR 1363977 Updated Sun JRE to 1.4.2_13 because of security issues with 1.4.2_12 fix 00000003 2007/04/09 SR 1365080 Added check for read/write access to watch directory fix 00000004 2007/06/07 Modify os.arch to allow "390" or "s390" for support of OS/390 and z/OS fix 00000005 2007/07/26 SR 1365885 Update CDUtils.jar to allow user-specified encoding charsets fix 00000006 2007/08/07 SR 1357158 Correct fix to populate %FA_n variables when file is OS/390 DSN. fix 00000007 2007/09/21 SR 1366777 Update CDJAI, which requires update to JRE 1.5. fix 00000008 2007/10/22 SR 1367018 Add -f cmd line argument to force processing of existing files when starting FA fix 00000009 2007/11/08 Correct manifest file to include CDJAI.jar fix 00000010 2008/07/13 SR 1369647 FA correctly processes files after a network share was temporarily unavailable fix 00000011 2008/08/14 SR 1370425 FA does not process files that are transferred through FTP, until the whole file is transferred. fix 00000012 2008/09/12 SR 1370886 FA GUI will not open once more than 50 FA configurations have been created. fix 00000013 2008/10/09 SR 1371102 FA will parse files containing paranthesis fix 00000014 2008/10/13 SR 1371102 FA will parse files with a + in it. fix 00000015 2008/10/15 SR 1370425 File Completion Delay no longer needs to be provided for File Agent Configurations on Windows. File Agent does not process files that are in transit through FTP. fix 00000016 2009/01/09 SR 1372144 Fixed the issue with File Agent freezing if there were more than 120 rules. Version 1.0.09 ============== fix 00000000 2006/08/17 SR 1356970 Add -p (productLevel) to identify the version fix 00000001 2006/11/07 C:D UNIX Defect 498 Fixed install on Tru64, RedHat zSeries, and SUSE zSeries platforms so that cdfa executable gets installed. Version 1.0.08 ============== fix 00000001 2006/06/13 SR 1354005 Fixed variables with concatenated filename to have correct quotes fix 00000002 2006/06/23 SR 1355987 add "" around %FA variables that have filenames with parentheses fix 00000003 2006/06/27 SR 1355826 Directory beginning with $1 correctly parsed in regexp fix 00000004 2006/06/28 C:D UNIX Defect 300 Change msg if rule default process not found to give proc name fix 00000005 2006/07/17 SR 1354472 Encode bytes using ISO-8859-1 instead of UTF-8 to support national chars fix 00000006 2006/08/15 SR 1357710 Modify build to use JRE 1.4.2 for AIX Version 1.0.07 ============== fix 00000002 2005/12/01 SR 1350476 File scan of GDG files caused 2 processes to be kicked off fix 00000003 2006/01/25 SR 1351662 FILE variable getting exception if file doesn't exist; also included fix for SR 1292550 fix 00000004 2006/02/06 SR 1292550 Cmd variables with ~ not substituted correctly Version 1.0.06 ============== fix 00000001 2005/11/09 SR 1349399 add "" around %FA variables that have filenames with spaces fix 00000002 2005/12/01 SR 1349911 EXT variable getting exception if ext doesn't exist Instructions for upgrading File Agent ===================================== WINDOWS: 1. Download the zipped maintenance. 2. Unzip the maintenance file. 3. Stop the Connect Direct File Agent service. 4. Uninstall File Agent (Start/All Programs/Connect Direct File Agent/Uninstall Connect Direct File Agent). 5. Reinstall File Agent using the FAInstall.exe installer in the zipped maintenance file. UNIX: 1. Download the zipped maintenance. 2. Unzip the maintenance file. 3. Stop Connect Direct File Agent 4. Copy configuration files (*.ser) to another location 5. Remove existing File Agent installation directory 6. Reinstall File Agent using the FAInstall.bin installer in the zipped maintenance file. 7. Copy configuration files back to installation directory. OS/390 or z/OS: 1. Download the zipped maintenance. 2. Unzip the maintenance file. 3. FileAgent must already be installed as per instructions in the C:D z/OS Install Guide. 4. Take the three maintenance jars and overlay the jars in the File Agent install directory.