TurboIMAGE/XL Database Management System Reference Manual MPE/iX V6.5 (30391-90011)

466 Chapter9
Using a Remote Database
Access Through a Local Application Program
Activating a Database-Access File
After you have constructed a database-access file, you must use the DBUTIL utility program
to activate the file. The complete syntax for running the utility program is given in
chapter 8. Here is a summary of the operating instructions:
:RUN DBUTIL.PUB.SYS
.
.
.
>>ACTIVATE database-access file name
Verification follows:
FILE command: < result >
DSLINE command: < result >
HELLO command: < result >
ACTIVATED
>>EXIT
DBUTIL verifies that the file to be activated adheres to the following criteria:
• Has a file code of zero.
• Is an unnumbered, ASCII file.
• Has a record length <=128 characters.
• Has at least three records.
If any of these conditions is not satisfied, activation fails, and the following message is
printed:
filename is NOT a suitable database-access file
If the file has already been activated, the following message is printed:
filename is already ACTIVE
If all of the above are satisfied, DBUTIL prints the following message:
Verification follows:
Then the utility program verifies the syntax of the following records:
• Record 1.
• Record 2 through nodename; must be identical to the nodename specified in record 1.
• Records 3 through n, through the parameter rgpasw.
This means that for records 2 through n only the positional parameters (those whose
function is determined by their relative position within the command) are verified by