PI72104: DFHDPLOY CHANGES TO PROVIDE PIPELINE SCAN, PHASEIN AND NEWCOPY.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• DFHDPLOY changes to provide PERFORM PIPELINE SCAN
  SET PROGRAM PHASEIN and SET PROGRAM NEWCOPY.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of CICS Transaction Server for z/OS    *
  *                 V5.1, V5.2 and V5.3                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: -  The DFHDPLOY batch utility is being  *
  *                         updated to allow support for:        *
  *                                                              *
  *                         -  PIPELINE SCAN                     *
  *                         -  PROGRAM NEWCOPY                   *
  *                         -  PROGRAM PHASEIN                   *
  *                                                              *
  *                      -  Using DFHDPLOY to deploy a BUNDLE    *
  *                         resource leaves behind a BUNDLE      *
  *                         definition in the CICSPlex SM Data   *
  *                         Repository if the deploy fails.      *
  *                         This is alredy addressed in V5.3     *
  *                         through APAR PI72274.                *
  *                                                              *
  *                      -  SET APPLICATION STATE(ENABLE) gives  *
  *                         a RC=4 when a RC=8 is expected.      *
  *                                                              *
  *                      -  Message DFHRL2113I does not show the *
  *                         BUNDDEF version.                     *
  *                                                              *
  *                      -  An UNDEPLOY BUNDLE with a SCOPE of   *
  *                         only CICS TS 5.1 and 5.2 regions     *
  *                         gives RC=4 when it should give RC=0. *
  *                                                              *
  *                      -  An Application with no entrypoints   *
  *                         cannot be DISABLED.                  *
  *                                                              *
  *                      -  Making an Application state          *
  *                         UNAVAILABLE can give a RC=4 when it  *
  *                         should be RC=8.  DFHRL2094I is not   *
  *                         issued when it should be and         *
  *                         DFHRL2074W is issued in error.       *
  *                                                              *
  *                      -  When a command is split over         *
  *                         multiple lines, a space may be       *
  *                         inserted within the command, causing *
  *                         the command to fail.                 *
  ****************************************************************
  -  The DFHDPLOY batch utility does not allow a user to PHASEIN
     or NEWCOPY a CICS Program, nor perform a Pipeline scan across
     a scope of regions. These functions have been added to enable
     them to be performed as part of a DFHDPLOY script.
  
  -  When you use the DEPLOY BUNDLE command in DFHDPLOY without
     specifying RESGROUP or CSDGROUP, a resource definition is
     created using Business Administration Services (BAS) for the
     duration of the deployment and deleted after the artifact
     reaches its specified target state.
  
     In certain scenarios where the BUNDLE deployment fails, it is
     expected that the temporary resource would be removed from
     the CICSPlex SM Data Repository, but this does not always
     occur.
  
     If this failure occurs many times, the following messages may
     be produced:
  
       DFHRL2307I Unable to install BUNDLE(bundlename). The
                  definition version limit has been reached.
  
       DFHRL2055I Errors have occurred, processing terminated.
  
     Note, this fix also addresses a problem with the DFHDPLOY
     Kanji messages that have spanned multiple lines and not been
     created with a continuation character. This leads to rc-3
     messages issued by DFHDPLOY if REXX system tracing is set to
     normal.
  
  -  SET APPLICATION ENABLE fails and  issues message DFHRL2256I
     and give RC=4, a RC=8 is expected.
  
  -  Message DFHRL2113I issued during an UNDEPLOY BUNDLE command
     does not identify the version of the BUNDDEF being removed.
  
  -  An UNDEPLOY BUNDLE where the SCOPE is a CICS TS 5.1 or 5.2
     region will timeout with RC=4, and not give RC=0 is expected.
  
  -  A DISABLE APPLICATION where the Application contains no
     entrypoints will fail and give a RC=8 when  it would be
     expected to work giving a RC=0.
  
  -  When an application is UNDEPLOYed to UNAVAILABLE or DISCARDED
     state or SET to UNAVAILABLE, DFHDPLOY will wait for all
     active work using the application to quiesce. If tasks are
     still active after the timeout period then a RC=4 is issued.
     The following errors relate to this phase of processing:
  
     -  Message DFHRL2094I is expected to be issued but does not
        appear on the log.
  
     -  DFHRL2074W is issued during a quiesce when it should not
        be.
  
     -  A quiesce may return a RC=4 when a user expects a RC=8.
  
     -  The user may see the following message on the log:
  
          4 trace records written to trace file.
  
        This is due to DFHDPLOY incorreclty querying the
        underlying CPSM API and the query failing.
  
  -  When DFHDPLOY reads from the SYSIN card it may incorrectly
     parse a continued line if that line also has a parameter
     following the continuation. This results in an embedded space
     which causes an error in processing the parameter.
  
  Additional Keywords: PHASEIN NEWCOPY SCAN
  

Problem conclusion

Temporary fix

Comments

• DFHDPLOY has been changed to provide support for PROGRAM
  PHASEIN, PROGRAM NEWCOPY and PIPELINE SCAN, and to address
  the problems documented above.
  
  Updates have been made to:
  
  -  The DFHDPLOY REXX exec.
  
  -  The DFH$DPLY sample JCL member.
  
  -  The DFHDPLYE (English), DFHDPLYK (Japanese) and DFHDPLYS
     (Chinese) message files.
  

APAR Information

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

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

  UI44949 UI44950 UI44951

Modules/Macros

• DFH$DPLY DFHDPLOY DFHMERLC DFHMERLE DFHMERLK
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R000 PSY UI44951

     UP17/02/25 P F702

• R800 PSY UI44949

     UP17/02/25 P F702

• R900 PSY UI44950

     UP17/02/25 P F702

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.