8 Host Utilities

•-x

Terminate a running system. An active instance of the gctload module, together with any forked binaries, is terminated if a subsequent call of gctload binary is made with the -x parameter.

Example

To run gctload with the system.txt file as the configuration file, a congestion onset value of 70, a congestion abatement value of 30, and a message pool size of 2000, the command is:

gctload -csystem.txt -Co70 -Ca30 -m2000

8.3.1System Status (gctload -t1)

For diagnostic purposes, it is possible to determine message queue statistics using gctload with an additional command line option. When a host is running (having already started gctload), run gctload a second time with either the -t1 or -t2 option to display message statistics to the console. The -t1 option causes gctload to print the current system statistics.

For example, the command:

gctload -t1

generates output similar to the following:

GCTLOAD System status:

 

MSGs in system:

2000

MSGs allocated:

1

MSGs free:

 

1999

Maximum MSGs allocated:

155

Out of MSG

count:

0

Internal system error:

0

Congestion

module Id:

0x20

Congestion

onset:

1000

Congestion

abate:

200

Congestion

status:

0

Congestion

count:

0

GCTLIB library:

V1.19

A rising number of allocated messages indicates that there is a problem, for example, messages may be being sent to a non-existent queue or no process in the system is reading from the associated destination queue. The behavior of the system after it has run out of messages may be unstable and in these conditions, the gctload environment should be restarted. The contents of the currently allocated messages may be shown using the -t2 option, see Section 8.3.2 below.

8.3.2Show All Currently Allocated API messages (gctload -t2)

Caution: The gctload command with the -t2 option should not be used on live systems, since it locks the system until all messages have been printed out, an operation that can take a significant amount of time. The -t2 option is intended for use during fault finding on a system that has not been configured correctly.

Issuing the gctload command with the -t2 option generates a printout of all the currently allocated messages to the console. Messages are displayed in hexadecimal format as follows:

M t<type> i<id> f<src> d<dst> s<status> e<err_info> p<param>

where each field contains the value of the corresponding message field in hexadecimal format.

For example, the following command:

gctload -t2

generates output similar to the following:

M-t0f83-i0000-fb0-def-s02

M-t0f83-i0000-fb0-def-s01

M-t0f0d-i0000-fdf-def-s19

M-t0201-i0000-f71-def-s03

M-t0201-i0000-f71-def-s02

M-t0201-i0000-f71-def-s03

M-t0201-i0000-f71-def-s02

168

Page 168
Image 168
Dialogic DSI SS7MD manual System Status gctload -t1, Generates output similar to the following