Caché ObjectScript Reference
Invokes the MultiValue Shell.
||Optional A postconditional expression.
||Optional A MultiValue Shell command, specified as a quoted string, or a comma-separated list of MultiValue Shell commands, each command specified as a quoted string.
The Caché MultiValue Shell is not supported on the OpenVMS operating system.
command has two forms: argumentless MV and MV with a commands
command invokes the Caché MultiValue Shell. Caché displays the MultiValue Shell prompt. An argumentless MV command can only be issued from Caché Terminal.
At the MultiValue Shell prompt you can issue MultiValue Shell commands, as described in the Caché MultiValue Commands Reference
. You can also issue Caché MVBasic commands at this prompt by prefacing each MVBasic command with a semicolon (;). Refer to the Caché MultiValue Basic Reference
for further details. You can exit the MultiValue Shell by issuing a QUIT
command at the MultiValue prompt.
The argumentless MV
command enters the interactive MultiValue Shell and immediately rolls back any open transactions. Upon exiting the MultiValue Shell the current $TLEVEL
value is 0.
MultiValue Shell invocation command should not
be issued from within
the MultiValue Shell. Such nested MultiValue Shell invocations may cause unexpected problems.
command with the commands
option also invokes the Caché MultiValue Shell. It issues the specified MultiValue commands
and then exits the MultiValue Shell. It does not display the MultiValue Shell prompt.
You can specify one or more MultiValue Shell commands, as described in the Caché MultiValue Commands Reference
. Each command is specified as an expression that evaluates to a quoted string. You can specify multiple MultiValue commands as a comma-separated list.
You can also issue Caché MVBasic commands by prefacing each MVBasic command with a semicolon (;). Refer to the Caché MultiValue Basic Reference
for further details.
Because MV commands
automatically exits the MultiValue command environment, specifying a MultiValue QUIT
command has no effect.
has no effect on open transactions. Upon returning from this command the current $TLEVEL
value is unchanged.
An optional postconditional expression. Either form of MV
can take a postconditional. Caché executes the MV
command if the postconditional expression is true (evaluates to a nonzero numeric value). Caché does not execute the command if the postconditional expression is false (evaluates to zero). For further details, refer to Command Postconditional Expressions
in Using Caché ObjectScript
One or more Caché MultiValue commands. Each command must be specified as a quoted string. Multiple commands are separated by commas.
The following example issues several MultiValue commands and a MVBasic command. It uses MVBasic to set a MultiValue lock, lists all of the processes locks, clears all process-defined locks, and again lists all of the locks.
SET lck=";LOCK 7"