BUTIL

The Maintenance utility is writing only as many bytes as the value of the /D option allows. If you want the utility to write all the bytes in the record, specify a value for the /D option that is at least as large as the affected record.

BUTIL-25: The /D parameter specified to BUTIL was too small for BUTIL to receive any part of the record

You specified an invalid value for the Requester /D option. Go to the configuration properties to increase the value specified.

BUTIL-26: The data buffer is too small to hold any part of the record

The MicroKernel cannot return any data in the data buffer because the data buffer is too small to hold it. Go to the configuration properties to increase the value specified for the Largest Record Size configuration option.

BUTIL-27: An error occurred during the access of the variable page. BUTIL is writing the obtainable portion of the variable page.

An error occurred during the recovery of a file with variable-length records. The file is corrupt.

BUTIL-30: The key position cannot exceed the record length

The range of the specified key position is invalid. The key position you specify on a MicroKernel Engine call must be within the range of the record’s length. For example, for a record that is 100 bytes long, a key position of 50 is within the correct range. However, a key position of 150 is not.

BUTIL-31: The key position plus key length cannot exceed the record length

The range of the key position you specified is invalid. The key position of a key plus its length cannot be larger than the record length. Verify that the key is defined so that its position plus its length does not exceed the record length.

BUTIL-32: The key length must be an even number for key type xxxx

You specified an invalid key length for the key type. Some key types must contain an even number of bytes. Specify a valid Key Length element.

BUTIL-36: The page size must be a multiple of 512, from 512 to 4,096

The page size you specified is invalid. Specify a page size based on the file version:


Page Size (bytes)	File Version
Page Size (bytes)	prior to 9.0	9.0	9.5 or newer
512
1024
1536
2048
2560
3072
3584
4096
8192
16384

BUTIL-37: The record length cannot exceed the page size

The record length you specified is invalid. In the description file, the record length you specified for the Record Length element is larger than the page size you specified for the Page Size element. Specify a record length that is smaller than the page size or increase the page size.

BUTIL-38: The record length must be at least 4 and no greater than 4,096

Specify a record length between 4 and the maximum as shown in the following table:


File Version	Maximum Record Length (bytes)
5.x	4096
6.x or 7.x	4088
8.x	4086
9.0	8182
9.5 or newer	16372

The internal overhead in bytes is as follows:

•

Pre 8.x file format = 8

•

8.x file format = 10 (4096 - 10 = 4086)

•

9.0 file format = 10 (8192 - 10 = 8182)

•

9.5 file format = 12 (16384 - 12 = 16372)

Note that it is advisable to leave some margin and not to use every available byte because the amount of overhead may increase in future file formats.

BUTIL-41: The alternate collating sequence cannot be found

The Maintenance utility cannot find the alternate collating sequence file you specified in the definition file. Verify that the alternate collating sequence file exists and that the name is correct in the definition file.

BUTIL-43: The file exists, but the Replace option was not specified

The Maintenance utility did not create a file when you specified the BUTIL –CREATE command because the file already exists. To recreate this file, specify the Replace Existing File element in the description file as Y.

BUTIL-44: The file access error nn occurred for file filename

The Maintenance utility returns the appropriate status code and filename for a file on which a file access error occurred during the beginning or end of continuous operation. The corrective measure depends on the status code received. Refer to Chapter 1, Status Codes for a description of Status Code nn.

BUTIL-45: The number of duplicate keys must be between 1 and 119

Check the value specified for the Duplicate Key element in the description file.

BUTIL-47: BUTIL cannot open the command file

Ensure that the command file exists and that you specified the command file location and filename correctly.

BUTIL-48: The command file is empty

Specify the desired commands in the command file before attempting to use the command file again. In addition, ensure you specified the correct command filename.

BUTIL-49: The command file exceeds 1,000 bytes

A command file cannot contain more than 1,000 bytes. Verify that the command file adheres to this requirement.

BUTIL-50: An internal error caused BUTIL to terminate

The Maintenance utility detected an internal diagnostic error that caused it to terminate.

BUTIL-52: MKDE cannot be stopped when SQL is loaded

Unload the MKDE before attempting to unload the MicroKernel.

BUTIL-53: MKDE error nn occurred for file or command xxxx

The Maintenance utility returns a status code related to a particular file or command. The corrective measure depends on the status code received. Refer to Chapter 1, Status Codes for a description of Status Code nn.

BUTIL-60: The end of the file occurred while BUTIL was expecting keyword xxxx on key segment descriptor nn

Check the syntax of the description file.

BUTIL-61: The end of the file occurred while BUTIL was expecting keyword xxxx

Check the syntax of the description file.

BUTIL-62: BUTIL was expecting keyword xxxx on key segment descriptor nn

Check the syntax of the description file.

BUTIL-63: BUTIL was expecting keyword xxxx

Check the syntax of the description file.

BUTIL-65: BUTIL has loaded no records

Verify that you specified the command correctly and that the input file is in the correct format.

BUTIL-66: BUTIL has loaded nn records so far

The utility loaded the stated number of records since you issued the BUTIL -LOAD command. When you receive this message, the command is still executing.

BUTIL-70: The MKDE error nn occurred on closing a file

The Maintenance utility returns this status code while closing a file. The corrective measure depends on the status code received. Refer to Chapter 1, Status Codes for a description of Status Code nn.

BUTIL-74: MKDE error nn was returned for the Stop Command

This message applies only to the DOS environment. The Maintenance utility returns this status code after you issue the BUTIL -STOP command. The corrective measure depends on the status code received. Refer to Chapter 1, Status Codes for a description of Status Code nn.

BUTIL-76: When BUTIL wrote the Page Allocation Table at page #nn, an error occurred

The Maintenance utility returns this message while salvaging a file if the file is corrupt, or when a hardware error occurs.

BUTIL-77: When BUTIL wrote a mirror copy of the Page Allocation Table at page #nn, an error occurred

The Maintenance utility returns this message while salvaging a file if the file is corrupted, or when a hardware error occurs.

BUTIL-82: Error occurred on file specification of the description file

An error occurred when the Maintenance utility attempted to read the file specification portion of the description file. Ensure that the elements that describe the file specification are valid.

BUTIL-84: BUTIL internal error

The Maintenance utility encountered an internal error, such as an invalid pointer. Try to run the Maintenance utility again.

BUTIL-90: BUTIL could not allocate enough memory

Free some memory at the server by unloading unused applications.

BUTIL-91: BUTIL could not determine the size of the file

Try to recover the file using the BUTIL –RECOVER command.

BUTIL-100: An internal status code nn

The value nn specifies the ID of a status code whose string resource could not be found. If there is no additional information about the status code in this documentation, call PSQL Technical Support with this information.

BUTIL-101: The list of files that were not processed is: list

The Maintenance utility returns this error during the ROLLFWD operation if the utility encounters a file that cannot be rolled forward. The utility stops rolling forward and lists the remaining files not processed.

If you receive this message in conjunction with the Maintenance utility message number 103, restore the missing log segment and any log segments created after it to the log directory. If you cannot restore all missing log segments, restore as many as possible. Then, perform the ROLLFWD operation and specify the segment_number parameter of the earliest log segment you could restore.

BUTIL-102: A Roll Forward error occurred

An internal error occurred while the MicroKernel was rolling forward files.

BUTIL-103: Log segment number nn is missing

The Maintenance utility returns this error during ROLLFWD operation if you do not specify a segment_number parameter and one of the files to be rolled forward has a Restore Segment Number that indicates a log segment number that the MicroKernel cannot find.

BUTIL-131: BUTIL was unable to create or open the sequential file

The Maintenance utility returns this message when it is unable to create or open the specified file. Check the sequential file to make sure it exists and has the read-only attribute set.

BUTIL-132: The disk volume is full

You must have more disk space to create or enlarge any data files.

BUTIL-134: BUTIL was unable to create or open the new file

Check the file specified for the BUTIL –SAVE or –RECOVER command. The file may already exist.

BUTIL-136: BUTIL was unable to write the new backup file

Verify that you specified the correct path and filename for the backup file. Also, ensure you have enough disk space for the file to be written.

BUTIL-141: File xx has an invalid extension. This extension is reserved for extended unformatted files

Specify a valid extension. For more information, see Advanced Operations Guide.

BUTIL-142: File xx exists

For more information about extended files, see Advanced Operations Guide.