Previous Topic: ADSO Statement SyntaxNext Topic: ADSO Statement Usage


ADSO Statement Parameters

ACTivity log is

Requests the CA ADS dialog compiler to perform activity logging for database commands in a dialog. Database activity records document potential dialog database activity and are stored in the dictionary when the dialog is generated.

YES

Enables activity logging.

YES is the default when you omit the ACTIVITY LOG parameter from the ADSO statement.

NO

Specifies no activity logging is performed.

ADStask is task-code-a

Specifies the task code used to invoke the CA ADS runtime system. Task-code must be a task code that invokes the program ADSORUN1, as defined in the data dictionary with a TASK statement. The default is ADS.

ADS2task is task-code

Specifies the secondary task code used to invoke the CA ADS runtime system when not running under the CA IDMS Transfer Control Facility (TCF). (The ADS2TCF parameter, described below, defines the secondary task code under TCF.) This task code is used internally by CA ADS and will never be entered by the terminal operator.

Task-code must be a task code that invokes the program ADSOMAIN, as defined in the data dictionary with a TASK statement. The default is ADS2.

ADS2TCf task is task-code

Specifies the secondary task code used to invoke the CA ADS runtime system while running under TCF. This task code is used internally by CA ADS and will never be entered by the terminal operator.

Task-code must be a task code that invokes the program ADSOMAIN, as defined in the data dictionary with a TASK statement. The default is ADS2U.

AUTODialog is dialog-name

Specifies a dialog to be initiated automatically when the terminal operator invokes the CA ADS runtime system but does not enter a dialog name or ADSA application task code.

Dialog-name must be the name of a mainline dialog accessible to the terminal operator at runtime.

AUTOStatus is

Specifies the default AUTOSTATUS setting for dialog generation sessions.

YES

Enables AUTOSTATUS for all dialogs at the beginning of a dialog generation session.

YES is the default when you omit the AUTOSTATUS parameter from the ADSO statement.

NO

Disables AUTOSTATUS at the beginning of a dialog generation session.

OPTional

Allows the application developer to override the default AUTOSTATUS setting during dialog generation.

OPTIONAL is the default when you specify neither OPTIONAL nor MANDATORY in the AUTOSTATUS parameter of the ADSO statement.

MANdatory

Prevents the application developer from changing the default AUTOSTATUS setting during dialog generation.

COBol MOVe is

Defines the treatment of numeric values placed into alphanumeric fields by arithmetic and assignment commands. The COBOL MOVE parameter assigns the default option displayed on the CA ADS dialog compiler Dialog Options screen.

YES

Indicates that CA ADS automatically moves the result of an arithmetic or assignment command into the target field according to standard COBOL rules.

NO

Indicates that CA ADS automatically moves the result of an arithmetic or assignment command into the target field according to standard CA ADS rules.

NO is the default when you omit the COBOL MOVE parameter from the ADSO statement.

OPTional

Indicates the application developer can change the COBOL MOVE setting on a dialog-by-dialog basis.

MANdatory

Indicates the application developer cannot change the COBOL MOVE setting on a dialog-by-dialog basis.

Note: For more information about the COBOL MOVE parameter, see the CA ADS Reference Guide.

COMment DELimiter is ‘adso-comment-delimiter’

Specifies the character to be used as the comment delimiter. adso-comment-delimiter must be a single character enclosed in single quotes.

Default: An exclamation mark (‘!’)

DIAGnostic screen is

Controls the display of the Dialog Abort Information screen when the CA ADS runtime system detects an abend condition in an executing dialog.

YES

Indicates that CA ADS will display the Dialog Abort Information screen and will write error messages to the system log.

YES is the default when you omit the DIAGNOSTIC SCREEN parameter from the ADSO statement.

NO

Indicates that CA ADS will not display the Dialog Abort Information screen. When the runtime system terminates an abending dialog, CA ADS writes error messages to the system log and displays the following to the terminal operator:

ERROR OCCURRED DURING PROCESSING. CA ADS
DIALOG ABORTED.
DIAlog STAtistics

Specifies whether dialog statistics will be collected for CA ADS dialogs.

Note: Users can override DIALOG STATISTICS parameter options at runtime by means of the DCMT VARY ADSO STATISTICS command. DCMT commands are described in CA IDMS System Tasks and Operator Commands Guide.

Note: CA ADS/Batch dialog statistics collection is enabled by means of the ADSOBSYS utility.

ON

Indicates that dialog statistics and application overhead activity statistics are collected.

CA ADS dialog statistics are collected only if transaction statistics collection is enabled.

SELected

Enables statistics collection for dialogs on a dialog-by-dialog basis in conjunction with the DIALOG STATISTICS parameter of the PROGRAM statement (described in PROGRAM Statement.)

ALL

Enables statistics collection for all dialogs.

CHEckpoint interval is

Specifies the frequency with which dialog statistics are written to the system log file. The checkpoint interval is based on the number of times statistics are accumulated for any dialog.

checkpoint-interval

Specifies that dialog statistics are written to the log file after being accumulated the indicated number of times.

Checkpoint-interval must be an integer in the range 0 through 32,767. The default is 200. A value of 0 is synonymous with NULL.

NULL

Specifies that no checkpoint interval applies and that statistics records are written to the log file after an application terminates.

OFF

Indicates that no dialog statistics will be collected.

OFF is the default when you omit the DIALOG STATISTICS parameter from the ADSO statement.

Note: For more information about dialog statistics, see the System Operations Guide.

FASt mode threshold is

Specifies the point at which the CA ADS runtime system is to write record buffer blocks (RBBs) and statistics control blocks to the scratch area (DDLDCSCR) of the data dictionary across a pseudo-converse. If the total size, in bytes, of the RBBs and statistics control blocks in all storage pools exceeds the fast mode threshold (specified in bytes), and if the ADSO statement specifies RESOURCES ARE FIXED, the system writes the RBBs and statistics control blocks to scratch.

Note: If the ADSO statement specifies RESOURCES ARE RELOCATABLE, the system writes RBBs and statistics control blocks to scratch across a pseudo-converse regardless of the FAST MODE THRESHOLD specification.

fast-mode-threshold

Specifies the fast mode threshold in bytes.

Fast-mode-threshold must be an integer in the range 0 through 2,147,483,647. The default is 6,000.

0 directs the system always to write RBBs and statistics control blocks to scratch across a pseudo-converse.

OFF

Directs the system never to write RBBs and statistics control blocks to scratch across a pseudo-converse if the ADSO statement specifies RESOURCES ARE FIXED.

MAXimum LINks is max-link-count

Specifies the maximum number of dialog levels that can be established by each CA ADS application thread.

Max-link-count must be an integer in the range 0 through 9,999. The default is 10.

The value specified for max-link-count should be equal to at least 3. A value of 5 is sufficient for most systems.

Important! Some CA products are CA ADS applications. Specifying too low a value for the MAXIMUM LINKS parameter will affect the performance of these products.

MENu is

Controls the display of mainline dialogs on the CA ADS runtime system Dialog Selection screen.

USEr

Specifies that CA ADS will display a mainline dialog on the menu screen only if the user holds the authority to execute the dialog.

For more information about security, see the CA IDMS Security Administration Guide.

USER is the default when you omit the MENU parameter from the ADSO statement.

ALL

Specifies that CA ADS will display all mainline dialogs on the menu screen.

KEEP

Directs CA ADS to save the menu screen across pseudo-converses. If you do not specify KEEP, CA ADS rebuilds the menu screen each time it is displayed.

NEWpage mapout is

Specifies how CA ADS is to perform a mapout when a dialog's map is already displayed as the result of a previous mapout.

YES

Indicates that CA ADS will always perform a new page mapout, mapping out literal fields as well as data, message, and page fields.

NO

Indicates that CA ADS will transmit only the map's data fields, message field, and page field (pageable maps only). A new page mapout that includes literal fields will occur, however, if problems have occurred or if the terminal operator has pressed the CLEAR key prior to the last mapin.

NO is the default when you omit the NEWPAGE MAPOUT parameter from the ADSO statement.

Note: If the BACKSCAN option is enabled for any of the map's data fields, data from the previous mapout may remain in the fields.

PRImary pool is primary-buffer-size

Specifies the size, in bytes, of the primary buffer. The primary buffer is acquired at runtime for any CA ADS dialog that uses a database, map, subschema, logical, or work record and is used to hold those records. The primary buffer can be allocated from storage pool 0 or from an XA storage pool if one is defined. The LOCATION parameter on the ADS task statement determines where storage is allocated. Storage can be obtained from pool 0 or an XA storage pool when LOCATION=ANY is specified. LOCATION=BELOW gets storage from pool 0. If the primary buffer becomes full, CA ADS allocates storage for a secondary buffer, also determined by the LOCATION parameter (see the SECONDARY POOL parameter).

Primary-buffer-size must be an integer in the range 0 through 2,147,483,647; the default is 4,000.

Note: The size of the primary buffer for CA ADS/Batch dialogs is specified by the ADSOBSYS utility.

RECord COMpression is

Specifies whether record buffer blocks (RBBs) are compressed across a pseudo-converse when they are retained in the storage pool.

ON

Specifies that RBBs are compressed across a pseudo-converse and restored at the end of the pseudo-converse.

OFF

Specifies that RBBs are not compressed across a pseudo-converse.

OFF is the default when you omit the RECORD COMPRESSION parameter from the ADSO statement.

RESources are

Specifies whether storage used by the CA ADS runtime system is eligible for writing to the scratch area (DDLDCSCR) of the data dictionary across a pseudo-converse.

FIXed

Indicates that:

  • Storage used for record buffer blocks (RBBs) and statistics control blocks is written to scratch across a pseudo-converse only when the fast mode threshold is exceeded. You use the ADSO statement FAST MODE THRESHOLD parameter (described above) to establish a fast mode threshold.
  • Storage used for currency blocks, CA ADS terminal blocks (OTBs), OTB extensions, and variable dialog blocks (VDBs) is not eligible for writing to scratch.
RELocatable

Indicates that:

  • Storage used for RBBs and statistics control blocks is always written to scratch across a pseudo-converse, regardless of the relocatable threshold.
  • Storage used for currency blocks, OTBs, OTB extensions, and VDBs is written to scratch across a pseudo-converse only when the relocatable threshold is exceeded.

You use the RELOCATABLE THRESHOLD parameter of the SYSTEM statement to define a relocatable threshold for the primary storage pool.

You use the RELOCATABLE THRESHOLD parameter of the system generation STORAGE POOL and XA STORAGE POOL statements to define relocatable thresholds for secondary storage pools.

The SYSTEM statement is described in SYSTEM Statement.

The STORAGE POOL and XA STORAGE POOL statements are described later in this section.

SECondary pool is secondary-buffer-size

Specifies the size, in bytes, of the secondary buffer. When the primary buffer becomes full, the secondary buffer is allocated either from the DC/UCF system storage pool 0 or from the XA storage pool (see the PRIMARY POOL parameter above). If the secondary buffer becomes full, the CA ADS system allocates additional secondary buffers as necessary.

Secondary-buffer-size must be an integer in the range 0 through 2,147,483,647. The default is 2,000.

Note: The size of the secondary buffer for CA ADS/Batch dialogs is specified by the ADSOBSYS utility.

STAtus definition record is status-definition-record-name

Specifies the default status definition record used by both CA ADS and CA ADS/Batch dialogs to reference error-status values returned by executing dialogs.

Status-definition-record-name must be the name of a status definition record previously defined in the data dictionary. The default is ADSO-STAT-DEF-REC.

Version is version-number

Qualifies the named status definition record with a version number.

Version-number must be an integer in the range 1 through 9,999. The default is 1.

OPTional

Allows the application developer to override the default status definition record specification during dialog generation. The application developer can supply the name of an alternate status definition record for each generated dialog.

OPTIONAL is the default when you specify neither OPTIONAL nor MANDATORY in the STATUS DEFINITION RECORD parameter of the ADSO statement.

MANdatory

Prevents the application developer from overriding the default status definition record specification during dialog generation.

STOrage MODe is

Determines the amount of storage to be allocated for record buffer blocks (RBBs).

SGEnsize

Directs the CA ADS runtime system to use the buffer sizes specified by the PRIMARY POOL and SECONDARY POOL parameters (described above) when acquiring storage space for RBBs.

SGENSIZE is the default when you omit the STORAGE MODE parameter from the ADSO statement.

CALculated

Directs the CA ADS runtime system to calculate the size of the RBBs for an application or dialog and to use the calculated size when acquiring storage space for the RBBs.

Note: For more information about calculated storage, see Storage Pools.