Welltech SPCI2S Intel NetStructure SS7 Boards - Manual (Page 18)

SS7 Programmer’s Manual for SPCI2, SPCI4 and CPM8 Issue 2 Page 18
3.2 System Configuration
System configuration is handled by the program gctload which reads the system
configuration data from a file called system.txt.
System initialisation requires first that a pool of message buffers are created for
subsequent inter-process communication. Secondly that a message queue is
created for each process that will run and that any message re-direction for
modules that are running remotely is initialised. Then all processes can be started.
The program gctload exists to handle this initialisation sequence and create the
inter-process communication environment. It reads input from a text file called
system.txt, carries out all system initialisation and starts up all processes.
system.txt is a user configurable file containing details of all the module identifiers
known to the system, details of whether they are local modules or remote modules
accessed by a local module (message redirection) and lists the command line for
all processes to be started by gctload.
gctload creates a message queue for each of the local module identifiers. It
subsequently expects a process to service it’s message queue otherwise messages
written to that queue will never be read causing eventual loss of system messages.
It initialises the message queue look-up table so that messages destined for
modules that do not exist locally are re-directed to a message queue for a module
that does exist locally.
Having created the system environment, gctload proceeds to spawn all processes
listed in the system configuration file in the order listed.
Prior to running gctload the system configuration file must be edited to reflect the
requirements of your system.
3.2.1 System configuration file syntax
The system configuration file is a text file used by gctload to configure the software
environment.
The file syntax permits the use of comments to improve the readability of the file.
Comments are inserted into the file by using an asterisk *; all characters on the line
after the asterisk are ignored.
Numbers can be entered in either decimal or hexadecimal format. Hexadecimal
numbers should be prefixed with 0x. For example the value eighteen can be
entered in either of the following formats:
0x12 *(Hexadecimal)
18 *(Decimal)
The System Configuration File contains the following commands:
a) LOCAL commands to allow gctload to generate message queues for modules
running locally.