SET OPTIONS Syntax

DDDL Compiler Options › SET OPTIONS Statement › SET OPTIONS Syntax

SET OPTIONS Syntax

Syntax

SET OPTIONS Statement


►►─── set OPTions for ──┬─ SESsion ◄ ──┬──────────────────────────────────────►
                        └─ DICtionary ─┘

 ►─┬──────────────────────────────────────────────────┬───────────────────────►
   └─ PREPared by user-id ─┬────────────────────────┬─┘
                           └─ PASsword is password ─┘

 ►─┬─────────────────────────────────────────────────┬────────────────────────►
   └─ REVised by user-id ─┬────────────────────────┬─┘
                          └─ PASsword is password ─┘
 ►─┬──────────────────────┬───────────────────────────────────────────────────►
   └─ QUOte is ─┬─ ' ◄ ─┬─┘
                └─ " ───┘

 ►─┬────────────────────────────────────┬─────────────────────────────────────►
   └─ DECimal-point is ──┬─ PERiod ◄ ─┬─┘
                         └─ COMma ────┘

 ►─┬─────────────────────────┬────────────────────────────────────────────────►
   └─ DELete is ─┬─ ON ────┬─┘
                 └─ OFF ◄ ─┘
 ►─┬──────────────────────────┬───────────────────────────────────────────────►
   └─ DEFault is ─┬─ ON ────┬─┘
                  └─ OFF ◄ ─┘

 ►─┬────────────────────────────────────────────────────────────────────────┬─►
   └─┬─ FIRst ──┬─ alternate picture keyword is 'alternate-format-keyword' ─┘
     ├─ SECOnd ─┤
     ├─ THIrd ──┤
     └─ FOUrth ─┘

 ►─┬───────────────────────────────┬──────────────────────────────────────────►
   └─ SEQuence is ─┬─ sequence ──┬─┘
                   └─ 100 ◄ ─────┘
 ►─┬──────────────────────────┬───────────────────────────────────────────────►
   └─ BEFore is ─┬─ ON ─────┬─┘
                 └─ OFF ◄ ──┘

 ►─┬────────────────────────┬─────────────────────────────────────────────────►
   └─ AFTer is ─┬─ ON ────┬─┘
                └─ OFF ◄ ─┘

 ►─┬─────────────────────────────┬────────────────────────────────────────────►
   └─ RESEquence is ─┬─ ON ────┬─┘
                     └─ OFF ◄ ─┘
 ►─┬────────────────────────────────┬─────────────────────────────────────────►
   └─ AUThorization is ─┬─ ON ────┬─┘
                        └─ OFF ◄ ─┘

 ►─┬────────────────────────────────────────────────────────────┬─────────────►
   └─ SECUrity for ─┬─ ADS ──────────────────┬─ is ─┬─ ON ────┬─┘
                    ├─ CULprit ──────────────┤      └─ OFF ◄ ─┘
                    ├─ OLQ ──────────────────┤
                    ├─ IDMS ─────────────────┤
                    ├─ IDMS-DC ──────────────┤
                    ├─ CLAss and attribute ──┤
                    ├─ IDD ──────────────────┤
                    ├─ IDD SIGnon ───────────┤
                    └─ LOAd MODule ──────────┘
 ►─┬────────────────────────────────────────────────────────┬─────────────────►
   └─ INDividual PASsword security OVErride is ─┬─ OFF ◄ ─┬─┘
                                                └─ ON ────┘

 ►─┬───────────────────────────────────┬──────────────────────────────────────►
   └─┬─ REGistration ────┬─ OVErride ──┘
     └─ RESPonsibility ──┘

 ►─┬─────────────────────────────────────────────┬────────────────────────────►
   └─ USEr signon OVErride is ─┬─ ALLowed ◄ ───┬─┘
                               ├─ ON ──────────┤
                               ├─ NOT ALLowed ─┤
                               └─ OFF ─────────┘
 ►─┬──────────────────────────────────────────────────────┬───────────────────►
   └─ SEMicolon alternate end of sentence is ─┬─ ON ────┬─┘
                                              └─ OFF ◄ ─┘

 ►─┬──────────────────────────────┬───────────────────────────────────────────►
   └─ EOF is ─┬─ /* ◄ ──────────┬─┘
              ├─ eof-indicator ─┤
              └─ OFF ───────────┘

 ►─┬───────────────────────────┬──────────────────────────────────────────────►
   └─ FORMat is ─┬─ FIXED ───┬─┘
                 └─ FREE ◄ ──┘
 ►─┬──────────────────────────────────────────────────────────────────────────►─
   └─ PUNch TO ─┬─ SYSpch ◄ ──────────────────────────────────────────────────
                └─ MODule module-name ─┬───────────────────────────────────┬──
                                       └─ Version is ─┬─ version-number ─┬─┘
                                                      ├─ HIGhest ────────┤
                                                      └─ LOWest ─────────┘

─►──────────────────────────────────────────────────────────────────────────┬─►
  ─────────────────────────────────────────────────────────────────────────┬┘
  ─┬──────────────────────┬┬──────────────────────────────────────────────┬┘
   └ LANguage is language ┘└ PREpared by user-id ┬───────────────────────┬┘
                                                 └ PASsword is password ─┘

 ►─┬─────────────────┬────────────────────────────────────────────────────────►
   └─┬─ PROmpt ────┬─┘
     └─ NO PROmpt ─┘
 ►─┬───────────────┬──────────────────────────────────────────────────────────►
   └─┬─ ECHo ◄ ──┬─┘
     └─ NO ECHo ─┘

 ►─┬───────────────┬──────────────────────────────────────────────────────────►
   └─┬─ LISt ◄ ──┬─┘
     └─ NO LISt ─┘

 ►─┬─────────────────┬────────────────────────────────────────────────────────►
   └─┬─ HEAder ────┬─┘
     └─ NO HEAder ─┘
 ►─┬───────────────────────────────────┬──────────────────────────────────────►
   └─ LINes per page ─┬─ line-count ─┬─┘
                      └─ 60 ◄ ───────┘

 ►─┬────────────────────────────────────────────┬─────────────────────────────►
   └─ CULprit AUTo ATTributes are ──┬─ ON ────┬─┘
                                    └─ OFF ◄ ─┘

 ►─┬────────────────────────────────────────────────────────────────┬─────────►
   └─ INPut columns are start-column-number THRu end-column-number ─┘

 ►─┬─────────────────────────────────┬────────────────────────────────────────►
   └─ OUTput line size is ─┬─ 80 ──┬─┘
                           └─ 132 ─┘
 ►─┬────────────────────────────┬─────────────────────────────────────────────►
   └─ JCL CODe is ─┬─ $ ──────┬─┘
                   └─ NULl ◄ ─┘

 ►─┬───────────────────────────────────┬──────────────────────────────────────►
   └─ LEVel NUMbers are level-number ──┘

 ►─┬─────────────────────────────────────────────────────┬────────────────────►
   └─ DEFault for NEW Version is ─┬─ version-number ─────┤
                                  ├─ 1 ◄ ────────────────┤
                                  └─ NEXt ─┬─ HIGhest ─┬─┘
                                           └─ LOWest ──┘
 ►─┬──────────────────────────────────────────────────────────┬───────────────►
   └─ DEFault for EXIsting Version is ─┬─ version-number ─────┤
                                       ├─ 1 ◄ ────────────────┤
                                       └─ NEXt ─┬─ HIGhest ─┬─┘
                                                └─ LOWest ──┘

 ►─┬────────────────────────────────────┬─────────────────────────────────────►
   └─ DISplay ALL LIMit is ─┬─ ON ────┬─┘
                            └─ OFF ◄ ─┘

 ►─┬─────────────────────────────────────────────────┬────────────────────────►
   └─ INTerrupt count is ─┬─ maximum-record-count ─┬─┘
                          ├─ 0 ◄ ──────────────────┤
                          └─ NULl ─────────────────┘
►─┬──────────────────────────────────────────────────────────────────────────►─
  │           ┌────────────────────────────────────────────────────────┐
  │           │                   ┌─────────────────────────────────┐  │
  └─ DISplay ─▼─┬─ WITh ◄ ────┬───▼─┬─ ALL COMment TYPes ─────────┬─┴──┴─────
                ├─ ALSo WITh ─┤     ├─ ALL ◄ ─────────────────────┤
                └─ WITHOut ───┘     ├─ AREas ─────────────────────┤
                                    ├─ ATTributes ────────────────┤
                                    ├─ COBol ─────────────────────┤
                                    ├─ COMments ──────────────────┤
                                    ├─ CULprit headers ───────────┤
                                    ├─ DEFinitions ───────────────┤
                                    ├─ DEStinations ──────────────┤
                                    ├─ DETails ───────────────────┤
                                    ├─ ELements ──────────────────┤
                                    ├─ ENTRy points ──────────────┤
                                    ├─ FILes ─────────────────────┤
                                    ├─ HIStory ───────────────────┤
                                    ├─ LINes ─────────────────────┤
                                    ├─┬─ LOGical-terminals ─┬─────┤
                                    │ └─ LTErms ────────────┘     │
                                    ├─ LRS ───────────────────────┤
                                    ├─ MAPs ──────────────────────┤
                                    ├─┬─ MODules ──────┬──────────┤
                                    │ ├─ MODules ONLy ─┤          │
                                    │ ├─ PROCesses ────┤          │
                                    │ ├─ QFIles ───────┤          │
                                    │ └─ TABles ───────┘          │
                                    ├─ MODule SOUrce ─────────────┤
                                    ├─ NONe ──────────────────────┤
                                    ├─ OLQ headers ───────────────┤
                                    ├─┬─ PANels ──┬───────────────┤
                                    │ └─ SCReens ─┘               │
                                    ├─┬─ PHYsical-terminals ─┬────┤
                                    │ └─ PTErms ─────────────┘    │
                                    ├─ PICture OVErrides ─────────┤
                                    ├─ PROCesses ─────────────────┤
                                    ├─ PROgrams ──────────────────┤
                                    ├─ PROgrams CALled ───────────┤
                                    ├─ QFIles ────────────────────┤
                                    ├─ QUEues ────────────────────┤
                                    ├─ RECELements ───────────────┤
                                    ├─ RECords ───────────────────┤
                                    ├─ RELated FILes ─────────────┤
                                    ├─ REMarks ───────────────────┤
                                    ├─ REPorts ───────────────────┤
                                    ├─ SAMe AS ───────────────────┤
                                    ├─ SCHema ────────────────────┤
                                    ├─ SETs ──────────────────────┤
                                    ├─ SUBOrdinate ELements ──────┤
                                    ├─ SUBSChemas ────────────────┤
                                    ├─ SYNonyms ──────────────────┤
                                    ├─┬─ SYStems ──────┬──────────┤
                                    │ └─ SUBSYstems ───┘          │
                                    ├─ TABles ────────────────────┤
                                    ├─ TASks ─────────────────────┤
                                    ├─ TRAnsactions ──────────────┤
                                    ├─ USErs ─────────────────────┤
                                    ├─┬─ USEr DEFINED COMments ─┬─┤
                                    │ └─ UDCs ──────────────────┘ │
                                    ├─┬─ USEr DEFINED NESts ─┬────┤
                                    │ └─ UDNs ───────────────┘    │
                                    ├─ VIEws ─────────────────────┤
                                    ├─ WHEre USED ────────────────┤
                                    └─ WITHIn ─┬─┬─ SYStem ────┬──┤
                                               │ └─ SUBSYstem ─┘  │
                                               └─ USEr ───────────┘
─►────────────────────────────────────────────────────────┬───────────────────►◄
  ─┬────────────────────────────────────────────────────┬─┘
   └─ VERB ──┬─────────────────┬─ AS ─┬─ SYNtax ──────┬─┘
             └─┬─ DISplay ───┬─┘      └─ COMments ◄ ──┘
               ├─ PUNch ─────┤
               ├─ ADD ───────┤
               ├─ MODify ────┤
               ├─ REPlace ───┤
               └─ DELete ────┘

Parameters

set OPTions for DICtionary

Establishes new default processing options for all DDDL compiler sessions that access the current dictionary; installation defaults or defaults established with a previous SET OPTIONS FOR DICTIONARY statement are overridden. To issue SET OPTIONS FOR DICTIONARY statements, the user must be assigned AUTHORITY FOR UPDATE IS ALL (see USER). When the issuing user has not been assigned the proper authority, the PREPARED BY or REVISED BY clause must accompany this statement.

set OPTions for SESsion

Establishes temporary default processing options for a single DDDL compiler session. Any user can issue the SET OPTIONS FOR SESSION statement. However, some clauses require user authority (see SET OPTIONS Security). When the issuing user has not been assigned the proper authority, SET OPTIONS statements including such clauses must also include PREPARED BY or REVISED BY specifications.

PREpared by user-id

Establishes a default PREPARED BY specification for all entity-type statements issued in the current DDDL session and assigns the user authority to specify secured clauses of the SET OPTIONS statement. If this clause is not specified, the default PREPARED BY specification is the user ID supplied in SIGNON statement or the user ID known to the execution environment. PREPARED BY is ignored if NOT ALLOWED is specified in the USER SIGNON OVERRIDE clause. For more information about the PREPARED BY clause, see Securing the Dictionary.

PASsword is password

Identifies the password assigned to the authorized user specified in the PREPARED BY clause.

REVised by user-id

Establishes a default REVISED BY specification for all entity-type statements issued in the current DDDL session and assigns the issuing user authority to specify secured clauses of the SET OPTIONS statement. If this clause is not specified, the default REVISED BY specification is the user ID supplied in the SIGNON statement or the user ID known to the execution environment. PREPARED BY is ignored if NOT ALLOWED is specified in the USER SIGNON OVERRIDE clause. For more information about the REVISED BY clause, see Securing the Dictionary.

QUOte is '

Defines the site-standard quote as a single quotation mark (').

QUOte is ''

Defines the site-standard quote as a double quotation mark ('').

DECimal-point is

Specifies the site-standard decimal-point character to be used in ELEMENT, RECORD ELEMENT, and COBOL PICTURE and VALUE specifications.

PERiod

Establishes the period (.) as the default decimal-point character. The DDDL compiler interprets periods as decimal points.

COMma

Establishes the comma (,) as the default decimal-point character. The DDDL compiler interprets commas as insertion characters.

DELete is

Specifies whether elements are deleted or retained when the only record occurrence in which they participate is deleted.

ON

Deletes elements when the only record occurrence in which they participate is deleted. The DDDL compiler, however, does not automatically delete elements that participate in another record, have associated description text, have been modified and have a nonblank date-last-updated field, or are associated with users, attributes, ranges, other elements through nesting or any comment type.

OFF

Retains elements when the only record occurrence in which they participate is deleted. To delete such elements, the user must issue individual DELETE ELEMENT statements.

DEFault is

Specifies whether ADD statements that identify existing entity occurrences are accepted or rejected.

ON

Accepts ADD statements that identify existing entity occurrences. The DDDL compiler interprets such statements as MODIFY statements for the entity occurrence and issues the message ADD CHANGED TO MODIFY.

OFF

Rejects ADD statements that identify existing entity occurrences.

FIRst/SECond/THIrd/FOUrth ALTERNATE PICTURE KEYWORD IS 'alternate-format-keyword'

Establishes up to four keywords that can be used within ELEMENT and RECORD statements to identify alternative formats for the object element or for all elements within the object record. Alternate-format-keyword is a 1 to 16 character user-defined keyword enclosed in quotation marks that characterizes the desired format (for example, 'NUMERIC EDITED' or 'ZONED DECIMAL'). To issue this clause, the user must be assigned AUTHORITY FOR UPDATE IS ALL.

SEQuence is sequence

Establishes the starting and increment values for line numbers associated with entries in record-element structures, comment text, and module source. Sequence must be a 1 to 5 digit integer.

BEFore is

Specifies whether text is to be printed before it is erased by an EDIT clause.

ON

Specifies that text to be erased or replaced by an EDIT clause instruction is to be printed before it is erased.

OFF

Specifies that text to be erased or replaced by an EDIT clause instruction is not to be printed before it is erased. The user can include a SHOW instruction within individual EDIT clauses to override the SET OPTIONS BEFORE value.

AFTer is

Specifies whether to print new text after it is inserted or replaced by an EDIT clause instruction.

ON

Specifies that the new text to be inserted or replaced by an EDIT clause instruction is to be printed after it is inserted or replaced.

OFF

Specifies that the new text to be inserted or replaced by an EDIT clause instruction is not to be printed after it is inserted or replaced.

The user can include a SHOW instruction within individual EDIT clauses to override the SET OPTIONS AFTER value.

RESEquence is

Specifies whether all instructions in an EDIT clause are resequenced after modification.

ON

Specifies that text to be modified by an EDIT clause instruction is to be resequenced after all instructions within the requested EDIT clause have been completed.

OFF

Specifies that text to be modified by an EDIT clause instruction is not to be resequenced after all instructions within the requested EDIT clause have been completed.

You can include a SEQUENCE instruction within individual EDIT clauses to override the SET OPTIONS RESEQUENCE value.

AUThorization is

Specifies guidelines for accepting or rejecting programs based on whether they are defined in the dictionary.

ON

Directs CA IDMS DMLO precompilers to accept only programs defined in the dictionary (those represented by occurrences of the PROGRAM entity type in the dictionary).

OFF

Directs CA IDMS DMLO precompilers to accept any program.

SECUrity for

Specifies whether security is to be enabled for IDD, CA IDMS, and CA IDMS/DC system entity types, the DDDL compiler, the CA IDMS schema compiler, the CA IDMS subschema compiler, and for CA ADS, CA Culprit, and CA OLQ operations. The SECURITY FOR clause is repeatable.

ADS

Specifies that only users with ADS authority can access CA ADS.

CULprit

Specifies that only users with CULPRIT authority can authorize other users to access files and subschemas to run CA Culprit reports. CA Culprit runs will access only authorized files and subschemas. CA Culprit security can also be used to restrict a user's ability to change record layouts and file definitions and to restrict access to DDR reports. To change record layouts and file definitions, the user must be assigned the CULPRIT OVERRIDES ARE ALLOWED option; to access DDR reports, the user must be assigned the CULPRIT OVERRIDES ARE ALLOWED option and must be authorized to access subschema IDMSNWKA of schema IDMSNTWK version 1. For more information about the CULPRIT OVERRIDES option, see USER.

OLQ

Specifies that only users with CA OLQ authority can code USER statement clauses that pertain to CA OLQ. Additionally, if SECURITY FOR OLQ IS ON is specified, CA OLQ release 3.1 and later will enforce subschema and q-file restrictions. See the CA OLQ Reference Guide for further details.

IDMs

Specifies that only users with IDMS authority can register programs with subschemas and use the CA IDMS schema compiler and/or the CA IDMS subschema compiler.

IDMS-DC

Specifies that only users with IDMS-DC authority can access occurrences of the DESTINATION, LINE, LOGICAL-TERMINAL, MAP, MESSAGE, PANEL, PHYSICAL-TERMINAL, QUEUE, and TASK entity types.

CLAss and attribute

Specifies that only users with CLASS AND ATTRIBUTE authority can access occurrences of the ATTRIBUTE, CLASS, and user-defined entity types.

IDD

Specifies that only users with IDD authority can access occurrences of the ELEMENT, FILE, MODULE, QFILE, PROCESS, PROGRAM, RECORD, SYSTEM, TABLE, and USER entity types.

IDD SIGnon

Specifies that only users with IDD SIGNON authority can sign on to the DDDL compiler.

LOAd MODule

Specifies that only users with AUTHORITY FOR UPDATE IS LOAD MODULE can access a load module in the dictionary. To issue this clause, the user must be assigned AUTHORITY FOR UPDATE IS LOAD MODULE.

is ON

Specifies (as part of the SECURITY FOR clause) that user authorization is required to access (ADD, MODIFY, REPLACE, DELETE, DISPLAY, PUNCH) secured entity types or perform secured operations. If the authorized user has been assigned a password, that password must be supplied in the accompanying PREPARED BY/REVISED BY specification. User authority is established with the USER statement (see USER).

is OFF

Specifies (as part of the SECURITY FOR clause) that user authorization is not required to access entity types specified in the SECURITY FOR clause.

INDividual PASsword security OVErride is

Specifies whether users will be allowed to modify their own passwords.

OFF

Specifies that users cannot modify their own passwords unless they are assigned AUTHORITY FOR UPDATE IS PASSWORD and, if the SET OPTIONS statement specifies SECURITY FOR IDD IS ON, AUTHORITY FOR UPDATE IS IDD.

ON

Specifies that users can modify their own passwords. To issue this clause, the user must be assigned AUTHORITY FOR UPDATE IS ALL.

REGistration OVErride

Turns off entity-occurrence security for the DDDL compiler session. The user cannot revoke this security override for the duration of the session. To issue this clause, the user must be assigned AUTHORITY FOR UPDATE IS ALL. For a detailed discussion of entity-occurrence security, see Securing the Dictionary. RESPONSIBILITY is a synonym for REGISTRATION.

SEr signon OVErride is

Indicates whether CA IDMS/DB will allow users to specify a different user ID in a SIGNON statement from the one known to the environment in which the compiler is executing (the DC/UCF system for online, the batch environment for batch).

ALLowed

Users may sign on to the compiler with a different user ID from the ID known to the execution environment and user-specification clauses may be used to override the default user ID. ALLOWED is the default. ON is a synonym for ALLOWED.

NOT ALLowed

CA IDMS/DB will not allow the user ID to be changed. Users who are already known to the environment cannot specify a different user ID in the SIGNON statement. Additionally, user-specification clauses cannot be used to change the default user ID. OFF is a synonym for NOT ALLOWED.

SEMicolon alternate end of sentence is

Indicates whether the semicolon is to be recognized as an alternative end-of-statement character.

ON

Specifies that both semicolons and periods are to be recognized as end-of-statement characters.

OFF

Specifies that the semicolon is not recognized as an alternative end-of-statement character. OFF is the default.

EOF is

Overrides the default logical end-of-file indicator established at IDD installation.

/*

Indicates the default logical end-of-file indicator.

eof-indicator

Specifies an end-of-file indicator.

OFF (online IDD only)

Specifies that there is no active end-of-file indicator.

FORMat is

Establishes the default format for DISPLAY/PUNCH verb output.

FIXED

Lists DISPLAY/PUNCH output in columnar format.

FREE

Lists DISPLAY/PUNCH output as running text.

PUNch TO

Specifies the default destination for PUNCH verb output.

SYSpch

Directs PUNCH verb output to the SYSPCH file. SYSPCH is the default destination established during IDD installation.

MODULE module-name

Directs PUNCH verb output to an IDD module. Module-name must be the 1- through 32-character name of a module that has been defined in the dictionary with a MODULE statement (see MODULE (PROCESS/QFILE/TABLE)). The following rules apply to the module named as the PUNCH verb destination:

Once the module has been named as the destination of the PUNCH command, it cannot be modified, replaced, or deleted.
A module cannot be punched to itself.

If module source code is already associated with the named module, the DDDL compiler adds the PUNCH verb output to the end of the existing source. If module source does not exist, the DDDL compiler generates a header, which contains the date and time that the initial punched output was created; the punched output follows this header.

LANguage is language

Specifies a language to be associated with the named module.

PREpared by user-id

Identifies the user who defined the module.

PASsword is 'password'

Specifies the password of the identified user; mandatory if a password is associated with the user.

PROmpt

Specifies use of the word ENTER to prompt users for input. The PROMPT option is useful for local TSO z/VM operations or with dial-up devices.

NO PROmpt

Specifies no user prompt.

ECHo

Redisplays each input line the compiler reads. This is useful when DDDL statements are input one line at a time (for example, under TSO or z/VM, or from a hard-copy terminal).

NO ECHo

Specifies no redisplay of input lines even if the line contains an error. Suppresses execution of the EJECT and SKIP carriage control statements.

LISt

Redisplays each line read by the compiler.

NO LISt

Specifies no redisplay of input lines unless a line contains errors. Suppresses execution of the EJECT and SKIP carriage control statements.

HEAder

Specifies that the header lines that identify the DDDL compiler are to be printed on the IDD Activity List.

NO HEAder

Specifies that the header lines that identify the DDDL compiler are not to be printed on the IDD Activity List. This is useful when DDDL statements are input one line at a time (for example, under TSO or z/VM, or from a hard-copy terminal).

LINes per page line-count

Specifies the number of lines per page as a SET OPTIONS FOR SESSION option. The acceptable range for line-count is 10 through 60.

CULprit AUTo ATTributes are

For CA Culprit users only, this parameter determines whether file definitions are copied from the dictionary by CA Culprit at runtime.

ON

Specifies that the file description, including such information as block size, record size, recording mode, file and device types, or input module name, is to be copied from the dictionary at runtime.

OFF

Specifies that the file description is not copied from the dictionary at runtime.

INPut columns are start-column-number THRu end-column-number

Specifies the starting and ending columns for DDDL compiler input (and output with the exception of error messages). The maximum input column range is 1 through 80 for batch and line mode and 1 through 79 for full-screen mode. The default column range established at installation is 1 through 72 for batch mode, 1 through 80 for line mode, and 1 through 79 for full-screen mode. The continuation character (+) need not be coded in column 1; it can appear anywhere, provided that it is the first entry on the line. The user can select any value within the allowable range for start-column-number and end-column-number; the minimum number of characters allowed between low and high columns is ten.

OUTput line size is

Specifies an output line size for error messages. The line size for all other DDDL output is determined by the INPUT COLUMNS ARE clause.

80

Specifies an error message line size of 80 columns for the online compiler. The DDDL compiler does not list the line numbers of erroneous lines when it issues error messages; the error message, however, always appears on the line immediately below the erroneous line.

132

Specifies an error message line size of 132 columns for the batch compiler.

JCL CODe is

Specifies whether a dollar sign ($) in the first column of module source or EDIT clause input will be recognized as JCL or input data.

$

Specifies that a dollar sign in column one of module source or EDIT clause input is to be translated to a slash (/) when it is stored in the dictionary. Typically, this option is used to ensure that the operating system does not interpret input data as JCL.

NULl

Specifies that a dollar sign in column one is to be treated as input data; that is, the dollar sign is not translated to a slash when it is stored in the dictionary.

LEVel NUMbers are

Specifies the values to be associated with corresponding hierarchical depths in record-element structures.

level-number

Specifies a two-digit integer in the range 02 through 49; used with the LEVEL NUMBERS clause. In order to request a range of level numbers, the entire sequence of numbers must be explicitly coded; up to 48 level numbers can be specified in ascending order. If fewer than 48 level numbers are coded, 49 is the default. The LEVEL NUMBERS specification does not modify level numbers in existing record elements.

DEFault for NEW Version is

Establishes a default version number for the VERSION parameter of the NAME clause in ADD statements.

version-number

Specifies that the DDDL compiler is to assign a new entity occurrence the specified version number; version-n must be an integer in the range 1 through 9999.

NEXt HIGhest

Specifies that the DDDL compiler is to assign a new entity occurrence the highest version number associated with the specified entity-occurrence name, plus 1. If NEXT is the only keyword coded, NEXT HIGHEST is assumed. Because NEXT HIGHEST creates a new version, if the requested entity occurrence exists in the dictionary, the DDDL compiler does not issue the ADD CHANGED TO MODIFY message.

NEXt LOWest

Specifies that the DDDL compiler is to assign a new entity occurrence the lowest version number associated with the specified entity-occurrence name, minus 1. Because NEXT LOWEST creates a new version, if the requested entity occurrence exists in the dictionary, the DDDL compiler does not issue the ADD CHANGED TO MODIFY message.

DEFault for EXIsting Version is

Establishes a default version number to be used in any statement or clause that references an existing entity occurrence.

version-number

Specifies use of the specified version number; version-number must be an integer in the range 1 through 9999.

HIGhest

Specifies use of the highest version number associated with the specified entity-occurrence name.

LOWest

Specifies use of the lowest version number associated with the specified entity-occurrence name.

DISplay ALL LIMit is

Indicates whether the DDDL compiler will limit the number of records to be retrieved using a DISPLAY ALL statement.

ON

Specifies that the number of records retrieved by a DISPLAY ALL statement will be limited to the number of records specified in the INTERRUPT COUNT clause.

OFF

Specifies that the number of records retrieved by a DISPLAY ALL statement is not limited. OFF is the default.

INTerrupt count is

Specifies the maximum number of records to be retrieved using a DISPLAY ALL statement when the DISPLAY ALL LIMIT is ON.

maximum-record-count

Specifies a maximum number for INTERRUPT COUNT. Maximum-record-count can be any number, including 0.

NULl

Sets the maximum-record-count to 0.

DISplay

Supplies default values for DISPLAY/PUNCH clauses. This clause is positional; it must be coded as the last clause in a SET OPTIONS statement. You can select one or more entity options for display, but you cannot repeat an option.

WITh

Lists the requested information. All options specified in previously issued DISPLAY WITH and DISPLAY ALSO WITH statements are replaced.

ALSo WITh

Lists the requested information in addition to any information requested in previously issued DISPLAY WITH and DISPLAY ALSO WITH statements.

WITHOut

Excludes the specified information from the information requested in previously issued DISPLAY WITH and DISPLAY ALSO WITH statements.

ALL

Specifies the display of all of the information associated with the requested entity occurrence. ALL is the default.

ALL COMment TYPes

Specifies the display of all comment entries (COMMENTS, DEFINITIONS, ELEMENT DEFINITIONS, CULPRIT HEADERS, OLQ HEADERS, REMARKS, and user-defined comment keys) associated with the requested entity occurrence.

AREas

Specifies the display of all database areas associated with the requested entity occurrence.

ATTributes

Specifies the display of all attributes associated with the requested entity occurrence.

COBol

Specifies the display of record elements associated with the requested record occurrence displayed in COBOL format. This parameter applies only to RECORD entities.

COMments

Specifies the display of all comments associated with the requested entity occurrence.

CULprit headers

Specifies the display of all RIT headers associated with the requested record element. This parameter applies to record elements only.

DEFinitions

Specifies the display of all definitions associated with the requested entity occurrence.

DEStinations

Specifies the display of all destinations associated with the requested entity occurrence.

DETails

Specifies the display of entity-specific descriptions; for example, the length of a record or the block size of a file.

ELements

Specifies the display of all elements associated with the requested entity occurrence.

ENTRy points

Specifies the display of all entry points associated with the requested entity occurrence.

FILes

Specifies the display of all files associated with the requested entity occurrence.

HIStory

Specifies the display of the chronological account of an entity's existence, including PREPARED/REVISED BY specifications, date created, and date last updated. For programs, HISTORY also includes the number of times the program has been compiled and the date of the last compilation.

LINes

Specifies the display of all lines associated with the requested entity occurrence.

LOGical-terminals

Specifies the display of all logical terminals associated with the requested entity occurrence.

LRS

Specifies the display of all of the logical records associated with the requested program. This parameter only applies to PROGRAM entities.

MAPS

Specifies the display of all maps associated with the requested entity occurrence.

MODules

Specifies the display of all modules, processes, q-files, or tables associated with the requested entity occurrence.

MODules ONLy

Optionally limits the list to modules with a language specification other than PROCESS, OLQ, or TABLE.

MODule SOUrce

Specifies the display of the source statements associated with the requested module, process, or q-file. This parameter only applies to MODULE, PROCESS, and QFILE entities.

NONE

Specifies the display of the name of the requested entity occurrence. NONE is meaningful only when WITH is specified.

OLQ headers

Specifies the display of all CA OLQ headers associated with the requested record element. This parameter applies to record elements only.

PANels

Specifies the display of all panels (screens) associated with the requested entity occurrence. SCREENS is a synonym for PANELS.

PHYsical-terminals

Specifies the display of all physical terminals associated with the requested entity occurrence. PTERMS is a synonym for physical-terminals.

PICture OVErrides

Specifies the display of the PICTURE, USAGE, VALUE, JUSTIFY, SIGN, BLANK WHEN ZERO, LINE IS, SUBORDINATE ELEMENT REDEFINES, and SUBORDINATE ELEMENT OCCURS specifications associated with the requested record element. This parameter only applies to RECORD entities.

PROCesses

Specifies the display of all processes associated with the requested entity occurrence.

PROgrams

Specifies the display of all programs associated with the requested entity occurrence.

PROgrams CALled

Specifies the display of all of the subprograms associated with the requested program. This parameter applies to PROGRAM entities only.

QFIles

Specifies the display of all q-files associated with the requested entity occurrence.

QUEues

Specifies the display of all queues associated with the requested entity occurrence.

RECELems

Specifies the display of record detail information and all record elements associated with the requested record occurrence. This parameter applies only to RECORD entities.

RECords

Specifies the display of all records associated with the requested entity occurrence.

RELated FILes

Specifies the display of all of the relationships created with the RELATED FILES ARE clause of the FILE statement for the requested file.

REMarks

Specifies the display of all remarks associated with the requested program. This parameter applies to PROGRAM entities only.

REPorts

Specifies the display of all reports associated with the requested entity occurrence.

SAMe AS

Specifies the display of all of the relationships that exist between the entities that are the source and target of a SAME AS clause; for information on the SAME AS clause, see Copying and Editing Entity Occurrences.

SCHemas

Specifies the display of all schemas associated with the requested entity occurrence.

SETs

Specifies the display of all sets associated with the requested entity occurrence.

SUBOrdinate ELements

Specifies the display of all of the subordinate elements associated with the requested group element. This parameter applies to ELEMENT entities only.

SUBSChemas

Specifies the display of all subschemas associated with the requested entity occurrence.

SYNonyms

Specifies the display of all of the synonyms associated with the requested entity occurrence. If the requested entity occurrence is an attribute, record synonyms associated with that attribute apply. This parameter only applies to ELEMENT, FILE, and RECORD entities.

SYStems

Specifies the display of all systems or subsystems associated with the requested entity occurrence. SYSTEMS and SUBSYSTEMS are synonyms.

TABles

Specifies the display of all tables associated with the requested entity occurrence.

TASks

Specifies the display of all tasks associated with the requested entity occurrence.

TRAnsactions

Specifies the display of all transactions associated with the requested entity occurrence.

USErs

Specifies the display of all users associated with the requested entity occurrence.

USEr DEFINED COMments

Specifies the display of all user-defined comment keys associated with the requested entity occurrence. This parameter only applies to entities with user-defined comment keys. UDCS is a synonym for USER DEFINED COMMENTS.

USEr DEFINED NESts

Specifies the display of all of the user-defined nests associated with the requested entity occurrence. This parameter only applies to entities with relational keys. UDNS is a synonym for USER DEFINED NESTS.

WHEre USED

Specifies the display of all relationships in which the requested entity occurrence participates as a subordinate element, program called, related file, attribute, user-defined nest, or user or system within another user or system.

This parameter only applies to ATTRIBUTE, ELEMENT, FILE, MODULE, PROGRAM, RECORD, SYSTEM, USER, and user-defined entities.

WITHin SYStem

Specifies the display of all system (subsystem) occurrences related to the requested system/subsystem by means of the WITHIN SYSTEM clause. This parameter applies to SYSTEM/SUBSYSTEM entities only. SUBSYSTEM and SYSTEM are synonyms and can be used interchangeably.

WITHIn USEr

Specifies the display of all users with whom the requested user has been related by means of the WITHIN USER clause. This parameter applies to USER entities only.

VERB DISplay/PUNch/ADD/MODify/REPlace/DELete

Specifies the default verb to accompany DISPLAY/PUNCH verb output.

AS SYNtax

Specifies that information listed in response to a DISPLAY/PUNCH request appears as DDDL syntax. By displaying entity-occurrence definitions as syntax, the user can edit existing definitions and resubmit them to the DDDL compiler.

AS COMments

Specifies that DISPLAY/PUNCH output appears as comments (which are ignored by the DDDL compiler). Each line is preceded by an asterisk and a plus sign (*+) in the first two columns.

Example

The following SET OPTIONS statement establishes default processing options for one session. Specifications are given that instruct the DDDL compiler to list DISPLAY/PUNCH output in syntax format and accept input in columns 2 through 65.

set options for session
   input columns are 2 thru 65
   display as syntax.

Usage

Order of SET OPTIONS parameters

The parameters of the SET OPTIONS statement can be coded in any order, with the exception of the DISPLAY clause, which must appear as the last clause in a SET OPTIONS statement.

Considerations for alternate picture keywords

Subsequently issued SET OPTIONS statements can change existing alternate picture keywords. Note, however, that all elements and record elements that have been assigned alternative formats retain those formats unless the element or record-element definition is explicitly changed. For example, if an element definition specifies PICTURE IS 'NUMERIC EDITED', the format remains unchanged, regardless of whether a SET OPTIONS FIRST ALTERNATE PICTURE KEYWORD statement establishes a new keyword.

DELETE IS ON usage and cautions

DELETE IS ON provides a convenient means of deleting record elements that have been added to the dictionary with the COBOL substatement. Because the COBOL substatement automatically associates elements with records, elements associated with deleted records need not be maintained.

More information: For a detailed description of the COBOL substatement, see RECORD (REPORT/TRANSACTION).

To avoid the inadvertent deletion of elements, select DELETE IS ON only on an as-needed basis; immediately thereafter, specify DELETE IS OFF.

Overriding PREPARED BY and REVISED BY clauses

You can override the default PREPARED BY specification by including a PREPARED BY clause in individual ADD, MODIFY, REPLACE, DELETE, and DISPLAY/PUNCH statements.

You can override the default REVISED BY specification by including a REVISED BY clause in individual ADD, MODIFY, REPLACE, DELETE, and DISPLAY/PUNCH statements.

Overrides to PREPARED BY and REVISED BY clauses are recognized only if ALLOWED is specified in the USER SIGNON OVERRIDE clause.

Overriding SEQUENCE values

The user can include the following instructions within individual EDIT clauses to override the SET OPTIONS SEQUENCE value:

SEQUENCE overrides sequence default for all EDIT clause instructions.
INCREMENT BY in an INSERT or REPLACE instruction overrides, for that instruction only, the default established by the SET OPTIONS statement or by the SEQUENCE instruction.

Overriding the default PUNCH destination

The user can include a TO SYSPCH/MODULE clause within individual PUNCH statements to override the default PUNCH destination.

WHERE USED guidelines

WHERE USED must accompany a request to display SUBORDINATE ELEMENTS, PROGRAMS CALLED, RELATED FILES, ATTRIBUTES, USER-DEFINED NESTS, or WITHIN USER or WITHIN SYSTEM.

If WHERE USED is not specified, a request for SUBORDINATE ELEMENTS, PROGRAMS CALLED, RELATED FILES, ATTRIBUTES, USER-DEFINED NESTS, or WITHIN USER or WITHIN SYSTEM displays the programs called by, elements subordinate to, files, attributes, and user-defined nests related to, and users and systems within the requested entity occurrence.

For example, DISPLAY PROGRAM PAYROLL WITH PROGRAMS CALLED lists the programs called by the program named PAYROLL; DISPLAY PROGRAM PAYROLL WITH PROGRAMS CALLED WHERE USED lists the programs that call the program PAYROLL.

Overriding DISPLAY/PUNCH options

You can include these clauses in individual DISPLAY/PUNCH statements to override the specified options:

WITH/ALSO WITH/WITHOUT
VERB
AS SYNTAX/COMMENTS