PK04106: ODE DCB PROBLEM WHERE FPXOFILE DD NAME GETS RESET AND THEREFORE CANNOT BE USED BY USER APPLICATIONS

APAR status

• Closed as program error.

Error description

• The LRECL of FPXOFILE is reset according to the device
  type of the dataset, regardless of the DCB parameter
  specified in the JCL. Customers need to specify
  the LRECL to have the format that user applications
  require as input.
  This is a forward fit of FPO V2R1 APAR PK03754.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All Online Data Extract users of High        *
  *                 Performance Fast Path Utilities FP Online    *
  *                 Tools Version 2 Release 1 (FMID: H31A210).   *
  ****************************************************************
  * PROBLEM DESCRIPTION: Forward Fit of FPO V2R1 APAR PK03754.   *
  *                      Provide an option in ODE to allow       *
  *                      users to specify the LRECL of FPXOFILE. *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  Forward Fit of FPO V2R1 APAR PK03754.
  The LRECL of FPXOFILE is reset according to the device type of
  the dataset, regardless of the DCB parameter specified in the
  JCL. This apar addresses the requirement for Online Data Extract
  (ODE) to allow users to specify the LRECL of FPXOFILE using a
  new option OLRECL.
  

Problem conclusion

• ODE supports a new optional keyword OLRECL=BLOCK|nnnnn(integer).
  When OLRECL=BLOCK is specified, LRECL is determined as
  BLKSIZE - 4, this is the default. When OLRECL=nnnnn is
  specified, LRECL is determined as OLRECL if its value is
  available.
  
  The macro FPXMBLK has been modified to add control indicator for
  OLRECL, and a new parameter FPXORECL for the LRECL of FPXOFILE.
  
  The module FPXMSG00 has been modified to add new messages
  FPX0122W.
  
  The module FPXOXIT0 has been modified to determine the LRECL of
  FPXOFILE using the OLRECL specification.
  
  The module FPXPARM1 has been modified to process new keyword
  parameter OLRECL.
  
  The module FPXWSTD0, FPXWURF0, FPXWURF1 have been modified to
  abend with U3516 if the length of output record is bigger
  than DCBLRECL of FPXOFILE.
  
  The modules FPXMBLK0 has been reassembled.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS High Performance Fast Path Utilities for z/OS
  User's Guide Volume 3: Fast Path Online Tools (SC18-9239-00)
  should be changed as follows:
  
  Part2. Online Data Extract
   Chapter 6. Using Online Data Extract
    Invoking ODE
  
    Before change:
    -------------
    The dataset for FPXOFILE DD reside on either a direct-access
    device or tape. Standard labels must be used for this data
    set. The DCB attributes are calculated by FPXOXIT0. RECFM is
    VB.
  
    . For 3380, the BLKSIZE is 23476 and the LRECL is 23472 bytes
    . For 3390, the BLKSIZE is 27998 and the LRECL is 27994 bytes
    . For 9345, the BLKSIZE is 22928 and the LRECL is 22924 bytes
    . For Tape, the BLKSIZE is 32760 and the LRECL is 32756 bytes
  
    After change:
    -------------
    The dataset for FPXOFILE DD reside on either a direct-access
    device or tape. Standard labels must be used for this data
    set. The DCB attributes are calculated by FPXOXIT0. RECFM is
    VB.
  
    . For 3380, the BLKSIZE is 23476.
    . For 3390, the BLKSIZE is 27998.
    . For 9345, the BLKSIZE is 22928.
    . For Tape, the BLKSIZE is 32760.
  
    FPXCTL Statement
  
  << The keywords associated with FPXCTL are: >>
  The following description should be added:
  . OLRECL (FPXOFILE LRECL option)
  
  The following description should be added:
  OLRECL keyword
  
  The OLRECL keyword specifies the LRECL of FPXOFILE.
  
  The keyword is optional. If not specified, the default is BLOCK.
  
  The format of the OLRECL keyword is:
  
                     -----BLOCK--------
                     |                |
    >>--OLRECL=--------------------------------------------><
                     |----------------|
                         |         |
                         --integer--
  
  The variable fields are defined as follows:
  
  BLOCK
       The LRECL of FPXOFILE is determined as BLKSIZE - 4.
       The BLKSIZE is determined according to the device
       type of the dataset,
  
  integer
       The LRECL of FPXOFILE is determined as the indicated
       integer if the value is available.
  
  Default: BLOCK
  
  Restrictions:
  1.The integer you specify must be in the range of 5 through
  32760.
  2. You cannot have multiple values for the OLRECL keyword.
  If you do specify multiple values, only the last valid
  occurrence of the OLRECL keyword will be in effect.
  3. When the integer you specified is unavailable, that is,
  larger than BLKSIZE-4, ODE uses the default value BLKSIZE-4.
  
  Appendixes. Messages:
  The 3516 description should be added as follows:
  ---------------------------------------------------------------
  3516
  
  Explanation: The length of the output record is greater than
  the DCBLRECL value of FPXOFILE specified by OLRECL keyword.
  
  System Action: Processing terminates with abend code 3516.
  
  User Response: Increase the OLRECL value.
  
  Issuing Module:  FPXWSTD0, FPXWURF0, FPXWURF1
  
  
  The FPX0122W message descriptions should be added as follows:
  ---------------------------------------------------------------
  FPX0122W INCORRECT OLRECL xxxxx SPECIFICATION. DEFAULT VALUE
  xxxxx SUBSTITUTED.
  
  Explanation: FPXOFILE LRECL is too bigger, it must be less
  than or equal to BLKSIZE-4.
  
  System Action: The default value for FPXOFILE LRECL, BLKSIZE-4
  is enforced by ODE (OLRECL specification is ignored). ODE sets
  an end-of-job return code of 4 and continues processing.
  
  User Response: To eliminate this warning message for subsequent
  executions of the job, correct the OLRECL value.
  
  Issuing Module: FPXOXIT0
  210Y
  FPXMBLK
  FPXMBLK0
  FPXMSG00
  FPXOXIT0
  FPXPARM1
  FPXWSTD0
  FPXWURF0
  FPXWURF1
  

Temporary fix

Comments

APAR Information

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

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

  UK02453

Modules/Macros

•    FPXMBLK  FPXMBLK0 FPXMSG00 FPXOXIT0 FPXPARM1
  FPXWSTD0 FPXWURF0 FPXWURF1
  

Fix information

• Fixed component name

  IMS HP FP UTILI

• Fixed component ID

  5655K9400

Applicable component levels

• R210 PSY UK02453

     UP05/04/22 P F504