Visara Master Console Center Scripting Guide - Manual (Page 127)

Chapter 5 Script Commands
Scripting Guide 127
HMCEXEC
Syntax:
HMCEXEC(%ObjID, $Action [, parm1, ...]) => %RetVal
Description:
Send a command to an HMC-controlled CPC or Image on a CMOS
generation mainframe.
Action:
Any command that can be performed using the MCC’s HMC Window
can be automated using this function.
Parameters:
%ObjID. Numeric expression. The unique Object ID number of the
CPC or Image (CPU or OS) to which the command is to be sent. Refer
to OBJID() for more information.
$Action. String expression. The HMC action to perform:
parm1, parm2, .. String or numeric expression. Optional. Only two
Actions take optional parameters: HMC_ACTIVATE and HMC_LOAD.
Details are given in Table 13. Possible HMC actions and parameters
following.
Returns:
Numeric value, as follows:
Value
Meaning
0 (FALSE) Command failed.
1 (TRUE) Command was successful.
Notes: Performing these commands on a non-HMC CPU or OS will have no
effect other than returning a 0.
Example: %ObjID := OBJID(OS, $ImageName)
%RetVal := HMCEXEC(%ObjID, HMC_START)
%ObjID := OBJID(CPU, $CPCName)
%RetVal := HMCEXEC(%ObjID, HMC_DEACTIVATE)
See Also:
N/A