DBUTLTY Command Syntax

DBUTLTY functions are invoked through commands input to the utility. Many functions also require additional information that is supplied with keywords.
datacom150
DBUTLTY functions are invoked through commands input to the utility. Many functions also require additional information that is supplied with keywords.
Contents
Command
To execute a utility function, supply a command to DBUTLTY. Each command specifies the function to be performed. You can enter a command starting in any position of the command line, but you cannot precede a command with any other data in that line.
Keyword Parameters
A keyword parameter consists of a keyword followed by an equal sign (=) and a value. Do not code any intervening blanks when constructing a keyword parameter. Separate the command name and the first keyword parameter with at least one blank.
If you have multiple keyword parameters, separate them with commas. You can place the parameters either on one line (with no intervening blanks or other characters) or on separate lines. The keyword parameters can begin in any column. For example:
COMMAND KEYWORD1=VALUE1,KEYWORD2=VALUE2
or
COMMAND     KEYWORD1=VALUE1,             KEYWORD2=VALUE2
Line Length
No input statement can extend beyond column 71.
End of Command
For commands without keyword parameters, the blank following the command name is the end of the command. When keyword parameters are required, DBUTLTY keeps reading input until it reads a keyword value which is followed by a blank instead of a comma.
Comments
You can include comments on your utility report by placing an asterisk (*) in column 1 of any input record. Any such input record is reproduced on your utility report but ignored for command input scan.
You can also include comments on command input records. For commands that have no keyword parameters, a comment can begin immediately following the blank that terminates the command.
For commands that have keyword parameters, you can place a comment following the last keyword parameter on a line as long as the comment is separated from the parameter (including the continuation comma) by at least one blank. A comment cannot directly follow a command that accepts keywords.
Following are examples illustrating the previous listed command input rules.
Input column ----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8   * This is a comment * The SPILL command requires no keyword parameters, * so the text after the command is a comment - *               SPILL                                Execute the spill function * * The LOAD command requires keyword parameters.  Comments can follow * the last keyword parameter on a line or follow the parameter on a * separate line. *               LOAD * * Comments cannot directly follow a command that requires keyword * parameters such as LOAD. *               AREA=CXX,                            We are loading the Directory               DDNAME=INPUT                         From ddname INPUT * * The next example shows how you might code multiple * keyword parameters on input lines with continuations. *          LOAD  DBID=59,AREA=TAB,   Comments can start here                 DDNAME=INPUT,FORMAT=BACKUP