callback resource

From The x3270 Wiki
Revision as of 17:13, 3 July 2022 by Pmattes (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

New in 4.0

Type Default Option
string -callback

Replaces stdin/stdout scripting with a socket.

The format of this resource uses an extended version listener syntax.

In s3270, this resource is similar to the scriptPort resource, except that the direction of the TCP connection is reversed. That is, instead of listening for connections on the specified port, s3270 makes a connection to that port. As with the scriptPort and httpd resources, specifying callback means s3270 no longer accepts s3270 protocol commands from its standard input.

In b3270, this resource has the same effect, but the TCP connection uses the b3270 protocol instead.

The purpose of this option is to simplify port selection in peer scripts that start a copy of s3270 or b3270. The script listens on a socket, letting the system pick an unused port number. Then it starts the emulator, passing that port number with the -callback command-line option. Finally, it accepts the connection from the emulator and closes its listening socket.

If the resource begins with the string 2x, then the emulator will make two connections. This allows one connection to be used to execute actions, and the other to be used to monitor the status of the emulator (the TCP connection breaks when the emulator exits). New in 4.2

Examples

Call back to port 12345.

127.0.0.1:12345

Call back to port 55543, twice. Use IPv6. New in 4.2

2x[::1]:55543