Category: xUncategorized

ubmv

NAME

ubmv – renames one UNIBASE table to another name

SYNOPSIS

ubmv table1 [table2..] target

DESCRIPTION

ubmv moves UNIBASE table (“.dat” and “.key” files) to a target name, table1 and target cannot be the same.

If target is not a directory, then only one table may be specified before it. If the target has its “.dat” and “.key” link to another file with links, the other links remain and “.dat” and “.key” of target become a new file.

If target is a directory, then the specified table(s) are moved to the target directory.

<P> <h2>EXAMPLE</h2> To move the “.dat” and “.key” files of the table “oldstock” to new table “newstock” <PRE>ubmv oldstock newstock</PRE> <h2>SEE ALSO</h2> mv(1) Unix Reference Manual

FLAGS

FLAG ARGUMENT TYPE DESCRIPTION

ERRORS

EXAMPLE

SEE ALSO

May 5, 2009
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

May 5, 2009
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

May 5, 2009
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

May 5, 2009
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

May 5, 2009
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

May 5, 2009
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

May 5, 2009
ubcleanup

NAME

ubcleanup – garbage collector for /tmp/UBTMP file

SYNOPSIS

ubcleanup

DESCRIPTION

FLAGS

FLAG ARGUMENT TYPE DESCRIPTION

ERRORS

EXAMPLE

SEE ALSO

May 5, 2009
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><directory></TD> <TD>directory to be tested</TD> </TR> <TR> <TD><application></TD> <TD>Optional data dictionary (default dict.dat) to use for test</TD> </TR> <TR> <TD><table></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

May 5, 2009
ubcgirc

NAME

ubcgirc – WWW cgi script initialisation

SYNOPSIS

DESCRIPTION

FLAGS

FLAG ARGUMENT TYPE DESCRIPTION

ERRORS

EXAMPLE

SEE ALSO

May 5, 2009