ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzatv_5.4.0.1/rzatvcmmnd5250.htm

185 lines
13 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?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>