Previous Topic: Setting DefaultsNext Topic: Integrated Data Dictionary Options


System Generation Options

Table 14 presents the options available during system generation and the statements that control the options. The system generation statement is ADD/MODIFY/DELETE OLQ.

Table 14. CA OLQ Options Set During System Generation

Option

Clause of the Statement

OLQ

INCLUDE/EXCLUDE AUTHORITY IS OLQ

Access to ASF tables, logical and database records, and sequential files

OLQ ACCESS TO OLQ

Access to SQL tables

OLQ ACCESS TO IDMS

PF key module

PFKEY MODULE IS qfile-name

Interrupt count

INTERRUPT COUNT IS 100/interrupt-count

Maximum interrupt count

MAXIMUM INTERRUPT COUNT IS 32767/maximum-interrupt-count

Menu mode

MENU MODE IS ALLOWED/DISALLOWED/ONLY

Report retention

REPORT RETENTION IS 1/retention-period/FOREVER

Maximum report retention

MAXIMUM REPORT RETENTION IS 5/max-report-retention/FOREVER

Size of report pages (in bytes)

REPORT FILE PAGE SIZE IS 4000/report-file-page-size

Maximum number of reports

MAXIMUM REPORT COUNT IS 5/maximum-report-count

Number of pages per report

MAXIMUM REPORT PAGES IS 5/maximum-report-pages

Maximum storage for sorts

MAXIMUM SORT STORAGE IS 100/max-sort-storage-size

Number of input lines

INPUT LINE SIZE IS 4/input-line-size

Continuation character

CONTINUATION CHARACTER IS '-'/continuation-character

Separator character

SEPARATOR CHARACTER IS '!'/separator-character

Comment character

COMMENT CHARACTER IS ';'/comment-character

Default report dictionary name

REPORT DICTNAME IS dictionary-name

Batch class

BATCH CLASS IS 0/batch-class

Special considerations for the options available during system generation are presented below.

Access to ASF tables:

You can create, replace, modify, and delete ASF tables.

You use the IDD DDDL source statement USER to set the access switch to OLQ:

OLQ ACCESS IS OLQ

OLQ is the default.

The OLQ setting also allows you to use the SELECT statement with the following entities:

Access to SQL tables:

You can create, replace, modify, and delete tables which are associated with an SQL schema.

You use the IDD DDDL source statement USER to set the access switch to IDMS:

OLQ ACCESS IS IDMS

Note:

PF key module:

You use the system generation statement ADD OLQ to define a qfile as the PF key module to be executed for each user issuing the CA OLQ task code. The intended use of the PF key module is to contain a series of CA OLQ SET FUNCTION commands that assign values to each of the PF keys in CA OLQ.

The specific clause of the ADD OLQ statement is:

PFKEY MODULE IS qfile-name

How to set interrupt:

The interrupt count interrupts processing after the specified number of CA OLQ database requests. You can set:

The system generation statements that set these defaults are:

ADD/MODIFY OLQ ...
INTERRUPT COUNT IS interrupt-count
MAXIMUM INTERRUPT COUNT IS max-interrupt-count

These statements set the default interrupt count and the default maximum interrupt for CA OLQ.

Access to menu mode:

Specify a user's access to menu mode with:

MENU MODE IS ALLOWED/NOT ALLOWED/ONLY

Users are automatically allowed to access command mode with the ALLOWED and NOT ALLOWED options. ONLY specifies that the user is allowed to access CA OLQ through menu mode only.

Maximum sort storage:

You can set the maximum amount of storage, in K bytes, that CA OLQ can use for sort operations. Specifying too low a value prevents CA OLQ from performing sort operations. Specifying too large a value degrades CV performance.

The system generation statement that sets this option is:

ADD/MODIFY OLQ ...
MAXIMUM SORT STORAGE IS 100/max-sort-storage-size

Number of input lines:

You can define the number of lines on the screen reserved for command input. The maximum number of lines defined by input-line-size is limited to the total number of lines on the screen minus the number of lines allocated for output.

Keep in mind that a large line size may be needed to comfortably code SELECT statements or multiple commands.

The system generation statement that sets this option is:

ADD/MODIFY OLQ ...
INPUT LINE SIZE IS 4/input-line-size

Continuation character:

To set the default continuation character during system generation, use the statement:

ADD/MODIFY OLQ ...
CONTINUATION CHARACTER IS -/continuation-character

Use the continuation character in qfiles and batch when the length of a CA OLQ command exceeds one line. You can also use the continuation character to continue commands (or a series of commands) across a pseudo-converse. Specify the continuation character at the end of each line to be continued.

Separator character:

The separator character is used to separate commands in the command input area. To set the default separator character during system generation, use the statement:

ADD/MODIFY OLQ ...
SEPARATOR CHARACTER IS !/separator-character

Comment character:

The comment character is used to separate commands from comments. Anything typed in after the comment character is considered to be a comment and is ignored by CA OLQ. Entering comments can be useful in documenting qfiles.

To set the default comment character during system generation, use the statement:

ADD/MODIFY OLQ ...
COMMENT CHARACTER IS ;/comment-character

Batch class:

Batch class is used to activate the CA OLQ batch interface. You can specify the print class used by CA OLQ when submitting batch jobs under z/OS. To specify the default print class during system generation, use the statement:

ADD/MODIFY OLQ ...
BATCH CLASS IS 0/batch-class

You should ensure that the specified class has been assigned to an internal reader.

For more information:

Batch Processing