wc3270/Command-line options

From The x3270 Wiki

The syntax for wc3270 is:

wc3270 [option]... [hostname [port]]

or to specify a session file:

wc3270 [option]... session-filename.wc3270

Here is a summary of wc3270 command-line options. The table columns are:

The name and syntax of the option.
A summary of what the option does.
Resource and Further Details
The wc3270 resource that the option sets. Most command-line options set an wc3270 resource value. The hyperlinks to the wc3270 resources give more detailed information about what each option does.
The default value of the wc3270 resource.
Additional information about the option.


Option Meaning Resource
and Further Details
Default Notes
Turn off auto-shortcut mode autoShortcut = false false
--help Display basic command-line help and then exit
Prefer IPv4 addresses preferIpv4 = true false New in 4.2
Prefer IPv6 addresses preferIpv6 = true false New in 4.2
-accepthostname name
Name to match in the host's TLS certificate acceptHostname
-clear resource Set a Boolean resource to false
-clientcert name
Name of client certificate for TLS clientCert
-codepage codepage
Host EBCDIC code page codePage bracket
-connecttimeout seconds
Timeout before giving up on a host connection connectTimeout
-devname device-name
Device name (workstation ID) response to TELNET NEW-ENVIRON request devName
-httpd [address:]port
Start HTTP server httpd
-keymap keymap-name[,...]
Override the default keymap keymap
-loginmacro actions
Actions to run when host connection is established loginMacro
-minversion version
Minimum version number required (major.minortypeiteration) minVersion
-model model
Model of 3270 to emulate model 3279-4-E
Do not verify the TLS host certificate verifyHostCert = false true
Force NVT mode -- do not negotiate 3270 mode nvtMode = true false
-oversize columnsxrows
Make the display larger than the default for the 3270 model oversize
-port number
TCP port to connect to port 23
-proxy type:[user[:pass]@]server[:port]
Type of proxy and proxy server to use proxy
Reconnect to host after session disconnects reconnect = true false
Turn on auto-shortcut mode autoShortcut = true false
-scriptport [address:]port
Accept TCP connections for s3270 protocol sessions scriptPort
Accept only one -scriptport session scriptPortOnce = true false
Limit actions that can modify the local workstation secure = true false
-set resource
-set resource=value
Set a Boolean resource to true
Set a resource to some value
-sl lines
Save lines lines of screen data in the scrollbar buffer saveLines 4096
Accept s3270 protocol sessions on the Unix-domain socket /tmp/x3sck.pid socket = true false
-title text
Set the window title to text title varies
-tn terminal-name
Use terminal-name as the terminal name reported to the host termName varies
Turn on data stream and action tracing trace = true false
-tracefile file-name
Use file-name as the file for data stream and action tracing traceFile Desktop\x3trc.pid.txt Use -trace to turn on tracing
-tracefilesize bytes
Limit trace files to bytes bytes in size traceFileSize
-user user-name
Use user-name in the reply to the TELNET NEW-ENVIRON sub-negotiation user varies
Use UTF-8 encoding for all I/O on the workstation (files, script output, etc.) utf8 = true false
-v Display version information on standard output and then exit
-xrm 'wc3270.resource: value' Set the value of a resource

Deprecated options

Option Meaning Resource
and Further Details
Default Notes
-charset codepage
Host EBCDIC code page charset bracket Use -codepage instead
Verify the TLS host certificate verifyHostCert = true true Redundant; this is the default