IBM Mainframe Forum Index
 
Log In
 
IBM Mainframe Forum Index Mainframe: Search IBM Mainframe Forum: FAQ Register
 

Why Newcopy is required when we have Phase-in?


IBM Mainframe Forums -> CICS
Post new topic   Reply to topic
View previous topic :: View next topic  
Author Message
DIXINSH

New User


Joined: 26 Apr 2016
Posts: 2
Location: India

PostPosted: Thu Apr 28, 2016 9:47 am
Reply with quote

We all know, we use NEWCOPY to refresh the program however if module is in use i.e rescount is not equal to 0. NEWCOPY will fail and that's why we have PHASE-IN which performs a REFRESH PROGRAM function to inform the loader domain that a new version of the program is cataloged and that this version of the named program must be used in all future ACQUIRE requests. Now when I can live happily with PHASE-IN why NEWCOPY still exits?
Back to top
View user's profile Send private message
Rohit Umarjikar

Global Moderator


Joined: 21 Sep 2010
Posts: 3048
Location: NYC,USA

PostPosted: Thu Apr 28, 2016 12:58 pm
Reply with quote

Welcome!
You would have to do a bit of a research before getting into it as IBM has documented everything on this here.
quick is newcopy has to be issued in the same region where program resides but for PHASEIN you tell cics which cicsplex to go and cpsm will take further and does newcopy.
Back to top
View user's profile Send private message
DIXINSH

New User


Joined: 26 Apr 2016
Posts: 2
Location: India

PostPosted: Thu Apr 28, 2016 3:09 pm
Reply with quote

Thanks for the reply. When the cics region is part of CICSPlex then to perform any function we need to set context and scope which tells which cicsplex and cics region the required function need to perform so for newcopy as well you need to tell. And the doc you shared is for TX series. I am asking for z/os platform
Back to top
View user's profile Send private message
Abid Hasan

New User


Joined: 25 Mar 2013
Posts: 88
Location: India

PostPosted: Thu Apr 28, 2016 4:07 pm
Reply with quote

From CICS TS 5.2 System Programming Reference (SC34-7294-00):

Quote:

COPY(cvda)
Specifies that a new copy of the program is to be used the next time that the
module is requested. LINK, XCTL, LOAD, ENABLE, and BMS commands can cause a
module request. You can choose to refresh the module only if it is not currently
in use (NEWCOPY), or to phase in the new version of the module for all
future requests (PHASEIN).
You cannot specify the COPY option for any module that is currently loaded
with the HOLD option, or for any program that is defined as remote.
CICS does not load the module at the time you issue the command, but it does
ensure that a copy is available. If you specified the SHARED option and the
module is in the link-pack area, the LPA copy satisfies this requirement.
Otherwise, CICS searches the DFHRPL or dynamic LIBRARY concatenations,
and returns an IOERR exception if it cannot locate a copy there.
For Java programs that run in a JVM server, you cannot use the NEWCOPY or
PHASEIN options of this command to refresh the program. To implement a
new version of the program, replace the old version of the CICS bundle with
an updated version. For more information, see Updating OSGi bundles in a
JVM server.
For PROGRAM resources that were defined and installed in a CICS bundle,
you cannot use the NEWCOPY or PHASEIN options of this command to
refresh the program. To implement a new version of the program, replace the
old version of the CICS bundle with an updated version. If the CICS bundle
was deployed as part of an application or with an application binding, update
the whole application.
This option has the following CVDA values:
NEWCOPY
The module is to be refreshed only if it is not currently in use;
otherwise CICS returns an INVREQ exception instead. You can
determine whether a module is in use from the RESCOUNT option in
an INQUIRE PROGRAM command. A value of zero means that the program
is not in use.
PHASEIN
The refresh is to occur whether or not the module is in use. If it is, the
copy or copies in use remain until they are no longer in use. All
requests that occur after the refresh use the new copy.
Back to top
View user's profile Send private message
Robert Sample

Global Moderator


Joined: 06 Jun 2008
Posts: 8696
Location: Dubuque, Iowa, USA

PostPosted: Thu Apr 28, 2016 5:41 pm
Reply with quote

NEWCOPY came first. IBM does not remove things without a good reason to maintain backward compatibility, so NEWCOPY will probably be around for a good long time after everyone starts using PHASEIN.
Back to top
View user's profile Send private message
Rohit Umarjikar

Global Moderator


Joined: 21 Sep 2010
Posts: 3048
Location: NYC,USA

PostPosted: Thu Apr 28, 2016 8:57 pm
Reply with quote

Concept is same on Zos too.
Quote:
Now when I can live happily with PHASE-IN why NEWCOPY still exits?

Because there many be IBM customer who still on older version where PHASEIN doesn't work, I think ,this is introduced in 4.1 release.
Back to top
View user's profile Send private message
View previous topic :: :: View next topic  
Post new topic   Reply to topic View Bookmarks
All times are GMT + 6 Hours
Forum Index -> CICS

 


Similar Topics
Topic Forum Replies
No new posts Required Date Format in Include Sort ... DFSORT/ICETOOL 6
No new posts COMPUSET/XICS z/os document required All Other Mainframe Topics 1
No new posts Number of Packages required for stati... DB2 4
No new posts Receommendations required for adding ... JCL & VSAM 5
No new posts FTP help required All Other Mainframe Topics 3
Search our Forums:

Back to Top