OpenTP1 Version 7 Programming Guide

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

2.4.1 Executing operation commands

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()

[Figure]

Organization of this subsection
(1) OpenTP1 commands which can be executed using the function dc_adm_call_command()

(1) OpenTP1 commands which can be executed using the 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

Legend:
Y: Can be executed from UAPs.
N: Cannot be executed from UAPs.

#
When the dcstop command is executed from UAPs, it should be in the background.