Previous Topic: SyntaxNext Topic: Usage


Parameters

SET OPTions for session

Establishes the defaults that govern a single session. All other executions of the compiler are unaffected by the options specified in this statement.

DECimal-point is COMma

Designates a comma as the character that represents a decimal point in DDL source statements.

When DECIMAL-POINT IS COMMA is in effect, a comma (,) is interpreted as a decimal point, and a period (.) is interpreted as an insertion character.

DECimal-point is PERiod

Designates a period as the character that represents a decimal point in DDL source statements.

When DECIMAL-POINT IS PERIOD is in effect, a period is interpreted as a decimal point, and a comma is interpreted as an insertion character.

DEFault is ON

Specifies that the compiler will accept ADD statements that identify established components and will interpret them as MODIFY statements. A warning message is issued when this occurs.

DEFault is OFF

Specifies that the compiler will not accept ADD statements that identify established components. The compiler issues an error message and terminates processing of the statement in error.

DEFault for EXIsting Version is

Establishes a default version number for existing schemas, records, programs, and source modules named in DDL statements. If a statement identifies an existing schema, record, or program without a version number, the compiler treats the statement as though it were coded with a VERSION clause in the format specified in the DEFAULT FOR EXISTING VERSION option. Version numbers must fall within the range 1 through 9999, whether specified explicitly or in relation to existing versions.

version-number

Specifies an explicit version number and must be an unsigned integer in the range 1 through 9999. If a subsequent DDL statement references an existing schema, record, or program without including a version number, the compiler selects the version number specified by version-number.

HIGhest

Specifies the highest existing version number for the named schema, record, or program. If a subsequent DDL statement references an existing schema, record, or program without including a version number, the compiler selects the highest existing version number for that schema, record, or program.

LOWest

Specifies the lowest existing version number for the named schema, record, or program. If a subsequent DDL statement references an existing schema, record, or program without including a version number, the compiler selects the lowest existing version number for that schema, record, or program.

DEFault for NEW Version is

Establishes a default version number for schemas being added to the dictionary. If an ADD SCHEMA statement names a schema without a version number, the compiler treats the statement as though it were coded with a VERSION clause in the format specified in the DEFAULT FOR NEW VERSION option. Version numbers must fall within the range 1 through 9999, whether specified explicitly or in relation to existing versions.

version-number

Specifies an explicit version number and must be an unsigned integer in the range 1 through 9999. If a subsequent ADD SCHEMA statement names a schema without including a version number, the compiler assigns the version number specified by version-number.

next HIGhest

Specifies the highest version number assigned to schema-name plus one. If a subsequent ADD SCHEMA statement names a schema without including a version number, the compiler assigns the highest existing version number for that schema name plus one.

next LOWest

Specifies the lowest version number assigned to schema-name minus one. If a subsequent ADD SCHEMA statement names a schema without including a version number, the compiler assigns the lowest existing version number for that schema name minus one.

DELete is ON

Turns on an option to automatically delete version 1 of a subschema load module when the subschema is deleted.

DELete is OFF

Turns off an option to automatically delete version 1 of a subschema load module when the subschema is deleted. OFF is the default.

DISplay ALL LIMit is ON

Limits the number of entity occurrences read for a DISPLAY ALL request by the value specified in the INTERRUPT COUNT clause.

DISPLAY ALL LIMit is OFF

Does not limit the number of entity occurrences read for a DISPLAY ALL request. OFF is the default.

ECHo

Specifies that the compiler lists every line it reads (note that lines beginning with *+ are not echoed). Online, input is redisplayed; in batch mode, input appears in the compiler's activity listing.

NO ECHo

Specifies the compiler does not list input lines, whether or not a line contains an error. This option is intended for commands that are submitted 1 line at a time (for example, under TSO local, z/VM local, or from a hard-copy terminal).

EOF is

Designates the 2-character logical end-of-file indicator to be honored by the compiler. When the compiler encounters the indicator coded in the first 2 columns of the input range, it recognizes only the DDL statements that precede the indicator and does not process DDL statements that follow it.

/*

Is the default end-of-file indicator.

'eof-indicator'

Is a 2-character value enclosed in quotes.

OFF

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

HEAder

(Batch only) Specifies that a heading line identifying the compiler is to appear on the compiler activity listing.

NO HEAder

(Batch only) Specifies that no heading line identifying the compiler is to appear on the compiler activity listing.

INPut columns are

Specifies the input range. The compiler reads, in subsequent input lines, only those columns that fall between start-column-number and end-column-number, inclusive; all other columns are ignored. Start-column-number and end-column-number must be at least 10 columns apart. The default and maximum ranges depend on the mode in which the compiler is used:

INTerrupt COUnt is interrupt-count

Specifies the number of entity occurrences CA IDMS/DB will read for a DISPLAY ALL request when you specify DISPLAY ALL LIMIT IS ON. Interrupt-count is an integer in the range 0 through 32768.

INTerrupt COUnt is NULL

Sets to 0 (zero) the number of entity occurrences CA IDMS/DB will read for a DISPLAY ALL request when you specify DISPLAY ALL LIMIT IS ON. If you attempt to issue a DISPLAY ALL statement when the interrupt count is null (0), CA IDMS/DB will reject the command. NULL is the default.

LISt

Specifies that the compiler lists every line it reads. LIST performs the same function as ECHO.

NO LISt

Specifies that the compiler lists only lines containing errors.

LINes per page is line-count

Establishes the number of lines per page for a terminal display or batch activity listing. Line-count is an integer in the range 10 through 60. The default is 60.

OUTput line size is

Specifies the width of the terminal display or batch activity listing. The online default is 80; the batch default is 132. Note that with an output line size of 80, error messages do not provide the line numbers of lines in error; the error message, however, will immediately follow the line in error.

user-specification

Establishes the default user for the user-specification clause in the SCHEMA and SUBSCHEMA statements and can be overridden in those statements.

Note: Expanded syntax for user-specification is presented in Chapter 13, “Parameter Expansions”.

If this clause is not used, user-id defaults to the user ID known to the DC/UCF system (online compiler) or the user ID known to the batch environment (batch compiler).

PROmpt

Indicates that the compiler will prompt the user for each new line of input when entering DDL source statements line by line (rather than in full-screen mode), as shown in the following example:

ENTER

Note that this option is operational in batch execution, where PROMPT causes the prompt to precede each statement in the compiler's activity listing.

NO PROmpt

Indicates that the compiler will not prompt the user for each new line of input when entering DDL source statements line by line (rather than in full-screen mode).

PUNch TO module-specification

Specifies that punched output will be directed to the named module in the dictionary. The user can override this default in individual PUNCH statements.

Note: Expanded syntax for module-specification is presented in Chapter 13, “Parameter Expansions”.

PUNCH to SYSpch

Specifies that punched output will be directed to the system punch file. SYSPCH is the default destination established during installation. The user can override this default in individual PUNCH statements.

QUOte is '/"

Designates a single (') or double (") quote as the quote character in effect for the session. Once set, the selected character must be used in DDL source statements wherever a quotation mark is required.

REGistration OVErride

Turns off schema or subschema security for the session. The user who specifies REGISTRATION OVERRIDE can modify, delete, display, and punch all schemas and subschemas, even those whose accessibility otherwise is limited by a PUBLIC ACCESS clause.

SEMicolon alternate end of sentence is ON/OFF

Designates that the schema and subschema compilers will (ON) or will not (OFF) recognize both a semicolon and period as an end of statement terminator. OFF, the default, indicates that the compilers will treat a semicolon as a blank character.

SEQuence is sequence-number

Specifies the starting and incremental value for the line numbers to be assigned to record elements and to lines of comment text. Sequence-number must be a 1- to 5-digit unsigned integer.

Sequence numbers assigned to record elements are insignificant within the schema compiler itself; however, you can refer to an element by its sequence number when using IDD to modify a record description.

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.

DISplay display-options

Sets the defaults that govern the output produced by subsequent DISPLAY or PUNCH statements. The defaults established with this clause can be overridden in individual DISPLAY and PUNCH statements.

WITh

Instructs the compiler to include the specified types of information in output produced by DISPLAY/PUNCH statements.

ALSo WITH

Instructs the compiler to include the specified types of information in output produced by DISPLAY/PUNCH statements in addition to those currently in effect (either through the SET OPTIONS statement or as set in the individual DISPLAY or PUNCH statement).

WITHOut

Instructs the compiler to exclude the specified types of information in output produced by DISPLAY/PUNCH statements.

ALL COMment TYPes

Displays or punches all comment entries (COMMENT, CULPRIT HEADERS, OLQ HEADERS, DEFINITIONS) associated with the schema or subschema.

AREas

Displays or punches all areas in the schema or subschema.

ATTributes

Displays or punches all attributes, and their respective classes, associated with the schema or the subschema.

COMments

Displays or punches comments associated with the schema, schema record, subschema, or logical record.

CULprit headers

Displays or punches all CA Culprit headers for schema elements, when schema record elements are displayed.

DEFinitions

Displays or punches all definitions associated with the subschema.

DETails

Displays or punches details of the component. The details vary depending on the component; they are presented with the syntax for each schema and subschema statement.

ELements

When records for the schema are displayed, displays or punches all elements in COBOL format; when records in the subschema are displayed, all elements included in the subschema definition of the record.

HIStory

Displays or punches the date and time that the schema or subschema was created and/or last modified and the name of the user who created or last modified the schema or subschema.

LRS

Displays or punches all logical records in the subschema.

OLQ headers

Displays or punches all CA OLQ headers for schema elements, when schema record elements are displayed.

PATh-groups

Displays or punches all logical-record path groups in the subschema.

PROgrams

Displays or punches all programs associated with the subschema.

RECords

Displays or punches all database records and elements in the schema or subschema.

SCHemas

Displays or punches the schema related to the displayed or punched schema through the DERIVED FROM option of the SCHEMA statement.

SETs

Displays or punches all sets in the schema or subschema.

SHAred structures

Displays or punches the SHARE STRUCTURE clause of a schema record as syntax and the record's elements as comments.

SUBschemas

Displays or punches all subschemas related to the displayed or punched schema.

SYMbols

Displays or punches all symbols associated with the schema.

SYNonyms

When records for the schema are displayed, displays or punches all record synonyms associated with the schema; when record elements also are displayed, the record and element synonyms associated with the schema.

USEr DEFINED COMments/(UDCS)

Displays or punches all user-defined comment keys associated with the schema and subschema.

USErs

Displays or punches all users associated with the schema or subschema.

ALL

Displays or punches all the information associated with the displayed component. WITH ALL is the default for the DISPLAY clause of the SET OPTIONS statement.

NONE

Displays or punches only the information that uniquely identifies the component: component name; component version, if any; and, for subschemas only, the name and version of the associated schema. Note that NONE is meaningful only when WITH is specified.

VERB

Sets the default for the verb with which the statements are to be produced as the output of DISPLAY and PUNCH statements. For example, if VERB ADD is specified, the output of a later DISPLAY RECORD statement is an ADD RECORD statement; if VERB DELETE is specified, the output of a later DISPLAY RECORD statement is a DELETE RECORD statement; and so on.

The user can override this default in individual DISPLAY and PUNCH statements.

AS COMments

Instructs the compiler to list output produced by a DISPLAY or PUNCH statement in comment format (each line begins with the characters *+). These comment characters specify that the line is not to be redisplayed as a function of the ECHO or LIST options.

AS SYNtax

Instructs the compiler to list output produced by a DISPLAY or PUNCH statement in syntax format. Display output AS SYNTAX when you plan to resubmit some or all of the displayed statements to the compiler (for example, when using an existing component description as a template for a new component).

for SESsion

Displays or punches the current options in effect for the session, whether defaulted from installation, set in the dictionary by IDD, or set for the session with the DDL compiler SET OPTIONS statement. FOR SESSION is the default.

for DICtionary

Displays or punches the current options for the dictionary. These options default across sessions. The display does not list options that are only in effect for the session. Dictionary options are set with SET OPTIONS FOR DICTIONARY in the IDD DDDL compiler.

WITh DETails

Specifies that the session or dictionary options are displayed. WITH must be specified to display the options if SET OPTIONS FOR SESSION DISPLAY WITHOUT DETAILS was specified.

WITHOut DETails

Specifies that the session or dictionary options are not displayed.