SITE

Establishes the option for the entire site. The SITE option is valid with the following options: $RC, CLEAR, ERROR‑PNL, LOOPLIMIT, QUITIDEAL, QUITMSG, SQL, STRNO, URT, and XA.

$RC

Defines how the value of the $RC return code is set for each run. Specify:

ZERO The value of the return code is set to zero at the beginning of each run.

KEEP Keeps the return code value set during the execution of a previous program or CA Ideal command. Each run starts with the most recent return code value.

CBSTRACE

Controls whether an CA Datacom CBS trace of CA Ideal applications is turned on. If the command is not issued, the default is NO. Specify:

YES/Y CBS trace is turned on.

NO/N CBS trace is not turned on.

For information on the CBS trace, see the Problem Determination Guide.

CLEAR

Specifies the action taken if you press the Clear when a program transmitted a panel. This command is only in effect while a CA Ideal application is running. During CA Ideal activities other than RUN, the Clear key continues to return the Main Menu. Specify:

QUITRUN The Clear key ends the application. If SET RUN QUITIDEAL YES is in effect, this also ends the CA Ideal session; otherwise, the user returns to the Main Menu.

RESHOW The Clear key redisplays the current panel in the same state in which it was most recently transmitted.

ERROR‑PNL

Redisplays the panel in the event of a fatal CA Ideal internal error during a run (and if you specified SET RUN QUITIDEAL YES). You must specify the panel name, version number, and system.

NONE Resets the option to the default panel.

name VERSION nnn SYSTEM sys‑id The name, the version number, and the system ID of the system containing the panel to display if a fatal error terminates a run.

LOOPLIMIT

Establishes a maximum for the number of times a test‑status program loops through a FOR or LOOP construct. A runtime error occurs if this limit is exceeded. You can override this command for the current session to a higher or lower value. Specify:

nnnnnnnnn The maximum number of iterations (0 through 999,999,999) allowed through each FOR or LOOP construct.

PACKAGE‑SET

Identifies the collection that contains the package into which a subsequently executed program is bound. Specify:

collection‑id A valid collection id.

PLAN

(DB2 Only) Establishes a default application plan name for a CA Ideal session or run. This plan name is used unless a new plan name specified in a CA Ideal application or a CA Ideal plan name exit program supersedes it. You can include the command in your jobstream or sign‑on member or issue it at the terminal before running an application. You can use it in batch and online Specify:

name The one‑ to eight‑character name of an application plan. CA Ideal plan names can be a maximum of seven characters long. Non‑Ideal subprograms can use a plan name of up to eight characters.

DEFAULT Sets the default plan name to the value in the IDOPTSCB. The installed value is IDP110DV.

QUITIDEAL

Allows sign off to take place automatically at the completion of the application in progress. If the command is not issued, the default is NO. Specify:

YES At the conclusion of the current application, the CA Ideal session is terminated and a signoff panel other than the normal CA Ideal signoff panel displays. You can replace this signoff panel with a site‑specified signoff panel. See the Administration Guide for more information.

Using YES in batch causes unpredictable return codes. Online, use with SET COMMAND LINE 0.

NO The session is not terminated at the conclusion of an application.

QUITMSG

Determines whether the following message prints at the end of a run:

IDADRUNP01I: Run Completed, RC=0

Specify:

YES Message prints.
NO Message is suppressed.

SQL

(DB2 Only) Lets you specify at run‑time whether an application running against a DB2 database can execute dynamic SQL mode or must execute only static SQL mode. Specify:

MIXED (Default) Indicates that dynamic SQL mode is allowed. (This option requires that dynamic SQL be allowed on the plan parameters fill‑in.)

STATIC Indicates that only static SQL mode is allowed.

STRNO

(VSAM Only) Lets you specify how many VSAM strings are required to access a VSAM data set through nested FOR constructs. If this command is not issued, the default value is 1. Specify:

nnn Number of VSAM strings required. This value can be any integer number from 1 to 255. Set it to the maximum level of nesting in any FOR construct in the applications run while this command is in effect.

This command is required only for batch VSE applications that contain nested FOR constructs for the same VSAM data set. This command is ignored for CICS.

This command is not required for batch z/OS environments (OS batch) since z/OS allocate strings dynamically. However, if an application contains nested FOR constructs, setting the STRNO to a number greater than 1 can improve performance. Increasing the value of STRNO increases storage requirements, therefore, do not set STRNO any higher than is required for the applications being run.

UPDATE

Determines whether updates execute or are suppressed for all dataviews (CA Datacom native and SQL access, DB2, sequential, and VSAM). This command controls access through both the FOR construct and embedded SQL. Specify:

YES Allows updating of the database during execution.

NO Prevents updating of the database.

The SET RUN UPDATE NO command only suppresses data access commands that request the addition, update, or deletion of a record. All other processes, including such processes as allocation of sequential files, are still executed.

This command is intended for debugging and testing a program without actually updating the data. Since programs function as if the update was successful, including display of any program messages indicating that the update was successful, do not use this command as a method of enforcing security or to make an updateable program non‑updateable.

URT
FILETABLE

For batch CA Ideal programs, use this command before a run to select an alternate user requirements table. Specify:

name The name of an alternate user requirements user table.

For online CA Ideal programs, this is not necessary because another technique automatically selects file tables (see the CA Datacom/DB documentation.)

Online, set the ACCESS= parameter to RAN (random). If the ACCESS= parameter is set to RANSEQ, you can use a single URT for both online and batch processing, but this incurs additional overhead for online processing.

XA

For a z/OS or VSE/ESA capable system, this command tells CA Ideal to use XA, either for the site or for the current session. CA Ideal then uses 31‑bit addressing and storage above the line while running programs. The default is OFF until SET RUN XA ON is issued. Specify:

ON Use z/OS.

OFF Do not use z/OS.