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.	HiRDB administrator	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
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.	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
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
pdjarsync	Registers, re-registers, or deletes a JAR file or displays a list of JAR files.	HiRDB administrator	ANY	SDS or MGR
pdkill	Terminates a specified process forcibly.	HiRDB administrator	ACT	Each server machine
pdlistls	Displays list definition information.	HiRDB administrator	ACT	SDS or MGR
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.	HiRDB administrator	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 Server processing status 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	HiRDB administrator⁸	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
pdntenv	Displays or sets up an HiRDB operating environment.	HiRDB administrator	INA	Each server machine
pdobils	Displays the utilization status of SQL objects stored in the SQL object buffer.	HiRDB administrator	ACT	Any server machine
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
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
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
pdrplstart	Starts HiRDB Datareplicator linkage.	HiRDB administrator	ACT⁴	SDS or MGR
pdrplstop	Stops HiRDB Datareplicator linkage.	HiRDB administrator	ACT⁵	SDS or MGR
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.

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

⁷: 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 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