OpenTP1 Version 7 User's Guide

[Contents][Index][Back][Next]

3.1 List of code-level functions

The code-level functions that are available differ between OpenTP1 for Windows and OpenTP1 for UNIX. In addition, limitations apply to some functions, such as arguments and settings that are not supported. If you are new to OpenTP1 for Windows, we recommend that you check the list below for the differences from OpenTP1 for UNIX.

Once you have checked this list, see the applicable language's edition of the manual OpenTP1 Version 7 Programming Reference for details of the functions.

Note
This list does not include the functions for message queuing (TP1/Message Queue).

The following symbols are used in the list:

Legend:
S: Same (function is supported identically in OpenTP1 for Windows and OpenTP1 for UNIX)
D: Differences (function has differences in OpenTP1 for Windows from OpenTP1 for UNIX or some limitations apply to OpenTP1 for Windows)
N: Not supported (function is not supported for OpenTP1 for Windows)
--: Not applicable

The following table lists and describes differences in functionality between OpenTP1 for Windows and OpenTP1 for UNIX.

Table 3-1 Differences in functionality between OpenTP1 for Windows and OpenTP1 for UNIX

Classification/purpose Function name# Support by OpenTP1 for Windows Difference from OpenTP1 for UNIX
Remote procedure call Starting an application program dc_rpc_open
CBLDCRPC('OPEN ')
S --
Starting an SPP service dc_rpc_mainloop
CBLDCRSV('MAINLOOP')
S --
Requesting a remote service dc_rpc_call
CBLDCRPC('CALL ')
D The DCRPC_DOMAIN setting in flags is not supported.
Invoking a remote service with a communication destination specified dc_rpc_call_to
--
S --
Receiving processing results in asynchronous mode dc_rpc_poll_any_replies
CBLDCRPC('POLLANYR')
S --
Acquiring a descriptor of an asynchronous-response RPC request resulting in an error dc_rpc_get_error_descriptor
CBLDCRPC('GETERDES')
S --
Rejecting reception of processing results dc_rpc_discard_further_replies
CBLDCRPC('DISCARDF')
S --
Discarding a specific response message of an asynchronous-response RPC dc_rpc_discard_specific_reply
CBLDCRPC('DISCARDS')
S --
Retrying a service function dc_rpc_service_retry
CBLDCRPC('SVRETRY')
S --
Setting a schedule priority for service requests dc_rpc_set_service_prio
CBLDCRPC('SETSVPRI')
S --
Referencing a schedule priority for service requests dc_rpc_get_service_prio
CBLDCRPC('GETSVPRI')
S --
Referencing the service response wait time dc_rpc_get_watch_time
CBLDCRPC('GETWATCH')
S --
Updating the service response wait time dc_rpc_set_watch_time
CBLDCRPC('SETWATCH')
S --
Acquiring a client UAP's node address dc_rpc_get_callers_address
CBLDCRPC('GETCLADR')
S --
Acquiring a gateway node address dc_rpc_get_gateway_address
CBLDCRPC('GETGWADR')
S --
Unilaterally reporting to a CUP dc_rpc_cltsend
CBLDCRPC('CLTSEND ')
S --
Terminating an application program dc_rpc_close
CBLDCRPC('CLOSE ')
S --
Remote API facility Establishing a connection with a RAP-processing listener dc_rap_connect
CBLDCRAP('CONNECT ')
CBLDCRAP('CONNECTX')
S --
Disconnecting from a RAP-processing listener dc_rap_disconnect
CBLDCRAP('DISCNCT ')
S --
Transaction control Starting a transaction dc_trn_begin
CBLDCTRN('BEGIN ')
S --
Committing in chained mode dc_trn_chained_commit
CBLDCTRN('C-COMMIT')
S --
Rolling back in chained mode dc_trn_chained_rollback
CBLDCTRN('C-ROLL ')
S --
Committing in unchained mode dc_trn_unchained_commit
CBLDCTRN('U-COMMIT')
S --
Rolling back in unchained mode dc_trn_unchained_rollback
CBLDCTRN('U-ROLL ')
S --
Reporting information about the current transaction dc_trn_info
CBLDCTRN('INFO ')
S --
System operations management Executing operation commands dc_adm_call_command
CBLDCADM('COMMAND ')
D
  • The DCADM_DELAY setting in flags is not supported.
  • If the specified character string contains / or $, OpenTP1 performs internally a specific character string conversion processing on the character string. If you want to ignore OpenTP1's character string conversion processing and execute the command exactly as specified, specify the following environment variable in the user service definition or user service default definition:
    putenv DCADMCONVSEP 1
  • OpenTP1 does not support asynchronous execution of a command when & is specified at the end of the character string.
Reporting completion of user server start processing dc_adm_complete
CBLDCADM('COMPLETE')
S --
Reporting user server status dc_adm_status
CBLDCADM('STATUS ')
S --
Output of audit log Outputting an audit log dc_log_audit_print
CBLDCADT('PRINT ')
S --
Output of message log Outputting a message log dc_logprint
CBLDCLOG('PRINT ')
D color settings are not supported.
Acquisition of a user journal Acquiring a user journal dc_jnl_ujput
CBLDCJNL('UJPUT ')
S --
Editing journal data Closing a jnlrput output file --
CBLDCJUP('CLOSERPT')
S --
Opening a jnlrput output file --
CBLDCJUP('OPENRPT ')
S --
Importing journal data from a jnlrput output file --
CBLDCJUP('RDGETRPT')
S --
Message exchange Opening an MCF environment dc_mcf_open
CBLDCMCF('OPEN ')
S --
Starting an MHP service dc_mcf_mainloop
CBLDCMCF('MAINLOOP')
S --
Receiving messages dc_mcf_receive
CBLDCMCF('RECEIVE ')
S --
Sending response messages dc_mcf_reply
CBLDCMCF('REPLY ')
S --
Sending messages dc_mcf_send
CBLDCMCF('SEND ')
S --
Resending messages dc_mcf_resend
CBLDCMCF('RESEND ')
S --
Receiving synchronous messages dc_mcf_recvsync
CBLDCMCF('RECVSYNC')
S --
Sending synchronous messages dc_mcf_sendsync
CBLDCMCF('SENDSYNC')
S --
Exchanging synchronous messages dc_mcf_sendrecv
CBLDCMCF('SENDRECV')
S --
Accepting temporarily-stored data dc_mcf_tempget
CBLDCMCF('TEMPGET ')
S --
Updating temporarily-stored data dc_mcf_tempput
CBLDCMCF('TEMPPUT ')
S --
Ending continuous inquiry responses dc_mcf_contend
CBLDCMCF('CONTEND ')
S --
Activating an application program dc_mcf_execap
CBLDCMCF('EXECAP ')
S --
Reporting application information dc_mcf_ap_info
CBLDCMCF('APINFO ')
S --
Reporting application information to a user exit routine dc_mcf_ap_info_uoc
--
S --
Setting user timer monitoring dc_mcf_timer_set
CBLDCMCF('TIMERSET')
S --
Canceling user timer monitoring dc_mcf_timer_cancel
CBLDCMCF('TIMERCAN')
S --
Committing MHP dc_mcf_commit
CBLDCMCF('COMMIT ')
S --
Rolling back MHP dc_mcf_rollback
CBLDCMCF('ROLLBACK')
S --
Closing MCF environment dc_mcf_close
CBLDCMCF('CLOSE ')
S --
Acquiring MCF communication service statuses dc_mcf_tlscom
CBLDCMCF('TLSCOM ')
S --
Acquiring the connection status dc_mcf_tlscn
CBLDCMCF('TLSCN ')
S --
Establishing a connection dc_mcf_tactcn
CBLDCMCF('TACTCN ')
S --
Releasing a connection dc_mcf_tdctcn
CBLDCMCF('TDCTCN ')
S --
Acquiring the acceptance status of a server-type connection establishment request dc_mcf_tlsln
CBLDCMCF('TLSLN ')
S --
Starting acceptance of a server-type connection establishment request dc_mcf_tonln
CBLDCMCF('TONLN ')
S --
Ending acceptance of a server-type connection establishment request dc_mcf_tofln
CBLDCMCF('TOFLN ')
S --
Deleting an application timer start requests dc_mcf_adltap
CBLDCMCF('ADLTAP ')
S --
Acquiring a logical terminal status dc_mcf_tlsle
CBLDCMCF('TLSLE ')
S --
Shutting down a logical terminal dc_mcf_tdctle
CBLDCMCF('TDCTLE ')
S --
Releasing a logical terminal from shutdown status dc_mcf_tactle
CBLDCMCF('TACTLE ')
S --
Deleting a logical terminal output queue dc_mcf_tdlqle
CBLDCMCF('TDLQLE ')
S --
DAM file service Opening a logical file dc_dam_open
CBLDCDAM('DCDAMSVC','OPEN')
S --
Inputting logical file blocks dc_dam_read
CBLDCDAM('DCDAMSVC','READ')
S --
Updating logical file blocks dc_dam_rewrite
CBLDCDAM('DCDAMSVC','REWT')
S --
Outputting logical file blocks dc_dam_write
CBLDCDAM('DCDAMSVC','WRIT')
S --
Closing a logical file dc_dam_close
CBLDCDAM('DCDAMSVC','CLOS')
S --
Shutting down a logical file dc_dam_hold
CBLDCDAM('DCDAMSVC','HOLD')
S --
Releasing a logical file from shutdown status dc_dam_release
CBLDCDAM('DCDAMSVC','RLES')
S --
Referencing the status of a logical file dc_dam_status
CBLDCDAM('DCDAMSVC','STAT')
S --
Starting an unrecoverable DAM file dc_dam_start
CBLDCDAM('DCDAMSVC','STRT')
S --
Ending an unrecoverable DAM file dc_dam_end
CBLDCDAM('DCDAMSVC','END ')
S --
Allocating a physical file dc_dam_create
CBLDCDMB('DCDAMINT','CRAT')
S --
Opening a physical file dc_dam_iopen
CBLDCDMB('DCDAMINT','OPEN')
S --
Inputting physical file blocks dc_dam_get
CBLDCDMB('DCDAMINT','GET ')
S --
Outputting physical file blocks dc_dam_put
CBLDCDMB('DCDAMINT','PUT ')
S --
Searching physical file blocks dc_dam_bseek
CBLDCDMB('DCDAMINT','BSEK')
S --
Directly inputting physical file blocks dc_dam_dget
CBLDCDMB('DCDAMINT','DGET')
S --
Directly outputting physical file blocks dc_dam_dput
CBLDCDMB('DCDAMINT','DPUT')
S --
Closing a physical file dc_dam_iclose
CBLDCDMB('DCDAMINT','CLOS')
S --
TAM file service Opening a TAM table dc_tam_open
--
S --
Inputting TAM table records dc_tam_read
CBLDCTAM('FxxR')('FxxU')
S --
Updating on the assumption that TAM table records have been input dc_tam_rewrite
CBLDCTAM('MFY ')('MFYS')('STR ')
S --
Updating/adding TAM table records dc_tam_write
CBLDCTAM('MFY ')('MFYS')('STR ')
S --
Deleting TAM table records dc_tam_delete
CBLDCTAM('ERS ')('ERSR')
S --
Canceling input of TAM table records dc_tam_read_cancel
--
S --
Acquiring TAM table status dc_tam_get_inf
CBLDCTAM('GST ')
S --
Acquiring information about a TAM table dc_tam_status
CBLDCTAM('INFO')
S --
Closing a TAM table dc_tam_close
--
S --
IST service Opening an IST dc_ist_open
CBLDCIST('DCISTSVC','OPEN')
N The IST service is not supported.
Inputting IST records dc_ist_read
CBLDCIST('DCISTSVC','READ')
N
Outputting IST records dc_ist_write
CBLDCIST('DCISTSVC','WRIT')
N
Closing an IST dc_ist_close
CBLDCIST('DCISTSVC','CLOS')
N
Locking a resource Locking resources dc_lck_get
CBLDCLCK('GET ')
S --
Releasing all resources from a lock dc_lck_release_all
CBLDCLCK('RELALL ')
S --
Releasing a lock with a resource name specified dc_lck_release_byname
CBLDCLCK('RELNAME ')
S --
XATMI interface Calling a request/response service and receiving a response tpcall()
TPCALL
N The XATMI interface is not supported.
Calling a request/response service tpacall()
TPACALL
N
Receiving an asynchronous response from a request/response service tpgetrply()
TPGETRPLY
N
Canceling a request/response service tpcancel()
TPCANCEL
N
Connecting to an interactive service tpconnect()
TPCONNECT
N
Disconnecting from an interactive service tpdiscon()
TPDISCON
N
Receiving messages from an interactive service tprecv()
TPRECV
N
Sending messages to an interactive service tpsend()
TPSEND
N
Allocating a typed buffer tpalloc()
--
N
Releasing a typed buffer tpfree()
--
N
Changing a typed buffer's size tprealloc()
--
N
Acquiring information about a typed buffer tptypes()
--
N
Advertising a service name tpadvertise()
TPADVERTISE
N
Canceling advertisement of a service name tpunadvertise()
TPUNADVERTISE
N
Template for service functions tpservice()
TPSVCSTART
N
Returning from a service function tpreturn()
TPRETURN
N
TX interface Starting a transaction tx_begin()
TXBEGIN
S --
Committing a transaction tx_commit()
TXCOMMIT
S --
Returning information about the current transaction tx_info()
TXINFORM
S --
Opening a set of resource managers tx_open()
TXOPEN
S --
Rolling back a transaction tx_rollback()
TXROLLBACK
S --
Closing a set of resource managers tx_close()
TXCLOSE
S --
Setting the commit_return characteristic tx_set_commit_return()
TXSETCOMMITRET
S --
Setting the transaction_control characteristic tx_set_transaction_control()
TXSETTRANCTL
S --
Setting the transaction_timeout characteristic tx_set_transaction_timeout()
TXSETTIMEOUT
S --
Multi-node Starting acquisition of OpenTP1 node status dc_adm_get_nd_status_begin
--
N The multi-node (TP1/Multi) is not supported.
Acquiring the status of OpenTP1 nodes dc_adm_get_nd_status_next
--
N
Acquiring the status of a specified OpenTP1 node dc_adm_get_nd_status
--
N
Terminating the acquisition of OpenTP1 node status dc_adm_get_nd_status_done
--
N
Starting the acquisition of node identifiers dc_adm_get_nodeconf_begin
--
N
Acquiring node identifiers dc_adm_get_nodeconf_next
--
N
Terminating acquisition of node identifiers dc_adm_get_nodeconf_done
--
N
Acquiring a specified node identifier dc_adm_get_node_id
--
N
Starting acquisition of user server statuses dc_adm_get_sv_status_begin
--
N
Acquiring the status of user servers dc_adm_get_sv_status_next
--
N
Acquiring the status of a specified user server dc_adm_get_sv_status
--
N
Terminating acquisition of user server statuses dc_adm_get_sv_status_done
--
N
Management of online testers Reporting the test status of a user server dc_uto_test_status
CBLDCUTO('T-STATUS')
N The online tester facility (TP1/Online Tester) is not supported.
Performance verification trace Acquiring user-specific performance verification traces dc_prf_utrace_put
CBLDCPRF('PRFPUT ')
S --
Reporting the sequential number for an acquired performance verification trace dc_prf_get_trace_num
CBLDCPRF('PRFGETN ')
S --
Real-time statistics service Acquiring real-time statistics at any interval dc_rts_utrace_put
CBLDCRTS('RTSPUT ')
S --

#
The upper row shows the C language function name, and the lower row shows the COBOL UAP creation program.