About SET OPTIONS

The SET OPTIONS statement controls DDDL compiler processing options. The user can supply default processing options for the current dictionary or for the current DDDL session. This article describes the following information about the SET OPTIONS statement:
idmscu19
The SET OPTIONS statement controls DDDL compiler processing options. The user can supply default processing options for the current dictionary or for the current DDDL session. This article describes the following information about the SET OPTIONS statement:
 
 
2
 
2
 
 
Functions
The SET OPTIONS statement allows you to perform the functions shown in the following table.
 
To do this
 
 
Use this SET OPTIONS clause
 
Specify dictionary security options
PREPARED BY
REVISED BY
SECURITY FOR
PASSWORD SECURITY OVERRIDE
REGISTRATION OVERRIDE
USER SIGNON OVERRIDE
Set a site-standard quote character
QUOTE
Set a site-standard decimal point character
DECIMAL-POINT
Specify maintenance conventions for entity-occurrences
DELETE
DEFAULT
Establish keywords that identify alternative formats(up to four) for element occurrences
ALTERNATE PICTURE KEYWORD
Direct the text editor of the batch DDDL compiler
SEQUENCE
BEFORE
AFTER
RESEQUENCE
Set input and output formats for online and batch processing
PROMPT/NO PROMPT
ECHO/NO ECHO
LIST/NO LIST
HEADER/NO HEADER
LINES PER PAGE
INPUT COLUMN
OUTPUT LINE SIZE
JCL CODE
Specify whether DML precompilers are to accept undefined programs at runtime
AUTHORIZATION IS ON/OFF
Specify whether CULPRIT is to copy file definitions from the dictionary at runtime
CULPRIT AUTO ATTRIBUTES
Specify default level numbers for elements that participate in record-element structures
LEVEL NUMBERS
Establish default version numbers
DEFAULT FOR NEW VERSION
DEFAULT FOR EXISTING VERSION
Control DISPLAY/PUNCH output
PUNCH TO
FORMAT
DISPLAY ALL LIMIT
INTERRUPT COUNT
DISPLAY WITH/ALSO WITH/WITHOUT
DISPLAY AS SYNTAX/COMMENTS
DISPLAY VERB
Establish a default end-of-file indicator for use with the online DDDL compiler
EOF
Establish recognition of an alternative end-of-statement character
SEMICOLON ALTERNATE
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 sectionlines 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 section
     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.
  •  
    USEr 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 sectionlines
 
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
Defaults and Overrides
The IDD installation procedure establishes defaults for most of the DDDL compiler processing options. These defaults remain in effect until they are explicitly changed for one of the following:
  •  
    Dictionary
     -- you can specify a SET OPTIONS FOR DICTIONARY statement to establish default options for all DDDL compiler sessions that access the current dictionary.
     Any option you can specify under SET OPTIONS FOR DICTIONARY you can also specify under SET OPTIONS FOR SESSION.
  •  
    Single session
     -- you can specify a SET OPTIONS FOR SESSION statement to establish default options for the current DDDL session only.
     If you try to use SET OPTIONS FOR DICTIONARY when only SET OPTIONS FOR SESSION is permitted, IDD applies the option to your current session.
  •  
    Single statement
     -- you can specify optional clauses in an entity-type statement to establish processing options for that statement only.
The following table lists DDDL compiler processing options, their installation default values, and the ways you can change the defaults. Installation defaults are for batch and online processing, unless otherwise noted.
 
SET OPTIONS
clause
 
 
Default
 
 
 Overrides possible for:
 
 
 
 
Dictionary
 
 
Session
 
 
Statement
 
AFTER IS
OFF
X
X
X
AUTHORIZATION IS
OFF
X
 
 
BEFORE IS
OFF
X
X
X
CULPRIT AUTO ATTRIBUTES ARE
OFF
X
 
 
DECIMAL- POINT IS PERIOD/COMMA
PERIOD
X
X
 
DEFAULT FOR EXISTING VERSION IS
1
X
X
X
DEFAULT FOR NEW VERSION IS
1
X
X
X
DEFAULT IS
OFF
X
X
 
DELETE IS
OFF
X
X
 
DISPLAY ALL LIMIT
OFF
X
X
 
DISPLAY AS SYNTAX/ COMMENTS
COMMENTS
 
X
X
DISPLAY WITH/ ALSO WITH/ WITHOUT
WITH ALL
 
X
X
DISPLAY VERB
ADD
 
X
X
ECHO/NO ECHO
ECHO
 
X
 
EOF IS
/* (batch)
X
X
 
FIRST/SECOND/
THIRD/FOURTH
ALTERNATE
PICTURE
KEYWORD
No defaults
X
X
 
FORMAT IS FIXED/FREE
FREE
 
X
X
HEADER/ NO HEADER
HEADER (batch)
NO HEADER (online)
 
X
 
INPUT COLUMNS ARE
1-72 (batch)
1-80 (online)
 
X
 
INTERRUPT COUNT IS
0
X
X
X
JCL CODE IS
NULL
 
X
 
LEVEL NUMBERS ARE
02-49
X
X
 
LINES PER PAGE
60
 
X
 
LIST/NO LIST
LIST
 
X
 
OUTPUT LINE SIZE IS
132 (batch)
80 (online)
 
X
 
PASSWORD SECURITY OVERRIDE
OFF
X
 
 
PREPARED BY/ REVISED BY
No defaults
 
X
X
PROMPT/ NO PROMPT
NO PROMPT (batch)
NO PROMPT
(online; 3270)
PROMPT
(online; line mode)
 
X
 
PUNCH TO
SYSPCH
 
X
X
QUOTE IS
'
X
X
 
RESEQUENCE IS
OFF
X
X
 
REGISTRATION OVERRIDE
No default
 
X
 
SECURITY FOR
OFF
X
X
 
SEMICOLON ALTERNATE
OFF
X
X
 
SEQUENCE IS
100
X
X
X
USER SIGNON OVERRIDE
ON
X
X
 
 
Overriding Clauses
 
The following DDDL clauses override defaults established by the SET OPTIONS FOR SESSION statement:
  • The PREPARED/REVISED BY clause of ADD/MODIFY/REPLACE/DELETE/DISPLAY/PUNCH
  • The SHOW instruction of the EDIT clause
  • The SEQUENCE instruction of the EDIT clause
  • The INCREMENT BY parameter of the INSERT and REPLACE instruction of the EDIT clause
  • The WITH/ALSO WITH/WITHOUT clause of DISPLAY/PUNCH
  • The VERB clause of DISPLAY/PUNCH
  • The AS SYNTAX/COMMENTS clause of DISPLAY/PUNCH
  • The TO clause of PUNCH
  • The VERSION clause of ADD/MODIFY/REPLACE/DELETE/DISPLAY/PUNCH
Security
You must have explicit update authority to submit certain SET OPTIONS clauses. The following table lists the applicable clauses and the required authority.
 
SET OPTIONS clause
 
 
Required UPDATE authority
 
SET OPTIONS FOR DICTIONARY
ALL
FIRST/SECOND/THIRD/FOURTH
ALTERNATE PICTURE KEYWORD
ALL
CULPRIT AUTO ATTRIBUTES
CULPRIT
REGISTRATION OVERRIDE
ALL
PASSWORD SECURITY OVERRIDE
ALL
SECURITY FOR ADS
ALL
SECURITY FOR CLASS AND
ATTRIBUTE
CLASS AND ATTRIBUTE
SECURITY FOR CULPRIT
CULPRIT
SECURITY FOR IDD
IDD
SECURITY FOR IDD SIGNON
IDD SIGNON
SECURITY FOR IDMS
IDMS
SECURITY FOR IDMS-DC
DC
SECURITY FOR LOAD MODULE
ALL
SECURITY FOR OLQ
OLQ
USER SIGNON OVERRIDE
ALL
DISPLAY ALL LIMITS
ALL
INTERRUPT COUNT
ALL