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 <FILENAME> is locked and cannot be processed to <FILENAME> 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.
fix 00000019  2014/04/03  RTC 414185                Obfuscate API password in config report (-r).
fix 00000020  2015/02/18  RTC 453743  APAR IT07059  Multiple vulnerabilities in IBM Java SDK affects IBM Sterling Connect:Direct File Agent (CVE-2014-3065, CVE-2014-6468). Updated the JRE.
fix 00000021  2015/03/24  RTC 459300  APAR IT07947  Enhanced File Agent log monitoring and alerting
fix 00000022  2015/06/02  RTC 460416  APAR IT09238  Installs on AIX 5.3 and Solaris 9 systems fail due to bundling JRE 7.  Sterling Connect:Direct for UNIX 4.1.0 supports those operating 
                                                    systems, so this fix bundles JRE 6 for them.  NOTICE:  This iFix marks the end of support for AIX 5.3 and Solaris 9.
fix 00000023  2015/06/17  RTC 469046  APAR IT09495  A vulnerability in IBM Java Runtime affects IBM Sterling Connect:Direct File Agent (CVE-2015-0383).
                                                    Updated the hybrid JREs on Solaris and HP-UX.
fix 00000024  2015/08/31  RTC 461731  APAR IT10974  Improved the error message when File Agent is unable to list directories/files in a directory, like when the user does not have read
                                                    permission, replacing the user-unfriendly "WinDir.scanDir ... filter list of files is null" messages.
fix 00000025  2016/12/09  RTC 502610  APAR IT18290  Fixed a memory leak occurring at every configuration refresh, which over time can lead to a java.lang.OutOfMemoryError and
                                                      File Agent stop processing files while it still reports as being active.
                                                    Fixed a java.lang.IndexOutOfBoundsException in the ConfigFileWatcher thread sometimes occurring before a configuration refresh. Also
                                                      rearranged the sequence to first check for shutdown before checking the configuration.
                                                    Fixed a "Service name:FileAgent not found." exception occasionally occurring during shutdown.
                                                    Added a new log message to show the number of restarts for configuration refresh:
                                                      <date> <time> INFO  - Services have stopped and will be restarted (#<restart counter>)
fix 00000026  2017/04/26  RTC 535414  APAR IT20205  Support for new File Agent variables for 2-digit year, milliseconds and counters:
                                                    %FA_FDATE2.      The date a file was last modified. This value has 6 characters representing year (2-digit), month, and day, 
                                                                     for example, 040903.
                                                    %FA_FDATE_YEAR2. The year (2-digit) in which a file was last modified, for example, 04.
                                                    %FA_DATE2.       The current date. This value has 6 characters representing year (2-digit), month, and day, for example, 040131.
                                                    %FA_DATE_YEAR2.  The current year (2-digit), for example, 04.
                                                    %FA_FTIME_MS.    The millisecond a file was last modified, for example, 067
                                                    %FA_TIME_MS.     The current millisecond, for example, 067.
                                                    %FA_NUM2.        A 5-digit number in the range of 00000..99999, for example 00345. The counter always starts with 0
                                                                     at File Agent startup and is increased by 1 on every process submission. The counter remains its current value
                                                                     through a config refresh.
                                                    %FA_NUM3.        A 9-digit number in the range of 000000000..999999999, for example 000006789. The counter always starts with 0
                                                                     at File Agent startup and is increased by 1 on every process submission. The counter remains its current value
                                                                     through a config refresh.
fix 00000027  2017/04/26  RTC 535596                Multiple date/time variables specified in the same rule can resolve to different values in the command after substitution.
fix 00000028  2018/04/30  RTC 466327                Updated installer to support newer Windows and UNIX OS versions
fix 00000029  2018/04/30  RTC 469046                Upgraded the JRE to IBM Runtime Environment, Java(TM) Technology Edition version 8 on Windows.
fix 00000030  2018/06/22  RTC 563325  APAR IT25476  Improved first-failing snapshot capturing. Added stack trace to snaps file and generated a more unique filename.
fix 00000031  2018/08/17  MFT-9482    APAR IT25319  A vulnerability in IBM Java Runtime affects IBM Sterling Connect:Direct File Agent (CVE-2018-2602).
                                                    Updated or upgraded the IBM Runtime Environment, Java(TM) Technology Edition to 
                                                      JRE 8 for Windows, AIX, Linux and HP-UX Itanium
                                                      JRE 7 for Solaris SPARC and x86
                                                      JRE 6 for HP-UX PA-RISC
                                                    NOTICE:  This is the last release to be published for C:D File Agent 1.4.0 for HP-UX PA_RISC. In the future, 
                                                      releases for this platform will be available on demand only from Customer Support.
fix 00000032  2018/09/12  MFT-9881                  Ignore duplicate watchdir entries to prevent files being processed twice.
                                                      (partial fix; restriction: case-sensitive on Windows)
fix 00000033  2018/09/13  MFT-9055                  Add support for connecting to a Connect:Direct server using a Java Connection Utility (JCU) file. A JCU file
                                                      contains all required connection information, including the server's address and user credentials.
                                                      To enable the use of a JCU file:
                                                        (1) Type the value jcu in both the Userid for API and the Password for API fields.
                                                        (2) Create or update the JCU file by running the following command line from the File Agent directory:
                                                              java -classpath CDJAI.jar com.sterlingcommerce.cd.sdk.JCU "-fcddef.jcu" 
                                                            Enter Node, Address, Port, UserId and Password for your CD node. Enter "tcpip" as the Protocol.
                                                            Note that the associated fields from the File Agent configuration will be ignore for this connection.
fix 00000034  2018/11/12  MFT-9989    APAR IT26921  Multiple vulnerabilities in IBM Java Runtime affect IBM Sterling Connect:Direct File Agent (CVE-2018-165, CVE-2018-12539).
                                                      Updated the IBM Java Runtime to addressed the applicable CVEs.
fix 00000035  2019/04/12  MFT-10094   APAR IT28785  Installer fails on some UNIX systems with error "Installer User Interface Mode Not Supported"
                                                      Updated installer, which also adds support for newer Windows and UNIX OS versions.
fix 00000036  2019/04/12  MFT-10245   APAR IT28783  Multiple vulnerabilities in IBM Java Runtime affect IBM Sterling Connect:Direct File Agent (CVE-2018-1890, CVE-2018-12547).
                                                      Updated the IBM Java Runtime to addressed the applicable CVEs.


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 <FILENAME> is locked and cannot be processed to <FILENAME> 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.