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

2 thoughts on “runtime.cfc”

  1. Where did you find the list of valid properties for calls like runtime.getCacheProperty()? I’ve been looking everywhere for this information. Thank you for putting it out here!

Comments are closed.