PURPOSE

mio, wmio - mask input/output program

SYNOPSIS

mio
[ -B ]
[ -n ]
[ -e ]
[ -F ]
[ -t ]
[ -i fname]
[ -m fname]
[ -r rname]
[ -p rname]
[ -s service]
[ -b usrname]
[ -u file] 
wmio [options]

DESCRIPTION

NOTE: For TUXEDO Sample Application Only.

mio is the Data Entry System mask input/output handler. It reads mask object files created by the compiler and displays user-defined forms on the standard output. Once the forms are filled out, their contents are shipped to a server in the form of fielded buffers. If the form has been created with the parameter TRANMODE set to TRAN, mio is invoked in transaction mode. See the BEA TUXEDO Programmer's Guide for a detailed explanation.

wmio is a version of mio build using the workstation libraries. On sites supporting just /WS, only the wmio command will be present.

The following command line options are available:

-B: Synchronous (blocking) calls are made. mio will block on send calls and wait if there is a blocking condition.
-e: Allow shell escapes. Escape to the shell is via an esc !.
-F: Print packets sent to and received from the server on the standard error. When this option is used the standard error should be directed away from the terminal on which mio is run.
-n: Don't allow mio to be terminated from a terminal. Presumably, it will be terminated by a signal.
-b: Use usrname for this process in the bulletin board. usrname can include printf(3) notation to append the process id. For example, teller%d will append the process id to the string teller to make the usrname unique. nnnnn is mio's process id.
-s: Override destination services specified on all masks and always send mio output to service.
-t: Run mio in test mode. Useful for testing recently compiled masks.
-r: Record mio session into disk file rname. The session can be played back with the -p option.
-p: Playback mio session, using rname as the input file instead of user terminal input. In the standard case rname was created by a previous run of mio with the -r option.
-i: fname is displayed instead of the initial mask. Exiting fname terminates mio.
-m: fname is an alternate initial mask.
-u: This option is used to redefine the character sequences that constitute mio's function keys. file contains a list of character sequences and keywords as described in udfk(5).

By default the following function keys are defined by mio. These can be changed with the -u option.

CTRL-a
-- display help message for the current field
CTRL-n
-- display error message for the current field
CTRL-b
-- go back a page
CTRL-f
-- go forward a page
TAB (CTRL-i)
-- go forward a field
CTRL-o
-- go back a field
CTRL-j or down arrow
-- go down a line
CTRL-k or up arrow
-- go up a line
BACKSPACE (CTRL-h) or left arrow
-- go back one space
CTRL-l or right arrow
-- go forward one space
CTRL-u
-- delete a character
CTRL-c
-- insert a character
CTRL-d
-- quit this form and return to previous level
CTRL-t
-- go to home field
ESC 0
-- transmit form to server
ESC 1
-- transmit form to server
ESC 2
-- transmit form to server
ESC 3
-- transmit form to server
ESC 4
-- transmit form to server
ESC 5
-- transmit form to server
ESC 6
-- transmit form to server
ESC 7
-- transmit form to server
ESC 8
-- transmit form to server
ESC 9
-- transmit form to server
CTRL-v
-- transmit form to server
CTRL-w
-- display defaults cyclically
CR (CTRL-m)
-- move to the left and down a line
CTRL-x
-- clear the form
CTRL-y
-- print the form
CTRL-p
-- refresh the form
ESC !
-- escape to a shell

NOTICES

The terminfo(4) database must exist for mio to run, and the TERMINFO shell variable must point to the correct directory.

PORTABILITY

mio and/or wmio are supported as TUXEDO System/T-supplied clients on UNIX operating systems only.

ENVIRONMENT VARIABLES

TERMINFO, TERM, TUXDIR, LOGNAME, UBBCONFIG, NGXACTS, OKXACTS, FLDTBLDIR, FIELDTBLS, SRVID, SRVGRP, MSKIPCKEY, MASKPATH.