Professional Documents
Culture Documents
Contents
Introduction UQCA-4500-00
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
Introduction UQCA-4500-00
CHAPTER 1
Columbus OM queues
Columbus OM stores the entries that it processes in queues. Columbus OM gives
each entry a number to identify it.
■ The pending queue contains entries that are waiting to be processed.
■
The completed queue contains entries that Columbus OM has finished
processing (whether successfully or not).
■
The archive queue contains entries that have been stored after Columbus has
finished processing them. The archive queue is optional; you can also either
delete entries or transfer them to another application, for example
Columbus DW.
Columbus OM automatically moves entries between the queues automatically.
You can also move and delete entries manually.
Managing queues
When you install Columbus OM, you have to specify the size of the queues, that is
the maximum number of entries that you want to be in a queue at once. The size of
the queues affects the disk space that they occupy; even if there are no entries in a
queue it occupies the same space as if it was full.
\usr\ColumbusOM\archive2000.Q1
\usr\ColumbusOM\archive2000.Q2
\usr\ColumbusOM\archive2000.Q3
\usr\ColumbusOM\archive2000.Q4
CHAPTER 2
PC HostA
Multiple instances on single host and shared communication service and defined in
each other’s systems table so they can talk directly to each other
Instance1
incoming requests
uniqcs uqserver talking to
instance
(port 2006) each other
HostA
Instance2
Instance1
HostA
Instance2
multiple Instance1
incoming requests addresses
for address1
uniqcs uqserver not
incoming requests (port 2006) communicating
for address2
Local host
0.0.0.0 Instance2
Single host
uniqcs1
incoming requests uqserver Instance1
(port 2006)
uniqcs2
incoming requests uqserver Instance2
(port 2007)
uqserver configuration
uqserver requires minimal configuration. uqserver should be configured to use a
communication service name. The name is is usually uniqcs, but you could choose
a different name. It must match with an entry in the services file.
HostA
incoming uniqcs1
uqserver csuniq Instance1
requests for Port 2006
HostA
netmaster
HostB
netmaster
incoming
requests for uniqcs2
HostB uqserver csuniq Instance2
Port 2007
Communication csuniq is a program used by uqserver when a remote process such as netmaster
between hosts: transfers an entry to uqserver.
csuniq csuniq needs to be specified in the system defaults for client mode and also for the
ACK_Command for individual printer configuration when status feedback is not
being used.
Account name
If you install two or more Columbus OM instances on the same host, it is
preferable that the same user account name, for example uniq, is used for owning
all the instances.
Instance names
Each instance must have a different name, for example Print01, Print02, Print03
and so on, or Sales, Accounts, Admin and so on.
Instance folders
Each instance must be installed in a different folder; the most efficient method is to
put each instance in a separate subfolder under a main Columbus OM folder.
CHAPTER 3
This chapter describes the interfaces that enable you to access Columbus OM.
Columbus OM Explorer
Columbus OM Explorer enables you to access Columbus OM instances from a
Windows computer. You can access one or more instances at once.
Columbus OM Explorer provides access to almost every Columbus OM function,
including:
■ adding, changing and deleting entries and tracking their progress
■
configuring servers and printers
■ starting and stopping servers
■
enabling, disabling, pausing and resuming printers
■ controlling security.
The security features enable you to control which of these functions can be
accessed by each user.
For more information about using Columbus OM Explorer, see the How to use
Columbus OM manual.
There are some functions that the web interface does not provide: for example, you
can not add new entries to a queue, and you can not change the configuration of
printers and servers.
uq menu interface
(Available on UNIX.)
The uq menu interface enables you to administer and operate Columbus OM from
a character-mode terminal.
For more information about configuring and using the uq menu interface, see the
How to use the uq menu interface manual.
CHAPTER 4
Standard features
A Columbus OM print instance has these features, which are common to all types
of Columbus OM instance:
■
Priority management: Jobs with a higher priority are processed before those
with a low priority.
■
Deferred processing: Jobs can be held for processing until a specified date and
time.
■
Job dependencies: The processing of a job can be made dependent on another
job; Columbus OM starts processing the second job only when the first job has
completed.
■
Event handling: Specific actions can be performed in response to events such
as jobs completing successfully, failing, or being postponed.
Local printing
Local printers are controlled by the instance to which the user is logged on and
where the job is submitted. Printers can be physically attached, or network
connected, or addressed using a modem.
Overview
1 You add an entry to Columbus OM.
2 Columbus OM puts the entry in the pending queue.
3 The pending queue is scanned at regular intervals by printmaster for entries
that are to be processed by printers that are controlled by the current instance.
4 When printmaster finds an entry, it sends the entry to the printer server that
controls the printer that you have specified.
5 The printer server sends the entry to the printer.
6 When the entry has been completed, Columbus OM moves it to the completed
queue.
incoming requests
uqserver printmaster
...
all pending entries for PrinterA
are processed by the printer
completed server which disappears when
queue entry1 printing is finished
entry2
when printed, the request is
... transferred to the completed queue
Distributed printing
A Columbus OM print instance can control printing across a network of printers
that are controlled by other Columbus OM instances. This section describes the
environment and what you need to consider to set it up.
Overview
1 A user submits an entry to Columbus OM.
2 Columbus OM adds the entry to the pending queue.
The pending queue is scanned by netmaster for entries that are to be
processed by remote printers, that is printers that are not controlled by the
current instance.
3 When netmaster finds an entry for a remote printer, it transfers it to the
instance that controls that printer.
4 When the entry arrives at the remote instance, it is picked up by that instance’s
uqserver, and the entry is processed by the instance as if it were a local entry
(see ‘Local printing’ on page 26).
Remote printing
completed entry.5678
queue entry.1234 ..(1234)
notifies the original host moves to
that the entry has completed queue
..... completed ..... after printing
For requests to remote printers, the network print scheduler netmaster scans the
queue and works out where print requests should be sent. It looks for the
destinations in remote.tab. The following diagram shows the flow of
communication between servers:
incoming requests
If status feedback has been configured, the printer program will attempt to return
entry statuses either directly or through the status feedback caching server,
uqsfcache, which caches the status feedback for efficiency reasons. If status
feedback is not configured, the printer program will queue a special entry called an
ACK or a NAK and netmaster will deliver this entry back to the originating host
when it can.
If large documents are being transferred to remote instances, the workload can be
spread by defining two or more netmaster servers. Configure each netmaster server
to process documents of specific sizes (for example, one to process documents of
100 pages or less, and one to process documents of more than 100 pages).
■
which host systems and login ids can be used for printing from ColumbusZ.
The file contains a list of host computers, and an associated list of users who can
access the print instance from that host. If the file does not exist for an instance, all
users are able to access the instance from any host.
The file does not control requests which are made directly, such as by using the apq
command.
Each instance can have its own trusted hosts file, enabling different users to access
different instances.
Setting up printers
For each printer that you want to use with Columbus OM, you must set up a
printer server. The printer server tells Columbus OM information such as where
the printer is, the formats that it can print, and how you want it to operate.
To use the same printer in different ways, you can set up two or more printer
servers to control it.
Setting up printers
To set up printers, you can use these methods:
■
automatically scan the network for printers, and create a configuration file that
can be loaded into Columbus OM.
■
manually create a configuration file for one or more printers that can be loaded
into Columbus OM
■
provide all the information manually
■
set up one or more generic printer types, and then use them as the basis for
other printers.
Printer features
Printer types
Printers defined in a Columbus OM print instance can reference a printer type as a
quick way of defining the printer attributes.
A printer type is a “family” of printers that have a common set of attributes such as
escape sequences, fonts, paper orientation, finishing, and so on. (for example, “HP
LaserJet”, “Xerox Laser” or “PostScript”). Columbus OM includes some basic
printer types that you can use, either as they are, or as the basis for your own
printer types.
CHAPTER 5
Document bundling
Document bundling collects together a number of source documents, over a period
of time, to form a new document or bundle. The source documents are submitted
as discrete dispatch tasks with the task attributes set to identify the document as a
bundle component. Once created, the bundle is added as an entry in the pending
queue.
Bundles are treated by the Columbus OM dispatch facility as documents in their
own right and may be processed in the same manner as any other document entry
in the queue. Actions may be applied to the bundle to print the document, either in
its complete state or split into different views. Once all actions are complete, the
bundle entry is passed to the completed queue.
Document splitting
Document splitting extracts predefined sections or views from a specified
document without affecting the original document. Document splitting may be
applied to any pending dispatch task, including document bundles.
A view is defined by page numbers, or by the appearance of a specified text pattern
at a particular location in the document. A view could be a single page or the whole
document. Multiple views can overlap.
Document dispatch
The dispatch of a document is performed by executing a command, most
commonly printing it. The method of printing is determined by the dispatch server,
which you can customize. The method may be a call to a Columbus OM print
instance, or other print-management utility, or to the UNIX lp command.
Other available functions include:
■ Ensure that all documents printed by a department are printed on a printer in
that department.
■
Redirect documents sent to a printer that is out of order to a different printer.
■
Put long documents on hold so that other documents can be printed first.
■
Check the text of the document and act according to whether it is correct or
not.
Overview
You add a document to the queue, with its medium set to dispatch.
The queue is monitor for entries by the dispatch server. When it finds one, it
applies the rules to the entry, for example, to create a bundle, or to split the
document.
It can also change the medium of the entry, and put it back in the queue for further
processing. For example, it could extract a page, change the medium to PRINT,
and then put the entry back in the pending queue as a “new” entry, which will this
time be processed by the server that is set up to handle “PRINT” entries (that is,
usually printmaster).
DISPATCH queue
Source
documents Pending entries
pending entries: completed
in a folder entries
submitted to Entries
queue marked for
bundling
completed
bundle being entries completed
built bundle
document
original
for splitting
document
Printer
or Print
management
Split documents
utility
CHAPTER 6
This section describes how to use other output channels that are included with
Columbus OM:
■
‘Faxing documents with Columbus OM’ on page 40
■
‘Using Columbus OM to email documents’ on page 44
■
‘Webpublishing documents with the Columbus OM webserver’ on page 45
Sending faxes
To send a fax, you prepare the document and submit to Columbus OM in the same
way as a document for printing.
Enhancing documents
You can add these enhancements to faxed documents:
■ Coversheets (a standard single page that may contain information such as the
name of the recipient) can be added at the front of each document.
■ Banner lines, including information such as your company name, fax number,
and the current date and time, can be added to the top of each page.
■ Overlay graphics can be superimposed on transmitted pages. Each graphic
design is held in its own file in T4 fax format.
■
Graphics such as logos or signatures can be embedded in the message text.
■
A confirmation copy of every outgoing fax can be printed automatically.
■
Insert line numbers, change the margins, and change the fonts.
Fax features
■ Automatically redirect documents alternative fax numbers.
■
Prevent specific numbers from being used.
■ Define shortform numbers.
■
Least-cost faxing to transfer documents to a Columbus OM fax instance closer
to the destination fax number before transmission (for example, a fax for an
overseas fax number could first be transferred to a Columbus OM fax instance
in the destination country, and then transmitted.
■ Industry-standard automatic retry sequence, if the document cannot be
transmitted immediately (for example, if the destination is engaged, or the
connection breaks in mid-transmission).
Receiving faxes
Incoming faxes are placed in the fax instance’s queue and then distributed to
appropriate recipients, or actioned in other ways, such as printed.
■
Documents received can be converted from the fax format that the modem
handles (usually T4) to a format that is suitable for viewing.
■
Documents can be automatically distribution distributed to the recipient.
■ Automatic printing of received documents.
user input
host
outgoing fax
user
document
interface
files
uqserver
fax modem
faxmaster: fax
fax
fax server
management telephone
queue
server for
system
incoming
fax
faxes
server
fax modem
faxprint:
incoming fax
fax print
document files
server
print output
netmaster netmaster
uqserver uqserver
This configuration enables faxes to be sent from SAP R/3, which can interface with
a Columbus OM print instance. (A Columbus OM fax instance cannot interact
directly with SAP R/3.) A document is submitted to SAP R/3; SAP R/3 transfers
the document to the print instance; and then the print instance transfers the
document to the fax instance.
The fax instance process the fax, and then returns the status to the print instance so
the sender can see what has happened.
entry
HostA transferred HostB
telephone system
to fax fax modem
instance
print fax
instance instance
status status
returned
Server Modem
Overview
The email facility is designed to be used to process bulk document delivery using
the Columbus OM command line interface, for example, to send a document to a
mailing list of email addresses.
The basic components of the Columbus OM email facility are:
■
The ability to send messages to multiple addresses.
■ The ability to send multiple attachments.
■
The ability to monitor the progress of the message using the standard
Columbus OM queue monitoring facilities.
user
application
email + attachments)
print
queue
mail
mailer server
completed
queue
www
The mailer server monitors the queue for entries whose medium is mail, and then
submits these entries to the mail server (for example, Microsoft Exchange) for
delivery.
Overview
This suite of programs consists of two main components: the webserver and the
Web Channel.
■
The webserver detects documents that are submitted to the Columbus OM
queue with their medium set to WEB. It copies the document to a central area.
It can optionally send an email message to selected users, to notify them that
the document is available for viewing.
■ The Web Channel is used to navigate to the central area, where the user can
examine the contents of the directory and display documents they are
interested in. The Web Channel can be accessed from any web browser such as
Microsoft Internet Explorer.
In addition to posting the documents as they are, the contents can be converted to a
different format.
SMTP mail
CHAPTER 7
This section describes some of the methods by which you can monitor the status of
the components of the Columbus OM system. See:
■
‘Recording events’ on page 48
■
‘Responding to actions’ on page 48
Recording events
Information about events (for example, starting a server or adding a new one) can
be recorded for subsequent viewing and analysis.
The information can be either recorded in a file, or broadcast as SNMP (Simple
Network Management Protocol) traps for collection by another application.
Responding to actions
You can specify operating system commands to be issued when a certain action is
taken or detected by a server program.
For example, you can configure a print server to issue a command when it starts
printing a document like this:
echo Printing document %UID at %TIME
To use this feature, use the servers’ Action_On parameters.
CHAPTER 8
Chapter 8 Security
To ensure that users can access only the functions and data that they are authorized
for, Columbus OM includes extensive security features that can be implemented at
different levels. See:
■
‘First level security’ on page 50
■ ‘Controlling access to Columbus OM functions’ on page 51
■
‘Authorized user groups’ on page 52
■ ‘Group security for printers’ on page 53
■
‘Document and destination security’ on page 53
■
If there is no control file for a function, no one can use the function.
■
If the file exists but it is empty, everyone can use the function.
■
If the file exists and it contains a list of users, only the users who are in the list
can use the function.
For more information, see the Technical Reference.
Co-operative working
Entries submitted to the queue by a user are owned by the user group of which the
user is a member. This means that any member of the user group can control the
entry, for example to change its properties or delete it.
Teams
Teams are a special form of user group. Team members can treat only their own
entries and entries belonging to the team as their own, they cannot treat entries
belonging to other members of the team as their own.
Fred
Rick
Sam Entry owned by Sam
this one seen
only by Sam
In this example, Fred, Rick, and Sam can see entries for team Accts, but only Sam
can see entries owned by herself. You must choose between using user groups or
using teams: they cannot be used together on the same instance.
CHAPTER 9
Print from
Windows: Columbus OM
Windows Explorer
TCP/IP Gateway
IPX/SPX LAN
Windows host
Print command
Windows host
myfile
dummy
network
printer
TCP/IP
host PC
PC Printer Windows
Columbus OM
Channel Print Manager
PC printer
A user submits a job for printing in Columbus OM. Columbus OM transfers the
data to the PC Printer Channel on the PC by using a TCP/IP connection. When
the data has been transferred, Windows Print Manager is invoked to service the
print request, and the job is recorded as “Completed” in Columbus OM.
As well as TCP/IP access, you can also define LPD/LPR access to a printer. A print
server needs to be defined in Columbus OM relating to each PC printer that is to
be accessed.
Two or more printers that are attached to the same PC can be managed by
installing a PC Printer Channel to control each one.
host
Columbus OM
TCP/IP
NetWare
server Columbus OM
Novell Gateway
IPX/SPX
Novell
PC
Netware Netware
printer printer
ColumbusZ
If the connection is made with VTAM/SNA using APPC LU6.2 then the
OPEN SNA interface is required as shown in this diagram:
ColumbusZ
SNA APPC
communications TCP/IP Columbus OM
LU6.2
server OPEN SNA
(COMMSERV) interface
The OPEN SNA interface converts SNA addresses to IP addresses and vice versa.
OPEN SNA can send to more than one Columbus OM print instance but can
communicate with only one ColumbusZ instance. If you need to communicate with
more than one, then install another copy of OPEN SNA.
Users can:
■
submit print requests directly from Columbus OM to ColumbusZ
■ direct print requests from ColumbusZ to a Columbus OM printer. Where
multiple Columbus OM print instances are interconnected, reports can be
routed to other instances using Columbus OM’s distributed printing facility.
Format conversion
Data transferred from ColumbusZ to a Columbus OM print instance is converted
from EBCDIC to ASCII, so that it can be interpreted by the network printers. Data
transferred from Columbus OM to ColumbusZ can be converted from ASCII to
EBCDIC by the communications server COMMSERV.
If the Columbus OM print instance cannot find a matching printer, it can try other
instances for a suitable printer where distributed printing has been set up.
SAP R/3
lp command
emulation
Columbus OM
printers defined as
access method ‘L’ in R/3
Access method ‘L’ uses lp and lpstat command line integration using
Columbus OM’s lp and lpstat emulation.
■
Each printer known to R/3 must be configured as access method ‘L’ device in
R/3.
■ Columbus OM lp command must be specified as the R/3 print command.
When submitting a print job from R/3, the Columbus OM lp command is issued.
When R/3 needs to enquire on the status of a job, it issues an lpstat command.
Job submission R/3 attributes such as title and R/3 owner are supported.
Attributes are mapped onto the most appropriate
Columbus OM Explorer attribute.
Job tracking Print jobs can be tracked from within R/3. All information
regarding a print job’s status is reported back to R/3.
Device status The current status of a Columbus OM print device can be
displayed from within R/3.
SAP/R3
Columbus
OM SAP
logical logical logical
command
OMS OMS OMS printers defined
definitions
as access method
‘E’ in R/3
ftserver
create a file
document
file
Oracle printer
Financials configuration
feature
As well as using the methods described above, Oracle Financials also contains a
printer configuration feature that can be modified to pass reports to
Columbus OM.
datastream generator
application
datastreams
DCS
queue
server
datastream processing
application
datastreams split and formatted
How it works
Datastream input requires special handling in Columbus OM. For each datastream
input, a master entry is added to the queue. This entry is detected by
Columbus OM’s Document Composition Server (DCS) as it monitors the queue.
The DCS passes the datastream to the external application, where it is formatted
and split into individual documents, called child entries. These are then submitted
to the Columbus OM print queue and processed as normal documents.
The progress of each master entry and its associated child entries is monitored and
its status is returned to Columbus OM, and to the originating datastream generator
application.
Columbus OM
How it works
Each queue entry that is marked for archiving is detected by Columbus OM’s
Archive Server Process (ASP) as it monitors the queue. It then passes the associated
document to the file archiving application. It ignores entries for remote queues
because these are transferred using netmaster to their appropriate destination.
The progress of each entry is monitored and status feedback is returned to
Columbus OM.
Index
A Columbus OM WebClient 21
security 50
access control file 51
Columbus OM Windows Gateway 58
accessing Columbus OM 19
ColumbusD Transfer 61
security 49, 50
ColumbusZ
account names 17
description 55
ACK signals 16
integration with 61
acknowledgement signals 16
security 30
administrators
command line interface 22
adding 52
overview 22
user groups 52
security 50
archive queue 9
communication between instances 16
managing 9
communication service 17
area description files 38
completed queue 9
managing 9
B connecting to printers 32
BackChannel commands 33 cross-platform printing 61
banner pages 34 cshosts.tab file (trusted hosts) 29
bundling documents 36 csuniq program 17
C D
Columbus Central 57 data warehousing 59
Columbus DW datastream processing applications
integration with 59 integration with 65
Columbus OM dcs servers 66
accessing 19 deferred processing 24
configuration 7 destination security 53
integration with ColumbusZ 61 disk storage space 10
Columbus OM Explorer dispatch features
description 20 overview 35
overview 20 dispatch instances
security 50 area description files 38
Columbus OM Novell Gateway 55 overview 37
integration with 60 rules files 38
Columbus OM PC Printer Channel dispatch servers 36
integration with 58 multiple 35
overview 35 instances
using 35 accessing 12
dispatching documents 36 communication between 16
distributed printing 27 multiple 8, 13
document composition servers 66 names 18
document formats 24 single 8, 12
converting 34 integration with other applications 55
fax instances 40 Macro 4 applications 57
document handling 24, 36 SAP R/3 63
document operations third-party applications 63
bundling 36 interfaces 19
dispatch 36
splitting 36 J
document security 53
job dependencies 24
documents
validating 34
L
E landscape to portrait 34
least-cost faxing 40
electronic forms flashing 34
using SAP R/3 64
email messages 44
local printing 26
sending 44
lpdserver server 25
event handling 24
event logging 48
M
F Macro 4 applications
integrating with 57
failover system 29
mail messages 44
fax instances
mailer server
communicating with other instances
42 overview 44
overview 40, 41 multiple folders
servers 43 account names 17
faxing documents 40 locations 18
file archiving applications multiple instances 13
integration with 66 security 30
filters 34
font size N
changing 34 NAK signals 16
forms for documents 34 names
ftserver server 25 instances 18
netmaster server
G description 18
group security for printers 53 netmaster servers 18
network communications 17
between hosts 17
H between hosts and PCs 17
haslerfx server 43 port numbers 17
hosts non-acknowledgement signals 16
access 50 Novell Netware printers 60
multiple host system 17
O
I operators user group 52
implementors Oracle
user group 52 integration with 65
input filters for printing files 34 overlays for documents 34
P S
paper types 32 SAP R/3
passwords 50 access methods 63
pending queue 9 datastream processing 65
managing 9 integration 63
pfax server 43 least-cost faxing 64
PJL (printer job language) sending faxes 43
status information 33 security 49
port numbers access to functions 51
choosing 17 documents 53
portrait to landscape 34 hosts 50
PostScript printers levels 52
printing plain text 34 operating system level 50
preprinted stationery 32, 34 printers 53
print instances 23 trusted hosts and users 29
overview 23 user groups 52
security 50 user interfaces 50
printer classes 34 sending faxes 40
printer servers 25, 31 process 41
printer types 32 servers
printers ftserver 25
connection types 32 haslerfx 43
defining 31 lpdserver 25
directly connected 58 pfax 43
group security 53 printer 25
overview 26 printmaster 25
paper types 32 statserver 25
printer types 32 xprinter 25
status information 33 SFCache server 27
printmaster servers 25, 26 single instance 12
priority management 24 SNMP integration 33
privileges 52 for printer status information 33
special stationery 32
Q splitting of documents 36
statistical data logging 48
queues
statserver 25
managing 9
statserver servers 33
overview 9
status feedback mechanism 27
status information 33
R StreamServe 65
receiving faxes 41 system examples 8
process 42 system security 52
remote hosts 29 systems.tab file 13
remote printers list 29
remote printing 28 T
remote.tab file 28
teams 52
resource sharing 13
trusted hosts
rotate filter program 34
description 29
route definitions list 29
TTY interface 22
rules (dispatch server)
description 35
rules files 38 U
uniqcs 12, 16
UniQLaser
integration with 61
UNIX
menu interface See uq menu interface
security 50
uq menu interface
description 22
security 50
uqserver 12
shared 13
uqserver servers
communication between instances 16
configuration 16
shared 14
uqsfcache server 28
user groups 52
privileged groups 52
teams 52
user interfaces 19
security 50
users
types of 52
W
web browser interface 21
Web Channel
description 45
functionality 45
WebClient 21
webserver
description 45
functionality 45
Windows
interfaces 20
printers 58
security 50
X
xprinter
configuration parameters 25
www.macro4.com