V1 R2.5 Configuration Files
30 July 1999
http://www.ibm.com/nc/pubs
Table of Contents
Release
2.5 Configuration Files
Editing
Configuration Files
Attention: This information is intended for advanced users that
understand the consequences of directly editing configuration files. The
IBM Network Station Manager program is the preferred method to change configuration
parameters. These parameters are subject to change at any time. IBM
provides program support for configuration files that are automatically
edited through ordinary use of the IBM Network Station Manager program,
and the files that are manually edited in accordance with the full-screen
solutions .
The IBM Network Station network computer (hereafter referred to as Network
Station) configuration files contain parameters (or settings) that set
the configuration of the IBM Network Station. Most frequently used parameters
can be set through the IBM Network Station Manager program. Other parameters
can only be set through the use of editable configuration files. A description
of these parameters can be found in NCDware's
Remote Configuration Parameter
Quick Reference. You can obtain this document from Network Computing
Devices, Inc. (the US telephone number is 650-694-0650). This information
is also available on some platforms in the following files:
-
RS/6000 - /usr/netstation/configs/configd.doc
-
OS/390 - /usr/lpp/tcpip/nstation/standard/StationConfig/configd.doc
-
PC Server - d:\nstation\configd2.doc where d: is a drive letter
| Note: |
The files described in this section contain hardware
settings. Do not confuse hardware settings with application settings and
startup settings. |
The following tables list the configuration files that are shipped with
the IBM Network Station Manager program. The tables indicate which files
can be edited and which files should not be edited.
Attention: Do not edit any files that are marked No in the Edit
column of the following tables. If you edit these files, your changes may
be overwritten by the IBM Network Station Manager program, and they may
not be migrated in future releases.
The settings in these files are the basic system-wide settings. These settings
apply to all IBM Network Stations.
| File Name |
Edit |
Description |
| standard.nsm |
No |
This is the master file that controls the other
configuration files downloaded by the IBM Network Station. |
| required.nsm |
No |
This file contains the settings for base IBM
Network Station functions. These settings are not configurable through
the IBM Network Station Manager program. |
| control.nsm |
No |
This file contains the default settings in the
IBM Network Station Manager program. |
| hosts.nsm |
No |
This file contains TCP/IP settings set through
the IBM Network Station Manager program. |
| defaults.nsm |
No |
This file contains the settings set through the
IBM Network Station Manager program. |
| defaults.dft |
Yes |
This file may be created if it does not exist.
Configuration settings added to this file take precedence over settings
in required.nsm, control.nsm, and defaults.nsm. IBM Network Station Manager
program does not read or write this file. |
| local.nsm |
Yes |
Found on the RS/6000 platform only. This file
is created during RS/6000 installation with settings specific to the system
where the IBM Network Station Manager program is being installed. This
file may be edited by customers and changes are migrated on the next installation. |
The defaults.dft file is in the following directory:
| AS/400 |
/QIBM/UserData/NetworkStation/StationConfig/ |
| PC Server |
d:\nstation\configs\ (where d: is a drive letter) |
| OS/390 |
/etc/nstation/system/StationConfig/ |
| RS/6000 |
/usr/netstation/configs/ |
| VM/ESA |
/QIBM/UserData/NetworkStation/StationConfig/ |
The local.nsm file is in the following directory: /usr/netstation/configs/.
These files are specific to a particular IBM Network Station. The settings
in these files take precedence over the system-wide files.
| File Name |
Edit |
Description |
| "name" |
No |
This is the master file that controls the other
configuration files called "name". Where "name" is the TCP/IP host name
of the IBM Network Station. |
| "name".nst |
No |
This file contains the settings that are set
through the IBM Network Station Manager program for the IBM Network Station
called "name". |
| "name".trm |
Yes |
This file cannot be edited until it is created
by the IBM Network Station Manager program. The IBM Network Station Manager
program creates this file when the IBM Network Station is configured. Settings
added to this file take precedence over settings in the "name".nst. The
IBM Network Station Manager program does not read or write this file. |
The "name".trm files are in the following directory:
| AS/400 |
/QIBM/UserData/NetworkStation/StationConfig/ |
| PC Server |
d:\nstation\configs\ (where d: is a drive letter) |
| OS/390 |
/etc/nstation/system/StationConfig/ |
| RS/6000 |
/usr/netstation/configs/ |
| VM/ESA |
/QIBM/UserData/NetworkStation/StationConfig/ |
These files are specific to a particular IBM Network Station user. The
settings in these files take precedence over the system-wide files and
individual Network Station files.
| File Name |
Edit |
Description |
| "username".nsu |
No |
This file contains the settings that are set
through the IBM Network Station Manager program for the IBM Network Station
user called "username". Where "username" is the name of the user. |
| "username".usr |
Yes |
This file cannot be edited until it is created
by the IBM Network Station Manager program. The IBM Network Station Manager
program creates this file when the IBM Network Station user is configured.
Settings added to this file take precedence over settings in the "username".nsu.
The IBM Network Station Manager program does not read or write this file. |
The "username".usr files are in the following directory:
| AS/400 |
/QIBM/UserData/NetworkStation/"username"/ |
| PC Server |
d:\nstation\userdata\"username"\ (where d: is
a drive letter) |
| OS/390 |
/etc/nstation/user/"username"/nsm/ |
| RS/6000 |
/usr/netstation/nsm/"username"/ |
| VM/ESA |
/QIBM/UserData/NetworkStation/"username"/ |
The sequence that the configuration files are downloaded is important.
In the case of conflicting parameters appearing in two files, the last
file that is downloaded sets the parameter. The configuration files are
downloaded from the server to the IBM Network Station in the following
order:
| __ 1. |
During boot (pre-login):
| __ a. |
Download system-wide files (apply to all IBM Network Stations):
| __ 1) |
standard.nsm |
| __ 2) |
required.nsm |
| __ 3) |
control.nsm |
| __ 4) |
local.nsm (editable, RS/6000 only) |
| __ 5) |
hosts.nsm |
| __ 6) |
defaults.nsm |
| __ 7) |
defaults.dft (editable) |
|
| __ b. |
Download files associated with a particular IBM Network Station:
| __ 1) |
"name" |
| __ 2) |
"name".nst |
| __ 3) |
"name".trm (editable) |
|
|
| __ 2. |
During login
-
Download files associated with the user
| __ a. |
"username".nsu |
| __ b. |
"username".usr (editable) |
|
If you have already changed one or more of the files that should not be
edited, you need to do the following steps. If you do not make these changes,
your settings will be lost when you install Release 3.
-
If you changed standard.nsm, required.nsm, control.nsm, hosts.nsm, or defaults.nsm,
move the added or changed statements in those files to the defaults.dft
file.
-
If you changed any "name" or "name".nst files, move the added or changed
statements in those files to "name".trm files.
-
If you changed any "username".nsu files, move the added or changed statements
in those files to "username".usr files.
-
If you changed any other Network Station Manager file, see Migrating
to Release 3 for instructions on how to keep these changes in Release
3.
-
If you created a new file and changed standard.nsm to include the new file,
move the statements in the new file to the defaults.dft file.
Attention: Do not simply copy the contents of the changed files
to the editable files. This may cause unpredictable results. Move only
the new or changed information to the editable files.
Before you begin editing, make a copy of the original file.
The configuration files that are marked Yes in the Edit column should
be in UNIX format. This means that lines must end with a line feed, not
a carriage return-line feed. The editor that you use must not insert carriage
returns.
The exceptions are startup files, which may contain carriage returns.
Any ASCII editor may be used for these files.
The files marked ASCII in the file format column must only contain invariant
(ISO 8859-1) characters.
Generally you are not required to edit Unicode (UCS-2) files. All of
the files that are marked Yes in the Edit column may be ASCII files. You
would create Unicode files only if you need to enter UCS-2 characters (for
example, Chinese). Unicode files must contain big endian UCS-2 characters.
The first 2-bytes must contain the byte order mark (BOM). The BOM must
be FEFF (big endian).
On a PC, we recommend editing the files by using one of the following
editors to avoid damaging the files:
-
Microsoft WordPad
-
IBM EPM
On the AS/400, we recommend using Client Access to access the files. You
can also ftp the files (in binary format) from the AS/400 to another system,
edit the files, and then ftp the files back (in binary format) to the AS/400.
On the RS/6000 platform, you can use the vi editor or any other UNIX
editor.
On the OS/390 platform, we recommend using the aedit editor.
On the VM/ESA platform, we recommend using the ASCXED editor to edit
files in the client mode.
You may also want to consult the Redbooks for additional information
on selecting editors and editing the configuration files.
In order to edit "name".trm and "username".usr files, you must first
create these files by using the IBM Network Station Manager program. For
example, to create the bob.usr file, you first need to create a user preference
for bob (such as a mouse setting) using the IBM Network Station Manager
program. The IBM Network Station Manager program creates these files with
the proper permissions and links.
|
