This is documentation for Caché & Ensemble.

For information on converting to InterSystems IRIS, see the InterSystems IRIS Adoption Guide and the InterSystems IRIS In-Place Conversion Guide, both available on the WRC Distributions page (login required).

Home > Class Reference > ENSLIB namespace > Ens.Director

Ens.Director

abstract class Ens.Director

Method Inventory (Including Private)

Parameters

parameter DOMAIN = Ensemble;

Methods (Including Private)

classmethod Console(pTarget As %String = $NAMESPACE)
Console for managing/monitoring Ensemble from a terminal prompt.
classmethod CreateBusinessService(pTargetDispatchName As %String, Output pBusinessService As Ens.BusinessService) as %Status
This method creates a Business Service object from which you can send messages. pTargetDispatchName: is the configuration name of the business service. pBusinessService: is an output parameter that contains the business service object.
classmethod DeleteProduction(pProdId As %String) as %Status
This method permanently deletes the specified production and its underlying class.
classmethod EnableConfigItem(pConfigItemName As %String, pEnable As %Boolean = 1, pDoUpdate As %Boolean = 1) as %Status
Enable or disable a ConfigItem in a Production. The Production may be running or not. The pConfigItemName argument gives the name of the config item to be enabled or disabled In the case of multiple matching items with the same config name, if any is already enabled then the pEnable=1 option will do nothing and the pEnable=0 option will disable the running matching production item, or if not running then the first matching enabled item that it finds. See method Ens.Director.ParseConfigName() for full syntax of the ConfigItem name specification string.
classmethod GetActiveProductionName() as %String
Get the name of the current running or last used production
classmethod GetAdapterSettingValue(pConfigItemName As %String, pSetting As %String, Output pStatus As %Status) as %String
classmethod GetAdapterSettings(pConfigItemName As %String, Output pSettings) as %Status
classmethod GetCurrProductionSettingValue(pSetting As %String, Output pStatus As %Status) as %String
This method is deprecated. Please call GetProductionSettingValue("",tSetting,.tStatus) instead
classmethod GetCurrProductionSettings(Output pSettings) as %Status
This method is deprecated. Please call GetProductionSettings("",.tSettings) instead
classmethod GetHostSettingValue(pConfigItemName As %String, pSetting As %String, Output pStatus As %Status) as %String
classmethod GetHostSettings(pConfigItemName As %String, Output pSettings) as %Status
classmethod GetItemSettingValue(pConfigItemName As %String, pType As %String, pSetting As %String, Output pStatus As %Status) as %String
classmethod GetItemSettings(pConfigItemName As %String, pType As %String, Output pSettings) as %Status
classmethod GetProductionSettingValue(pProd As %String, pSetting As %String, Output pStatus As %Status) as %String
classmethod GetProductionSettings(pProd As %String, Output pSettings) as %Status
classmethod GetProductionStatus(Output pProductionName As %String, Output pState As %Integer, pLockTimeout As %Numeric = 10, pSkipLockIfRunning As %Boolean = 0) as %Status
This method returns the production status via the output parameters. pProductionName: Returns the production name when the status is running, suspended or troubled. pState: Outputs production status. The valid values are: $$$eProductionStateRunning $$$eProductionStateStopped $$$eProductionStateSuspended $$$eProductionStateTroubled
classmethod GetProductionSummary(ByRef pInfo, pNamespace As %String = $ZU(5))
classmethod GetRunningProductionShutdownTimeout() as %Integer
classmethod GetRunningProductionUpdateTimeout() as %Integer
classmethod GetSystemProductionSummary(ByRef pInfo) as %Status
classmethod IsItemEnabled(pConfigItemName As %String, pStatus As %Status) as %Boolean
Return 1 if the named config item is enabled
classmethod IsProductionRunning(Output pProductionName As %String) as %Boolean
This method returns whether a production is currently running in this namespace, and returns the name of the currently running production in pProductionName. Note that this method is not as reliable as GetProductionStatus()() as it does not lock $$$EnsRuntime and may not accurately reflect the production status while the production is changing state, e.g. while starting or stopping.
classmethod ParseConfigItemName(pConfigItemName As %String, Output pProductionName As %String, Output pItemBaseName As %String, Output pItemCommentOrClassName As %String)
The pConfigItemName argument may contain the following elements: ProductionName||ConfigName|CommentOrClassname Only the ConfigName portion is required. If ProductionName is not given, then the currently running or last run Production will be used. CommentOrClassname is the name shown in the Config page's dropdown list for multiple items having the same ConfigName. If it is not given, then if more than one item of the given ConfigName exists, all will match. In order for this method to work properly, none of the names of the items in your production should contain the '|' character.
classmethod ProductionNeedsUpdate(Output pReason As %String, pQuickLock As %Boolean = 0) as %Boolean
This method returns a boolean to indicate if the running production needs to be updated or not. pReason: is an output parameter that gives detailed reasons.
classmethod RecoverProduction() as %Status
This method recovers the last running production whose status is eProductionStateTroubled.
classmethod RestartProduction(pTimeout As %Numeric = 10, pForce As %Boolean = 0) as %Status
This method stops and restarts the running production. pTimeout: How many seconds to wait for the jobs to go down. pForce: It indicates if we should forcefully kill the jobs which can not stop by themselves.
classmethod SetAutoStart(pProductionName As %String) as %Status
classmethod StartProduction(pProductionName As %String = {$GET(^Ens.Configuration("csp", "LastProduction"))}) as %Status
This method starts the production running. pProductionName: The name of the production to be started. If not specified, defaults to the "last" production used (if any).
classmethod StopProduction(pTimeout As %Numeric = 10, pForce As %Boolean = 0) as %Status
This method stops the running production. pTimeout: How many seconds to wait for the jobs to go down. pForce: It indicates if we should forcefully kill the jobs which can not stop by themselves.
classmethod SystemStart() as %Status
classmethod SystemStop() as %Status
classmethod UpdateProduction(pTimeout As %Numeric = 10, pForce As %Boolean = 0, pCalledByScheduleHandler As %Boolean = 0) as %Status
This method updates the running production. pTimeout: How many seconds to wait for the jobs to go down. pForce: It indicates if we should forcefully kill the jobs which can not stop by themselves. pCalledByScheduleHandler: This parameter is set to one when it is called by the schedule handler.
classmethod actualizeProductionDifferences(ByRef pDefinition, Output pToStopJob, ByRef pToStartConfig, ByRef pToDeleteConfig, ByRef pToUpdateScheduler As %Boolean, pTimeout As %Numeric, pForce As %Boolean, pCalledByScheduleHandler As %Boolean = 0) as %Status
classmethod findProductionDifferences(pProductionName As %String, pLog As %Boolean, Output pDefinition, Output pToStopJob, Output pToStartConfig, Output pToDeleteConfig, Output pToUpdateScheduler As %Boolean = 0, Output pToCleanJobStatus, Output pActorForceDisabled As %Boolean = 0, pUpdatingProduction As %Boolean = 0, pActiveLockTimeout As %Integer = 10) as %Status
classmethod getProductionItems(tProduction As Ens.Config.Production, pDefinition As %String, pAutoAdd As %String) as %Status
classmethod getRunningJobData(Output pRunningCount, Output pRunningConfig) as %Status
classmethod hasDisabledActorProcess(pProduction As Ens.Config.Production) as %Boolean
classmethod killProductionGlobals(pKillAppDataToo As %Boolean = 0) as %Status
classmethod moveEnsRuntimeToEnsSuspended(pFromRecover As %Boolean = 0, pRecoverProductionName As %String = "")
FeedbackOpens in a new window