System Generation Compiler › Coding Considerations › Statement Format

Statement Format

System generation statements that reference entities have five parts.

1. Verb

The verb specifies the action to be taken by the system generation compiler:

• The action verbs are:
  • ADD establishes a new entity occurrence in the data dictionary.
  • MODIFY updates an existing entity occurrence.
  • DELETE removes an existing entity occurrence from the data dictionary.
• The display verbs are:
  • DISPLAY displays one or more existing entity occurrence definitions.
  • PUNCH displays one or more existing entity occurrence definitions and writes the definitions either to the SYSPCH file or to a data dictionary module.

  If you omit the verb from a system generation statement, the compiler supplies a verb.

ADD is the default verb when either of the following conditions applies:

• The specified entity occurrence does not exist in the data dictionary.
• The specified entity occurrence exists in the data dictionary but does not participate in the current system.

MODIFY is the default verb when the specified entity occurrence exists in the data dictionary and already participates in the current system.

The action verb DELETE and the display verbs DISPLAY and PUNCH must always be specified explicitly.

2. Entity Type Name

The entity type name identifies the type of entity to which the statement applies. The entity type name can also identify extended characteristics of the system entity.

Valid Entity Type Names

The following are the valid entity type names.

3. Entity Occurrence Name

The entity occurrence name identifies a specific occurrence of the named entity type. For example, in the following statement, UPDCUST is the entity occurrence name:

ADD PROGRAM UPDCUST.

Occurrences of the following entities can be further identified by a version number: destinations, lines, logical terminals, physical terminals, programs, queues, and tasks.

The following entity type names are not accompanied by an entity occurrence name: ADSO, IDD, OLM, OLQ, RESOURCE TABLE, RUNUNITS, TCP/IP, and SQL CACHE.

4. Parameters

The parameters either define characteristics of the entity occurrence or specify display options for the entity occurrence definition. For example, in the following statement, the LANGUAGE IS COBOL parameter defines the program's source language:

ADD PROGRAM ADDCUST LANGUAGE IS COBOL.

Parameters can be either optional or required, as indicated in the syntax, and can be coded in any order. If a statement contains multiple occurrences of the same parameter, the system generation compiler uses the last occurrence coded.

5. End of Statement

The period terminates a system generation statement and is required in all statements. The period can directly follow the last word in the statement, can be separated from the last word by blanks, or can be coded on a separate line.

Note: You can establish recognition of the semicolon as an alternate end of statement character if you specify the SEMICOLON ALTERNATE END OF SENTENCE IS ON clause on the SET OPTIONS statement or if this option has been activated by the IDD DDDL compiler as a default for the dictionary. For more information about the SET OPTIONS statement, see SET OPTIONS Statement.

The following example illustrates the parts of a typical system generation statement: