DMS Training - COM 3 Day Implementer Course Book

Macro 4 Training

Columbus Output Management 3 Day Implementer CourseTRAINING BOOK

Notice of non-responsibility about Training Book and Notice of Copyright

CopyrightCopyright 2008 Macro 4. All rights reserved. The reproduction of this document in its totality or partially is forbidden.

Notice of non-responsibilityNeither Macro 4 nor her subsidiaries, distributors, employees or agents are responsible for any loss caused for a person or a company following to an action or an absence of action resulting from information (exact or not) contained below. The death or the personal wounds are included. This opinion of nonresponsibility applies to the connected responsibilities to contracts, damages (including resulting from carelessness) or all other resulting consequences.

License information

Copyright 2008 Macro 4. All rights reserved. This publication, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. The information in this publication is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Macro 4. Macro 4 assumes no responsibility or liability for any errors or inaccuracies which may appear in this publication. Except as permitted by such license, no part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording or otherwise, without prior written permission from Macro 4.

Trademark acknowledgements

Product and company names mentioned herein may be the trademarks or registered trademarks of their respective owners.

VersionsVersion 1.0 2.0 2.1 2.2 Date Sept 07 Nov 08 Jan 09 Revisions Current Publication Major Rewrite Minor enhancements Review ad update

Columbus Output Management 3 Day Implementer CourseAims The Columbus OM (COM) suite of products is highly configurable and can be implemented in an infinite number of ways. This 3 day course is designed for technical IT staff that will be required to design and implement COM solutions. Whilst this course is based on the more common implementation and configuration options, there will be opportunities for delegates to discuss sitespecific configurations. The course is based on formal training notes and, wherever possible, presentations are supported by demonstrations and practical exercises.

Objectives On successful completion of the course, delegates will be able to: Design an outline COM solutions Install an example COM instance on a training systems Configure & test sample printer configurations from the Command line and the COM explorer interface Configure a COM distributed printing environment Undertake second line problem investigation tasks Communicate effectively with other Columbus OM Administration, Implementation and Support Staff

How to use this training book?Structure This training book is divided into chapters. Each chapter is designed to follow the order as outlined within the course agenda.

Subject pages are normally comprised of A slide and a blank zone for your notes, Glossary In addition to the definitions given throughout the course, a glossary is used to explain frequently used terms

For further information Please refer to the published documentation for Columbus OM.

TABLE OF CONTENTS

Introduction & Overview

1

Columbus OM Explorer & Basic Job Control

32

Columbus OM Core Architecture COM Installation Core Architecture - Basics Administration & Maintenance Security Overview Core Architecture - Advanced Multiple Instances Command Line Introduction Output Channels Print Channel Basics Print Channel Advanced Other Output Channels Input Gateways Additional Functions Additional Functions Web User Interface Conclusions

38 38 46 60 68 74 84 92 100 100 116 125 135 148 148 160 164

Glossary

174

Macro 4 Training

3 Day COM Implementer

Training Book

Columbus OM 3 Day Implementer Training CourseVers. 0120209

Course NotesThese course notes are designed to assist delegates of this related Macro 4 training course. Theses notes contain a copy of all the course slides used during the course and they should , as well as being a memory aid for the delegates, help provide a framework to ensure that all the required topics are covered in a logical order. Space is also provided so that delegates can make there own notes.

During the course the following icons will be used to highlight specific interest:

Valuable Information Test Your knowledge Manual Review Exercises

DMS Training (Slide 2)

1

Macro 4 Training


Training Book

Introductions Name Company Experience Current job Experience of Macro 4 products Expectation of course


Course Objectives On successful completion of the course, delegates will be able to: Design an outline COM solutions Install an example COM instance on a training systems Configure & test sample printer configurations from the Command line and the COM explorer interface Configure a COM distributed printing environment Undertake second line problem investigation tasks Communicate effectively with other Columbus OM Administration, Implementation and Support Staff


2

Macro 4 Training


Training Book

AgendaDay 1Introduction and overview Course introductionMacro 4 introduction COM Basic Overview COM Technical introduction

Day 2 ContinuedOutput ChannelsPrint Channels Basic Print Channels - Advanced Other output Channels Input Gateways

Columbus OM Explorer GUICOM Explorer Introduction

Day 3Additional FunctionsAdditional functions User Web User Interface

Columbus ArchitectureInstallation Core Architecture -basic

Day 2Administration & Maintenance Security overview Core Architecture Advanced Multiple instances Command line introduction

ConclusionImplementation Review Q&A Close


Course Logistics Fire exit Toilets Questions Start & Finish times Coffee/smoke breaks Practical exercises Software Licensed for training - do not remove Mobile Phones /Laptops Classroom Systems configurationDMS Training (Slide 6)

3

Macro 4 Training


Training Book

Practical Exercises Key component of this course Will be used to punctuate the course Reinforce the presentations Exercise sheets will be provided Use them to guide you round the system Mark exercises that you have completed Document when you have any issues, and then try to move on

Classroom systems may not match your installation Please discuss your sites configuration with the instructor/classDMS Training (Slide 7)


4

Macro 4 Training


Training Book

Macro 4 Overview


Who is Macro 4? UK Software Company since 1968 Headquarters in Crawley, England European & USA Operations Agents throughout the world


5

Macro 4 Training


Training Book

Agriculture

Automotive

Construction

Distribution

Chemicals

Energy/Oil & Gas

Finance

IT/Telcos

Manufacturing

Pharms

Retail

Others


Macro 4 Solutions Portal for Productivity Leader in Value Leader in Innovation Multi Platform Next Generation Design Application and Infrastructure

Assured Printing Document Warehouse SAP CertificationDMS Training (Slide 12)

6

Macro 4 Training


Training Book

Document Management Solutions


Macro 4s DMS Advanced Scalability From simple solutions that address: Archiving Enterprise Output Management (print) Document enabled CRM

to a complete strategy covering: Enterprise architecture for multi-channel document delivery Single repository and point of control for documents Manage print and electronic document channels Intelligent Office Printing


7

Macro 4 Training


Training Book

Document Management Key Products & FunctionsMPS CapabilityDocument Process Management Electronic Presentment

Customer Value Efficiency Self Service Compliance Confidentiality Availability Flexibility Adaptability Accountability Reliability

Archiving

Columbus

Functionality Workflow Storage Printing Accounting Monitoring

OnCall Zone Roaming Multi-Channel Accurate Billing Manage SLAs

Central DW OMAccounting

DFM


Columbus Product suite Columbus Z Mainframe print spooling and capture solutions

Columbus ADMIN Printer deployment and configuration

Columbus Central (CC) Enterprise-wide document delivery workflow

Columbus Accounting (APO) Centralised tool for accounting, planning and optimising of Columbus output solutions

Columbus Document Warehouse (CDW) Scalable archiving system allowing online viewing of actual documents by staff or customers

Columbus DFM Columbus OM WinMon

Windows print usage monitor Columbus OM DevMon

Columbus Output Management (COM) Enterprise wide output management solution

Windows Printer device monitor Columbus SPOC Single Point Of Control for Columbus Central, OM and DW

Columbus CAT Content Analysis and Transform


8

Macro 4 Training


Training Book

Our Document Management Solutions . Allow RBS to securely access large volumes of historical transactional data without the need and cost of migration. Enable VOCA (formerly BACS) process 4.5 trillion in transactions every year, including over 90% of salaries in the UK Provide over 500,000 Nationwide Building Society customers with on-line access to their statements Store 60% of all domestic UK utility bills for customer service and on-line access Provide 650,000 online payslips to employees of the Italian Government Provide over 2 million unemployed French workers with a total of 31bn in state benefits every year Enables TOTAL to inform all their global distribution outlets of changes in fuel prices within the hour Ensure critical documents are delivered in order for BMW to manufacture over 1m cars a yearDMS Training (Slide 17)


9

Macro 4 Training


Training Book

Columbus OM Basic OverviewTRAINING MODULE


Module ObjectivesThis short introduction module gives a high level overview of COMs core functionality and advantages.

By the end of this module, delegates should be able to: Explain the major function and advantages associated with using a Columbus OM solution.


10

Macro 4 Training


Training Book

Audience and Prerequisites Target audience Anybody that requires a high level overview of Columbus OM

Prerequisites None


Enterprise Output/Printing IssuesClient Client Client

Little control over who is directing what where Inconsistent job and device Administration across operating systems Inconsistent user printing interface Poor job management and tracking Poor utilisation of print assets No added datastream processing Weak or no security Weak or no accounting Weak or no user feedback of job or device status

Queue Printer

Queue Printer

Queue

Queue

Printer


11

Macro 4 Training


Training Book

Basic COM Store and Output Functionality

Pending queue Completed queue

COM instance

Production printing

Network printers

PC printers

Archive


Implementation Options Two major COM implementations COM - Critical Printing Also known as production printing Securely manages and routes business documents from business applications

COM - Intelligent Office Printing Applies controls and cost savings facilities to the Office printing environment Supported by the IOP Device Monitor solution based on DFM software Both packages are covered in separate courses


12

Macro 4 Training


Training Book

COM - IOP Key Features & Functions Unified print driver Simplified deployment & usage

Zone printing 100% service availability Roaming printing Automatic printer selection Based on business rules

Basic printing & usage reporting Based on User data Charges details Device data

IOP OnCall Printing Network card station EIP printer integration User logon Network card station

Print Policy Management(Business rules enforcement) Redirect to print room Colour enforcement Application enforcement

Confidential printing *Secure printing


COM Critical Printing offers: Consistent output/printing across operating systems Extensive job control, management and tracking Consistent device management with bi-directional device interaction Single point of control Consistent user printing Job and device user feedback

Better printer usage Consistent external datastream processing functions Security and accounting SAP integration Scaleable solution: approx. 1 to 1000 printers, 10 to 10,000 jobs Graceful legacy migration from existing print servers


13

Macro 4 Training


Training Book

COM Critical Printing - Additional Functions Secure electronic document distribution Global implementations

Manipulation of documents Document Formatting - Overlays - etc

Automatic printer selection Load balancing Zone printing for roaming workers

Accounting/statistics Printer/device status monitoring Integrates with large number of other application


COM Critical Printing - Related Products & Modules Connection products Columbus Z (VTAMPRINT) (M4CONNECT) (Reflect)

Third-party integration ERP packages SAP R/3 certified Oracle Baan PeopleSoft VIP Jetform FormScape StreamServe

(PrintManager (AS400))

Composition

Associated products (UniQPager) (UniQBatch)

Management framework products BMC PATROL HP OpenView TivoliDMS Training (Slide 28)

14

Macro 4 Training


Training Book

User/Operator AdvantagesCan include: View history & status of all documents Reprint documents directly Reprints part of document

View contents of a document Priority management Print important documents first Automatic printer selectionDMS Training (Slide 29)

Business Advantages Reduces output management costs by up to 90% Simplified support Minimising print stoppages and delays Radically reducing calls to your IT helpdesk Eliminating the cost of hardwiring systems to delivery channels

Tracks and manages all output across the enterprise From a single point of control and confirms successful delivery

Reduced paper and design costs As above, reducing reprints Overlay capability Partial reprints Reduced calls to the helpdesk

Assured safe delivery across computing platforms From any hardware platform or software application to any delivery channel Reducing reprints and computer time Right document to the right place at the right time

Highly configurable Can be tailored to resolve wide range of problems

Reporting capabilities Option to archiveDMS Training (Slide 30)

15

Macro 4 Training


Training Book

Columbus OM Implementers OverviewTRAINING MODULE


Module ObjectivesThis presentation it designed to highlight the different ways Columbus OM can be used, and provide implementers & architects with examples of how COM has been used in production environments

By the end of this module, delegates should be able to: Describe example COM implementations


16

Macro 4 Training


Training Book

Audience and Prerequisites Target audience System Architect & Delivery personnel who need understand the flexibility of the COM product.

Prerequisites A good understanding of commercial IT environments and printing Attendance of the COM Basic Overview module


Columbus OM Technical Features Enterprise spooling Input can be from large range of sources Runs on UNIX or Windows Global implementation

Multiple instances for: Scalability Distributed implementation

Polling driven Flat file configuration Highly configurable Multiple options

Input gateways Output channels Third-party optionsDMS Training (Slide 34)

17

Macro 4 Training


Training Book

Columbus OM Solution Can work straight from the box Can be tailored for specific requirements Very flexible Highly configurable

Easily integrated with other software products Facilities to use bespoke enhancements Ad hoc scripts Tailored enhancements


Implementation optionsSAP Gateways UNIX/Windows Dispatch Application Formatter PCMain frame

AS400

Novell

LPR

COM

CC

Archive

Channels Printers Fax CDW CC COM Web Pub Novell Mail SNMP Framework


18

Macro 4 Training


Training Book

Example Traditional IT Print RoomMainframe

TTY operators console

Columbus OM print servers

Production printer

Production printer


Example Global MainframeMainframe

Columbus OM

Columbus OM

Columbus OM

Columbus OM

North America

Far East

EuropeDMS Training (Slide 38)

19

Macro 4 Training


Training Book

Example Global ERP Solution

SAP/ Columbus OM Gateways

Columbus OM server

Columbus OM server

UK

Fax

Far East

Fax

Columbus OM server

Columbus OM server Fax

Americas

Europe

Fax


Example - Bulk / Critical PrintingRS6000 COMXprinter NLPD chan Xprinter XLPD chan Xprinter WLPD chan PCL, PostScript or PDF Various Xerox Docuprints

Xprinter VIP chan

TCP (single chanl)

Win 2000 VIP EmtexPrinter1 Printer2 Printer3 AFP docs IPDS Docuprints (continuous stationery) IPDS

PCL docs Shared raid disk (using Samba)


20

Macro 4 Training


Training Book

COM & Content Driven Delivery

Economy PrinterHeader Doc

COM InstancePending Queue

?Colour Printer

Delivery Message

Completd Queue

Production printer


Example - Enhanced Printing SolutionScan stations

Shared postbox Filein server Xselect


21

Macro 4 Training


Training Book

Example - Office PrintingUNIX Applications Office Printing

Windows GatewayHP Apache webserver webclient Xreqs Pages > 150 Alert Unix DCS(RedTitan Transform to PS)

Doubletake HA system

Office printersFailover

PrintroomFailover

Email

B&W printers

B&W printers

Color printer

Large Docs & Colour printingDMS Training (Slide 43)

Example IOP Installation COM IOP manages: 15 floors of office block near Canary Warf Approximately 5000+ desk places Supported by 17 Com instances driving: 6 printer hubs per floor Supporting 3-4 assorted printers per hubXerox Tektronics Also used by Citrix and SAP A4 Stapling Colour Duplex Etc

Total of approx. 300 printersDMS Training (Slide 44)

22

Macro 4 Training


Training Book

Columbus OM

Technical IntroductionTRAINING MODULE


Module ObjectivesThis mainly theoretical module is designed to introduce delegates to Columbus OM major components and terminology By the end of this module, you should be able to: Explain major COM architectural components Recognise all COM Interfaces Know how to access & reference technical documentation


23

Macro 4 Training


Training Book

Audience and Prerequisites Target audience Columbus OM Delivery and Support personnel who have had little or no exposure to Columbus OM

Prerequisites General IT Experience COM Overview course module


Columbus OM History and Naming UniQ

ColumbusD 4

Columbus Output Management(Columbus OM) (COM)


24

Macro 4 Training


Training Book

Basic Columbus OM InstanceCOM instance Pending queue

Completed queue

The COM instance is a self contained software environment consisting of Pending and completed queues code, variables, configuration information, etc.DMS Training (Slide 49)

Document Handling Capabilities By default document format is irrelevant to Columbus OM Columbus OM can accept documents in any format But it can only make sense of certain formats

Columbus OM can process: ASCII (unformatted text) PCL PDF (Adobe Acrobat document) PostScript AFP

Other formats can be converted to one of these before being passed to Columbus OM Columbus can also work with external conversion programs to convert documents as they are being processed


25

Macro 4 Training


Training Book

Multiple Instances & Remote PrintingHost 1 Instance 1

Host 2 Instance 2 Instance 3

Remote printing Local printing


Other Configurable Options High availability Input gateways Output channels Archive queues Remote printing Classes Secured delivery Status monitoring COM failover Document composition tools Dispatch pre-processor Job dependencies Security Groups Action on programs Filtering Overlays etc


26

Macro 4 Training


Training Book

Interfaces and Using Columbus OM Users & security 4 default user types User Operator Administrator Implementor Custom security possible

User interfacesCommand line UNIX menu WebClient Explorer (API/UPI) (SPOC) Completed queue Pending queue


Command Line Interface Fundamental interface to Columbus OM

Functions to: Control jobs and instance Interrogate the queues Add print requests Control processing

Able to define all Columbus OM attributes Can be used to create scripts More information later in course notes See Macro 4 documentation for full detailsDMS Training (Slide 54)

27

Macro 4 Training


Training Book

Unix Menu System Designed for ASCII

terminals

UNIX only

Command line

functions in a simple to use manner

Use uq command


COM Web Interfaces Evolving Web architectures Original COM user interface Limited functionality User interface only View own jobs and their status Resubmit/ Delete Documents Release an hold Filter view Can be tailored to site requirements Various styles Easy to implement Diagram is example only COM User interface IOP Original Virtual print room Columbus Accounting Virtual Print Room IOP (Not pure COM at present)DMS Training (Slide 56)

New user interface used for

Magik interface currently used for

28

Macro 4 Training


Training Book

Columbus OM Explorer Graphical interface across multiple instances Full admin & user functionality Inbuilt & third-party document viewer View & control Jobs Instances devices


Columbus OM Network ConnectivityCOM Explorer

Remote Instance 2 TCP/IPPorts

2006 TCP/IPPorts

Pending queue

2006

Completed queue

Instance TCP/IPPorts

Remote Instance 3 Pending queue

Pending queue

2006

Completed queue

Completed queue


29

Macro 4 Training


Training Book

Detailed information Training topics may require detailed/specific information Please use official documentation Command line help Command with h flagE.g. syq h

UNIX Menu help COM Explorer help facility Manuals Search facility

Manuals


Macro 4 COM Manuals Manuals Installation & Configuration User Guide Command Reference Technical Reference Parameter and configuration details

Please use and become familiar with these manuals while on the course Document names may change according to software version


30

Macro 4 Training


Training Book

Manuals Web Download See Macro 4 customer portal www.macro4.com/ support/download manuals Request access Complete the application form to be sent ID and password



31

Macro 4 Training


Training Book

Columbus OM Explorer & Basic Job ControlTRAINING MODULE


Module Objectives This practical module introduces delegates to Columbus OM Explorer and some of its more common user functions

By the end of this module, you should be able to: Explain features and purpose of Columbus OM Explorer Install and configure Columbus OM Explorer Use Columbus OM Explorer to submit and manage jobs


32

Macro 4 Training


Training Book


Prerequisites General IT experience Attendance of the COM Overview module Attendance of the COM Technical introduction


Columbus OM Explorer Graphical interface across multiple instances Full user functionality using document tab monitor & control their own jobs COM admin functionality Accessed from the additional advanced tab Used by Administrators & implementers to help monitor and check COM infrastructure All jobsDMS Training (Slide 66)

33

Macro 4 Training


Training Book

Installing COM Explorer Simple install Runs on most Windows PCs Click on setup.exe & follow wizard Options May change slightly with version Change default comms port Login to Explorer with current username


Starting with the Explorer Generating a new workspace Configure new workspace Specify Columbus OM hosts (host names/IP addresses) Select host/hosts for connection Refresh view if required

If prompted, log in to Columbus OM host Ordinary user or Columbus OM Administrator, etc On Windows host full domain name required e.g. sam\user 4muksrv03\iopDMS Training (Slide 68)

34

Macro 4 Training


Training Book

Using the Explorer Desktop 4 main desktop areas Context sensitive dropdown menus Context sensitive toolbar Top level view Working area Select icon for detailed view

Right click on icons to view options Drill-down operation


Generating COM job Print test job directly to COM Explorer Select print form menu or icon Select printer Select document Select medium E.g. print Fax mail

Other configuration options are available on tabs


35

Macro 4 Training


Training Book

Viewing queues and job information Options All entries or by printers

Pending and completed queues Always displays job uid Various display modes Large Icons to details

Detailed view can be configured with large amount of additional information /columns Use the View dropdown menu Tick required options Drag and drop columns to required place Change column widthDMS Training (Slide 71)

COM Job Statuses Blocked Connecting Completed Failed Held New Paused Postponed Printing Started Transferred TxStarting (Txetc) Tx


36

Macro 4 Training


Training Book

Job Controls Right click on document

Options include Release Modify Query remove


View Document Contents Click on job or select browse option 3 options for configuring the document viewer COM text viewer COM viewer External viewer

Link file extension to viewer type by Explorer View dropdown options file type


37

Macro 4 Training


Training Book

Columbus OM InstallationTRAINING MODULE

Vers 080125


Module Objectives This short modules summaries COM installation prerequisites and procedures

By the end of this module, you should be able to: Undertake a basic COM installation on a Windows systems Be able to explain the major differences required to install COM on a UNIX Operating system


38

Macro 4 Training


Training Book

Audience and Prerequisites Target audience Columbus OM Delivery

Prerequisites Attendance of the COM Overview & introduction modules Attendance of Core Architecture module


COM Instance The COM instance is a self contain software environment Can be installed on UNIX AIX HP RISC SUN Solaris (Sparc) Redhat Linux SuSe Linux Windows E.g. Windows 2000 Professional or Server, SP2 minimum processor and memory for the O/S CD Rom drive or access to FTP (UNIX) Supported network hardware Sufficient disk space; fast I/ODMS Training (Slide 78)

39

Macro 4 Training


Training Book

System Requirements Operating system Tier 1 Windows 2000 XP 2003 UNIX AIX HP RISC SUN Solaris (Sparc) Redhat Linux SuSe Linux

Tier 2 HP Titanium Sun Intel S390 Linux

Access to FTP supported network hardware Disk space allow (200MB for Source) 200 -300 MB for installation Queue space as required


Product Distribution Macro 4 Internal Requested via Pivotal Media of FTP

Ver. 4.91 Distributed with Columbus Accounting Manuals Release Notes User Interfaces Utilities Other supporting docs


40

Macro 4 Training


Training Book

Licensing COM Two Licensing Options License keys Most common licensing method Used during the course

[Macro 4 License] WARNING: unauthorised editing of this file may prevent Macro 4 products from running. [Reference Numbers] Security Device No=00000000 License Number=9 Authorisation Code=2462870360 Authorisation Confirmation=0 [Main] Licensee=Macro 4 License Commencement Date=31/03/2004 License Expiry Date=31/04/2005 Allow SoftDongle=yes [License Manager] Versions=5.0, 5.1, 5.2, 5.3 Allowed Hosts=m4uktr04 Allowed MAC Addresses=ALL others=4 Viewers=10 System Throughput RPM=60000 [Columbus OM Print] Slot Category=Others Licenses=1 Versions=4 Allowed Hosts=m4uktr04

License file License manager software Dependent on version


Windows Install overview Use ADVANCED user management to create COM Implementer With defined user characteristics Set required User Rights Assignment

Run the COM install wizard

Check/change the directory security settingsDMS Training (Slide 82)

41

Macro 4 Training


Training Book

Default Implementer Configured in Windows Procedure may vary with OS

Used to start COM Has full Columbus OM Implementer rights Control and configures COM instance Jobs Printers security

Normally created at install time Configure with User cannot change password Password never expires


Default Implementer security Settings The following Windows security rights must be set Acts as part of the operating system Log on as service

Procedure varies depending on Windows version E.g. go to: local security settings User right assignment Add user

Make sure you use fully qualified domain name and use the check name facilityDMS Training (Slide 84)

42

Macro 4 Training


Training Book

COM installation wizard Enter parameters as prompted Double click on setup.exe Select Critical Printing deployment Destination Directory (e.g. c:\macro4\com\londprint1) Instance details Instance name e.g. londprint1 uniqcs port no. e.g. 2006

License details Company name Customer number License keys

If required set the UNIQDIR variable Enter service logon details (e.g. default implementer comadmin)


Directory Security & Basic Checks Depending on the version of the Windows operating system it may be necessary to set the security on the COM instance destination directory (UNIQDIR) E.g. Locate the directory Right click on Properties Select the security tab Select the COM implementer Set all the privileges to allow

Once the install process is complete Check that your COM target directory is populatedDMS Training (Slide 86)

43

Macro 4 Training


Training Book

Windows Installation Process - Unattended Run the setup program with a r flag to create a response file e.g. Setup r

Edit %windir%\setup.iss if necessary On the target for a new installation copy the response file run e.g. setup -s -f1\setup.iss


UNIX Installation & Considerations Installation Create directories Install files Run install script Configuration tasks

Set working instance (variables) cd to instance directory Run . ./setup

Starting Columbus-OM Logon as implementer e.g. uniq # cd install_dir # . ./setup # syq -ai . . .


44

Macro 4 Training


Training Book

UNIX - lp and lpstat Columbus OM enhanced UNIX commands

Change PATH variable Put the ~/Instancename/commands directory before the operating Systems ~/bin directory



45

Macro 4 Training


Training Book

Columbus OM Core Architecture - BasicTRAINING MODULE

Version 080125DMS Training (Slide 91)

Module ObjectivesThis practical module explains how Columbus OM basically works as well as introducing delegates to some of the many optional components By the end of this module, you should be able to: Explain the major components in a COM instance Start & stop a COM Instance Understand COM servers and their basic controls Add a basic printer and perform a simple system check Configure and use a remote printer.


46

Macro 4 Training


Training Book


Prerequisites COM Overview module COM Technical introduction Knowledge of a COM interface (e.g. COM Explorer)


Columbus OM Instance The COM instance is a self contain software environment consisting of COM file structure Containing Queues COM servers Commands COM configuration files Columbus OM output channels (e.g. print servers)

O/S variables Columbus Default implementor e.g. the uniq or comadmin user Rights to control instance Used to start instance in WindowsDMS Training (Slide 94)

47

Macro 4 Training


Training Book

Simplified File Structure$UNIQDIR

programs

media config

queue

security

servers

LicenseManager

tools servers fonts commands

print paper

image

servinfo

printer1

printer2

document

printmaster

Note: File structure will contain queues and data


COM Variables (Windows)OS=Windows_NT Os2LibPath=C:\WINNT\system32\os2\dll; Path=C:\WINNT\system32;C:\WINNT;c:\UniQ\printinst10\programs\commands;;C:\PROGRA~1\E!PC PATHEXT=.COM;.EXE;.BAT;.CMD;.VBS;.VBE;.JS;.JSE;.WSF;.WSH PROCESSOR_ARCHITECTURE=x86 PROCESSOR_IDENTIFIER=x86 Family 6 Model 6 Stepping 10, GenuineIntel PROCESSOR_LEVEL=6 PROCESSOR_REVISION=060a PROMPT=$P$G SystemDrive=C: SystemRoot=C:\WINNT TEMP=C:\TEMP TMP=C:\TEMP UNIQDIR=c:\UniQ\printinst10 USERDOMAIN=ISYS USERNAME=PAF USERPROFILE=C:\WINNT\Profiles\paf windir=C:\WINNT


48

Macro 4 Training


Training Book

Basic COM InstanceHost/platform COM instance Job request uqserver Medium Pending queue Job Request Printmaster server Printer X server

Fax X Server Completed queue


Example Columbus OM ServersPrintmaster printer Fax Server uqserver netmaster statserver lpdserver print scheduler printer handler (as required) Fax Server transaction server (uniqcs receiver) network dispatcher (uniqcs transmitter) monitors printer status (optional) lpr/lpd server

N.B. There are a number of other Columbus OM servers


49

Macro 4 Training


Training Book

Other I/O ServersCOM instanceuqserver ASP server

Entry detailsLPDserver Pending queue

MediumWebserver

DCS server Filein server Dispatch Xml server Mailin server Completed queue Printmaster Mailer server Fax Server


COM ServersINPUT SERVERS Uqserver LPD server Filein server XMLserver Ftserver Mailin OUTPUT SERVERS Printmaster printer server Mailer server Asp server Webserver Fax servers (haslerfax, pfax, etc.) INFRASTRUCTURE SERVERS Netmaster Statserver Uqsfcache Status feedback cache for remote instances Uqsapcache SAP callback status caching Uqsrfcsrv SAP RFC listener OTHER SERVERS DCS Dispatch Netserver Rleserv Vtserver

File transfer colltn

Printer communication Email documents Archive server Web publishing Fax documents

Document composition server Pre-processing server (Obsolete COM networking) PostScript/PCL viewer/ conversion support Network server to simulate terminal server

NB Some servers may require specialist P.S. configurationDMS Training (Slide 100)

50

Macro 4 Training


Training Book

Default COM implementer Normally configured on each host at install time Default name of comadmin (or on older installation uniq) Used to start Columbus OM automatically

Has full Columbus OM Implementor rights Control and configure servers Configure printers Configure security Has access to the COM Explorer Advanced tabDMS Training (Slide 101)

COM Explorer Advanced Functions Requires higher COM access permission (implementor, etc) Security

Use Advanced tab on Explorer interface


51

Macro 4 Training


Training Book

Starting COM on Windows

Start COM with the relevant Windows services as preferred method See example instance opposite Also used to stop or reset instance

Owned by Initial COM Implementer Uniq comadmin IOP


Starting Columbus OM on UNIX If License Manager is installed, make sure it is started Windows service or process cr_lrm.exe

(If required, start webserver software) Start instance Logon as implementer e.g. uniq # cd install_dir (UNIX) # . ./setup (UNIX) # syq -ai . . .

Or use startup script if available

e.g. #comstartup


52

Macro 4 Training


Training Book

Columbus OM command line interface Normally used by experienced implementers See command line manual for full list and details of options

Some commands may be required if COM Explorer is not functioning You may need to change the system variable %uniqdir% to point to the right instance syq keyset - Queue and server control - used to enter new license keys


syq Command SummaryFormatsyq option System administration functions Starts/stops/monitors server processes Maintains the queues Example


53

Macro 4 Training


Training Book

Keyset command SummaryC:\Documents and Settings\paf>syq -as [SYQ Rev 4.4a Copyright (c) 2005 Macro 4] [Licence 012345T (test)] *** WARNING: Current licence for this software expires on 20 Sep 2005 C:\Documents and Settings\paf>keyset [KEYSET Rev 4.4a Copyright (c) 2005 Macro 4] [Licence 012345T (test)] System name: M4UKL012 Enter key 1: 6b4a741b Enter key 2: 255b0b5b Enter key 3: 414e1906 Enter key 4: 54055d Enter key 5: Licence name : test Licence name : test Licence number: 012345 Licence number: 12345 Keys set

U:\>keyset -q [KEYSET Rev 4.910h Copyright (c) 2008 Macro 4] [Licence 012345T (crawley491h)] System name: M4UKL056 Current software licence expires on 15 Feb 2009 Warnings will be issued from 05 Feb 2009 Licensed product: *


License manager Alternative Licensing method available in some version of COM2006 TCP/IPPorts

Host/platform COM instance uqserver Pending queue

License manager program Separate Columbus program/service Called cr_lrm.exe Same license manager as Columbus DW and Columbus Central Only one license manager per host Can be on remote host (pointer in the ~\config\default.tab)

7500

Printmaster server Completed queue

Separate location for log file (cr_lrm.log) Long lines mean you may need to scroll to right

cr_lrm

license file


54

Macro 4 Training


Training Book

License File Generated from hostname and MAC address File contents are in human readable format Default location under the LicenseManager directory File sensitive to any modification Licence file name must = License (UNIX is case-sensitive) No file name extension allowed Do not modify FTP as binary file only


Major Configuration Tables/Files default.tab systems.tab remote.tab servers.tab alias.tab eventlog.tab security.tab list of Columbus OM system options list of Columbus OM products installed list of remote printers list of selectable servers alternate printer name configure logging defines security (also groupsec)DMS Training (Slide 110)

55

Macro 4 Training


Training Book

Checking COM servers from the COM Explorer Log in with Admin rights Select the advanced tab Select servers Addition functions include Starting/stopping Modify configuration


Basic COM Output Channels

Pending queue Completed queue

COM instance

Production printing

Network printers

PC printers

Archive


56

Macro 4 Training


Training Book

Printer ConsiderationDatastreams standards ASCII text PCL PostScript Metacode AFP Printer features e.g. Paper trays Fonts Overlays PJL support

Datastream contents Control codes Text Pictures

Status feedback

Hardware interface e.g. Centronics Serial Network


Basic IOP Print processuqserverIncoming request

Medium

xmlserver

Pending QueueMedium

Printmaster server xprinter xprinter xprinter

Dispatch server

Completed Queue

Printer servers run only when required COM supports multiple types and configurations of COM printer servers IOP Level 3+4 uses the Xprinter server type in raw modeDMS Training (Slide 114)

57

Macro 4 Training


Training Book

Adding printers Printers can be added to a COM instance in a number of ways. IOP Designer IOP implementations only

Manual entry Command line with the p_mk command COM only

COM explorer COM only


Adding a basic COM printer Select add a new printer From the Printer tab Enter Printer name Select Device type tcp/ip

On the Details tab enter Printer IP address (hostname) Printer port number Configuration options Use default for basic testing


58

Macro 4 Training


Training Book

Remote Printers Printer located on other COM instances Printers must already exist on remote instance Easily configured by specifying valid Printer Name Host Name Instance Name


Columbus OM Component Summary Discrete file structure Background processes (COM servers) Configuration files (.tab) COM Commands Queues COM print servers (printer drivers) Network communications Variables (LicenseManager)


59

Macro 4 Training


Training Book

Columbus OM Administration & MaintenanceTRAINING MODULE

Version 080125


Module Objectives This module covers the practical aspects of managing a COM instance on a day to day basis and consolidates information from other course modules

By the end of this module, delegates should be able to: Undertake standard maintenance task at all levels of the product Monitor, extend and fix COM queues Configure automatic queue maintenance features Be able to make effective use of the Macro 4 Support Department


60

Macro 4 Training


Training Book

Audience and Prerequisites Target audience Primarily for Support personnel but this module may also be of interest to delivery personnel

Prerequisites COM Introduction and overview modules Knowledge of COM architecture Practical experience of work with COM with the Explorer and at the command line


Maintenance Requires higher access permission (implementor, etc) Use Advanced tab on Explorer interface Levels of maintenance Jobs and Queues COM servers Printer /printer servers Instance & System

Macro 4 Columbus Support: [email protected]


61

Macro 4 Training


Training Book

Checking jobs & queues Check all jobs on print instance for potential issues Pending Queue Completed Queue Check for problem status etc Use appropriate status fields for implementation


Queue Maintenance Pending and completed queues Can be set to be cleared down automatically

Optional Manual queue control On the Advanced tabHighlight instance name, and then select Maintenance

or Right-click instance name Statistics Extend queue Purge queue Fix queue Force Fix queue


62

Macro 4 Training


Training Book

Servers Maintenance Monitor/Start and stop server From explorer or command line Explorer view must be refreshed

Standard log files (per server) Day logs Different log file per day Log file name contains date day09.log Overwritten every month

Output log Error logs

Other log files as requested activity.log - server output log file background.job - log file recording most recent startup of server


Server Log Files COM Explorer Through COM Explorer Advanced tab Highlight instance Click Maintenance dropdown NB This is a page viewer


63

Macro 4 Training


Training Book

Server Log Files Direct Access Log files can be viewed direct under the appropriate directory/folder e.g. \uniq\printinst1\servers\day23.log


Printer Server Maintenance Standard log files(per printer) Day logs Output log Error logs

Can be viewed from COM Explorer From windows using a text editor

Other log files (as requested) driver.err - print server error log file driver.log - print server standard output messages

Also optional printer status feedback Dependent on printer capabilities SNMP, PJL, (BackChannel)


64

Macro 4 Training


Training Book

Instance Maintenance Work at O/S level Check free disk space, etc

Stop and start instance On Windows, use services


Columbus Support Details Some details may vary by country support requirements etc. Normal office hours or 24x7 support available Contact local country office (during normal office hours) Special number for contracted out of hours support Call priority and target response: 1 Critical Product or major product feature fails to. function, system down or business critical situation 2 High An intermittent problem that is not circumventable. or a serious problem that is circumventable 3 Medium An intermittent problem that is circumventable. or a problem that does not have a major impact on the Product or the user's system 4 Low - A minor usability, presentation or cosmetic problem. that does not affect the ability to use the product 2 hours 3 hours 5 hours

8 hours

Plus Professional services pre- and post-sales consultancy


65

Macro 4 Training


Training Book

Basic Helpdesk Questions Platform details Version of Columbus software being used Basic overview of the architecture how many servers and what processes are going on e.g. SAP -> ColOM instance -> DCS process -> ASP process -> ColDW system

The process/function that is being attempted - has it always worked up till now or has it never worked? An idea at what point the error or failure is seen What is happening at the time the error/problem is seen? Any logfiles or screenshots showing the error(s) Has the problem occurred after an upgrade to the product? Has the problem existed for a while or started to happen at a certain point in time?DMS Training (Slide 131)

Release cycle Consolidated release Twice a years Target dates January & June

Comprises of all All enhancements Maintenance releases Fixes

Certain features and software may be may have limited availability as a PS controlled release


66

Macro 4 Training


Training Book

Columbus OM (Uniq) Versions UniQPrint Columbus D Columbus OM

3.415 4.100 4.105

Columbus License Manager Remote printer status feedback Printing order by entry sequence option PostScript page counting and partial reprint

Columbus OM

4.2/4.3/4.4/4.5/4.6/4.7/4.8

Enhancements to printer communications Improved dispatch scripting capabilities New xprinter commands

Columbus OM

4.9

Integrated IOP install



67

Macro 4 Training


Training Book

Columbus OM Security OverviewTRAINING MODULE Version 080125


Module Objectives This module introduces delegates to the key elements of COM security

By the end of this module, delegates should be able to: Explain the power & flexibility of the COM security features Add users to the predefined administrator groups Configure a user to undertaken specific administration task (optional) Test the usergroup function (optional)


68

Macro 4 Training


Training Book


Prerequisites Knowledge of COM Architecture Practical experience of work with COM with the Explorer and at the command line


User Security Very flexible granular capabilities Several layers of operation Basic users Default COM administration groups Default COM user groups Tailored security groups Customer specified groups Assignment of individual tasks/capabilities Many possible options


69

Macro 4 Training


Training Book

Columbus OM SecurityIndividual COM functions Basic users Default COM groupsOps Admin Imp

Tailored security COM User groups /teams Client Assigned group


COM Users Logon based on normal O/S logon Uses only O/S level security No COM configuration required

Default users functions Adding documents for processing Viewing all documents in queue Displaying the contents of their documents Stopping their requests, either temporarily or permanently


70

Macro 4 Training


Training Book

COM Security configuration Can be modified in COM Explorer Com configuration files

Each function can be assigned as follows All users No Users Named user Including existing groups

Can nest groups by using & as the first character e.g. User group helpdeskgroup could contain &operators


Default Administration Groups Assign groups of Administration tasks to specified users 3 default administration groups Implementor Administrator Operators

Accessed from the security other folder in Explorer


71

Macro 4 Training


Training Book

User Groups & Teams User Group members can access and control other group members documents Often based on department structures

User teams Special form of user groups Team members can submit job as team member or as individual Often based on department structure Set up group and change global parameter in default.tab Only used from the command line It cannot be used from Columbus OM Explorer Use the o flag to submit document as team member i.e. aeq o teamname to submit job for the team to view


Printer Groups Printer Groups group and limit what is shown on a user queue display User can see only printers in their group (groups)

Printer group is a global option If the printer group option is enabled, then each printer must be defined in at least one printer group


72

Macro 4 Training


Training Book

Tailored Security Consideration Careful planning is required Need to consider long term administration implication

Capabilities Additional user groups and teams can be created Specific, individual, additional functions can be assigned to users or groups e.g. See addition views Undertake specific printer control commands Control Columbus OM servers Printer groups can be created



73

Macro 4 Training


Training Book

Columbus OM Core Architecture - AdvancedTRAINING MODULE

Vers 070813


Module Objectives This practical module provides delegates with information on how COM can be tuned and configured.

By the end of this module, delegates should: Use the command line and Explorer to change System configuration files Create and reconfigure Columbus OM servers


74

Macro 4 Training


Training Book

Audience and Prerequisites Target audience Columbus OM Delivery personnel who need to design and configure COM solutions

Prerequisites Attendance of COM introduction modules Attendance of the Technical introduction module Attendance of the basic core architecture module Have access to a working system for practical exercises


Columbus OM Instance COM file structure Containing Queues Commands COM configuration files COM servers Columbus OM print servers

Columbus administrator Default implementor Rights to control instance e.g. the uniq or comadmin user

O/S variables


75

Macro 4 Training


Training Book

Simplified File Structure$UNIQDIR

programs

media config

queue

security

servers

LicenseManager

tools servers fonts commands

print paper

image

servinfo

printer1

printer2

document

printmaster

Note: File structure will contain queues and data


COM ArchitectureCOM instanceuqserver ASP server

Entry detailsLPDserver Pending queue

MediumWebserver

DCS server Filein server Dispatch Xml server Mailin server Completed queue Printmaster Mailer server Fax Server


76

Macro 4 Training


Training Book

Queues structure$UNIQDIR\queue\ $UNIQDIR\ queue\ Pending.q2 documents directory 1 2 3 4 job header job header Completed.q2 X0000001.bd (document file) X0000002.bd (document file)

498 499 500


Queue structure COM assigns a number (the UID) to each entry Range of numbers can be configured When COM reaches the highest number, it starts again. It ensures that every entry in the instance has a different number. It does not re-use a number if original number is still in the queue.

Two or more instances can be set to different ranges The pending queue and completed queues can be indexed improves performance of accessing entries,. particularly effective when the maximum entry id number is exceeded and Columbus OM starts renumbering the entries at 1. Set Queue_Index parameter in the default.tab


77

Macro 4 Training


Training Book

Major Configuration Tables/FilesFlat Files ! systems.tab remote.tab default.tab servers.tab alias.tab config.tab list of COM installed Instances list of remote printers list of Columbus OM system options list of selectable servers alternate printer name servers parametersOne for each server Multiple options configurable directly or from Explorer

eventlog.tab security.tab

configure logging defines security (also groupsec)


default.tabParameter----------------------

Value---------------------ON 5 stdin No 5 All print uqnet "10 nj" 0 No 99999 No CSUNIQ uniqcs Yes Yes 0

Main system defaults table

%UNIQDIR%\config\default.tab

Key ParametersAuto_purge / extend Highest_UID Archive Hostname Client_mode License Manager host and port

Monitoring LIQ_Refresh AEQ_Default AEQ_Lock Priority LIQ_Entries Medium Service Auto_Purge Auto_Extend Access_Scripts Highest_UID Use_su_id Client_mode Uq_service LP_Message LP_Concat debug


78

Macro 4 Training


Training Book

Instance Configuration with Explorer System defaults can be configured in Explorer Highlight instance - View - Options - DefaultsE.g. Automatic queue control can be configured Auto purge Auto extend


systems.tab Locates other COM Instances on the same host Must be update manually

Name Print1 Print2 Batch

Directory /usr/ColumbusD /usr/Print2 / usr/UniQB

Same Yes Yes No

Type PRINT PRINT BATCH


79

Macro 4 Training


Training Book

servers.tab Lists all configured servers (printers and background processes)

syq all qualifier columns AI AT AS Initiate Terminate Display

The Master column always be set to yes for an internal server, always be no for a user-defined server. id driver ai at ------------- ----- ----- ----- -------10 11 12 13 17 18 19 printmaster uqserver netmaster netmaster printer printer printer Yes Yes Yes Yes No No No Yes Yes Yes Yes No No No as Master

name --------------- --printmaster uqserver netmaster ackmaster HPLJ5 CSysout SOLHP5

Yes Yes Yes Yes Yes Yes Yes

Yes Yes Yes Yes No No NoDMS Training (Slide 159)

COM ServersINPUT SERVERS Uqserver LPD server Filein server XMLserver Ftserver Mailin OUTPUT SERVERS Printmaster printer server Mailer server Asp server Webserver Fax servers (haslerfax, pfax, etc.) INFRASTRUCTURE SERVERS Netmaster Statserver Uqsfcache Status feedback cache for remote instances Uqsapcache SAP callback status caching Uqsrfcsrv SAP RFC listener OTHER SERVERS DCS Dispatch Netserver Rleserv Vtserver

File transfer colltn

Printer communication Email documents Archive server Web publishing Fax documents

Document composition server Pre-processing server (Obsolete COM networking) PostScript/PCL viewer/ conversion support Network server to simulate terminal server

NB Some servers may require specialist P.S. configurationDMS Training (Slide 160)

80

Macro 4 Training


Training Book

Medium All jobs are submitted with a medium type

Used to identify which jobs are for specific COM servers

Multiple medium types are available

Implementers can assign their own medium type when configuring a server


Columbus OM Server Parameters Each Columbus OM server has its own tuneable parameters Configure/tune COM server operation 1 Use the Advanced explorer view Click relevant server on desktop to view Right click and modify to change

2 Edit relevant config.tab file in servers directory Some default, predefined options Check Technical Reference manual for details of all possible option


81

Macro 4 Training


Training Book

Example config.tab# c:\uniq\londprintinst1\servers\printmaster\config.tab :

# Configuration file for server printmaster # Generated by csuniq at 14:29 on 24 June 2002 # # Key # ---------------------# Server Medium Scan_Interval Fix_Interval Port_Hold printmaster print 20 60 No No Yes Yes Yes Yes Value -------------------------------Disp? -----


Adding Server


82

Macro 4 Training


Training Book

Server defaults%UNIQDIR%\menus\.d defaults files contain parameter values used when creating a new copy printer.d netmaster.d printmaster.d uqserver.d def_defaults etc



83

Macro 4 Training


Training Book

Columbus COM Multiple InstancesTRAINING MODULE Vers 070906


Module Objectives

This module explains how COM instances can be can be configured to work together on single or multiple hosts By the end of this module delegates should be be able to: Install multiple COM instances on a single host Explain the feedback options for remote COM instances Explain high availability COM configuration options


84

Macro 4 Training


Training Book

Audience & Prerequisites Target audience: COM delivery personnel

Prerequisites COM Overview module COM Technical introduction COM Core Architecture Module COM Core Architecture - advanced


Multiple InstancesHost 1 Instance 1

Host 2 Instance 2 Instance 3

Remote printing Local printing


85

Macro 4 Training


Training Book

Multiple Instances - Single host See Manual for full details Comment out the Communications server entries in the servers.tab file for all but the first instance# Name # ---. . . # uqserver # xmlserver . . .

Id -2 5

Program ------uqserver xmlserver

AI? --Yes Yes

AT? --Yes Yes

AS? --Yes Yes

Master? ------Yes Yes

Update each instance systems.tab to specify other instances#Name Path type? Product #---------- ------------------------------------------- ----- --------F1 /usr/Columbus/fax1 Yes FAX P1 /usr/Columbus/print1 No PRINT P2 /usr/Columbus/print2 No PRINT


Columbus-OM Transfer MechanismInstance 2

Instance 1Print Server

Netmaster

remote.tab

forwards jobs from one instance to another, based on entries in the file remote.tabDMS Training (Slide 172)

86

Macro 4 Training


Training Book

remote.tab (& route.tab) Lists

All remote printers known to this instance remote locations Supports wildcards

remote.tab :Printer -------------HP5 AA* * Location ---------------------aiken:print selkirk:print1 ultra8:Columbus


Remote Printing Feedback Mechanism

Instance 1 Print serverInstance 2

Netmaster

Feedback option 1) Complete on transfer 2) Complete on trans/ process Ack 3) Status_Feedback Ack_command Status_Feedback 10


87

Macro 4 Training


Training Book

Remote Instance Feedback Configuration 4 configuration options

Transmit COM InstCOMP ON TRANS Yes No No No

Remote COM Print InstCOM ACK no Yes COM STAT 0 0 >5 Secs >5 Secs Enabled COM Comment Job completes on transfer to remote COM Job Completes with remote COM job completion Remote COM returns all job status changes Improves network usage by filtering COM messages

COMMAND FEEDBACK Uqsfcache


Job Completion Mechanisms 4 configuration for Job completion:1. Ignore status Complete on transfer To configure: sending end - Set netmaster's Complete_On_Transfer to YES. receiving end - Set the system default Status_Feedback to 0 (zero). system default - ACK_Command to NO. (This can optionally be configured on a per-printer basis)

2.

Final status - ACK/NAK mechanism To configure: sending end - Set netmaster's Complete_On_Transfer to NO at the. receiving end - Set the system default Status_Feedback to 0 (zero) at the. Set the system - default.tab ACK_Command to CSUNIQ. (This can optionally be configured on a per-printer basis)

3.

status feedback Status info returned every time job status change To configure: sending end - Set netmaster's Complete_On_Transfer to NO receiving end - system default Status_Feedback >5 five seconds System default ACK_Command is irrelevant.

4.

Status feedback with caching - uqsfcacheDMS Training (Slide 176)

88

Macro 4 Training


Training Book

uqsfcache UQ Status Feedback Cache Caches status feedback information for remote instances

Not to be confused with SAP servers Uqsapcache Uqrfcsrv (obsolete)

Status messages are saved in a cache file for Scan_Interval seconds. messages sorted superseded Messages are removed Messages for same host are bundled.

Configuration The system parameter Status_Feedback must be set with a value of 5 seconds or greater.


Multiple Netmaster Server It is possible to have multiple netmasters defined in the servers.tab. Since netmaster is single-threaded, increase through put by starting additional netmasters; they must have different names, will all talk on the port identified by the UQ_Service parameter in default.tab

old Ack_Command status method, ACK jobs would be added to the queue; netmaster parameter Process_Acks determines whether this netmaster is responsible for these ACK jobs or not. It is possible to increase throughput by restricting one netmaster to just process Acks.

ackmaster the response server; ackmaster is simply another netmaster


89

Macro 4 Training


Training Book

Columbus-OM Failover Mode

Instance 1Print Server

Instance 2

Netmaster

Instance 3

remote.tab

nmhost.tab


Columbus-OM Failover Configure nmhost.tab with original and alternate system Alternate (fail-over) hosts table Lists the alternate host, and sending parameters delivery rate compress/uncompress

# /usr/ColumbusD/config/nmhosts.tab # # # # # # # Netmaster Hosts Generated by uq at 09:57 on 25-09-2002 Key Value ---------------- -----------------------------selkirk hostB "-,-,-,aiken" "9600, compress, uncompress cf, hostC"

Tune the netmaster server for suitable retry optionsDMS Training (Slide 180)

90

Macro 4 Training


Training Book

High Availability/Clustered COM High Availability systems Automated failover High Availability /not fault tolerant Reduced system downtime (around 2 minutes) Equivalent Hot/cold standby downtime hours or days Protection depends on design not plug and play solutions specialist design will help Can require careful administration

COM is Cluster Proven, not Cluster Aware


High AvailabilityHA Cluster

Instance 2 Shared diskPrint Server

Netmaster

Instance 3remote.tab nmhost.tab


91

Macro 4 Training


Training Book

Columbus OM Command Line IntroductionTRAINING MODULE Version 080123


Module ObjectivesThis module describes a few of the key COM commands that can be used by delivery and support personnel to control and monitor a COM Instance

By the end of this module, delegates should be able to: Use COM commands to perform basic monitoring and control functions Especially Monitoring queues Submit and monitor jobs Monitor and control a COM instance

Use reference material to identify other commands and command options


92

Macro 4 Training


Training Book


Prerequisites COM Overview module COM Technical introduction COM Core Architecture Module


The Command Line Fundamental interface to Columbus OM Provides functions to: Interrogate the queues Add print requests Control processing

Able to define all Columbus OM attributes Use commands in a script See Macro 4 documentation for full details


93

Macro 4 Training


Training Book

Example Columbus OM Commands apq / aeq / lp / uniqlp liq uqwhy rsq req syq opq keyset X~ commands - Add job requests to queue - Display queues - Job status Information - Resubmit requests - Remove requests - Queue and server control - Printer server control - Check and enter licence keys - enhanced document & device functionality

Use manuals or -h flag for options and flags


apq Command summaryFormat

apq option Print specific interface to underlying aeq Adds entries to the pending queue Basic command structureCommand Add to print queue apq Source Document c:\testfile.txt Destination Printer -at hplj03

Example


94

Macro 4 Training


Training Book

uqwhy Command Query status of queue entries The uqwhy command responds with any known reason why the specified entry is not printing. Syntaxuqwhy entry_id [-QUEUE_NAME instance] [-NO_BANNER]

ExampleU:\>uqwhy 849 [UQWhy Rev 4.4b1 Copyright (c) 20 04 Macro 4] [Licence 012345 (traing)] Enquiry on entry number: 849 Entry 849 queued for printer 'classrmXeroxX'. Entry 849 has been cancelled


liq (and wliq for UNIX) Command line queue listing Customisable display (wliqsum.tab) Useful in no prompt mode for scripting Very fast liq option liq -h e.g. liq ao liq qn print2

list entries for all owners list another instance


95

Macro 4 Training


Training Book

rsq command Resubmits an existing request from the completed queue Runs with same parameters

rsq option rsq -h e.g. rsq 123

reprint entry# 123 (on hold)


req command Removes entries from the pending queue Also completed queue with -c option Force option for problem entries

req option req -h e.g. req 200-350 ao remove range, jobs for all owners


96

Macro 4 Training


Training Book

syq Command System administration functions Starts/stops server processes Maintains the queues

syq option syq -h e.g. syq -aa syq -atnw syq -as

list all active servers terminate all servers, and check


opq (wopq for UNIX) Printer operation functions Enable/disable Class management Paper management (mount/unmount) Job management (cancel/abort/split)

opq (option) opq -h e.g. opq printer1 d NOW opq printer2 a abort current job


97

Macro 4 Training


Training Book

lp command Adds entries to the pending queue Uses SVR4 standard lp command syntax Able to define limited number of Columbus OM attributes Useful where lp has been hardcoded Intercept PATH to /bin/lp with Columbus OM lp Interface to aeq Also available: uniqlp lp option lp -h e.g. lp dprinter1 uniqlp dprinter2 n3


lpstat Command(UNIX only) lp compatible queue listing Uses SVR4 standard lpstat command syntax Necessary where application polls lpstat for job status Also available: uniqlpstat$ uniqlpstat newthree-33 uniq Install.log newthree-38 uniq x0000037.bd newthree-39 uniq x0000037.bd $

priority 0 priority 5 priority 5

Dec 28 14:51 3285 bytes Jan 30 13:23 11096 bytes Jan 30 13:26 37000 bytes


98

Macro 4 Training


Training Book

Keyset command SummaryC:\Documents and Settings\paf>syq -as [SYQ Rev 4.4a Copyright (c) 2005 Macro 4] [Licence 012345T (test)] *** WARNING: Current licence for this software expires on 20 Sep 2005 C:\Documents and Settings\paf>keyset [KEYSET Rev 4.4a Copyright (c) 2005 Macro 4] [Licence 012345T (test)] System name: M4UKL012 Enter key 1: 6b4a741b Enter key 2: 255b0b5b Enter key 3: 414e1906 Enter key 4: 54055d Enter key 5: Licence name : test Licence name : test Licence number: 012345 Licence number: 12345 Keys set

U:\>keyset -q [KEYSET Rev 4.910h Copyright (c) 2008 Macro 4] [Licence 012345T (crawley491h)] System name: M4UKL056 Current software licence expires on 15 Feb 2009 Warnings will be issued from 05 Feb 2009 Licensed product: *


Advanced Printing X Commands xsearch Search the LAN for printers

xcaps Determine the printer capabilities

xselect Select best printer from pool

xreqs Analyse a document and count its pages

xmessage Send a pop-up message

xinfo Online printer monitorDMS Training (Slide 198)

99

Macro 4 Training


Training Book

xcaps command



100

Macro 4 Training


Training Book

Columbus OM Print Channel BasicTRAINING MODULE Version 080125


Module ObjectivesThis practical modules introduces the key configuration options associated with COM print channel By the end of this module delegates should be be able to: Explain the function of all COM Printer servers Install a basic network printer on to a COM instance Understand and configure the printer status feedback mechanism Understand the potential of the Xprinter server Configure & use a basic Xprinter server Configure and use a COM printer class (optional)


101

Macro 4 Training


Training Book

Audience & Prerequisites Target audience: COM Delivery and Support personnel who have had little or no exposure to Columbus OM

Prerequisites COM Overview module COM Technical introduction COM Core Architecture Module


Printer ConsiderationDatastreams standards ASCII text PCL PostScript Metacode AFP Printer features e.g. Paper trays Fonts Overlays PJL support

Datastream contents Control codes Text Pictures

Status feedback

Hardware interface e.g. Centronics Serial Network


102

Macro 4 Training


Training Book

Basic IOP Print processuqserverIncoming request

Medium

xmlserver

Pending QueueMedium

Printmaster server xprinter xprinter xprinter

Dispatch server

Completed Queue

Printer servers run only when required COM supports multiple types and configurations of COM printer servers IOP Level 3+4 uses the Xprinter server type in raw modeDMS Training (Slide 205)

Printer OperationHost/platform Columbus instance

Print request

uqserver Pending queue

Printer a server

ASCII text

PostScript Printer b server

Document

Printmaster server

PCL Printer c server

Completed queue Printer d server

ASCII text


103

Macro 4 Training


Training Book

Printer Servers Printer servers run only when required Multiple servers for the same device possible When adding printer select appropriate predefined: Device - Local printers TCP/IP - Network printer LPR/LPD - Using lpd service on printer port 515 Novell - Novell print server Command - Using non-Columbus command Modem - Modem attached printer Fax - Redirect job to fax instance XPrinter - Special printer driver


LPR/LPD Printers Configuration Set the Host Name to the name of the host on which lpd is running Set Port Number to 515 (default) Set Queue Name to the name of the print queue that is used by the lp daemon This queue name is not the name of a COM print queue On a network card, the queue name is often not obvious: common names include printer lp lpt1 the host name print (xerox 440)

Lprtest (UNIX Only) To check that you have the correct names, type at the command line: lprtest host queue If the names are correct, then the text "hello" is printedDMS Training (Slide 208)

104

Macro 4 Training


Training Book

TCP/IP Network printers Considerations Printer name Printer IP address (hostname) Printer port number Porttest command xsearch

Configuration options Multiple options, discussed later


Porttest Command Tests for responses from a range of the Printers ports suggests which port to use Format :

porttest host [range]

range is a range of port numbers to test: for example 9001 9500 If you omit this range, then Columbus OM tests port 1 to 9999. Make sure that the printer is idle. Initial message about print availability may not be accurate If the device is a printer and uses a network card, the port number is often 9100 5001. 35 515 HPLJ and Compatible IBM Minolta ? LPR/LPD port (favoured by Xerox)

The xsearch command provides a similar function


105

Macro 4 Training


Training Book

Print Server Parameters Some default, predefined options Many possible parameters Developed over many years Configurable as all COM servers 1 Edit config.tab file in servers directory 2 Click on relevant server on Explorer Sub-divided into 3 sections Configuration Action on Advanced configuration

Check Technical Reference manual for details E.g. Postscript yes /no/only


Printer Classes

Printer class = group of printers with a single name Users can print to printer class of as well as to printer Job will be allocated to next available printer in class Different to printer groups which is a security feature


106

Macro 4 Training


Training Book

Optional Printer Status

Status feedback

COM can request device & status information from tcp/ip printers Uses standard snmp calls to printers Various commands can be used to request information

Returned Information can vary greatly Dependent on printer capabilities

COM has flexible configuration methods Various status displaysDMS Training (Slide 213)

Printer Status Commands Several commands have developed over time Possible commands ncrdinfo lprinfo oceinfo Pjlinfo uqsnmpinfo Formerly snmpinfo

Kwikinfo Integrated into some COM server

Documentation will assist with Command format & Procedures

Can be run from command lines or Automatically by statserver


107

Macro 4 Training


Training Book

Example snmpinfo commandsC:\>snmpinfo 10.0.27.8 Description - IBM InfoPrint 20 2.40F Device Status - Running Status - Idle Default Input - 3 Console 1 - POWER SAVER ON Console 2 Backchannel - POWER SAVER ON

C:\>snmpinfo 10.0.27.8 backchannel POWER SAVER ON


Configuring Status Feedback Use COM Explorer or edit config.tab to set a printers Backchannel Querry_printer#

/usr/PrintD4/servers/t616_84/config.tab : # # Configuration file for server t616_84 # # Key Value Disp? # ---------------------- -------------------------------- ----# Server t616_84 No Medium print Yes Device "NETWORK 10.2.3.109 9100" Yes Attempts_Limit 24 Yes Banner_FF Yes Yes Pause_Time 30 Yes Postpone_Time 60 Yes Driver "pjlout -e" Yes Printer_Id "Lm Optra T616 in OpenSystems" Yes BackChannel "snmpinfo 10.2.3.109 backchannel" Yes . . . Query_Printer "snmpinfo 10.2.3.109" YesDMS Training (Slide 216)

108

Macro 4 Training


Training Book

BackChannel Column Configure backchannel column Explorer configuration View options

Feedback commands Basic COM uses the qwikinfo command Option to enter other commands On per printer basis


Query_Status Status display from each printer dropdown Default is the printer server status Optionally configure printer service Query_Printer option Useful for displaying multi-line snmp type display


109

Macro 4 Training


Training Book

Printer Warnings Consolidates all printer warning messages Dependent on printers BackChannel message Configurable automatic refresh Can be configured by editing backchan.tab (see extract opposite)


Xprinter OverviewPrint request Pending queueDoc analysis Progress status

Printmaster server Completed queue

xprinter server Channel config.Redirection

Accounting database

Warning banners DMS Training (Slide 220)

110

Macro 4 Training


Training Book

Xprinter Principal Functionality Enhanced printer communications Enhanced printer and job status Some channels allow: Page-by-page printing Job control PJL Job tickets handled separately from data Secure or overlapped printing Redirection of failed job

Document analysis Gets best available page count Can update Accounting database


Xprinter Considerationxprinter serverData Delivery status Printer buffer

Channel config.

Printer

xprinter server

Channel config.

Data Delivery status Printer buffer

Printer

xprinter server

Channel config.

Data Delivery status

Integ. print spools

Printer


111

Macro 4 Training


Training Book

Xprinter Channel Types Non-spooled RAW PJL XPP Data sent via RAW socket no responsibility after delivery Data sent via RAW socket + PJL for control XPP/XPP2 proprietary for data + control

Spooled SNMP XLPD NLPD WLPD Data lpr/lpd + SNMP for control (DocuCentre440) Onboard spooler uses Xerox variant of lpr/lpd (DocuSP) Onboard NPS spooler uses lpr/lpd variant (Xerox NPS) Onboard spooler use embedded Windows lpr/lpd

Subsystem VIP

Emtex VIP system configured to deliver to an IPDS printer device


Example x1 RawServer Medium Device Channel_Type x1 print "NETWORK 10.0.20.115 9100" #HP LaserJet 4000 RAW

Job is sent to printer End of story


112

Macro 4 Training


Training Book

Example x2 - SecureDevice Server Medium Channel_Type Delivery_Mode "NETWORK 10.0.20.115 9100" # HP LaserJet 4000 x2 print PJL secure

Page of job is sent Ack for that page Next page is sent, etc. Not the fastest, but secure Requires PJL protocol


Example x3 - StandardServer Medium Device 4000 Channel_Type Delivery_Mode x3 print "NETWORK 10.0.20.115 9100" # HP LaserJet PJL ""

Job is delivered Job is printed Job is acknowledged Now next job is sent PJL


113

Macro 4 Training


Training Book

Example x4 - OverlappedServer Medium Device 4000 Channel_Type Delivery_Mode x4 print "NETWORK 10.0.20.115 9100" # HP LaserJet PJL Overlapping

Jobs are sent without confirm Confirms for each before complete Fast and secure PJL


Example x5 - Overlapped with onboard queueServer Medium Device DocuCentre440 Channel_Type Hard_Queue Channel_Queue Delivery_Mode x5 print "NETWORK 10.0.26.11.9 515" # Xerox SNMP yes PRINT Overlapping

Jobs are sent without confirm Confirms for each before complete Fast and secure SNMP


114

Macro 4 Training


Training Book

Example x7 StandardServer x7 Medium print Device "NETWORK 10.0.26.9 515" #Xerox DocuTech DocuSP controller) Channel_type XLPD Hard_Queue Yes Channel_Queue Print Delivery_Mode Overlappping

Operation as per x5 Lots of variants in this style of config Check for Channel_Queue name



115

Macro 4 Training


Training Book

Columbus COM Print Channel AdvancedTRAINING MODULE


Module ObjectivesThis short module explains some of the more advanced printer configuration option By the end of this module delegates you should be be able to: Explain use the printer alias function Use the common statserver configuration options Configure and test a dummy test printer Configure advanced xprinter configuration options Explain how the Xprinter works with the COM database


116

Macro 4