xref: /dports/net/c3270/suite3270-4.0/c3270/resource-body

intro
 <i>Resources</i> are used to configure %p%.  Resources are named items with
 string, integer or Boolean values.
 <p>
 Resource definitions come from the following sources:
 <ul>
 <li>Default values are compiled into %p%.</li>
if x
 <li>Standard X11 methods can be used to override the compiled-in
  defaults.  These methods include:
  <ul>
  <li>The %p% app-defaults file (only if %p% is built with app-defaults
   support).  This can be a locale-specific or generic app-defaults file
   located in the user's home directory or in the system X11 directory.</li>
  <li>Definitions set by the <i>xrdb</i> command.
  <li>The <b>~/.Xdefaults</b> file.
 </ul>
endif
 <li>If a session file <b><i>foo</i>.%p%</b> is specified on the command line,
 its contents are applied.
if x c
 Otherwise, if the %p% profile (<b>~/.%p%pro</b>) exists, it is read and its
 contents are applied.
endif
 These definitions override resource values defined by
if x
 X11 methods and
endif
 compiled-in defaults.</li>
 <li>Command-line options override all other resource definitions.  If more
  than one command-line option sets a resource, the last one is used.</li>
 </ul>
 Many resources have their own command-line switches, which are listed below.
 Those that do not can still be set from the command-line via the <b>-xrm</b>
 command-line option.  For example %-bsdTm% can be set by the
 following command-line option:
 <pre>
     -xrm "%p%.bsdTm: true"
 </pre>
 Note that <b>-xrm</b> is supported on all of the 3270 emulators, not just on
 x3270.

 <h2>Resource File Syntax</h2>
 A resource file
if x
 (app-defaults file, profile or session file)
else
if c
 (profile or session file)
else
 (session file)
endif
endif
 has the following syntax.
 <ul>
  <li>Each definition consists of:
  <pre>
    <b>%p%.</b><i>resource-name</i><b>:</b> <i>value</i>
  </pre></li>
  <li>Comment lines begin with <b>!</b>.</li>
  <li>Line continuation is indicated by a backshash (<b>\</b>) character at
   the end of a line.</li>
if x C
  <li>Multi-line resources, such as keymap definitions, are split with
   newline characters, e.g.:
  <pre>
    <b>%p%.keymap.foo: \
      &lt;Key>a: String("bob") \n\
      &lt;Key>b: String("fred") \n\
      &lt;Key>c: String("joe")</b>
  </pre></li>
endif
 </ul>
.

name acceptHostname
applies a
type s
groups s
switch -accepthostname
description
    Defines a specific name to accept when validating the name presented in
    the server's SSL/TLS certificate, instead of using the name used
    to make the connection.
    (The form <b>DNS:</b><i>name</i>
    is also accepted for backwards compatibility.)
.

name acs
applies c
type b
default true
desc
    When true, %p% will use the curses Alternative Character Set (ACS) to
    display box-drawing characters.
    When false, %p% will use Unicode box-drawing characters.
.

name activeIcon
applies x
groups a
type b
default false
switch -activeicon
description
    When true, %p%'s icon becomes a live miniature of the
    screen display.
.

name aidWait
applies x c s
type b
default false
switch -set aidWait
switch -clear aidWait
desc
    When true, %p% will not block a script after executing
    an AID action (<b>Enter</b>, <b>Clear</b>, <b>PF</b> or <b>PA</b>).
    It is then script's responsibility to poll %p%'s status until it shows
    that the keyboard is no longer unlocked.
.

name allBold
applies c
groups a
type s
default auto
switch -allbold
desc
    When true, %p% will display all text in bold.  This is needed
    for terminals like Linux consoles and xterms that display non-bold text
    in unreadably-dim colors.  When false, text will be displayed in normal or
    bold, depending on the host-specified highlighting attribute.
    <p class=indented>
    When set to <b>auto</b>, it will be assumed <b>true</b> for 3279 emulation,
    and <b>false</b> for 3278 emulation.
.

name allowResize
applies x
type b
default true
description
    When true, the %p% window can be resized by the mouse (actually,
    by the
    window manager).  When false, the window can only be resized from
    menu
    options.  The purpose of disabling mouse resizing is to allow a window
    bigger than will fit on the screen, which some window managers (e.g., mwm)
    will not allow if permitted to resize it.
.

name alwaysInsert
applies a
type b
default false
description
    When true, %p% will set insert mode by default, and insert mode can only
    be disabled by the ToggleInsert() action.
.

name altCursor
applies x wc
groups a
type b
default false
switch -set altCursor
switch -clear altCursor
option Options -&gt; Toggles -&gt; Underline Cursor
option Options -&gt; Toggles -&gt; Block Cursor
description
    When true, this causes %p% to use the alternate
    (underscore) cursor.  When false, it will use a block cursor.
.

name altScreen
applies c
type s
switch -altscreen
desc
    Defines a character string that will be output to switch the terminal from
    80-column mode to 132-column mode.
    Within the string, the sequence <b>\E</b> is translated to the ASCII
    ESC character (0x1b).
    <p class=indented>
    When %-model% is 5, and this and
    %-defScreen% are defined, %p% will automatically change the
    terminal size when the host switches between the default (24x80) screen
    and the alternate (27x132) screen.
.

name aplCircledAlpha
applies x
groups a
type b
default false
description
    When set to true, allows %p% to work properly with special APL fonts like
    the APL385 font.
    APL385 maps the APL underscored alphabetic characters, which have no
    Unicode equivalent, to the DBCS circled alphabetic characters in the range
    U+24B6 to U+25CF.
    Otherwise, the only way to display these characters is with one of the
    special 3270 fonts included with %p%.
    <p class=indented>
    Because this mapping is non-standard, this setting affects only the
    display. The <b>Ascii</b> action will always output underscored alphabetics
    as blanks, and copy-and-paste operations will also represent them this way,
    though this may change to use the Unicode Combining Low Line character
    U+0332 at some point.
.

name aplMode
applies x
type b
default false
switch -apl
desc
    Sets %p% APL mode at start-up.
    APL mode sets up a temporary keymap and compose map to allow the entry of
    APL symbols.
    At run-time, APL mode is toggled with the Shift-Esc key.
.

name asciiBoxDraw
applies C
type b
default false
desc
    When true, this causes box-drawing characters (the Unicode 2500 block) to
    be drawn with ASCII-art characters (<b>+</b>, <b>-</b> and <b>|</b>).
    This allows a readable representation of these characters on the screen
    when using fonts that do not include them or have them with the wrong
    width.
.

name autoShortcut
applies wc
type b
default false
switch -S
switch +S
desc
    When true, %p% will run in <i>auto-shortcut</i> mode.  In auto-shortcut
    mode, %p% automatically creates a desktop shortcut (<b>.lnk</b> file)
    in %TEMP% that is compatible with its session file, then starts it.  This
    ensures that the console window's screen size, character set, font, etc.
    will be correct.
    <p class="indented">
    Auto-shortcut mode requires the use of a session file; the session file
    must have been created by the Session Wizard (release 3.3.9 or later) and
    must not have been modified incorrectly.  All desktop shortcuts created
    by the Session Wizard release 3.3.10 or later include setting autoShortcut
    to true.
    <p class="indented">
    The <b>+S</b> command-line switch turns off auto-shortcut mode.  All
    desktop shortcuts created by the Session Wizard release 3.3.10 or later
    include this switch.
    <p class="indented">
    Auto-shortcut mode does not work on Windows 9x.
.

name background
applies x
groups a
type s
default white
switch -bg
switch -rv
description
    The background color for menus, buttons, and on monochrome X11 displays, the
    emulator window.
.

name bellMode
applies wc
type s
groups i
description
    Controls how %p% responds to an ALARM WCC or BELL character.
    The value of <b>beepFlash</b> causes both the Windows console to
    beep and the %p% window to flash; this is the default behavior.
    The values of <b>beep</b> and <b>flash</b> cause just the beep and just
    the window flash respectively.  The value <b>none</b> causes ALARM WCCs
    and BELL characters to be ignored.
    <p class="indented">
    If this resource is defined, it overrides %-visualBell%.
.

name bellVolume
applies x
type i
default 0
description
    Controls the volume used when ringing the terminal bell.  The value
    ranges from -100 (silent) through 0 (normal) to +100 (loud).  Not all
    X11 servers can vary the bell volume, other than turning it on and off.
    This resource can be overridden by %-visualBell%, which
    if true, will replace the bell with a flash of the screen.
.

name bindLimit
applies a
groups p
type b
default true
description
    When true, %p% will restrict its screen dimensions to those specified in
    the BIND image sent by the host.
    If false, it will not.
.

name bindUnlock
applies a
type b
groups p
default false
description
    When true, %p% will unlock the keyboard as soon as the host sends a BIND
    image. Otherwise, it will wait until the host sends a Write command.
    <p class=indented>
    Note that in some previous releases, unlocking as soon as the BIND image
    was recevied was the default, and this behavior could be overridden
    (forcing %p% to wait for the Write) by the <b>B:</b> option on the
    hostname. Since waiting for the Write is now the default, <b>B:</b> is
    still supported as a no-op.
.

name blankFill
applies a
groups i
type b
default true
option Options -&gt; Toggles -&gt; Blank Fill
switch -set blankFill
switch -clear blankFill
description
    When true, in 3270 mode %p% will automatically convert
    trailing blanks in a field to NULLs in order to insert a character, and will
    automatically convert leading NULLs to blanks so that input data is not
    squeezed to the left.  This works around some of the quirkier behavior of
    real 3270 terminals.
.

name boldColor
applies x
groups a
default green
type s
description
    This resource defines the X11 color used to display intensified text in
    3278 mode.
    <p class=indented>
    Previous versions of %p% implemented something called <i>pseudo-color
    mode</i>, where a monochrome (3278) terminal was emulated with various
    colors assigned to different kinds of fields.
    To emulate pseudo-color mode with the current version of %p%, select 3278
    emulation with %-model%, set %-inputColor% to <b>orange</b> and set
    %-boldColor% to <b>cyan</b>.
.

name bsdTm
applies a
groups p
type b
default false
description
    Defines %p%'s response to the TELNET DO TIMING MARK option.  When set
    to false, %p% will respond to DO TIMING MARK with
    WONT
    TIMING MARK, which is consistent with most modern TELNET clients.  When
    true, %p% will respond with WILL TIMING MARK, which is consistent
    with the old BSD <i>telnet</i> command and with previous versions of
    %p%.  In either case, %p% will never respond to a DONT TIMING MARK option.
.

name caDir
applies u
type s
groups s
switch -cadir
description
    Defines a directory containing CA (root) certificates, used to validate
    a certificate presented by the host during SSL/TLS negotiation.
    The default is determined by the OpenSSL library on your workstation.
    (OpenSSL only)
.

name caFile
applies u
type s
groups s
switch -cafile
description
    Defines a PEM-format file containing CA (root) certificates, used to
    validate a certificate presented by the host during SSL/TLS negotiation.
    The default is determined by the OpenSSL library on your workstation.
    (OpenSSL only)
.

name cbreak
applies c
type b
default false
switch -cbreak
desc
    If true, %p% will set up the terminal in <b>cbreak</b> mode
    instead of the default <b>raw</b> mode.  <b>Cbreak</b> mode enables
    flow-control processing in the TTY driver, and may be required for
    certain terminals that use flow control to avoid dropping characters.
.

name certFile
applies u
groups s
type s
switch -certfile
desc
    Gives the name of a client certificate file, provided to the host
    during SSL/TLS negotiation.
    <p class=indented>
    With OpenSSL, the default file format is PEM; it can be overridden by
    %-certFileType%.
    The private key for the certificate is specified by %-keyFile%.
    If %-chainFile% is specified, it overrides %-certFile%.
    <p class=indented>
    On the Mac, the file must be in PKCS12 format.
.

name certFileType
applies u
groups s
type s
default pem
switch -certfiletype
desc
    Gives the type of the certificate file specified by %-certFile%.
    The value can be <b>pem</b> or <b>asn1</b>.
    (OpenSSL only)
.

name chainFile
applies u
groups s
type s
switch -chainfile
desc
    Gives the name of a certificate chain file to provided to the host
    during SSL/TLS negotiation.
    The file contains a PEM-format certificate, optionally followed by
    any intermediate certificates used to sign it, and the CA (root)
    certificate.
    The private key for the certificate is specified by %-keyFile%.
    If %-chainFile% is specified, it overrides %-certFile%.
    (OpenSSL only)
.

name charClass
applies x
type s
desc
    Defines groups of characters that should be treated the same when doing
    cut and paste of words.  Identical in use to the <i>xterm</i> resource
    of the same name.
.

name clientCert
applies w
groups s
type s
switch -clientcert
desc
    Gives the name of a client certificate, provided during SSL/TLS
    negotiation. The certificate is searched for in the Personal store.
.

name clientCert
applies u
groups s
type s
switch -clientcert
desc
    Gives the name of a client certificate, provided during SSL/TLS
    negotiation. (Mac only)
.

name codepage
applies a
groups c
type s
default bracket
switch -codepage
option Options -&gt; Code Page
description
    This defines the host EBCDIC code page, that is, what glyph (image) is
    displayed for each EBCDIC code sent by the host, and what EBCDIC code is
    sent to the host for each character typed on the keyboard.
    <p class="indented">
    To display the code pages supported by %p%, use the <b>-v</b>
    command-line option or the <b>Query(CodePages)</b> action.
if wc
    <p class="indented">
    Note that %p% DBCS support is limited. On Windows XP, Windows East Asian
    language support must be installed. On Windows Vista and later, the Windows
    System Locale must be set to a matching language.
endif
.

name colorBackground
applies x
groups a
type s
default black
description
    The background color for the emulator window.  This resource is used only
    on color X11 displays when %-model% specifies 3278 mode.  On
    monochrome X11 displays, the background color is <b>white</b>, unless
    <b>-rv</b>
    (reverse video) is selected on the command line; in 3279 mode, the screen
    background is determined by %-colorScheme%.
.

name colorScheme
applies x
groups a
type s
default default
option Options -&gt; Color Scheme
description
    Defines the colors used to paint the emulator window in 3279 (full-color)
    mode.  This resource is used only when %-model% specifies a 3279
    display.
    %-colorScheme% is just the name of the color scheme.
    The actual color scheme definition for color scheme <i>foo</i> is
    %-colorScheme.<i>foo</i>%.
.

name colorScheme.<i>foo</i>
applies x
groups a
type s
description
    An individual color scheme definition.
    I.e., to define color scheme <i>foo</i>, a resource named <b>%p%.colorScheme.<i>foo</i></b> must be defined.
    <p class=indented>
    Each resource is a whitespace-separated list of 23 items:
<ol>
 <li>X11 color for host color 0 NeutralBlack (also used for NVT color 0)</li>
 <li>X11 color for host color 1 Blue (also used for NVT color 4)</li>
 <li>X11 color for host color 2 Red (also used for NVT color 1)</li>
 <li>X11 color for host color 3 Pink (also used for NVT color 5)</li>
 <li>X11 color for host color 4 Green (also used for NVT color 2)</li>
 <li>X11 color for host color 5 Turquoise</li>
 <li>X11 color for host color 6 Yellow (also used for NVT color 3)</li>
 <li>X11 color for host color 7 NeutralWhite</li>
 <li>X11 color for host color 8 Black</li>
 <li>X11 color for host color 9 DeepBlue</li>
 <li>X11 color for host color 10 Orange</li>
 <li>X11 color for host color 11 Purple</li>
 <li>X11 color for host color 12 PaleGreen</li>
 <li>X11 color for host color 13 PaleTurquoise (also used for NVT color 6)</li>
 <li>X11 color for host color 14 Grey</li>
 <li>X11 color for host color 15 white (also used for NVT color 7)</li>
 <li>X11 color to use if one of 0..15 cannot be allocated (white or black)</li>
 <li>X11 color to use as the default screen background</li>
 <li>X11 color to use as the select background</li>
 <li>Host color (0..15) for unprotected, unhighlighted fields</li>
 <li>Host color (0..15) for unprotected, highlighted fields</li>
 <li>Host color (0..15) for protected, unhighlighted fields</li>
 <li>Host color (0..15) for protected, highlighted fields</li>
</ol>
<p class=indented>
<i>Note</i>: Host color 0 (NeutralBlack) means black on a display screen (a
white-on-black device) and white on a printer (a black-on-white device).
Host color 7 (NeutralWhite) means white on a display screen and black on a
printer.
.

name composeMap
applies x C
type s
default latin1
description
    Gives the name of the map used to define the pairs of characters that
    form composite characters with the <i>Compose</i> key.
    The definition of compose map <i>foo</i> is the resource
    %-composeMap.<i>foo</i>%.
.

name composeMap.<i>foo</i>
applies x C
type s
description
    An individual compose map definition.
    Each line in the resource is of the form:
<pre>
         keysym1 + keysym2 = keysym3
</pre>
<p class=indented>
    meaning "when the </i>Compose</i> key is pressed,
    followed by keysym1 and keysym2 (in either order), interpret it as
    keysym3."  The definitions are case-sensitive.
.

name confDir
applies a
type s
if u
default /usr/local/etc/x3270
else
default .
endif
desc
    Defines the %p% configuration directory, where %p% will search for the
    <b>ibm_hosts</b> file by default.  (See %-hostsFile%.)
if w
    <p class=indented>
    The default is to search the directory where %p% was started, which
    usually its installation directory.
endif
.

name connectFileName
applies x
type s
default ~/.x3270connect
description
    Gives the name of the file to store the recently-connected
    host list in.  If given the value <b>none</b>, no file will be read or
    written.  Note that by default, this file is shared among all instances
    of %p% that run under the same username.
.

name connectTimeout
applies a
type i
groups c
switch -connecttimeout
description
    Specifies a timeout, in seconds, that %p% will wait for a host connection
    to complete. If this is not set, the timeout will be determined by the
    operating system. Note that %p% will wait for the lesser of the two times
    (the specified timeout and the system-defined timeout).
.

name console
applies x
type s
desc
    Overrides the default console emulator program used for the %p%&gt; prompt
    and the trace monitor window.
    <p class=indented>
    The resource can take two forms. If it is just a keyword, it is the name
    of a well-known console: <b>gnome-terminal</b>, <b>konsole</b>,
    <b>xfce4-terminal</b> or <b>xterm</b>.
    If the string includes colons (:), it defines a console, and consists of
    four fields: <i>program-name</i>:<i>title-option</i>:<i>extra-option</i>:<i>exec-option</i>.
    <p class=indented>
    <i>program-name</i> is the name of the executable program.
    <p class=indented>
    <i>title-option</i> is the option used to set the window title.
    <p class=indented>
    <i>extra-option</i> is an extra command-line option to pass, such as
    <b>-sb</b> to turn on the xterm scroll bar. It can be empty.
    <p class=indented>
    <i>exec-option</i> is the option used to end the argument list, with the
    remaining options specifying the command and arguments to run inside the
    console window.
    <p class=indented>
    For example, the specification for gnome-terimnal is <b>gnome-terminal:--title::--</b>.
.

name consoleColorForHostColor0 consoleColorForHostColorNeutralBlack consoleColorForHostColor1 consoleColorForHostColorBlue consoleColorForHostColor2 consoleColorForHostColorRed consoleColorForHostColor3 consoleColorForHostColorPink consoleColorForHostColor4 consoleColorForHostColorGreen consoleColorForHostColor5 consoleColorForHostColorTurquoise consoleColorForHostColor6 consoleColorForHostColorYellow consoleColorForHostColor7 consoleColorForHostColorNeutralWhite consoleColorForHostColor8 consoleColorForHostColorBlack consoleColorForHostColor9 consoleColorForHostColorDeepBlue consoleColorForHostColor10 consoleColorForHostColorOrange consoleColorForHostColor12 consoleColorForHostColorPurple consoleColorForHostColor13 consoleColorForHostColorPaleGreen consoleColorForHostColor14 consoleColorForHostColorPaleTurquoise consoleColorForHostColor15 consoleColorForHostColorGrey consoleColorForHostColor16 consoleColorForHostColorWhite
applies wc
groups a
type i
desc
    Defines what console color to use to render a particular host color.
    Host colors can be specified by name or number.  That is, to define the
    console color to use when the host specifies <b>green</b>, which is host
    color 4, either the resource <b>%p%.consoleColorForHostColorGreen</b> or
    the resource <b>%p%.consoleColorForHostColor4</b> can be used.
    <p class=indented>
    The default definitions are as follows.
    <table cols=3 width="75%">
    <tr> <th>Host Color Index</th>
         <th>Host Color Name</th>
         <th>Default Console Color</th>
    <tr> <td>0</td> <td>NeutralBlack</td> <td>0</td> </tr>
    <tr> <td>1</td> <td>Blue</td> <td>9</td> </tr>
    <tr> <td>2</td> <td>Red</td> <td>12</td> </tr>
    <tr> <td>3</td> <td>Pink</td> <td>13</td> </tr>
    <tr> <td>4</td> <td>Green</td> <td>10</td> </tr>
    <tr> <td>5</td> <td>Turquoise</td> <td>11</td> </tr>
    <tr> <td>6</td> <td>Yellow</td> <td>14</td> </tr>
    <tr> <td>7</td> <td>NeutralWhite</td> <td>15</td> </tr>
    <tr> <td>8</td> <td>Black</td> <td>0</td> </tr>
    <tr> <td>9</td> <td>DeepBlue</td> <td>1</td> </tr>
    <tr> <td>10</td> <td>Orange</td> <td>12</td> </tr>
    <tr> <td>11</td> <td>Purple</td> <td>5</td> </tr>
    <tr> <td>12</td> <td>PaleGreen</td> <td>2</td> </tr>
    <tr> <td>13</td> <td>PaleTurquoise</td> <td>3</td> </tr>
    <tr> <td>14</td> <td>Grey</td> <td>7</td> </tr>
    <tr> <td>15</td> <td>White</td> <td>15</td> </tr>
    </table>
    <p class=indented>
    Note that "neutral black" means black on a display device and white on
    a printing device, and "neutral white" means white on a display device and
    black on a printing device.
    <p class=indented>
    The value of the resource is a console color index (0 through 15).
    Console colors are defined as follows:
    <table cols=3 width="75%">
    <tr> <th>Index</th> <th>Sample</th> </tr>
    <tr> <td>0</td>
         <td><span style="color: #000000; background-color: black">[<b>sample</b>]<span></td> </tr>
    <tr> <td>1</td>
         <td><span style="color: #000080; background-color: black">[<b>sample</b>]<span></li>
    <tr> <td>2</td>
         <td><span style="color: #008000; background-color: black">[<b>sample</b>]<span></td>
    <tr> <td>3</td>
         <td><span style="color: #008080; background-color: black">[<b>sample</b>]<span></td>
    <tr> <td>4</td>
         <td><span style="color: #800000; background-color: black">[<b>sample</b>]<span></td>
    <tr> <td>5</td>
         <td><span style="color: #800080; background-color: black">[<b>sample</b>]<span></td>
    <tr> <td>6</td>
         <td><span style="color: #808000; background-color: black">[<b>sample</b>]<span></td>
    <tr> <td>7</td>
         <td><span style="color: #c0c0c0; background-color: black">[<b>sample</b>]<span></td>
    <tr> <td>8</td>
         <td><span style="color: #808080; background-color: black">[<b>sample</b>]<span></td>
    <tr> <td>9</td>
         <td><span style="color: #0080ff; background-color: black">[<b>sample</b>]<span></td>
    <tr> <td>10</td>
         <td><span style="color: #00ff00; background-color: black">[<b>sample</b>]<span></td>
    <tr> <td>11</td>
         <td><span style="color: #00ffff; background-color: black">[<b>sample</b>]<span></td>
    <tr> <td>12</td>
         <td><span style="color: #ff0000; background-color: black">[<b>sample</b>]<span></td>
    <tr> <td>13</td>
         <td><span style="color: #ff00ff; background-color: black">[<b>sample</b>]<span></td>
    <tr> <td>14</td>
         <td><span style="color: #ffff00; background-color: black">[<b>sample</b>]<span></td>
    <tr> <td>15</td>
         <td><span style="color: #ffffff; background-color: black">[<b>sample</b>]<span></td>
    </table>
    <p class=indented>
    The color samples above are the default values used by the %p% Session
    Wizard when it creates a desktop shortcut.  The RGB values for any of the
    console colors can be changed later using the Colors tab on the Properties
    dialog of the shortcut.
    <p class=indented>
    In NVT mode, %p% maps the ANSI-standard colors 0 through
    7 to host colors, and from host colors to console colors.
    The mapping from ANSI colors to host colors cannot be changed, but the
    mapping from host colors to console colors can be with
    <b>%p%.consoleColorForHostColor*</b> resources.
    The mappings and defaults are as follows:
    <table cols=3 width="75%">
    <tr><th>NVT ANSI Color</th>
        <th>Mapped Host Color (not configurable)</th>
	<th>Default Console Color</th>
    <tr> <td>0 (black)</td>     <td>0 (Black)</td> <td>0</td> </tr>
    <tr> <td>1 (red)</td>       <td>2 (Red) </td> <td>12</td> </tr>
    <tr> <td>2 (green)</td>     <td>4 (Green)</td> <td>10</td> </tr>
    <tr> <td>3 (yellow)</td>    <td>6 (Yellow)</td> <td>14</td> </tr>
    <tr> <td>4 (blue)</td>      <td>1 (Blue)</td> <td>9</td> </tr>
    <tr> <td>5 (magenta)</td>   <td>3 (Pink)</td> <td>13</td> </tr>
    <tr> <td>6 (turquoise)</td> <td>6 (Turquoise)</td> <td>14</td> </tr>
    <tr> <td>7 (white)</td>     <td>7 (NeutralWhite)</td> <td>15</td> </tr>
    </table>
    <p class=indented>
    For example, to change the display from white-on-black to black-on-white,
    define the following resources:
    <pre>
     %p%.consoleColorForHostColorNeutralBlack: 15
     %p%.consoleColorForHostColorNeutralWhite: 0
    </pre>
.

name crosshair
applies x C
groups a
type b
default false
option Options -&gt; Toggles -&gt; Crosshair Cursor
switch -set crosshair
switch -clear crosshair
description
    When true, causes %p% to display a crosshair over the
    cursor: lines extending with height and width of the screen.
.

name crosshairColor
applies x C
groups a
type s
default purple
description
    Defines the color used for the crosshair cursor (see %-crosshair%).
    The value is a host color name or numeric host color index:
    <table cols=2 width="75%">
    <tr> <th>Host Color Name</th>
         <th>Host Color Index</th>
    <tr> <td>NeutralBlack</td> <td>0</td> </tr>
    <tr> <td>Blue</td> <td>1</td> </tr>
    <tr> <td>Red</td> <td>2</td> </tr>
    <tr> <td>Pink</td> <td>3</td> </tr>
    <tr> <td>Green</td> <td>4</td> </tr>
    <tr> <td>Turquoise</td> <td>5</td> </tr>
    <tr> <td>Yellow</td> <td>6</td> </tr>
    <tr> <td>NeutralWhite</td> <td>7</td> </tr>
    <tr> <td>Black</td> <td>8</td> </tr>
    <tr> <td>DeepBlue</td> <td>9</td> </tr>
    <tr> <td>Orange</td> <td>10</td> </tr>
    <tr> <td>Purple</td> <td>11</td> </tr>
    <tr> <td>PaleGreen</td> <td>12</td> </tr>
    <tr> <td>PaleTurquoise</td> <td>13</td> </tr>
    <tr> <td>Grey</td> <td>14</td> </tr>
    <tr> <td>White</td> <td>15</td> </tr>
    </table>
.

name cursesColorForDefault cursesColorForIntensified cursesColorForProtected cursesColorForProtectedIntensified
applies c
groups a
type s
desc
    Defines the default color to use to render text based on its attributes,
    when the host does not specify a particular color.
    <p class=indented>
    The value of the resource can be either a curses color index or curses color
    name.  These are are defined as follows:
    <table cols=2 width="75%">
    <tr> <th>Curses Color Index</th> <th>Curses Color Name</th> </tr>
    <tr> <td>0</td> <td>black</td> </tr>
    <tr> <td>1</td> <td>red</td> </tr>
    <tr> <td>2</td> <td>green</td> </tr>
    <tr> <td>3</td> <td>yellow</td> </tr>
    <tr> <td>4</td> <td>blue</td> </tr>
    <tr> <td>5</td> <td>magenta</td> </tr>
    <tr> <td>6</td> <td>cyan</td> </tr>
    <tr> <td>7</td> <td>white</td> </tr>
    <tr> <td>8</td> <td><i>no name -- displays as grey</i></td> </tr>
    <tr> <td>9</td> <td><i>no name -- displays as bright red</i></td> </tr>
    <tr> <td>10</td> <td><i>no name -- displays as bright green</i></td> </tr>
    <tr> <td>11</td> <td><i>no name -- displays as bright yellow</i></td> </tr>
    <tr> <td>12</td> <td><i>no name -- displays as bright blue</i></td> </tr>
    <tr> <td>13</td> <td><i>no name -- displays as bright magenta</i></td> </tr>
    <tr> <td>14</td> <td><i>no name -- displays as bright cyan</i></td> </tr>
    <tr> <td>15</td> <td><i>no name -- displays as bright white</i></td> </tr>
    </table>
    <p class=indented>
    The default values are:
    <table cols=3 width="75%" cellspacing=5>
    <tr> <th>%p% Resource</th>
         <th>Default Curses Color (8-color terminal)</th>
	 <th><b>Default Curses Color (16-color terminal)</th> </tr>
    <tr> <td>cursesColorForDefault</td> <td>green</td> <td>10 (bright green)</td> </tr>
    <tr> <td>cursesColorForIntensified</td> <td>red</td> <td>red</td> </tr>
    <tr> <td>cursesColorForProtected</td> <td>blue</td> <td>12 (bright blue)</td> </tr>
    <tr> <td>cursesColorForProtectedIntensified</td> <td>white</td> <td>15 (bright white)</td> </tr>
    </table>
.

name cursesColorForHostColor0 cursesColorForHostColorNeutralBlack cursesColorForHostColor1 cursesColorForHostColorBlue cursesColorForHostColor2 cursesColorForHostColorRed cursesColorForHostColor3 cursesColorForHostColorPink cursesColorForHostColor4 cursesColorForHostColorGreen cursesColorForHostColor5 cursesColorForHostColorTurquoise cursesColorForHostColor6 cursesColorForHostColorYellow cursesColorForHostColor7 cursesColorForHostColorNeutralWhite cursesColorForHostColor8 cursesColorForHostColorBlack cursesColorForHostColor9 cursesColorForHostColorDeepBlue cursesColorForHostColor10 cursesColorForHostColorOrange cursesColorForHostColor12 cursesColorForHostColorPurple cursesColorForHostColor13 cursesColorForHostColorPaleGreen cursesColorForHostColor14 cursesColorForHostColorPaleTurquoise cursesColorForHostColor15 cursesColorForHostColorGrey cursesColorForHostColor16 cursesColorForHostColorWhite
applies c
groups a
type s
desc
    Defines what curses color to use to render a particular host color.
    Host colors can be specified by name or number.  That is, to define the
    curses color to use when the host specifies <b>green</b>, which is host
    color 4, either the resource <b>%p%.cursesColorForHostColorGreen</b> or
    the resource <b>%p%.cursesColorForHostColor4</b> can be defined.
    <p class=indented>
    The default definitions are as follows.  Note that on an 8-color
    terminal, %p% only displays 8 host colors.
    <table cols=4 width="75%">
    <tr> <th>Host Color Index</th>
         <th>Host Color Name</th>
         <th>Default Curses Color (8-color terminal)</th>
         <th>Default Curses Color (16-color terminal)</th> </tr>
    <tr> <td>0</td> <td>NeutralBlack</td> <td>black</td> <td>black</td> </tr>
    <tr> <td>1</td> <td>Blue</td> <td>blue</td> <td>12 (bright blue)</td> </tr>
    <tr> <td>2</td> <td>Red</td> <td>red</td> <td>red</td> </tr>
    <tr> <td>3</td> <td>Pink</td> <td>red</td> <td>13 (bright magenta)</td> </tr>
    <tr> <td>4</td> <td>Green</td> <td>green</td> <td>10 (bright green)</td> </tr>
    <tr> <td>5</td> <td>Turquoise</td> <td>cyan</td> <td>14 (bright cyan)</td> </tr>
    <tr> <td>6</td> <td>Yellow</td> <td>yellow</td> <td>11 (bright yellow)</td> </tr>
    <tr> <td>7</td> <td>NeutralWhite</td> <td>white</td> <td>15 (bright white)</td> </tr>
    <tr> <td>8</td> <td>Black</td> <td>-</td> <td>black</td> </tr>
    <tr> <td>9</td> <td>DeepBlue</td> <td>-</td> <td>blue</td> </tr>
    <tr> <td>10</td> <td>Orange</td> <td>-</td> <td>9 (bright red)</td> </tr>
    <tr> <td>11</td> <td>Purple</td> <td>-</td> <td>magenta</td> </tr>
    <tr> <td>12</td> <td>PaleGreen</td> <td>-</td> <td>green</td> </tr>
    <tr> <td>13</td> <td>PaleTurquoise</td> <td>-</td> <td>cyan</td> </tr>
    <tr> <td>14</td> <td>Grey</td> <td>-</td> <td>white</td> </tr>
    <tr> <td>15</td> <td>White</td> <td>-</td> <td>15 (bright white)</td> </tr>
    </table>
    <p class=indented>
    Note that "neutral black" means black on a display device and white on
    a printing device, and "neutral white" means white on a display device and
    black on a printing device.
    <p class=indented>
    In NVT mode, %p% maps the ANSI-standard colors 0 through
    7 to host colors, and from host colors to curses colors.
    The mapping from ANSI colors to host colors cannot be changed, but the
    mapping from host colors to curses colors can be with
    <b>%p%.cursesColorForHostColor*</b> resources.
    The mappings and defaults are as follows:
    <table cols=4 width="75%">
    <tr><th>NVT ANSI Color</th>
        <th>Mapped Host Color (not configurable)</th>
	<th>Default Curses Color (8-color terminal)</th>
	<th>Default Curses Color (16-color terminal)</th> </tr>
    <tr> <td>0 (black)</td> <td>0 (Black)</td> <td>black</td> <td>black</td> </tr>
    <tr> <td>1 (red)</td> <td>2 (Red)</td> <td>red</td> <td>red</td> </tr>
    <tr> <td>2 (green)</td> <td>4 (Green)</td> <td>green</td> <td>10 (bright green)</td> </tr>
    <tr> <td>3 (yellow)</td> <td>6 (Yellow)</td> <td>yellow</td> <td>11 (bright yellow)</td> </tr>
    <tr> <td>4 (blue)</td> <td>1 (Blue)</td> <td>blue</td> <td>12 (bright blue)</td> </tr>
    <tr> <td>5 (magenta)</td> <td>3 (Pink)</td> <td>red</td> <td>13 (bright magenta)</td> </tr>
    <tr> <td>6 (turquoise)</td> <td>13 (PaleTurquioise)</td> <td>cyan</td> <td>cyan</td> </tr>
    <tr> <td>7 (white)</td> <td>15 (White)</td> <td>white</td> <td>15 (bright white)</td> </tr>
    </table>
    <p class=indented>
    See %-cursesColorForDefault% for the definitions of curses colors.
.

name cursesKeypad
applies c
type b
default false
desc
    When true, %p% will set up the terminal in curses keypad mode.
.

name cursorBlink
applies x
groups a
type b
default false
option Options -&gt; Toggles -&gt; Blinking Cursor
switch -set cursorBlink
switch -clear cursorBlink
description
    When true, causes %p% to use a blinking cursor.
.

name cursorColor
applies x
groups a
type s
default red
description
    On color X11 displays, this is the color of the text cursor.  This resource
    is used only if %-useCursorColor% is true.
.

name dbcsCgcsgid
applies a
groups p
type s
description
    Overrides the compiled-in value of the CGCSGID for the current host
    character set, which will be reported to the host in response to a
    Query(Character Sets).  The value is an integer, which can be prefixed with
    '0x' to be in hexadecimal.  The upper 16 bits are the GCSGID (character
    set) and the lower 16 bits are the CPGID (code page).  This value
    applies only to the double-byte (DBCS) character set.  Use
    %-sbcsCgcsgid% for the single-byte (SBCS) character set.
.

name debugTracing
applies x
groups t s
type b
default true
description
    If true, options are available on the <b>File</b> menu
    to trace the 3270 data stream and X11 events.  If false, these
    options are not displayed.
.

name defaultFgBg
applies c
type b
groups a
default false
switch -defaultfgbg
description
    If true, %p% will use the terminal's default foreground color instead of
    specifying the curses color <b>white</b>, and it will use the terminal's
    default background color instead of specifying the curses color
    <b>black</b>. This is helpful in two cases: for emulators such as
    <b>gnome-terminal</b> whose usual representation of a black background is
    a murky gray, and for emulators configured with a black foreground and a
    white background, so that %p%'s screen will appear the same way.
    <p class=indented>
    <b>defaultFgBg</b> will be set to true automatically if the environment
    variable <b>COLORTERM</b> is set to <b>gnome-terminal</b>.
    <p class=indented>
    Note that this resource and option are available only if %p% has been
    compiled with a version of ncurses that supports default foreground and
    background colors, and if the terminal and its associated termcap/terminfo
    entry also support it (it is usually implemented as ANSI color 9).
.

name defScreen
applies c
type s
switch -defscreen
desc
    Defines a character string that will be output to switch the terminal from
    132-column mode to 80-column mode.
    Within the string, the sequence <b>\E</b> is translated to the ASCII
    ESC character (0x1b).
    <p class=indented>
    When %-model% is 5, and this and
    %-altScreen% are defined, %p% will automatically change the
    terminal size when the host switches between the default (24x80) screen
    and the alternate (27x132) screen.
.

name devName
applies a
type s
switch -devname
groups p
description
    Specifies the device name (workstation ID) sent in response to a TELNET
    NEW-ENVIRON sub-negotiation request, used by iSeries hosts (RFC 4777).
.

name disconnectClear
applies x
type b
default false
description
    If true, %p% will clear the screen when a host disconnects.
.

name doConfirms
applies x
type b
default true
description
    When true, %p% will display a pop-up to report successful
    completion of certain operations, such as screen printing.  When
    false, these pop-ups are not displayed.
.

name dpi
applies x
type i
default 96
description
    Overrides the system DPI (screen resolution) setting, normally retrieved
    from Xft.dpi. This resource modifies the sizes of visual elements on the
    screen, but not fonts.
.

name emulatorFont
type s
applies x
groups a
default 3270
switch -efont
option Options -&gt; Font
description
    The font used for the emulator window.  By default it is <b>3270</b>,
    a 14-pixel
    clone of a real 3278 display font.  Other 3270-specific fonts are
    available in 8-, 12-, 16-, 24- and 32-pixel sizes.
    Any standard X11 constant-spaced font can also be used, provided that
    it implements a display character set compatible with the host code page
    (%-codepage%).  However, the special
    OIA (status line) symbols are only available with the 3270 fonts.
.

name eof
type s
applies a
groups n
default ^D
description
    This setting is used only in NVT mode, and is similar in function to
    the <i>stty</i> parameter of the same name.
    <p class=indented>
    When connected in line-at-a-time mode (when %p% gathers a line of input
    before forwarding it to the host), entering this character at the
    keyboard causes
    the current line of
    input to be forwarded to the host without a trailing CR/LF sequence.
    <p class=indented>
.

name erase
type s
applies a
groups n
default ^?
description
    This setting is used only in NVT mode, and is similar in function to
    the <i>stty</i> parameter of the same name.
    <p class="indented">
    When connected in line-at-a-time mode (%p% gathers a line of input
    before forwarding it ot the host), entering this character at the keyboard
    will cause %p% to discard the last character on the input line.
    <p class="indented">
    When connected in character-at-a-time mode (%p% sends each keystroke
    to the host as it is entered), this is the character that will be sent
    to the host by the <b>Erase</b> action.
.

name fixedSize
type s
applies x
groups a
description
    Specifies a fixed size for the %p% display window.
    If set, %p% will not allow its window to be resized by the window manager.
    The syntax is <b><i>width</i>x<i>height</i></b>.
    The 3270 display screen will float in the center of the window if necessary.
.

name foreground
type s
applies x
groups a
default black
switch -fg
switch -rv
description
    The foreground color for menus, buttons, and on monochrome X11 displays, the
    emulator display.
.

name ftAllocation
type s
applies a
groups i
default default
description
    Defines the default allocation type for files sent to TSO hosts by IND$FILE
    file transfers.
    Possible values are default, which lets the host decide the allocation
    type, or tracks, cylinders, or avblock.
.

name ftAvblock
type i
applies a
groups i
description
    Defines the default AVBOCK (average block) allocation size for files sent
    to TSO hosts by IND$FILE file transfers.
.

name ftBlksize
type i
applies a
groups i
description
    Defines the default block size for files sent to TSO hosts by IND$FILE
    file transfers.
.

name ftBufferSize
applies a
groups p
type i
default 4096
description
    Specifies the default buffer size for DFT IND$FILE file transfers.  This
    value can be overridden in the File Transfer dialog and by a parameter to
    the <b>Transfer</b> action.
.

name ftCr
type s
applies a
groups i
default auto
description
    Defines the default action for line separators (carriage returns and line
    feeds) in ASCII files during IND$FILE file transfers.
    The value can be auto, which will add them when files are received from the
    host and remove them when they are sent to the host, add (same as auto),
    remove (same as auto), or keep, meaning no special processing is done.
.

name ftDirection
type s
applies a
groups i
default receive
description
    Defines the default IND$FILE file transfer direction, from the perspective
    of the workstation.
    The value can be either send (send file from workstation to host) or
    receive (receive file from host to workstation).
.

name ftExist
type s
applies a
groups i
default keep
description
    Defines the default behavior for IND$FILE file transfers when the
    destination file already exists.
    The value keep means that the transfer will be
if x
    aborted (or if invoked interactively, the user will be prompted to confirm
    the file is to be overwritten),
else
    aborted,
endif
    replace means that the file will be overwritten unconditionally, and
    append means that the new file will be appended to the old file.
.

name ftHost
type s
applies a
groups i
default tso
description
    Defines the default host type for IND$FILE file transfers.
    The value can be vm, tso or cics.
.

name ftHostFile
type s
applies a
groups i
description
    Defines the default host file name for IND$FILE file transfers.
.

name ftLocalFile
type s
applies a
groups i
description
    Defines the default local file name for IND$FILE file transfers.
.

name ftLrecl
type i
applies a
groups i
description
    Defines the default logical record length for files sent to the host via
    IND$FILE.
.

name ftMode
type s
applies a
groups i
default ascii
description
    Defines the default mode for IND$FILE file transfers: ascii (text, with
    translation between the workstation's code page and EBCDIC), or binary (no
    translation).
.

name ftPrimarySpace
type i
applies a
groups i
description
    Defines the default primary space allocation for files sent to TSO hosts
    via IND$FILE.
.

name ftRecfm
type s
applies a
groups i
default default
description
    Defines the default record format for files sent to the host using
    IND$FILE.
    Possibe values are default, fixed, variable, and undefined.
    The default value of 'default' lets IND$FILE choose an appropriate format.
.

name ftRemap
type s
applies a
groups i
default yes
description
    Defines the default mapping behavior for ASCII files transferred with
    IND$FILE.
    When set to yes, ASCII files are translated by
    %p% to produce as accurate a mapping as possible between the workstation's
    code page and the host's EBCDIC code page. When set to no, only the fixed
    translation built into the IND$FILE application is run, which (roughly)
    maps ISO 8859-1 to host code page 37.
.

name ftSecondarySpace
type i
applies a
groups i
description
    Defines the default secondary space allocation for files sent to TSO hosts
    via IND$FILE.
.

name ftWindowsCodePage
type i
applies w
groups i
description
    The Windows code page to use for translating between EBCDIC and ASCII in
    IND$FILE file transfers. The default is to use the system ANSI code page.
    This value can be overridden in the File Transfer dialog and by a parameter
    to the <b>Transfer</b> action.
.

name highlightBold
type b
applies x
groups a
default false
description
    If true, highlighted fields will be displayed in bold.  If
    false, highlighted fields will be displayed in the normal
    font.
.

name hostColorForDefault hostColorForIntensified hostColorForProtected hostColorForProtectedIntensified
applies wc
groups a
type s
desc
    Defines the default color to use to render text with a particular
    attribute, when the host does not specify a particular color.
    <p class=indented>
    The value of the resource is a host color name or color index.
    See %-consoleColorForHostColor0% for the definitions of host colors.
    <p class=indented>
    The default values are:
    <table cols=2 width="75%">
    <tr> <th>%p% Resource</th>
         <th>Default Host Color</th>
    <tr> <td>hostColorForDefault</td> <td>Green</td> </tr>
    <tr> <td>hostColorForIntensified</td> <td>Red</td> </tr>
    <tr> <td>hostColorForProtected</td> <td>Blue</td> </tr>
    <tr> <td>hostColorForProtectedIntensified</td> <td>NeutralWhite</td> </tr>
    </table>
.

name hostname
type s
applies a
groups c
desc
    Gives the name of the host to connect to.  The name can include the usual
    options (prefixes to specify special connection options, LU names, and
    port).  A hostname specified on the command line takes precedence over
    %-hostname%.
    <p class=indented>
    The most common use of %-hostname% is in <i>session files</i>, where a
    file is used to pass all of the options to establish a %p% session.
.

name hostsFile
type s
applies x
default /usr/local/etc/x3270/ibm_hosts
description
    The pathname of a file listing the host names that appear on the
    <b>File -&gt; Connect</b> menu.
    The file can also be used to create hostname aliases and to define a set
    of actions to perform when connecting to a host.
    <p class="indented">
    The format of the file is explained on the <i>ibm_hosts</i> manual page.
    The default pathname is actually <b>ibm_hosts</b> in the directory
    defined by %-confDir%.
.

name hostsFile
type s
applies C S
if u
default /usr/local/etc/x3270/ibm_hosts
else
default ibm_hosts
endif
description
    The pathname of a file containing hostname aliases.
    The file can also be used to define a set of actions to perform when
    connecting to a host.
    <p class="indented">
    The format of the file is explained on the <i>ibm_hosts</i> manual page.
if u
    The default pathname is actually <b>ibm_hosts</b> in the directory
    defined by %-confDir%.
endif
.

name httpd
type s
applies C S x
switch -httpd
description
    Defines the TCP port and optional address to listen on for HTTP
    connections. (%p% implements a simple REST API and a set of HTML objects
    for access by scripts.) The syntax of this resource is
    [<i>address</i>:]<i>port</i>, where <i>address</i> is an IPv4 or IPv6
    address such as <b>127.0.0.1</b> or <b>0.0.0.0</b>, and <i>port</i> is a
    TCP port such as <b>4080</b>. The address can also be specified as <b>*</b>
    to indicate <b>0.0.0.0</b>. A numeric IPv6 address must be enclosed in
    square brackets, e.g., <b>[1234:5678::3]</b>, to avoid ambiguity between
    the colons inside the address and the colon separating the address from the
    port. If no address is specified, it defaults to <b>127.0.0.1</b>.
.

name iconFont
type s
applies x
groups a
default nil2
description
    The font used to paint the text inside the active icon (see %-activeIcon%).
    The default of <b>nil2</b> is a one-by-two pixel font that produces a
    "greeked" picture of the screen image.
.

name iconLabelFont
type s
applies x
groups a
default 8x13
description
    When %-activeIcon% and %-labelIcon% are true, this is the
    name of the font used to paint the icon label.
.

name icrnl
type b
applies a
groups n
default true
description
    This setting is used only in NVT mode, and is similar in function to
    the <i>stty</i> parameter of the same name.
    It controls whether input carriage returns are mapped to newlines.
.

name idleCommand
applies x C S
groups i
type s
description
    When %-idleCommand% is defined, it specifies a command to execute after a
    period of keyboard inactivity (no AID keys pressed).
    The %-idleCommand% can be an arbitrary sequence of %p% actions, but it
    should include an action which generates an AID (<b>Enter</b>, <b>Clear</b>,
    <b>PF</b> or <b>PA</b>).
    %-idleCommandEnabled% must be true in order for the
    %-idleCommand% to take effect. (This is so an idle command can be defined,
    but needs to be enabled explicitly at some point after login.)
    %-idleTimeout% specifies the inactivity interval.
.

name idleCommandEnabled
applies x C S
groups i
type b
default false
description
    Controls whether %-idleCommand% has effect as soon as a host session
    is established.  (This is so an idle command can be defined, but needs to
    be explicitly enabled at some point after login.)
.

name idleTimeout
applies x C S
groups i
type s
default ~7m
description
    The timeout value for %-idleCommand%.
    If the value ends in <b>h</b>, it specifies hours; if it ends in
    <b>m</b> it specifies minutes; if it ends in <b>s</b> or does not have
    an alphanumeric suffix, it specifies seconds.
    <p class="indented">
    If the value begins with a tilde <b>~</b>, the time will be randomly
    varied +/-10% from the value specified.
.

name inlcr
applies a
groups n
type b
default false
description
    This setting is used only in NVT mode, and is similar in function to
    the <i>stty</i> parameter of the same name.
    It controls whether input newlines are mapped to carriage returns.
.

name inputColor
applies x
groups a
type s
default green
description
    This resource defines the color used to display light-pen selectable
    text in 3278 (monochrome) emulation mode.
    <p class=indented>
    Previous versions of %p% implemented something called <i>pseudo-color
    mode</i>, where a monochrome (3278) terminal was emulated with various
    colors assigned to different kinds of fields.
    To emulate pseudo-color mode with the current version of %p%, select 3278
    emulation with %-model%, set %-inputColor% to <b>orange</b> and set
    %-boldColor% to <b>cyan</b>.
    <p class=indented>
    If the resource %-modifiedSel% is true, modified fields
    are also displayed using %-inputColor%.
.

name inputMethod
applies x
type s
switch -im
description
    Specifies the name of the multi-byte input method.  The
    default is specified by the XMODIFIERS environment variable, if set, or
    will be constructed by Xlib based on the current locale.
.

name insertMode
applies a
type b
default false
description
    Controls 3270 insert mode.
.

name intr
applies a
groups n
type s
default ^C
description
    This setting is used only in NVT mode, and is similar in function to
    the <i>stty</i> parameter of the same name.
    When this character is typed on the keyboard, the TELNET IP
    (Interrupt Process) sequence is sent to the host.
.

name invertKeypadShift
applies x
type b
default false
description
    When true, causes the PF1-PF12 and PF13-PF24 keys on the
    pop-up keypad to be swapped.  Normally, the low-numbered keys appear;
    when Shift, Alt, Ctrl or Meta is pressed, the high-numbered keys appear.
    With this resource true, that is reversed.
.

name keyFile
applies u
groups s
type s
switch -keyfile
desc
    Gives the name of a file containg the private key for the certificate
    specified by %-certFile% or %-chainFile%.  The default file type is PEM;
    it can be overridden by %-keyFileType%.  If the private key is encrypted,
    the password is specified by %-keyPasswd%.
    (OpenSSL only)
.

name keyFileType
applies u
groups s
type s
default pem
switch -keyfileType
desc
    Gives the type of the private key file specified by %-keyFile%.
    The value can be <b>pem</b> or <b>asn1</b>.
    (OpenSSL only)
.

name keyHeight
applies x
groups a
type i
default 24
desc
    Defines the height of the keys on the pop-up keypad.
.

name keymap
applies x C
groups c
type s
switch -keymap
description
    The name of the keyboard map to use.
    It can be a single keymap name or a comma-separated list of keymaps,
    which will be applied in order.
    <p class=indented>
    Each keymap can optionally be defined in three separate parts: a common
    keymap, which is applied at all times, an NVT-mode keymap, which is
    applied only in NVT mode, and a 3270-mode keymap, which is only applied
    in 3270 mode.
    The NVT-mode keymap has the same name as the common keymap, with the
    suffix <b>.nvt</b> appended.
    The 3270-mode keymap has the suffix <b>.3270</b> appended.
    Thus specifying a %-keymap% value of <i>foo</i> implies the use of
    three different keymaps (if found): <b>foo</b>, <b>foo.nvt</b> and
    <b>foo.3270</b>.
if x
    <p class=indented>
    After that, the string <b>.user</b>
    is appended to the keymap name and three more keymaps are searched
    for: <b>foo.user</b>, <b>foo.user.nvt</b> and <b>foo.user.3270</b>,
    for a total of six.
endif
    <p class=indented>
if x
    If no %-keymap% is defined, the environment variables $KEYMAP and
    $KEYBD are checked, in that order, for the name.
    %-keymap% is only the name; the keymap definition for name
    <i>foo</i> is the resource %-keymap.<i>foo</i>%.
endif
if C
    %-keymap% is only the name; the actual keymap for name
    <i>foo</i> can be defined either by the resource %-keymap.<i>foo</i>%, or
    by a
    <i>keymap file</i>.
if c
    The keymap file is not searched for in any particular
    location, nor does it have a special suffix, so %-keymap% can specify the
    full pathname of the keymap file.
else
    Keymap files are located in the wc3270 documents directory
    (usually <b>My Documents\wc3270</b>)
    and have the suffix <b>.wc3270km</b>.
endif
endif
.

name keymap.<i>foo</i>
applies x C
type s
description
    The definition of keymap <i>foo</i>.
    Please refer to the <i>How To Create a Custom Keymap</i> document for a
    full description of the syntax.
.

name keypad
applies x
groups a
type s
default right
description.
    This controls the position of the pop-up keypad.  It can have one of
    five values:
    <ul>
    <li><b>left</b>, a pop-up window positioned to the left
    of the main %p% window</li>
    <li><b>right</b>, a pop-up window positioned
    to the right of the main x3270 window</li>
    <li><b>bottom</b>, a pop-up window positioned below
    the main %p% window</li>
    <li><b>integral</b>, making the keypad an extension of the
    bottom of the main window itself</li>
    <li><b>insideRight</b>, placing the keypad
    over the upper-right corner of the emulator window, just below the keypad
    button on the menu bar</li>
    </ul>
.

name keypad.keyHeight
applies x
groups a
type i
default 24
description
    The height in pixels of all of the buttons on the keypad.
.

name keyPasswd
applies u
groups s
type s
switch -keypasswd
desc
    On OpenSSL,
    gives the password for the private key file specified by %-keyFile%, if it
    is encrypted.
    The value can take one of two forms. <b>file</b>:<i>filename</i> specifies
    that the password is in a file. <b>string</b>:<i>string</i> gives the
    password value in the resource itself.
    <p class=indented>
    On the Mac, this gives the password for the %-certfile% certifiate file.
.

name keyWidth
applies x
groups a
type i
default 48
description
    The width in pixels of the lower tier of buttons on a horizontal keypad.
.

name keypad.largeKeyWidth
applies x
groups a
type i
default 56
description
    The width in pixels of the lower tier of buttons on a vertical keypad.
.

name keypad.paWidth
applies x
groups a
type i
default 36
description
    The width in pixels of PA and cursor keys on the keypad.
.

name keypad.pfWidth
applies x
groups a
type i
default 32
description
    The width in pixels of PF keys on the keypad.
.

name keypadBackground
applies x
groups a
type s
default grey70
description
    On color X11 displays, this is the color of the empty area behind the
    buttons on the main window and keypad window.  On monochrome X11 displays,
    these areas are filled with a 50% grey bitmap.
.

name keypadOn
applies x
type b
groups a
default false
description
    If true, the keypad will automatically appear when %p% is
    started.
.

name kill
applies a
groups n
type s
default ^U
description
    This setting is used only in NVT mode, and is similar in function to
    the <i>stty</i> parameter of the same name.
    <p class=indented>
    When connected in line-at-a-time mode (when %p% gathers a line of input
    before forwarding it to the host), entering this character at the
    keyboard causes
    the current input line to be erased.
    <p class=indented>
    When connected in character-at-a-time mode (when %p% sends each
    keystroke to the host), this is the ASCII character that is sent to
    the host by the <b>DeleteField</b>
    action.
.

name labelIcon
applies x
groups a
type b
default false
description
    When %-activeIcon% is true, the <i>twm</i> window manager will
    not put a label on %p%'s icon.
    Setting %-labelIcon% to true causes
    %p% to supply its own label for the icon.
    <p class=indented>
    The icon label is drawn using the font specified by %-iconLabelFont%.
.

name largeKeyWidth
applies x
groups a
type i
default 56
desc
    Defines the width of the "large" keys in the lower section of the pop-up
    keypad.
.

name lightPenPrimary
applies wc
groups i
type b
default false
description
    Controls how a left mouse button works with the Alt key.
    When set to the default of false, clicking the left mouse button without a
    modifier will move the cursor or highlight an area for copy and paste.
    Clicking the left mouse button with Alt pressed will cause a lightpen
    select operation at the screen location where the mouse cursor is (it will
    not move the 3270 cursor).
    <p class=indented>
    When set to true, these are reversed. The left mouse button without a
    modifier will do a lightpen select; with Alt it will move the cursor or
    select for copy and paste.
.

name lineWrap
applies a
groups n
type b
default true
switch -set lineWrap
switch -clear lineWrap
option Options -&gt; Toggles -&gt; Wraparound
description
    This setting is used only in NVT mode.
    When true, %p% will automatically insert a
    CR/LF sequence when output reaches the end of a line.  When false,
    output will pile up at the end of each line until the host sends a
    CR/LF sequence.
.

name loginMacro
applies a
type s
switch -loginmacro
desc
    Defines a sequence of commands to run as soon as a host connection is
    established.  Usually these would be commands used to navigate through
    login screens, such <b>String</b>, <b>Tab</b> and <b>Enter</b>.
    <p class=indented>
    If a %-hostsFile% is in use and a matching entry is found, the login
    macro from that entry will be used in preference to the %-loginMacro%.
.

name lnext
applies a
groups n
type s
default ^V
description
    This setting is used only in NVT mode, and is similar in function to
    the <i>stty</i> parameter of the same name.
    <p class=indented>
    When connected in line-at-a-time mode (when %p% gathers a line of input
    before forwarding it to the host), entering this character at the
    keyboard removes any special meaning from the next character entered.
.

name localCp
applies ws
type i
desc
    Forces %p% to use the specified codepage in place of the system ANSI
    codepage.  This codepage is used when interpreting keymap files and
    when generating trace files.
.

name lockedCursor
applies x
groups a
type s
default X_cursor
description
    The name of the mouse cursor displayed with %p% is not connected to a
    host.
.

name macros
applies x
type s
description
    Defines a set of macros assigned to the <b>Macros</b> menu that appears
    when connected to a host.
    The syntax is similar to a keymap (an X11 translation
    table), except that rather than a keysym name, the left-hand side is a
    name that will appear on the menu.  A list of actions can be specified
    on the right-hand side.
    <p class=indented>
    %-macros% defines a set of macros for all hosts.
    To specify a set of macros for host <i>foo</i>, use %-macros.<i>foo</i>%.
.

name macros.<i>foo</i>
applies x
type s
description
    Defines a set of macros assigned to the <b>Macros</b> menu that appears
    when connected to host <i>foo</i>.
    It overrides the contents of %-macros%.
    See %-macros% for details on its syntax.
.

name marginedPaste
applies x wc
groups i
type b
default false
switch -set marginedPaste
switch -clear marginedPaste
option Options -&gt; Toggles -&gt; Paste With Left Margin
description
    When true, %p% will use the current cursor position as a
    left margin for pasted data: no pasted data will be input into an area to
    the left of the current cursor positon.
.

name maxRecent
applies x
groups i
type i
default 5
description
    The maximum number of entries in the Connect menu's recent host list.
.

name menuBar
applies x wc
groups a
type b
default true
description
    If false, the menu bar will not be displayed at the top of
    the %p% main window.
if x
    The three pull-down menus are still available,
    however, by pressing Ctrl and each of the mouse buttons.
endif
.

name menuBar
applies c
groups a
type b
default true
description
    If false, the menu bar will not be displayed at the top of
    the %p% display, even if the terminal supports a mouse.
.

name metaEscape
applies c
type b
default true
desc
    When true, %p% will assume that pressing a key while holding down the
    <b>Alt</b> key will cause the terminal to transmit the ASCII ESC character
    (0x1b) before the key.  Thus %p% will interpret ESC-x as Alt-x.
    <p class=indented>
    When false, ESC is treated like any other input character.
.

name minVersion
applies S
type s
switch -minversion
description
    Defines a minimum required version for %p%. If the version of %p% is less
    than the specified version, it will abort.
    <p class=indented>
    The format of a version is
    <i>major</i><b>.</b><i>minor</i><i><b>type</b></i><i>iteration</i>, for example,
    3.4ga5 or 3.5alpha2.
    The version can also be under-specified, such as 3.4 or 3, where the
    missing parts default to 0.
    The value of <i><b>type</b></i> is ignored, so 3.4ga5 and 3.4foo5 are
    considered equal.
.

name model
applies a
groups c
type s
default 3279-4-E
switch -model
option Options -&gt; Screen Size
description
    The terminal model that %p% is emulating.  The model is in three parts,
    separated by dashes; each part is optional.
    <ul>
	<li>3278 or 3279<br>
	    3278 specifies a monochrome (green) 3270 display.
if x
	    If used on a color
	     X11 display, it will cause all fields to be drawn in green.
	     3278 is the default for monochrome X11 displays.
endif
	     <br>
	    3279 specifies a color 3270 display.
if x
	    This is the default for color X11 displays.
endif
	     </li>
	<li>2, 3, 4 or 5</br>
	    The model number, which determines the size of the screen.</br>
	    Model 2 has 24 rows and 80 columns.</br>
	    Model 3 has 32 rows and 80 columns.</br>
	    Model 4 has 43 rows and 80 columns.</br>
	    Model 5 has 27 rows and 132 columns.</br>
	    The default is
if C
	     the largest model that will fit on the console or terminal
	     emulator window where %p% is running.
	     Displaying the OIA (status line) requires one more row than
	     what is listed above.
else
	     4.
endif
	     </li>
	<li>E</br>
	    An optional suffix which indicates support for the 3270 Extended
	     Data Stream (color, extended attributes, Query Reply).  3279
	     implies E.</li>
	     </ul>
.

name modifiedSel
applies x
groups a
type b
default false
description
    When true, modified fields are displayed in a different
    color than other modifiable fields.
    In 3278 mode, this color is the "input" (light pen selectable) color,
    defined by %-inputColor%.
    In 3279 mode, this is the color whose index is defined by
    %-modifiedSelColor%.
    When %-modifiedSel% is false,
    modified fields are displayed in the same colors as unmodified fields.
.

name modifiedSelColor
applies x
groups a
type i
default 10
description
    In 3279 mode, when %-modifiedSel% is true,
    this is index of the host color used to display modified fields.
    The default value of 10 corresponds to "orange".
    (See %-colorSchemes% for the host color index definitions.)
.

name mono
applies x c
type b
default false
switch -mono
description
if x
    If true, %p% will operate as if it were running on a
    monochrome X11 display.
else
    If true, %p% will emulate a 3278, and will not use any of the terminal's
    color attributes.
endif
.

name monoCase
applies a
type b
default false
switch -set monoCase
switch -clear monoCase
option Options -&gt; Toggles -&gt; Monocase
description
    When true, causes %p% to run in uppercase-only mode.
.

name mouse
applies c
groups i
type b
default true
description
    If true, enables %p% to accept mouse-control events on terminals and
    emulators that support them.  This allows a left mouse click to move the
    cursor.  On terminals like xterm and gnome-terminal, this means that the
    usual mouse selection actions must be performed with the Shift key pressed.

    If false, mouse-control events will not be enabled.
.

name newEnviron
applies a
type b
default true
description
    If true, %p% will respond to the TELNET NEW-ENVIRONMENT option. If false,
    it will not.
.

name noOther
applies x
groups s
type b
default false
description
    If true, the "Other" options are disabled for selecting
    fonts and connecting to hosts, limiting users to the options provided on
    the menus.
.

name noPrompt
applies C
groups s
type b
default false
desc
    If true, the interactive <b>%p%&gt;</b> prompt will be
    disabled.  In particular, this means that when %p% is not connected to
    a host, a keymap or an external script is the only way to start a new
    host connection.
.

name normalCursor
applies x
type s
groups a
default top_left_arrow
desc
    Defines the mouse cursor that %p% uses when it is connected to a host, not
    waiting for the host to complete a command, and the keyboard is not
    locked.
.

name nopSeconds
applies a
type i
groups i
default 0
desc
    If nonzero, %p% will send a TELNET NOP to the host every <i>n</i> seconds.
    This can be used to keep host sessions running that would otherwise be
    terminated due to inactivity.
.

name normalColor
applies x
groups a
type s
default green
desc
    On color X11 displays in 3278 mode, this is the color of normal-intensity
    text.  On monochrome X11 displays, normal text uses the foreground color.
.

name numericLock
applies a
groups i
type b
default false
desc
    When true, causes %p% to lock the keyboard when non-numeric data
    is entered into fields with the Numeric attribute.
.

name nvtMode
applies a
groups i
type b
default false
switch -nvt
desc
    When true, causes %p% to start immediately in NVT mode and allow keyboard
    input immediately, instead of waiting for the host to send data or
    negotiate 3270 mode. It also causes the default terminal type to be
    <b>xterm</b>.
    <p class="indented">
    NVT mode can also be selected per session by prepending an <b>A:</b> onto
    the hostname.
.

name onlcr
applies a
groups n
type b
default true
desc
    Used only in NVT line-at-a-time mode; similar to the <i>stty</i> parameter
    of the same name.
    It controls whether output newlines are mapped to CR/LF sequences.
.

name oerrLock
applies a
groups i
type b
default true
desc
    If true, operator errors (typing into protected fields,
    insert overflow, etc.) will cause the keyboard to lock with an error
    message in the OIA (status line).  If false, these
    errors will simply cause the terminal bell will ring, without any
    keyboard lock or message.
.

name once
applies x C S t
type b
default false
switch -once
desc
    When true, %p% will exit as soon as a host disconnects.
    The default is <b>false</b> if no hostname is specified on the command
if x C
    line or in a session file,
else
    line,
endif
    <b>true</b> otherwise.
.

name overlayPaste
applies wc x
groups i
type b
default false
switch -set overlayPaste
switch -clear overlayPaste
option Options -&gt; Toggles -&gt; Overlay Paste
desc
    When true, the <b>Paste</b> action will overlay protected fields,
    instead of locking the keyboard and stopping. This means that when the
    cursor is on a protected field, a displayable character read from the paste
    buffer will simply cause the cursor to advance to the right; the actual
    character is ignored. This allows regions of the screen that include
    protected fields to be copied and pasted back into a formatted screens that
    include the same protected fields (i.e., a form).
    <p class="indented">
    Note: Setting overlayPaste to <b>true</b> will cause %p% to act as if the
    %-marginedPaste% toggle were also set.
.

name oversize
applies a
type s
switch -oversize
desc
    Sets the screen dimensions to be larger than the default for the
    chosen model.  Its value is a string in the format
    <b><i>cols</i>x<i>rows</i></b>.
if C
    It can also be the string <b>auto</b>, which will cause %p% to use the
    entire screen area of the
endif
if c
    terminal.
endif
if wc
    console window it is running in.
endif
    It is used only if the %-model% includes the "-E" (extended
    data stream) suffix, and only if the specified dimensions are larger than
    the model number defaults.  Also, only hosts that support the Query Reply
    structured field will function properly with %p% in this mode.
.

name paWidth
applies x
groups a
type i
default 36
desc
    Defines the width of the PA keys in the lower section of the pop-up
    keypad.
.

name pfWidth
applies x
groups a
type i
default 32
desc
    Defines the width of the PF keys on the pop-up keypad.
.

name port
applies a
groups c
type s
default telnet
switch -port
desc
    The name of the default TCP port for %p% to connect to.  This can be
    either a symbolic name from /etc/services, or an integer.
.

name proxy
applies a
groups c
type s
switch -proxy
desc
    Defines a proxy server that %p% will use to connect to hosts.
    The value is of the form
    <b><i>type</i>:[<i>username</i>:<i>password</i>@]<i>server</i></b>[<b>:<i>port</i></b>],
    where options for <i>type</i> are described on the %p% manual page.
.

name preeditType
applies x
type s
default OverTheSpot+1
switch -pt
desc
    The preedit type for the multi-byte input method.  Valid values are
    <b>OverTheSpot</b>, <b>OffTheSpot</b>, <b>Root</b> and
    <b>OnTheSpot</b>.  The value for
    <b>OverTheSpot</b> can include an optional suffix, a signed number
    indicating the vertical distance in rows of the preedit window from the
    cursor position, e.g. <b>OverTheSpot+1</b> or <b>OverTheSpot-2</b>.
.

name printerLu
type s
applies x C
groups c
switch -printerlu
desc
    If a value is set, %p% will automatically start a
if u
    pr3287
else
    wpr3287
endif
    printer session
    when a host connection is established.
    If the value is "<b>.</b>", the
if u
    pr3287
else
    wpr3287
endif
    session will
    be associated with the interactive terminal session (this requires that
    the host supports TN3270E).  Otherwise, the value is taken as the LU
    name to associate with the printer session.
.

name printer.assocCommandLine
applies x C
type s
if x c
default pr3287 -assoc %L% -command %C% %R% %P% %V% %S% %O% %H%
else
default wpr3287.exe -assoc %L% -command %R% %P% %V% %S% %I% %O% %H%
endif
desc
    <i><b>Note:</b> This resource is for debug purposes only. To add optional
    parameters to the wc3270 command line, use %-printer.options.%</i>
    <p class="indented">
    The shell command to use to start a printer session, when associated with
    the current TN3270E session LU (when %-printerLU% is "<b>.</b>").
    Within the string, the following substitutions
    are made:
    <ul>
if x c
	<li><b>%C%</b> is replaced with the %-printer.command%</li>
endif
	<li><b>%H%</b> is replaced with the current host name</li>
if wc
	<li><b>%I%</b> is replaced with an option to pass %-printer.codepage%</li>
endif
	<li><b>%L%</b> is replaced with the current session's LU</li>
	<li><b>%O%</b> is replaced with the value of %-printer.options%</li>
	<li><b>%P%</b> is replaced with the current session's proxy option (%-proxy%)</li>
	<li><b>%R%</b> is replaced with an option to pass the current character set</li>
	<li><b>%S%</b> is replaced with an option to pass the port of the sync socket</li>
	<li><b>%V%</b> is replaced with SSL-related options</li>
    </ul>
.

name printer.codepage
applies wc
type i
desc
    The codepage used by the printer associated with wpr3287 printer sessions.
    The default is to use the system's ANSI codepage.
.

name printer.command
applies x c
type s
default lpr
desc
    The name of the command supplied to the "-command" option of the pr3287
    program to print each job.  This is the text which is substituted for
    <b>%C</b> in %-printer.assocCommandLine% and %-printer.luCommandLine%
    resources.
.

name printer.luCommandLine
applies x C
type s
if x c
default pr3287 -command %C% %R% %P% %V% %S% %O% %L%@%H%
else
default wpr3287.exe %R% %P% %V% %S% %I% %O% %L%@%H%
endif
desc
    <i><b>Note:</b> This resource is for debug purposes only. To add optional
    parameters to the wc3270 command line, use %-printer.options.%</i>
    <p class="indented">
    The shell command to use to start a printer session, when associated with a
    specific LU.  Within the string, the following substitutions are made:
    <ul>
if x c
	<li><b>%C%</b> is replaced with %-printer.command%</li>
endif
	<li><b>%H%</b> is replaced with the current host name</li>
if wc
	<li><b>%I%</b> is replaced with an option to pass %-printer.codepage%</li>
endif
	<li><b>%L%</b> is replaced with the LU value entered into the dialog box</li>
	<li><b>%O%</b> is replaced with the value of %-printer.options%</li>
	<li><b>%P%</b> is replaced with current session's proxy option (%-proxy%)</li>
	<li><b>%R%</b> is replaced with an option to pass the current character set</li>
	<li><b>%S%</b> is replaced with an option to pass the port of the sync socket</li>
	<li><b>%V%</b> is replaced with SSL-related options</li>
    </ul>
.

name printer.name
applies wc
type s
desc
    Defines the name of the printer used for wpr3287 sessions and by the
    <b>PrintText</b> action.  The default is to use the system's default
    printer.
.

name printer.options
applies x C
type s
desc
    Defines extra parameters to substutute for the <b>%O%</b> token in the
    printer command line.
.

name printTextCommand
applies x c
type s
default lpr
desc
    The shell command used by the <b>PrintText</b> action.  An ASCII image of
    the 3270 display becomes the standard input to this command.
if x
    If the first
    character of the command is '@', the usual pop-up windows before and after
    the text is printed will not appear.
endif
.

name printTextFont
applies wc
type s
default Courier New
desc
    The font used by the <b>PrintText</b> action.
.

name printTextHorizontalMargin
applies wc
type i
default 0.5
desc
    The left- and right-hand margins used by the <b>PrintText</b> action when
    printing.
    The value is in inches by default, but can be
    suffixed with <b>mm</b> or <b>cm</b> to specify SI units.
.

name printTextOrientation
applies wc
type i
desc
    The page orientation used by the <b>PrintText</b> action when
    printing.
    The value is either <b>portrait</b> or </b>landscape</b>. The default is
    to use whatever the printer's default is.
.

name printTextScreensPerPage
applies wc c x
type i
default 1
desc
    The number of screens to display on a page when tracing screens to the
    printer.
.

name printTextSize
applies wc
type i
default auto
desc
    The font size used by the <b>PrintText</b> action.
    The default is to select the largest font that
    will fit across the page.
.

name printTextVerticalMargin
applies wc
type i
default 0.5
desc
    The top and bottom margins used by the <b>PrintText</b> action when
    printing.
    The value is in inches by default, but can be
    suffixed with <b>mm</b> or <b>cm</b> to specify SI units.
.

name printWindowCommand
applies x
type s
default xwd -id %d | xpr | lpr
desc
    The shell command used by the <b>PrintWindow</b> action.
    The X11 window identifier of the main x3270 window is substituted for
    any <b>%d</b> in the command.
    If the first character of the command is '<b>@</b>', the usual pop-up
    windows before and after the window is printed will not appear.
.

name qrBgColor
applies C s b
type b
default false
desc
    When true, %p% will report in the QueryReply(color) that it supports
    background color; when false, it will not.  It is disabled by default
    because certain versions of GDDM are confused by this report and will
    crash.
.

name quit
applies a
groups n
type s
default ^\
desc
    This setting is used only in NVT mode, and is similar in function to
    the <i>stty</i> parameter of the same name.
    When connected in line-at-a-time mode (when %p%
    gathers a line of input before forwarding it to the host),
    entering this character at the keyboard causes the
    TELNET BREAK sequence to be sent to the host.
.

name reconnect
applies x C
type b
default false
desc
    When true, %p% will automatically reconnect to a host after it disconnects.
.

name rectangleSelect
applies x
groups i
type b
default false
switch -set rectangleSelect
switch -clear rectangleSelect
option Options -&gt; Toggles -&gt; Select by Rectangles
desc
    When true, %p% will always select rectangular areas of the
    screen.  When false, %p% will select rectangular areas in 3270
    mode, but in NVT mode it will select continuous areas of the screen like
    <i>xterm</i>.
.

name reverseInputMode
applies a
type b
default false
desc
    When true in 3270 mode, input fields fill in the opposite direction of the
    screen display.
.

name reverseVideo
applies c
type b
groups a
default false
option -rv
desc
    When true, %p% will use a white background instead of a black one.
.

name rightToLeftMode
applies x C
type b
default false
desc
    When true, the %p% display will be in right-to-left mode, with column 1
    on the right instead of on the left.
.

name rprnt
applies a
groups n
type s
default ^R
desc
    This setting is used only in NVT mode, and is similar in function to
    the <i>stty</i> parameter of the same name.
    When connected in line-at-a-time mode (when %p%
    gathers a line of input before forwarding it to the host), entering this
    character at the keyboard causes the current input line to be redisplayed.
.

name saveLines
applies x C
type i
default 4096
switch -sl
desc
    The number of display lines to save for the scroll bar. Note that the
    scroll bar operates on full screens of data, so the value divided by the
    number of rows on the screen gives you the number of screens that will be
    saved.
.

name sbcsCgcsgid
applies a
groups p
type s
desc
    Overrides the compiled-in value of the CGCSGID for the current host
    character set.  The value is an integer, which can be prefixed with '0x'
    to be in hexadecimal.  The upper 16 bits are the GCSGID (character
    set) and the lower 16 bits are the CPGID (code page).  This value
    applies only to the single-byte (SBCS) character set.  Use
    %-dbcsCgcsgid% for the double-byte (DBCS) character set.
.

name schemeList
applies x
type s
desc
    Lists the options on the Color Scheme menu.  Can contain '>' characters to
    indicate a menu hierarchy. The format of the list is one entry per line,
    each line containing the menu label, a colon and the name of the color
    scheme.
.

name screenTrace
applies a
groups t
type b
default false
switch -set screenTrace
switch -clear screenTrace
option File -&gt; Save Screen(s) in File
desc
    When true, %p% will save an ASCII version of the screen image in
    a file every time it changes.
    The file name defaults to
if u
    <b>x3scr.<i>pid</i></b>.
else
    <b>x3scr.<i>pid</i>.txt</b>.
endif
    The directory where the file is written is defined by %-traceDir%.
    If %-screenTraceFile% is defined, it defines the
    file name and %-traceDir% is ignored.
if w
    file name.
endif
.

name screenTraceFile
applies a
groups t
type s
desc
    If defined, gives the name of the file that screen traces will be
    written into.
.

name scripted
applies x
type b
default false
switch -script
desc
    When true, %p% will read commands from standard input.  The rules
    for these commands are documented in the <i>x3270-script</i> manual page.
.

name scriptPort
applies a
type i
switch -scriptport
desc
    If defined, %p% will accept script connections on the specified local TCP
    port.
    The rules for the commands passed over these connections are documented
    in the <i>x3270-script</i> manual page.
    The syntax of this resource is [<i>address</i>:]<i>port</i>, where
    <i>address</i> is an IPv4 or IPv6 address such as <b>127.0.0.1</b> or
    <b>0.0.0.0</b>, and <i>port</i> is a TCP port such as <b>4081</b>. The
    address can also be specified as <b>*</b> to indicate <b>0.0.0.0</b>. A
    numeric IPv6 address must be enclosed in square brackets, e.g.,
    <b>[1234:5678::3]</b>, to avoid ambiguity between the colons inside the
    address and the colon separating the address from the port. If no address
    is specified, it defaults to <b>127.0.0.1</b>.
.

name scriptPortOnce
applies a
type b
default false
switch -scriptportonce
desc
    If defined, %p% will accept only one script connection. When that
    connection is broken, it will exit.
.

name scrollBar
applies x
type b
default false
switch -sb
switch +sb
switch -set scrollBar
switch -clear scrollBar
desc
    When true, %p% will display a scroll bar to the right of the emulator
    window.
.

name secure
applies x
groups s
type b
default false
desc
    When true, %p% will prevent users from executing arbitrary
    commands from within the program.
    In particular, the <b>File -&gt; x3270&gt; Prompt</b> menu option is
    disabled, as are the pop-ups which allow editing the commands
    for <b>File -&gt; Print Screen Text</b> and
    <b>File -&gt; Print Window Bitmap</b>, and
    %-disconnectClear% is true.
    See %-noOther% and %-suppressActions% for additional security options.
.

name selectBackground
applies x
groups a
type s
default dimGrey
desc
    On color X11 displays, this is the background color used for selected text
    (text highlighted with the mouse for cut and paste).  On monochrome
    X11 displays, selected text is in reverse video.
.

name showTiming
applies x
groups a
type b
default false
switch -set showTiming
switch -clear showTiming
option Options -&gt; Toggles -&gt; Show Timing
desc
    When true, %p% will display on the OIA (status line) the time
    that the host takes to unlock the keyboard after an AID is sent.
.

name socket
applies u
type b
default false
switch -socket
desc
    When true, %p% will create a Unix-domain socket than can be used
    by an external script to control the session.  The name of the socket is
    <b>/tmp/x3sck.<i>pid</i></b>.  The <b>-p</b> option of the
    <i>x3270if</i> command can be used to connect to this socket.
.

name startTls
applies a
type b
groups s
default true
description
    If true, %p% will accept the TELNET STARTTLS negotiation from the host. If
    false, it will
    reject them.
.

name *suppress
applies x
groups s
type b
desc
    When true, suppresses a menu item.  For example, setting
    <b>x3270*aboutConfig.suppress</b> to true will remove
    the <b>Configuration</b> option from the <b>About</b> menu.
    The names of the menu items are:<br>
&nbsp;&nbsp;&nbsp;aboutMenu.aboutConfig.suppress<br>
&nbsp;&nbsp;&nbsp;aboutMenu.aboutCopyright.suppress<br>
&nbsp;&nbsp;&nbsp;aboutMenu.aboutStatus.suppress<br>
&nbsp;&nbsp;&nbsp;fileMenu.abortScriptOption.suppress<br>
&nbsp;&nbsp;&nbsp;fileMenu.aboutOption.suppress<br>
&nbsp;&nbsp;&nbsp;fileMenu.disconnectOption.suppress<br>
&nbsp;&nbsp;&nbsp;fileMenu.exitOption.suppress<br>
&nbsp;&nbsp;&nbsp;fileMenu.ftOption.suppress<br>
&nbsp;&nbsp;&nbsp;fileMenu.printerOption.suppress<br>
&nbsp;&nbsp;&nbsp;fileMenu.printWindowOption.suppress<br>
&nbsp;&nbsp;&nbsp;fileMenu.promptOption.suppress<br>
&nbsp;&nbsp;&nbsp;fileMenu.saveOption.suppress<br>
&nbsp;&nbsp;&nbsp;fileMenu.screenTraceOption.suppress<br>
&nbsp;&nbsp;&nbsp;fileMenu.traceOption.suppress<br>
&nbsp;&nbsp;&nbsp;modelsMenu.model2Option.suppress<br>
&nbsp;&nbsp;&nbsp;modelsMenu.model3Option.suppress<br>
&nbsp;&nbsp;&nbsp;modelsMenu.model4Option.suppress<br>
&nbsp;&nbsp;&nbsp;modelsMenu.model5Option.suppress<br>
&nbsp;&nbsp;&nbsp;modelsMenu.oversizeOption.suppress<br>
&nbsp;&nbsp;&nbsp;optionsMenu.codepageOption.suppress<br>
&nbsp;&nbsp;&nbsp;optionsMenu.colorsOption.suppress<br>
&nbsp;&nbsp;&nbsp;optionsMenu.fontsOption.suppress<br>
&nbsp;&nbsp;&nbsp;optionsMenu.idleCommandOption.suppress<br>
&nbsp;&nbsp;&nbsp;optionsMenu.keymapDisplayOption.suppress<br>
&nbsp;&nbsp;&nbsp;optionsMenu.keymapOption.suppress<br>
&nbsp;&nbsp;&nbsp;optionsMenu.modelsOption.suppress<br>
&nbsp;&nbsp;&nbsp;optionsMenu.togglesOption.suppress<br>
&nbsp;&nbsp;&nbsp;printerMenu.assocButton.suppress<br>
&nbsp;&nbsp;&nbsp;printerMenu.luButton.suppress<br>
&nbsp;&nbsp;&nbsp;printerMenu.printerOffButton.suppress<br>
&nbsp;&nbsp;&nbsp;togglesMenu.blankFillOption.suppress<br>
&nbsp;&nbsp;&nbsp;togglesMenu.blockCursorOption.suppress<br>
&nbsp;&nbsp;&nbsp;togglesMenu.characterModeOption.suppress<br>
&nbsp;&nbsp;&nbsp;togglesMenu.crosshairOption.suppress<br>
&nbsp;&nbsp;&nbsp;togglesMenu.cursorBlinkOption.suppress<br>
&nbsp;&nbsp;&nbsp;togglesMenu.extendedDsOption.suppress<br>
&nbsp;&nbsp;&nbsp;togglesMenu.lineModeOption.suppress<br>
&nbsp;&nbsp;&nbsp;togglesMenu.lineWrapOption.suppress<br>
&nbsp;&nbsp;&nbsp;togglesMenu.m3278Option.suppress<br>
&nbsp;&nbsp;&nbsp;togglesMenu.m3279Option.suppress<br>
&nbsp;&nbsp;&nbsp;togglesMenu.marginedPasteOption.suppress<br>
&nbsp;&nbsp;&nbsp;togglesMenu.monocaseOption.suppress<br>
&nbsp;&nbsp;&nbsp;togglesMenu.overlayPasteOption.suppress<br>
&nbsp;&nbsp;&nbsp;togglesMenu.rectangleSelectOption.suppress<br>
&nbsp;&nbsp;&nbsp;togglesMenu.scrollBarOption.suppress<br>
&nbsp;&nbsp;&nbsp;togglesMenu.showTimingOption.suppress<br>
&nbsp;&nbsp;&nbsp;togglesMenu.underlineCursorOption.suppress<br>
&nbsp;&nbsp;&nbsp;togglesMenu.visibleControlOption.suppress
.

name suppressActions
applies a
groups s
type s
desc
    A list of whitespace-separated action names, with or without parentheses,
    which are to be ignored.  The actions will be completely inaccessible,
    whether by keymaps, scripts, macros or at the prompt.
    This resource is intended to be used as a security precaution for users
    who can define their own keymaps, but who do not have access to resource
    definitions or command-line options.
.

name suppressFontMenu
applies x
type b
default false
desc
    If true, the <b>Options -&gt; Font</b> menu will not be displayed.
.

name suppressHost
applies x
type b
default false
desc
    If true, %p% will omit the hostname from the
    <b>File -&gt; About %p% -&gt; Connection Status</b> pop-up.
.

name termName
applies a
groups p
type s
switch -tn
desc
    An alternate name to be sent in response to the host's TELNET DO OPTION
    TERMINAL-NAME request.  The default is <b>IBM-</b>, followed by the
    value of %-model%.
.

name title
applies x wc
groups a
type s
switch -title
desc
    Sets the title for the %p% window, overriding the default of constructing
    the name from the host that is connected to.
.

name trace
applies a
groups t
type b
default false
switch -trace
switch -set trace
switch -clear trace
option File -&gt; Trace Data and Events
description
    When true, %p% writes information about events and actions, as well as a
    hexadecimal representation of all network traffic (and its interpretation)
    into a file, which defaults to
if u
    <b>x3trc.<i>pid</i></b>.
else
    <b>x3trc.<i>process-id</i>.txt</b>.
endif
if x wc
    It also pops up a window to watch the file as it
    is created, with the pathname of the file as the window title.
endif
if x
    The command run in the window is defined by %-traceCommand%.
endif
    The directory where the file is written is defined by %-traceDir%.
    If %-traceFile% is defined, it gives the entire pathname
    and %-traceDir% is ignored.
.

name traceCommand
applies x
type s
default tail -f
desc
    Defines the command that runs in the trace window.
.

name traceDir
applies a
groups t
type s
if u
default /tmp
endif
if wc
default current user's Desktop
endif
if ws
default current directory
endif
desc
    Defines the directory that trace files are written into.
.

name traceFile
applies a
groups t
type s
switch -tracefile
desc
    If defined, gives the name of the file that data stream and event traces
    will be written into.
    If it begins with ">>", data will be appended to the file.
if x
    If given the value <b>stdout</b>, traces will
    be written to standard output.  If given the value <b>none</b>, then the
    traces will be piped directory to the monitor window, and no file will
    be created.
endif
.

name traceFileSize
applies a
groups t
type s
switch -tracefilesize
desc
    If defined, gives a limit on the size of the file that data stream and
    event traces will be written into.  If not defined, or defined as <b>0</b>,
    there
    will be no limit on the size of the file.  The value is a number, followed
    by an optional suffix.  If the suffix is <b>K</b> (e.g., 128K),
    the value will be multiplied by 1024.
    If the suffix is <b>M</b>, the value will be multiplied
    by (1024*1024).  The size limit enforced at operation boundaries, not per
    byte, so the actual file may grow slightly larger.  When the file size
    exceeds the limit, the trace file will be renamed with a "-" appended and
    a new file started.
.

name traceMonitor
applies x wc
groups t
type b
default true
desc
    When true, %p% will create a window to monitor data stream and
    event traces.
    When false, no monitor window will be
if x
    created (and the value of <b>none</b> for %-traceFile% will be
    considered invalid).
else
    created.
endif
.

name typeahead
applies C x b
type b
default true
switch -set typeahead
switch -clear typeahead
desc
    When true, %p% will store keystrokes in a buffer when the
    keyboard is locked.  When false, these keystrokes will be dropped.
.

name underscore
applies C
groups a
type b
if c
default false
else
default true
endif
switch -set underscore
switch -clear underscore
desc
    When true, %p% will display fields with the <i>underlined</i>
    attribute in a special way: blank characters will be translated to
    underscore (<b>_</b>) characters.  This is needed
if c
    on terminals that
else
    to overcome the fact that Windows consoles
endif
    are unable to display real underlined text.
.

name unlockDelay
applies x c wc
type b
default true
desc
    When %p% sends the host an AID (the <b>Enter</b>, <b>Clear</b>, <b>PF</b>
    or <b>PA</b>
    actions), it locks the keyboard until the host sends a reply to
    unlock it.  Some hosts unlock the keyboard before they are actually
    finished processing the command, which can cause scripts to malfunction
    subtly.  To avoid this, %p% implements a hack to briefly delay actually
    unlocking the keyboard.
    When %-unlockDelay% is true (the default), the keyboard unlock
    will be delayed for %-unlockDelayMs% milliseconds.  Setting it to
    false removes this delay.
.

name unlockDelay
applies s ws b
type b
default false
desc
    When %p% sends the host an AID (the <b>Enter</b>, <b>Clear</b>, <b>PF</b>
    or <b>PA</b>
    actions), it locks the keyboard until the host sends a reply to
    unlock it.  Some hosts unlock the keyboard before they are actually
    finished processing the command, which can cause scripts to malfunction
    subtly.  To avoid this, %p% can implement a hack to briefly delay actually
    unlocking the keyboard.
    When set to false (the default), there is no delay.
    When set to true, the keyboard unlock will be delayed for %-unlockDelayMs%
    milliseconds.
.

name unlockDelayMs
applies a
type i
default 350
desc
    Overrides the default value for the unlock delay (the delay between the
    host unlocking the keyboard and %p% actually performing the unlock).
    The value is in milliseconds; use 0 to turn off the delay completely,
    including for macros.
.

name useCursorColor
applies x
groups a
type b
default false
desc
    If false, the cursor will be drawn using the same color as
    the text behind it.  If true, on color X11 displays the
    cursor will be drawn with the color specified by %-cursorColor%.
.

name user
applies a
type s
switch -user
groups p
description
    Specifies the user name sent in response to a TELNET NEW-ENVIRON
    sub-negotiation request, used by iSeries hosts (RFC 4777).
.

name utf8
applies S
type b
switch -utf8
description
    Forces local I/O to use UTF-8 encoding, regardless of the local codepage.
.

name verifyHostCert
applies a
type b
groups s
switch -noverifycert
switch -verifycert
default true
description
    If true (the default), %p% will verify SSL/TLS host certificates, and not
    allow an SSL/TLS connection to complete unless the host certificate can be
    validated.
    If false, %p% will not verify SSL/TLS host certificates.
    <p class="indented">
    This resource is overridden by a <b>y:</b> prepended to the hostname when
    connecting, which disables certificate checking.
.

name visibleControl
applies x C
type b
default false
switch -set visibleControl
switch -clear visibleControl
option Options -&gt; Toggles -&gt; Visible Control Characters
desc
    If true, certain control characters, which are normally displayed as
    blanks, are displayed on the screen.
    <p class="indented">
    EBCDIC control characters,
if x c
    displayed with underlines,
endif
    are as follows:
    <table cols=3 width="75%">
    <tr> <th>Character</th>
         <th>Meaning</th>
    </tr>
    <tr> <td>.</td> <td>NUL (X'00')</td> </tr>
    <tr> <td>&lt;</td> <td>The SO character (begins a DBCS subfield)</td> </tr>
    <tr> <td>&gt;</td> <td>The SI character (ends a DBCS subfield)</td> </tr>
    <table>
    <p>
    3270 field attributes,
if x c
    displayed in yellow with underlines,
endif
if wc
    displayed in reverse-video yellow,
endif
    are decoded as follows:
    <table cols=6 width="75%">
    <tr> <th>Character</th>
         <th>Protected</th>
         <th>Numeric</th>
         <th>Display</th>
         <th>Selectable</th>
         <th>Modified</th>
    </tr>
    <tr> <td>0</td> <td>-</td> <td>-</td> <td>normal</td> <td>-</td> <td>-</td> </tr>
    <tr> <td>1</td> <td>-</td> <td>-</td> <td>normal</td> <td>-</td> <td>modified</td> </tr>
    <tr> <td>2</td> <td>-</td> <td>-</td> <td>normal</td> <td>selectable</td> <td>-</td> </tr>
    <tr> <td>3</td> <td>-</td> <td>-</td> <td>normal</td> <td>selectable</td> <td>modified</td> </tr>
    <tr> <td>4</td> <td>-</td> <td>-</td> <td>intensified</td> <td>selectable</td> <td>-</td> </tr>
    <tr> <td>5</td> <td>-</td> <td>-</td> <td>intensified</td> <td>selectable</td> <td>modified</td> </tr>
    <tr> <td>6</td> <td>-</td> <td>-</td> <td>nondisplay</td> <td>-</td> <td>-</td> </tr>
    <tr> <td>7</td> <td>-</td> <td>-</td> <td>nondisplay</td> <td>-</td> <td>modified</td> </tr>
    <tr> <td>8</td> <td>-</td> <td>numeric</td> <td>normal</td> <td>-</td> <td>-</td> </tr>
    <tr> <td>9</td> <td>-</td> <td>numeric</td> <td>normal</td> <td>-</td> <td>modified</td> </tr>
    <tr> <td>A</td> <td>-</td> <td>numeric</td> <td>normal</td> <td>selectable</td> <td>-</td> </tr>
    <tr> <td>B</td> <td>-</td> <td>numeric</td> <td>normal</td> <td>selectable</td> <td>modified</td> </tr>
    <tr> <td>C</td> <td>-</td> <td>numeric</td> <td>intensified</td> <td>selectable</td> <td>-</td> </tr>
    <tr> <td>D</td> <td>-</td> <td>numeric</td> <td>intensified</td> <td>selectable</td> <td>modified</td> </tr>
    <tr> <td>E</td> <td>-</td> <td>numeric</td> <td>nondisplay</td> <td>-</td> <td>-</td> </tr>
    <tr> <td>F</td> <td>-</td> <td>numeric</td> <td>nondisplay</td> <td>-</td> <td>modified</td> </tr>
    <tr> <td>G</td> <td>protected</td> <td>-</td> <td>normal</td> <td>-</td> <td>-</td> </tr>
    <tr> <td>H</td> <td>protected</td> <td>-</td> <td>normal</td> <td>-</td> <td>modified</td> </tr>
    <tr> <td>I</td> <td>protected</td> <td>-</td> <td>normal</td> <td>selectable</td> <td>-</td> </tr>
    <tr> <td>J</td> <td>protected</td> <td>-</td> <td>normal</td> <td>selectable</td> <td>modified</td> </tr>
    <tr> <td>K</td> <td>protected</td> <td>-</td> <td>intensified</td> <td>selectable</td> <td>-</td> </tr>
    <tr> <td>L</td> <td>protected</td> <td>-</td> <td>intensified</td> <td>selectable</td> <td>modified</td> </tr>
    <tr> <td>M</td> <td>protected</td> <td>-</td> <td>nondisplay</td> <td>-</td> <td>-</td> </tr>
    <tr> <td>N</td> <td>protected</td> <td>-</td> <td>nondisplay</td> <td>-</td> <td>modified</td> </tr>
    <tr> <td>O</td> <td>protected</td> <td>numeric</td> <td>normal</td> <td>-</td> <td>-</td> </tr>
    <tr> <td>P</td> <td>protected</td> <td>numeric</td> <td>normal</td> <td>-</td> <td>modified</td> </tr>
    <tr> <td>Q</td> <td>protected</td> <td>numeric</td> <td>normal</td> <td>selectable</td> <td>-</td> </tr>
    <tr> <td>R</td> <td>protected</td> <td>numeric</td> <td>normal</td> <td>selectable</td> <td>modified</td> </tr>
    <tr> <td>S</td> <td>protected</td> <td>numeric</td> <td>intensified</td> <td>selectable</td> <td>-</td> </tr>
    <tr> <td>T</td> <td>protected</td> <td>numeric</td> <td>intensified</td> <td>selectable</td> <td>modified</td> </tr>
    <tr> <td>U</td> <td>protected</td> <td>numeric</td> <td>nondisplay</td> <td>-</td> <td>-</td> </tr>
    <tr> <td>V</td> <td>protected</td> <td>numeric</td> <td>nondisplay</td> <td>-</td> <td>modified</td> </tr>
    </table>
.

name visualBell
applies x
groups i
type b
default false
desc
    When true, %p% will flash the screen in response to an ALARM WCC
    or BELL character, rather than ringing the terminal's bell.
.

name visualSelect
applies x
groups a
type b
default false
desc
    This resource controls how %p% displays light pen selectable fields
    that do not have a color explicitly set by the host.
    When true,
    %p% will display these fields using the color defined by
    %-visualSelectColor%.
    When false, %p% will display these fields based on
    their highlighting attribute.  This attribute is used only in 3279 mode.
.

name visualSelectColor
applies x
groups a
type i
default 6
desc
    The host color index of the color to use to display light pen
    selectable fields.  This resource is used only if %-visualSelect% is
    true.  The default is 6 (yellow).
.

name waitCursor
applies x
groups a
type s
default watch
desc
    The name of the mouse cursor displayed when %p% is connected to a host,
    but is unable to process keyboard input.  Cursor names are in the file
    <b>&lt;X11/cursorfont.h&gt;</b>.
.

name werase
applies a
groups n
type s
default ^W
desc
    This setting is used only in NVT mode, and is similar in function to
    the <i>stty</i> parameter of the same name.
    When connected in line-at-a-time mode (when %p%
    gathers a line of input before forwarding it to the host), entering
    this character at the keyboard erases the last word of input.
    <p class=indented>
    When connected in character-at-a-time mode (when %p% sends each
    keystroke to the host), this is the ASCII character that is sent to
    the host by the <b>DeleteWord</b> action.
.

EOF