|
|
|
|
This chapter describes how to configure SNAP-IX TN3270 and the information you need.
SNAP-IX TN3270 uses a single configuration file to hold the following details of your SNAP-IX TN3270 configuration:
The host computers you can access
The TN3270 emulation functions available to individual TN3270 users
The files used to record SNAP-IX TN3270 diagnostics information
You create this single binary configuration file by first defining a configuration text file and then using the tncfgtcp program to convert the text file to a binary file.
The configuration process begins with a simple text file that contains the configuration information. A sample configuration text file, tnsample.txt, is included with SNAP-IX TN3270. The sample file is located in subdirectory /opt/tn3270/samples. You can use any standard ASCII text editor (for example, vi) to modify a copy of the sample file to include the information you need or to create a new configuration file. For more information about the contents of the configuration text file, see Understanding the Configuration Text File Records.
SNAP-IX TN3270 uses the configuration text file as input to the tncfgtcp program, which validates the configuration and generates a binary configuration file for use by SNAP-IX TN3270 components. Following is the syntax of the tncfgtcp program:
tncfgtcp filename.txt
The name of the text file to be converted to binary is filename.txt. This file name must have the extension .txt. Include the directory path if the file is not in the current directory.
If the tncfgtcp program detects an error, such as failing to find the specified text file or a syntax error in the text file, it writes a message to standard error and does not create a binary configuration file. For syntax errors, the program continues to parse the text file and writes a separate message for each error it finds. Correct the errors and run tncfgtcp again.
If no errors are found, SNAP-IX TN3270 creates the binary configuration file in the same directory as the text file. The binary configuration file has the same name as the text file but with the extension .cfg instead of .txt.
To use the new configuration file as the configuration for SNAP-IX TN3270, copy it to /etc/opt/tn3270/com.cfg.
The tncfgtcp program is stored in the directory /opt/tn3270/bin. Specify the path to this directory in one of the following ways:
Add the directory to your
Include the directory name each time you run the program, as follows:
/opt/tn3270/bin/tncfgtcp newfile.txt
The sample command lines shown in this guide assume that you have added
the directory to your
When a user starts the TN3270 program, SNAP-IX TN3270 obtains its configuration information from the file /etc/opt/tn3270/com.cfg. This file is known as the running configuration file. .
You can create several different TN3270 configurations and save them in different configuration files. To use a particular configuration, copy its binary configuration file to com.cfg in the directory /etc/opt/tn3270. Also copy the text configuration file to com.txt in the same directory so that you can easily check details of the current configuration.
It is possible to write a new configuration directly to the running configuration file /etc/opt/tn3270/com.cfg by using the file /etc/opt/tn3270/com.txt as input. However, any active copies of the TN3270 emulation program continue to run with the previous configuration and are not affected by the change. For example, if you change the parameters that control whether audit or exception messages (or both) are recorded, any active TN3270 emulation programs continue to use the previous settings. Users must stop and restart the TN3270 emulation program for the new settings to take effect.
|
|
|
 |
|