A fix is available
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 number
PI72104
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
800
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2016-11-10
Closed date
2017-02-23
Last modified date
2017-03-02
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.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"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":"5.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 March 2017