Changing the PROGRAM resource definitions for the application
You can now change the PROGRAM resource definitions for the application to state that each program is threadsafe and must run on an open TCB as soon as the program starts. The attribute CONCURRENCY(REQUIRED) in the PROGRAM resource definitions produces this behavior.
Before you begin
All mirror transactions use the CICS-supplied mirror program DFHMIRS. The CICS-supplied PROGRAM resource definition for the mirror program DFHMIRS has had its CONCURRENCY attribute changed from CONCURRENCY(QUASIRENT) to CONCURRENCY(THREADSAFE) during the migration to CICS® TS 4.2. DFHMIRS is not defined as CONCURRENCY(REQUIRED) because only function shipping over IPIC is threadsafe. For MRO and ISC the function shipping code is not threadsafe, so its is not possible to define DFHMIRS to run on an open TCB from the start. DFHMIRS itself will decide to switch to an open TCB if appropriate, that is only when invoked over IPIC links.
For an application that uses a mirror transaction, it is important to check whether your application is using a copy of the PROGRAM resource definition for DFHMIRS, rather than the original CICS-supplied resource definition. If you are using a copy, when you are defining the PROGRAM resources for the application as threadsafe, make sure that you also change the attribute in your copy of the resource definition for DFHMIRS from CONCURRENCY(QUASIRENT) to CONCURRENCY(THREADSAFE). DFHMIRS must not be defined as CONCURRENCY(REQUIRED).
A file control, transient data queue, or temporary storage queue request must be function shipped over the IPIC connection in order for CICS to run DFHMIRS on an open TCB. If the mirror task is a long-running mirror, where the MIRRORLIFE attribute has been specified in the IPCONN resource definition to extend the lifetime of the mirror to the next sync point or to the end of the task, it can continue to run on the open TCB for subsequent requests.
About this task
These instructions explain how to modify the PROGRAM resource definition by using the CICS Explorer®. See www.ibm.com/cics/explorer/ for information about the CICS Explorer.
You could also modify the resource using a view that lists the attributes of the resource definition, such as CICSPlex® SM or the CEDA transaction in CICS.
You could also carry out this task using CICS Configuration Manager. For information about CICS Configuration Manager, seeCICS Configuration Manager.
Procedure
- From the CICS Explorer menu bar, select . The CICSplex Repositories window shows your data repository and an expandable list of the CICS regions in your CICSplex.
- In the CICSplex Repositories window, expand the list of CICS regions and highlight the region where one of the PROGRAM resources for the application is defined. From the CICS Explorer menu bar, select . All the program definitions in the CICS region are displayed.
- In the Name box at the top right of the Program Definitions view, type the name of the PROGRAM resource and press the right arrow button to apply the filter. The PROGRAM resource definition is displayed.
- Double-click the PROGRAM resource definition to open the editor for the definition. The view on the Overview tab combines the resource definition attributes and provides more detail about them to simplify the update process. To see the attributes individually in the same way as they appear in CEDA or the CICSPlex SM WUI, select the Attributes tab at the bottom of the editor window.
- In the Overview tab of the editor window, select all three of the boxes under the heading Open Transaction Environment. The boxes represent three levels of threadsafe capability, and you must select them in sequence. To see the effect on the resource definition attributes, click the Attributes tab. The program is now defined as API(CICSAPI) and CONCURRENCY(REQUIRED). The attributes that you have changed appear in bold text.
- Save your changes by selecting from the menu bar, or pressing Ctrl-S, or exiting the editor and confirming to save the changes.
- Right-click the name of the PROGRAM resource definition, and select Install. The Perform Operation window opens.
- Select the box for the CICS region where you are working with the PROGRAM resource, and click OK. The CICS Explorer displays a message at the bottom of the main window to verify that the resource has been reinstalled successfully.
- Repeat these steps for the remaining PROGRAM resources for the application.