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 byuser-id─┬────────────────────────┬─┘ └─ PASsword ispassword─┘ ►─┬─────────────────────────────────────────────────┬────────────────────────► └─ REVised byuser-id─┬────────────────────────┬─┘ └─ PASsword ispassword─┘ ►─┬──────────────────────┬───────────────────────────────────────────────────► └─ 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 ◄ ────────────────────────────────────────────────── └─ MODulemodule-name─┬───────────────────────────────────┬── └─ Version is ─┬─version-number─┬─┘ ├─ HIGhest ────────┤ └─ LOWest ─────────┘ ─►──────────────────────────────────────────────────────────────────────────┬─► ─────────────────────────────────────────────────────────────────────────┬┘ ─┬──────────────────────┬┬──────────────────────────────────────────────┬┘ └ LANguage islanguage┘└ PREpared byuser-id┬───────────────────────┬┘ └ PASsword ispassword─┘ ►─┬─────────────────┬────────────────────────────────────────────────────────► └─┬─ 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 arestart-column-numberTHRuend-column-number─┘ ►─┬─────────────────────────────────┬────────────────────────────────────────► └─ OUTput line size is ─┬─ 80 ──┬─┘ └─ 132 ─┘ ►─┬────────────────────────────┬─────────────────────────────────────────────► └─ JCL CODe is ─┬─ $ ──────┬─┘ └─ NULl ◄ ─┘ ►─┬───────────────────────────────────┬──────────────────────────────────────► └─ LEVel NUMbers arelevel-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 DICtionaryEstablishes 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 SESsionEstablishes 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 byuser-idEstablishes 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 ispasswordIdentifies the password assigned to the authorized user specified in the PREPARED BY clause.
- REVised byuser-idEstablishes 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 isSpecifies the site-standard decimal-point character to be used in ELEMENT, RECORD ELEMENT, and COBOL PICTURE and VALUE specifications.
- PERiodEstablishes the period (.) as the default decimal-point character. The DDDL compiler interprets periods as decimal points.
- COMmaEstablishes the comma (,) as the default decimal-point character. The DDDL compiler interprets commas as insertion characters.
- DELete isSpecifies whether elements are deleted or retained when the only record occurrence in which they participate is deleted.
- ONDeletes 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.
- OFFRetains 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 isSpecifies whether ADD statements that identify existing entity occurrences are accepted or rejected.
- ONAccepts 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.
- OFFRejects 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-keywordis 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 issequenceEstablishes the starting and increment values for line numbers associated with entries in record-element structures, comment text, and module source.Sequencemust be a 1 to 5 digit integer.
- BEFore isSpecifies whether text is to be printed before it is erased by an EDIT clause.
- ONSpecifies that text to be erased or replaced by an EDIT clause instruction is to be printed before it is erased.
- OFFSpecifies that text to be erased or replaced by an EDIT clause instruction isnotto 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 isSpecifies whether to print new text after it is inserted or replaced by an EDIT clause instruction.
- ONSpecifies that the new text to be inserted or replaced by an EDIT clause instruction is to be printed after it is inserted or replaced.
- OFFSpecifies that the new text to be inserted or replaced by an EDIT clause instruction isnotto 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 isSpecifies whether all instructions in an EDIT clause are resequenced after modification.
- ONSpecifies 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.
- OFFSpecifies that text to be modified by an EDIT clause instruction isnotto 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 isSpecifies sectionlines for accepting or rejecting programs based on whether they are defined in the dictionary.
- ONDirects CA IDMS DMLO precompilers to accept only programs defined in the dictionary (those represented by occurrences of the PROGRAM entity type in the dictionary).
- OFFDirects CA IDMS DMLO precompilers to accept any program.
- SECUrity forSpecifies 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.
- ADSSpecifies that only users with ADS authority can access CA ADS.
- CULpritSpecifies 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.
- OLQSpecifies 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 theCA OLQ Reference sectionfor further details.
- IDMsSpecifies 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-DCSpecifies 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 attributeSpecifies that only users with CLASS AND ATTRIBUTE authority can access occurrences of the ATTRIBUTE, CLASS, and user-defined entity types.
- IDDSpecifies 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 SIGnonSpecifies that only users with IDD SIGNON authority can sign on to the DDDL compiler.
- LOAd MODuleSpecifies 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 ONSpecifies (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 OFFSpecifies (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 isSpecifies whether users will be allowed to modify their own passwords.
- OFFSpecifies 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.
- ONSpecifies that users can modify their own passwords. To issue this clause, the user must be assigned AUTHORITY FOR UPDATE IS ALL.
- REGistration OVErrideTurns 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 isIndicates 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).
- ALLowedUsers may sign on to the compiler with a different user ID from the ID known to the execution environment anduser-specificationclauses may be used to override the default user ID. ALLOWED is the default. ON is a synonym for ALLOWED.
- NOT ALLowedCA 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-specificationclauses cannot be used to change the default user ID. OFF is a synonym for NOT ALLOWED.
- SEMicolon alternate end of sentence isIndicates whether the semicolon is to be recognized as an alternative end-of-statement character.
- ONSpecifies that both semicolons and periods are to be recognized as end-of-statement characters.
- OFFSpecifies that the semicolon isnotrecognized as an alternative end-of-statement character. OFF is the default.
- EOF isOverrides the default logical end-of-file indicator established at IDD installation.
- /*Indicates the default logical end-of-file indicator.
- eof-indicatorSpecifies an end-of-file indicator.
- OFF (online IDD only)Specifies that there is no active end-of-file indicator.
- FORMat isEstablishes the default format for DISPLAY/PUNCH verb output.
- FIXEDLists DISPLAY/PUNCH output in columnar format.
- FREELists DISPLAY/PUNCH output as running text.
- PUNch TOSpecifies the default destination for PUNCH verb output.
- SYSpchDirects PUNCH verb output to the SYSPCH file. SYSPCH is the default destination established during IDD installation.
- MODULEmodule-nameDirects PUNCH verb output to an IDD module.Module-namemust 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.
- LANguage islanguageSpecifies a language to be associated with the named module.
- PREpared byuser-idIdentifies 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.
- PROmptSpecifies 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 PROmptSpecifies no user prompt.
- ECHoRedisplays 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 ECHoSpecifies no redisplay of input lines even if the line contains an error. Suppresses execution of the EJECT and SKIP carriage control statements.
- LIStRedisplays each line read by the compiler.
- NO LIStSpecifies no redisplay of input lines unless a line contains errors. Suppresses execution of the EJECT and SKIP carriage control statements.
- HEAderSpecifies that the header lines that identify the DDDL compiler are to be printed on the IDD Activity List.
- NO HEAderSpecifies that the header lines that identify the DDDL compiler arenotto 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 pageline-countSpecifies the number of lines per page as a SET OPTIONS FOR SESSION option. The acceptable range forline-countis 10 through 60.
- CULprit AUTo ATTributes areFor CA Culprit users only, this parameter determines whether file definitions are copied from the dictionary by CA Culprit at runtime.
- ONSpecifies 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.
- OFFSpecifies that the file description isnotcopied from the dictionary at runtime.
- INPut columns arestart-column-numberTHRuend-column-numberSpecifies 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 forstart-column-numberandend-column-number; the minimum number of characters allowed between low and high columns is ten.
- OUTput line size isSpecifies an output line size for error messages. The line size for all other DDDL output is determined by the INPUT COLUMNS ARE clause.
- 80Specifies 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.
- 132Specifies an error message line size of 132 columns for the batch compiler.
- JCL CODe isSpecifies 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.
- NULlSpecifies 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 areSpecifies the values to be associated with corresponding hierarchical depths in record-element structures.
- level-numberSpecifies 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 isEstablishes a default version number for the VERSION parameter of the NAME clause in ADD statements.
- version-numberSpecifies that the DDDL compiler is to assign a new entity occurrence the specified version number;version-nmust be an integer in the range 1 through 9999.
- NEXt HIGhestSpecifies 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 compilerdoes notissue the ADD CHANGED TO MODIFY message.
- NEXt LOWestSpecifies 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 compilerdoes notissue the ADD CHANGED TO MODIFY message.
- DEFault for EXIsting Version isEstablishes a default version number to be used in any statement or clause that references an existing entity occurrence.
- version-numberSpecifies use of the specified version number;version-numbermust be an integer in the range 1 through 9999.
- HIGhestSpecifies use of the highest version number associated with the specified entity-occurrence name.
- LOWestSpecifies use of the lowest version number associated with the specified entity-occurrence name.
- DISplay ALL LIMit isIndicates whether the DDDL compiler will limit the number of records to be retrieved using a DISPLAY ALL statement.
- ONSpecifies 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.
- OFFSpecifies that the number of records retrieved by a DISPLAY ALL statement isnotlimited. OFF is the default.
- INTerrupt count isSpecifies the maximum number of records to be retrieved using a DISPLAY ALL statement when the DISPLAY ALL LIMIT is ON.
- maximum-record-countSpecifies a maximum number for INTERRUPT COUNT.Maximum-record-countcan be any number, including 0.
- NULlSets themaximum-record-countto 0.
- DISplaySupplies 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.
- WIThLists the requested information. All options specified in previously issued DISPLAY WITH and DISPLAY ALSO WITH statements are replaced.
- ALSo WIThLists the requested information in addition to any information requested in previously issued DISPLAY WITH and DISPLAY ALSO WITH statements.
- WITHOutExcludes the specified information from the information requested in previously issued DISPLAY WITH and DISPLAY ALSO WITH statements.
- ALLSpecifies the display of all of the information associated with the requested entity occurrence. ALL is the default.
- ALL COMment TYPesSpecifies 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.
- AREasSpecifies the display of all database areas associated with the requested entity occurrence.
- ATTributesSpecifies the display of all attributes associated with the requested entity occurrence.
- COBolSpecifies the display of record elements associated with the requested record occurrence displayed in COBOL format. This parameter applies only to RECORD entities.
- COMmentsSpecifies the display of all comments associated with the requested entity occurrence.
- CULprit headersSpecifies the display of all RIT headers associated with the requested record element. This parameter applies to record elements only.
- DEFinitionsSpecifies the display of all definitions associated with the requested entity occurrence.
- DEStinationsSpecifies the display of all destinations associated with the requested entity occurrence.
- DETailsSpecifies the display of entity-specific descriptions; for example, the length of a record or the block size of a file.
- ELementsSpecifies the display of all elements associated with the requested entity occurrence.
- ENTRy pointsSpecifies the display of all entry points associated with the requested entity occurrence.
- FILesSpecifies the display of all files associated with the requested entity occurrence.
- HIStorySpecifies 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.
- LINesSpecifies the display of all lines associated with the requested entity occurrence.
- LOGical-terminalsSpecifies the display of all logical terminals associated with the requested entity occurrence.
- LRSSpecifies the display of all of the logical records associated with the requested program. This parameter only applies to PROGRAM entities.
- MAPSSpecifies the display of all maps associated with the requested entity occurrence.
- MODulesSpecifies the display of all modules, processes, q-files, or tables associated with the requested entity occurrence.
- MODules ONLyOptionally limits the list to modules with a language specification other than PROCESS, OLQ, or TABLE.
- MODule SOUrceSpecifies 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.
- NONESpecifies the display of the name of the requested entity occurrence. NONE is meaningful only when WITH is specified.
- OLQ headersSpecifies the display of all CA OLQ headers associated with the requested record element. This parameter applies to record elements only.
- PANelsSpecifies the display of all panels (screens) associated with the requested entity occurrence. SCREENS is a synonym for PANELS.
- PHYsical-terminalsSpecifies the display of all physical terminals associated with the requested entity occurrence. PTERMS is a synonym for physical-terminals.
- PICture OVErridesSpecifies 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.
- PROCessesSpecifies the display of all processes associated with the requested entity occurrence.
- PROgramsSpecifies the display of all programs associated with the requested entity occurrence.
- PROgrams CALledSpecifies the display of all of the subprograms associated with the requested program. This parameter applies to PROGRAM entities only.
- QFIlesSpecifies the display of all q-files associated with the requested entity occurrence.
- QUEuesSpecifies the display of all queues associated with the requested entity occurrence.
- RECELemsSpecifies the display of record detail information and all record elements associated with the requested record occurrence. This parameter applies only to RECORD entities.
- RECordsSpecifies the display of all records associated with the requested entity occurrence.
- RELated FILesSpecifies the display of all of the relationships created with the RELATED FILES ARE clause of the FILE statement for the requested file.
- REMarksSpecifies the display of all remarks associated with the requested program. This parameter applies to PROGRAM entities only.
- REPortsSpecifies the display of all reports associated with the requested entity occurrence.
- SAMe ASSpecifies 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.
- SCHemasSpecifies the display of all schemas associated with the requested entity occurrence.
- SETsSpecifies the display of all sets associated with the requested entity occurrence.
- SUBOrdinate ELementsSpecifies the display of all of the subordinate elements associated with the requested group element. This parameter applies to ELEMENT entities only.
- SUBSChemasSpecifies the display of all subschemas associated with the requested entity occurrence.
- SYNonymsSpecifies 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.
- SYStemsSpecifies the display of all systems or subsystems associated with the requested entity occurrence. SYSTEMS and SUBSYSTEMS are synonyms.
- TABlesSpecifies the display of all tables associated with the requested entity occurrence.
- TASksSpecifies the display of all tasks associated with the requested entity occurrence.
- TRAnsactionsSpecifies the display of all transactions associated with the requested entity occurrence.
- USErsSpecifies the display of all users associated with the requested entity occurrence.
- USEr DEFINED COMmentsSpecifies 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 NEStsSpecifies 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 USEDSpecifies 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 SYStemSpecifies 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 USErSpecifies 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/DELeteSpecifies the default verb to accompany DISPLAY/PUNCH verb output.
- AS SYNtaxSpecifies 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 COMmentsSpecifies 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 |