tn3270c(1) USER COMMANDS tn3270c(1)
NAME
tn3270c - start EXPRESS TN3270-C
SYNOPSIS
tn3270c [SmName] [-h Host] [-p Port] [-t Term]
[-k Keymap] [-m Model] [-n NumberSessions]
[-dn DeviceName] [-oldTN] [-DebugFileName FileName]
[-rp] [-dbg] [-nohup ] [ -b ] [ -hp Permission]
[ -s SmPath] [ -dDirectory] [ -C PipeDirectory] [ -scn ]
DESCRIPTION
Use tn3270c to start EXPRESS TN3270-C. EXPRESS TN3270-C pro-
vides 3270 terminal emulation using telnet and includes the
capability to customize keyboard mappings, adapt to your
display and printer capabilities, and use any single-byte
national language.
The configuration of EXPRESS TN3270-C is determined using
one or more of the following:
o Options used with the tn3270c command. Unless indicated
below, all options can also be specified in the confi-
guration files.
o Session Manager (.cfg) and Session Group (.sdf) confi-
guration files. For information on the configuration file
syntax, see tn3270c(4).
o Internal program defaults
Note that only the local printing of screens is supported in
host sessions started using tn3270c. For tn3287 printer emu-
lation support, see tn3287c(1).
OPTIONS
SmName
Directs EXPRESS TN3270-C to use the configuration
defined by the Session Manager configuration file with
the name SmName.cfg. The combination of SmName, user
ID, and pipe directory must be unique for every
instance of EXPRESS TN3270-C running at one time. There
is no default SmName. If SmName is not specified,
EXPRESS TN3270-C builds a configuration based on the
command line options and internal program defaults as
described in tn3270c(4). If SmName is specified but the
file does not exist, EXPRESS TN3270-C exits with an
error message.
-h Host
Specifies the host name or IP address used with all
sessions that are either defined in the Session Group
file or automatically generated using internal program
Last change: 4/13/95 1
tn3270c(1) USER COMMANDS tn3270c(1)
defaults. Overrides any specification in the Session
Group file. There is no default host name.
-p Port
Specifies the IP port number or service name used to
connect to hosts. Overrides any specification in the
Session Group file. The default IP service name is
tn3270. If tn3270 is not defined, the default is
telnet.
-t Term
Specifies the name for the compiled display capabili-
ties file (see dcinit(1M)). Overrides any specification
in Session Manager file. The default is $TERM.d.
-k Keymap
Specifies the name for the compiled keyboard mapping
file (see kminit(1M)). Overrides any specification in
Session Manager file. The default is $TERM.k. If
$TERM.k does not exist, the default is std.k.
-m Model
Specifies 3270 emulation model. Overrides any specifi-
cation in Session Group file. 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
-n NumberSessions
Generates the specified number of sessions. If EXPRESS
TN3270-C is configured with a Session Manager confi-
guration file (*.cfg) and a Session Group configuration
file (*.sdf), the sessions defined in the configuration
file are used. If more sessions are specified using -n
than are defined in the configuration files, the extra
sessions are generated automatically. For example, if
you enter "tn3270c -n 3", and session 0 is defined in
your Session Group configuration file, your session
list includes session 0 and two automatically generated
sessions, 1 and 2.
-dn DeviceName
This option specifies the name of the device, a
Last change: 4/13/95 2
tn3270c(1) USER COMMANDS tn3270c(1)
specific LU or LU pool, to which you wish to connect.
DeviceName is a string whose length is determined by
your specific tn server. The DeviceName specified by
this option corresponds to the DEVICE-NAME defined for
tn3270-E (RFC 1647) in the terminal-type negotiation
suboption "CONNECT DEVICE-NAME". There is no default
device name.
-oldTN
This option disable TN3270-E functionality and enables
EXPRESS TN3270-C functionality. This option cannot be
set using configuration files. You must specify this
option on the command line. RFC 1647 is new, and some
parts of it are open to interpretation. Therefore, some
clients and some servers may be unable to communicate
with each other. -oldTN provides a work-around for
these sorts of communication problems.
-DebugFileName FileName
Redirects stderr to FileName if -dbg or -rp is speci-
fied on the command line, if the TELL function is
invoked in a host session, or if the replay trace is
turned on by the new HLLAPI function (See the EXPRESS
TN3270-C Release Notes).
-rp Starts a replay trace which lists the information that
is sent to and received from the host. This option can
be used in conjunction with -DebugFileName to save
trace information in a file. Use this option with the
advice of support personnel. This option cannot be set
using the configuration files.
-dbg Sets the debug flag in shared memory. This sends a ver-
bose listing of internal processing information to
stderr. This option can used in conjunction with
-DebugFileName to write the information to a file. Use
this option with the advice of support personnel and
only after trying the -rp option first. This option
cannot be set using the configuration files.
-nohup
Runs EXPRESS TN3270-C in the background so that it can
be used by HLLAPI user programs (HUPs) and makes
EXPRESS TN3270-C ignore the "hup" signal that is gen-
erated when you log off. If EXPRESS TN3270-C recognized
the "hup" signal, the HLLAPI user program and EXPRESS
TN3270-C would terminate. This option cannot be set
using configuration files.
-b Runs EXPRESS TN3270-C in the background for HLLAPI user
programs. The sessions are not displayed. This option
cannot be set using configuration files.
Last change: 4/13/95 3
tn3270c(1) USER COMMANDS tn3270c(1)
-hp Permission
Specifies the access permission of shared memory to
provide access to a common session manager for HLLAPI
user programs run by multiple users. Permission can
have the following values:
- "owner" access only (default)
- "group" access
- "all" access
This option cannot be set using configuration files.
-s SmPath
Specifies the full pathname for Session Manager confi-
guration file. This option cannot be set using confi-
guration files.
-d Directory
Specifies the directory containing EXPRESS TN3270-C
(only needed if you have rearranged your EXPRESS
TN3270-C directory structure after installation). The
default is $COMMLINK/bin/3270. This option cannot be
set using configuration files.
-C PipeDirectory
Specifies the directory containing shared memory key
pipes (only needed if you have rearranged your EXPRESS
directory structure after installation). The default
is $HOME/Express/tn3270c/pipes/$LOGNAME.
If this directory does not exist, the default is
$COMMLINK/pipes/$LOGNAME. This option cannot be set
using configuration files.
-scn Displays Source Control Numbers (SCNs) of all EXPRESS
TN3270-C processes and records the SCNs in your current
directory in either SmName.scn or, if SmName is not
specified, Default.scn. Used for diagnostic purposes
only. This option cannot be set using configuration
files.
FILES
$COMMLINK/adm/3270/tn3270-c.cfg Sample Session Manager
configuration file
SEE ALSO
stop3287(1), tn3287c(1), dcinit(1M), kminit(1M), neinit(1M),
prinit(1M), jlang(4), tn3270c(4), tn3287c(4), EXPRESS
TN3270-C User's Guide, RFC 1647
Last change: 4/13/95 4