Dialogic DSI SS7MD - Manual (Page 167)

167
Dialogic
®
DSI SS7MD Programmer’s Manual Issue 3
8.3 gctload
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 -m -Ci
-Co -Ca
-d -v -t1 -t2 -x]
Command Line Options
The gctload utility supports the following command line options:
•
-c
Specifies the system configuration file, . If not selected, a default filename of system.txt is
assumed.
•
-m
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
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
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
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.