OpenTP1 Version 7 Programming Guide
To support OpenTP1 system operation, you can execute commands, which can be entered in online mode, from a UAP by using the function dc_adm_call_command() [CBLDCADM('COMMAND ')]. The execution results of commands are returned to the UAP. The results comprise values which are output to the standard output or standard error output.
Give the following specification to the UAP which is to execute commands, in order to define the directory containing the command as the command search path:
The figure below outlines OpenTP1 command execution using the function dc_adm_call_command().
Figure 2-46 Outline of OpenTP1 command execution using function dc_adm_call_command()
Table 2-1 lists the OpenTP1 commands and indicates which commands can be executed from UAPs. For details of results of command input which come from OpenTP1, see the manual OpenTP1 Operation.
Table 2-1 OpenTP1 commands which can be executed from UAPs
Facility | Command name | Can/cannot be executed from UAPs | |
---|---|---|---|
System management | Catalog OpenTP1 into OS, delete OpenTP1 from OS | dcsetup | N |
Restart process service and reflect definitions | dcreset | N | |
Reserve or release resources for OpenTP1 internal control | dcmakeup | N | |
Start OpenTP1 | dcstart | N | |
Terminate OpenTP1 | dcstop | Y# | |
Output system statistical information | dcstats | Y | |
Start multinode area/subarea | dcmstart | Y | |
Terminate multinode area/subarea | dcmstop | Y | |
Execute OpenTP1 commands from the scenario template | dcjcmdex | N | |
Specify an operand of the system definition | dcjchconf | N | |
Update the domain definition file | dcjnamch | Y | |
Display the status of OpenTP1 node | dcndls | Y | |
Display shared memory utilization status | dcshmls | Y | |
Display execution status of temporary close processing | rpcstat | Y | |
Redirect standard output and standard error output | prctee | N | |
Stop and restart the prctee process | prctctrl | N | |
Acquire maintenance documents | dcrasget | Y | |
Edit and output system statistical information to the standard output in real time | dcreport | Y | |
Delete troubleshooting information | dccspool | Y | |
Check the system definition | dcdefchk | N | |
Display product information | dcpplist | Y | |
Remote API management | Display the RAP-processing listener or RAP-processing server status. | rapls | N |
Set up the execution environment of a remote API facility | rapsetup | N | |
Generate automatically definitions used for a remote API facility | rapdfgen | N | |
Server management | Start server | dcsvstart | Y |
Terminate server | dcsvstop | Y | |
Display status of server | prcls | Y | |
Display search path names for user server and for command activated from user server | prcpathls | Y | |
Change search path names for user server and for command activated from user server | prcpath | Y | |
Abort OpenTP1 process | prckill | Y | |
Schedule management | Display scheduling status | scdls | Y |
Shut down the scheduling | scdhold | Y | |
Restart scheduling | scdrles | Y | |
Change the number of processes | scdchprc | Y | |
Stop and restart a process | scdrsprc | Y | |
Transaction management | Display status of transactions | trnls | Y |
Commit transactions | trncmt | Y | |
Roll back transactions | trnrbk | Y | |
Terminate transactions forcibly | trnfgt | Y | |
Start and terminate collecting of transaction statistical information | trnstics | Y | |
Delete undecided transaction information file | trndlinf | Y | |
Display undecided transaction information for OSI TP communication | tptrnls | Y | |
XA resource management | Display an XAR event trace information | xarevtr | N |
Display status of an XAR file | xarfills | Y | |
Change status of an XAR transaction | xarforce | Y | |
Shut down an XA resource service | xarhold | Y | |
Create an XAR file | xarinit | N | |
Display an XAR transaction information | xarls | Y | |
Release an XA resource service from shutdown | xarrles | Y | |
Delete an XAR file | xarrm | N | |
Exclusion management | Display lock information | lckls | Y |
Display lock table pool information | lckpool | Y | |
Delete deadlock information file or timeout information file | lckrminf | Y | |
Name management | Check OpenTP1 startup and delete a cache | namalivechk | Y |
Catalog and delete domain alternate schedule service | namdomainsetup | Y | |
Change domain configuration (using the system common definition) | namndchg | Y | |
Change domain configuration (using the domain definition file) | namchgfl | Y | |
Perform a forced invalidation of the startup notice information | namunavl | N | |
Display server information about OpenTP1 | namsvinf | Y | |
Manipulate the RPC suppression list | namblad | Y | |
Message log management | Display message log file | logcat | Y |
Switch message log realtime output function | logcon | Y | |
Audit logs | Set up the environment for audit logging | dcauditsetup | N |
OpenTP1 file management | Initialize a OpenTP1 file system | filmkfs | N |
Display status of an OpenTP1 file system | filstatfs | Y | |
Display contents of an OpenTP1 file system | fills | Y | |
Back up an OpenTP1 file system | filbkup | N | |
Restore an OpenTP1 file system | filrstr | N | |
Change an OpenTP1 file group | filchgrp | Y | |
Change an OpenTP1 file access authorization mode | filchmod | Y | |
Change an OpenTP1 file owner | filchown | Y | |
Status file management | Create and initialize a status file | stsinit | N |
Display status of status files | stsls | Y | |
Display contents of a status file | stsfills | Y | |
Open a status file | stsopen | Y | |
Close a status file | stsclose | Y | |
Delete a status file | stsrm | Y | |
Swap status files | stsswap | Y | |
Journal file management | Initialize a journal file | jnlinit | N |
Display journal file information | jnlls | Y | |
Display information about previously read journal files during a rerun | jnlrinf | N | |
Open a journal file | jnlopnfg | Y | |
Close a journal file | jnlclsfg | Y | |
Allocate journal physical file | jnladdpf | Y | |
Delete journal physical file | jnldelpf | Y | |
Allocate a journal file dynamically | jnladdpf | Y | |
Swap journal files | jnlswpfg | Y | |
Delete journal files | jnlrm | N | |
Change status of journal files | jnlchgfg | N | |
Unload journal files | jnlunlfg | N | |
Control the automatic unload facility | jnlatunl | N | |
Recover journal files | jnlmkrf | N | |
Integrate file recovery journals | jnlcolc | N | |
Copy unload journal files | jnlcopy | N | |
Display archive status | jnlarls | Y | |
Edit and output unload journal files or global archive unload journal files | jnledit | N | |
Output records from unload journal files or global archive unload journal files | jnlrput | N | |
Sort and merge unload journal files or global archive unload journal files chronologically | jnlsort | N | |
Output uptime statistical information | jnlstts | N | |
Output MCF uptime statistical information | jnlmcst | N | |
Forcibly release connection to resource group | jnlardis | N | |
DAM file management | Initialize a physical file | damload | N |
Display status of logical files | damls | Y | |
Add a logical file | damadd | Y | |
Remove a logical file | damrm | Y | |
Shut down a logical file logically | damhold | Y | |
Release logical file from the shutdown | damrles | Y | |
Delete a physical file | damdel | N | |
Back up a physical file | dambkup | N | |
Restore a physical file | damrstr | N | |
Recover a logical file | damfrc | N | |
Set a threshold for the number of cache blocks | damchdef | Y | |
Obtain the number of cache blocks | damchinf | Y | |
TAM file management | Initialize a TAM file | tamcre | N |
Display status of TAM tables | tamls | Y | |
Add a TAM table | tamadd | Y | |
Remove a TAM table | tamrm | Y | |
Shut down a TAM table logically | tamhold | Y | |
Release a TAM table from shutdown | tamrles | Y | |
Load a TAM table | tamload | Y | |
Unload a TAM table | tamunload | Y | |
Delete a TAM file | tamdel | N | |
Back up a TAM file | tambkup | N | |
Restore a TAM file | tamrstr | N | |
Recover a TAM file | tamfrc | N | |
Convert a TAM locked resource name | tamlckls | Y | |
Display synonym information about hash type TAM files and TAM tables | tamhsls | N | |
Message queue file management | Display status of queue groups | quels | Y |
Allocate physical file for message queue | queinit | N | |
Delete physical file for message queue | querm | N | |
Resource manager control | Display resource manager information | trnlsrm | N |
Catalog and delete the resource manager | trnlnkrm | N | |
Create a transaction control object file | trnmkobj | N | |
Trace management | Output UAP trace information | uatdump | N |
Merge RPC traces | rpcmrg | N | |
Output RPC trace information | rpcdump | N | |
Output shared memory dump | usmdump | Y | |
Management of performance verification traces | Edit and output trace information file | prfed | N |
Get trace information file | prfget | N | |
Real-time statistical information service management | Edit and output RTS log files | rtsedit | N |
Output real-time statistical information to the standard output | rtsls | N | |
Set up an execution environment for the real-time statistical information service | rtssetup | N | |
Change the settings for real-time statistical information | rtsstats | N | |
Connection management | Display status of connection | mcftlscn | Y |
Establish connections | mcftactcn | Y | |
Release connections | mcftdctcn | Y | |
Switch connections | mcftchcn | Y | |
Display network status | mcftlsln | Y | |
Start acceptance of server-type connection establishment requests | mcftonln | Y | |
Terminate acceptance of server-type connection establishment requests | mcftofln | Y | |
Display status of multiplex message processing | mcftlstrd | Y | |
Application management | Display status of applications | mcfalsap | Y |
Shut down applications | mcfadctap | Y | |
Release shutdown of applications | mcfaactap | Y | |
Initialize abnormal terminations counts applications | mcfaclcap | Y | |
Display status of application start request | mcfalstap | Y | |
Delete timer activation requests for applications | mcfadltap | Y | |
Application operation support | Start application programs | mcfuevt | Y |
Logical terminal management | Display status of logical terminals | mcftlsle | Y |
Shut down logical terminals | mcftdctle | Y | |
Release shutdown of logical terminals | mcftactle | Y | |
Skip first message in a logical terminal message queue | mcftspqle | Y | |
Hold process of a logical terminal output queue | mcfthldoq | Y | |
Release held process of a logical terminal output queue | mcftrlsoq | Y | |
Delete output queues for logical terminals | mcftdlqle | Y | |
Start message journal collection for logical terminals | mcftactmj | Y | |
Terminate message journal collection for logical terminals | mcftdctmj | Y | |
Terminate forcibly continuous-inquiry-response processing for logical terminals | mcftendct | Y | |
Start the alternate terminal | mcftstalt | Y | |
Terminate the alternate terminal | mcftedalt | Y | |
Service group management | Display status of service groups | mcftlssg | Y |
Shut down service groups | mcftdctsg | Y | |
Release service groups from shutdown | mcftactsg | Y | |
Hold process of input queue for service group | mcfthldiq | Y | |
Release held process of input queues for service group | mcftrlsiq | Y | |
Delete the input queue for a service group | mcftdlqsg | Y | |
Service management | Display status of services | mcftlssv | Y |
Shut down services | mcftdctsv | Y | |
Release services from shutdown | mcftactsv | Y | |
Session management | Start a session | mcftactss | Y |
Terminate a session | mcftdctss | Y | |
Buffer management | Display utilization status of buffer groups | mcftlsbuf | Y |
Map management | Change path name of a map file | dcmapchg | N |
Display the loaded resources in the map file | dcmapls | N | |
Queue management | Output contents of input/output queues | mcftdmpqu | Y |
MCF trace acquisition management | Swap MCF trace files forcibly | mcftswptr | Y |
Start MCF trace acquisition | mcftstrtr | Y | |
Terminate MCF trace acquisition | mcftstptr | Y | |
Management of MCF statistics | Edit MCF statistics | mcfreport | N |
Output MCF statistics | mcfstats | Y | |
MCF communication service management | Partially stop the MCF communication service | mcftstop | N |
Partially start the MCF communication service | mcftstart | N | |
Reference the status of the MCF communication service | mcftlscom | N | |
User timer monitoring | Display status of user timer monitoring | mcftlsutm | Y |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.