iimonitor Commands Specific to GCF Servers
The iimonitor commands that are specific to GCF servers include the following:
• set trace
• register server
• remove tickets
• remove pooled sessions
Set Trace Command
The iimonitor set trace command dynamically enables or disables tracing on a GCF server. Dynamic tracing allows tracing to be limited to specific times, which can be useful to trap specific conditions or to reduce the volume of trace output. Dynamic tracing allows tracing to be turned on and off without having to recycle GCF servers.
Note: This command overrides trace settings in config.dat and environment variables.
The set trace command has the following format:
set trace attribute value
attribute value
Specifies the trace attribute and its value. Valid values depend on the trace attribute being set. Valid attributes are:
level, GCA, GCS, or API (iigcd only)
Specifies type of tracing to perform. “level” turns on the default tracing associated with that GCF server:
GCC—Communications Server - COMSVR (iigcc)
GCD—Data Access Server - DASVR (iigcd)
GCN—Name Server - NMSVR (iigcn)
GCA, GCS or API (for iigcd only) can be specified in addition to or instead of "level" to provide tracing for those areas in the server.
Note: The 3-character trace mnemonic is equivalent to setting Ingres variable II_XXX_TRACE or config.dat XXX_trace_level for the server connected to, where XXX is GCA, GCS, API, GCC, GCD, or GCN. For more details on tracing GCF servers for diagnostic purposes, see the Connectivity Guide and System Administrator Guide.
The associated attribute value is the level of tracing from 0-5, with a higher value providing more detailed tracing.
log
Specifies a trace output log file. The associated attribute value is the full disk path and file name of the log file or NONE to disable all tracing.
Note: All tracing from a server is directed to a single output file. As a result, any trace settings configured using a non-dynamic method (that is, configured through config.dat instead of iimonitor) will also be enabled when log is set to a trace file.
Examples: Set Trace Command
When connected to the Communications Server, the following iimonitor commands turn on GCC and GCA tracing in that server to levels 3 and 5 respectively and write the output to trace file /tmp/gcc_log:
set trace level 3
set trace GCA 5
set trace log /tmp/gcc.log
The following iimonitor command closes the log file:
set trace log NONE
Register Server Command
The iimonitor register server command allows a GCF server to dynamically register its listen address with the Name Server.
Note: Using this command is the preferred method for restoring server registrations that have been lost or manually removed.
The register server command has the following format:
register server
Remove Tickets Command
The iimonitor remove tickets command removes installation password tickets stored by the Name Server.
Note: This command is valid for the Name Server only.
The remove tickets command has the following format:
remove [all]|local|remote tickets
all
Removes all tickets.
local
Removes local tickets only.
remote
Removes remote tickets only.
Remove Pooled Sessions Command
The iimonitor remove pooled sessions command terminates all DBMS sessions in the connection pool.
Note: This command is valid for the Data Access Server (GCD process) only.
This command has the following format:
remove pooled sessions