Previous Page Contents Page Next Page

6 Customizing 3270 Emulation

To customize the 3270 emulation program before beginning emulation or file transfer, follow the instructions and information in this chapter, which include the following:

To accept the system defaults and begin display or printer emulation, turn to Fast Path to 3270 Terminal Emulation, or follow the more detailed instructions in Controlling 3270 Emulation. To begin file transfer without changing your customization, refer to Transferring Files.

The System Administrator may have configured the 3270 emulation program so that you can use only the default customization settings. In this case, all the menu options described in this chapter except Key Definitions and Exit are not selectable and you cannot use them. Refer to the SNAP-IX TN3270 Administrator's Guide for information about changing the configuration file to enable you to customize the 3270 emulation program.

6.1 What Is a Style File?

A style file contains parameters that control the appearance and behavior of your Solaris terminal in 3270 emulation. These parameters determine session characteristics, display colors, host language, key definitions, audible signals, and file transfer parameters. The style file also contains any keystroke sequences you have recorded (for more information, see Keystroke Recording and Replay).

The name of the open style file is displayed on the main screen of the 3270 emulation program. If the style file that you want to change is not open, use the File menu to open it. Then use one or more of the options on the Customize menu to make changes.

6.1.1 Search Path for Style Files

When you start the 3270 emulation program, you can specify a style file name to be used (using the option on the command line). The 3270 emulation program uses the following order to find a style file:

  1. If you use the option on the command line to specify a style file name, this style file is used. The style file name must be 1-8 characters followed by the extension .stu, but you do not need to include the extension on the command line. If you specify a directory path for the file name with a fully qualified path name (for example /usr/user1/user1.stu), the program tries to open the file with the name you specify in the given directory. If you specify a directory path for the file name with a relative path name (for example styles/user1.stu ), the program tries to open the file with the name you specify in the given directory relative to your current directory. If you do not specify a path, the file is assumed to be in your current directory.

    If it finds the file, the SNAP-IX TN3270 product starts the 3270 emulation program using this style file. If it does not find the file, the SNAP-IX TN3270 product uses default settings as described in Item 3.

  2. If you do not specify a style file name on the command line, the entry you stored in the configuration file defines the default style file name. The 3270 emulation program then looks in the following places to find a file with this name:

    1. In your home directory (the directory specified on the HOME environment variable)

    2. In the same directory as the configuration file, /etc/opt/tn3270, if the HOME environment variable is not set up or if the file does not exist in your home directory.

    Because of this order of searching, you can load the default style file created by your System Administrator (which will be in the configuration file directory), modify this style to create your own version, and then save this version with the same file name in your own home directory, without overwriting the original default file. When you start the 3270 emulation program again, it looks first in your home directory, so that the style file it uses as the default will be your own version rather than the system default. Thus, you do not need to specify the name every time you start the 3270 emulation program. You can, of course, override this default by specifying another file name on the command line when you start the program.

  3. If neither the file you specify nor the default style file can be found, the 3270 emulation program uses its own built-in default settings. An error message is displayed when the program starts, to warn you that the style file specified could not be found; choose <Exit Message> to acknowledge this message.

6.1.2 Permissions to Use and Modify Style Files

Your System Administrator can configure the 3270 emulation program to restrict your use of style files in one of the following ways:

  • You may be restricted to using the default style file specified in the configuration. In this case, the 3270 emulation program uses the style file specified in the configuration (from the configuration file directory), or its own built-in default settings. It does not search your home directory for the style file. A warning message is displayed if you specify a style file on the command line, informing you that this file will not be used because you do not have permission to use it.

  • You may be permitted to specify a style file on the command line when you start the 3270 emulation program, but not to modify style files. In this case, check with your System Administrator to determine the style file name to use.

In either of these cases, most options on the File and Customize menus are not selectable, because you cannot open or save style files or modify customization settings. You can, however, use the Key Definitions menu option to check your key mappings, or the Exit menu option to exit the program. Apart from these options, the remaining functions described in this chapter are not available.

Previous Page Contents Page Top of Page Next page