OpenTP1 Version 7 Tester and UAP Trace User's Guide
As shown in 14.1(1) Simulation functions, you can simulate functions provided by OpenTP1 by using the simulation functions of the offline tester. However, functions provided by OpenTP1 that are listed in the following tables are not supported by the simulation functions of the offline tester. Therefore, if these functions are executed by a UAP, only the return values listed in the following tables are returned, and trace information is not acquired nor are function arguments changed. In addition, you cannot set return values in the function return value file.
The following tables separately list the simulation functions not supported for C and for COBOL.
Table 14-3 List of functions not supported by the simulation feature (for C)
Type | Function name | Description of the OpenTP1-provided function | Return value |
---|---|---|---|
Remote procedure call (rpc) | dc_rpc_call_to function | Calls a remote service by specifying the communication destination. | 0 |
dc_rpc_get_error_descriptor function | Acquires the descriptor of the asynchronous response RPC request where an error occurred. | 1 | |
dc_rpc_discard_specific_reply function | Rejects the reception of specific processing results. | DC_OK | |
dc_rpc_service_retry function | Retries a service function. | DC_OK | |
dc_rpc_get_gateway_address function | Acquires the gateway node address. | DC_OK | |
dc_rpc_cltsend function | One-way communication to the CUP | DC_OK | |
Remote API facility (rap) | dc_rap_connect function | Establishes a connection with a RAP-processing listener. | DC_OK |
dc_rap_disconnect function | Releases the connection with a RAP-processing listener. | DC_OK | |
Performance verification trace (prf) | dc_prf_utrace_put function | Acquires the user-specific performance verification trace information. | DC_OK |
dc_prf_get_trace_num function | Reports the sequential number of the acquired performance verification trace information. | DC_OK | |
Message transmission (mcf) | dc_mcf_ap_info function | Reports application information. | DCMCFRTN_00000 |
dc_mcf_ap_info_uoc function | Reports application information to a user exit routine. | DCMCFRTN_00000 | |
dc_mcf_timer_set function | Sets user timer monitoring. | DC_OK | |
dc_mcf_timer_cancel function | Cancels user timer monitoring. | DC_OK | |
DAM file service (dam) | dc_dam_bseek function | Searches for a physical file block. | Returns the relative block number specified in the argument of the function. |
dc_dam_dget function | Directly reads a block from a physical file. | 504 | |
dc_dam_dput function | Directly writes data to a block in a physical file. | 504 |
Table 14-4 List of functions not supported by the simulation feature (for COBOL)
Type | Program name (request code) | Description of the OpenTP1-provided function | Status code |
---|---|---|---|
Remote procedure call (rpc) | CBLDCRPC ('GETERDES') | Acquires the descriptor of the asynchronous response RPC request where an error occurred. | 00000 |
CBLDCRPC ('DISCARDS') | Rejects the reception of specific processing requests. | 00000 | |
CBLDCRPC ('SVRETRY') | Retries a service program. | 00000 | |
CBLDCRPC ('GETGWADR') | Acquires the gateway node address. | 00000 | |
Remote API facility (rap) | CBLDCRAP ('CONNECT') | Establishes a connection with a RAP-processing listener. | 00000 |
CBLDCRAP ('DISCNCT') | Releases the connection with a RAP-processing listener. | 00000 | |
Edition of journal data (jnl) | CBLDCJUP ('CLOSERPT') | Closes the jnlrput output file. | 00000 |
CBLDCJUP ('OPENRPT') | Opens the jnlrput output file. | 00000 | |
CBLDCJUP ('RDGETRPT') | Enters journal data from the jnlrput output file. | 00000 | |
Performance verification trace (prf) | CBLDCPRF ('PRFPUT') | Acquires the user-specific performance verification trace information. | 00000 |
CBLDCPRF ('PRFGETN') | Reports the sequential number of the acquired performance verification trace information. | 00000 | |
Transmission of messages (mcf) | CBLDCMCF ('APINFO') | Reports application information. | 00000 |
DAM file service (dam) | CBLDCDMB ('BSEK') | Searches for a physical file block. | 00000 |
CBLDCDMB ('DGET') | Directly reads a block from a physical file. | 00000 | |
CBLDCDMB ('DPUT') | Directly writes data to a block in a physical file. | 00000 | |
XATMI interface (tp~) | TPCALL | Calls a request or response service and receives the reply. | TPOK# |
TPACALL | Calls a request or response service. | TPOK# | |
TPGETRPLY | Receives an asynchronous reply from a request or response service. | TPOK# | |
TPCANCEL | Cancels a request or response service. | TPOK# | |
TPCONNECT | Establishes a connection with an interactive service. | TPOK# | |
TPDISCON | Disconnects an interactive service. | TPOK# | |
TPRECV | Receives a message from an interactive service. | TPOK# | |
TPSEND | Sends a message to an interactive service. | TPOK# | |
TPADVERTISE | Advertises a service name. | TPOK# | |
TPUNADVERTISE | Cancels the advertisement of a service name. | TPOK# | |
TPSVCSTART | Starts a service routine. | TPOK# | |
TPRETURN | Returns control from a service routine. | There is no status code. |
#: TPOK is set in the data area (TP-STATUS) where a return value indicating the result of execution is set.
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.