82
82
Causes <i>x3270if</i> to use a Unix-domain socket to connect to the emulator,
83
83
rather than pipe file descriptors given in environment variables.
84
84
The emulator must have been started with the <b>-socket</b> option.
85
<dt><b>-t</b> <i>port</i></dt><dd>
86
Causes <i>x3270if</i> to use a TCP socket to connect to the emulator,
87
rather than pipe file descriptors given in environment variables.
88
The emulator must have been started with the <b>-scriptport</b>
85
90
<dt><b>-v</b></dt><dd>
86
91
Turns on verbose debug messages, showing on stderr the literal data that is
87
92
passed between the emulator and <b>x3270if</b>.
97
102
variable, or an unexpectedly closed pipe,
98
103
<b>x3270if</b> exits with status 2.
99
104
<a NAME="Environment"></a><h2>Environment</h2>
100
Unless the <b>-socket</b> option is given when they are started,
101
<i>x3270</i>, <i>c3270</i>, and <i>s3270</i>
102
use a pair of pipes for communication with each child script process.
105
When a script is run as a child process of one of the emulators via the
106
<b>Script</b> action, the emulator passes information about how to control it
107
in environment variables.
109
On Unix, the emulator process creates a pair of pipes for communication with
110
the child script process.
103
111
The values of the file descriptors for these pipes are encoded as text
104
in two environment variables, which are required by
112
in two environment variables:
106
113
<dl><dt><b>X3270OUTPUT</b></dt><dd>
107
114
Output from the emulator, input to the child process.
108
115
<dt><b>X3270INPUT</b></dt><dd>
109
116
Input to the emulator, output from the child process.
118
On Windows, or when a Unix emulator is started with the
119
<b>-scriptport</b> option, the emulator will pass the port number
120
encoded as text in the <b>X3270PORT</b> environment variable.
121
<i>x3270if</i> will use that value as if it had been passed to it via the
123
<b>X3270PORT</b> takes precedence over <b>X3270OUTPUT</b> and
111
126
<a NAME="See-Also"></a><h2>See Also</h2>
112
127
<a HREF="x3270-man.html">x3270(1)</a>,
114
129
<a HREF="s3270-man.html">s3270(1)</a>,
115
130
<a HREF="x3270-script.html">x3270-script(1)</a>
116
131
<a NAME="Copyright"></a><h2>Copyright</h2>
117
Copyright © 1999, 2000, 2001, 2004, 2005 by Paul Mattes.
118
<blockquote>Permission to use, copy, modify, and distribute this software and its
119
documentation for any purpose and without fee is hereby granted,
120
provided that the above copyright notice appear in all copies and that
121
both that copyright notice and this permission notice appear in
122
supporting documentation.</blockquote>
132
Copyright © 1999-2009, Paul Mattes.
136
Redistribution and use in source and binary forms, with or without
137
modification, are permitted provided that the following conditions are met:
140
Redistributions of source code must retain the above copyright
141
notice, this list of conditions and the following disclaimer.
143
Redistributions in binary form must reproduce the above copyright
144
notice, this list of conditions and the following disclaimer in the
145
documentation and/or other materials provided with the distribution.
147
Neither the names of Paul Mattes nor the names of his contributors
148
may be used to endorse or promote products derived from this software
149
without specific prior written permission.
153
THIS SOFTWARE IS PROVIDED BY PAUL MATTES `AS IS' AND ANY EXPRESS OR IMPLIED
154
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
155
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
156
EVENT SHALL PAUL MATTES BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
157
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
158
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
159
OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
160
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
161
OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
162
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
125
165
This HTML document and the accompanying troff document were generated with
126
166
a set of write-only <b>m4</b> macros and the powerful <b>vi</b> editor.
127
<br>Last modified 14 April 2008.
167
<br>Last modified 02 October 2009.
added
removed
s3270/html/x3270if.html
