1. ATMI client invokes toupsrv service.
2. The toupsrv service issues tpcall for SIMPDPL, which is advertised in the DM_REMOTE_SERVICES section of the DMCONFIG file.
3.
4. The TOUPDPLS program processes data.
5.
1. ATMI client invokes toupsrv service.
2. The toupsrv service issues tpacall for SIMPDPL, which is advertised in the DM_REMOTE_SERVICES section of DMCONFIG file.
3.
4. The TOUPDPLS program processes data.
5.
1. ATMI client invokes toupsrv service.
2. The toupsrv service issues tpacall for SIMPDPL, which is advertised in the DM_REMOTE_SERVICES section of DMCONFIG file. The toupsrv service uses TPNOREPLY to specify that no reply is expected.
3.
4. The TOUPDPLS program processes data.
1.
2. The EXEC CICS LINK command causes the advertised service mapped to MIRRDPLS (in the DM_LOCAL_SERVICES section of the DMCONFIG file) to execute.
3. The MIRROR service processes the data received in the service TPSVCINFO data buffer from the EXEC CICS LINK.
4.
1.
2. The EXEC CICS LINK command causes the advertised service mapped to MIRRDPLS (in the DM_LOCAL_SERVICES section of the DMCONFIG file) to execute. The SYNCONRETURN option indicates that the invoked service will not participate in the CICS/ESA transaction.
3.
4. The MIRROR service processes the data.
5. The tpcommit indicates the end of the transaction; all updates performed within the service transaction are to be committed.
6.
7. The EXEC CICS SYNCPOINT is an explicit commit request. All updated resources in the CICS/ESA transaction are committed.
1. ATMI client invokes toupsrv service.
2.
3. The toupsrv service issues tpcall for SIMPDPL, which is advertised in the DM_REMOTE_SERVICES section of the DMCONFIG file. The TPNOTRAN parameter indicates the CICS/ESA application does not participate in the service transaction.
4.
5. The TOUPDPLS program processes data.
6. The EXEC CICS SYNCPOINT is an explicit commit request. All updated resources in the CICS/ESA transaction are committed.
7.
8. The toupsrv service tpcommit request signals the successful completion of the transaction, causing a commit of its own updated resources.
1. ATMI client invokes toupsrv service.
2.
3. The toupsrv service issues tpcall for SIMPDPL, which is advertised in the DM_REMOTE_SERVICES section of the DMCONFIG file. The tpcall is requested multiple times within the same transaction.
4. Host mirror transaction starts TOUPDPLS program and passes idata buffer contents for processing. The host mirror transaction remains as a long-running task to service all further requests on the transaction.
5. The TOUPDPLS program processes data.
6.
7. Step 3 through Step 6 are repeated until the toupsrv service loop end conditions are met.
8. The tpcommit request indicates the successful completion of the transaction, causing a commit of its own resources and the resources held by the host mirror transaction.
1.
2. The EXEC CICS LINK command causes the advertised service mapped to MIRRDPLS (in the DM_LOCAL_SERVICES section of the DMCONFIG file) to execute. The invoked service participates in the CICS/ESA transaction.
3. The MIRROR service processes the data.
4.
5. The EXEC CICS SYNCPOINT is an explicit commit request indicating a successful end of the conversation. All updated resources in the transaction are committed.
1. User-entered KNC1 invokes CHANCONC program.
3. The EXEC CICS LINK command causes the advertised service mapped to CHANCONS to execute.
4. The CHAN1 service gets all containers from the channel, processes data of them, and puts them back to channel.
5.
6. Although it is most suited for the DPL environment, the tpcall is usually used for the DPL environment, it can also be used for a request/response to a DTP server.
1. ATMI client invokes toupsrv service.
2. The toupsrv service issues tpcall for SIMPDTP, which is advertised in the DM_REMOTE_SERVICES section of DMCONFIG file.
3.
4. It is recommended you save the eibtrmid to a program variable. This value may be used to identify the specific conversation in your CICS/ESA APPC verbs.
5.
6. The TOUPDTPS program processes data.
7. The EXEC CICS SEND command returns the OUT-BUFFER contents into the clients odata buffer. LAST indicates the conversation is finished. WAIT suspends processing until the data has successfully been received.
1. ATMI client invokes toupsrv service.
2. The toupsrv service issues tpacall for SIMPDTP, which is advertised in the DM_REMOTE_SERVICES section of the DMCONFIG file.
3. User transaction DTPS starts TOUPDTPS program.
4. It is recommended you save the EIBTRMID to a program variable. This value may be used to identify the specific conversation in your CICS/ESA APPC verbs.
5.
6. The TOUPDTPS program processes data.
7. The EXEC CICS SEND command returns the OUT-BUFFER contents into the clients tpgetreply odata buffer. LAST indicates the conversation is finished. WAIT suspends processing until the data has successfully been received.
1. ATMI client invokes toupsrv service.
2. The toupsrv service issues tpacall with a TPNOREPLY request for SIMPDTP, which is advertised in the DM_REMOTE_SERVICES section of DMCONFIG file.
3. User transaction DTPS starts TOUPDTPS program.
4. It is recommended you save the EIBTRMID to a program variable. This value may be used to identify the specific conversation on your CICS/ESA APPC verbs.
5.
6. The TOUPDTPS program processes data.
1. ATMI client invokes toupsrv service.
2. The toupsrv service issues tpconnect for SIMPDTP, which is advertised in the DM_REMOTE_SERVICES section of DMCONFIG file. The TPRECVONLY flag indicates the server gets control and the first conversation verb toupsrv can issue is tprecv. Data is sent on the tpconnect in the idata buffer.
3. User transaction DTPS starts TOUPDTPS program.
4. It is recommended you save the EIBTRMID to a program variable. This value may be used to identify the specific conversation on your CICS/ESA APPC verbs.
5.
6. The TOUPDTPS program processes data.
7. The EXEC CICS SEND command returns the OUT-BUFFER contents into the clients tprecv odata buffer. WAIT suspends processing in TOUPDTPS until the data has successfully been received. LAST indicates the conversation is finished and is communicated to the tprecv as TPEV_SVCSUCC.
1. ATMI client invokes toupsrv service.
2. The toupsrv service issues tpconnect for SIMPDTP, which is advertised in the DM_REMOTE_SERVICES section of DMCONFIG file. The TPSENDONLY indicates the client retains control and continues to send data. Data is sent on the tpconnect in the idata buffer.
3. User transaction DTPS starts TOUPDTPS program.
4. It is recommended you save the EIBTRMID to a program variable. This value may be used to identify the specific conversation on your CICS/ESA APPC verbs.
5.
6. The TOUPDTPS program processes data.
7.
9. The EXEC CICS SEND WAIT LAST returns OUT-BUFFER data in the tprecv odata buffer, along with notification that the conversation is over.
1. ATMI client invokes toupsrv service.
2. The toupsrv service issues tpconnect for SIMPDTP, which is advertised in the DM_REMOTE_SERVICES section of DMCONFIG file. The TPRECVONLY indicates the server gets control and the first conversation verb toupsrv can issue is tprecv.
3. User transaction DTPS starts TOUPDTPS program.
4. It is recommended you save the EIBTRMID to a program variable. This value may be used to identify the specific conversation on your CICS/ESA APPC verbs.
5. The EXEC CICS RECEIVE command receives a send state indicator from the tpconnect TPRECVONLY flag. No data is received into the INBUFFER.
6. The EXEC CICS SEND command returns the OUT-BUFFER contents into the clients tprecv odata buffer. The EXEC CICS SEND command relinquishes control to the client by using the INVITE option. This is communicated to the tprecv as TPEV_SENDONLY.
7. The EXEC CICS RECEIVE command receives the tpsend idata contents into the server’s IN-BUFFER, along with notification that the server has relinquished control.
8.
1.
2. The EXEC CICS ALLOCATE acquires a session to the remote Tuxedo domain.
3. Save the conversation ID returned in EIBRSRCE to a program variable. This value is used to identify the specific conversation in your CICS/ESA APPC verbs.
4. The EXEC CICS CONNECT PROCESS command initiates the advertised service mapped to MIRROR in the DM_LOCAL_SERVICES section of the DMCONFIG file.
5. Execute the EXEC CICS SEND command to send the contents of the OUT-BUFFER to the Tuxedo service in the tpsvcinfo->data buffer. The contents might be sent immediately.
6. The EXEC CICS SEND INVITE WAIT command sends out-buff contents into the tprecv odata buffer. The INVITE parameter relinquishes control of the conversation, seen as a TPEV_SENDONLY in the reevent parameter on the tprecv command. The data is sent immediately, along with the data from the previous SEND operation.
9. The ATMI tpreturn data returns data to the EXEC CICS RECEIVE, along with notification that the conversation completed successfully.
1. User-entered HOTP invokes MIRRDTPC program.
2. The EXEC CICS ALLOCATE acquires a session to the remote Tuxedo domain.
3. Save the conversation ID returned in EIBRSRCE to a program variable. This value is used to identify the specific conversation in your CICS/ESA APPC verbs.
4. The EXEC CICS CONNECT PROCESS command initiates the advertised service mapped to MIRROR in the DM_LOCAL_SERVICES section of the DMCONFIG file.
5.
6.
7. The tpreturn request tears down the conversation and indicates on the EXEC CICS RECEIVE that the conversation is over.
1. ATMI client toupclt invokes toupsrv service. (Note that each tpcall made in the program must be bookended with a tpbegin and a tpcommit.)
2. The service issues tpbegin to start a transaction.
3. The toupsrv service issues tpcall for SIMPDTP, which is advertised in the DM_REMOTE_SERVICES section of the DMCONFIG file.
4. User transaction DTPS starts TOUPDTPS program.
5. Save the EIBTRMID to a program variable. This value is used to identify the specific conversation on your CICS/ESA APPC verbs.
6.
7. The TOUPDTPS program processes data.
8. The EXEC CICS SEND command returns the OUT-BUUFER contents into the clients odata buffer. CONFIRM indicates the conversation is finished. INVITE allows the client to respond with a COMMIT request.
9. The toupsrv service issues tpcommit to end the transaction. The COMMIT is received on the EXEC CICS RECEIVE verb and the server issues EXEC CICS RETURN to commit the resources, terminate the transaction, and free the outstanding conversation.
1. ATMI client invokes toupsrv service.
2.
3. The toupsrv service issues tpconnect for SIMPDTP, which is advertised in the DM_REMOTE_SERVICES section of DMCONFIG file. The TPRECVONLY indicates the server gains control and the first conversation verb toupsrv can issue is tprecv. Data is sent on the tpconnect in the idata buffer.
4. User transaction DTPS starts TOUPDTPS program.
5. It is recommended you save the EIBTRMID to a program variable. This value may be used to identify the specific conversation on your CICS/ESA APPC verbs.
6.
7. The TOUPDTPS program processes data.
8. The EXEC CICS SEND command returns the OUT-BUFFER contents into the clients tprecv odata buffer. CONFIRM indicates that the conversation is finished and is communicated to the tprecv as TPEV_SVCSUCC. INVITE enables the client to respond with a COMMIT request.
9. The toupsrv service issues tpcommit to end the transaction. The COMMIT is received on the EXEC CICS RECEIVE verb and the server issues EXEC CICS RETURN to commit the resources, terminate the transaction, and free the outstanding conversation.
1. User-entered H2TP invokes MIRRDTPC program.
2. The EXEC CICS ALLOCATE acquires a session to the remote Tuxedo domain.
3. Save the conversation ID returned in EIBRSRCE to a program variable. This value is used to identify the specific conversation on your CICS/ESA APPC verbs.
4. The EXEC CICS CONNECT PROCESS command initiates the advertised service mapped to MIRRDTPS. The SYNCLEVEL(2) parameter indicates the inclusion of the ATMI service in the CICS/ESA transaction.
5. The EXEC CICS SEND INVITE WAIT command causes the client to immediately relinquish control to the Tuxedo server. This is communicated to the service in TPSVCINFO as TPSENDONLY. No data is sent to the server on this request.
6. The EXEC CICS RECEIVE command receives the tpsend idata buffer contents into the IN-BUFFER. The EXEC CICS RECEIVE command receives a confirm request indicating the conversation should be terminated.
7. The EXEC CICS ISSUE CONFIRMATION verb responds positively to the confirm request.
8. The EXEC CICS SYNCPOINT is an explicit commit request to end the conversation and update all resources in the transaction.
9. The EXEC CICS FREE verb explicitly frees the outstanding conversation.Although it is most suited for the DPL environment, the tpcall is usually used in the DPL environment but can also be used for a request/response to an APPC server.
1. ATMI client invokes toupsrv service.
2. The toupsrv service issues tpcall for SIMPCPIC, which is advertised in the DM_REMOTE_SERVICES section of the DMCONFIG file.
3.
4. The server accepts the conversation with the cmaccp call. The conversation id returned on the request in convid is used for all other requests on this conversation.
5.
6. The TOUPCPIC program processes data.
7. The cmsst request prepares the next send request by setting the send type to CM_SEND_AND_DEALLOCATE.
8. The cmsend request returns the obuffer contents into the client odata buffer. The buffer is flushed, and the conversation ended.
1. ATMI client invokes toupsrv service.
2. The toupsrv service issues tpacall for SIMPCPIC, which is advertised in the DM_REMOTE_SERVICES section of the DMCONFIG file.
3.
4. The server accepts the conversation with the cmaccp call. The conversation id returned on the request in convid is used for all other requests on this conversation.
5.
6. The TOUPCPIC program processes data.
7. The cmsend command returns the obuffer contents into the client tpgetreply odata buffer. The data may not be immediately sent to the tpgetreply odata buffer on this request.
8. The cmdeal flushes the data to the client, and indicates the conversation is finished.
1. ATMI client invokes toupsrv service.
2. The toupsrv service issues tpacall with a TPNOREPLY request for SIMPCPIC, which is advertised in the DM_REMOTE_SERVICES section of the DMCONFIG file.
3.
4. The server accepts the conversation with the cmaccp call. The conversation id returned on the request in convid is used for all other requests on this conversation.
5. The cmrcv request receives the idata buffer contents for processing, and notification that the conversation has ended with the return code value of CM_DEALLOCATED_NORMAL.
6. The TOUPCPIC program processes data.
1. ATMI client invokes toupsrv service.
2. The toupsrv service issues tpconnect for SIMPCPIC, which is advertised in the DM_REMOTE_SERVICES section of the DMCONFIG file. The TPRECVONLY indicates the server gains control and the first conversation verb the toupsrv can issue is tprecv. Data is sent on the tpconnect in the idata buffer.
3.
4. The server accepts the conversation with the cmaccp call. The conversation ID returned on the request in convid is used for all other requests on this conversation.
5.
6. The TOUPCPIC program processes data.
7.
8. The cmsend command returns the obuffer contents into the client tprecv odata buffer. The data is immediately flushed on the send request.
9. The cmdeal request ends the conversation.
1. ATMI client invokes toupsrv service.
2. The toupsrv service issues tpconnect for SIMPCPIC, which is advertised in the DM_REMOTE_SERVICES section of the DMCONFIG file. The TPSENDONLY indicates the client retains control and continues to send data. No data is sent with the tpconnect.
3.
4. The server accepts the conversation with the cmaccp call. The conversation id returned on the request in convid is used for all other requests on this conversation.
5. The cmrcv request receives the tpsend idata buffer contents for processing. The conversation is relinquished with the TPRECVONLY flag.
6. The TOUPCPIC program processes data.
7. The cmsend returns a response in the tprecv idata buffer, along with notification from the cmdeal command that the conversation is over. The cmdeal flushes the data buffer and the tprecv reevent parameter is set to TPEV_SUCCESS.
1. ATMI client invokes toupsrv service.
2. The toupsrv service issues tpconnect for SIMPCPIC, which is advertised in the DM_REMOTE_SERVICES section of the DMCONFIG file. The TPRECVONLY indicates the server gains control and the first conversation verb the toupsrv can issue is tprecv.
3.
4. The server accepts the conversation with the cmaccp request. The conversation id returned on the request in convid is used for all other requests on this conversation.
5. The cmrcv requests receives the indicator that control has been granted to the server.
6. The cmsend request returns its obuffer contents into the first client tprecv odata buffer. The data may not immediately be sent.
7. The cmsend request returns its obuffer contents into the second client tprecv odata buffer. The data may not immediately be sent.
8. The cmptr request flushes the data to the client, and grants control to the client.
9. The cmrcv request receives the tpsend idata buffer contents for processing. The TPRECVONLY is passed to the tprecv, relinquishing control of the conversation.
10.
1. The CPI-C application program MIRRCPIC is invoked using environment start-up specifications.
2. The MIRRCPIC client requests cminit to establish conversation attributes and receive a conversation ID that will be used on all other requests on this conversation. The remote server and service are named in the CPI-C side information entry MIRRSIDE.
3. The cmallc request initiates the advertised service mapped to MIRRORSERV in the DM_LOCAL_SERVICES section of the DMCONFIG file.
4.
5. The cmdeal request flushes the data, and indicates the conversation is finished with the TPNOREPLY in the tpsvcinfo->flag field.
6. The service completes with the tpreturn.
2. The MIRRCPIC client requests cminit to establish conversation attributes and receive a conversation id that will be used on all other requests on this conversation. The remote server and service are named in the CPI-C side information entry MIRRSIDE.
3. The cmallc request initiates the advertised service mapped to MIRRORSERV in the DM_LOCAL_SERVICES section of the DMCONFIG file.
4. The cmsst request prepares the next send request by setting the send type to CM_SEND_AND_PREP_TO_RECEIVE.
5. The cmsend request immediately sends the contents of obuffer to the ATMI service in the tpsvcinfo->data buffer and relinquishes control to the mirrorserv service.
6. The cmrcv request receives the contents of the odata returned on the ATMI tpreturn service, and notification that the conversation has ended with the return code value of CM_DEALLOCATED_NORMAL.
2. The MIRRCPIC client requests cminit to establish conversation attributes and receive a conversation id that will be used on all other requests on this conversation. The remote server and service are named in the CPI-C side information entry MIRRSIDE.
3. The cmallc request initiates the advertised service mapped to MIRRORSERV in the DM_LOCAL_SERVICES section of the DMCONFIG file.
4.
5. The cmdeal request flushes the data and ends the conversation, as indicated by TPNOREPLY in the tpsvcinfo->flag field.
1. The CPI-C application program MIRRCPIC is invoked using environment start-up specifications.
2. The MIRRCPIC client requests cminit to establish conversation attributes and receive a conversation ID that will be used on all other requests on this conversation. The remote server and service are named in the CPI-C side information entry MIRRSIDE.
3. The cmallc request initiates the advertised service mapped to MIRROR in the DM_LOCAL_SERVICES section of the DMCONFIG file.
4. The cmptr relinquishes control of the conversation to the ATMI service indicated as TPSENDONLY in the tpsvcinfo->flag field. No data is passed in the tpsvcinfo->data field.
5. The cmrcv receives the contents of the tpsend odata into the ibuffer. The end of the conversation is passed from the tpreturn service as return code value CM_DEALLOCATED_NORMAL.
1. ATMI client invokes toupsrv service.
2.
3. The toupsrv service issues tpcall for SIMPCPIC, which is advertised in the DM_REMOTE_SERVICES section of the DMCONFIG file. Data is sent from the idata buffer on the tpconnect.
4.
5. The server accepts the conversation with the cmaccp call. The conversation ID returned on the request in convid is used for all other requests during this conversation.
6.
7. The cmsst and cmsptr prepare the next send request by setting the send type to CM_SEND_AND_PREP_TO_RECEIVE and by setting the prepare-to-receive type to CM_PREP_TO_RECEIVE_CONFIRM.
8. The cmsend request immediately returns the obuffer contents into the client’s odata buffer. The server relinquishes control to the server and indicates the end of the conversation with the CONFIRM request.
9. The toupsrv issues the tpcommit to successfully complete the transaction and commit all updated resources. The cmrcv request receives the commit request, and responds explicitly to the request with the SAA Resource/Recovery commit call srrcmit. The conversation is ended after the successful commit exchange.
1. ATMI client invokes toupsrv service.
2.
3. The toupsrv service issues a tpconnect service request for SIMPCPIC, which is advertised in the DM_REMOTE_SERVICES section of the DMCONFIG file. Data is sent in the idata buffer on the tpconnect.
4.
5. The server accepts the conversation with the cmaccp call. The conversation ID returned on the request in convid is used for all other requests during this conversation.
6.
7. The TOUPCPIC program processes the data.
8. The cmsend returns the obuffer contents into the client’s tprecv odata buffer. The buffer contents may not be sent immediately.
9. The cmsptr prepares the prepare-to-receive request with CM_PREP_TO_RECEIVE_CONFIRM. The cmptr request with CONFIRM indicates that the conversation is finished and is communicated to the tprecv as TPEV_SVCSUCC.
10. The toupsrv issues the tpcommit to successfully complete the transaction and commit all updated resources. The cmrcv request receives the commit request and responds explicitly to the request with the SAA Resource/Recovery commit call srrcmit. The conversation is ended after the successful commit exchange.
1. The CPI-C application program MIRRCPIC is invoked using environment start-up specifications.
2. The MIRRCPIC client requests cminit to establish conversation attributes and receive a conversation ID that will be used on all other requests on this conversation. The remote server and service are named in the CPI-C side information entry MIRRSIDE.
3. The cmssl sets the conversation attributes to sync-level 2 with CM_SYNCPOINT. This allows the ATMI service to participate in the transaction.
4. The cmallc request initiates the advertised service mapped to MIRRORSERV in the DM_LOCAL_SERVICES section of the DMCONFIG file.
5. The MIRRCPIC causes the client to relinquish control to the ATMI server with a prepare-to-receive request. The cmsptr sets the prepare-to-receive type to CM_RECEIVE_AND_FLUSH. The cmptr request immediately relinquishes control.
6. The MIRROR service sends the data contents of the odata buffer to the cmrcv ibuffer. The cmrcv receives a confirm request from the server indicating the conversation should be terminated.
8. The MIRRCPIC client prepares to free the conversation with the cmdeal request. The conversation in CM_DEALLOCATE_SYNC_LEVEL commits all updated resources in the transaction and waits for the SAA resource recovery verb, srrcmit. After the commit sequence has completed, the conversation terminates.
1. The ATMI service makes a request to the service TRN1DATA, which is advertised as a remote service in the DMCONFIG file. It is a DPL request to a program named SVC1 in the CICS/ESA region.
2. The first four characters of the remote service tag name (TRN1) are extracted and passed to the CICS/ESA region as the invoking TRANSID. No CICS/ESA resource definition for the TRANSID is required in the region.
3. The mirror transaction CSMI is attached in the CICS/ESA region, starting the mirror program DFHMIRS. The program performs the DTP requests for the service.
4. The mirror program now attaches the invoking TRANSID (TRN1) and then invokes the application service program SVC1.The program can interrogate the EIBTRNID field to find this value.
1. The ATMI program makes a service request for SERVICE1, which is advertised as a remote service in the DMCONFIG file. The FUNCTION option indicates the remote service is invoked as a DPL.
2. The request extracts TRN1 as an alternate mirror transaction ID for the remote region, along with the remote program name SERVICE1.
3. The TRN1 ID is attached instead of the default mirror transaction, CSMI or CVMI. The TRN1 ID must be defined as a transaction resource in the remote region and must point to the mirror transaction program DFHMIRS.
4. The mirror program DFMMIRS calls the server application program, passing the TRN1 ID in the EIBTRNID field.
1. The CICS/ESA program makes a request to INSVC1, which is a local ATMI service. The SYSID and PROGRAM values in the request identify the local system and the name of the local service. The TRANSID option indicates the mirror transaction to be initiated.
2. The PROGRAM and mirror TRANSID are extracted from the DPL request and are used to find an exact RNAME match in the DM_LOCAL_SERVICES section of the DMCONFIG file.
3. The service SERVICE1, which is advertised locally in the ATMI platform application, is initiated.
• CICS/ESA Intercommunication Guide, IBM publication No. SC33-0657
• CICS/ESA Distributed Transaction Programming Guide, IBM publication No. SC33-00783
• CICS/ESA Recovery and Restart Guide, IBM publication No. SC33-0658