PM27506: DFHCSDUP UTILITY RC=12 WHEN SYSIN DATA SET IS EMPTY.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When the SYSIN data set for DFHCSDUP is empty, the utility
  retun-code is 12. This is to harsh and should be changed to 4.
  Additionaly the utility tries to process a command and then
  issues error messages which are misleading, e.g. that a command
  is invalid even though there is no one command when the data set
  is empty. Our suggestion is to issue a clear message, saying
  that the SYSIN data set is empty.
  
  The following misleading message is issued when SYSIN data set
  is empty:
  
  DFH5201 S ' ' COMMAND IS NOT VALID. COMMAND NOT EXECUTED.
  

Local fix

• Invoke DFHCSDUP from a user program after you have checked that
  SYSIN is not empty (or dummy). If it is empty, don't call
  DFHCSDUP and return with RC=4.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHCSDUP with blank SYSIN DD produces   *
  *                      return code 12.                         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When using the DFHCSDUP utility with a blank SYSIN DD card,
  DFHCSDUP produces return code 12 due to DFHCSDUP considering
  this a severe error and issues msgDFH5201 which is considered
  to be misleading.
  

Problem conclusion

• DFHCSDUP has been amended to issue new WARNING message DFH5209
  when a blank SYSIN DD card is detected and DFHCSDUP will
  subsequently produce return code 4.
  
  In publication GC34-6827-03, CICS Transaction Server for z/OS
  Messages and Codes Version 3 Release 2
  -> Chapter 1 DFH messages
  --> DFH52nn messages
  
  After message DFH5207E on page 26, the following new message
  will be added DFH5209W with the following text:
  
  DFH5209    W  NO COMMAND ENCOUNTERED. THE INPUT FILE
            MIGHT BE EMPTY.
  
  
  EXPLANATION:  The CSD utility detected that an input
  command was blank.  A valid CSD input command was expected
  but not found.
  
  SYSTEM ACTION:  The utility stops processing input
  commands.
  
  USER RESPONSE:  Ensure that you have valid DFHCSDUP input
  commands in the SYSIN data stream.  If you are using an
  UPGRADE USING (filename) command, ensure that the input file
  (filename) is not empty.
  
  NOTE:  This message cannot be changed with the message
  editing utility.
  
  DESTINATION:  SYSPRINT
  
  MODULE:  DFHCSDUP
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  PM27537 UK63946

Modules/Macros

•    DFHBAM52 DFHCUCA  DFHCUCAB DFHCUCAC DFHCUCP
  DFHME52E DFH27506
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R500 PSY UK63946

     UP11/01/22 P F101

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.