The remote API facility is the processing in which OpenTP1 transfers an API issued by the UAP at a client node to the server, and server processes are used to perform the delegated execution of the API. The UAP at the client node that requests the remote API facility is called a RAP-processing client. The RAP-processing listener of OpenTP1 receives the API issued by the RAP-processing client and the RAP-processing server executes the API on the server node. The RAP-processing listener and RAP-processing server operate as user services of OpenTP1.

Figure 3-62 shows an overview of the remote API facility.

Figure 3-62 Remote API facility

Table 3-17 shows the UAPs that can be a RAP-processing client.

Table 3-17 UAPs that can be RAP-processing clients

Program Product	UAPs that can be a RAP-processing client
TP1/Server Base	SUP, SPP, MHP
TP1/Client	CUP

The APIs that can be executed remotely for each type of RAP-processing client are listed below.

• TP1/Server Base and TP1/LiNK acting as the RAP-processing client
  

  C library function	Program for creating a COBOL-UAP
  dc_rpc_call	CBLDCRPC ('CALL ')

• TP1/Client/P and TP1/Client/W acting as the RAP-processing client
  

  C library function	Program for creating a COBOL-UAP
  dc_rpc_call_s	CBLDCRPS ('CALL ')
  dc_trn_begin_s	CBLDCTRS ('BEGIN ')
  dc_trn_chained_commit_s	CBLDCTRS ('C-COMMIT')
  dc_trn_chained_rollback_s	CBLDCTRS ('C-ROLL ')
  dc_trn_unchained_commit_s	CBLDCTRS ('U-COMMIT')
  dc_trn_unchained_rollback_s	CBLDCTRS ('U-ROLL ')

• TP1/Client/J acting as the RAP-processing client
  

  Method
  rpcCall
  trnBegin
  trnChainedCommit
  trnChainedRollback
  TrnUnchainedCommit
  trnUnchainedRollback

• TP1/Client for .NET Framework acting as the RAP-processing client
  

  Method
  Call
  Begin
  CommitChained
  RollbackChained
  Commit
  Rollback

Organization of this section

3.7.1 Example of using the remote API facility

3.7.2 Permanent connection

3.7.3 Connection mode

3.7.4 RAP-processing client manager

3.7.5 Definitions necessary for using the remote API facility

3.7.6 Prerequisites for using the XA resource service