Scope: The IBM File Manager Version 9.1 product is having maintenance applied that may have potential impact to users of certain functions of File Manager. This maintenance changes the behavior of FINDNEXT() FINDPREV() and DOWN() File Manager external functions. Please read the documentation changes and ensure any batch jobs using these functions are adjusted accordingly. If you are not using these functions then there is no impact.
Effective Date: The rollout will begin in the first quarter of 2012 with Service Center RFCs scheduled with the MVS Maintenance Window IPLs.
Group Name: National MVS Software Support team.
Affected Locations: All sites where IBM File Manager version 9.1 is installed and being used.
Summary: File Manager maintenance changes the behavior of FINDNEXT() FINDPREV() and DOWN() File Manager external functions. IBM is changing the behavior of these functions to make sure the documented behavior is followed.
Justification: Notify IBM File Manager users of FINDNEXT() FINDPREV() and DOWN() File Manager external functions of potential impact for planned maintenance for the File Manager product.
Benefits to Users: Users of IBM File Manager are notified to behavior changes of FINDNEXT() FINDPREV() and DOWN() File Manager external functions.
Details:
Initial problem description
FINDPREV() FINDNEXT functions are:
1. Returning EOF or TOF instead of 0.
2. Not search the current record as documented.
3. Only finding one occurrence of a string in a given record. DOWN()command returns EOF inconsistently.
Outline of solution
FINDPREV(), FINDNEXT() have been changed to ensure the documented
behaviour is followed.
1. 0 will be returned when string is not found.
2. Searching will take place from the current record as documented.
Repeated searching will resume from the previously located string
unless the record location has been changed by a UP(), Down(), TOP(),
or BOT() commands.
3. DOWN() behavior will be changed so that it only returns end of file
when you are positioned on the last record and the command is issued.
Changes to vendor manual:
Changes to the User's Guide and Reference
Chapter 16, "Functions"
In the section "File Manager functions", subsection "DOWN (DSEB only)", change
the sentence:
If, after moving, the current record is the last record, then the DOWN function
returns the string value “EOF” (end of file). Otherwise, DOWN returns 0.
to:
If, before moving, the current record is the last record, then the DOWN function
returns the string value “EOF” (end of file). Otherwise, DOWN returns 0.
In the section "File Manager functions", subsection "FINDNEXT, FINDPREV (DSEB
only)", add the following:
If a FINDNEXT() or FINDPREV() has located a needle on a given record, then
repeated searching resumes from the previously located needle plus 1 for
FINDNEXT and minus 1 for FINDPREV. If the record location has been changed
by an UP(), Down(), TOP(), or BOT() command, or there has been no previous
located needle, then FINDPREV searches from the end of the current record
backward, and FINDNEXT searches from the start of the current record forward.
Complete updated documentation for the File Manager product can be found at:
http://www-01.ibm.com/software/awdtools/filemanager/library/#v91
Primary Contact: Michael Brennan – mbrennan@hp.com
|
Usercomm - IBM File Manager maintenance potential impact.