tn3270c(4) DEVICES AND NETWORK INTERFACES tn3270c(4)
NAME
tn3270c - EXPRESS TN3270-C Session Manager and
Session Group configuration files
SYNOPSIS
SmName.cfg or Default.cfg - Session Manager configuration
file
FileName.sdf - Session Group configuration file
SESSION MANAGER CONFIGURATION FILE
The Session Manager file provides a convenient method for
configuring EXPRESS TN3270-C. The file establishes charac-
teristics for the terminal emulation environment that are
independent of individual sessions. The Session Manager con-
figuration file is not required by EXPRESS TN3270-C; if one
does not exist, internal program defaults are used with
tn3270c(1) command line options to determine the configura-
tion.
The Session Manager configuration file is an ASCII file that
can be created and edited with a standard UNIX editor such
as vi or emacs. When you create a Session Manager configura-
tion file, use a standard UNIX file name in the form
SmName.cfg. SmName is the configuration name that is used
when invoking tn3270c(1). When EXPRESS TN3270-C is started,
it searches directories for the Session Manager configura-
tion file in the following order:
1. Your working directory
2. $HOME/Express/tn3270c
3. $COMMLINK/$LOGNAME
4. $COMMLINK
The Session Manager configuration file should be placed in
the appropriate directory location based on who will use and
maintain the configuration.
The Session Manager configuration file contains statements
introduced by configuration keywords with the following syn-
tax:
keyword value;
Comments are entered in the configuration file using the
number sign character (#). Statements must end with the
semicolon (;).
Last change: 4/13/95 1
tn3270c(4) DEVICES AND NETWORK INTERFACES tn3270c(4)
The keywords and syntax for Session Manager configuration
statements are defined below. Keywords are not dependent on
case and can be entered in any order. If a keyword statement
is not included or a keyword is entered without a parameter
value, EXPRESS TN3270-C uses the default value. For more
information on the configuration files, see the EXPRESS
TN3270-C User's Guide.
KEYWORDS USED IN SESSION MANAGER
CONFIGURATION FILE
Activate n[,n ... ,n];
Lists short name(s) of session(s) activated when
EXPRESS TN3270-C is started. The session list con-
sists of single-character session short names
separated by commas, with no intervening white
space. When the Session Manager is started, all
sessions in the list are activated. If any session
in the list fails to activate, the Session Manager
terminates with an error message and a specific
process completion code. There is no default.
ControlMode Enable|Disable;
Determines if EXPRESS TN3270-C can enter Control
Mode. The default value is Enable.
DisplayFile Filename;
Specifies the name of the file that defines the
display capabilities used in sessions and Control
Mode. If the file cannot be found, the directory
$COMMLINK/adm/3270 is inserted at the beginning of
the Filename. Display capability files for many
display types are provided with EXPRESS TN3270-C
and are located in $COMMLINK/adm/3270 using
filenames that end in .d. The default value is
$TERM.d.
ExtendedAttributes Enable|Disable;
Determines if extended attribute byte buffers are
allocated in the Session Manager's internal
representation of host presentation space. If this
parameter is disabled, no full color or video
highlighting operations are possible on any host
session. The default value is Enable.
KeyboardFile Filename;
Specifies the name of the file that defines the
mapping of functions to physical keys. If the file
cannot be found, the directory $COMMLINK/adm/3270
is inserted at the beginning of the Filename. Key-
board mapping files for many keyboard types are
provided with EXPRESS TN3270-C and are located in
Last change: 4/13/95 2
tn3270c(4) DEVICES AND NETWORK INTERFACES tn3270c(4)
$COMMLINK/adm/3270 using filenames that end in .k.
The default value is $TERM.k.
LocalPrint Enable|Disable;
Enables or disables local print capability for any
host session. This capability allows printing
screens in terminal sessions. For tn3287 printer
emulation see tn3287c(1). The Local Print Inter-
cept feature, which allows an HLLAPI User Program
to handle local print requests, is independent of
this parameter and is always available. The
default value is Disable.
MaxProcesses n;
Specifies the maximum number of concurrent HLLAPI
programs. When this number of HLLAPI User Programs
(HUPs) is concurrently accessing the Session
Manager, any request made by an additional HUP for
the same Session Manager to perform an HLLAPI
function receives a System Error return code. The
default value is 3.
MaxSessions n;
Specifies the maximum number of host and/or local
sessions that can be activated. The default value
is 4. If you exceed the default, it may be neces-
sary to tune the kernel parameters of your com-
puter system. See the Release Notes for EXPRESS
TN3270-C for more information.
NationalLanguageFile Filename;
Specifies the name of the file that defines the
National Language used by host sessions, local
sessions, and EXPRESS TN3270-C Control Mode. If
the file cannot be found, the directory
$COMMLINK/adm/natlang is inserted at the beginning
of the Filename. National language files for IBM
defined national languages are provided with
EXPRESS TN3270-C and are located in
$COMMLINK/adm/natlang using filenames that start
with NLO. The default value is NLO.US.
PrinterFile Filename;
Specifies the name of the file that defines the
printer capabilities for local printing of screens
in host sessions. When no file is specified, a
device initialization string is not used and all
universal ASCII characters are sent as is to the
print destination. If the file cannot be found,
the directory $COMMLINK/adm/natlang is inserted at
the beginning of the Filename. Printer capability
Last change: 4/13/95 3
tn3270c(4) DEVICES AND NETWORK INTERFACES tn3270c(4)
files for common printer types are provided with
EXPRESS TN3270-C and are located in
$COMMLINK/adm/natlang using filenames that end in
.pca. There is no default value.
Select n; Specifies the short name of the session that is
displayed when EXPRESS TN3270-C is started. This
option is only meaningful when the session you
select is one listed with the Activate parameter.
If no session is specified but a local session was
activated, the local session is selected by
default. If no session is specified and only host
sessions were activated, EXPRESS TN3270-C starts
in Control Mode.
SessionFile Filename;
Specifies the name of the Session Group configura-
tion file that defines host and local sessions.
There is no default value.
SESSION GROUP CONFIGURATION FILE
The Session Group configuration file is used to configure
host and local sessions in EXPRESS TN3270-C. The configura-
tion file is only required if EXPRESS TN3270-C is started
using a Session Manager configuration file that references
the Session Group file. If the Session Manager file is not
used or does not reference a Session Group file, internal
program defaults and command line options are used to
automatically create host sessions.
The Session Group Configuation file is an ASCII file that
can be created and edited with a standard UNIX editor such
as vi or emacs. Use a standard UNIX file name in the form
FileName.sdf. The corresponding Session Manager configura-
tion file references this file with the SessionFile state-
ment. When EXPRESS TN3270-C is started, it reads the name of
the Session Group configuration file from the Session
Manager configuration file. If the directory is not speci-
fied, or the path cannot be found, EXPRESS TN3270-C searches
directories for the Session Group file in the following
order:
1. Your working directory
2. $HOME/Express/tn3270c
3. $COMMLINK/$LOGNAME
4. $COMMLINK
Last change: 4/13/95 4
tn3270c(4) DEVICES AND NETWORK INTERFACES tn3270c(4)
The Session Group configuration file should be placed in the
appropriate directory location based on who will use and
maintain the configuration.
The Session Group configuration file contains one statement
per session. Each statement is introduced by either the
word Host or Local based on the type of session being
defined. Statements include a list of configuration parame-
ter keywords and related parameter values. The keywords and
parameter values are separated by blank spaces, tabs, and/or
newlines. Each statement is terminated by a semicolon and
may extend over multiple lines. The statement syntax for a
host session is:
Host keyword1 value1 . . . keywordN valueN;
The statement syntax for a local session is:
Local keyword1 value1 . . . keywordN valueN;
Comments are entered in the configuration file using the
number sign character (#).
The keywords and syntax for Session Manager configuration
statements are defined below. Keywords are not dependent on
case and can be entered in any order. If a keyword statement
is not included or a keyword is entered without a parameter
value, EXPRESS TN3270-C uses the default value. For more
information on the configuration files, see the EXPRESS
TN3270-C User's Guide.
HOST SESSION KEYWORDS
The following keywords are used to define host sessions in
the Session Group configuration file:
ShortName c
Defines a single ASCII alphanumeric character (A-
Z, a-z, 0-9 ) used as a short name for the ses-
sion. Short names must be unique within a Session
Group file. Lower case and numeric short names are
not valid in a standard IBM environment. There is
no default, but a value is required.
LongName Name
Defines a long name for a session. Name consists
of up to eight ASCII alphanumeric characters. The
first character must be alphabetic. Long names are
displayed in Control Mode and are available to
HLLAPI user programs. The default is Hostc where
c is the session short name.
Description "Text"
Defines a description of the session that consists
Last change: 4/13/95 5
tn3270c(4) DEVICES AND NETWORK INTERFACES tn3270c(4)
of up to 40 ASCII characters enclosed by quotation
marks. When a list of sessions is requested in
Control Mode, the description appears alongside
the session name. The default is blank.
Model n Specifies 3270 emulation model. The following
models are supported:
1 12 Rows by 40 Columns. 480 Characters.
2 24 Rows by 80 Columns. 1920 Characters. This
is the default.
3 32 Rows by 80 Columns. 2560 Characters.
4 43 Rows by 80 Columns. 3440 Characters.
5 27 Rows by 132 Columns. 3564 Characters.
ExtendedAttributes Enable|Disable
Determines if extended attribute bytes are enabled
for the session. These bytes are required for 3270
full color and video highlighting features.
Extended attributes must also be enabled in the
Session Manager file or this parameter has no
effect. The default is Enable.
PrintMode n
Determines the initial mode of operation for local
printing of host session screens. Two values are
permitted:
1 - Print to a UNIX file
2 - Print to a UNIX command. The command is
treated as a filter process.
If not configured, local print requests are ini-
tially ignored. There is no default.
PrintDestination Dest
Specifies the initial destination of local print
requests for host session screens. Required if
PrintMode is specified.
If the PrintMode is 1, enter the full path and
file name.
If the PrintMode is 2, enter a UNIX command. If
the command includes blank spaces, use quotation
marks around the command.
If PrintMode is not configured, PrintDestination
may not be specified. There is no default.
IPHostName Name
Specifies the TCP/IP host address or name (from
the /etc/hosts file) where the TN3270 Server
Last change: 4/13/95 6
tn3270c(4) DEVICES AND NETWORK INTERFACES tn3270c(4)
resides. There is no default.
IPServiceName Name
Specifies the TCP/IP service name or port number
for the tn3270 service. If the Name is all
numeric, EXPRESS TN3270-C assumes a port address.
The default is tn3270. If tn3270 is not defined,
the default is telnet.
LogonScript ScriptName
Specifies the name of file containing a jlang
script used to automate the logon process for a
session. The default is Logon_c.jl, where c is the
short session name. jlang(4) is a HLLAPI user pro-
gram provided with EXPRESS TN3270-C.
ComBufSize n
Specifies the size of communications buffers in
bytes for the direct session data feature used for
3270 file transfer configuration. The buffers
should be large enough to contain the maximum
inbound or outbound RU size (configured at the
host). The default value, 3600, is sufficient for
most applications.
ComBufNum n
Specifies the number of direct session data
buffers. Used for 3270 file transfer configura-
tion. The default is 1.
DeviceName Name
Specifies the name of the device, a specific logi-
cal unit (LU) or LU pool, to which you wish to
connect. Name is string whose length is determined
by your specific tn server. The Name specified by
this option corresponds to the DEVICE-NAME defined
for tn3270-E (RFC 1647) in the terminal-type nego-
tiation suboption "CONNECT DEVICE-NAME". There is
no default.
HOST SESSION KEYWORDS RELATED TO HLLAPI
When executing HLLAPI User Programs with a host session, use
the following keywords in the Session Group file, with the
standard host session keywords listed above:
MaxKeystrokes n
Determines the maximum keystroke intercept queue
size. There is no default.
MaxHostEvents n
Specifies the maximum host event queue size. There
Last change: 4/13/95 7
tn3270c(4) DEVICES AND NETWORK INTERFACES tn3270c(4)
is no default.
MaxHostEventQueues n
Specifies the maximum number of host event queues.
The default is 1 when MaxHostEvents is specified.
D0Struct Enable|Disable
Determines if Destination/Origin (DO) Structured
Fields for SNA are accepted and processed. The
default is Disable.
Interpret Enable|Disable
Determines if the 3270 data stream and maintain
presentation space is interpreted. The default is
Enable.
AutoAcknowledge Enable|Disable
Specifies whether to generate automatic positive
acknowledgment for session data (for SNA). The
default is Enable.
LPIntercept Enable|Disable
Specifies whether to allow an HLLAPI user program
to process local print requests. The default is
Enable.
LOCAL SESSION KEYWORDS
The following keywords are used to define local sessions in
the Session Group configuration file:
ShortName c
Defines a single ASCII alphanumeric character (A-
Z, a-z, 0-9 ) used as a short name for the ses-
sion. Short names must be unique within a Session
Group file. There is no default, but a value is
required.
LongName Name
Defines a long name for a session that consists of
up to eight ASCII alphanumeric characters. The
first character must be alphabetic. Long names are
displayed in Control Mode and are available to
HLLAPI user programs. The default is Localc where
c is the session short name.
Description "Text"
Defines a description of the session that consists
of up to 40 ASCII characters enclosed by quotation
marks. When a list of sessions is requested in
Control Mode, the description appears alongside
the session name. The default is blank.
Last change: 4/13/95 8
tn3270c(4) DEVICES AND NETWORK INTERFACES tn3270c(4)
Command "CommandLine"
Specifies a UNIX command for automatic invocation
when the session is started. The command must be
enclosed in quotation marks. If you start a Korn
shell, the MENU, SELECT, and JUMP commands cannot
be used in the local session. There is no default.
Directory "Path"
Specifies the initial working directory for local
session. The path must be enclosed in quotation
marks. The default is the current working direc-
tory.
Multiple Enable|Disable
Specifies if multiple instances of this local ses-
sion and the associated command are permitted. Do
not enable multiple instances of a local session
if you intend to leave the session without ter-
minating it (for example, using the JUMP,
SELECTSESSION, or MENU commands or the equivalent
HLLAPI calls). The default is Disable.
FILES
$COMMLINK/adm/3270/tn3270-c.cfg Sample Session Manager
configuration file
SEE ALSO
tn3270c(1), tn3287c(1), dcinit(1M), kminit(1M), neinit(1M),
prinit(1M), jlang(4), EXPRESS TN3270-C User's Guide, Release
Notes for EXPRESS TN3270-C, RFC 1647
Last change: 4/13/95 9