TOCPREVNEXTINDEX

Lund Performance Solutions


Setting Options
The following list covers the standard settings that you would commonly use with System Manager’s Toolbox utility after you have started it and are at that tool’s prompt. These options impact how the tools behave. Any user-defined customization is achieved through these special options.
The RESET and SET commands are used for enabling or disabling options. In general, SET is equivalent to "enable" and RESET is equivalent to "disable".

When to Use Setting Options

For tools that serve very pointed, specific tasks like finding a file or changing program capabilities. setting options never really becomes an issue because users are "in and out" of these programs so quickly. But for tools that have a more multi-dimensional purpose, a typical user session could last quite a while. So, knowing how these options can affect a given utility’s operation is extremely useful.
For example, the EATEMPTY option, when enabled, ignores empty input lines and continues to display the results from the command last entered. If you need to look at several screens full of information then enabling this option is very useful.

TOOLBOX STANDARDS

The ToolBox collections from Lund Performance Solutions have a uniform user interface. As a result, in addition to the commands specific to each Toolbox tool, most tools allow the following commands: //, CAPTURE, CRON, CROFF, DO, LISTREDO, RESET, SET, USE.

//

// will terminate most tools immediately.

CAPTURE

This command has the following syntax:
CAPTURE <captureoptions>
The CAPTURE command will generate a hardcopy (or a disc copy) of all (or a portion) of the screen display. The ability to enter CAPTURE as a command to most tools can be enabled by entering SET CAPTUREOK and can be disabled by entering RESET CAPTUREOK.
The interactive tools maintain a shared session-local redo stack of 40 lines. The DO, LISTREDO, and REDO commands access this stack. The options REDOOK and REDOALL affect the operation of the commands.

DO

This command has the following syntax:
DO [ cmd# | relative_cmd# | start_text ]
The DO command causes the tool to re-use the selected saved input line without re-editing.
If no options follow DO, then the most recent line is reused.
If a cmd# (i.e.: DO 5) is used, then that command is retrieved and reused.
If a relative_cmd# (i.e.: DO -3) is used, then that line is retrieved and reused. A value of -1 means: most recent, -2 means second most recent, etc.
If start_text is specified, then the most recent command that started with the same text (regardless of case) is reused.

LISTREDO

This command has the following syntax:
LISTREDO [ALL | *]
Lists the REDO stack for a tool. The REDO stack is up to 40 lines long. If the REDOALL option is false, then only the saved input lines from the current tool will be listed, otherwise the last 40 lines (regardless of what tool saved them) will be listed.
If the ALL option is specified, then all saved input lines will be listed, regardless of REDOALL and tool identity.
If the "*" option is specified, then only the current tool's saved lines will be listed, regardless of REDOALL.

REDO

This command has the following syntax:
REDO [ cmd# | relative_cmd# | start_text ]
The REDO command is very similar to the DO command. After selecting a saved input line, it then displays it for editing. When editing is done, the line is used as input. The REDO can be abandoned by pressing CTRL+Y while editing.

HELP

This command has one of the following syntax:
HELP or
HELP ? or
HELP command
The HELP command (synonym: ?) provides help information about the program in general, or about a specific command. Commands may be abbreviated, in which case HELP will display information about every command that starts with the same characters.
HELP ? will display the entire help file for a tool.
Examples:

HELP STANDARDS
displays information about Toolbox standard interface.
? SE
displays information about the SET command, and any other command beginning with "SE".

SET/RESET

These commands have the following syntax:
SET <options>
RESET <options>
In addition to the various SET/RESET options provided by each tool, every tool supports the following options:
<options>:
BATCH CAPTUREOK COPYLP CRON CRONOK CRONPROMPT EATEMPTY EATPROMPT ECHO MPEOK PAGING QEDITOK REDO REDOALL TERMQUIET UPSHIFT USEOK 80 132
Some users like the set/reset paradigm for turning options on/off, while other users like the set option/NOoption paradigm. The SET and RESET commands provides both styles:

SET <option>
will set the option to true.
RESET <option>
will set the option to false.
SET NO<option>
will set the option to false.
RESET NO<option>
will set the option to true.

Some of the options that end in "OK" control whether or not certain commands will be automatically recognized by the Toolbox input routine.
These options are: CAPTUREOK, CRONOK, MPEOK, REDOOK, and USEOK.
[RE]SET BATCH
The BATCH option allows the user to tell a tool that it is in a job (SET BATCH) or in a session (RESET BATCH). Every tool initially determines the value of this option by calling the WHO intrinsic. The ability to override it with a SET/RESET command is intended as a development tool for Lund Performance Solutions.
[RE]SET CAPTUREOK
If CAPTUREOK is true, then the a "pscreen" (a hard copy of the screen's current contents) can be obtained by entering the command CAPTURE at most prompts. (See also: HELP CAPTURE)
CAPTUREOK can be turned on by entering: SET CAPTUREOK
CAPTUREOK can be turned off by entering: RESET CAPTUREOK
[RE]SET COPYLP
When COPYLP is true, then a copy of all terminal output (except for input prompts) is sent to LPSLP.
COPYLP can be turned on by entering: SET COPYLP
COPYLP can be turned off by entering: RESET COPYLP
[RE]SET CROFF
[RE]SET CRON
SET CROFF turns off the "CRON" option
When CRON is true, hitting a return with no other input on the line will cause a tool to re-use the last input line.
CRON can be turned on by entering: CRON, SET CRON, or RESET CROFF
CRON can be turned off by entering: CROFF, SET CROFF, or RESET CRON
NOTENOTE See CRONOK option for more information about the CRON and CROFF commands.
[RE]SET CRONOK
When CRONOK is true, the CRON and CROFF commands may be entered at any prompt.
When CRONOK is false, the CRON and CROFF commands are not allowed. (In this case, the [RE]SET CRON command can be used to turn CRON on and off.)
[RE]SET CRONPROMPT
When CRON is true, the tool will display the default input as part of the prompt if CRONPROMPT is true.
CRONPROMPT can be turned on by entering: SET CRONPROMPT
CRONPROMPT can be turned off by entering: RESET CRONPROMPT
[RE]SET EATEMPTY
When EATEMPTY is true (and CRON is false), the tool will not "see" empty input lines. Most tools set EATEMPTY to true by default.
EATEMPTY can be turned on by entering: SET EATEMPTY
EATEMPTY can be turned off by entering: RESET EATEMPTY
[RE]SET EATPROMPT
When EATPROMPT is true, then a tool will look at the beginning of every input line to see if you did something like:
move cursor up; hit ENTER
If EATPROMPT is true, and the start of the input line matches the text you were last prompted with, then that text is stripped from your input. After the stripping is done, the remainder of the input line is treated as though it was freshly typed in. Most tools set EATPROMPT to true by default.
EATPROMPT can be turned on by entering: SET EATPROMPT
EATPROMPT can be turned off by entering: RESET EATPROMPT
[RE]SET ECHO
If ECHO is true, then all input read by the tool input routine is automatically echoed to LPSOUT. ECHO is set/reset automatically at the start of each tool, and is normally not changed by users. It is documented here for completeness.
[RE]SET MPEOK
If MPEOK is true, then any input line starting with a colon (:) is passed to the HPCICOMMAND intrinsic. Most tools set MPEOK to true by default.
MPEOK can be turned on by entering: SET MPEOK
MPEOK can be turned off by entering: RESET MPEOK
[RE]SET PAGING
If PAGING is true, and if the tool is running in a session, then most output will be "paged" (i.e.: it will pause every 22 lines or so). The HELP subsystem ALWAYS temporarily sets paging to true for sessions.
PAGING can be turned on by entering: SET PAGING
PAGING can be turned off by entering: RESET PAGING
[RE]SET PSCREENOK
PSCREENOK is a synonym for CAPTUREOK.
[RE]SET QEDITOK
If QEDITOK is true and REDOOK is true, then the 2-character sequence <escape>v will be treated as a synonym for LISTREDO. This character sequence is loaded into softkey 7 by QEDIT and labelled "Listredo".
[RE]SET REDOALL
The REDO stack maintained by the tool programs is a shared stack of 40 lines.
If REDOALL is true and REDOOK is true, then LISTREDO, DO, and REDO will see the entire stack.
If REDOALL is false and REDOOK is true, then LISTREDO, DO, and REDO will see only those redo stack entries that came from the current tool.
REDOALL is reset by default.
[RE]SET REDOOK
If REDOOK is true, then most tools support the commands DO, LISTREDO, and REDO.
REDOOK can be turned on by entering: SET REDOOK
REDOOK can be turned off by entering: RESET REDOOK
[RE]SET UPSHIFT
If UPSHIFT is true, then input will be automatically shifted to uppercase.
UPSHIFT can be turned on by entering: SET UPSHIFT
UPSHIFT can be turned off by entering: RESET UPSHIFT
[RE]SET USEOK
If USEOK is true, then most tools will allow the USE command. (See also: HELP USE)
USEOK can be turned on by entering: SET USEOK
USEOK can be turned off by entering: RESET USEOK

USE

This command has the following syntax:
USE[Q] <filename>
The USE command causes the tool to read subsequent input from the specified disc file. USE will echo its input, USEQ will not.
Because USE files may not be nested, a USE command within a USE file will close the first USE file and switch to the second file.

Lund Performance Solutions
www.lund.com
Voice: (541) 812-7600
Fax: (541) 81207611
info@lund.com
TOCPREVNEXTINDEX