Oce PRISMAproduction User manual

Océ
Océ|User Guide
Océ PRISMAproduction Server V3.02
APA-Module

Copyright Océ Printing Systems GmbH 2002, 2003, 2004
All rights reserved, including rights of translation, reprinting, reproduction by copying
or any other method.
Offenderswillbeliablefordamages.Allrights,including rightscreatedbypatentgrant
or registration of a utility model or design, are reserverd.
Delivery subject to availability; right of technical modification reserved.
All hardwware and software names used are trademarks of their respective owners.
March 2004 Edition
A29247-X2-X-8-7670
For this product we also offer seminars at
our International Training Center in Poing.
Information:
Phone [phone]
Fax [phone]
Océ Printing Systems GmbH
Postfach 1260
85581 Poing
Germany
...and Training?

Introduction
Access Rights
The PRISMAproduction Desktop
APA-Module Components
The PRISMAproduction Explore
r
Configuration
Network Functions
Print Job Manager
Command Line Interface
Linedata
More chapters->

A29247-X2-X-8-7670

Index

A29247-X2-X-8-7670

Contents
A29247-X2-X-8-7670
Contents
1 Introduction............................................................................................................1
1.1 PRISMAproduction Server V3.................................................................................1
1.2 Introduction to the APA-Module...............................................................................3
2 User ID’s and Access Rights................................................................................5
3 The PRISMAproduction Desktop .........................................................................9
3.1 Login........................................................................................................................9
3.2 Main Pop Up Menu................................................................................................10
3.2.1 Applications Used by More than One Module .............................................11
3.2.2 Available Applications for the APA-Module Functions.................................12
3.2.3 'System' menu .............................................................................................13
3.2.4 The 'Utilities' Menu ......................................................................................14
4 APA-Module Components ..................................................................................17
4.1 Introduction to the APA Processes........................................................................17
4.2 APA-Module Sample Window................................................................................18
4.3 APA Testjobs.........................................................................................................20
4.4 Import AFP Data Window......................................................................................20
4.5 Convert AFP Resources........................................................................................22
4.6 The APA-Module LU 6.2 Connection.....................................................................24
4.6.1 Introduction..................................................................................................24
4.6.2 Components of APA-Module LU 6.2............................................................26
4.6.3 LU6.2 Connection Status.............................................................................26
4.6.4 The LU 6.2Config Module............................................................................31
4.6.5 The SNA2TCP Communications Module ....................................................31
4.6.6 SNAP-IX - General Summary......................................................................32
4.6.7 Application/ Example...................................................................................33
4.6.8 Terminal Emulation......................................................................................35
4.7 Web Client.............................................................................................................39
4.7.1 Introduction..................................................................................................39

Contents
A29247-X2-X-8-7670
4.7.2 Login............................................................................................................41
4.7.3 Login as Administrator.................................................................................42
4.7.4 Administration..............................................................................................43
4.7.5 QickPrint Easy .............................................................................................45
4.7.6 QuickPrint Advanced ...................................................................................48
4.7.7 APA Print .....................................................................................................51
4.7.8 PJM in the Web ...........................................................................................53
5 PRISMAproduction Explorer ..............................................................................57
5.1 Introduction............................................................................................................57
5.2 Using the Eplorer...................................................................................................59
5.2.1 Explorer Tree...............................................................................................60
5.2.2 Application area...........................................................................................60
5.2.3 Menu bar......................................................................................................62
5.2.4 Menu ’Help’..................................................................................................62
5.2.5 Toolbar.........................................................................................................62
5.2.6 Status bar ....................................................................................................62
5.2.7 The ‘Explorer’ Menu.....................................................................................63
5.2.8 Customising the Explorer window................................................................63
5.3 Task related Workspaces ......................................................................................65
5.3.1 Workspace 'Basic Operator'.........................................................................66
5.3.2 Workspace 'Operator with Job Submission'.................................................66
5.3.3 Workspace ’Job Submission’.......................................................................66
5.4 Configuration .........................................................................................................67
5.5 Connections...........................................................................................................67
5.6 Server Files............................................................................................................69
5.6.1 Libraries.......................................................................................................69
5.6.2 Devices........................................................................................................69
5.6.3 Archives.......................................................................................................69
5.6.4 GCI/LCDS....................................................................................................70
5.7 Job Lists.................................................................................................................71
5.7.1 General........................................................................................................71
5.7.2 Authorisations for jobs .................................................................................72
5.7.3 Icons for short Information...........................................................................72
5.7.4 Column Titles...............................................................................................73
5.7.5 Job States....................................................................................................75
5.7.6 Menu Functions ...........................................................................................76
5.7.7 Filters...........................................................................................................80

Contents
A29247-X2-X-8-7670
5.7.8 Interrupt Printing..........................................................................................84
5.7.9 Job Positioning ............................................................................................85
5.7.10 Detailed status of a job................................................................................86
5.8 Servers ..................................................................................................................88
5.9 Services.................................................................................................................90
5.10 Messages ..............................................................................................................91
5.10.1 The 'Messages' Menu..................................................................................94
5.10.2 The 'View' Menu ..........................................................................................98
5.10.3 The 'Help' Menu.........................................................................................102
5.10.4 Operator Requests ....................................................................................103
5.11 Vario PJM............................................................................................................105
5.11.1 Functions of the Menu Bar/Tool Bar..........................................................105
5.11.2 Functions of the Status Bar .......................................................................105
5.11.3 Functions of the Tabs................................................................................106
5.12 PJM......................................................................................................................115
5.13 Printer Pool..........................................................................................................116
5.13.1 The 'Printer' Menu......................................................................................119
5.13.2 The 'View' Menu ........................................................................................123
5.13.3 The 'Help' Menu.........................................................................................125
5.14 LCDS Channel.....................................................................................................127
5.15 LCDS Resources Import......................................................................................128
5.16 LCDS Resources Export......................................................................................129
5.17 Print File Manager ...............................................................................................131
5.18 LU6.2...................................................................................................................131
5.19 PDC.....................................................................................................................131
5.20 OLDS-Services....................................................................................................131
5.21 Directory Viewer ..................................................................................................132
6 Configuration .....................................................................................................137
6.1 Introduction..........................................................................................................137
6.2 User Administration .............................................................................................140
6.2.1 Introduction................................................................................................140
6.2.2 Login..........................................................................................................141
6.2.3 Permission Groups ....................................................................................142
6.2.4 User Interfaces ..........................................................................................142
6.2.5 Configuration User.....................................................................................144
6.2.6 Configuration Personal Data......................................................................148
6.2.7 Configuration Permissions.........................................................................149

Contents
A29247-X2-X-8-7670
6.3 Job Queues .........................................................................................................151
6.4 Cluster .................................................................................................................151
6.5 Logging................................................................................................................153
6.6 Events..................................................................................................................154
6.7 System.................................................................................................................155
6.7.1 System parameter .....................................................................................155
6.7.2 ODS-Parameter.........................................................................................156
6.7.3 Job-Parameter...........................................................................................158
6.7.4 EMail Notification.......................................................................................159
6.8 Master/Slave........................................................................................................160
6.9 Device Configuration ...........................................................................................162
6.10 Service activation.................................................................................................163
6.11 Backup.................................................................................................................163
6.12 Library paths........................................................................................................165
6.13 Licenses...............................................................................................................166
6.13.1 Introduction................................................................................................166
6.13.2 Functions of the License Manager.............................................................166
6.14 Printer ..................................................................................................................175
6.14.1 The ‘Printer’ Menu .....................................................................................175
6.14.2 Active Notification Interface .......................................................................176
6.14.3 The ’Help’ Menu.........................................................................................178
6.14.4 Printer Overview Area................................................................................178
6.14.5 Configuring a new Printer ..........................................................................179
6.14.6 Printer Configuration Area .........................................................................180
6.14.7 General......................................................................................................181
6.14.8 Print Parameter..........................................................................................185
6.14.9 Custom specific infopages and resources for configured printers.............189
6.14.10 Job Queues ...............................................................................................190
6.14.11 Cluster .......................................................................................................190
6.14.12 Colors ........................................................................................................191
6.14.13 Input Devices.............................................................................................191
6.14.14 Output Devices ..........................................................................................192
6.14.15 Printer Active Notification Interface............................................................192
6.14.16 Grey Curves...............................................................................................194
6.14.17 Custom specific infopages and resources for configured printers.............197
6.15 Printer-Input Devices ...........................................................................................198
6.16 Paper ...................................................................................................................198

Contents
A29247-X2-X-8-7670
6.17 Toner ...................................................................................................................201
6.18 Color Verification .................................................................................................201
6.19 LP ........................................................................................................................202
6.19.1 Using PRISMAproduction LP.....................................................................202
6.19.2 Submitting a Print Job with ”lpr”.................................................................203
6.19.3 Getting Spool Queue Information with ”lpq”...............................................204
6.19.4 Cancel Print Jobs with ”lprm”.....................................................................204
6.19.5 Control Function ”lpc” ................................................................................205
6.20 Download (license dependent)............................................................................207
6.21 HotDir...................................................................................................................208
6.22 TicketRules..........................................................................................................209
7 PRISMAproduction Network Functions...........................................................213
7.1 Remote Printing Using rcmd................................................................................213
7.2 PRISMA SNMP Interface.....................................................................................216
7.2.1 Querying MIB Leaf Elements Using the Command snmpget....................224
7.2.2 Querying Multiple MIB Elements Using the Command snmpwalk.............226
7.2.3 Modifying Individual MIB Elements Using the Command snmpset ...........229
8 Print Job Manager .............................................................................................231
8.1 Introduction..........................................................................................................231
8.2 Basic Steps to submit a new Print Job with the APA-Module..............................232
8.3 Overview Main Window.......................................................................................235
8.4 The 'Ticket' Menu.................................................................................................236
8.5 ’Job Parameter’ Section.......................................................................................237
8.5.1 Jobsplitting per Job Copies........................................................................239
8.6 ’List of Files’ Section (‘Edit’ Menu).......................................................................241
8.6.1 Columntitels...............................................................................................243
8.6.2 File Selection Box......................................................................................243
8.6.3 File Formats...............................................................................................246
8.6.4 Logical Paths.............................................................................................247
8.7 ’Job Attributes’ Section ........................................................................................248
8.7.1 Messages ..................................................................................................249
8.7.2 Store output...............................................................................................250
8.7.3 Print ...........................................................................................................251
8.7.4 Header ......................................................................................................257
8.7.5 Start Job Events ........................................................................................258
8.7.6 Start Print Events.......................................................................................259

Contents
A29247-X2-X-8-7670
8.7.7 Notification.................................................................................................260
8.8 The ‘Job’ Menu ....................................................................................................261
8.9 The ‘Utilities’ menu ..............................................................................................264
8.10 Set Working Mode ...............................................................................................265
8.11 Edit File Properties with the APA-Module............................................................266
8.11.1 Resource Libraries.....................................................................................267
8.11.2 Resource File Extensions..........................................................................271
8.11.3 Resources..................................................................................................273
8.11.4 Options ......................................................................................................275
8.11.5 Custom settings.........................................................................................280
8.12 PJM in Command Line Mode ..............................................................................281
8.12.1 Calling the PJM Commandline: .................................................................282
8.12.2 Syntax Examples for Use Cases ...............................................................286
8.12.3 Return Codes.............................................................................................287
8.12.4 Description of the Océ Custom Ticket .......................................................291
9 Command Line Interface...................................................................................305
9.1 Job Editor.............................................................................................................305
9.2 Spsprt-to-JobTicket Converter ............................................................................309
9.3 Printer Administrator............................................................................................310
9.4 Message Information ...........................................................................................315
9.5 Job Queue Information ......................................................................................318
9.6 PRISMA Command Line Tools............................................................................321
10 Linedata..............................................................................................................325
Index ..............................................................................................................................329

Introduction PRISMAproduction Server V3
A29247-X2-X-8-7670 1
1 Introduction
1.1 PRISMAproduction Server V3
PRISMAproductionServer V3 is the 3rd generation of the Océ printserver for IPDS printing
systems.
Due to the following features PRISMAproduction is a high performance printer server,
which combines stability and flexibility for production printing:
• A better throughput of data allows you to connect more and faster printing systems.
• You can manage and print jobs of more than 2 gigabyte.
• An extended LINUX server operating system supports modern server technologies
such as UDMA/ATA, RAID, Pentium 4 and XEON processors.
• The combination of several servers in a network increases performance and guaran-
tees high system stability.
• SNMP assists you in monitoring an maintaining the system locally or via remote control.
• PRISMAproduction Server V3 is a modular system which allows you to combine all
available language modules in one system.
• PRISMAproduction Server V3 is also a scalable system providing print performance up
to 1000 ipm. You can enhance performance and stability by selecting from a variety of
industrial standard server models, by cross-linking servers and by the use of multi-pro-
cessor systems.
• The "Print while spooling/downloading" function enables PRISMAproduction Server V3
to start printing during the transmission of data. This function is provided for MVS Direct
and MVS Download users as well as for offline users.

PRISMAproduction Server V3 Introduction
2A29247-X2-X-8-7670
Graphical User Interface
The administration and configuration of the system is centralized in the PRISMAproduction
Explorer. This java-based graphical user interface has the following features:
• Monitoring and handling of all print jobs independent of the printer language, workflow
and interface by means of the common spool.
• Changes in the configuration are detected automatically, e.g. printers and resources
can be added dynamically to the system without restating the GUI.
• Status changes are communicated by events, i.e. no polling in monitoring components
necessary, better overall performance.
• Exact repositioning and reprinting of jobs in case of an error.
• ThePRISMAproductionExploreralso worksasastandaloneapplicationina distributed
network allowing you to realize a centralized administration of the system independant
of the physical location of the server(s).

Introduction Introduction to the APA-Module
A29247-X2-X-8-7670 3
1.2 Introduction to the APA-Module
The APA-Module provides full compatibility to the IBM AFP world. The connection to the
AFP hostsystem is realized via MVS Router Download (or alternatively via MVS Download
by IBM) or the Token Ring connection LU6.2. The LU6.2 protocol is also supported for con-
nection to an AS/400 system. Print data can also be read from 9-track tape or 18-/36-track
cartridge (IEBGENER). Tape and cartridge input supports multifile/multivolume ANSI-la-
beled media. Existing IPDS resources are transferred via IEBCOPY to the PRISMAproduc-
tion system.
The data to be printed is in the formats AFPDS (Advanced Function PrintingData Stream),
SPDS (Siemens Nixdorf Printing Data Stream) or simple linedata. It is sent to the print serv-
er station by file transfer via Ethernet or Token Ring with the TCP/IP protocol.

Introduction to the APA-Module Introduction
4A29247-X2-X-8-7670
The standard network interfaces SNMP (for remote spool control and administration) and
lp (for remote job submission) areintegrated as common components for all languagemod-
ules.
The APA-Module can be combined with other PRISMAproduction products (e.g. the POD-
Module, the LCDS-Module and the OLDS-Module) to enhance the print servers' capability
to handle different input datastreams.
This user manual describes the work with the APA-Module under the operating system
Caldera LINUX.

User ID’s and Access Rights
A29247-X2-X-8-7670 5
2 User ID’s and Access Rights
All PRISMAproduction print servers have the PRISMAproduction UI with its distinct look
andfeel.To reflectthe differentrolesofusers accessingtheprintserver,fourdifferentusers
with different access rights are automatically installed. These are:
Printer Operator operator
Application Engineer applic
System Administrator admin
Service Engineer service
You can use these userroles as a basis for indiviually configuring the user administration
in PRISMAoroduction (see chapter "User Administration" on page 140).
The Printer Operator has the most restricted access rights and has no access to the UNIX
operating system. The Service Engineer has access to everything, including the operating
system.
The user "operator” can:
• Enable and disable printers
• Interrupt and cancel print jobs
• Assign priority rights to print jobs
• Change job queues
• Display all messages and logs
• Shut down the system
• Submit predefined print jobs without modifying the print parameters
• Import print data from 9-track-tape and 18/36-track cartridge
• Enable and disable Host Download
• Enable and disable the LU6.2 host connection
• Execute shellscripts and programs made available by the administrator in a ”userscript”
director
• Change his/her own password

User ID’s and Access Rights
6A29247-X2-X-8-7670
The user "applic” has access to the same features as "operator”, and can additionally per-
form the following actions:
• Submit print jobs without restrictions
• Edit, load and save print job parameters
• Load print resources from tape/cartridge or floppy
• Administrate print resources via GUI
The user "admin” has access to the same features as "applic”, and can also perform the
following actions:
• Configure the spool parameters
• Enable and disable the spool
• Enable and disable the JCF spool
• Configure printers
• Configure the LU6.2 parameters
• Have full access to the operating system features for administrative tasks
• Work with diagnostic tools like analyze, catest and tapman
• Work with the License Manager to modify, enter and delete PRISMAproduction licens-
es.
The user "service” has access to all PRISMAproduction features and to the operating sys-
tem. This includes additional diagnostic tools and the license manager to modify, enter or
delete PRISMAproduction licenses.

User ID’s and Access Rights
A29247-X2-X-8-7670 7
Complete overview of the access rights: (x = full access, - = no access, o = read only)
login as →OPERATOR APPLIC ADMIN SERVICE
access rights ↓
Utilities:
Tapman -- -- x x
Catest -- -- x x
Account (master only) -- -- -- --
Account delete -- -- x x
Analyze -- -- x x
Calculator x x x x
Show Messages -- -- -- x
Testjobs x xxx
Terminal -- -- x x
Explorer
Licenses (change) o o x x
Printer (change) o o x x
Download (license dependent) -- -- x x
LP-In, LP-Out, HotDir -- -- x x
GCILCDS -- xxx
PJM Production
mode only xxx
APA-Module:
APA Sample x x x x
APA Test jobs x x x x
Import AFP Data x x x x
Convert AFP Resource -- x x x
LCDS-Module x x x x
LCDS Tools (collect) - - - x

User ID’s and Access Rights
8A29247-X2-X-8-7670
LCDS Copy x x x x
LCDS Convert x x x x
LCDS Sample x x x x
LCDS Samplef x x x x
LCDS Compile x x x x
LCDSCMD x xxx
LCDS Save/Restore x x x x
LCDSPrint x xxx
LCDS Resources x x x x
PRISMA+LCDS Test Jobs x x x x
PRISMA+LCDS Demo Jobs x x x x
Stockset Configuration x x x x
System x x x x
Reset x xxx
Set default window settings x x x x
Shutdown x x x x
Info x x x x
JCF Spool -- -- x x
Line Data (license dependent) -- x x x
Messages (delete) -- -- x x
Message (view) x x x x
Printer Administration x x x x
login as →OPERATOR APPLIC ADMIN SERVICE
access rights ↓