Visara SCON-20L Configuration Manual - Manual (Page 61)

707044-006 6-7
Chapter 6. TN3270 Client Definition Panel
The nickname file (nickname.sys) is an ASCII text file, and can be created on a PC
using any text editor. The Visara eManager product also may be used to create, manage,
and distribute the nickname.sys file. The name of the file must be nickname.sys, and no
other file name will be recognized by LINCS. The file must be present in the system
directory on the LINCS hard drive, or on a floppy present in the floppy drive at boot
time. The file is read only at boot time, or when the utility /3/5 is run. Note that you can
only run the /3/5 utility if the file already exists, and the new file should not exceed the
original file size (read at boot time) by more than 20%.
File entries may be of the following types:
Name=resource
Where the name can be any alphanumeric name, 12 characters or less, and the resource
is a LINCS SCON-2XL resource. LINCS resources that are valid include the name of a
3270 Host Class, or a host designator followed by a comma and the two hex character
address of the desired session. Here is an example:
Console003=05,03
In this example, the resource name ‘console003’ would be configured in the TN3270E
client (LU Name field), and would be requested by the client emulator at connection
time. The resource that the 2XL will give to the client is session 03 from Host Circuit
05.
Name=resource password
This entry is exactly the same as the previous entry except that a password is added to
the end of the entry, separated from the rest of the entry with a space. In this instance, to
receive the requested resource, the user must enter the correct password. A corresponding
example is shown below:
Console003=05,03 pituitary
The password can be a combination of alphanumeric characters.
UserID-password
This type of entry is used to validate a user at connect time. It is used with all client
types defined on the TN3270 Client Definition panel that have the letters ‘ID’ included
(‘Client ID’, ‘VisaraNCT ID’, ‘Client+CC ID’). These client types will prompt the user
for a User ID, and if a valid User ID is given as found in the nickname.sys list, then the
corresponding password must be given to establish the connection. An example entry
might appear like this:
Virgil-Bonita671
Notes:
1. No white space is permitted between the name, the equal sign, and the resource, nor
within the resource notation itself, except to permit the inclusion of a password.
2. Even though a Host ID may have been assigned to the Host Circuit, the only notation
that may be used in this definition can be the character representing the Host Circuit
(00-7F or A-Z, 1-6 for older code versions).