ADDRESS VOX Commands › Utility Commands › SETENGINE Command

SETENGINE Command

The SETENGINE command allows you to modify various settings that are directly associated with the notification server.

This command has the following format:

ADDRESS VOX "SETENGINE ENGINESETTING(AUTORESET) VAR(var.) [SYSTEM(sysname)]"

ENGINESETTING

Specifies the ENGINESETTING operand enables you to change the default autoreset period to a setting other than five minutes.

VAR

A stem variable name (var.) that you assign containing the autoreset value. The specified stem variable must contain the following information:

varname.0

Must be 1

varname.1

The value you wish to set for the ENGINESETTING value

SYSTEM

(Optional) Specifies the name of the system to which you want to direct the command.

The sysname value can contain up to eight alphanumeric characters.

Default: The local system name

Return Information:

After the SETENGINE command executes, it sets the special REXX return code variable RC.

• If the command executes successfully, the RC variable contains a value of zero.
• If the command does not execute successfully, the RC variable contains one of the following values: 5117, 5155, 5199. (See the Message Reference Guide for further information.) Additionally, the VOX.ERROR variable contains the complete VOX error message, which includes the four-digit return code and complete error message text.

Example:

The following REXX code illustrates how to use the SETENGINE command to set the autoreset to three minutes:

 value.0 = 1     
 value.1 = 3  /* value of 3 minutes for auto-reset */
   address VOX "SETENGINE ENGINESETTING(AUTORESET)     VAR(VALUE.)"