Previous Topic: Command Syntax

Next Topic: The ACCESS Command


The SET Command

Use the SET command to set certain options used by the CA DRAS server. Options changed using the SET commands are only retained while the session remains active. To permanently change the values of these parameters, update the CAHFDCFG configuration file.

Note: For more information about how to update this configuration file for permanent modifications, see the chapter "Configuring CA DRAS".

Note: The SET MESSAGE DEST statement is no longer valid and must NOT appear in the configuration file.

Options that can be dynamically changed using the SET command include:

The format and options of the SET command are defined next.

SET CLIENT TRANSLATION

This command indicates where code page translation is done. The format of the command is:

SET CLIENT TRANSLATION(ON|OFF)
ON

Indicates that translation occurs at the client (this is the default).

OFF

Indicates that the server does the translation.

Note: This command is intended for future use and, for the time being, must be set to ON.

SET CLIENT TYPE

This command indicates the operating system of the client software. The format is:

SET CLIENT TYPE(WINDOWS|UNIX|LINUX|MVS|ZOS)

This command is reserved for future use. At this time, use the default, WINDOWS.

SET THREADS

This command instructs CA DRAS to set the number of parallel execution threads to the specified value (count). Acceptable values are 1–99. The format of this command is:

SET THREADS(count)
count

Indicates a tuning parameter that can be used to increase the server throughput.

The value defined in the THREADS parameter determines how many concurrent tasks are started to process work in the CA DRAS region. This is a tuning parameter, and increasing the count can improve server throughput if excessive delays are observed.

Increasing this count may not necessarily improve the throughput if the value has already been increased to the optimum setting for your system and workload. If performance improvement cannot be obtained by increasing the value in this field, contact CA Support for further assistance. The default is 12.

SET LANGUAGE

This command designates the message language. The format of this command is:

SET LANGUAGE(language)
language

Specifies that data is generated in the chosen language.

SET LONGWAIT

This command specifies the number of minutes a user can be inactive before being timed-out. The format of this command is:

SET LONG	WAIT(mm|OFF)
mm

Indicates the number of minutes a user can be idle before being disconnected. SET LONGWAIT(OFF) disables checking for idle users. This command can be included in the configuration file or issued from the console.

SET MESSAGE ECHO

These commands specify whether and which messages are to be echoed to SYSLOG. The formats of the commands are:

SET MESSAGE ECHO(ON|OFF)
SET MESSAGE ECHO(message_id) [ROUT(rr)] [ DESC(dd)]
ON

Starts message echoing.

OFF

Stops message echoing.

message_id

Specifies a complete or partial message ID.

Rr

Specifies the routing code (default 11).

dd

Specifies the descriptor code (default 6).

The second form of the command allows you to specify which messages are to be echoed.

SET MESSAGE ECHO(ON) without specifying any message numbers causes all agent messages to be echoed. That is, messages whose IDs start with BUN, CADS, or CAHA, are written to SYSLOG.

These commands can be included in the configuration file or issued from the console.

++ Command ++ SET MESSAGE ECHO(ON)                        
CAHFMTK029I Message echoing turned on                     
++ Command ++ SET MESSAGE ECHO(OFF)                       
CAHFMTK029I Message echoing turned off                    
++ Command ++ SET MESSAGE ECHO(CAHFMKT02) ROUT(11) DESC(6)
CAHFMTK031I CAHFMKT02 added to echoed messages list   
SET MESSAGE SUPPRESSION

This command designates the level of messages written to DRASLOG. The format of this command is:

SET MESSAGE SUPPression(ON|OFF)
ON

Suppresses all informational messages.

OFF

Allows them to be written to DRASLOG.

This command can be included in the configuration file or issued from the console. Note that SUPPRESSION can be abbreviated to SUPP.

++ Command ++ SET MESSAGE SUPP(ON)        
CAHFMTK030I Message suppression turned on 
++ Command ++ SET MESSAGE SUPP(OFF)       
CAHFMTK030I Message suppression turned off
SET LOGUSERS

This command specifies whether user IDs must appear in the DRASLOG with the computer name.

SET LOGUSERS(ON|OFF)
ON

Causes the user ID to be added to the computer name in DRASLOG messages.

OFF

Suppresses displaying the user ID by default.

++ Command ++ SET LOGUSERS(ON)
Log Users          = ON
++ Command ++ SET LOGUSERS(OFF)
Log Users          = OFF