pdloginit (Initialize log file)
Function
The pdloginit command creates a log physical file in the HiRDB file system area and initializes it so that it can be used by the active HiRDB.
Executor
HiRDB administrator
Format
pdloginit {-d sys [-s server-name]
-f physical-filename -n HiRDB-records-count [-l record-length]
| -d spd [-s server-name]
-f physical-filename -n HiRDB-records-count}
pdloginit {-d sys -s server-name[-u unit-identifier]
-f physical-filename -n HiRDB-records-count
[-l record-length] [-D]
| -d spd -s server-name[-u unit-identifier]
-f physical-filename -n HiRDB-records-count [-D]}
Options
Specifies the type of log file to be initialized:
Specifies the name of the server corresponding to the file group.
Specifies the absolute pathname of the physical file to be initialized. The physical file name must be specified in the format HiRDB-file-system-area-name/HiRDB-filename. A HiRDB file name cannot be duplicated in the HiRDB file system area. If the specified HiRDB file has already been initialized, the command results in an error. A name beginning with pl cannot be specified as a HiRDB file name.
Specifies the number of records in the HiRDB file to be initialized.
For the purposes of this section, a record is an area with the following size in the HiRDB file system:
For the number of HiRDB records, specify a value in the following range:
For details about how to estimate the number of HiRDB records, see the HiRDB Version 8 Installation and Design Guide.
Specify the record length for the HiRDB file to be initialized as a system log file. This option should be specified when it is necessary to create a system log file before modifying the system definition, or when it is desirable to explicitly specify a record length.
When the standby-less system switchover (effects distributed) facility is used, specifies the unit identifier of the host that contains the disk on which the file is to be created.
When the applicable server is running, the -u option is ignored, if specified.
Specifying the -u option results in an error if any of the following is true:
The following table describes whether or not the -u option is required:
Server status | Host containing the disk where file is created | Specification of -u option |
---|---|---|
Active | Host containing the running back-end server | Optional |
Inactive | Host containing the primary back-end server | |
Other host | Mandatory |
Specifies that a unit or server is to be added by the pdchgconf command.
This option initializes the system log file or synchronization point dump file that is needed in order to add a unit or server. When this option is specified, the command will not check the server name.
If you execute the pdloginit command with this option specified, make sure that the command is executed at the unit where the system log file or synchronization point dump file is to be created.
Rules
Notes
Examples
pdloginit -d sys 1
-f /svr01/logf11 2
-n 64 3
pdloginit -d sys 1
-f /svr01/logf12 2
-n 64 3
pdloginit -d sys 1
-s bes1 2
-f /svr01/logf11 3
-n 64 4
pdloginit -d sys 1
-s bes1 2
-f /svr01/logf12 3
-n 64 4
pdloginit -d spd 1
-f /svr01/spdf11 2
-n 64 3
pdloginit -d spd 1
-f /svr01/spdf12 2
-n 64 3
pdloginit -d spd 1
-s bes1 2
-f /svr01/spdf11 3
-n 64 4
pdloginit -d spd 1
-s bes1 2
-f /svr01/spdf12 3
-n 64 4