Maintaining configuration files
Configuration files define the operating environment for IBM® Connect:Direct®. The following configuration files are created during the customization procedure:
- Initialization parameters file
- Client configuration parameters file
- Network map file
- Two access files: userfile.cfg and sysacl.cfg
After the initial customization, you can modify these files, if necessary.
A configuration file is a text file composed of records. A record is a single logical line. A logical line is one or more physical lines that can be continued with the backslash (\) character. In the sample format below, physical lines 4 and 5 illustrate a logical line. Line 4 ends with a backslash (\) character, to indicate that the line is continued on the next physical line. Line 1 of the sample begins with a pound (#) sign. The pound sign indicates this line contains a comment.
A record consists of a record name and one or more parameter pairs. A parameter pair is a parameter name and parameter value. Line 2 contains the record name, ndm.path. Line 2 also contains the parameter pair, path and /ndm/users/c, where the parameter name is path and the parameter value is /ndm/users/c. The parameter pair is bound by colons (:) and separated by an equal sign (=) in the following format. The following example displays a complete record, where ndm.path is the record name, path is the parameter name, and /ndm/users/c is the parameter value:
|
Record names and parameter names are not case sensitive. Parameter values are case sensitive.
Lines 7 through 23 illustrate a longer logical record. Line 7 contains the record name local.node followed by an optional colon (:) and a backslash (\) character. All lines between 7 and 23 end with a backslash (\) character. Line 23 does not contain a backslash (\) character, to indicate the end of the record.
Sample format of a configuration file
The following table displays a portion of the initialization parameters file to illustrate the format of IBM Connect:Direct configuration files:
Line | Contents | Notes |
---|---|---|
1 | #Miscellaneous Parameters |
# indicates a comment |
2 | ndm.path:path=/ndm/users/c: |
record name=ndm.path, parameter=path, value= /ndm/users/c |
3 | proc.prio:default=8: |
record name=proc.prio, parameter=default, value= 8 |
6 | #Local IBM Connect:Direct connection
information |
# indicates a comment |
7 | local.node:\ |
record name=local.node |
13 | . | |
. . . | . | |
21 | . | |
22 | :tcp.api=rusty;3191:\ |
parameter= tcp.api, value= rusty;3191 |
23 | :tcp.api.bufsize=32768: |
parameter= tcp.api.bufsize, value= 32768 |
Configuration files allow duplicate but not identical records, in some cases. For example, you can define more than one remote node information (rnode.listen) record in the initialization parameters file.