EDIT (Validate Syntax)

The EDIT function of DBUTLTY checks the syntax of one or more function keyword sets without executing the functions. When the EDIT function is specified, DBUTLTY edits all of the commands (and the keywords that follow them) for missing or invalid input. DBUTLTY displays all of the input that is accepted.
datacom
The EDIT function of DBUTLTY checks the syntax of one or more function keyword sets without executing the functions. When the EDIT function is specified, DBUTLTY edits all of the commands (and the keywords that follow them) for missing or invalid input. DBUTLTY displays all of the input that is accepted.
This function does not attempt to verify that any database, area, or table specified in the input actually exists. The editing is for most conditions, but not every edit occurs when the function is completely processed.
The EDIT function does not open any
CA Datacom®/DB
tables.
The following topics are discussed on this page:
When to Use EDIT
Use the EDIT function when setting up JCL for a DBUTLTY function for the first time or when making changes to JCL.
How to Use EDIT
You can execute this command in either Single User or with the MUF active. To edit a stream of DBUTLTY functions, execute DBUTLTY using the following command format preceding the input stream to be edited:
►►─ EDIT ─────────────────────────────────────────────────────────────────────►◄
Command
  • EDIT
    Invokes the EDIT function for the input stream following this command. This must be the first input control statement in the input stream.
Example JCL (EDIT)
Use the following as a guide to prepare your JCL. The JCL statements are for example only. Lowercase letters in a statement indicate a value you must supply. Code all statements to your site and installation standards.
 //jobname    
See the previous note and 
.
 //       EXEC PGM=DBUTLTY,REGION=2M  //STEPLIB    
See the previous note and 
.
 //CXX      DD DSN=cxx.data.set,DISP=SHR           Directory data set  //SYSIN    DD *                                   Command Input           EDIT           DBURSTR  ABEND=YES,MULTUSE=YES  /*
Sample Report
Following is a sample report page. For an example report header, see Sample Report Headers.
 
                    CONTROL CARD(S)                     .........1.........2.........3.........4.........5.........6.........7.........8                     EDIT                       FUNCTION=EDIT                DB10016I - EDIT ONLY, NO FUNCTION(S) PROCESSED  
This page of the report shows the following:
  • The command exactly as entered.
  • An analysis of keywords encountered and expected. Any errors found are flagged with a note in the left margin.
  • Any messages related to syntax processing.
  • Message DB10016I indicates an EDIT was in process.
  • An analysis of the keywords encountered and expected with the command being edited.
    CA Datacom®/DB
    flags any errors with a note in the left margin.
                    CONTROL CARD(S)                     ........1.........2.........3.........4.........5.........6.........7.........8                     DBURSTR ABEND=YES,MULTUSE=YES                       FUNCTION=DBURSTR                        ABEND=YES                        MULTUSE=YES       DB10016I - EDIT ONLY, NO FUNCTION(S) PROCESSED