runtime.cfc

CFIDE.adminapi.runtime
Component runtime (runtime)

Manages runtime settings for fonts, cache, charts, configuration, and other settings.

hierarchy: WEB-INF.cftags.component
CFIDE.adminapi.base
CFIDE.adminapi.runtime
path: {web-root}\CFIDE\adminapi\runtime.cfc
serializable: Yes
properties:
methods: backup*, clearComponentCache, clearTrustedCache, deleteClientStore, deleteFont, executeClassPath*, getCacheProperty, getChartProperty, getClientStores, getFonts, getJvmProperty, getLastClientID, getOption*, getOptionList*, getPath, getProps*, getRuntimeProperty, getScopeProperty, saveJvmConfig*, setCacheProperty, setChartProperty, setClientStore, setFont, setJvmConfig*, setJvmProperty, setLastClientID, setRuntimeProperty, setScopeProperty, splitargs*, stopApplication
inherited methods: dump, getEdition, getInstallType, getJRunRootDir, isAdminUser, RDSInvoker, setJrunSN

* – private method

backup*
private void backup ( daFile
)

Creates a backup (.bak) version of the specified file.

Output: suppressed
Parameters:
daFile: any, optional, daFile – Name of file for which to create a backup copy.

clearComponentCache
void clearComponentCache (

)

Clears the Component cache.

Output: suppressed

clearTrustedCache
void clearTrustedCache ( templateList=""
)

Clears the template cache.

Output: suppressed
Parameters:
templateList: any, optional, templateList – a comma separated list of compiled templates full path to be deleted from cache

deleteClientStore
public deleteClientStore ( required string name
)

Removes a data source type of client variable store.

Available only for users in one of the roles: admin
Output: suppressed
Parameters:
name: string, required, name – Name of data source to remove as a client variable store.

deleteFont
public deleteFont ( required fontFile
)

Deletes a font from the ColdFusion list of registered fonts.

Output:

suppressed
Parameters:
fontFile: any, required, fontFile – Name of the font to delete.

executeClassPath*
private executeClassPath ( required name
)

Executes the named executable process with the specified classpath setting.

Output:
Parameters:
name: any, required, name – Name of executable process to run on the ColdFusion server.

getCacheProperty
public any getCacheProperty ( required propertyName
)

Returns the value of a ColdFusion cache property setting.

Output: suppressed
Parameters:
propertyName: any, required, propertyName – Valid Properties are:

  • ComponentCache
  • TrustedCache
  • InRequestTemplateCache
  • TemplateCacheSize
  • SaveClassFiles
  • CacheRealPath
  • MaxCachedQuery
getChartProperty
public any getChartProperty ( required propertyName
)

Returns the value of a Charting property.

Output: suppressed
Parameters:
propertyName: any, required, propertyName – Valid Properties are:

  • CacheSize
  • CacheType
  • CachePath
  • Threads
getClientStores
public getClientStores ( string name
)

Returns a specific client data store or a list of client data stores.

Available only for users in one of the roles: admin
Output: suppressed
Parameters:
name: string, optional, name – Name of a specific client data store.

getFonts
public struct getFonts ( fontFamily
)

Returns font information (family, face, type, use, path) for all fonts or for a specified font.

Output: suppressed
Parameters:
fontFamily: any, optional, fontFamily – Specifies a font name.

getJvmProperty
public any getJvmProperty ( required propertyName
)

Returns the value of a Java Virtual Machine (JVM) property.

Output: suppressed
Parameters:
propertyName: any, required, propertyName – Valid Properties are:

  • MinJVMHeapSize
  • MaxJVMHeapSize
  • ClassPath
  • JVMArguments
getLastClientID
public numeric getLastClientID (

)

Returns the ID for the last client.

Available only for users in one of the roles: admin
Output: suppressed

getOption*
private getOption ( required option
)

Returns the value of a specified JVM option.

Output:
Parameters:
option: any, required, option – Name of the option to retrieve.

getOptionList*
private getOptionList ( required vmArgs
)

Splits JVM arguments into a list that can be handled one by one.

Output:
Parameters:
vmArgs: any, required, vmArgs – JVM arguments.

getPath
public getPath ( required path, required type
)

Filters the classpath to replace ‘;’ and ‘:\\’ with commas, specifying whether to remove or return ColdFusion-only items.

Output: suppressed
Parameters:
path: any, required, path – Classpath string to parse.
type: any, required, type – Specify ‘cf’ for this parameter to return ColdFusion-only items.

getProps*
private getProps (

)

Returns the Java configuration properties (server configuration only).

Output:

getRuntimeProperty
public any getRuntimeProperty ( required propertyName
)

Returns the value of a ColdFusion performance property setting.

Output: suppressed
Parameters:
propertyName: any, required, propertyName –
Valid Properties are:

  • AllowExtraAttributes
  • CFCLimit
  • CFFormScriptSrc
  • CFThreadLimit
  • CFCTypeCheck
  • DisableServiceFactory
  • EnablePerAppSettings
  • FlashRemotingLimit
  • GlobalScriptProtect
  • HTTPStatusCodes
  • JRunActiveHandlerThreads
  • JRunMaxHandlerThreads
  • MissingIncludeHandler
  • PostSizeLimit
  • RequestLimit (same as SimultaneousThreads)
  • RequestQueueTimeout
  • RequestQueueTimeoutPage
  • RequestThrottleThreshold
  • RequestThrottleMemory
  • ReportThreads
  • SerialNumber
  • SimultaneousThreads
  • SiteWideErrorHandler
  • TimeoutRequests
  • TimeoutRequestTimeLimit
  • WebServiceLimit
  • Whitespace
  • SecureJSON
  • SecureJSONPrefix
  • serverCFC
  • AppCFCLookupOrder
  • GoogleMapKey
getScopeProperty
public any getScopeProperty ( required propertyName
)

Returns the value of a scope property.

Output: suppressed
Parameters:
propertyName: any, required, propertyName – Valid Properties are:

  • clientStorage
  • clientStore
  • UUIDCFToken
  • enableJ2EESessions
  • enableSessionScope
  • sessionScopeTimeout
  • sessionScopeMaxTimeou
  • enableApplicationScope
  • applicationScopeTimeout
  • applicationScopeMaxTimeout
saveJvmConfig*
private saveJvmConfig (

)

Saves the JVM configuration setting to the jvm.config file (server configuration only).

Output:

setCacheProperty
public void setCacheProperty ( required propertyName, required propertyValue
)

Sets the value of a ColdFusion cache property setting.

Output: suppressed
Parameters:
propertyName: any, required, propertyName – Valid Properties are:

  • ComponentCache
  • TrustedCache
  • InRequestTemplateCache
  • TemplateCacheSize
  • SaveClassFiles
  • CacheRealPath
  • MaxCachedQuery

propertyValue: any, required, propertyValue – Value to set for the specified property.

setChartProperty
public void setChartProperty ( required propertyName, required propertyValue
)

Sets the value of a Charting property.

Output: suppressed
Parameters:
propertyName: any, required, propertyName – Valid Properties are:

  • CacheSize
  • CacheType
  • CachePath
  • Threads

propertyValue: any, required, propertyValue – Value to set for the specified property.

setClientStore
public setClientStore ( required string description, required boolean disable_globals, required string name, required boolean purge, required numeric timeout, required string type, string dsn=""
)

Sets the properties of a client data store.

Available only for users in one of the roles: admin
Output: suppressed
Parameters:
description: string, required, description – A description of the client data store and its settings.
disable_globals: boolean, required, disable_globals – Specifies whether to disable global client variables. Specify true or false.
name: string, required, name – Name of client data store:

  • Registry
  • Cookie
  • data source name

purge: boolean, required, purge – Set to have ColdFusion periodically purge client data that has not been accessed in the specified number of days – true/false
timeout: numeric, required, timeout – Number of days after which ColdFusion is to purge client data that has not been accessed.
type: string, required, type – Type of client data store.
dsn: string, optional, dsn – If client data store is a data source, name of the data source.

setFont
public setFont ( required fontFile
)

Adds a new font and registers it with ColdFusion.

Output: suppressed
Parameters:
fontFile: any, required, fontFile – Specifies a fully qualified path/filename to the font file to add.

setJvmConfig*
private void setJvmConfig ( minHeapArg="[runtime expression]", maxHeapArg="[runtime expression]", jvmArgs="[runtime expression]"
)

Sets JVM arguments in the JRun jvm.config file (server configuration only).

Output: suppressed
Parameters:
minHeapArg: any, optional, minHeapArg – Minimum heap size.
maxHeapArg: any, optional, maxHeapArg – Maximum heap size.
jvmArgs: any, optional, jvmArgs – Other JVM arguments.

setJvmProperty
public void setJvmProperty ( required propertyName, required propertyValue
)

Sets the value of a Java Virtual Machine property.

Output: suppressed
Parameters:
propertyName: any, required, propertyName – Valid Properties are:

  • MinJVMHeapSize
  • MaxJVMHeapSize
  • ClassPath
  • JVMArguments

propertyValue: any, required, propertyValue – The value to set for the specified property.

setLastClientID
public void setLastClientID ( required numeric lastid
)

Stores the ID of the last client to visit the site.

Available only for users in one of the roles: admin
Output: suppressed
Parameters:
lastid: numeric, required, lastid – ID number for the last client.

setRuntimeProperty
public void setRuntimeProperty ( required propertyName, required propertyValue
)

Sets the value of a ColdFusion performance property.

Output: suppressed
Parameters:
propertyName: any, required, propertyName –
Valid Properties are:

  • AllowExtraAttributes
  • CFCLimit
  • CFFormScriptSrc
  • CF5Compatibility
  • CFThreadLimit
  • CFCTypeCheck
  • DefaultCharset
  • DisableServiceFactory
  • EnablePerAppSettings
  • FlashRemotingLimit
  • GlobalScriptProtect
  • HTTPStatusCodes
  • JRunActiveHandlerThreads
  • JRunMaxHandlerThreads
  • MissingIncludeHandler
  • PostSizeLimit
  • RequestLimit (same as SimultaneousThreads)
  • RequestQueueTimeout
  • RequestQueueTimeoutPage
  • RequestThrottleThreshold
  • RequestThrottleMemory
  • ReportThreads
  • SerialNumber
  • SimultaneousThreads
  • SiteWideErrorHandler
  • TimeoutRequests
  • TimeoutRequestTimeLimit
  • WebServiceLimit
  • Whitespace
  • SecureJSON
  • SecureJSONPrefix
  • serverCFC
  • AppCFCLookupOrder
  • GoogleMapKey

propertyValue: any, required, propertyValue – Value to set for the specified property.

setScopeProperty
public void setScopeProperty ( required propertyName, required propertyValue
)

Sets the value of a scope property.

Output: suppressed
Parameters:
propertyName: any, required, propertyName – Valid Properties are:

  • clientStorage
  • clientStore
  • UUIDCFToken
  • enableJ2EESessions
  • enableSessionScope
  • sessionScopeTimeout
  • sessionScopeMaxTimeou
  • enableApplicationScope
  • applicationScopeTimeout
  • applicationScopeMaxTimeout

propertyValue: any, required, propertyValue – Value to set for the specified property.

splitargs*
private splitargs ( required string
)

Splits a list of string arguments into an array.

Output:
Parameters:
string: any, required, string – Internal use.

stopApplication
void stopApplication ( required appName
)

Stops the named application.

Output: suppressed
Parameters:
appName: any, required, appName – Name of the application

Leave a Reply

Your email address will not be published. Required fields are marked *

*

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>