if PARM= is omitted, the formal designator for the input ￿le, DBSTEXT , is equated to

$STDLIST . You would use this option, for example, if y ou wanted to enter the schema directly from y our terminal during a session and list the output to y our terminal (in addition to creating a root ￿le).

PARM=1 if DBSTEXT has been equated to an actual ￿le designator PARM=2 if DBSLIST has been equated to an actual ￿le designator

PARM=3 if both DBSTEXT and DBSLIST have been equated to actual ￿le designators

Figure 7-5 shows an example of creating a root ￿le. In this case, both DBSTEXT and DBSLIST are equated to actual ￿le designators: DBSTEXT is an existing MPE/iX text ￿le and DBSLIST is the line printer.

Figure 7-5. Example of Creating a Root File

DBUTIL

DBUTIL is a TurboIMAGE/XL subprogram that has man y capabilities. You can use it to:

Create a database Purge a database Erase a data set Display information about a database Enable and disable logging and reco very options Activate, deactivate, and report on a database access ￿le

You must be the creator of the database or kno w its maintenance word to use the DBUTIL commands PURGE and ERASE . The maintenance word is an optional ASCII string that y ou can specify with the DBUTIL commands CREATE or SET. It de￿nes a passw ord to use for executing DBUTIL commands, suc h as PURGE and ERASE, and to operate other database procedures. If no maintenance word is de￿ned, then only the database creator can operate them.

The DBUTIL command PURGE purges the root ￿le and all of the data sets in the database. (You cannot use the MPE/iX command :PURGE to purge a root ￿le, detail set, or master set.

Data Management 7-15