IBM Support

PM22978: FINDNEXT FUNCTION RETURNING "TOF" VALUE INSTEAD OF RECORD NUMBEROR ZERO.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When running REXX code in a File Manager DSEB function, user
    expects the FINDNEXT function to return a record number where
    the string is found or a zero if no string is found.
    
    In this case, the function returned the string, TOF, instead of
    a zero after the last string was encountered, causing the REXX
    to loop.
    

Local fix

  • n/a
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All File Manager Users.                      *
    ****************************************************************
    * PROBLEM DESCRIPTION: FINDPREV() FINDNEXT() functions are     *
    *                      1. Returning EOF or TOF instead of 0.   *
    *                      2. Not searching the current record as  *
    *                      documented.                             *
    *                      3. Only finding one occurrence of a     *
    *                      string in a given record.               *
    *                                                              *
    *                      DOWN() command returns EOF              *
    *                      inconsistently.                         *
    ****************************************************************
    * RECOMMENDATION: Apply the provided PTF.                      *
    ****************************************************************
    DOWN() returns end of file when you are positioned at the last
    record for the first time. After end of file has been reached
    DOWN() returns end of file when you navigate to the last record.
    

Problem conclusion

  • 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() command.
    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.
    
    Publication Closing Code: DEVCHNG
    For the documentation changes associated with this APAR,
    please refer to:
    ftp://ftp.software.ibm.com/software/websphere/awdtools/
        filemanager/fmv10apar.pdf
    
    The changes are to the following publications:
    
    PUB ID        PUB NAME
    ------------  ----------------------------------------
    
    SC19-2857-00  File Manager for z/OS User's Guide and
                  Reference Version 10 Release 1
    
    
    The latest published manuals can be found at:
    http://www.ibm.com/software/awdtools/filemanager/library/
           index.html.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PM22978

  • Reported component name

    FILE MANAGER ZO

  • Reported component ID

    5655V5200

  • Reported release

    A10

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2010-09-22

  • Closed date

    2011-05-30

  • Last modified date

    2011-07-05

  • APAR is sysrouted FROM one or more of the following:

    PM22660

  • APAR is sysrouted TO one or more of the following:

    UK68127 UK68140 UK68164 UK68169 UK68211 UK68218 UK68219 UK68221

Modules/Macros

  • FMNABXIT FMNBE50  FMNCAALT FMNCABF  FMNCADAT
    FMNCADEF FMNCADEL FMNCADS  FMNCADSB FMNCADS1 FMNCADS2 FMNCADS3
    FMNCAIBB FMNCAIDX FMNCARMA FMNCAS2  FMNCATT  FMNCAVER FMNCMGUA
    FMNCM00A FMNDISK1 FMNDQV   FMNDSM   FMNEDCRS FMNE35   FMNFCH
    FMNIOXIN FMNLOCAL FMNMAIN  FMNPLIMN FMNQSAM  FMNQSENQ FMNQSOCF
    FMNRMCPL FMNRMQ   FMNRMV   FMNRXBLO FMNRXBMD FMNRXCB  FMNSCREX
    FMNVSAM  FMN0LVL  FMN0LVLJ FMN0LVLK FMN0MENU FMN0MJPN FMN0MKOR
    FMN1DDDC FMN1LVL  FMN1MAIN FMN2AJSQ FMN2AUDI FMN2BCNL FMN2BCTQ
    FMN2BDBQ FMN2BONM FMN2BUTQ FMN2CATQ FMN2CD2V FMN2CHKI FMN2CKCN
    FMN2CNVR FMN2CSQI FMN2CTMP FMN2CTM1 FMN2CTQ2 FMN2DATA FMN2DBC
    FMN2DBI  FMN2DBJ  FMN2DBO  FMN2DBOL FMN2DBP  FMN2DBV  FMN2DBX
    FMN2DBY  FMN2DIUS FMN2D2C  FMN2D2E  FMN2D2EC FMN2D2EG FMN2D2EI
    FMN2D2EL FMN2D2ES FMN2D2G  FMN2D2SP FMN2EDSP FMN2EDT1 FMN2EOBN
    FMN2ERR  FMN2ETRC FMN2EXSY FMN2FMT  FMN2IDTB FMN2INTE FMN2INTJ
    FMN2INTP FMN2IPSU FMN2ISPF FMN2ISQ  FMN2ISQG FMN2ISQI FMN2ISQS
    FMN2ITSV FMN2IVSU FMN2LIBS FMN2LOCL FMN2LVL  FMN2LVLJ FMN2LVLK
    FMN2MAIN FMN2OPTL FMN2PFMS FMN2PRVP FMN2RMR  FMN2RMR2 FMN2RMUT
    FMN2RUNI FMN2RUN1 FMN2RUN2 FMN2RUN3 FMN2RUN4 FMN2RUN5 FMN2SBPR
    FMN2SCON FMN2SEDX FMN2SELS FMN2SENX FMN2SERR FMN2SHSQ FMN2SIDM
    FMN2SNTX FMN2SQLC FMN2SQS2 FMN2SQTB FMN2SSID FMN2SSQL FMN2SXPM
    FMN2TEXT FMN2TTBL FMN3CICS FMN3LVL
    

Publications Referenced
SC19285700    

Fix information

  • Fixed component name

    FILE MANAGER ZO

  • Fixed component ID

    5655V5200

Applicable component levels

  • RA1A PSY UK68140

       UP11/06/03 P F106

  • RA1B PSY UK68164

       UP11/06/03 P F106

  • RA10 PSY UK68127

       UP11/06/03 P F106

  • RA11 PSY UK68169

       UP11/06/03 P F106

  • RA12 PSY UK68211

       UP11/06/03 P F106

  • RA13 PSY UK68218

       UP11/06/03 P F106

  • RA14 PSY UK68219

       UP11/06/03 P F106

  • RA16 PSY UK68221

       UP11/06/03 P F106

Fix is available

  • Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"A10","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSXJAV","label":"File Manager for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"A10","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
05 July 2011