Uquf

I N T E L L I G E N T S Y S T E M S M A N A G E M E N T
Columbus Output Management

How to use the uq menu interface
UQUF-4300-00 Columbus OM 4.3

Publication number Trademark acknowledgements
UQUF-4300-00 (June 2004) The following are trademarks of Macro 4: Columbus OM,
UniQLaser, UniQPager, UniQTelex.
Documentation set Other product and company names mentioned herein may
be the trademarks or registered trademarks of their
The documentation relating to this product includes: respective owners.
Introduction
How to install Columbus OM License information

How to configure Columbus OM Copyright 2004 Macro 4. All rights reserved.
How to use Columbus OM This publication, as well as the software described in it, is
How to use the command line interface furnished under license and may be used or copied only in
accordance with the terms of such license. The information
How to use the uq menu interface

in this publication is furnished for informational use only, is
How to use the WebClient subject to change without notice, and should not be
How to integrate with SAP R/3 construed as a commitment by Macro 4. Macro 4 assumes
no responsibility or liability for any errors or inaccuracies
Technical Reference which may appear in this publication.
Except as permitted by such license, no part of this
Making comments publication may be reproduced, stored in a retrieval
system, or transmitted, in any form or by any means,
We welcome suggestions from all users regarding our
electronic, mechanical, recording or otherwise, without
software products and their accompanying documentation.
prior written permission from Macro 4.
Please contact your local Macro 4 representative, email us
at tech.authors@macro4.com, or write to:
Technical Documentation
Macro 4
The Orangery, Turners Hill Road,
Crawley, West Sussex RH10 4SS
United Kingdom
www.macro4.com
3
Contents
How to use the uq menu interface UQUF-4300-00
About this manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Chapter 1 Using the uq menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Working with menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Using vertical menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Using horizontal menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Working with the browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Controlling the display. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Moving around the document . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Locating text strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Marking blocks to be printed . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Printing parts of the document . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Chapter 2 Terminal definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Selecting a terminal definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Standard supported terminals . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Copying an existing terminal definition . . . . . . . . . . . . . . . . . . . . . 21
Creating a definition for uq . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Defining the terminal characteristics . . . . . . . . . . . . . . . . . . . . . . . 22
Compiling the definition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Specifying function key handling . . . . . . . . . . . . . . . . . . . . . . . . . 27
Creating a definition for the browser . . . . . . . . . . . . . . . . . . . . . . . . . 29
Configuring the Columbus OM/browser relationship . . . . . . . . . . . . . . . 34
Chapter 3 Standard Columbus OM menu structure . . . . . . . . . . . . 35

Customizing the menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Dispatch instance menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
uq401: Main Menu (dispatch implementors, administrators, operators) . . 37
uq402: Main Menu (dispatch users) . . . . . . . . . . . . . . . . . . . . . . . 38
uq010: Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
uq411: Dispatch Server Management . . . . . . . . . . . . . . . . . . . . . . 40
COLUMBUS OUTPUT MANAGEMENT HOW TO USE THE UQ MENU INTERFACE

4 Contents
uq413: Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
wliq: List Queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
wliq3: Search Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Fax instance menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
uq201: Main Menu (fax implementors, administrators, operators). . . . . . 43
uq202: Fax Submission (fax users) . . . . . . . . . . . . . . . . . . . . . . . . 44
uq010: Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
uq211: Fax Server Management . . . . . . . . . . . . . . . . . . . . . . . . . 46
uq212: Monitor Fax Servers. . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
wliq: List Queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Print instance menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
uq001: Main Menu (print implementors, administrators, operators) . . . . 50
uq002: Document Printing (print users) . . . . . . . . . . . . . . . . . . . . . 51
uq008: Configure System Tables . . . . . . . . . . . . . . . . . . . . . . . . . 51
uq010: Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
uq011: Scheduler Management . . . . . . . . . . . . . . . . . . . . . . . . . . 55
uq012: Monitor Printers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
uq014: Queue Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
uq027: View Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
wliq: List Queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
wopq: Printer Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
wopq1: Class Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
wopq2: Paper Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Chapter 4 Built-in functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

A functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
B functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
C functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
D functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
E functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
F G and H functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
I J and K functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
L functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
M functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
N functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
O P and Q functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
R functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
S functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
T U and V functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
W functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Contents
5
Chapter 5 System files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

menu.fkey: Function key assignments . . . . . . . . . . . . . . . . . . . . . . . . . 84
menu.menu: Vertical menu definitions . . . . . . . . . . . . . . . . . . . . . . . . 85
menu.ring: Horizontal menu definitions . . . . . . . . . . . . . . . . . . . . . . . 87
terminal_type: Source terminal definitions . . . . . . . . . . . . . . . . . . . . . . 88
terminal_type.def: Browser terminal definitions . . . . . . . . . . . . . . . . . . . 89
terminal_type.ttp: Compiled terminal definitions. . . . . . . . . . . . . . . . . . . 90
fkey.tab: Function key classification. . . . . . . . . . . . . . . . . . . . . . . . . . 91
report.def: Browser print specification . . . . . . . . . . . . . . . . . . . . . . . . 92
uqadm.menu, uqimp.menu, uqops.menu, uquser.menu . . . . . . . . . . . . . . 93
wliqsum.tab: Queue display format . . . . . . . . . . . . . . . . . . . . . . . . . . 94
wopqsum.tab: Printer status display format . . . . . . . . . . . . . . . . . . . . . 95
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

6 Contents

7
About this manual
The uq menu interface is available for Columbus OM running on UNIX platforms.

The interface, invoked by the uq command, enables you to administer and operate
Columbus OM by using hierarchical menus presented on an 80 by 24 character-
mode terminal. It is described in these sections:

Using the uq menus on page 9, describing the appearance and operation of
the menu interface and of the associated text file browser, is of relevance to
anybody using the menu interface.
Terminal definitions on page 19 explains how the interface uses standardized
setup files in order to operate across a range of terminal types. You should
study this material during the Columbus OM installation procedure.
Standard Columbus OM menu structure on page 35 specifies the menu
hierarchies distributed with Columbus OM. The information here and in the
following sections is of importance only if you intend to customize the menus.

Built-in functions on page 63 lists the available set of functions which the
menu system invokes in order to control and monitor Columbus OM activities.
System files on page 83 defines various files used by the menu interface and
the text file browser.

8 About this manual
Conventions
Conventions
The following typographic conventions are used:
boldface Indicates a command or keyword that you should type, exactly
as shown.
italics Indicates a variable for which you should substitute an
appropriate value.
monotype Indicates literal input and output.
Ctrl+D Indicates two or more keys pressed simultaneously.
[ ] Brackets surround an optional value.
| Vertical bars separate alternative values from which you must
make a selection.
... Ellipsis indicates that the preceding element may be repeated.
The names of some files and directories depends on your installation. For example,
the directory $UNIQDIR/media/paper contains files defining the types of paper
used at that installation. In the text, such files are referenced as
$UNIQDIR/media/paper/paper_type.

9
CHAPTER 1
Chapter 1 Using the uq menus
The uq menu interface is a UNIX-based alternative to the command line method of

using and controlling a Columbus OM system. Instead of needing to remember the
various Columbus OM commands and their options, you can navigate through a
hierarchy of logical choices until you reach the operation which you want to
perform. Wherever possible, you can select an item either by typing its name, or by
highlighting it from a list of possible values.
The associated document browser enables you to view the contents of an ASCII
text document. As well as moving sequentially forwards and backwards through
the document, you can jump to specific pages, locate occurrences of text strings,
and print some or all of the document.
The browser is primarily used by the uq menu system, but is also available from the
command line. Both components are provided only on UNIX systems.

Working with menus on page 10 provides general instructions on the use of
the menu system to control Columbus OM.

Working with the browser on page 15 covers use of the text browser.

10 CHAPTER 1
Using the uq menus
Working with menus
Working with menus

The interface assumes that you have a character mode terminal, typically
displaying 24 rows of 80 columns, and capable of a small number of visual effects
such as high/low intensity and normal/inverse video; if available, line-drawing
characters are also displayed. To control these effects, it uses the $TERM (or
$UNIQTERM) environment variable to determine the characteristics of your
terminal device: the procedure for configuring this variable correctly during
Columbus OM installation is described in Creating a definition for uq on page 22.
Also, your $UF_HOME environment variable must be set to $UNIQDIR/uniform.
Starting the menu interface

Type uq on the UNIX command line to start the menu interface and display the
top-level menu. The menus are different for each print, fax and dispatch instances,
and also vary according to your access privileges, but all follow the same pattern.
You will come across three general display styles:

for selecting primary options, see Using vertical menus on page 11

for data-related activities such as viewing the entries on a queue, see Using
horizontal menus on page 14

for viewing the contents of a file, see Working with the browser on page 15.
To exit from the menu interface, select the Quit option on the top-level (vertical)
menu. You can also exit by pressing function key F10. The interface uses the
function keys F1 to F10 to select various options; in particular F9 to confirm an
operation and F10 to terminate an operation.
Note On some terminals you may need to use an alternative set of ten function
keys: Help, F7, F8, F9, F10, F11, F12, F13, Do, PF4.
Terminal emulators do not always provide full function key support, but you can
achieve the same results by pressing the Escape key followed by a digit: Esc then 1
is equivalent to F1 (or Help), Esc then 2 is equivalent to F2 (or F7)..., through to
Esc then 0 which is equivalent to F10 (or PF4).

CHAPTER 1
Using the uq menus
Working with menus
11
Using vertical menus

This is an example of a vertical menu: the top-level options available to somebody
with Implementors privileges to a Columbus OM print instance:
title block option panel
key legends instance block

information block
The display includes these areas:

a title block, naming the product and the access level
the option panel, listing the choices available at this level

an information block with version and licensing data

an instance block, naming the Columbus OM instance and this menu screen
a set of key legends relating to function and other keys.
Choosing from the menu

To select an option, do one of the following:

Press the CursorDown and CursorUp keys to highlight the option, and then
press Return to select it.
Type the first letter of the option. If there is only one option with that letter, it is
automatically selected. If there are multiple options, keep typing the letter to
cycle through them, pressing Return to select.
Note You can configure this second behaviour by setting the Menu_Mode
parameter in $UNIQDIR/config/defaults.tab, described in the Technical
Reference manual.

12 CHAPTER 1
Using the uq menus
Working with menus
Performing the chosen option

After you select an option, one of two things happens:
If no further information is needed, the option is performed. For example,
Printer Status List immediately displays the status of all configured print
servers, while Quit takes you back to the previous menu, or out from the menu
interface.
Where additional choices or values are required, the interface presents a further
menu, or overlays another panel on the current menu. For example, Queue
Maintenance overlays a set of options relating to queues, on which Extend
Completed Queue superimposes a prompt panel for you to enter an
appropriate number for the extended queue size.
Selecting additional values from a list

In many cases, the interface can assist you by offering a list of possible values. For
example, Configuration overlays a set of options relating to server configuration,
on which Modify a Printer superimposes a prompt panel for you to enter the
printer name. At this point, you can either:
type the name, and then press Return to display its configuration; or

just press Return. The interface displays a list of possible printers, from which
you can select the appropriate value in the usual way.

CHAPTER 1
Using the uq menus
Working with menus
13
On a data entry panel where multiple values are defined, a similar mechanism is
available. For example, after you select Modify a Printer and specify the printer
name, the displayed panel includes a field for you to specify the name of a printer
type. With the cursor in this field, you can either:

type the name; or

use the List command assigned to function key F8. The interface then pops up
an option panel of possible printer types, from which you can select the
appropriate value as before; or

if the field is empty, just press Return to pop up the option panel.
For some field types, for example Yes/No values, the List command cycles
through the possible values. For fields where it is not possible to display a list of
possible values (for example, user-definable remarks), the List command has no
effect.

14 CHAPTER 1
Using the uq menus
Working with menus
Using horizontal menus

This is an example of a horizontal (or ring) menu: a display of the queues in for the
Columbus OM print instance:
option bar monitor block
key legends display area instance block

the option bar, listing the choices available at this level, and explaining the
currently-selected option

a monitor block, showing whether the data display is being automatically
refreshed as values change

a display area which can contain a variety of data presentations

an instance block, naming the Columbus OM instance and this menu screen

a set of key legends relating to function and other keys.
In most respects, horizontal menus offer the same functionality as vertical menus.
Choosing from the menu

To select an option from the menu, do one of the following:
Press the CursorRight and CursorLeft keys to highlight the option, and then
press Return to select it;
Type the first letter of the option. If there is only one option with that initial
letter, it is automatically selected. If there are multiple options, keep typing the
letter to cycle through them, and then press Return to select.
You can often use the CursorDown and CursorUp keys to select one of the items in
the display area, on which the selected option is to operate.

CHAPTER 1
Using the uq menus
Working with the browser
15

Like the uq menu interface, the browser assumes that you have a character mode
terminal, typically displaying 24 rows of 80 columns, and capable of a small
number of visual effects such as high/low intensity and normal/inverse video. To
control these effects, it uses the $TERM (or $UNIQTERM) environment variable to
determine the characteristics of your terminal device. The procedure for
configuring this variable correctly during Columbus OM installation is described in
Creating a definition for the browser on page 29.
Note The browser and the uq menu interface use separate terminal definitions.
Starting the browser

Type browse file on the UNIX command line to view the first lines of the file.
key legends display area status bar

a display area which presents the file contents

a status bar which shows the current location within the file

a set of key legends relating to function and other keys. Display of this
optional area is controlled by the browser terminal definition file: see Help
Text block on page 32.
Using the keyboard

The standard key assignments for the supported functions are given here:
Controlling the display on page 16
Moving around the document on page 16

Locating text strings on page 17

Marking blocks to be printed on page 17

16 CHAPTER 1
Using the uq menus

Printing parts of the document on page 18
The browser uses function keys F1 to F10 to select various options.
Note On some terminals you may need to use an alternative set of ten function
keys: Help, F7, F8, F9, F10, F11, F12, F13, Do, PF4.
Terminal emulators do not always provide full function key support: you can
achieve the same results by pressing the Escape key followed by a digit. For
example, Esc then 1 is equivalent to F1 (or Help); Esc then 2 is equivalent to F2 (or
F7); through to Esc then 0 which is equivalent to F10 (or PF4).
Controlling the display

These keys control the browser display.
To do this Press these keys
display help text h or H
toggle the display of the Status bar w or W
cycle through the defined display sizes z or Z
refresh the display Ctrl+L
exit from the browser q or Q or Esc then 0
Moving around the document

These keys support navigation around the document.
move the cursor down one row n or N or CursorDown
move the cursor up one row CursorUp
move the cursor right one column CursorRight
move the cursor left one column CursorLeft
scroll down by half the screen height d
scroll up by half the screen height u
scroll right by half the screen width >
scroll left by half the screen width <
go to the next page D
go to the previous page U
go to the first page t or T or F3
go to the last page b or F4

CHAPTER 1
Using the uq menus
17
go to a specified page g or G
the page_number then Return
go to the last line of the file B
Locating text strings

These keys display occurrences of a specified text string.
locate the next occurrence of a text string l or L

the string then Return
the attributes then Return
repeat the last locate function r or R or Return
The attributes control the way in which the search is conducted; any
combination of:
C to ignore upper/lowercase differences when matching the string

I to require that the string is an independent word, delimited by non
alphanumeric characters
W to recognize wildcards in the string, with an asterisk * meaning any
number of characters, and a question mark ? meaning any single character.
Marking blocks to be printed

These keys mark one or more blocks of contiguous lines, which can then be
printed.
define a block which starts at the bottom line of s

the display
define a block which starts at the top line of the S
display
define a block which ends at the bottom line of e
the display
define a block which ends at the top line of the E
display
display the next marked block, with its start at the m
bottom line of the display
display the previous marked block, with its start M
at the bottom line of the display
clear the marked block which starts at the bottom c
line of the display

18 CHAPTER 1
Using the uq menus
clear the marked block which starts at the top C

line of the display
clear all marked blocks aa or AA
Printing parts of the document

These keys invoke the print capability.
print the entire document p or P

1 then Return
the printer then Return
(see the Note below)
Return
print a range of pages p or P

2 then Return
the first_page then Return
the last_page then Return
Return
print the marked block(s) p or P

3 then Return
Return
Note Printing can be configured to use either the standard UNIX lp command
or, if available, the capabilities of the Columbus OM print instance: see
Configuring the Columbus OM/browser relationship on page 34. Where
a Columbus OM print instance is used, you are also asked whether the
print queue entry should have Held status, and given the opportunity to
associate a remark with the print job.

19
CHAPTER 2
Chapter 2 Terminal definitions
This chapter describes how, as part of the Columbus OM installation process, you
must establish terminal definition files to support the uq menu interface. Standard
files suitable for use with many popular terminal types are supplied with
Columbus OM, so this task is unlikely to be complicated.
The uq and browse commands present formatted displays using absolute cursor
positioning, inverse video, line-drawing characters and other similar effects. These
displays are constructed using control codes which must be specified for a
particular terminal type (and emulators of that type) in a terminal definition file. To
use the uq and browse commands, you must ensure that appropriate definition files
exist for the terminal type(s) which you plan to use.

Selecting a terminal definition on page 20 explains how to check if your
terminal type is supported as standard, and what to do if it isnt.

Creating a definition for uq on page 22 specifies the definition files used by
the uq command.

Creating a definition for the browser on page 29 specifies the definition files
used by the browse command.
Configuring the Columbus OM/browser relationship on page 34 covers
additional points to be considered when integrating the browser into a
Columbus OM instance.
Note Terminal definitions are stored in files beneath the $UNIQDIR directory
defining a single Columbus OM instance. If your installation includes
multiple Columbus OM instances, you must create appropriate terminal
definitions within each instance.

20 CHAPTER 2
Terminal definitions
Selecting a terminal definition

Columbus OM uses two sets of terminal definition files:
files in $UNIQDIR/uniform/ttp control the menus displayed by the uq
command; in addition, $UNIQDIR/menus/fkey.tab defines how the Key
legends area of menus are displayed.

files in $UNIQDIR/browser control text file displays produced by the browse
command, and by certain options within the uq menu interface.
For a list of terminal definitions supplied with the Columbus OM product, see
Standard supported terminals on page 21. To ensure that Columbus OM uses the
appropriate definition for your terminal, determine the current value of your
$TERM environment variable, then proceed according to these options:
1 $TERM value matches one of the standard Columbus OM terminal definitions:

you need do nothing further. Columbus OM will use the $TERM value to select
the appropriate definition.
2 $TERM value is not an exact match, but is related to one of the standard
Columbus OM terminal definitions (for example, your $TERM contains vt420,
which is upwards compatible with the supplied vt220 definition): you have
three choices.

Clone a supplied definition: see Copying an existing terminal definition
on page 21. This is the preferred method, since the new definition is then
available to all users with no impact on their environment variables.

Define a $UNIQTERM environment variable to contain one of the standard
Columbus OM terminal definitions; Columbus OM will use a $UNIQTERM
value in preference to a $TERM value. For example, your $TERM contains
vt420, so you could set $UNIQTERM to vt220.

Change your $TERM setting to match one of the standard Columbus OM
terminal definitions. For example, your $TERM contains vt420, so you
could change it to vt220. This is the simplest answer, but should be
approached with caution as it may affect the behaviour of other software
running on your terminal.
3 $TERM value bears no relation to any of the standard Columbus OM terminal
definitions (for example, your $TERM contains hp700, which is incompatible
with the supplied definitions): you have two choices.

Switch the terminal hardware to a different emulation mode and change
your $TERM setting to match one of the standard Columbus OM terminal
definitions. This is the preferred method, since almost all modern terminals
include emulators of models such as the vt100 or vt220 which are
including among the Columbus OM definitions.

Build a new definition: see Creating a definition for uq on page 22 and
Creating a definition for the browser on page 29. This is more
complicated, and may not be possible for all terminals.

CHAPTER 2
21
Standard supported terminals

Columbus OM is supplied with this set of standard terminal definitions:
Definition Applies to
aixterm AIX X-terminal

dtterm DEC VT220
ibm3101 IBM 3101
ibm3151 IBM 3151
ibm3161 IBM 3161
m303 ICL M303
pt200 Prime PT200
sun Sun workstation console
sun-cmd Sun workstation console
ti931 Texas Instruments TI931
vt100 DEC VT100
vt220 DEC VT220
vt220d DEC VT220 with no graphic characters
wyse60 Wyse 60
xterm X-terminal
xterm2 X-terminal with no graphic characters
Copying an existing terminal definition

If your $TERM value is not an exact match, but is compatible with one of the
standard Columbus OM terminal definitions, you can clone the existing definition
by making identical copies of its files:
1 In $UNIQDIR/browser, copy std_terminal_type.def to
new_terminal_type.def (preferably updating the comment at the top of the
file).
2 In $UNIQDIR/uniform/ttp/source, copy std_terminal_type to
new_terminal_type (preferably updating the comment at the top of the file).
3 Compile the copied file using the command ufct new_terminal_type

4 In $UNIQDIR/menus, edit fkey.tab by copying the line for std_terminal_type
to an equivalent line for new_terminal_type.
Columbus OM will use your $TERM value to select the new_terminal_type
definition.

22 CHAPTER 2
Creating a definition for uq

uq terminal definitions are created in source form, then compiled before use. For a
given terminal_type, the source file is
$UNIQDIR/uniform/ttp/source/terminal_type and the compiled file is
$UNIQDIR/uniform/ttp/terminal_type.ttp.
To build a definition for a new terminal type, follow these steps:

1 Create a source definition file: see Defining the terminal characteristics below.
2 Compile the source: see Compiling the definition on page 27.
3 Classify the terminal types function keys: see Specifying function key
handling on page 27.
Defining the terminal characteristics

A uq terminal definition file is divided into a number of logical blocks. Each block
starts with the keyword BEGIN, contains a related set of specification statements,
and is terminated by the keyword END. A specification statement occupies a single
line. Blank lines are ignored, as is any text on a line after the comment characters
/*. The blocks are:

ATTRIBUTES block on page 23

CONFIG block on page 24

CURSOR block on page 24
GRAPHICS block on page 25

KEYBOARD block on page 26

SCREEN block on page 27
In the specification statements which follow, the phrase code... denotes a space-
separated list of control codes to be transmitted to, or received from, the terminal.
Each item in the list is either:

one or more literal characters enclosed in single quotes '...' (within which
two consecutive quotes '' can be used to represent one single quote);

the standard ASCII control character name, from this list:
Name Octal Name Octal Name Octal
nul 000 vt 013 syn 026

soh 001 ff 014 etb 027
stx 002 cr 015 can 030
etx 003 so 016 em 031
eot 004 si 017 sub 032
enq 005 dle 020 esc 033
ack 006 dc1 021 fs 034
bell 007 dc2 022 gs 035

CHAPTER 2
23
bs 010 dc3 023 rs 036

ht 011 dc4 024 uf 037
lf 012 nak 025 del 177
ATTRIBUTES The ATTRIBUTES block specifies the visual attributes of characters.

block
Syntax
BEGIN ATTRIBUTES
ADDITIVE character
PREFIX code...
PREFIX_RESETS_ALL
RESET_ALL code...
RESET_BLINKING code...
RESET_RVIDEO code...
RESET_HIDDEN code...
RESET_LOW_INTENSITY code...
RESET_UNDERLINED code...
SEPERATOR code...
SET_BLINKING code...
SET_HIDDEN code...
SET_LOW_INTENSITY code...
SET_RVIDEO code...
SET_UNDERLINED code...
SUFFIX code...
END
Parameters
PREFIX code...
SEPERATOR code...
SUFFIX code...
For terminals which can set and reset several attributes in a single command,
PREFIX is sent first, then the first attribute, then the SEPERATOR (sic), then the
second attribute, then the SEPERATOR ..., then the final attribute, then SUFFIX.
For terminals which must treat each attribute individually, these statements
must be omitted.
PREFIX_RESETS_ALL
For terminals which can set and reset several attributes in a single command,
PREFIX_RESETS_ALL specifies that PREFIX first resets all attributes and then
sets those which follow, instead of individually setting and resetting them. For
terminals which must treat each attribute individually, this statement should be
omitted.
RESET_ALL code...
The sequence to reset all attributes.

24 CHAPTER 2
SET_attribute code...
RESET_attribute code...
The sequences to set and reset individual attributes.

ADDITIVE character
An optional base value added to the code values for SET_attribute.
CONFIG block The CONFIG block specifies communications properties.
Syntax
BEGIN CONFIG
DYNT_ID T1|T2
END
Parameters
DYNT_ID T1|T2
T1 and T2 identify block mode device drivers used with some terminal types.
The appropriate setting can best be established through trial and error.
CURSOR block The CURSOR block specifies cursor positioning.
Syntax
BEGIN CURSOR
COLUMN [FIRST] ADD|SUBTRACT number
INVISIBLE code...
PREFIX code...
ROW [FIRST] ADD|SUBTRACT number
SEPERATOR code...
SUFFIX code...
USE_RANK_VALUE
VISIBLE code...
END
Parameters
PREFIX code...
SEPERATOR code...
SUFFIX code...
When positioning the cursor to an absolute location, PREFIX is sent first, then
the row (or column) position, then the SEPERATOR (sic), then the column (or
row) position, then SUFFIX.
ROW [FIRST] ADD|SUBTRACT number
COLUMN [FIRST] ADD|SUBTRACT number
The FIRST qualifier should be used once, with either ROW or COLUMN, to
determine which is sent first when positioning the cursor to an absolute
location. The number is added to or subtracted from the absolute row or
column to determine the appropriate value to be sent to the terminal.

CHAPTER 2
25
USE_RANK_VALUE
USE_RANK_VALUE specifies that each row or column value is sent as a seven-bit

binary number (thus a value of 65 is sent as the character A). If omitted, each
value is converted to a decimal string (thus a value of 65 is sent as the
characters 65).
VISIBLE code...
INVISIBLE code...
The sequences to make the cursor visible (while the user is entering data) and
invisible (at other times).
GRAPHICS block The GRAPHICS block specifies the display of simple lines and boxes.
Syntax
BEGIN GRAPHICS
G1_ON code...
G2_ON code...
G_OFF code...
HLINE|TLINE|BLINE code...
RHLINE|RTLINE|RBLINE code...
VLINE|LLINE|RLINE code...
RVLINE|RLLINE|RRLINE code...
TLCORNER|BLCORNER|TRCORNER|BRCORNER code...
RTLCORNER|RTRCORNER|RBLCORNER|RBRCORNER code...
HEADL|HEAD|HEADR code...
RHEADL|RHEAD|RHEADR code...
END
Parameters
G1_ON code...
G2_ON code...
G_OFF code...
The sequences to select graphics character set 1 (normal video), graphics

character set 2 (reverse video), and to return to the standard text character set.
TLINE|HLINE|BLINE code...
RTLINE|RHLINE|RBLINE code...
The sequences to output a one-character horizontal line in normal video and in

reverse video. The position of the line within the character pixel matrix is
respectively across the top, through the middle, and across the bottom.
LLINE|VLINE|RLINE code...
RLLINE|RVLINE|RRLINE code...
The sequences to output a one-character vertical line in normal video and in

reverse video. The position of the line within the character pixel matrix is
respectively at the left, through the middle, and at the right.

26 CHAPTER 2
TLCORNER|TRCORNER|BLCORNER|BRCORNER code...
RTLCORNER|RTRCORNER|RBLCORNER|RBRCORNER code...
The sequences to output a one-character corner in normal video and in reverse

video.
HEADL|HEAD|HEADR code...
RHEADL|RHEAD|RHEADR code...
The sequences to output a one-character menu header character (top-left, top,

top-right) in normal video and in reverse video.
KEYBOARD block The KEYBOARD block maps character sequences received from the terminal to the
appropriate function name.
Syntax
BEGIN KEYBOARD
BACKTAB code...
CLEAR code...
CURSOR_DOWN code...
CURSOR_LEFT code...
CURSOR_RIGHT code...
CURSOR_UP code...
DELETE code...
ENTER code...
F1 code...
...
F10 code...
HELP code...
HOME code...
INSERT code...
PAGE_DOWN code...
PAGE_UP code...
PRINT code...
RETURN code...
TAB code...
END
Any given function name may be defined several times, each with a different
character sequence. However, any given character sequence must appear only
once in this block. When an incoming character sequence is recognized, the uq
interface instructs the terminal to perform the associated functionality.
The block includes the function names F1 through F10. These entries represent the
standard functionality associated with ten function keys, rather than the actual key
legends (which may in some instances be Help, F7, ... PF4); you can also press the
Escape key and then a digit 1 through 0 to achieve the same effect. If you cannot
otherwise identify it, you may be able to determine the character sequence return
from a given key by using this technique on the terminal concerned:
$ echo "press_key_here" | od -c
0000000 code... \n
0000004

CHAPTER 2
27
where press_key_here represents a single press of the key concerned. The

returned code... prior to the \n is the keys character sequence, with control
codes given as three-digit octal numbers (see Defining the terminal characteristics
on page 22). Note, however, that this method requires the Bourne shell, and may
not work reliably under a terminal emulator.
See also Specifying function key handling below.
SCREEN block The SCREEN block specifies the display characteristics as a whole.
Syntax
BEGIN SCREEN
CLEAR code...
PAUSE_AFTER_CLEAR number
END
Parameters
CLEAR code...
The sequence to clear the screen to spaces, with the cursor at the first column of
the first row.
PAUSE_AFTER_CLEAR number
The delay in milliseconds after CLEAR and before sending further characters.
Compiling the definition

To compile a uq terminal definition file:
1 Change to the $UF_HOME/ttp/source directory.
2 Use the ufct command to compile the appropriate terminal_type source file.
$ ufct terminal_type
3 If successful, the resulting terminal_type.ttp is written to $UF_HOME/ttp.
Specifying function key handling

$UNIQDIR/menus/fkey.tab defines the way in which function keys are labelled on
a given terminal. The file contains one line for each terminal type, with two space-
separated fields:
terminal_type
The name of the terminal type, as set in $TERM or $UNIQTERM.

0|1|2
The classification of the terminal type, used to select the appropriate set of key
legends to display along the bottom of the uq menus; one of:
0 The terminal has no function keys; the equivalent functionality can be

obtained only by pressing ESC followed by a digit 1 through 0.

28 CHAPTER 2
1 The terminal has standard ANSI function keys labelled F1 through

F10.
2 The terminal has enhanced ANSI function keys labelled Help, F7
through F13, Do and PF4.
Add an appropriate line for the new terminal type.

CHAPTER 2
Creating a definition for the browser
29

A browser terminal definition file $UNIQDIR/browser/terminal_type.def is
divided into a number of logical blocks. Unlike the uq definitions, a block is
delineated only by the specification statements that it contains, not by surrounding
BEGIN and END keywords. A specification statement occupies a single line. Blank
lines are ignored, as is any text on a line which starts with the comment character #.
The blocks are:
Display block below

Keyboard block on page 31

Help Text block on page 32
In addition, a capability to switch between different display sizes on the same
terminal requires changes in two of those blocks. See Screen Size Switching on
page 33.
In the specification statements which follow, the phrase code... denotes a
sequence of control codes to be transmitted to, or received from, the terminal. Each
item in the sequence is either:

a literal character (with two consecutive backslashes \\ used to represent one
single backslash);

a standard ASCII control character from this list, given as a backslash followed
by a three-digit octal number:
nul 000 vt 013 syn 026

soh 001 ff 014 etb 027
stx 002 cr 015 can 030
etx 003 so 016 em 031
eot 004 si 017 sub 032
enq 005 dle 020 esc 033
ack 006 dc1 021 fs 034
bell 007 dc2 022 gs 035
bs 010 dc3 023 rs 036
ht 011 dc4 024 uf 037
lf 012 nak 025 del 177
Display block The Display block specifies the visual attributes of characters, cursor positioning,
and the display characteristics as a whole.

30 CHAPTER 2
Syntax
# Display block
BLINK code...
BOTTOM code...
CLEAR code...
COLS number
CURSOROFF code...
CURSORON code...
DELETE code...
ERASE code...
HOME code...
INITS code...
INSERT code...
LINTENSE code...
NL_STR code...
NORMAL code...
RESETS code...
ROWS number
RVIDEO code...
STATUS ON|OFF
Parameters
ROWS number
COLS number
The number of rows and columns on the screen.

STATUS ON|OFF
ON to initially display the status bar at the bottom of the screen; OFF to suppress
it.
INITS code...
RESETS code...
CLEAR code...
The sequences to initialize the terminal on entry to browse mode, to reset it on

exit, and to clear the screen.
BLINK code...
LINTENSE code...
NORMAL code...
RVIDEO code...
The sequences to set and reset display attributes.

HOME code...
BOTTOM code...
NL_STR code...
The sequences to move the cursor to the top left corner and bottom left corner
of the screen, and to the start of the next line.
CURSORON code...
CURSOROFF code...
The sequences to make the cursor visible and invisible.

CHAPTER 2
31
INSERT code...
DELETE code...
ERASE code...
The sequences to insert a blank line above the cursor (scrolling the remainder
down), to delete the current line (scrolling up), and to erase all text to the right
of the cursor on the current line.
Keyboard block The Keyboard block maps character sequences received from the terminal to the
appropriate function name. Each line contains three space-separated fields:
function code... legend
Parameters
function
The name of a browser function, listed below. Any given function name may
be defined several times, each with a different character sequence. However,
any given character sequence must appear only once in this block. When an
incoming character sequence is recognized, the browser instructs the terminal
to perform the associated functionality.
code...
A character sequence which might be received.

legend
The legend on the associated key, used when displaying help text to inform the
user which key performs which function.
The browser functions are:
BEGIN Display the first page of the file.

END Display the last page of the file.
EOF Display the last line of the file on the bottom line of the display.
EXIT Exit from the browser.
GOTOPAGE Display a specified page of the file starting at the top line of the
display.
HELP Display help text.
LINEDOWN Move cursor down one row.
LINELEFT Move cursor left one column.
LINERIGHT Move cursor right one column.
LINEUP Move cursor up one row.
LOCATE Search for a string.
MARKCLEARALL Clear all marked blocks.
MARKCLEARBOT Clear the marked block which starts at the bottom line of the
display.
MARKCLEARTOP Clear the marked block which starts at the top line of the
display.
MARKENDBOT Define a block which ends at the bottom line of the display.
MARKENDTOP Define a block which ends at the top line of the display.

32 CHAPTER 2
MARKGOTONEXT Display the next marked block with its start at the bottom line
of the display.
MARKGOTOPREV Display the previous marked block with its start at the bottom
line of the display.
MARKSTARTBOT Define a block which starts at the bottom line of the display.
MARKSTARTTOP Define a block which starts at the top line of the display.
NULLACT Define a key to have no effect.
PAGEDOWN Display the next page of the file starting at the top line of the
display.
PAGEUP Display the previous page of the file starting at the top line of
the display.
PRINT Print all or part of the file.
REDRAW Refresh the display.
REPEAT Repeat the last LOCATE function.
SCROLLDOWN Scroll down by half the screen height.
SCROLLEFT Scroll left by half the screen width.
SCROLLRIGHT Scroll right by half the screen width.
SCROLLUP Scroll up by half the screen height.
SIZE_SW Cycle through the defined display size configurations
(optional: see Screen Size Switching on page 33).
STATUS_SW Toggle the display of the status bar.
Help Text block The Help Text block supports two capabilities: user-defined material, and function
key assignments.
Syntax
# Help Text block
HELPPATH file
HELP_TEXT "14_char_string"
Parameters
HELPPATH file
file is the full path to a file of user-defined supplementary material, which will
be displayed after the standard browser help listing the functions available and
the keystrokes which invoke those functions.
HELP_TEXT "14_char_string"
If used, this statement should appear exactly ten times, giving the text to appear
in the ten highlighted boxes in the Key legends area; the legends can reflect
the use of ten function keys, or any other key information you wish to display.
Each quoted 14_char_string is displayed as two strings of seven characters,
one above the other; by convention, the upper string is the left-aligned key
identification, and the lower string is the right-aligned functional description.

CHAPTER 2
33
If you choose to display the function key assignments using HELP_TEXT, you should
also make allowances for the two lines that this occupies by modifying two
statements in the Keyboard block: decrease by two the value specified for ROWS,
and adjust the definition of BOTTOM correspondingly.
The default terminal definition files in $UNIQDIR/browser/terminal_type.def do
not include HELP_TEXT definitions, though such definitions are available in files
$UNIQDIR/browser/terminal_type.fkey. To switch to the definitions which
include the Key legends display:
$ cd $UNIQDIR/browser
$ mv terminal_type.def terminal_type.no_fkey
$ mv terminal_type.fkey terminal_type.def
CAUTION Do not confuse these .fkey files in $UNIQDIR/browser with the quite
different .fkey files in $UNIQDIR/menus.
Screen Size Screen Size Switching supports the capability of switching between different
Switching display sizes on the same terminal. If you wish to implement this capability, you
must change two blocks in the file.
Firstly, modify the Display block by grouping the ROWS, COLS and BOTTOM
specifications for a given display configuration, followed by a SET_SIZE statement
to activate that configuration. You can repeat this group of four statements for each
display configuration.
# Screen size definitions
ROWS number
COLS number
BOTTOM code...
SET_SIZE code...
Parameters
ROWS number
COLS number
BOTTOM code...
The definitions which are associated with a given display configuration.

SET_SIZE code...
The sequence to switch the terminal into that configuration.

Secondly, modify the Keyboard block by associating one or more character
sequences with the SIZE_SW function. Repeated operation of the key associated
with this function then causes the browser to cycle through the defined display
configurations.

34 CHAPTER 2
Configuring the Columbus OM/browser relationship
Configuring the Columbus OM/browser relationship

When you install Columbus OM on a UNIX platform, you need to consider the
relationship with the text file browser. There are three aspects:
invoking the browser from the uq menu interface

invoking a Columbus OM print instance from the browser
configuring browser printing.
Invoking the browser from the uq menu interface

The system file $UNIQDIR/config/default.tab contains a VDUMode parameter
which determines how text files are displayed from within the uq menu interface.
To use the browser for this purpose, set the parameter thus:
VDUMode 'browse %FILE -PAGE %PLEN'
Invoking a Columbus OM print instance from the browser

The browser calls the shell script $UNIQDIR/browser/brprint when requested to
print parts of a document. By default, this script calls the Columbus OM print
instance to handle the print request; therefore, if your installation includes a print
instance then you need take no further action. If your installation does not include a
Columbus OM print instance, you should switch to the alternative print process
which uses the standard UNIX lp command:
$ cd $UNIQDIR/browser
$ mv brprint brprint.uniq
$ mv brprint.lp brprint
If necessary, you can amend either of these scripts.
Configuring browser printing

The browser reads a file $UNIQDIR/browser/report.def to obtain certain
configuration information. See report.def: Browser print specification on page 92
for details.

35
CHAPTER 3
Chapter 3 Standard Columbus OM

menu structure
This chapter presents the standard uq menu structure for Columbus OM, primarily
for the benefit of implementors wanting to apply customizations to suit the
requirements of their installation.
Note In the standard menu definition files, some options have been commented
out by a hash # at the start of the line; these extra options are shown as such
in the sections which follow.
Where applicable, the minimum administrative access privilege that a user must
have before being offered an option by the menu interface is provided. Thus,
Minimum privileges: administrators means that a user listed in
$UNIQDIR/security/administrators (which also includes everybody listed in
implementors) will see the option, which will not be offered to users listed only in
operators, or in none of these three files. Options without an annotation of this
form are offered to all users of a given menu.

Customizing the menus on page 36

Dispatch instance menus on page 37
Fax instance menus on page 43
Print instance menus on page 50

36 CHAPTER 3
Standard Columbus OM menu structure
Customizing the menus
Customizing the menus

The menu interface is controlled by a series of definition files, in
$UNIQDIR/menus, whose structure is defined in menu.menu: Vertical menu
definitions on page 85 and menu.ring: Horizontal menu definitions on page 87.
In almost every instance, the effect of selecting a menu option is either to display a
sub-menu, or to invoke one of the Columbus OM functions: see Built-in functions
on page 63.
You can modify any of the Columbus OM menu definition files in order to:

add options to a menu

remove (usually by commenting out) options from a menu

change the access privileges associated with an option.
You can also modify some of the information displays. See:

wliqsum.tab: Queue display format on page 94

wopqsum.tab: Printer status display format on page 95.
The interface displays the name of the current menu in the Instance block towards
the bottom right-hand corner of the screen.

CHAPTER 3
Dispatch instance menus
37

The uq command uses your access privileges in conjunction with files
uqimp.menu, uqadm.menu, uqops.menu and uquser.menu in
$UNIQDIR/menus to display an appropriate menu:

uq401: Main Menu (dispatch implementors, administrators, operators) below

uq402: Main Menu (dispatch users) on page 38
uq010: Security on page 38

uq411: Dispatch Server Management on page 40

uq413: Configuration on page 40

wliq: List Queue on page 41
wliq3: Search Options on page 41
uq401: Main Menu (dispatch implementors, administrators,

operators)
Server Status List Invoke built-in function all_server_stats: Show
status of all servers (see page 64). Minimum privileges:
operators.
List the Dispatch Display ring menu wliq: List Queue on page 41 by
Queue invoking built-in function wlistq: List the queue (see
page 80). Minimum privileges: operators.
List Current Browse the contents of file
Bundles $UNIQDIR/media/dispatch/bundle.tab. Minimum
privileges: operators.
Dispatch a File Invoke built-in function addq: Add entry to print or
dispatch queue (see page 64). Minimum privileges:
operators.
System Security Display menu uq010: Security on page 38 by invoking
built-in function security_sel: Display System
Security menu (see page 77). Minimum privileges:
operators.
Server Management Display menu uq411: Dispatch Server Management
on page 40. Minimum privileges: operators.
Configuration Display menu uq413: Configuration on page 40.
Minimum privileges: implementors.
Queue Maintenance Display menu uq014: Queue Maintenance on
page 57. Minimum privileges: operators.
View Logs Display menu uq027: View Logs on page 57.
Minimum privileges: operators
Quit Exit from the uq menu interface.

38 CHAPTER 3
uq402: Main Menu (dispatch users)

# Print a File Invoke built-in function addq: Add entry to print or
dispatch queue (see page 64).
List the Dispatch Display ring menu wliq: List Queue on page 41 by
page 80).
Server Status List Invoke built-in function all_server_stats: Show
status of all servers (see page 64).
uq010: Security
Add name to list of Invoke built-in function addname: Add name to list of
authorized users authorized users (see page 64).
Remove name from Invoke built-in function remname: Remove name
list of authorized from list of authorized users (see page 76).
users
Allow access to all Invoke built-in function addall: Allow all users
other users access to a function (see page 64).
Remove access from Invoke built-in function remall: Remove access to
all individual function from all users (see page 76).
users
Quit Return to the previous menu.
The operations on this menu add and remove entries from the files which control
which users are authorised to perform which Columbus OM functions. The list of
controllable functions, taken from $UNIQDIR/security/security.tab, is:
Operator Privileges Update access control file operators. Minimum

Administrator Update access control file administrators. Minimum
Privileges privileges: administrators.
Implementor Update access control file implementors. Minimum
Privileges privileges: implementors.
Add entries for Update access control file aeq_o. Minimum privileges:
other user operators.
Modify entries for Update access control file aeq_mod. Minimum
any user privileges: operators.
Resubmit entries as Update access control file rsq_o. Minimum privileges:
your own operators.
Redirect a pending Update access control file mod_at.
queue entry
Redirect a Update access control file mod_at_c.
completed queue
entry
List all in pending Update access control file liq_ap. Minimum privileges:
queue operators.

CHAPTER 3
39
List all in either Update access control file liq_ao. Minimum privileges:
queue operators.
List specific Update access control file liq_o. Minimum privileges:
owner's entries operators.
View other owner's Update access control file liq_view. Minimum
entries privileges: administrators.
View entries of Update access control file liq_view_g. Minumum
others in group privileges: operators.
View your own Update access control file liq_view_o. Minumum
entries privileges: operators.
Display queue entry Update access control file liq_det. Minimum privileges:
details administrators.
Receive 'queue Update access control file wliq_warn. Minimum
tidy' message privileges: operators.
Remove any owner's Update access control file req_ao. Minimum privileges:
entries administrators.
Remove specific Update access control file req_o. Minimum privileges:
Use of queue Update access control file aeq_p0. Minimum
priority 0 privileges: operators.
priority 8 privileges: administrators.
priority 9 privileges: implementors.
Display system Update access control file syq_dd. Minimum
defaults privileges: operators.
Modify system Update access control file sysdef_mod. Minimum
defaults privileges: implementors.
Extend Completed Update access control file syq_ec. Minimum privileges:
queue administrators.
Extend Pending Update access control file syq_ep. Minimum
queue privileges: administrators.

40 CHAPTER 3
Journal of Update access control file syq_jc. Minimum privileges:

Completed queue operators.
Journal of Pending Update access control file syq_jp. Minimum privileges:
queue operators.
Fix Completed queue Update access control file syq_fc. Minimum privileges:
operators.
Fix Pending queue Update access control file syq_fp. Minimum privileges:
operators.
Purge Completed Update access control file syq_pc. Minimum
Purge Pending queue Update access control file syq_pp. Minimum
privileges: administrators.
Start a dispatch Update access control file syq_i. Minimum privileges:
server operators.
Stop a dispatch Update access control file syq_tn. Minimum privileges:
server operators.
View Queue Update access control file syq_qs. Minimum
statistics privileges: operators.
View Server status Update access control file syq_s. Minimum privileges:
operators.
uq411: Dispatch Server Management

Start Server Invoke built-in function start_server: Start server
(see page 77). Minimum privileges: operators.
Stop Server Invoke built-in function stop_server: Stop server
Server Status Invoke built-in function server_stats: Display
status of server (see page 77). Minimum privileges:
operators.
Start all Servers Invoke built-in function start_all_servers: Start
all servers (see page 77). Minimum privileges:
operators.
Stop all Servers Invoke built-in function stop_all_servers: Stop
operators.
All Server Status Invoke built-in function all_server_stats: Show
operators.
uq413: Configuration
Add Dispatch Server Invoke built-in function add_server: Configure new
general server (see page 64). Minimum privileges:
implementors.

CHAPTER 3
41
Modify Dispatch Invoke built-in function mod_server: Configure

Server general server (see page 73). Minimum privileges:
implementors.
Remove a Dispatch Invoke built-in function del_server: Delete server
Server (see page 68). Minimum privileges: implementors.
Rules Table Browse the contents of file
$UNIQDIR/media/dispatch/rules.tab. Minimum
privileges: implementors.
System Defaults Invoke built-in function mod_default: Configure
system defaults (see page 73). Minimum privileges:
implementors.
wliq: List Queue

Servers Invoke built-in function all_server_stats: Show
# Add Invoke built-in function wliq_addq: Add entry to
print queue (see page 79).
# Modify Invoke built-in function wliq_modq: Modify current
print queue entry (see page 79).
Remove Invoke built-in function wliq_remq: Remove current
entry from queue (see page 79).
Hold Invoke built-in function wliq_hold: Put current entry
on hold (see page 79).
Release Invoke built-in function wliq_relq: Release current
HELD entry (see page 79).
# Resubmit Invoke built-in function wliq_resq: Resubmit
current entry (see page 79).
Location Invoke built-in function wliq_setq: Change to
another Columbus OM instance (see page 80).
Minimum privileges: administrators.
View Invoke built-in function wliq_view: View document
file for current entry (see page 80).
Search Display menu wliq3: Search Options below by
invoking built-in function wliq_options: Display
Search Options menu (see page 79).
Attributes Invoke built-in function si_detail: Display server
information for current entry (see page 77).
wliq3: Search Options

Restrict OWNER Invoke built-in function chg_owner: Select specific
owner (see page 67). Minimum privileges: liq_o.
Show all OWNERS Invoke built-in function any_owner: Select any
owner (see page 65). Minimum privileges: liq_ao.

42 CHAPTER 3
Show all OWNERS in Invoke built-in function any_pending: Select any

pending queue owner in Pending, current owner in Completed (see
page 65). Minimum privileges: liq_ap.
Restrict FILENAME Invoke built-in function chg_filename: Select
specific filename (see page 67).
Show all FILENAMES Invoke built-in function any_filename: Select any
filename (see page 65).
Restrict ADDRESS Invoke built-in function chg_address: Select specific
(printer/class) address (see page 67).
Show all ADDRESSES Invoke built-in function any_address: Select any
(printers/ classes) address (see page 64).
Add a STATUS Invoke built-in function new_status: Impose
restriction restriction on status code (see page 74).
Remove a STATUS Invoke built-in function rem_status: Lift restriction
restriction on status code (see page 76).
Allow all STATUSES Invoke built-in function any_status: Select any
status code (see page 65).

CHAPTER 3
Fax instance menus
43
Fax instance menus


uq201: Main Menu (fax implementors, administrators, operators) below

uq202: Fax Submission (fax users) on page 44

uq211: Fax Server Management on page 46

uq212: Monitor Fax Servers on page 47


uq201: Main Menu (fax implementors, administrators,

operators)
Fax Server Status Invoke built-in function list_fax_servers: List
status of all fax servers (see page 72). Minimum
# All Server Status Invoke built-in function all_server_stats: Show
operators.
List the Fax Queue Display ring menu wliq: List Queue on page 48 by
invoking built-in function wlistq: List the queue (see
Monitor Fax Servers Display ring menu uq212: Monitor Fax Servers on
page 47 by invoking built-in function uqt: Monitor all
fax servers (see page 78). Minimum privileges:
operators.
Send a Fax Invoke built-in function addfq: Add entry to fax
queue (see page 64). Minimum privileges: operators.
operators.
Fax Server Display menu uq211: Fax Server Management on
Management page 46. Minimum privileges: operators.
Change Queue Invoke built-in function set_queue: Change to

44 CHAPTER 3
Fax instance menus

Minimum privileges: operators.
uq202: Fax Submission (fax users)

Send a Fax Invoke built-in function addfq: Add entry to fax
queue (see page 64).
List the Fax Queue Display ring menu wliq: List Queue on page 48 by
page 80).
Fax Server Status Invoke built-in function list_fax_servers: List
status of all fax servers (see page 72).
# All Server Status Invoke built-in function all_server_stats: Show
uq010: Security
users
users

your own operators.

CHAPTER 3
Fax instance menus
45

queue entry
completed queue
entry
queue operators.
queue operators.

46 CHAPTER 3
Fax instance menus

queue operators.
operators.
operators.
Start a fax server Update access control file syq_i. Minimum privileges:
operators.
Stop a fax server Update access control file syq_tn. Minimum privileges:
operators.
operators.
Remote Update access control file uqnet_uq. Minimum
Administration privileges: administrators.
uq211: Fax Server Management

Start Fax Server Invoke built-in function start_server: Start server
Stop Fax Server Invoke built-in function stop_server: Stop server
Fax Server Status Invoke built-in function server_stats: Display
operators.
Start all Fax Invoke built-in function start_all_servers: Start
Servers all servers (see page 77). Minimum privileges:
administrators.
Stop all Fax Invoke built-in function stop_all_servers: Stop
Servers all servers (see page 77). Minimum privileges:
administrators.

CHAPTER 3
Fax instance menus
47

administrators.
uq212: Monitor Fax Servers

Management Display menu uq211: Fax Server Management on
page 46.
ListQ Display ring menu wliq: List Queue on page 48 by
page 80).
Detail Invoke built-in function server_setup: Display
server configuration (any server) (see page 77).
Add a Fax server Invoke built-in function add_fax_server:
Configure new fax server (see page 64). Minimum
Duplicate a Fax Invoke built-in function dup_server: Duplicate
server server (see page 68). Minimum privileges:
implementors.
Modify a Fax server Invoke built-in function mod_fax_server:
Configure fax server (see page 73). Minimum
Remove a Fax server Invoke built-in function del_server: Delete server
(see page 68). Minimum privileges: implementors.
Add Other Server Invoke built-in function add_server: Configure new
implementors.
Modify Other Server Invoke built-in function mod_server: Configure
implementors.
Fax Shortcodes Invoke built-in function fax_shortcodes:
Configure fax shortcodes (see page 70). Minimum
Serial Line Invoke built-in function mod_ldef: Configure serial
Definition lines (see page 73). Minimum privileges:
implementors.
implementors.

48 CHAPTER 3
Fax instance menus
wliq: List Queue

Servers Invoke built-in function list_fax_servers: List
status of all fax servers (see page 72).
# Add Invoke built-in function wliq_addfq: Add entry to
fax queue (see page 79).
Modify Invoke built-in function wliq_modfq: Modify current
fax queue entry (see page 79).
Resubmit Invoke built-in function wliq_resq: Resubmit
# Location Invoke built-in function wliq_setq: Change to
Options Display menu wliq3: Search Options below by

address (see page 67).
address (see page 64).
Add a MEDIUM Invoke built-in function new_medium: Impose
restriction restriction on medium (see page 74).
Remove a MEDIUM Invoke built-in function rem_medium: Lift restriction
restriction on medium (see page 76).

CHAPTER 3
Fax instance menus
49
Show all MEDIA Invoke built-in function any_medium: Select any

medium (see page 65).

50 CHAPTER 3
Print instance menus


uq001: Main Menu (print implementors, administrators, operators) below

uq002: Document Printing (print users) on page 51
uq008: Configure System Tables on page 51


uq011: Scheduler Management on page 55

uq012: Monitor Printers on page 56

uq014: Queue Maintenance on page 57

uq027: View Logs on page 57


wopq: Printer Operations on page 59

wopq1: Class Maintenance on page 60

wopq2: Paper Maintenance on page 61
uq001: Main Menu (print implementors, administrators,

operators)
Printer Status List Invoke built-in function list_printers: List status
of all print servers (see page 72). Minimum privileges:
operators.
List the Print Display ring menu wliq: List Queue on page 58 by
Print a File Invoke built-in function addq: Add entry to print or
dispatch queue (see page 64). Minimum privileges:
operators.
Monitor Printers Display ring menu uq012: Monitor Printers on
page 56 by invoking built-in function uqo: Monitor all
print servers (see page 78). Minimum privileges:
operators.
Printer Operations Display ring menu wopq: Printer Operations on
page 59 by invoking built-in function wopq: Display
Printer Operations menu (see page 80). Minimum

CHAPTER 3
51

operators.
Scheduler Display menu uq011: Scheduler Management on
Management page 55. Minimum privileges: operators.
Change Location Invoke built-in function set_queue: Change to
uq002: Document Printing (print users)

Print a File Invoke built-in function addq: Add entry to print or
dispatch queue (see page 64).
List the Print Display ring menu wliq: List Queue on page 58 by
page 80).
Printer Status List Invoke built-in function list_printers: List status
of all print servers (see page 72).
uq008: Configure System Tables

implementors.
Group Maintenance Invoke built-in function printer_groups:
Configure printer groups (see page 75). Minimum
Netmaster Hosts Invoke built-in function netmaster_hosts:
Table Configure hosts for netmaster (see page 74). Minimum
Remote Printers Invoke built-in function remote_table: Configure
Table remote printers (see page 76). Minimum privileges:
implementors.
Trusted Hosts Table Invoke built-in function mod_cshosts: Configure
csuniq trusted hosts (see page 73). Minimum

52 CHAPTER 3
uq010: Security
users
users

your own operators.
queue entry
completed queue
entry
Full modification Update access control file modq_full. Minimum
queue operators.
queue operators.
List queue for one Update access control file liq_1p. Minimum privileges:
printer only operators.

CHAPTER 3
53

Create a new Update access control file server_add. Minimum
printer privileges: implementors.
Modify an existing Update access control file server_mod. Minimum
Delete an existing Update access control file server_rem. Minimum
Abort any printout Update access control file opq_a. Minimum privileges:
operators.
Abort own printouts Update access control file opq_a_own. Minimum
only privileges: operators.
Cancel any printout Update access control file opq_c. Minimum privileges:
operators.
Cancel own Update access control file opq_c_own. Minimum
printouts only privileges: operators.

54 CHAPTER 3
Pause any printout Update access control file opq_p. Minimum privileges:
operators.
Pause own printouts Update access control file opq_p_own. Minimum
Resume any printout Update access control file opq_r. Minimum privileges:
operators.
Resume own Update access control file opq_r_own. Minimum
Split any printout Update access control file opq_s. Minimum privileges:
operators.
Split own printouts Update access control file opq_s_own. Minimum
Transfer any Update access control file opq_t. Minimum privileges:
printout operators.
Transfer own Update access control file opq_t_own. Minimum
Lineup a printer Update access control file opq_l. Minimum privileges:
operators.
Add a printer to a Update access control file opq_i. Minimum privileges:
class operators.
Delete a printer Update access control file opq_x. Minimum privileges:
from a class operators.
Disable a printer Update access control file opq_d. Minimum privileges:
operators.
Enable a printer Update access control file opq_e. Minimum privileges:
operators.
Duplicate a printer Update access control file opq_o. Minimum privileges:
implementors.
Add paper to a Update access control file opq_m. Minimum privileges:
printer operators.
Remove paper from a Update access control file opq_u. Minimum privileges:
printer operators.
Change printer Update access control file opq_v. Minimum privileges:
device administrators.
Kill a printer Update access control file opq_k. Minimum privileges:
server administrators.

CHAPTER 3
55

queue operators.
operators.
operators.
Start a print Update access control file syq_i. Minimum privileges:
server operators.
Stop a print server Update access control file syq_tn. Minimum privileges:
operators.
operators.
View Printer Update access control file printer_ops. Minimum
Operations privileges: administrators.
Force shutdown of Update access control file uqkill. Minimum privileges:
Columbus OM server administrators.
uq011: Scheduler Management

Start Scheduler Invoke built-in function start_master: Start
scheduler on current queue (see page 77). Minimum
Stop Scheduler Invoke built-in function stop_master: Stop
scheduler on current queue (see page 77). Minimum
Scheduler Status Invoke built-in function master_status: Show
status of scheduler on current queue (see page 73).
# Start all Invoke built-in function start_all_masters: Start
Schedulers scheduler on all queues (see page 77). Minimum
# Stop all Invoke built-in function stop_all_masters: Stop
Schedulers scheduler on all queues (see page 77). Minimum
# All Scheduler Invoke built-in function all_master_status:
Status Show status of scheduler on all queues (see page 64).
Start Server Invoke built-in function start_server: Start server
Stop Server Invoke built-in function stop_server: Stop server

56 CHAPTER 3
Server Status Invoke built-in function server_stats: Display

operators.
Start all Servers Invoke built-in function start_all_servers: Start
operators.
Stop all Servers Invoke built-in function stop_all_servers: Stop
operators.
operators.
uq012: Monitor Printers

page 55.
page 80).
Operations Display ring menu wopq: Printer Operations on
page 59 by invoking built-in function wopq: Display
Printer Operations menu (see page 80).
Detail Invoke built-in function server_setup: Display
server configuration (any server) (see page 77).
# Detail Invoke built-in function printer_setup: Display
print server configuration (see page 75).
Add a Printer Invoke built-in function add_print_server:
Configure new print server (see page 64). Minimum
Duplicate a Printer Invoke built-in function dup_server: Duplicate
server (see page 68). Minimum privileges:
implementors.
Modify a Printer Invoke built-in function mod_print_server:
Configure print server (see page 73). Minimum
Remove a Printer Invoke built-in function del_server: Delete server
(see page 68). Minimum privileges: implementors.
Enable a Printer Invoke built-in function enable_printer: Enable
print server (see page 69). Minimum privileges:
implementors.

CHAPTER 3
57
Modify Print Invoke built-in function mod_scheduler: Configure

Scheduler scheduler (see page 73). Minimum privileges:
implementors.
Add Other Server Invoke built-in function add_server: Configure new
implementors.
Modify Other Server Invoke built-in function mod_server: Configure
implementors.
Paper Type Invoke built-in function paper_types: Configure
Definition paper type (see page 75). Minimum privileges:
implementors.
Printer Type Invoke built-in function define_printer:
Definition Configure printer type (see page 68). Minimum
Serial Line Invoke built-in function mod_ldef: Configure serial
Definition lines (see page 73). Minimum privileges:
implementors.
Configure System Display menu uq008: Configure System Tables on
Tables page 51. Minimum privileges: implementors.
# Create an Archive Invoke command uq_mkarchive. Minimum privileges:
Queue implementors.
uq014: Queue Maintenance

Extend Pending Invoke built-in function ext_pending: Extend
Queue Pending queue (see page 69). Minimum privileges:
administrators.
Extend Completed Invoke built-in function ext_complete: Extend
Queue Completed queue (see page 69). Minimum privileges:
administrators.
Purge Pending Queue Invoke built-in function purge_pending: Purge
Pending queue (see page 75). Minimum privileges:
administrators.
Purge Completed Invoke built-in function purge_complete: Purge
Queue Completed queue (see page 75). Minimum privileges:
administrators.
Fix Pending Queue Invoke built-in function fix_pending: Fix Pending
queue (see page 70). Minimum privileges: operators.
Fix Completed Queue Invoke built-in function fix_complete: Fix
Completed queue (see page 70). Minimum privileges:
operators.
Queue Statistics Invoke built-in function queue_stats: Display
queue statistics (see page 75). Minimum privileges:
operators.

58 CHAPTER 3
uq027: View Logs

# Day Log Invoke built-in function view_day_log: View day
log by page (see page 78).
# Error Log Invoke built-in function view_err_log: View error
# Output Invoke built-in function view_output: View output
Day Log Invoke built-in function browse_day_log: Browse
day log (see page 66).
Error Log Invoke built-in function browse_err_log: Browse
error log (see page 66).
Output Invoke built-in function browse_output: Browse
output log (see page 66).
wliq: List Queue

Printers Invoke built-in function list_printers: List status
of all print servers (see page 72).
# Add Invoke built-in function wliq_addq: Add entry to
print queue (see page 79).
Modify Invoke built-in function wliq_modq: Modify current
print queue entry (see page 79).
Resubmit Invoke built-in function wliq_resq: Resubmit
Redirect Invoke built-in function wliq_redir: Redirect
current entry to another queue (see page 79).
Location Invoke built-in function wliq_setq: Change to
Errors Invoke built-in function wliq_error: View stderr
stream for current entry (see page 79).
Search Display menu wliq3: Search Options on page 59 by

CHAPTER 3
59
Attributes Invoke built-in function si_detail: Display server

information for current entry (see page 77).
Why? Query the status of the current queue entry.
# Edit Modify the Columbus OM file containing the current
queue entry.

Restrict SETUP Invoke built-in function chg_form: Select specific
(paper type) paper type (see page 67).
Show all SETUPS Invoke built-in function any_info: Select any server
(paper types) information (see page 65).
(printer/class) address (see page 67).
(printers/classes) address (see page 64).
wopq: Printer Operations

Enable Invoke built-in function wopq_enable: Enable print
server (see page 81). Minimum privileges: operators.
EnaAll Invoke built-in function wopq_enable_all: Enable
all print servers (see page 81). Minimum privileges:
administrators.
Disable Invoke built-in function wopq_disable: Disable
print server (see page 81). Minimum privileges:
operators.

60 CHAPTER 3
DisAll Invoke built-in function wopq_disable_all:

Disable all print servers (see page 81). Minimum
Abort Invoke built-in function wopq_abort: Abort printout
Cancel Invoke built-in function wopq_cancel: Cancel
printout (see page 80). Minimum privileges: operators.
Realign Invoke built-in function wopq_lineup: Line up
paper (see page 81). Minimum privileges: operators.
Pause Invoke built-in function wopq_pause: Pause print
server (see page 81). Minimum privileges: operators.
Resume Invoke built-in function wopq_continue: Continue
paused print server (see page 81). Minimum privileges:
operators.
Backup Invoke built-in function wopq_backup: Back up
Advance Invoke built-in function wopq_advance: Advance
Gotopage Invoke built-in function wopq_goto_page:
Reposition printout (see page 81). Minimum
Split Invoke built-in function wopq_split: Split printout
onto another print server (see page 81). Minimum
Transfer Invoke built-in function wopq_transfer: Transfer
printout to another print server (see page 82).
Class Display menu wopq1: Class Maintenance below.
Paper Display menu wopq2: Paper Maintenance on page 61.
Location Invoke built-in function wopq_setq: Change to
Monitor Display ring menu uq012: Monitor Printers on
page 56 by invoking built-in function uqo: Monitor all
print servers (see page 78). Minimum privileges:
operators.
page 80).
wopq1: Class Maintenance

Add a Printer to a Invoke built-in function wopq_create_alias: Add
Class print server to class (see page 81).

CHAPTER 3
61
Remove a Printer Invoke built-in function wopq_remove_alias:

from a Class Remove print server from class (see page 81).
List the Printers Invoke built-in function list_aliases: List print
in a Class servers in class (see page 72).
wopq2: Paper Maintenance

Add Paper Type Invoke built-in function wopq_add_paper: Mount
paper (see page 80).
Remove Paper Type Invoke built-in function wopq_rem_paper:
Unmount paper (see page 81).
Change Paper Type Invoke built-in function wopq_change_paper:
Change and line up paper (see page 80).

62 CHAPTER 3

63
CHAPTER 4
Chapter 4 Built-in functions
The uq menu interface invokes the built-in functions to perform almost all
Columbus OM control and administration tasks.
A functions on page 64

B functions on page 66
C functions on page 67
D functions on page 68

E functions on page 69

F G and H functions on page 70
I J and K functions on page 71
L functions on page 72

M functions on page 73

N functions on page 74
O P and Q functions on page 75
R functions on page 76

S functions on page 77

T U and V functions on page 78
W functions on page 79

64 CHAPTER 4
Built-in functions
A functions
A functions
abort_print: Abort printout
Invoke the opq -a command.

add_fax_server: Configure new fax server
Update files in $UNIQDIR/servers/.

add_net_server: Configure new net server

add_paper: Mount paper
Invoke the opq -m command.

add_print_server: Configure new print server

add_server: Configure new general server

add_vts_server: Configure new VTS server

addall: Allow all users access to a function
Update files in $UNIQDIR/security/. May be placed only on the System

Security menu uq010.menu.
addfq: Add entry to fax queue
Invoke the afq command.

addname: Add name to list of authorized users

addq: Add entry to print or dispatch queue
Invoke the aeq command.

advance: Advance printout
Invoke the opq -r command.

all_master_status: Show status of scheduler on all queues
Invoke the syq -s server command.

all_server_stats: Show status of all servers
Invoke the syq -as command.

any_address: Select any address
Set wliq command options to control which queue entries are listed. May be
placed only on the Search Options menu wliq3.menu.

CHAPTER 4
Built-in functions
A functions
65
any_filename: Select any filename
any_info: Select any server information
any_medium: Select any medium
any_owner: Select any owner
any_pending: Select any owner in Pending, current owner in Completed
any_status: Select any status code

66 CHAPTER 4
Built-in functions
B functions
B functions
back_up: Back up printout

browse_day_log: Browse day log
Display the contents of $UNIQDIR/servers/server/dayDD.log.

browse_err_log: Browse error log
Display the contents of $UNIQDIR/servers/server/error.log, driver.err and

output.txt.
browse_output: Browse output log
Display the contents of $UNIQDIR/servers/server/activity.log,

background.job, driver.log and output.txt.
build_rolo: Build ROLO configuration
Update files in $UNIQDIR/rolo/.

CHAPTER 4
Built-in functions
C functions
67
C functions
cancel_print: Cancel printout
Invoke the opq -c command.

change_paper: Change and lineup paper
Invoke the appropriate commands.

chg_address: Select specific address
chg_filename: Select specific filename
chg_font: Change font
Invoke the apq -f command.

chg_form: Select specific paper type
chg_hopper: Change hopper
Invoke the apq -hp command.

chg_info: Select specific server information
chg_orient: Change orientation
Invoke the apq -or command.

chg_owner: Select specific owner
chg_paper: Change paper without line up
Invoke the opq -m command.

chg_pitch: Change pitch
Invoke the apq -pt command.

continue_print: Continue paused printout

create_alias: Add print server to class
Invoke the opq -i command.

68 CHAPTER 4
Built-in functions
D functions
D functions
define_printer: Configure printer type
Update files in $UNIQDIR/media/print/.

del_server: Delete server

disable_all: Disable all print servers
Invoke the opq -d command for all printers.

disable_printer: Disable print server
Invoke the opq -d command.

dup_rolo: Duplicate ROLO configuration

dup_server: Duplicate server
Invoke the opq -o command.

CHAPTER 4
Built-in functions
E functions
69
E functions
edit_rolo: Modify ROLO configuration

enable_all: Enable all print servers
Invoke the opq -e command for all printers.

enable_printer: Enable print server
Invoke the opq -e command.

ext_complete: Extend Completed queue
Invoke the syq -ec command.

ext_pending: Extend Pending queue
Invoke the syq -ep command.

70 CHAPTER 4
Built-in functions
F G and H functions
F G and H functions
fax_shortcodes: Configure fax shortcodes
Update files in $UNIQDIR/media/fax/shortcds/.

fix_complete: Fix Completed queue
Invoke the syq -fc command.

fix_pending: Fix Pending queue
Invoke the syq -fp command.

freq_macros: Define macros for user-defined frequencies
Update $UNIQDIR/config/fmacro.tab.
goto_page: Go to specific page

hold: Put queue entry on hold
Invoke the aeq -h command.

CHAPTER 4
Built-in functions
I J and K functions
71
I J and K functions
install_rolo: Install ROLO configuration

kill_server: Kill server
Invoke the opq -k command.

72 CHAPTER 4
Built-in functions
L functions
L functions
lineup: Line up active printout
Invoke the opq -l command.

list_aliases: List print servers in class
Display information from $UNIQDIR/servers/alias.tab.

list_fax_servers: List status of all fax servers

list_printers: List status of all print servers

list_rolo: List ROLO configurations
Display information from $UNIQDIR/rolo/.

listq: List the queue
Invoke the liq command (with -ao -ap if those options are available to the
user).
listq_ao: List the queue
Invoke the liq command (with -ao if that option is available to the user).
listq_ap: List the queue
Invoke the liq command (with -ap if that option is available to the user).

CHAPTER 4
Built-in functions
M functions
73
M functions
master_status: Show status of scheduler on current queue
Invoke the syq -s server command.

mod_cshosts: Configure csuniq trusted hosts
Update $UNIQDIR/config/chosts.tab.
mod_default: Configure system defaults
Update $UNIQDIR/config/default.tab.
mod_fax_server: Configure fax server

mod_ldef: Configure serial lines

mod_net_server: Configure net server

mod_print_server: Configure print server

mod_scheduler: Configure scheduler

mod_server: Configure general server

mod_uqvars: Modify Columbus OM system variables
Update $UNIQDIR/config/uqvar.tab.
mod_vts_server: Configure VTS server

modfq: Modify fax queue entry
Invoke the afq command.

modq: Modify print or dispatch queue entry

74 CHAPTER 4
Built-in functions
N functions
N functions
net_listq: List remote queue
Obsolete.
net_run_uq: Display Columbus OM menu on remote queue
Obsolete.
net_uqo: Monitor remote queue
Obsolete.
net_wlistq: List remote queue
Obsolete.
netmaster_hosts: Configure hosts for netmaster
Update $UNIQDIR/config/nmhosts.tab.
new_medium: Impose restriction on medium
new_status: Impose restriction on status code

CHAPTER 4
Built-in functions
O P and Q functions
75
O P and Q functions
paper_types: Configure paper type
Update files in $UNIQDIR/media/paper/.

pause_print: Pause printout
Invoke the opq -p command.

printer_groups: Configure printer groups
Update files in $UNIQDIR/media/groups/.

printer_setup: Display print server configuration
Invoke the opq -q command.

purge_complete: Purge Completed queue
Invoke the syq -pc command.

purge_pending: Purge Pending queue
Invoke the syq -pp command.

queue_stats: Display queue statistics
Invoke the syq -qs command.

76 CHAPTER 4
Built-in functions
R functions
R functions
redirect: Redirect entry to another queue

release: Release HELD queue entry
Invoke the aeq -r command.

rem_medium: Lift restriction on medium
rem_paper: Unmount paper
Invoke the opq -u command.

rem_rolo: Remove ROLO configuration

rem_status: Lift restriction on status code
remall: Remove access to function from all users

remname: Remove name from list of authorized users

remote_table: Configure remote printers
Update $UNIQDIR/config/remote.tab.
remove_alias: Remove print server from class
Invoke the opq -x command.

remq: Remove entry
Invoke the req command.

remq_ao: Remove entry
Invoke the req command (with -ao if that option is available to the user).
remq_force: Remove entry
Invoke the req -f command (with -ao if that option is available to the user).
resubmit: Resubmit entry
Invoke the rsq command.

CHAPTER 4
Built-in functions
S functions
77
S functions
security_sel: Display System Security menu
Display the appropriate System Security menu uq010.menu.

server_setup: Display server configuration (any server)
Invoke the opq -q command.

server_stats: Display status of server
Invoke the syq -s command.

set_queue: Change to another Columbus OM instance
Set the -qn command option.

show_queue: Display name of current queue
Display the name of the Columbus OM instance defined by $UNIQDIR.

si_detail: Display server information for current entry
Invoke the wliq command to display queue entry information. May be placed
only on the List Queue menu wliq.ring.
split_print: Split printout onto another print server
Invoke the opq -s command.

start_all_masters: Start scheduler on all queues
Invoke the syq -i server command.

start_all_servers: Start all servers
Invoke the syq -ai command.

start_master: Start scheduler on current queue
Invoke the syq -i server command.

start_server: Start server
Invoke the syq -i command.

stop_all_masters: Stop scheduler on all queues
Invoke the syq -t server command.

stop_all_servers: Stop all servers
Invoke the syq -at command.

stop_master: Stop scheduler on current queue
Invoke the syq -t server command.

stop_server: Stop server
Invoke the syq -t command.

78 CHAPTER 4
Built-in functions
T U and V functions
T U and V functions
transfer_print: Transfer printout to another print server
Invoke the opq -t command.

uqo: Monitor all print servers
Invoke the liq command.

uqt: Monitor all fax servers
Invoke the liq command.

view_day_log: View day log by page
Display the contents of $UNIQDIR/servers/server/dayDD.log.

view_err_log: View error log by page
Display the contents of $UNIQDIR/servers/server/error.log, driver.err and

output.txt.
view_output: View output log by page
Display the contents of $UNIQDIR/servers/server/activity.log,

background.job, driver.log and output.txt.

CHAPTER 4
Built-in functions
W functions
79
W functions
wliq_addfq: Add entry to fax queue
Invoke the afq command. May be placed only on the List Queue menu
wliq.ring.
wliq_addq: Add entry to print queue
Invoke the apq command. May be placed only on the List Queue menu
wliq.ring.
wliq_error: View stderr stream for current entry
Display the contents of $UNIQDIR/queue/document/xentry_id.err. May be

placed only on the List Queue menu wliq.ring.
wliq_hold: Put current entry on hold
Invoke the aeq -h command. May be placed only on the List Queue menu
wliq.ring.
wliq_modfq: Modify current fax queue entry
Invoke the afq command. May be placed only on the List Queue menu
wliq.ring.
wliq_modq: Modify current print queue entry
Invoke the apq command. May be placed only on the List Queue menu
wliq.ring.
wliq_notify: Notify stream to continue
Invoke the opq -n command. May be placed only on the List Queue menu
wliq.ring.
wliq_options: Display Search Options menu
Display the Search Options menu wliq3.menu.

wliq_output: View stdout stream for current entry
Display the contents of $UNIQDIR/queue/document/xentry_id.out. May be

placed only on the List Queue menu wliq.ring.
wliq_redir: Redirect current entry to another queue
Invoke the aeq command. May be placed only on the List Queue menu
wliq.ring.
wliq_relq: Release current HELD entry
Invoke the aeq -r command. May be placed only on the List Queue menu
wliq.ring.
wliq_remq: Remove current entry from queue
Invoke the req command. May be placed only on the List Queue menu
wliq.ring.
wliq_resq: Resubmit current entry
Invoke the rsq command. May be placed only on the List Queue menu
wliq.ring.

80 CHAPTER 4
Built-in functions
W functions
wliq_setq: Change to another Columbus OM instance
Set the -qn command option. May be placed only on the List Queue menu
wliq.ring.
wliq_view: View document file for current entry
Invoke the browse command. May be placed only on the List Queue menu
wliq.ring.
wlistq: List the queue
Invoke the wliq command (with -ao -ap if those options are available to the
user).
wlistq_ao: List the queue
Invoke the wliq command (with -ao if that option is available to the user).
wlistq_ap: List the queue
Invoke the wliq command (with -ap if that option is available to the user).
wlistq_cl: List remote queue in client mode
Invoke the wliq command to list the remote queue in client (local) mode (with
-ao -ap if those options are available to the user).
wlistq_loc: List the client queue
Invoke the wliq command to list the client (local) queue (with -ao -ap if
those options are available to the user).
wopq: Display Printer Operations menu
Display the Printer Operations menu wopq.menu.

wopq_abort: Abort printout
Invoke the opq -a command. May be placed only on the Printer Operations
menu wopq.menu.
wopq_add_paper: Mount paper
Invoke the opq -m command. May be placed only on the Printer Operations
menu wopq.menu.
wopq_advance: Advance printout
Invoke the opq -r command. May be placed only on the Printer Operations
menu wopq.menu.
wopq_backup: Back up printout
menu wopq.menu.
wopq_cancel: Cancel printout
Invoke the opq -c command. May be placed only on the Printer Operations
menu wopq.menu.
wopq_change_paper: Change and line up paper
Invoke the appropriate commands. May be placed only on the Printer

Operations menu wopq.menu.

CHAPTER 4
Built-in functions
W functions
81
wopq_continue: Continue paused print server
menu wopq.menu.
wopq_create_alias: Add print server to class
Invoke the opq -i command. May be placed only on the Printer Operations
menu wopq.menu.
wopq_disable: Disable print server
Invoke the opq -d command. May be placed only on the Printer Operations
menu wopq.menu.
wopq_disable_all: Disable all print servers
Invoke the opq -d command for all printers. May be placed only on the
Printer Operations menu wopq.menu.
wopq_enable: Enable print server
Invoke the opq -e command. May be placed only on the Printer Operations
menu wopq.menu.
wopq_enable_all: Enable all print servers
Invoke the opq -e command for all printers. May be placed only on the
Printer Operations menu wopq.menu.
wopq_goto_page: Reposition printout
menu wopq.menu.
wopq_lineup: Line up paper
Invoke the opq -l command. May be placed only on the Printer Operations
menu wopq.menu.
wopq_pause: Pause print server
Invoke the opq -p command. May be placed only on the Printer Operations
menu wopq.menu.
wopq_rem_paper: Unmount paper
Invoke the opq -u command. May be placed only on the Printer Operations
menu wopq.menu.
wopq_remove_alias: Remove print server from class
Invoke the opq -x command. May be placed only on the Printer Operations
menu wopq.menu.
wopq_setq: Change to another Columbus OM instance
Set the -qn command option. May be placed only on the Printer Operations
menu wopq.menu.
wopq_split: Split printout onto another print server
Invoke the opq -s command. May be placed only on the Printer Operations
menu wopq.menu.

82 CHAPTER 4
Built-in functions
W functions
wopq_transfer: Transfer printout to another print server
Invoke the opq -t command. May be placed only on the Printer Operations
menu wopq.menu.

83
CHAPTER 5
Chapter 5 System files
This chapter provides definitions of the following files which are used only by the
uq menu interface (for details of general Columbus OM files, see the Technical
Reference manual):

menu.fkey: Function key assignments on page 84

menu.menu: Vertical menu definitions on page 85
menu.ring: Horizontal menu definitions on page 87
terminal_type: Source terminal definitions on page 88

terminal_type.def: Browser terminal definitions on page 89

terminal_type.ttp: Compiled terminal definitions on page 90
fkey.tab: Function key classification on page 91
report.def: Browser print specification on page 92

uqadm.menu, uqimp.menu, uqops.menu, uquser.menu on page 93

wliqsum.tab: Queue display format on page 94
wopqsum.tab: Printer status display format on page 95

84 CHAPTER 5
System files
menu.fkey: Function key assignments
menu.fkey: Function key assignments

$UNIQDIR/menus/menu.fkey defines the function keys associated with a menu.
Structure
Blank lines: significant. Comments: hash (#) at start. Continuation: none.
Content
The file contains three blocks of ten lines. The first block is used with terminals
classified as type 0 (no function keys) in $UNIQDIR/menus/fkey.tab, the second
block applies to type 1 terminals (standard ANSI function keys), and the third
block is for type 2 terminals (enhanced ANSI function keys).
A block contains exactly ten lines, giving the designations for keys F1 through F10,
where each line is either blank, or contains exactly fourteen characters. Each
14_char_string is displayed as two strings of seven characters, one above the
other; by convention, the upper string is the left-aligned key identification, and the
lower string is the right-aligned functional description.
Example
# Esc N (default)
esc 1: Help
esc 2: AutoHlp
esc 4: EditOpt
Tab: Next
Backtab Prev
esc 7: List Q
esc 8: List
esc 9: Commit
esc 0: Quit
#
# F1-F10 (ANSII)
F1: Help
F2:Auto Help
F4:EditOptions
Tab: Next
Backtab Prev
F7: List Q
F8: List
F9: Commit
F10: Quit
#
# Do/PF4 (Enhanced ANSII)
Help: Help
F7:Auto Help
F9:EditOptions
Tab: Next
Backtab Prev
F12: List Q
F13: List
Do: Commit
PF4: Quit
See also

fkey.tab: Function key classification on page 91

CHAPTER 5
System files
menu.menu: Vertical menu definitions
85

$UNIQDIR/menus/menu.menu contains the definition of a vertical menu.
The same structure is also used for another class of files:

$UNIQDIR/menus/menu.ring contains the definition of a horizontal (ring)
menu, on which the menu title is always a null string.
Structure
Blank lines: ignored. Comments: hash (#) at start. Continuation: tilde (~) at end.
Content
The file starts with a line specifying the menu title, enclosed in quotes "..." if it
contains spaces or is null. Two optional numbers give the horizontal and vertical
offsets of the first character of the first menu option, with a minimum value of 2 and
a maximum determined by the size of the menu; if the values are zero or null, the
menu is centred. This is followed by one line for each option on the menu, with
four space-separated fields.
string
The option text to be displayed on the menu, enclosed in quotes "..." if it

contains spaces.
action
The Columbus OM action invoked when this option is selected.

MEN|BIF|SHELL|COM|WINrrcc
The action type; one of:
MEN display a sub-menu.

BIF (the default) invoke a Columbus OM function. See Built-in
functions on page 63.
SHELL execute a UNIX command, then redisplay the menu.
COM execute a UNIX command, then display the message Hit any
Key to Return to Menu.
WINrrcc execute a UNIX command in a window of rr rows and cc
columns (both must be two-digit numbers), then display the
message Hit any Key to Acknowledge.
access_file
The file in $UNIQDIR/security which determines which users may access this
option; the option is not displayed for users who are not (directly or indirectly)
listed in the access_file. If omitted, or if the file is empty, all users have
access.

86 CHAPTER 5
System files
Example
"Main Menu"
"Printer Status List" list_printers BIF operators

"List the Print Queue" wlistq BIF operators
"Print a File" addq BIF operators
"Monitor Printers" uqo BIF operators
"Printer Operations" wopq BIF operators
"System Security" security_sel BIF operators
"Scheduler Management" uq011 MEN operators
"Configuration" uq013 MEN implementors
"Change Location" set_queue BIF administrators
"Queue Maintenance" uq014 MEN operators
"View Logs" uq027 MEN operators
"Quit" quit

CHAPTER 5
System files
menu.ring: Horizontal menu definitions
87
menu.ring: Horizontal menu definitions

$UNIQDIR/menus/menu.ring contains the definition of a horizontal (ring) menu.
For details of the structure of this file, see menu.menu: Vertical menu definitions
on page 85.
Note Because of the limited space available for a horizontal menu, the strings
giving the option text to be displayed on the menu should be restricted to
single-word mnemonics not longer than ten characters.

88 CHAPTER 5
System files
terminal_type: Source terminal definitions
terminal_type: Source terminal definitions

$UNIQDIR/uniform/ttp/source/terminal_type contains the definition (in source
format) of the characteristics of terminal_type terminals, for use by the uq
command which starts the menu interface.
Structure
Blank lines: ignored. Comments: characters /* at start. Continuation: none.
Content
A uq terminal definition file is divided into a number of logical blocks. Each block
starts with the keyword BEGIN, contains a related set of specification statements,
and is terminated by the keyword END. A specification statement occupies a single
line.
Example
See Creating a definition for uq on page 22.
See also

terminal_type.ttp: Compiled terminal definitions on page 90

CHAPTER 5
System files
terminal_type.def: Browser terminal definitions
89
terminal_type.def: Browser terminal definitions

$UNIQDIR/browser/terminal_type.def contains the definition of the
characteristics of terminal_type terminals, for use by the browse command.
Structure
Blank lines: ignored. Comments: hash (#) at start. Continuation: none.
Content
A browser terminal definition file is divided into a number of logical blocks. A
specification statement occupies a single line.
Example
See Creating a definition for the browser on page 29.

90 CHAPTER 5
System files
terminal_type.ttp: Compiled terminal definitions
terminal_type.ttp: Compiled terminal definitions

$UNIQDIR/uniform/ttp/terminal_type.ttp contains the compiled definition of the
characteristics of terminal_type terminals, for use by the uq command which starts
the menu interface. This is a binary file, created from the corresponding source file
$UNIQDIR/uniform/ttp/source/terminal_type with the ufct command.
See also
terminal_type: Source terminal definitions on page 88

CHAPTER 5
System files
fkey.tab: Function key classification
91
fkey.tab: Function key classification

$UNIQDIR/menus/fkey.tab classifies supported terminal types according to their
function key labelling.
Structure
Content
The file contains one line for each terminal type, with two space-separated fields:
terminal_type
The name of the terminal type, as set in $TERM or $UNIQTERM.

0|1|2
The classification of the terminal type; one of:
0 The terminal has no function keys; the equivalent functionality can be

obtained only by pressing ESC followed by a digit 1 through 0.
1 The terminal has standard ANSI function keys labelled F1 through
F10.
2 The terminal has enhanced ANSI function keys labelled Help, F7
through F13, Do and PF4.
Example
# Terminal Mapping
# -------- -------
a230 1
aixterm 1
dtterm 1
hp220 1
hpterm 1
ibm3151 1
m303 1
pt200 1
sun-cmd 1
vt100 1
vt220 1
vt420 1
xterm 1
xterm2 1
#
hp700 2
wyse60 2
See also
menu.fkey: Function key assignments on page 84

92 CHAPTER 5
System files
report.def: Browser print specification
report.def: Browser print specification

$UNIQDIR/browser/report.def contains print specification data, for use by the
browse command.
Structure
Content
The file contains five lines:
INITP ??
Defines the character sequence which when detected at the start of a file
switches into FORTRAN print mode.
RESETP
Defines the character sequence which when detected switches out of

FORTRAN print mode.
FORMFEED 1
Defines the character which when detected in column one causes a formfeed in
FORTRAN print mode.
PAGESIZE 60
The default number of lines per page; may be over-ridden by the -page option.
MAXPAGE 9999
The maximum number of pages that can be browsed. This value can be
increased if required.
Example
INITP ??
RESETP
FORMFEED 1
PAGESIZE 60
MAXPAGE 9999

CHAPTER 5
System files
uqadm.menu, uqimp.menu, uqops.menu, uquser.menu
93
uqadm.menu, uqimp.menu, uqops.menu,

uquser.menu
$UNIQDIR/menus/uqXXX.menu defines the top-level menus displayed by the uq
command. There are four such menus:
uqadm.menu for users with administrators privileges

uqimp.menu for users with implementors privileges
uqops.menu for users with operators privileges
uquser.menu for users without any of those privileges.
Structure
Content
The file contains a single line, with two space-separated fields.
menu
The name of the top-level menu for this class of user, corresponding to a
definition contained in file $UNIQDIR/menus/menu.menu.
string
The title text to be displayed at the head of the menu, enclosed in quotes "..."
if it contains spaces.
Usage
uq checks your user_id against the contents of the implementors, administrators
and operators files in $UNIQDIR/security to establish your personal level of
authorisation. The outcome of that evaluation determines:

which of the files uqimp.menu, uqadm.menu, uqops.menu and uquser.menu
defines your initial uq menu

which options to include when displaying any of the menus.
Example
uq001 "Columbus OM Implementors Menu"

94 CHAPTER 5
System files
wliqsum.tab: Queue display format
wliqsum.tab: Queue display format

$UNIQDIR/config/wliqsum.tab defines the default display format used for queue
displays in the uq menu interface, which presents each queue entry on a separate
line, divided into columns displaying the entrys attributes in the format and
sequence which you specify here. The display is generated by the wliq command,
a variant of the liq command.
For details of the structure of this file, see the definition of
$UNIQDIR/config/liqsum.tab in the Technical Reference manual.
Example
# Column Column Column Format or Trailing
# Name Title Width Justification Spaces
# ----------- ----------- ------ ------------- --------
UID Entry 5 R 1
OWNER Owner 5 L 1
NAME Document 14 L 1
PAGES Pages 5 R 1
DESTINATION Printer 10 L 1
PAPER Paper 8 L 1
DATE 'Date ' 0 'DD MON' 1
DATE 'Time ' 0 'HH:MI' 1
STATUS Status 9 L 1

CHAPTER 5
System files
wopqsum.tab: Printer status display format
95

$UNIQDIR/config/wopqsum.tab defines the default display format used for print
server displays in the uq menu interface, which presents each server on a separate
line, divided into columns displaying the servers status in the format and sequence
which you specify here. The display is generated by the wopq command, a variant
of the opq command.
Structure
Content
The file contains one line for each attribute to be displayed; the sequence of the
lines in this file determines the order of the columns across the display. Any
column which would cause the display to exceed 80 characters is silently ignored.
Each line has six space-separated fields.
attribute
The name of the attribute to be displayed in this column, listed in Displayable

attributes on page 95.
title
The text to be displayed at the head of the column, enclosed in quotes "..." if
it contains spaces. A title which is shorter than width is aligned according to
format; one which is longer than width is truncated.
width
The number of character positions occupied by this column.

format
L to left-align the attribute value within the specified width, R to right-align it.
An attribute value which is longer than width is truncated.
YES|NO
YES to update the display in Monitoring mode if a value in this column

changes; NO otherwise.
padding
The number of blank character positions between this column and the next.
The default is 1; a value of zero is permitted.
Displayable attributes
The following attributes of a print server may be selected for display. Note that you
should specify SERVER as the first column; otherwise, the system automatically
inserts such a specification of its own.
ACTIVE
Either ACTIVE or inactive.

CONFIG.name
The value of the servers configuration parameter name.

96 CHAPTER 5
System files
ENABLED
Either ENABLED or disabled.

FILENAME
The source document currently being processed.

LAST_ACTIVE
The time (hh:mm) at which the server was last active.

PAGE
The number of the page currently being printed.

SERVER
The name of the server.

STATUS
The servers current status.

UID
The unique identification number entry_id of the queue entry currently being
processed.
Example
# Column Column Column Left/ Monitor Trailing
# Name Title Width Right Column? Spaces
# ----------- --------- ------ ----- ------- --------
SERVER Printer 12 L No 1
STATUS Status 8 L Yes 1
ENABLED Enabled? 8 L Yes 1
PAGE Page 5 R Yes 1
CONFIG.PAPER Paper 10 L No 1
CONFIG.PRINTER_ID Id 26 L No 1

97
Index
B terminal_type.ttp 22, 27, 90

uqadm.menu 37, 43, 50, 93
browse command 15, 20, 89, 92
uqimp.menu 37, 43, 50, 93
brprint file 34
uqops.menu 37, 43, 50, 93
uquser.menu 37, 43, 50, 93
C wliqsum.tab 94
commands wopqsum.tab 95
browse 15, 20, 89, 92 fkey.tab file 20, 27, 84, 91
liq 94
opq 95 L
ufct 27, 90
liq command 94
uq 10, 20, 37, 43, 50, 88, 90, 93
wliq 94
wopq 95 M
.menu file 36
D menu.fkey file 84
menu.menu file 85
default.tab file 11, 34
menu.ring file 36, 87
E O
environment variables
opq command 95
TERM 10, 15, 20, 27
UF_HOME 10
UNIQTERM 10, 15, 20, 27 R
report.def file 34, 92
F
files T
brprint 34 TERM environment variable 10, 15, 20,
default.tab 11, 34 27
fkey.tab 20, 27, 84, 91 terminal_type file 22, 27, 88
menu.fkey 84 terminal_type.def file 29, 33, 89
menu.menu 36, 85 terminal_type.ttp file 22, 27, 90
menu.ring 36, 87
report.def 34, 92 U
terminal_type 22, 27, 88
UF_HOME environment variable 10
terminal_type.def 29, 33, 89

98 Index
ufct command 27, 90

UNIQTERM environment variable 10,
15, 20, 27
uq command 10, 20, 37, 43, 50, 88, 90, 93
uq menus
built-in functions 63
customizing 36
dispatch instance 37
fax instance 43
horizontal 14
print instance 50
using 10
vertical 11
uqadm.menu file 37, 43, 50, 93
uqimp.menu file 37, 43, 50, 93
uqops.menu file 37, 43, 50, 93
uquser.menu file 37, 43, 50, 93
W
wliq command 94
wliqsum.tab file 94
wopq command 95
wopqsum.tab file 95

I N T E L L I G E N T S Y S T E M S M A N A G E M E N T
www.macro4.com

Uquf

Transféré par

Informations du document

Titre original

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

Uquf

Transféré par

Droits d'auteur :

Formats disponibles

I N T E L L I G E N T S Y S T E M S M A N A G E M E N T

Columbus Output Management

UQUF-4300-00 Columbus OM 4.3

How to install Columbus OM License information

How to use the uq menu interface

How to use the uq menu interface UQUF-4300-00

About this manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Chapter 1 Using the uq menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Chapter 2 Terminal definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Chapter 3 Standard Columbus OM menu structure . . . . . . . . . . . . 35

COLUMBUS OUTPUT MANAGEMENT HOW TO USE THE UQ MENU INTERFACE

Chapter 4 Built-in functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

COLUMBUS OUTPUT MANAGEMENT HOW TO USE THE UQ MENU INTERFACE

Chapter 5 System files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

COLUMBUS OUTPUT MANAGEMENT HOW TO USE THE UQ MENU INTERFACE

COLUMBUS OUTPUT MANAGEMENT HOW TO USE THE UQ MENU INTERFACE

About this manual

The uq menu interface is available for Columbus OM running on UNIX platforms.

COLUMBUS OUTPUT MANAGEMENT HOW TO USE THE UQ MENU INTERFACE

COLUMBUS OUTPUT MANAGEMENT HOW TO USE THE UQ MENU INTERFACE

Chapter 1 Using the uq menus

The uq menu interface is a UNIX-based alternative to the command line method of

COLUMBUS OUTPUT MANAGEMENT HOW TO USE THE UQ MENU INTERFACE

Working with menus

Starting the menu interface

COLUMBUS OUTPUT MANAGEMENT HOW TO USE THE UQ MENU INTERFACE

Using vertical menus

key legends instance block

The display includes these areas:

Choosing from the menu

COLUMBUS OUTPUT MANAGEMENT HOW TO USE THE UQ MENU INTERFACE

Performing the chosen option

Selecting additional values from a list

COLUMBUS OUTPUT MANAGEMENT HOW TO USE THE UQ MENU INTERFACE

COLUMBUS OUTPUT MANAGEMENT HOW TO USE THE UQ MENU INTERFACE

Using horizontal menus

option bar monitor block

key legends display area instance block

The display includes these areas:

Choosing from the menu

COLUMBUS OUTPUT MANAGEMENT HOW TO USE THE UQ MENU INTERFACE

Working with the browser

Starting the browser

key legends display area status bar

The display includes these areas:

Using the keyboard

COLUMBUS OUTPUT MANAGEMENT HOW TO USE THE UQ MENU INTERFACE

Controlling the display

To do this Press these keys

display help text h or H

toggle the display of the Status bar w or W

cycle through the defined display sizes z or Z

refresh the display Ctrl+L

exit from the browser q or Q or Esc then 0

Moving around the document

To do this Press these keys

move the cursor down one row n or N or CursorDown

move the cursor up one row CursorUp

move the cursor right one column CursorRight

move the cursor left one column CursorLeft

scroll down by half the screen height d

scroll up by half the screen height u

scroll right by half the screen width >