Using CA Datacom/DB Utility (DBUTLTY) › Command Syntax › Comments

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
              DTFNAME=INPUT                        From dtfname 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
                DTFNAME=INPUT,FORMAT=BACKUP