185 lines
13 KiB
HTML
185 lines
13 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
||
<!DOCTYPE html
|
||
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
<html lang="en-us" xml:lang="en-us">
|
||
<head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
<meta name="security" content="public" />
|
||
<meta name="Robots" content="index,follow" />
|
||
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
||
<meta name="DC.Type" content="reference" />
|
||
<meta name="DC.Title" content="Command line emulator options" />
|
||
<meta name="abstract" content="Learn about command line options for iSeries Access for Linux 5250 emulator." />
|
||
<meta name="description" content="Learn about command line options for iSeries Access for Linux 5250 emulator." />
|
||
<meta name="DC.Relation" scheme="URI" content="rzatvconfig5250.htm" />
|
||
<meta name="copyright" content="(C) Copyright IBM Corporation 2004, 2006" />
|
||
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2004, 2006" />
|
||
<meta name="DC.Format" content="XHTML" />
|
||
<meta name="DC.Identifier" content="cmmnd5250" />
|
||
<meta name="DC.Language" content="en-us" />
|
||
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
||
<!-- US Government Users Restricted Rights -->
|
||
<!-- Use, duplication or disclosure restricted by -->
|
||
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
||
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
||
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
||
<title>Command line emulator options</title>
|
||
</head>
|
||
<body id="cmmnd5250"><a name="cmmnd5250"><!-- --></a>
|
||
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
<h1 class="topictitle1">Command line emulator options</h1>
|
||
<div><p>Learn about command line options for iSeries™ Access for Linux<sup>®</sup> 5250 emulator.</p>
|
||
<div class="section"><div class="p">The format of the command line to invoke a 5250 emulator session
|
||
is:<pre><samp class="codeph">ibm5250 <em>iSeries_system_name</em> <em>optional_parameters</em></samp>
|
||
|
||
where:</pre>
|
||
</div>
|
||
<ul><li><samp class="codeph">ibm5250</samp> is the application name and is case sensitive.</li>
|
||
<li><samp class="codeph"><em>iSeries_system_name</em></samp> specifies the name of the
|
||
server with which the 5250 emulation session communicates. The name is a host
|
||
name or an IP address. The user is prompted when this field is not specified.</li>
|
||
<li><samp class="codeph"><em>optional_parameters</em></samp> specifies optional parameters.</li>
|
||
</ul>
|
||
</div>
|
||
<div class="section"><div class="p">The two main command line entries for configuring the iSeries Access
|
||
for Linux emulator
|
||
are: <ol><li><samp class="codeph"><span class="uicontrol">ibm5250</span></samp> - This application invokes
|
||
the 5250 emulator and displays a graphical user interface (GUI) for entering
|
||
the system name, userid, and password. This information is used to obtain
|
||
a 5722-XW1 license and initiate a 5250 session. Type <samp class="codeph">ibm5250 --help</samp> to
|
||
see command line options. </li>
|
||
<li><samp class="codeph"><span class="uicontrol">setup5250</span></samp> - This is the setup
|
||
program that is used to configure global values that are applied to all 5250
|
||
sessions, userid's, and multiple connections. Once the initial 5250 program
|
||
is started, reference the online help text for additional configuration options.
|
||
The setup5250 program also allows for the creation and launching of customized
|
||
ibm5250 sessions.</li>
|
||
</ol>
|
||
</div>
|
||
<p>You can use the following case sensitive, optional parameters
|
||
on the 5250 command line: </p>
|
||
<ul><li class="liexpand"><samp class="codeph">-title</samp> Case sensitive title text follows this parameter.
|
||
If the title text contains a space, the title text must be within double quotes.
|
||
The title text is displayed in the 5250 session window overriding the 5250
|
||
window title text resource value. Title text is truncated if longer than thirty
|
||
characters. When the 5250 session dialogue (menu pull down) is used to start
|
||
another 5250 session, the same title is used.</li>
|
||
<li class="liexpand"><samp class="codeph">-TITLE_OPTION</samp> is followed by one of the following: <samp class="codeph">TEXT_AND_SESSION_ID</samp> (default), <samp class="codeph">TEXT_ONLY</samp>, <samp class="codeph">SESSION_ID_ONLY</samp>, <samp class="codeph">TEXT_HOST_AND_SESSIONID</samp>,
|
||
or <samp class="codeph">TEXT_AND_HOST</samp>.</li>
|
||
<li class="liexpand"><samp class="codeph">-wide</samp> Either <em>enable</em> or <em>disable</em> should follow
|
||
and are case sensitive. This parameter enables or disables 27x132 support.
|
||
The default is <em>enable</em>.</li>
|
||
<li class="liexpand"><samp class="codeph">-image</samp> Either <em>enable</em> or <em>disable</em> should
|
||
follow and are case sensitive. This parameter enables or disables image/fax
|
||
viewing. The default is <em>enable</em>.</li>
|
||
<li class="liexpand"><samp class="codeph">-LARGEST_IMAGE</samp> A 3 or 4 digit numeric parameter follows
|
||
which indicates the maximum source image/fax size which is displayed. The
|
||
parameter indicates the number of thousands of bytes that are accepted. The
|
||
5250 emulator has a default value of 400, displaying an image or fax up to
|
||
400,000 bytes in size. This parameter is undocumented in help text.</li>
|
||
<li class="liexpand"><samp class="codeph">-LANGID</samp> A 5 digit parameter follows which contains the
|
||
locale that is used. The<samp class="codeph"> –LANGID</samp> overrides the Linux environment
|
||
variable <samp class="codeph">$LANG</samp> and determines the conversions that are used
|
||
on the OS400 data stream. The emulator window decorations are determined by
|
||
the <samp class="codeph">$LANG</samp> or <samp class="codeph">–LANGID</samp> value of the first
|
||
emulator session that is started.</li>
|
||
<li class="liexpand"><samp class="codeph">-geometry</samp> Window width, window height, x offset, and
|
||
y offset follow (<samp class="codeph">WWxWH+Xoffset+Yoffset</samp>). The 5250 window
|
||
is placed according to these values. The window size parameters are adjusted
|
||
as necessary to fit the font that fills the window. <samp class="codeph">-geometry 9999x9999+0+0</samp> provides
|
||
the maximized window, using the largest font that fits a particular monitor
|
||
resolution.</li>
|
||
<li class="liexpand"><samp class="codeph">-playback</samp> or <samp class="codeph">-PLAYBACK</samp> A case sensitive
|
||
file name of a 5250 playback file follows. This function enables autologon
|
||
so users are not required to reenter their userid's and passwords. This function
|
||
also enables starting a playback file, which allows users to display a specific iSeries server
|
||
screen. The playback file is from the user's playback directory or a default
|
||
playback file.</li>
|
||
<li class="liexpand"><samp class="codeph">-keypad</samp> or <samp class="codeph">-KEYPAD</samp> Use this parameter
|
||
to start a popup keypad window when the 5250 emulator session starts. A case
|
||
sensitive popup keypad file name follows. Specify multiple <samp class="codeph">-keypad</samp> command
|
||
line options to start multiple popup keypad windows. The keypad file is from
|
||
your keypad directory or from the default keypad file.</li>
|
||
<li class="liexpand"><samp class="codeph">-KEYFILE</samp> Use this parameter to specify a user-named keyboard
|
||
remapping file that is used for the 5250 emulator session. A case sensitive
|
||
keyboard remapping file name follows, including the keyboard type file extension.</li>
|
||
<li class="liexpand"><samp class="codeph">-DISPLAY_NAME</samp> is followed by one parameter. The following
|
||
rules apply to i5/OS™ 5250
|
||
session names: <ul><li>Each active 5250 session must have a unique session name.</li>
|
||
<li>The first character must be an alpha character.</li>
|
||
<li>All characters must be alpha, numeric, a period, or an underscore.</li>
|
||
<li>All alpha characters must be upper case.</li>
|
||
<li>Session names must be 2 to 10 characters in length.</li>
|
||
</ul>
|
||
</li>
|
||
<li class="liexpand"><samp class="codeph">-SESSION_ID</samp> is followed by an ID for the 5250 session.
|
||
The session ID text is upper or lower case and up to 20 characters in length.
|
||
If there is a space in the session ID text, the session ID text must be enclosed
|
||
within double quotes. <div class="note"><span class="notetitle">Note:</span> <samp class="codeph">+n</samp> is also supported where n
|
||
is a numeric digit between 1 and 99. No spaces are allowed between the text
|
||
and <samp class="codeph">+n</samp>.</div>
|
||
</li>
|
||
<li class="liexpand"><samp class="codeph">-EURO</samp>, <samp class="codeph">-Euro</samp>, <samp class="codeph">-euro</samp>,
|
||
and <samp class="codeph">-NOEURO</samp> specify whether or not the European monetary
|
||
symbol is used. This command line option is ignored for languages that do
|
||
not support the Euro symbol.</li>
|
||
<li class="liexpand"><samp class="codeph">-port</samp> or <samp class="codeph">-PORT</samp> allows a 5250 session
|
||
to use a port number other than the default. For non-SSL telnet, the default
|
||
port number is 23. A 1 to 4 digit port number follows the command line option.</li>
|
||
<li class="liexpand"><samp class="codeph">-INACTIVITY</samp> is followed by a numeric parameter from 0
|
||
to 9999. This option specifies whether the telnet connection is disconnected
|
||
or reconnected, after a specified time of inactivity. The default value is
|
||
0 which indicates that inactivity is not monitored.</li>
|
||
<li class="liexpand"><samp class="codeph">-BLOCK_COPY</samp> specifies that the 5250 emulator defaults
|
||
to block copy, as opposed to linear copy, when marking an area for copy or
|
||
cut. Block copy occurs by a double click of the mouse button while linear
|
||
copy means pressing and dragging the primary mouse button to mark the desired
|
||
area. If this option is not specified, linear copy is the default.</li>
|
||
<li class="liexpand"><samp class="codeph">-NO_COPY_PASTE</samp> specifies that the emulator does not allow
|
||
copy, cut, or paste into or out of the emulator session.</li>
|
||
<li class="liexpand"><samp class="codeph">-SESSION_COPY_PASTE_ONLY</samp> specifies that the 5250 emulator
|
||
only allows copy, cut, and paste within the emulator session.</li>
|
||
<li class="liexpand"><samp class="codeph">-COPY_PASTE</samp> specifies the emulator allows copy, cut,
|
||
and paste into and out of the emulator session.</li>
|
||
<li class="liexpand"><samp class="codeph">-BROWSER_START</samp> specifies that the emulator code recognize
|
||
a URL hot spot. This option defaults to unavailable because not all users
|
||
have browser access. If this option is specified and the user clicks on a
|
||
valid URL hot spot, the command specified in the system environment variable <samp class="codeph">$BROWSER</samp> is
|
||
called with the URL passed as an option. The user must define the system variable <samp class="codeph">$BROWSER</samp> as
|
||
the browser name that is used. A fully qualified name or a name found in the
|
||
system path is specified. If the environment variable is not found or is not
|
||
valid, a browser is not started.</li>
|
||
<li class="liexpand"><samp class="codeph">-RETRY_COUNT</samp> specifies whether to try to reconnect if
|
||
a communication error occurs and the 5250 session is disconnected. A numeric
|
||
parameter follows with a value between 0 and 9999. Zero indicates that any
|
||
reconnect is attempted manually. One to 9999 indicates the number of automatic
|
||
retries that are attempted. The default is 144.</li>
|
||
<li class="liexpand"><samp class="codeph">-RETRY_INTERVAL</samp> specifies the automatic retry count in
|
||
seconds. A numeric parameter follows with a value from 1 to 9999; the default
|
||
value is 300 (5 minutes).</li>
|
||
<li class="liexpand"><samp class="codeph">-NO_DESKTOP_FILE</samp> The emulator supports reading and writing
|
||
a desktop file to remember the user's last window location and font size.
|
||
This option disables the ability to read and write the desktop file.</li>
|
||
<li class="liexpand"><samp class="codeph">-debug</samp> or <samp class="codeph">-DEBUG</samp> displays verbose messaging
|
||
while the emulator runs.</li>
|
||
<li class="liexpand"><samp class="codeph">-trace</samp> or <samp class="codeph">-TRACE</samp> traces Telnet activity
|
||
between the emulator and host OS/400<sup>®</sup>.</li>
|
||
<li class="liexpand"><samp class="codeph">-sso</samp> or <samp class="codeph">-SSO</samp> bypasses the signon screen.</li>
|
||
<li class="liexpand"><samp class="codeph">-kerberos</samp> authentication used for getting a license and
|
||
bypassing signon when used with the -sso parameter.</li>
|
||
<li class="liexpand"><samp class="codeph">-IBMCURLIB</samp> specifies the current library when used with
|
||
the -sso parameter.</li>
|
||
<li class="liexpand"><samp class="codeph">-IBMIMENU</samp> specifies the initial menu when used with the
|
||
-sso parameter.</li>
|
||
<li class="liexpand"><samp class="codeph">-IBMPROGRAM</samp> specifies the initial program when used with
|
||
the -sso parameter.</li>
|
||
</ul>
|
||
</div>
|
||
</div>
|
||
<div>
|
||
<div class="familylinks">
|
||
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzatvconfig5250.htm" title="You can configure the 5250 emulator installed with iSeries Access for Linux RPM.">Configure 5250 emulation</a></div>
|
||
</div>
|
||
</div>
|
||
</body>
|
||
</html> |