List of operation commands

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

Table 1-1 List of operation commands

Operation command	Description	Executor	HiRDB status	Executing server machine
pdacunlck	Releases the consecutive certification failure account lock state.	HiRDB administrator	ACT	SDS or MGR
pdadmvr	Displays the HiRDB version information.	HiRDB administrator	ANY	Each server machine
pdaudbegin	Starts acquisition of audit trails.	HiRDB administrator	ACT	SDS or MGR
pdaudend	Stops acquisition of audit trails.	HiRDB administrator	ACT¹²	SDS or MGR
pdaudrm	Deletes audit trail files.	HiRDB administrator	ACT	SDS or MGR
pdaudswap	Swaps audit trail files.	Auditor	ACT	SDS or MGR
pdbkupls	Displays information about backup files acquired by pdcopy.	HiRDB administrator	ANY	Server machine where backup files are located
pdbufls	Displays the status of global buffers.	HiRDB administrator	ACT	SDS or MGR
pdbufmod	Adds, deletes, or changes a global buffer during HiRDB operation.	HiRDB administrator	ACT	SDS or MGR
pdcancel	Forcibly disconnects and terminates the process on HiRDB for processing a specified UAP or utility.	HiRDB administrator	ACT	Any server machine⁵
pdcat	Displays status file status.	USR	ANY²	Any server machine⁵
pdcat	Displays messages in a message log file.	USR	ACT	Any server machine⁵
pdcbl¹	Preprocesses a UAP written in COBOL.	USR	ANY	Any server machine
pdchgconf	Changes system definitions during HiRDB operation.	HiRDB administrator	ACT	SDS or MGR
pdchprc	Changes 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 administrator	ACT	SDS or MGR
pdclose	Closes RDAREAs.	HiRDB administrator	ACT	SDS or MGR
pdclttrc	Acquires an SQL trace for a client executing SQL statements.	HiRDB administrator	ACT	SDS or MGR
pdcmt	Commits transactions when transactions that are part of a global transaction cannot be concluded.	HiRDB administrator	ACT	Each server machine⁵
pdconfchk	Checks HiRDB system definitions for inconsistencies.	HiRDB administrator	ANY	SDS or MGR
pdcpp¹	Preprocesses a UAP written in C language.	USR	ANY	Any server machine
pdcspool	Deletes troubleshooting information.	HiRDB administrator	ANY	Each server machine
pddbadset	Sets up HiRDB External Data Access Adapter in the HiRDB environment in order to use the HiRDB External Data Access facility.	HiRDB administrator	INA	Each server machine
pddbchg	Changes the replica status of replica RDAREAs.	HiRDB administrator	ACT	SDS or MGR
pddbfrz	Places a full HiRDB file (used through the last page of the file) that constitutes a user LOB RDAREA in frozen update status.	HiRDB administrator	ACT	SDS or MGR
pddbls	Displays the status of RDAREAs.	HiRDB administrator	ACT	SDS or MGR
pddefrev	Generates a definition SQL statement.	User with DBA privilege	ACT	SDS or MGR
pdfbkup	Makes a backup of a HiRDB file system.	HiRDB administrator	ANY¹⁴	Server machine where the HiRDB file system is located
pdffsck	Checks a HiRDB file system area for integrity errors and corrects any errors that are detected.	Superuser and HiRDB administrator	ANY¹⁶	Server machine where the HiRDB file system is located
pdfgt	Terminates a transaction forcibly when a transaction branch that is part of a global transaction cannot be terminated for some reason.	HiRDB administrator	ACT	Each server machine⁵
pdfls	Displays information about HiRDB files in a HiRDB file system area.	USR	ANY	Server machine where the HiRDB file system is located
pdfmkfs	Initializes files for a HiRDB file system area.	HiRDB administrator	ANY	Server machine where the HiRDB file system is located
pdfrm	Deletes a HiRDB file from a HiRDB file system area.	HiRDB administrator	ANY⁹	Server machine where the HiRDB file system is located
pdfrstr	Restores a HiRDB file system from a backup.	HiRDB administrator	INA	Server machine where the HiRDB file system is located
pdfstatfs	Displays the status of a HiRDB file system area.	USR	ANY	Server machine where the HiRDB file system is located
pdgen	Generates the HiRDB environment interactively.	HiRDB administrator	ANY¹⁰	SDS or MGR
pdgeter	Outputs error information to a specified directory or DAT drive when an error occurs in the HiRDB system.	HiRDB administrator	ANY	Any server machine⁶
pdgrprfl	When the Hitachi Directory Server linkage facility is used, updates the user information maintained by HiRDB to the most recent status.	HiRDB administrator	ACT	SDS or MGR
pdhold	Shuts down RDAREAs.	HiRDB administrator	ACT	SDS or MGR
pditvstop¹¹	Stops the command that was started by the pditvtrc command.	USR	ANY	Any server machine
pditvtrc¹¹	Executes a specified command at a specified interval (in seconds) and then outputs the result to a file.	USR	ANY	Any server machine
pdjarsync	Registers, re-registers, or deletes a JAR file or displays a list of JAR files.	HiRDB administrator	ANY	SDS or MGR
pdlistls	Displays list definition information.	HiRDB administrator	ACT	SDS or MGR
pdlodsv	When Java^TM 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 user	ANY	Each server machine
pdlogadpf	During HiRDB operation, assigns a physical file to a file group specified in the HiRDB system definition.	HiRDB administrator	ACT	SDS or MGR
pdlogatul	Restarts, cancels, or displays the status of the automatic log unloading facility.	HiRDB administrator	ANY	SDS or MGR
pdlogchg	Forcibly places a specified file group in unload completed status or HiRDB Datareplicator extraction completed status.	HiRDB administrator	ANY²	SDS or MGR
pdlogcls	Closes an open physical file that comprises a file group so that it cannot be used by the active HiRDB.	HiRDB administrator	ACT	SDS or MGR
pdloginit	Creates a log file in the HiRDB file system and initializes it so that it can be used by HiRDB.	HiRDB administrator	ANY²	SDS or MGR
pdlogls	Displays information about log files.	USR	ANY²^,³	SDS or MGR
pdlogopen	Opens a closed physical file that comprises a file group so that it can be used by the active HiRDB.	HiRDB administrator	ACT	SDS or MGR
pdlogrm	Deletes a log file from the HiRDB file system.	HiRDB administrator	ANY²	SDS or MGR
pdlogswap	Swaps log files.	HiRDB administrator	ACT	SDS or MGR
pdlogsync	Collects a synchronization point dump.	HiRDB administrator	ACT	SDS or MGR
pdlogucat	Displays information about an unload log file.	HiRDB administrator	ANY	Server machine where the unload log file is located
pdlogunld	Unloads a file group into a destination file and places it in unload completed status.	HiRDB administrator	ANY²	SDS or MGR
pdls	Displays 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	USR¹³	ANY when -d aud, ha, or rpl is specified; otherwise, ACT	Any server machine⁵ when -d ha, lck, svr, trn, or ust is specified; otherwise, SDS or MGR
pdmemsv	Saves memory space during multi-HiRDB operation.	Super user	INA	SDS or MGR
pdobils	Displays the utilization status of SQL objects stored in the SQL object buffer.	HiRDB administrator	ACT	Any server machine
pdobjconv	Migrates SQL objects to a 64-bit-mode HiRDB.	User with DBA privilege	ACT	SDS or MGR
pdocb¹	Preprocesses a UAP coded in OOCOBOL.	USR	ANY	Any server machine
pdocc¹	Preprocesses a UAP coded in C++.	USR	ANY	Any server machine
pdopen	Opens RDAREAs.	HiRDB administrator	ACT	SDS or MGR
pdopsetup	Installs and uninstalls optional program products.	Super user	INA	Each server machine
pdorbegin	Places original and replica RDAREAs in online reorganization hold status.	HiRDB administrator	ACT	SDS or MGR
pdorcheck	Checks application conditions for updatable online reorganization.	HiRDB administrator	ACT	SDS or MGR
pdorchg	Changes current RDAREAs from original RDAREAs in online reorganization hold status to replica RDAREAs in online reorganization hold status.	HiRDB administrator	ACT	SDS or MGR
pdorcreate	Creates an environment for reflection processing for online reorganization.	HiRDB administrator	ACT	SDS or MGR
pdorend	Executes reflection processing for online reorganization.	HiRDB administrator	ACT	SDS or MGR
pdpfresh	Terminates the current server process and starts a new process.	HiRDB administrator	ACT	SDS or MGR
pdplgrgst	Registers plug-ins and deletes them from a HiRDB.	User with DBA privilege	ACT	Any server machine
pdplgset	Sets up a plug-in in the HiRDB environment.	HiRDB administrator	INA	Each server machine
pdprgcopy	Copies a HiRDB update version into the HiRDB directory.	HiRDB administrator	ANY	SDS or MGR
pdprgrenew	Updates the current HiRDB to the HiRDB update version.	HiRDB administrator	ACT	SDS or MGR
pdrbk	Rolls back transactions when a transaction branch that is part of a global transaction could not be concluded.	HiRDB administrator	ACT	Each server machine⁵
pdrdrefls	Displays information about related RDAREAs.	HiRDB administrator	ACT	SDS or MGR
pdrels	Releases RDAREAs from shutdown status.	HiRDB administrator	ACT	SDS or MGR
pdrisechk	Checks the configuration of Real Time SAN Replication.	HiRDB administrator	ANY	SDS or MGR
pdrisedbto	In 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 administrator	ACT	SDS or MGR (log application site)
pdriseset	In 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 administrator	ANY	SDS or MGR
pdrpause	Starts the system or restarts processing that has been suspended.	HiRDB administrator	INA	Each server machine
pdrplstart	Starts HiRDB Datareplicator linkage.	HiRDB administrator	ACT⁷	SDS or MGR
pdrplstop	Stops HiRDB Datareplicator linkage.	HiRDB administrator	ACT⁸	SDS or MGR
pdsetup	Registers a HiRDB system under the HiRDB directory into the OS or deletes it from the OS.	Super user	INA	Each server machine
pdstart	Starts a HiRDB system.	HiRDB administrator	INA	SDS⁴ or MGR
pdstart	Starts a unit or server.	HiRDB administrator	ACT	SDS or MGR
pdstbegin	Starts output of statistical information to the statistics log file.	HiRDB administrator	ACT	SDS or MGR
pdstend	Stops output of statistical information to the statistics log file.	HiRDB administrator	ACT	SDS or MGR
pdstjswap	Swaps statistics log files.	HiRDB administrator	ACT	SDS or MGR
pdstjsync	Outputs information about the statistics log buffer to the statistics log file.	HiRDB administrator	ACT¹⁵	Any server machine
pdstop	Terminates a HiRDB system, unit, or server.	HiRDB administrator	ACT	SDS⁴ or MGR
pdstscls	Closes an open status file.	HiRDB administrator	ACT	SDS or MGR
pdstsinit	Initializes a physical file comprising a status file (logical file).	HiRDB administrator	ANY²	SDS or MGR
pdstsopen	Opens an initialized or closed status file.	HiRDB administrator	ACT	SDS or MGR
pdstsrm	Deletes a status file.	HiRDB administrator	ANY²	SDS or MGR
pdstsswap	Swaps status files.	HiRDB administrator	ACT	SDS or MGR
pdsvhostname	Displays a specified server's host name in DAT format.	HiRDB administrator	ACT	SDS or MGR
pdtrndec	Completes any uncompleted transactions.	HiRDB administrator	ACT	SDS or MGR
pdtrnqing	Starts or releases transaction queuing for a back-end server.	HiRDB administrator	ACT¹⁷	Any server machine⁵
pdusrchk	Checks whether or not users registered in HiRDB are registered in the Directory Server.	HiRDB administrator	ACT	SDS or MGR
pdvrup	Maintains the master directory RDAREA and data dictionary RDAREAs when the HiRDB version has been upgraded.	HiRDB administrator	ACT	SDS 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.

¹: For details about pdcbl, pdcpp, pdocb, and pdocc, see the HiRDB Version 8 UAP Development Guide.

²

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)

³: When the -d spd option is specified, this command can be executed only while HiRDB is active.

⁴: Execute this command on the server machine of the single server or a utility special unit.

⁵: This command cannot be executed for a server machine that has a utility special unit.

⁶: 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.

⁷: This command can be executed only when all units and servers in the HiRDB system are active.

⁸: 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.

⁹: 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).

¹⁰: 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.

¹¹: 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.

¹²: This command can be executed after acquisition of an audit trail has started.

¹³: 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.

¹⁴: To execute this command during HiRDB operation, specify the -f option.

¹⁵: This command can be executed when HiRDB is running and statistical information is being acquired.

¹⁶: 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.

¹⁷: Whether or not the command can be executed depends on the back-end server's operating status. For details, see the rules in pdtrnqing.

1.2 List of operation commands