ubprompt: The Forms front end for Shell Scripts

NAME

ubprompt – forms front end for shell scripts

SYNOPSIS

ubprompt -[E H* I* L W* Q T a d i g* k# n s w*] <prompt>

DESCRIPTION

The user fills in a screen form. When the user completes the form, they can then select one or more function keys and execute the attached shell script or quit without execution.

You can program function keys to execute the attached script and exit or return for further input.

The user interface consists of full screen form display, easy to use function keys, and pop-up context sensitive help messages.

A data dictionary in the form describes the form fields. ubprompt can function stand alone for any purpose, or through the foreign key field it can interface directly to UNIBASE tables. Files whose name ends in ‘.prm’ store the forms as text.

ubprompt can function without any input fields, in which case it displays a message and executes a shell script. It can also function without a shell script so that it simply displays a message and gets an ‘OK’ or ‘NOT OK’ response from a user.

An exit value of 0 indicates OK, 60 (UEQUIT) indicates quit and the shell script was not executed, anything else indicates failure or not OK.

FLAGS

FLAG	ARGUMENT	TYPE	DESCRIPTION
-E			Disable EXIT key (F10)
-H	HTML Title	string	Text for the TITLE tag in the header section of an HTML document. i.e. the title shown on the title bar.
-I	On web pages, put result of function key call in “id” of target division in HTML document.	string	id identifies the block element to be updated with the output of the http request.
-L			Turn off STATUS line (date, time, user, etc) on top line of screen.
-Q			Disable QUIT signal.Normally ubprompt can be stopped by typing the key that generates a UN*X QUIT signal. This flag disables this function.
-T			Trace all calculations.
-W	window	string	On web pages, put results of function key in target window.
-a			Create an audit trail entry for every script executed.When auditing, an environment variable UB_ADT contains the name of a temporary file. The script executed can write to this file and its content will be included in the audit trail as a message (see ubaudit(1) for details).
-d			This gives a debug output.As ubprompt reads the screen format each line is echoed to the screen. In this way the exact point at which an error occurs can be observed and corrected.
-i			ubprompt is not interactive.In this mode ubprompt will not attempt to draw a screen. Instead it will read its standard input for lines in the form <attribute>,<value> This flag is used by HTML forms to call ubprompt in a non-interactive manner.
-n			Print table network used by this screen.This is a map showing the paths used by ubprompt to find information in each table.
-s			Display screen only.Do not wait for input. If there is an execute section, it will be executed immediately.

EXAMPLE

To debug a screen form called “date.prm”