1.2 List of operation commands

Table 1-1 lists the operation commands used with HiRDB.

Table 1-1 List of operation commands

Operation commandDescriptionExecutorHiRDB statusExecuting server machine
pdacunlckReleases the consecutive certification failure account lock state.HiRDB administratorACTSDS or MGR
pdadmvrDisplays the HiRDB version information.HiRDB administratorANYEach server machine
pdaudbeginStarts acquisition of audit trails.HiRDB administratorACTSDS or MGR
pdaudendStops acquisition of audit trails.HiRDB administratorACT12SDS or MGR
pdaudrmDeletes audit trail files.HiRDB administratorACTSDS or MGR
pdaudswapSwaps audit trail files.AuditorACTSDS or MGR
pdbkuplsDisplays information about backup files acquired by pdcopy.HiRDB administratorANYServer machine where backup files are located
pdbuflsDisplays the status of global buffers.HiRDB administratorACTSDS or MGR
pdbufmodAdds, deletes, or changes a global buffer during HiRDB operation.HiRDB administratorACTSDS or MGR
pdcancelForcibly disconnects and terminates the process on HiRDB for processing a specified UAP or utility.HiRDB administratorACTAny server machine5
pdcatDisplays status file status.USRANY2Any server machine5
Displays messages in a message log file.USRACTAny server machine5
pdcbl1Preprocesses a UAP written in COBOL.USRANYAny server machine
pdchgconfChanges system definitions during HiRDB operation.HiRDB administratorACTSDS or MGR
pdchprcChanges the number of resident server processes and maximum number of startup server processes, or displays the current number of resident server processes and current maximum number of startup server processes at the time the pdchprc command is executed.HiRDB administratorACTSDS or MGR
pdcloseCloses RDAREAs.HiRDB administratorACTSDS or MGR
pdclttrcAcquires an SQL trace for a client executing SQL statements.HiRDB administratorACTSDS or MGR
pdcmtCommits transactions when transactions that are part of a global transaction cannot be concluded.HiRDB administratorACTEach server machine5
pdconfchkChecks HiRDB system definitions for inconsistencies.HiRDB administratorANYSDS or MGR
pdcpp1Preprocesses a UAP written in C language.USRANYAny server machine
pdcspoolDeletes troubleshooting information.HiRDB administratorANYEach server machine
pddbadsetSets up HiRDB External Data Access Adapter in the HiRDB environment in order to use the HiRDB External Data Access facility.HiRDB administratorINAEach server machine
pddbchgChanges the replica status of replica RDAREAs.HiRDB administratorACTSDS or MGR
pddbfrzPlaces a full HiRDB file (used through the last page of the file) that constitutes a user LOB RDAREA in frozen update status.HiRDB administratorACTSDS or MGR
pddblsDisplays the status of RDAREAs.HiRDB administratorACTSDS or MGR
pddefrevGenerates a definition SQL statement.User with DBA privilegeACTSDS or MGR
pdfbkupMakes a backup of a HiRDB file system.HiRDB administratorANY14Server machine where the HiRDB file system is located
pdffsckChecks a HiRDB file system area for integrity errors and corrects any errors that are detected.Superuser and HiRDB administratorANY16Server machine where the HiRDB file system is located
pdfgtTerminates a transaction forcibly when a transaction branch that is part of a global transaction cannot be terminated for some reason.HiRDB administratorACTEach server machine5
pdflsDisplays information about HiRDB files in a HiRDB file system area.USRANYServer machine where the HiRDB file system is located
pdfmkfsInitializes files for a HiRDB file system area.HiRDB administratorANYServer machine where the HiRDB file system is located
pdfrmDeletes a HiRDB file from a HiRDB file system area.HiRDB administratorANY9Server machine where the HiRDB file system is located
pdfrstrRestores a HiRDB file system from a backup.HiRDB administratorINAServer machine where the HiRDB file system is located
pdfstatfsDisplays the status of a HiRDB file system area.USRANYServer machine where the HiRDB file system is located
pdgenGenerates the HiRDB environment interactively.HiRDB administratorANY10SDS or MGR
pdgeterOutputs error information to a specified directory or DAT drive when an error occurs in the HiRDB system.HiRDB administratorANYAny server machine6
pdgrprflWhen the Hitachi Directory Server linkage facility is used, updates the user information maintained by HiRDB to the most recent status.HiRDB administratorACTSDS or MGR
pdholdShuts down RDAREAs.HiRDB administratorACTSDS or MGR
pditvstop11Stops the command that was started by the pditvtrc command.USRANYAny server machine
pditvtrc11Executes a specified command at a specified interval (in seconds) and then outputs the result to a file.USRANYAny server machine
pdjarsyncRegisters, re-registers, or deletes a JAR file or displays a list of JAR files.HiRDB administratorANYSDS or MGR
pdlistlsDisplays list definition information.HiRDB administratorACTSDS or MGR
pdlodsvWhen JavaTM stored procedures, Java stored functions, and the Hitachi Directory Server linkage facility are no longer used, enables you to delete unneeded load modules from the HiRDB installation directory.Super userANYEach server machine
pdlogadpfDuring HiRDB operation, assigns a physical file to a file group specified in the HiRDB system definition.HiRDB administratorACTSDS or MGR
pdlogatulRestarts, cancels, or displays the status of the automatic log unloading facility.HiRDB administratorANYSDS or MGR
pdlogchgForcibly places a specified file group in unload completed status or HiRDB Datareplicator extraction completed status.HiRDB administratorANY2SDS or MGR
pdlogclsCloses an open physical file that comprises a file group so that it cannot be used by the active HiRDB.HiRDB administratorACTSDS or MGR
pdloginitCreates a log file in the HiRDB file system and initializes it so that it can be used by HiRDB.HiRDB administratorANY2SDS or MGR
pdloglsDisplays information about log files.USRANY2, 3SDS or MGR
pdlogopenOpens a closed physical file that comprises a file group so that it can be used by the active HiRDB.HiRDB administratorACTSDS or MGR
pdlogrmDeletes a log file from the HiRDB file system.HiRDB administratorANY2SDS or MGR
pdlogswapSwaps log files.HiRDB administratorACTSDS or MGR
pdlogsyncCollects a synchronization point dump.HiRDB administratorACTSDS or MGR
pdlogucatDisplays information about an unload log file.HiRDB administratorANYServer machine where the unload log file is located
pdlogunldUnloads a file group into a destination file and places it in unload completed status.HiRDB administratorANY2SDS or MGR
pdlsDisplays the following types of status:
  • User status
  • Status of audit trail files
  • System status when system switchover facility is used
  • Server lock status
  • Information about server's shared memory
  • Progress of reflection processing for online reorganization
  • Server processing status
  • Execution status of log application processing
  • Communication control information on connected servers
  • HiRDB Datareplicator linkage status
  • Server scheduling status
  • Whether or not an output type for statistical information by unit and server is specified
  • Unit or server status file status
  • Unit and server status
  • Server transaction status
  • Unit activity status
USR13ANY when -d aud, ha, or rpl is specified; otherwise, ACTAny server machine5 when -d ha, lck, svr, trn, or ust is specified; otherwise, SDS or MGR
pdmemsvSaves memory space during multi-HiRDB operation.Super userINASDS or MGR
pdobilsDisplays the utilization status of SQL objects stored in the SQL object buffer.HiRDB administratorACTAny server machine
pdobjconvMigrates SQL objects to a 64-bit-mode HiRDB.User with DBA privilegeACTSDS or MGR
pdocb1Preprocesses a UAP coded in OOCOBOL.USRANYAny server machine
pdocc1Preprocesses a UAP coded in C++.USRANYAny server machine
pdopenOpens RDAREAs.HiRDB administratorACTSDS or MGR
pdopsetupInstalls and uninstalls optional program products.Super userINAEach server machine
pdorbeginPlaces original and replica RDAREAs in online reorganization hold status.HiRDB administratorACTSDS or MGR
pdorcheckChecks application conditions for updatable online reorganization.HiRDB administratorACTSDS or MGR
pdorchgChanges current RDAREAs from original RDAREAs in online reorganization hold status to replica RDAREAs in online reorganization hold status.HiRDB administratorACTSDS or MGR
pdorcreateCreates an environment for reflection processing for online reorganization.HiRDB administratorACTSDS or MGR
pdorendExecutes reflection processing for online reorganization.HiRDB administratorACTSDS or MGR
pdpfreshTerminates the current server process and starts a new process.HiRDB administratorACTSDS or MGR
pdplgrgstRegisters plug-ins and deletes them from a HiRDB.User with DBA privilegeACTAny server machine
pdplgsetSets up a plug-in in the HiRDB environment.HiRDB administratorINAEach server machine
pdprgcopyCopies a HiRDB update version into the HiRDB directory.HiRDB administratorANYSDS or MGR
pdprgrenewUpdates the current HiRDB to the HiRDB update version.HiRDB administratorACTSDS or MGR
pdrbkRolls back transactions when a transaction branch that is part of a global transaction could not be concluded.HiRDB administratorACTEach server machine5
pdrdreflsDisplays information about related RDAREAs.HiRDB administratorACTSDS or MGR
pdrelsReleases RDAREAs from shutdown status.HiRDB administratorACTSDS or MGR
pdrisechkChecks the configuration of Real Time SAN Replication.HiRDB administratorANYSDS or MGR
pdrisedbtoIn the case of Real Time SAN Replication based on the log-only synchronous method, terminates the log application site and inherits the database from the transaction execution site.HiRDB administratorACTSDS or MGR (log application site)
pdrisesetIn the case of Real Time SAN Replication based on the log-only synchronous method, sets, releases, or displays the system status at the site where the command is executed.HiRDB administratorANYSDS or MGR
pdrpauseStarts the system or restarts processing that has been suspended.HiRDB administratorINAEach server machine
pdrplstartStarts HiRDB Datareplicator linkage.HiRDB administratorACT7SDS or MGR
pdrplstopStops HiRDB Datareplicator linkage.HiRDB administratorACT8SDS or MGR
pdsetupRegisters a HiRDB system under the HiRDB directory into the OS or deletes it from the OS.Super userINAEach server machine
pdstartStarts a HiRDB system.HiRDB administratorINASDS4 or MGR
Starts a unit or server.HiRDB administratorACTSDS or MGR
pdstbeginStarts output of statistical information to the statistics log file.HiRDB administratorACTSDS or MGR
pdstendStops output of statistical information to the statistics log file.HiRDB administratorACTSDS or MGR
pdstjswapSwaps statistics log files.HiRDB administratorACTSDS or MGR
pdstjsyncOutputs information about the statistics log buffer to the statistics log file.HiRDB administratorACT15Any server machine
pdstopTerminates a HiRDB system, unit, or server.HiRDB administratorACTSDS4 or MGR
pdstsclsCloses an open status file.HiRDB administratorACTSDS or MGR
pdstsinitInitializes a physical file comprising a status file (logical file).HiRDB administratorANY2SDS or MGR
pdstsopenOpens an initialized or closed status file.HiRDB administratorACTSDS or MGR
pdstsrmDeletes a status file.HiRDB administratorANY2SDS or MGR
pdstsswapSwaps status files.HiRDB administratorACTSDS or MGR
pdsvhostnameDisplays a specified server's host name in DAT format.HiRDB administratorACTSDS or MGR
pdtrndecCompletes any uncompleted transactions.HiRDB administratorACTSDS or MGR
pdtrnqingStarts or releases transaction queuing for a back-end server.HiRDB administratorACT17Any server machine5
pdusrchkChecks whether or not users registered in HiRDB are registered in the Directory Server.HiRDB administratorACTSDS or MGR
pdvrupMaintains the master directory RDAREA and data dictionary RDAREAs when the HiRDB version has been upgraded.HiRDB administratorACTSDS or MGR
Legend:
ANY: Can be executed whether or not HiRDB is active.
ACT: Can be executed only while HiRDB is active.
INA: Can be executed only while HiRDB is inactive.
USR: Can be executed by a user without privileges.
SDS: For a HiRDB/Single Server, the command is executed on the server machine of the single server.
MGR: For a HiRDB/Parallel Server, the command is executed on the server machine where the system manager is located.
Note 1
Log files include system log files and synchronization point dump files.
Note 2
A file that is specified in an operation command or utility that is executing must not be in use at the same time by another operation command, utility, or UAP; doing so will result in an error and cause the processing results to be invalidated.
1
For details about pdcbl, pdcpp, pdocb, and pdocc, see the HiRDB Version 8 UAP Development Guide.
2
This command cannot be executed during the following periods:
  • During HiRDB startup processing (from output of KFPS01800-I message to output of KFPS05210-I message)
  • During HiRDB termination processing (from output of KFPS05220-I message to output of KFPS01850-I message)
3
When the -d spd option is specified, this command can be executed only while HiRDB is active.
4
Execute this command on the server machine of the single server or a utility special unit.
5
This command cannot be executed for a server machine that has a utility special unit.
6
Parameters must be set so that the remote shell can be executed between the hosts targeted for error information acquisition. This does not apply when error information is to be acquired for only the host executing the pdgeter command. Moreover, if the -a option is specified, this command must be executed at one of the hosts where the error information is to be acquired.
7
This command can be executed only when all units and servers in the HiRDB system are active.
8
For a HiRDB/Single Server, this command can be executed only while HiRDB is active. For a HiRDB/Parallel Server, this command can be executed if the unit where the system manager is located is active, even if other units are inactive.
9
If the usage purpose of the HiRDB file system area that contains the HiRDB file to be deleted is other than UTL, this command cannot be executed in the HiRDB file system area that contains that HiRDB file while the active HiRDB is in use (if the HiRDB file in the HiRDB file system area has been opened even once). If the usage purpose is UTL, the command can be executed regardless of whether or not the HiRDB file system area is in use. However, it cannot be executed if the specified HiRDB file is in use by the active HiRDB (opened by another process).
10
When a separate HiRDB environment is to be created, this command can be executed regardless of whether or not HiRDB is active. When an existing HiRDB environment is to be re-created or a new HiRDB environment is to be created, the command can be executed only while the HiRDB is inactive.
11
The pditvtrc and pditvstop commands take another command as their command argument. The execution conditions for the command that is specified as the command argument take effect. When specifying a HiRDB operation command, observe the Executor, HiRDB status, and Executing server machine conditions for that command.
12
This command can be executed after acquisition of an audit trail has started.
13
Only the auditor can execute -d aud during HiRDB operation. When HiRDB is not running, any HiRDB administrator (including superuser) other than the auditor can execute this command.
14
To execute this command during HiRDB operation, specify the -f option.
15
This command can be executed when HiRDB is running and statistical information is being acquired.
16
Depends on whether or not the -c option is specified and on the purpose of the HiRDB file system area. For details, see the rules in pdffsck.
17
Whether or not the command can be executed depends on the back-end server's operating status. For details, see the rules in pdtrnqing.