SITE

Use the SITE option with the following options to set the option for the entire site: DATEFOR, DB2PLAN‑EXIT, GLOBAL‑POOL, LINES, SIGNON‑EXIT, and SQL.

ACCOUNT‑ID

Assigns different development or production activities to separate user‑specified CICS transactions. This allows CICS performance analysis packages or transaction accounting packages to isolate transactions for charge‑back and resource consumption analysis. It also allows DB2 users to select application plans associated with transaction IDs from in CA Ideal. Specify:

xxxx A one‑ to four‑character CICS transaction ID. In accordance with IBM standards, it is recommended that transaction IDs not begin with C. You must also specify each ACCOUNT‑ID specified in a SET ENVIRONMENT command as the TRANSID parameter in a CICS DFHPCT entry. The entry should look exactly like the one distributed for TRANSID=SCFD, except for the TRANSID and PRTY.

COMPILE‑ID

Assigns COMPILE tasks to a separate user‑specified CICS transaction. This allows CICS performance analysis packages or transaction accounting packages to isolate COMPILE transactions for charge‑back and resource consumption analysis. Specify:

xxxx A one‑ to four‑character CICS transaction ID. You must also specify each COMPILE‑ID specified in a SET ENVIRONMENT command as the TRANSID parameter in a CICS DFHPCT entry.

For DB2, you must specify each COMPILE‑ID specified in a SET ENVIRONMENT command in a CICS DFHRCT entry patterned after the one for SAST.

CURRENCY

Displays an alternate currency symbol in panels and prints it in reports generated by an application during the current session. This command does not affect the currency symbol as it is specified in the edit pattern of a report definition or panel field definition or in a $EDIT function in the procedure of a CA Ideal program. Specify:

value Any symbol.

DATEFOR

Establishes the date format the compiler uses. See the $DATE function in Chapter 5 of the Programming Reference Guide for a chart containing edit pattern rules. Specify:

pattern Any logical combination of the date patterns. You can change date formats for a report at runtime with the SET REPORT DATEFOR command and not the SET ENVIRONMENT DATEFOR command.

DB2PLAN‑EXIT

Enables or disables a CA Ideal plan name exit program for the site or for the current session. This exit program can select or modify the name of the pla CA Ideal provides to DB2. Specify:

exit‑name The name of the plan name exit program to execute.

NONE Disables the plan name exit program.

DECIMAL

Uses an alternate convention for the digit separator and decimal point when displayed in panels or printed in reports generated by an application running during the current session. Specify:

• ,. (Period) The decimal symbol is a period and the digit separator is a comma.
• , (Comma) The decimal symbol is a comma and the digit separator is a period.

You cannot specify any other symbols.

This command does not affect the decimal symbol as it is specified in the edit pattern of a report definition or panel field definition or in a $EDIT function in the procedure of a CA Ideal program. For example, if X is defined as:

SET X = $EDIT(N, PIC='ZZZ,ZZZ.99')

and the following command is entered

SET ENVIRONMENT DECIMAL ,

at runtime, X displays as 2.345,00.

For dataviews containing fields that have been defined in Datadictionary with a European format edit pattern, it is necessary to execute the "SET ENVIRONMENT DECIMAL ," command before cataloging the dataview. The CA Ideal CATALOG dataview process will swap commas and periods to produce dataview objects with the CA Ideal default edit pattern.

EXECERROR

Specifies whether to quit or continue after an error resulting from the execution of commands in a member. Including this command in a member affects all commands that follow it in the member until the next SET ENVIRONMENT EXECERROR command or until the end of the member. Specify:

QUIT Execution of the member stops when any of the statements following causes an error. This is the default.

QUITIDEAL The CA Ideal session terminates when any of the statements following causes an error.

CONTINUE Execution of the member continues when any of the statements following causes an error.

For example, executing the following CA Ideal member duplicates a series of programs to the next version and compiles them. If an error is encountered, a message displays and processing continues.

SET ENVIRONMENT EXECERROR CONTINUE
DUPLICATE PROGRAM DEMO1 TO NEXT VERSION
COMPILE DEMO1 VERSION LAST
DUPLICATE PROGRAM JECLUP TO NEXT VERSION
COMPILE JECLUP VERSION LAST
...

However, SET ENVIRONMENT EXECERROR does not execute subsequent commands if there was a run time error. A run time error stops execution of the member even if CONTINUE was specified.

FINAL‑ID

Specifies the next CICS transaction to schedule when the OFF command is executed (explicitly or implicitly) in CA Ideal. If you do not specify this command, the CA Ideal signoff logo displays. Specify:

xxxx The one‑ to four‑character transaction ID to schedule when the current session ends. In accordance with IBM standards, it is recommended that transaction IDs not begin with C.

NONE The screen is cleared and the signoff logo displays when the current session ends.

For use with CA Dataquery, issue the following command to log off CA Ideal and log on to CA Dataquery, bypassing both the CA Ideal logoff screen and the CA Dataquery logon screen. The CA Dataquery Main Menu displays.

SET ENV FINAL‑ID DQRY

GLOBAL‑POOL

Obsolete tuning method related to RUN-STATUS. This command applies to the current CICS partition and any subsequent CICS partitions and should always be set to 0.

LINES

Specifies the maximum number of lines per print page used by the compiler and PRINT commands. It applies to print requests to network and system printers when printing entities, session options, and indexes. It also applies to compile listings and displays in batch. Specify:

nn The number of lines per page. The minimum number of lines per page is 20; the maximum is 99.

PRINT‑ID

Assigns PRINT tasks to a separate user‑specified CICS transaction. This allows CICS performance analysis packages or transaction accounting packages to isolate transactions for charge‑back and resource analysis. Specify:

xxxx A one‑ to four‑character CICS transaction ID. You must also specify each PRINT‑ID specified in a SET ENVIRONMENT command as the TRANSID parameter in a CICS DFHPCT entry.

For DB2, you must specify each PRINT‑ID specified in a SET ENVIRONMENT command in a CICS DFHPCT entry patterned after the one for SAST.

SIGNON‑EXIT

Establishes or changes a signon exit program for a site. The exit specified in this program goes into effect after the next signon. Specify:

exit‑name The name of the exit program to execute if an exit program is specified for a transparent signon.

NONE

Disables the site‑specified signon program.

SQL

Establishes the default type of database to use for SQL access when a site can access multiple database management systems using SQL. The CATALOG command uses it as its default for SQL dataviews. It is used as the default primary database for the program environment fill‑in. Specify:

DB CA Datacom SQL access
DB2 DB2 access