|pc||Optional — A postconditional expression.|
|commands||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.|
MV command has two forms: argumentless MV and MV with a commands argument.
The MV command invokes the Caché MultiValue Shell. Caché displays the MultiValue Shell prompt. An argumentless MV command can only be issued from the 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.
The MV MultiValue Shell invocation command should not be issued from within the MultiValue Shell. Such nested MultiValue Shell invocations may cause unexpected problems.
The MV 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.
MV commands 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 lst="LIST.LOCKS" SET clr="CLEAR.LOCKS" SET lck=";LOCK 7" MV lck,lst,clr,lst