Space announcement This documentation space provides the same content as before, but the organization of the content has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

NEWCOPY Function

Related Topics

Assembler User Guide

Code Debug for CICS C User Guide

COBOL User Guide

Code Debug for CICS PL I User Guide

The NEWCOPY function performs a PHASEIN to load a new version of a program into the CICS region after it has been changed by the programmer. Typically, the CEMT transaction is used to perform the NEWCOPY function; however, you may use Code Debug’s NEWCOPY function instead.

All users in the region can copy their programs using the NEWC transaction. If the program is in use by another user, an error message is issued, but the program is not disabled.

Only breakpoints that are set by symbolics (BEFORE ALL PARA, AFTER ALL LABEL) are reset when you issue the NEWC transaction. If the program is changed so that a label, paragraph name, or dataname used in a breakpoint no longer exists, that breakpoint fails; however, the rest of the breakpoints are still processed. Breakpoints that are set by statement number or offset are not reset.

Important

If you have set excludes, keeps, or verifys in your original program, and perform a NEWCOPY, the lines affected in the new copy of the program may be different than the lines the commands were originally set on.

To use the NEWC transaction, type NEWC, followed by the program name, on a blank CICS screen:

NEWC program-name

If the NEWCOPY is successful, a message similar to the following is displayed:

NEWC CWDEMCB2

MXDNC0001I 12 Jun 2008 13:56:52 - SYSID=C123 - APPLID=CICSC123
Program 'CWDEMCB2' phased in Len(00021E8)
From(XD.TEST.R82.PDE.LOADLIB)

The program name in the first line of the message may be overtyped to issue an additional NEWCOPY request.

For information on using NEWC in a dynamic transaction routing environment, see Specific Region Routing.

The NEWCOPY function can also be invoked from the NEWCOPY Programs screen (1.N). See NEWCOPY-Programs-1-N. 

Code Debug’s NEWCOPY function can also be invoked in multiple CICS regions from a single batch jobstep, which can be inserted after your batch linkedit jobstep. For details, see the Code Debug CICS Advanced Configuration space section entitled “Installing and Customizing the Batch Interface to Code Debug CICS NEWCOPY”.

For NEWCOPY function error messages, see Code Debug CICS Messages and Codes space.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*