
8 Host Utilities
•
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
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
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
For example, the command:
gctload
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
8.3.2Show All Currently Allocated API messages (gctload -t2)
Caution: The gctload command with the
Issuing the gctload command with the
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
generates output similar to the following:
168