X3270IF(1)X3270IF(1)NAMEx3270if - command interface to x3270
SYNOPSISx3270if [ -v ] action [ ( param [ ,... ] ) ]
x3270if [ -v ] -s field
DESCRIPTIONx3270if provides an interface between x3270(1) and child
processes run with the Script() action.
x3270if performs one of two functions: passing an action
and optional parameters to x3270 for execution, or report-
ing the value of one of x3270's status fields.
The result of the command execution, or the value of the
requested status field, is written to standard output.
OPTIONS-v Turns on verbose debug messages, showing the lit-
eral data that is passed between x3270 and x3270if.
-s field
Causes 3270if to return the value of an x3270 sta-
tus field, rather than passing an action to be exe-
cuted. Field is an integer in the range 0 through
11, indicating the desired status field. The
indices and meanings of each field are documented
on the x3270-script(1) manual page.
EXIT STATUS
If the requested action succeeds, x3270if exits with sta-
tus 0. If the action fails, x3270if exits with status 1.
If there is an operational error within x3270if itself,
such as a command-line syntax error, missing environment
variable, or closed pipe, x3270if exits with status 2.
ENVIRONMENT
x3270 uses a pair of pipes for communication with each
child process. The values of the file descriptors for
these pipes are encoded as text in two environment vari-
ables, which are required by x3270if:
X3270OUTPUT
Output from x3270, input to the child process.
X3270INPUT
Input to x3270, output from the child process.
SEE ALSOx3270(1), x3270-script(1)COPYRIGHT
Copyright 1995 by Paul Mattes.
1 October 1995 1
X3270IF(1)X3270IF(1)
Permission to use, copy, modify, and distribute
this software and its documentation for any purpose
and without fee is hereby granted, provided that
the above copyright notice appear in all copies and
that both that copyright notice and this permission
notice appear in supporting documentation.
1 October 1995 2