/MEng/System/CQC/Runtime/CQCUtils

Class Information:

ClassPath:	MEng.System.CQC.Runtime.CQCUtils
Parent ClassPath:	MEng.Object
Copyable:	No
Final:	Yes

MEng.System.CQC.Runtime.CQCUtils is a class that is intended to be a bit of a grab bag for some general purpose utility methods that don't justify their own classes, but need to go somewhere. For now, the number of methods is quite small. Others will be added as time goes by.

Nested Types:

Enum=CQCUtilsErrs
    ACSNotFound : "App Ctrl Server '%(1)' was not found";
    NoLocInfo   : "The location information could not be accessed"
    OpFailed    : "";
EndEnum;

This enumerated type defines the exceptions thrown by this class. They have no text because they just get assigned the underlying C++ exception text.

 

Constructors:

Constructor();

There is just a default constructor available.

 

Final, Non-Const Methods:

GetLatLong([Out] MEng.Float8 Lat, [Out] MEng.Float8 Long);

This method allows you to retrieve the latitude and longitude values that were set in CQC by the administrator.  This is not set until the Admin runs the Admin Interface the first time and is prompted to set it. So it could possibly not be set, in which case you will get an NoLocInfo exception.

SendEmail
(
    [In] MEng.String AcctName
    , [In] MEng.String ToAddr
    , [In] MEng.String Subject
    , [In] MEng.String Message
);

This method allows you to send an e-mail via one of the defined CQC e-mail accounts. You just have to provide the account name, an e-mail address to send it to, a subject line, and some message text. The message text of course will often be built up dynamically so that it includes device information. If the operation fails, the OpFailed exception will be thrown.

StartRemApp
(
    [In] MEng.String Binding
    , [In] MEng.String RemotePath
    , [In] MEng.String Parms
    , [In] MEng.String InitPath
)   Returns MEng.Boolean;

This method allows you to start an application remotely via an app control server running on another machine (or the same machine for that matter though that would not be necessary since you could start it directly.) You providing the binding name of the app control server to target, the path on the remote machine of the app to start, the parameters to pass, and an optional initial path for it to start in which can be empty if you don't care.

If the target App Control Server cannot be found, you will get an ACSNotFound exception.