3/19/2018 IBM Knowledge Center - Mirror transactions

Home  CICS Transaction Server for z/OS 5.3.0  . . .  Design overview 

Previous Next

Mirror transactions

 Table of contents Change version 

Search in all products

Search in this product... 

When a transaction issues a command for a function to run on a remote system, the local CICS system encodes the request and sends
it to the remote system. The remote system attaches one of the CICS-supplied mirror transactions, which all use the mirror program,
DFHMIRS.

The CVMI and CPMI mirror transactions service requests sent as part of an LU6.2 synclevel 1 conversation. The CPMI, CSMI, CSM1,
CSM2, CSM3, and CSM5 mirror transactions service requests that are sent as part of an LU6.2 synclevel 2 conversation, an LU6.1
conversation, an MRO conversation, or an IPIC conversation.

For distributed program link (DPL) requests shipped from a CICS application region to a CICS resource region, you can specify the
name of the mirror transaction to be attached. If you specify your own mirror transaction, you must define the transaction in the
resource region and associate it with the CICS-supplied mirror program, DFHMIRS.

A mirror transaction runs the request from the initiating transaction and returns to the local system the response code and any control
fields and data that are associated with the request. If running the request causes the mirror transaction to abend, this information is
also returned to the initiating transaction.

If a resource has browse place holders or is recoverable, or the lock has been acquired, the mirror transaction becomes a long-running
mirror and does not end until the issuing transaction ends the logical unit of work; that is, a SYCNPOINT or RETURN. Any resources
that the mirror has acquired are freed when the initiating transaction issues the appropriate command to free those resources.

The CICS-supplied mirror program DFHMIRS is defined as a threadsafe program. For IPIC connections only, CICS runs DFHMIRS on
an L8 open TCB whenever possible. For other connection types, CICS does not run DFHMIRS on an open TCB. For threadsafe
applications that issue commands for functions on remote CICS systems over IPIC connections, the reduction in TCB switching
improves application performance compared to other intercommunication methods. For file control commands, to gain the
performance improvement, you must specify the system initialization parameter FCQRONLY=NO in the file-owning region.

Parent topic:
 Design overview

dfhs3c00775.html | Last updated: Sunday, 14 January 2018

Please note that DISQUS operates this forum. When you sign in to comment, IBM will provide your email, first name and last name to DISQUS. That
information, along with your comments, will be governed by DISQUS’ privacy policy. By commenting, you are accepting the DISQUS terms of
service.

https://www.ibm.com/support/knowledgecenter/en/SSGMCP_5.3.0/com.ibm.cics.ts.diagnosisref.doc/topics/dfhs3c00775.html 1/3
3/19/2018 IBM Knowledge Center - Mirror transactions

Sign In

0 Comments IBM Knowledge Center

Sort by Best
 Recommend ⤤ Share

Nothing in this discussion yet.

✉ Subscribe d Add Disqus to your siteAdd DisqusAdd 🔒 Privacy

More topics

Application programming functions with CICS function shipping

Local and remote names

Initialization of CICS for CICS function shipping

Communication with a remote system

Protocols

CICS function shipping environment

CICS function shipping—handling of EXEC CICS commands

CICS function shipping—handling of DL/I requests

Terminal control support for CICS function shipping

NOCHECK option function handling

 Print this topic

 Help
 Select a product

 Open a ticket and download fixes at the IBM Support Portal

Find a technical tutorial in developerWorks

Find a best practice for integrating technologies in IBM Redbooks

Contact Privacy Terms of use Accessibility Feedback

English 

https://www.ibm.com/support/knowledgecenter/en/SSGMCP_5.3.0/com.ibm.cics.ts.diagnosisref.doc/topics/dfhs3c00775.html 2/3
3/19/2018 IBM Knowledge Center - Mirror transactions

https://www.ibm.com/support/knowledgecenter/en/SSGMCP_5.3.0/com.ibm.cics.ts.diagnosisref.doc/topics/dfhs3c00775.html 3/3