ubmlp

NAME

ubmlp – select a printer

SYNOPSIS

ubmlp <command>

DESCRIPTION

ubmlp prompts the user to select a printer from a list of available printers and then executes command piping its output to the selected print spool service.

The list of available printers is held in the file $UBDIR/printers/list (normally /usr/lib/ub/printers/list). The format of this file is a ubitem list where the return value is the printer spool command the display is a description of the printer.

<printer list> ::=<printer def> <printer def> ::=<spool command>:<description>

eg. lp -s : DEFAULT PRINTER lp : NOISY PRINTER

Once the printer has been selected command is executed with its output redirected.

If $P_SELECT is included in command, command is executed but not redirected. Instead the variable P_SELECT is set to the printer command.

To pass $P_SELECT through to ubmlp, it may need to be escaped.

<P> <h2>EXAMPLE</h2> <PRE> ubmlp ubreport stocklist ubmlp ubreport -p\”\$P_SELECT\”stocklist </PRE> (NB. ” and $ are escaped with\.)

FLAGS

FLAG ARGUMENT TYPE DESCRIPTION

ERRORS

EXAMPLE

SEE ALSO

ubln

NAME

ubln – links one UNIBASE table to another

SYNOPSIS

ubln table 1 [table2…]target

DESCRIPTION

ubln link a UNIBASE table (“.dat” and “.key”files) to a target name, table1 and target can not be the same.

If target is not a directory, then only one table may be specified before it. ubln links “.dat” and “.key” of table1 to “.dat” and “.key” of target. If “.dat” and “.key” of target exists and its mode forbids writing, the mode is printed and the user is asked for a response. If the response begins with a ‘y'(and the user is permitted) then the link occurs.

If the target is a directory then the specified “.dat” and “.key” of table1 are linked to that directory. That is,”.dat” and “.key” files with the same names are created in the directory linked to the specified “.dat” and “.key” files.

<P> <h2>EXAMPLE</h2> To link the “.dat” and “.key” files of the table “stock” to the table “stk”: <P><PRE>ubln stock stk</PRE> <P> <h2>SEE ALSO</h2> ln(1) Unix Reference Manual

FLAGS

FLAG ARGUMENT TYPE DESCRIPTION

ERRORS

EXAMPLE

SEE ALSO

ubitem

NAME

ubitem – execute a command on selected items

SYNOPSIS

ubitem -[C* E F* H* L Q S d f* g* i k# w*] <item>

DESCRIPTION

ubitem displays a list of text items on a formatted screen. The first item is highlighted and the highlighting can be moved up and down the list by using the arrow keys. The highlighted item can be selected (indicated by a `*’) or deselected by pressing the AB key. Pressing one of the programed FUNCTION KEYS will execute a predetermined script for each item.

F1 (SEARCH) can be used to find an entry by entering a string. EXIT can be used to exit without doing anything.

Pressing RETURN will execute the first defined function key with the currently selected list.

If no items are selected when a function key or RETURN is pressed, the currently highlighted record will be automatically selected.

The list of items to choose from can be a file, output from a unix command, read from standard input, or text values stored in the command file.

Depending on the configuration single or multiple selections may be made.

A selection list consists of lines of text. Each line has one or two parts. A return value and a display value. If there is only one part then it is used for both display and return. The two parts of each line are separated by a ‘:’. This may be changed – see command line options below.

When a script is executed, the return values of the selected items are passed as arguments to the script.

After reading the selection list, ubitem displays some (or all depending on screen size) of the list with the first item highlighted. The user can use the arrow keys to move the highlighting up or down the list. The list will scroll as appropriate.

The format for file, the control file, can be found in item(4).

FLAGS

COMMAND LINE FLAGS
FLAG ARGUMENT TYPE DESCRIPTION
-C control file text file name security control file for menus. See menu(4) for details.
-E disable EXIT key
-F file text file name Name of file containing list of items
-S read the selection list from standard input
-d debug output. Echo each line as it is read
-f separator character Use separator to separate the return value from the display value. The default value is `:’.

ERRORS

EXAMPLE

To run the item list program select.itm

ubitem select

To select a user from the passwd file (using user.itm)

awk '{print $1":"$5}' /etc/passwd|ubitem -S user

SEE ALSO

item(4)

ubformat

NAME

ubformat – a simple text formatter

SYNOPSIS

ubformat -[c# l* o# p* w# #] <files>

DESCRIPTION

This utility is similar to nroff but much simpler. Its advantages are that it is small and fast and by using command line options it can format small amounts of text without using dot commands. This is particularly useful for the vi “!” command. e.g. To centre 2 lines and justify the rest of a marked text section in 6O character wide lines use the following keystrokes in vi:

!.+2 ubformat -c2-w6O

The actions of ubformat can be controlled by a simple set of ‘.’ (dot) commands. Unless otherwise directed, ubformat will justify paragraphs to lines 6O characters long. Dot commands are lines in the text that start with a ‘.’.

<P> <TABLE WIDTH=”100%” BGCOLOR=”#000000″> <CAPTION>DOT COMMANDS</CAPTION> <TR><TD> <TABLE WIDTH=”100%” BGCOLOR=”#FFFFFF”> <TR> <TH>COMMAND</TH> <TH>DESCRIPTION</TH> </TR> <TR> <TD>bl n</TD> <TD>print n blank lines (*line spacing)</TD> </TR> <TR> <TD>br</TD> <TD>break to a new line</TD> </TR> <TR> <TD>ce n</TD> <TD>centre next n lines</TD> </TR> <TR> <TD>fi</TD> <TD>start filling output</TD> </TR> <TR> <TD>fo n</TD> <TD>next n lines are footer</TD> </TR> <TR> <TD>in n</TD> <TD>indent n characters</TD> </TR> <TR> <TD>he n</TD> <TD>next n lines are header</TD> </TR> <TR> <TD>lb n t</TD> <TD>label at column n with text t</TD> </TR> <TR> <TD>ll n</TD> <TD>line lenth n characters</TD> </TR> <TR> <TD>ma xx</TD> <TD>define macro xx</TD> </TR> <TR> <TD>me</TD> <TD>end macro definition</TD> </TR> <TR> <TD>nf</TD> <TD>stop filling output</TD> </TR> <TR> <TD>np</TD> <TD>new page</TD> </TR> <TR> <TD>pa</TD> <TD>new paragraph</TD> </TR> <TR> <TD>pc t</TD> <TD>printer characteristic</TD> </TR> <TR> <TD>pn n</TD> <TD>set page number to n</TD> </TR> <TR> <TD>re f</TD> <TD>read input from file f</TD> </TR> <TR> <TD>sp n</TD> <TD>set line spacing to n</TD> </TR> </TABLE> </TD></TR> </TABLE> <P> <TABLE WIDTH=”100%” BGCOLOR=”#000000″> <CAPTION>COMMAND LINE OPTIONS</CAPTION> <TR><TD> <TABLE WIDTH=”100%” BGCOLOR=”#FFFFFF”> <TR> <TH>OPTION</TH> <TH>DESCRIPTION</TH> </TR> <TR> <TD>-c number</TD> <TD>Centre the next number of text lines.</TD> </TR> <TR> <TD>-I characters</TD> <TD>characters is characters to be ignored/placed at the beginning of each line.</TD> </TR> <TR> <TD>-o number</TD> <TD>Offset number characters from left margin.</TD> </TR> <TR> <TD>-w width</TD> <TD>Set the width of a line to width character position (default is 6O).</TD> </TR> <TR> <TD>-number</TD> <TD>Set the length of a page to number lines (default is 66).</TD> </TR> </TABLE> </TD></TR> </TABLE> <P> <h2>EXAMPLE</h2> To centre lines which start with a ‘#’ character <PRE>ubformat -c2 -I# filename</PRE>

FLAGS

FLAG ARGUMENT TYPE DESCRIPTION

ERRORS

EXAMPLE

SEE ALSO

ubform

NAME

ubform – forms overlay

SYNOPSIS

ubform -[d f* o#] <form>

DESCRIPTION

ubform is used to overlay a form onto a report (such as an order form or table). The overlay form is given by the -f flag. The report can be in a file or if none is given then standard input is read.

ubform understands attribute specifications where a line ending in “@@” is followed by an attribute line. These two lines are counted as one and the attribute line is passed through unchanged. ubform also passes through “.” commands (i.e. lines starting with “.”) unchanged.

Another filter such as ubprint (1) is required to produce actual printer output.

<P> <TABLE WIDTH=”100%” BGCOLOR=”#000000″> <CAPTION>COMMAND LINE OPTIONS</CAPTION> <TR><TD> <TABLE WIDTH=”100%” BGCOLOR=”#FFFFFF”> <TR> <TH>OPTION</TH> <TH>DESCRIPTION</TH> </TR> <TR> <TD>-d</TD> <TD>debug output</TD> </TR> <TR> <TD>-f file</TD> <TD>name of file to overlay on form. If not given standard input is used.</TD> </TR> <TR> <TD>-o offset</TD> <TD>output offset offset spaces from left margin</TD> </TR> <TR> <TD>form</TD> <TD>Name of the form to overlay with the file.</TD> </TR> </TABLE> </TD></TR> </TABLE> <P> N.B. There is no default extension for forms. <P> <h2>EXAMPLE</h2> ubreport purch/ubform -o 1O purchorder/ubprint -p hplaser Ip <P> <h2>SEE ALSO</h2> form(4) ubprint(1) printers(4)

FLAGS

FLAG ARGUMENT TYPE DESCRIPTION

ERRORS

EXAMPLE

SEE ALSO

ubfax

NAME

ubfax – send a fax

SYNOPSIS

ubfax

DESCRIPTION

ubfax sends a fax using efax.

ubfax is installed as an alias program that can be called by sendmail. Therefore it expects it’s input to be an email source (headers and attachments)

to use ubfax simply email the file to be faxed as an attachment to ubfax@yourdomain

Valid attachments are text, postscript, and pdf files

The fax number and comments are part of the subject of the email. The subject format is:

<fax number>*<subject>

When the fax has been sent, the subject part of the message subject is returned to the sender with a failed or success indicator

FLAGS

FLAG ARGUMENT TYPE DESCRIPTION

ERRORS

EXAMPLE

ubmail –nostdin –attach message.pdf –subject “555 8976 * MY MESSAGE” ubfax@somedomain.com

SEE ALSO

uberror_log

NAME

uberror_log

SYNOPSIS

uberror_log <Apache error log> <email address for report>

DESCRIPTION

uberror_log extracts today’s errors from an Apache error log file and forwards them to the email address.

FLAGS

FLAG ARGUMENT TYPE DESCRIPTION

ERRORS

EXAMPLE

SEE ALSO

ubcleanup

NAME

ubcleanup – garbage collector for /tmp/UBTMP file

SYNOPSIS

ubcleanup

DESCRIPTION

FLAGS

FLAG ARGUMENT TYPE DESCRIPTION

ERRORS

EXAMPLE

SEE ALSO

ubcheck

NAME

ubcheck – exhaustively check UNIBASE tables for structure errors

SYNOPSIS

ubcheck <directory> {<application>} {<table>}

DESCRIPTION

ubcheck will exhaustively check every UNIBASE table in a directory for errors.

Any errors are logged in a file called filecheck in the data directory. An existing filecheck is removed before the testing begins.

As ubcheck is exhaustive it can take a long time and is best run as an overnight process.

NB. The UNIBASE isam routines are very robust and tables are not normally corrupted except by machine failures which are usually detected by a redundancy check everytime a table is opened. This utility simply provides an extra level of assurance.

<P> <TABLE WIDTH=”100%” BGCOLOR=”#000000″> <CAPTION>COMMAND LINE OPTIONS</CAPTION> <TR><TD> <TABLE WIDTH=”100%” BGCOLOR=”#FFFFFF”> <TR> <TH>OPTION</TH> <TH>DESCRIPTION</TH> </TR> <TR> <TD>&lt;directory&gt;</TD> <TD>directory to be tested</TD> </TR> <TR> <TD>&lt;application&gt;</TD> <TD>Optional data dictionary (default dict.dat) to use for test</TD> </TR> <TR> <TD>&lt;table&gt;</TD> <TD>Optional table if only one table, rather than all tables, is to be tested.</TD> </TR> </TABLE> </TD></TR> </TABLE> <P> <h2>EXAMPLE</h2> <PRE>ubcheck /data/stock /usr/app/stock_sys/dct/dict.dat stock</PRE>

FLAGS

FLAG ARGUMENT TYPE DESCRIPTION

ERRORS

EXAMPLE

SEE ALSO

ubcgirc

NAME

ubcgirc – WWW cgi script initialisation

SYNOPSIS

DESCRIPTION

FLAGS

FLAG ARGUMENT TYPE DESCRIPTION

ERRORS

EXAMPLE

SEE ALSO