S4PM 5.11.0 RELEASE NOTES

Release Date

April 25, 2006

Functional Changes

1. Production Summary Feature - Added a new optional feature that allows algorithms to generate a Production Summary output file. This file is a summary of the each algorithm run and is generated by a customized summary of the runtime log files. Refer to the Stringmaker Algorithm configuration file for details or the S4PM 5.11.0 Installation and Configuration Guide.
   
   
2. New Acquire Data Station - Added support for the new Acquire Data station which is used in place of Request Data for non ECS S4PM strings. To support this, a new parameter has been added to the Stringmaker Global configuration file: $external_archive_system which can be set to either 'ecs' or 's4pa'. The default (for now) is 'ecs'. This station FTPs data directly or creates symlinks (for local files). The calling sequence for the script is s4pa_acquire_data.pl -f config_file -r request_dir -F ftp_dir -l symlink_dir work_order. It outputs work orders that are sent downstream to Register Data.
   
   
3. s4pm_run_easy.pl - Properly detects when more than one product output file is being used with the tar option and errors out before attempting tar command.
   
   
4. When $trigger_coverage Set To Zero - A bug was fixed that caused the invokation of dynamic processing boundaries to fail. If one sets both the $processing_period and the $trigger_coverage to zero in the Stringmaker Algorithm configuration file, it is supposed to cause the start and stop times of the output product to be aligned with the start time of the input file and not fixed to a predicted start time. This is useful in direct broadcast where the input can start at any time. But the bug prevented this from working properly. This has been fixed.
   
   
5. Fill Hole Tool - In S4PM strings where there is no implicit algorithm chaining, the Fill Hole tool (in the Request Data station) was not working due to a malformed configuration file. This has been fixed.
   
   
6. FileSpec.pm - Switched to use of Basename in pathname() to get around Perl argument-passing bug.
   
   
7. Stationmaster Fix for Non Forking Case - Fixed stationmaster.pl for the non-forking case ($cfg_max_children = 0)
   
   
8. s4pm_bootstrap_dprep.pl - Changed contact info in metadata file to help-disc@listserv.gsfc.nasa.gov.

Detailed File Changes

S4P::FileSpec.pm

• Changed pathname() to use basename and dirname to split up the path.

s4pm_acquire_data.pl

• New script to support the new Acquire Data station which is used in place of Request Data on strings that interoperate with S4PA.

S4PM::Algorithm.pm

• Fixed a bug in the reading of $trigger_coverage from the Stringmaker Algorithm configuration file.

• Added handling of the new %production_summary_parms hash in new().

s4pm_bootstrap_dprep.pl

• Changed contact info in metadata file to help-disc@listserv.gsfc.nasa.gov.

s4pm_run_easy.pl

• Properly detects when more than one product output file is being used with the tar option and errors out before attempting tar command.

s4pm_stringmaker.pl

• Added support for Production Summary generation. Modified the read_algorithm_cfg() to read in the %production_summary_parms hash from the Stringmaker Algorithm configuration file and feed it into the %all_production_summary_parms hash.

s4pm_stringmaker_algorithm.cfg

• Added the %production_summary_parms hash to support the generation of Production Summary files by algorithms.

s4pm_stringmaker_derived.cfg

• Made a change so that the s4pm_tk_fillhole_request.cfg file is properly generated even in strings where there is no implicit algorithm chaining. This was getting generated before, but the hashes within were not filled out.

• Added support for Production Summary generation by adding code to generate the required parameters in the <algorithm>.cfg file in the Run Algorithm station.

• Added code to support the Acquire Data station. Whether a Acquire Data or Request Data station is built is determined by the setting of the new $external_archive_system parameter.

s4pm_stringmaker_global.cfg

• Added the new parameter $external_archive_system which sets the system into which S4PM exports data and the system from which PANs, DNs, and subscription notifications are received.

s4pm_stringmaker_host.cfg

• Added a new parameter $local_s4pa_ftp_root to support S4PM strings that interoperate with a local instance of S4PA. It sets the root directory of the S4PA data archive.

s4pm_stringmaker_static.cfg

• Removed any description of the Request Data station completely out and into the s4pm_stringmaker_derived.cfg file since its presence it no longer ensured depending upon the configuration.

s4pm_tk_compose_request.pl

• Changed button lable "Query Database" to "Query Archive" to make it more compatible with S4PA. Also, changed window label from "Compose Request Tool" to "Compose Data Request Tool".

s4pm_tk_compose_single_request.pl

• Changed button lable "Query Database" to "Query Archive" to make it more compatible with S4PA. Also, changed window label from "Compose Sinlge File Request Tool" to "Compose Single Data File Request Tool".

stationmaster.pl

• Fixed code to properly handle the case where $cfg_max_children = 0. This was fossil code that did not get updated over the years.

tkstat.pl

• Modified create_menu() so that if $cfg_max_children is set to zero, the 'Stop Fast' option for turning off a station is removed. The reason is that this combination can be dangerous.

• Also modified show_station_status() to prevent a station button from showing up as yellow when the $cfg_max_children is set to zero. This bit of code was originally in there, probably to warn if cfg_max_children was set to zero accidentally.