4.622 tst-disk
Use this command prior to an upgrade, or as a diagnostic tool, to test the integrity of an EAGLE fixed drive or removable media drive, at the specified location. The test is non-intrusive and non-destructive to the disk. A read-only test is executed for all logical blocks (LBAs) used on the specified target disk and a report identifying any bad or questionable LBAs is output.
Parameters
- partition (optional)
- Portion of disk to be tested. This parameter
specifies the individual physical disk partition (1, 2, 3, or 4) or all defined
partitions for a given disk size up to a maximum of 4 partitions.
- Range:
- 1, 2, 3, 4
—Tests the specified existing partition on the
disk. Only the number or numbers for the partition or partitions that exist on
the disk are valid. (For example, if the disk size allows only 2 partitions,
partition=3 and
partition=4 are invalid
for that disk.)
all —Tests all existing partitions on the fixed disk or removable drive
- Default:
- all
Example
tst-disk:loc=1116
Dependencies
The card in the specified location (loc) must be an E5-TDM or E5-MCAP card.
The disk to be tested must be in service.
If a TDM location is specified, the TDM cannot be reserved (as when a copy-disk command is running).
The target drive must have low level format.
This command can be run simultaneously on both TDMs, if entered from different terminals.
The removable drive can be tested simultaneously with the standby TDM but not with the active TDM.
To test the Removable drive when loc=1113/1115:disk=remove/usb, the removable media must be inserted in the corresponding removable drive.
The partition=3 and partition=4 values are invalid for a 4GB fixed drive. The only valid value for the 2.3 GB and 4.1 GB removable disks is partition=1
An error message will be generated for a disk that has
been Formatted (format-disk
command) but does not yet contain a DOS directory structure
(created with the
copy-disk command) when the
partition= parameter is specified.
This command cannot be entered when other database commands are running.
If an E5-TDM card is installed, then the disk=fixed parameter cannot be specified.
The disk to be tested must be available.
Notes
A physical fixed disk (TDM) or removable drive is formatted and given a DOS directory structure to define the number of physical partitions that the disk size can accommodate. (The logical partitions that contain database, backup, GPL, and measurements files are placed in these physical partitions, with no correlation between the physical numbers and the logical contents.)
For a fixed TDM disk, the partition parameter specifies the individual partition (1, 2, 3, or 4) or all existing partitions to be tested.
- One partition = 2 GB.
- The 4 GB drive contains two 2 GB partitions.
- The 9 GB drive and the 18 GB drive each contain four 2 GB partitions.
- The 9 GB drive contains four 2 GB partitions.
- Any disk space beyond the four 2 GB partitions is unused disk space (and always has been due to EAGLE DISK FAT structure used).
The partition=all parameter implies that testing starts with the first partition, then second, and so on, until the last existing disk partition is detected without skipping any non-existing or defined partitions.
Table 4-57 outlines execution time estimates based on disk capacity.
Table 4-57 Test Disk Execution Times
| Capacity | Nominal Execution Time | Maximum Execution Time for 100% Errors |
|---|---|---|
|
4.0 GB |
40 minutes |
27.5 hours |
|
9.0 GB |
1 hour 45 minutes |
(Not determined) |
|
18 GB |
30 minutes (partition=1) 5 hours (partition=disk) depending on amount of disk tested and EAGLE provisioning/activity |
(Not determined) |
|
507 MB |
5 minutes |
3.4 hours |
|
2.0 GB |
20 minutes |
13.5 hours |
|
4.0 GB |
40 minutes |
27.5 hours |
|
Removable Drive |
30 seconds |
Less than 1 minute |
Nominal times for
tst-disk
command execution depend on the capacity of the disk being
tested and assume that few or no errors are found. Maximum execution times are
based on disk capacity, retry count, and retry delay. Each read error and retry
may cause a delay of up to three seconds. If a TDM has 100% error sectors, the
MASP will likely reset, terminating the disk test. A termination and reset will
not occur, however, when testing the removable media.
Because of the intense, sustained disk activity created
when
tst-disk
is executed, concurrently performing other disk-based
activities, such as prolonged LNP command entry or database backups, will
result in performance degradation up to twice the usual execution time.
Because of the extended processing time required for large disks, a progress message is displayed every five minutes providing the current LBA and the total LBA count for the partition.
Specific errors are reported for the first 10 error occurrences. Thereafter, only the error count is tracked and summary results are reported upon completion.
Output
tst-disk:loc=1116
rlghncxa03w 03-11-27 11:40:02 EST EAGLE 31.3.0
TST-DISK of all partitions initiated for TDM 1116
;
rlghncxa03w 03-11-27 11:40:02 EST EAGLE 31.3.0
TST-DISK: TDM 1116 in progress 868680 of 4124735 LBA read
;
rlghncxa03w 03-11-27 11:40:02 EST EAGLE 31.3.0
TST-DISK Error: TDM 1116 LBA range 4124706 - 4124960
Check Condition: DISK_NOT_READY
TST-DISK results for TDM 1116
Total LBAs = 4124735 LBA size = 512
Retries = 1 Errors = 1
Command Completed
;
tst-disk:loc=1116:partition=2
rlghncxa03w 03-11-27 11:40:02 EST EAGLE 31.3.0
TST-DISK on Partition 2 initiated for TDM 1116
;
rlghncxa03w 03-11-27 11:40:02 EST EAGLE 31.3.0
TST-DISK: TDM 1116 in progress 1234567 of 4194304 LBA read
;
rlghncxa03w 03-11-27 11:40:02 EST EAGLE 31.3.0
TST-DISK Error: TDM 1116 LBA range 4194304 - 4194558
(NOTE: w/i 2nd disk partition)
Check Condition: DISK_NOT_READY
TST-DISK results for TDM 1116
Total LBAs = 4194304 LBA size = 512
Retries = 1 Errors = 1
Command Completed
;
Related Topics