Dialogic DSI SS7MD manual Gctload, Display version information Enable diagnostic tracing

Dialogic® DSI SS7MD Programmer’s Manual Issue 3

8.3gctload

Description

gctload is a task that initializes the host system environment and starts up all other processes (such as ssd), deriving the process and message queue configuration from a text file. For further details of the operation of gctload, refer to the Software Environment Programmer's Manual. The gctload task derives its configuration from a text file, typically called system.txt.

The gctload task can be run on an active system to provide tracing information that indicates the system state (-t1, -t2 flags) and it can also be used to terminate an active system (-x flag).

Syntax

gctload [-c<filename> -m<message pool size> -Ci<congestion module id> -Co<congestion onset threshold> -Ca<congestion abatement threshold> -d -v -t1 -t2 -x]

Command Line Options

The gctload utility supports the following command line options:

•-c<filename>

•

•

Specifies the system configuration file, <filename>. If not selected, a default filename of system.txt is assumed.

-m<message pool size>

Specifies the message pool size, that is the number of messages available on the host. If this option is not defined, the default message pool size is 200.

Note: For systems using DSI SS7MD Boards, a higher system throughput is expected; therefore the size of the pool should be increased to at least 2000.

Note: For Linux systems, the kernel.msgmnb value may also have to be increased to ensure stable operation. See Section 3.2.3, “Support for a Large Number of DSI Messages” on page 21.

-Ci<congestion module id>

Specifies the congestion-handling module ID. If this ID is set to the module ID of ssdm (0x20), then ssdm stops reading messages from the board until the congestion abates.

•-Co<congestion onset threshold>

Specifies the congestion (overload) onset threshold, that is, the percentage of the total number of available messages that must be allocated before the system starts congestion procedures. The default is 50% of the messages in the message pool defined by the -m option. Once this threshold is reached, the congestion-handling module specified by the -Ci option is notified and should take steps to reduce the system loading.

•-Ca<congestion abatement threshold>

Specifies the congestion abatement threshold, that is, the percentage of the total number of messages that must be available before the system stops congestion procedures. The default is 10% of the messages in the message pool defined by the -m option. Once the message pool size drops back below this threshold, the congestion-handling module, as specified by the -Ci option, is notified and can return the system to normal loading levels.

•-t1

Display system trace information (short). See Section 8.3.1, “System Status (gctload -t1)” on page 168 for more information.

•-t2

•

•

Display system trace information (long). See Section 8.3.2, “Show All Currently Allocated API messages (gctload -t2)” on page 168 for more information.

-v

Display version information.

-d

Enable diagnostic tracing.

167