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
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 Multi-User Facility (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 example 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 JCL Requirements
.
// EXEC PGM=DBUTLTY,REGION=2M //STEPLIB
See the previous note and JCL Requirements
.
//CXX DD DSN=cxx.data.set,DISP=SHR Directory data set //SYSIN DD * Command Input EDIT DBURSTR ABEND=YES,MULTUSE=YES /*
Sample Report
The following example 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. 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