The pdstsrm command deletes a physical file comprising a status file in the HiRDB file system. This command cannot delete the current or a spare physical file being used during HiRDB operation. This command is used to delete a physical file that has been placed in shutdown status due to an error.

HiRDB administrator

(a) HiRDB single server configuration

Unit status file

pdstsrm [{-x host-name|-u unit-identifier}] -f physical-file-name

Server status file

pdstsrm -s server-name -f physical-file-name

(b) HiRDB parallel server configuration

Unit status file

pdstsrm {-x host-name|-u unit-identifier} -f physical-file-name [-D]

Server status file

pdstsrm -s server-name [{-x host-name|-u unit-identifier}] -f physical-file-name [-D]

(a) {-x host-name|-u unit-identifier}

When a unit status file is to be deleted, specifies the identifier of the unit or the name of the host corresponding to the unit status file. For a HiRDB single server configuration, this option can be omitted because the host and unit are fixed.

-x host-name ~<identifier> ((1-32))

• For a unit status file
  Specifies the name of the host corresponding to the unit status file.
  
• For a server status file
  When the standby-less system switchover (effects distributed) facility is used, specifies the name of the host that contains the disk where the status file to be deleted was created. This host must contain a unit that belongs to the HA group to which the server specified in the -s option is to be moved.
  When the server specified in the -s option and the system manager are running, this option is ignored, if specified.
  When the standby-less system switchover (effects distributed) facility is not used and this option is specified together with the -s option, the command checks the host specified in this option and the primary system's host at the server specified in the -s option to determine if they match. If the host names do not match, an error results.
  

-u unit-identifier ~<identifier> ((4 characters))

• For a unit status file
  Specifies the identifier of the unit corresponding to the unit status file.
  
• For a server status file
  When the standby-less system switchover (effects distributed) facility is used, specifies the unit identifier of the host that contains the disk where the status file to be deleted was created. This unit must belong to the HA group to which the server specified in the -s option is to be moved.
  When the server specified in the -s option and the system manager are running, this option is ignored, if specified.
  When the standby-less system switchover (effects distributed) facility is not used and this option is specified together with the -s option, the command checks the primary system's host on the unit specified in this option and the primary system's host at the server specified in the -s option to determine if they match. If the host names do not match, an error results.
  

(b) -s server-name ~<identifier> ((1-8))

When a server status file is to be deleted, specifies the name of the server corresponding to the server status file.

(c) -f physical-filename ~<pathname> ((up to 167 characters))

Specifies the absolute pathname of the physical file to be deleted. A physical filename must be specified in the format HiRDB-file-system-area-name/HiRDB-file-name.

If you are using Real Time SAN Replication based on the log-only synchronous method, you can specify either of the status files (the status file for transaction processing or the status file for log application processing). The volume containing the status file must be write-enabled.

(d) -D

Specifies that a unit or server is to be deleted by the pdchgconf command.

To delete a unit or server, the command deletes the unit's or server's status files. When this option is specified, the command does not check the unit identifier or server name.

When you specify this option, make sure that the pdstsrm command is executed on the unit that contains the status files that are to be deleted.

1. The pdstsrm command can be executed at any time, whether or not HiRDB is active (except during HiRDB startup or termination processing).
2. The pdstsrm command must be executed at the server machine containing the single server or the server machine where the system manager is located.
3. The current status file being used during HiRDB operation must not be deleted.

1. The result of the pdstsrm command can be determined from the command's return code or the existence of an error message. Return code 0 for this command indicates normal termination, 8 indicates abnormal termination (such as invalid option or rsh error), and 12 indicates abnormal termination (when retry was executed from a standby system in a configuration in which IP addresses are not inherited).
2. The following table describes how to specify the -u and -s options when the standby-less system switchover (effects distributed) facility is used:
   

   Initialization target	Unit or server status	Host containing the file storage disk	Specification of -u and -s options
   Unit status file	Active	Host where the unit is located	Specify one of them
   	Inactive
   Server status file	Active	Host containing the running back-end server	Optional
   	Inactive	Host containing the primary back-end server
   		Other host	Specify one of them