%CSP.Mgr.GatewayMgrImpl
hidden class %CSP.Mgr.GatewayMgrImpl extends %Library.RegisteredObject, %CSP.Mgr.GatewayMgr
Method Inventory
- %OnNew()
- ActivateCSPIni()
- CheckPermissions()
- ClearCSPLog()
- ClearCache()
- ClearCacheInternal()
- CloseConnections()
- GetApplicationParams()
- GetApplicationPaths()
- GetCSPIni()
- GetCSPLog()
- GetDefaultParams()
- GetInfo()
- GetServerParams()
- GetServerStatus()
- GetServers()
- GetSystemMetrics()
- GetSystemStatus()
- GetThisServerName()
- SetApplicationParams()
- SetDefaultParams()
- SetServerParams()
- SetServerStatus()
Methods
If this method returns an error then the object will not be created.
It is passed the arguments provided in the %New call. When customizing this method, override the arguments with whatever variables and types you expect to receive from %New(). For example, if you're going to call %New, passing 2 arguments, %OnNew's signature could be:
Method %OnNew(dob as %Date = "", name as %Name = "") as %Status If instead of returning a %Status code this returns an oref and this oref is a subclass of the current class then this oref will be the one returned to the caller of %New method.
Security: To call this method, you must have one of the following roles assigned: %All or %Manager.
Security: To call this method, you must have one of the following roles assigned: %All or %Manager.
The values of clearFilenames determines the exact action of the method.
- An empty or undefined value indicates that the entire cache should be cleared.
- A list of the file names to be purged from the cache.
- A file name may contain a
wildcard, '*'.
1. Clear all forms named 'zenutils.js', regardless of path: */zenutils.js 2. Clear all forms from the '/csp/samples/images/' location: /csp/samples/images/* 3. Clear all forms whose path/name contains the '/Zen_' token: */Zen*
Security: To call this method, you must have one of the following roles assigned: %All or %Manager.
connections specifies which connections are to be closed:
Value | Connections Closed|
---|---|
* | All connections |
Server Name | Close connections to a specific server, e.g. LOCAL |
number | Close a specific connections, e.g. 3 |
list of numbers | Close a list of specific connections, e.g, $lb(2,5,7) |
Security: To call this method, you must have one of the following roles assigned: %All or %Manager.
path indicates the application path whose parameters are being requested. See the GetApplicationPaths()() method to obtain a list of the application paths defined for this Gateway.
configAry [name,value] pairs are returned in local array
See SetApplicationParams() for a list of parameters.
Security: To call this method, you must have one of the following roles assigned: %All, %Manager or %Operator.
appPaths is a list of strings, each an application path.
Security: To call this method, you must have one of the following roles assigned: %All, %Manager or %Operator.
format is the return format:
"array" - return as
an array.
"stream" - returns as a %Stream.GlobalCharacter.
cspIni
If format="array", tke values are returned in a two-level array. A partial example:
cspini("[APP_PATH:/]", "Default_Server" ) = "LOCAL" cspini("[APP_PATH:/csp]", "Default_Server") = "LOCAL" cspini("[APP_PATH:/csp]", "GZIP_Minimum_File_Size") = "0" cspini("[LOCAL]", "Ip_Address") = "127.0.0.1" cspini("[LOCAL]", "Maximum_Server_Connections") = "4" cspini("[LOCAL]", "Maximum_Session_Connections") = "3" cspini("[LOCAL]", "Minimum_Server_Connections") = "30" cspini("[LOCAL]", "Username") = "CSPSystem"
If format="stream", the data is returend as a %Stream.GlobalCharacter object which allows the CSP Ini text to be parsed directly.
Security: To call this method, you must have one of the following roles assigned: %All, %Manager or %Operator.
cspLogStream is a %Stream.GlobalCharacter stream from which you can read the lines of the returned from the event log When you close the stream, the temporary data from the server will be removed.
startDateTime the time from which to start returning events. The format the date one of the following:
C format: e.g.: Fri Apr 01 22:28:23 2011 RFC1123 format: e.g.: Mon, 26 Jul 2010 15:09:28 GMT
The value "now" [default] will be replaced by the current date and time.
direction the direction to scan for events: 1 -> forward; -1 -> backward
nEvents the number of Events to return from the event file. Each event consists of, at least, three CRLF separated lines. Caution: The CSP Log file contains tens of thousands of lines of text. If you request too many events in one call, GetCSPLog() will timeout waiting for the Gateway to finish transfering all the data.
Security: To call this method, you must have one of the following roles assigned: %All, %Manager or %Operator.
config values are returned as named parameters of the object. See SetDefaultParams() for a list of parameters.
configAry [name,value] pairs are returned in local array
Security: To call this method, you must have one of the following roles assigned: %All, %Manager or %Operator.
format is the return format:
"object" - return as
%CSP.Mgr.GatewayInformation object;
"stream" - returns as the information as XML in a %Stream.GlobalCharacter.
info if format="object" this is an instance of the
%CSP.Mgr.GatewayInformation class.
if format="stream", this is a %Stream.GlobalCharacter containing the information as XML
<?xml version="1.0" encoding="UTF-8" ?> <GatewayInformation> <Version>2011.2.0.202.0</Version> <Build>1102.1226</Build> <WebServerName>localhost</WebServerName> <WebServerPort>57773</WebServerPort> <WebServerSoftware>Apache Cache_Server_Pages-Apache_Module/2011.2.0.202.0-1102.1226</WebServerSoftware> <ActiveInterface>apapi</ActiveInterface> </GatewayInformation>
Security: To call this method, you must have one of the following roles assigned: %All, %Manager or %Operator.
server indicates that server path whose values are being requested. See the GetServers()() method to obtain a list of the servers defined for this Gateway.
configAry [name,value] pairs are returned in local array
See SetServerParams() for a list of parameters.
Security: To call this method, you must have one of the following roles assigned: %All, %Manager or %Operator.
GetServerStatus() retrieves the 'online' status for either a single or a specified range of Caché servers
path is the application path as defined in the Gateway Configuration (or "*" for all)
server is the Caché server name as defined in the Gateway configuration (or "*" for all)
An array of servers and their status is returned as follows:
statusAry(path,server_number)=$List(server, status)
Where status is '1' for online and '0' for offline
Security: To call this method, you must have one of the following roles assigned: %All, %Manager or %Operator.
serverList is a list of strings, each the name of a configured server.
Security: To call this method, you must have one of the following roles assigned: %All, %Manager or %Operator.
metricsAry [name,value] pairs are returned in local array
Security: To call this method, you must have one of the following roles assigned: %All, %Manager or %Operator.
GetSystemStatus() gets the System Status.
format is the return format:
"object" - return as a Caché object;
"stream" - returns as the information as XML.
systemStatus if format="object" returned as an instance of a %CSP.Mgr.GatewaySystemStatus
object. There are the following main
sections to the status: Connections, Cache Servers, Application Paths, Alternative Servers, and Cached Form.
if format="stream", this is a %Stream.GlobalCharacter containing the information as XML
Connection, number | |
WebServerPID | |
CacheServerName | |
IpAddress | |
TCPPort | |
CacheServerPID | |
Status | |
IdleTime | |
Activity | |
CacheServer, number | |
CacheServerName | |
IpAddress | |
TCPPort | |
TotalConnections | |
ConnectionsInUse | |
PrivateConnections | |
Activity | |
QueuedRequests | |
Application Path, path | |
AlternativeServer | |
CacheServerName | |
Activity | |
Status | |
Alternative Server, number | |
CacheServerName | |
Activity | |
Status | |
CachedForms | |
FormsInCache | |
CachedData | |
CacheActivity | |
CachedForms,Form, form name | |
Size | |
Activity |
Security: To call this method, you must have one of the following roles assigned: %All, %Manager or %Operator.
serversAry [number,name] pairs are returned in local array
Security: To call this method, you must have one of the following roles assigned: %All, %Manager or %Operator.
path indicates that application path being updated. See the GetApplicationPaths()() method to obtain a list of the application paths defined for this Gateway.
configUpdates a local array whose [name,value] pairs are used to update the configuration.
Param Name | Description |
---|---|
Application_Status | Service Status: Enabled, Disabled |
Extra_CGI_Env_Variables | Extra CGI Environment Variables |
Proc_Class | Process with this class |
GZIP_Compression | GZIP Compression: Enabled, Disabled |
GZIP_Mininum_File_Size | GZIP minimum file size |
GZIP_Exclude_File_Types | GZIP exclude file types |
KeepAlive | Keep alive: Enabled, Disabled, No Action |
Non_Parsed_Headers | Non-parsed headers: Enabled, Disabled |
Default_Server | Default server |
Alternative_Servers | Alternative Servers. This takes one of the following values: LoadBalancing - Load balancing and failover FailOver - Failover only Disabled - Disabled |
Alternative_Server_[n] | Alternative server |
Alternative_Server_[n]_Status | Alternative Server Status: Enabled, Disabled, OFFLINE |
Security: To call this method, you must have one of the following roles assigned: %All or %Manager.
configUpdates a local array whose [name,value] pairs are used to update the configuration.
Param Name | Description |
---|---|
Instance_Host_Name | Instance host name |
SM_Forms | Access to these forms |
Username | User name |
Password | Password All passwords will be encrypted (as appropriate) before they are saved in CSP.ini. |
SM_Timeout | Session Timeout |
System_Manager | System Manager Machine(s) |
System_Manager_UNPW_Override | Override Username and Password Checkbox "1"=checked; ""=unchecked |
Server_Response_Timeout | Server response timeout |
Queued_Request_Timeout | Queued request timeout |
No_Activity_Timout | No activity timeout |
Env_Parameters | Event Log Level |
Event_Log_File | Event log file |
Event_Log_Rotation_Size | Event log rotation size |
Document_Root | Web document root |
ASP_Directory | Temp ASP Directory |
WS_Service_Status | Service State: Enabled,Disabled |
NSD_Document_Root | NSD Document Root |
Server_Error | Server Error |
Server_Busy | Server_Busy |
Server_Unavailable | Server Unavailable |
Server_Timeout | Server timeout |
Connection_Closed | Connection closed |
Security: To call this method, you must have one of the following roles assigned: %All or %Manager.
server indicates that server path being updated. See the GetServers()() method to obtain a list of the servers configured on this Gateway.
configUpdates a local array whose [name,value] pairs are used to update the configuration.
Param Name | Description |
---|---|
Server_Status | Server status: Enabled, Disabled |
Ip_Address | IP Address |
TCP_Port | TCP Port |
Minimum_Server_Connections | Minimum server connections |
Maximum_Server_Connections | Maximum server connections |
Connection_Security_Level | Connection Security Level This takes a numeric value: 0 Password 1 Kerberos 2 Kerberos with Packet Integrity 3 Kerboros with Encryption 10 SSL |
Product | Product This takes a numeric value: 0 Cache 1 Ensemble |
Service_Principal_Name | Service principal name |
Keytable | Key table |
SSLC_Protocol | SSL Protocol This takes a combination of numeric values: 1 SSLv2 2 SSLv3 3 TLSv1 |
SSLCC_Key_Type | SSL Key Type This takes a numeric value: 1 DSA 2 RSA |
SSLCC_Verify_Peer | SSL Verify Peer checkbox: "1"=Checked;""=Unchecked" |
SSLCC_Certificate_File | SSL Certificate File |
SSLCC_Certificate_Key_File | SSL Certifictate Key File |
SSLCC_CA_Certificate_File | SSL CA Certificate File |
Alternative Servers should be saved as a contiguous set of alternative servers as follows:
Alternative_Server_1=CACHE20071 Alternative_Server_1_Status=Enabled Alternative_Server_2=CACHE_20072 Alternative_Server_2=Disabled
Security: To call this method, you must have one of the following roles assigned: %All or %Manager.
SetServerStatus() sets the 'online' status for either a single or a specified range of Caché servers
path is the application path as defined in the Gateway Configuration (or "*" for all)
server is the Caché server name as defined in the Gateway configuration (or "*" for all)
status is '1' for online and '0' for offline
Security: To call this method, you must have one of the following roles assigned: %All or %Manager.
Inherited Members
Inherited Properties
Inherited Methods
- %AddToSaveSet()
- %ClassIsLatestVersion()
- %ClassName()
- %ConstructClone()
- %DispatchClassMethod()
- %DispatchGetModified()
- %DispatchGetProperty()
- %DispatchMethod()
- %DispatchSetModified()
- %DispatchSetMultidimProperty()
- %DispatchSetProperty()
- %Extends()
- %GetParameter()
- %IsA()
- %IsModified()
- %New()
- %NormalizeObject()
- %ObjectModified()
- %OriginalNamespace()
- %PackageName()
- %RemoveFromSaveSet()
- %SerializeObject()
- %SetModified()
- %ValidateObject()