Caché ObjectScript Reference
MV
 [Next]
   
Server:docs2
Instance:LATEST
User:UnknownUser
 
-
Go to:
Search:    

Invokes the MultiValue Shell.
Synopsis
MV:pc commands
Arguments
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.
Description
Note:
The Caché MultiValue Shell is not supported on the OpenVMS operating system.
MV command has two forms: argumentless MV and MV with a commands argument.
Argumentless MV
The MV 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.
Note:
The MV MultiValue Shell invocation command should not be issued from within the MultiValue Shell. Such nested MultiValue Shell invocations may cause unexpected problems.
MV commands
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.
Arguments
pc
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.
commands
One or more Caché MultiValue commands. Each command must be specified as a quoted string. Multiple commands are separated by commas.
Examples
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
See Also