Options dialog box: Command tab

You can use the options in the Command tab to specify how ACL executes commands.

Autoexecute Commands

If you turn this option on, ACL immediately executes any command that has been selected from a toolbar or menu. You cannot edit the command or apply a local filter.

Automatic Output Filenames

If you turn this option on, ACL auto-generates filenames for each output file. The name contains the command name and an incremental number starting at 01. You can accept the name, or choose a more meaningful name.

Use Output Table

This option controls whether or not the Use Output Table checkbox, located in command dialog boxes that create tables, is initially selected. You can change this default setting, command by command. When you execute a command, ACL automatically closes the active table and opens the table created by the command.

Show Group Tests in Log

When you run a script, this option affects the display of group results as they appear in the command log. ACL displays the group results of If, While, For, and Next tests beside the commands to which they apply. Because more than one test in a group can apply to each command, the syntax can get very long.

If you turn this option off, ACL does not display the tests when a script is run.

Changes to this setting are recorded in the log using the following syntax:

SET TEST {ON|OFF}

Suppress XML Output for Command Results

When this option is selected, ACL produces command output as plain text rather than formatted text.

Changes to this setting are recorded in the log using the following syntax:

SET SUPPRESSXML {ON|OFF}

Return Matches for Null Fields

This option controls how ACL interprets null character values. A character value is “null” when it is empty and contains no data. For example, NAME="" is an expression with a null character value: there is nothing between the quotation marks.

When this option is selected, ACL interprets a null as a wildcard. For example, the view filter NAME = "" displays records with any value in the NAME field.

When this option is not selected, ACL interprets a null literally as a null. For example, the view filter NAME = "" displays only records with no data in the NAME field.

Intervals

This option indicates the number of intervals chosen by default for a stratification or histogram. Enter a number from 1 to 255. The default is 10.

Error Limit

This option sets the default number of errors after which ACL stops processing the Sequence or Verify commands. The default is 10.

Notify Settings

Retry Attempts

This option specifies the number of times the Notify operation will attempt to send an email if the initial attempt is unsuccessful. Enter a number from 0 to 255. If you enter 0, no additional attempts are made after an initial failure. The default is 5.

One possible reason for the Notify operation failing to send an email is that the email server is unavailable.

Retry Interval (seconds)

This option specifies the amount of time in seconds between additional attempts to send an email after an initial failure. Enter a number from 1 to 255. The default is 10 seconds.

Stop Script if Notify Fails

If you turn this option on, ACL stops processing a script if the Notify operation fails. The script stops after the initial failure, or after the specified number of Retry Attempts, if none of the attempts are successful. The default setting is off, which allows a script to continue even if a Notify operation fails.

An invalid email recipient is not considered a failure of the Notify operation and does not cause a script to stop regardless of how Stop Script if Notify Fails is set.

Related tasks
Configuring ACL options


(C) 2015 ACL Services Ltd. All Rights Reserved.