Ricoh InfoPrint Pro C900AFP User manual

InfoPrint Manager for AIX
Procedures
Version 4 Release 3
G550-1066-04

InfoPrint Manager for AIX
Procedures
Version 4 Release 3
G550-1066-04

Note:
Before using this information and the product it supports, read the information in “Notices” on
page 365.
Fifth edition (September 2010)
This edition applies to InfoPrint Manager for AIX, Version 4 Release 3 Modification 0 with PTF U100003 and to all
subsequent releases and modifications until otherwise indicated in new editions.
This edition replaces G550-1066-03.
Internet
Visit our home page: http://www.infoprint.com
You can send comments by e-mail to [email protected] or by mail to:
InfoPrint Solutions Company
6300 Diagonal Hwy 002J
Boulder, CO 80301-9270
U.S.A.
This product is or contains commercial computer software and commercial computer software documentation
developed exclusively at private expense. As specified in Federal Acquisition Regulation 12.212 in the case of
civilian agencies and Defense Federal Acquisition Regulation Supplement 227.7202 in the case of military agencies,
use, duplication and disclosure by agencies of the U.S. Government shall solely be in accordance with the
accompanying International Program License Agreement in case of software products and in accordance with the
licensing terms specified in the product's documentation in the case of hardware products.
© Copyright InfoPrint Solutions Company 1998, 2010.

Figures
1. Sequence of user-exit programs for InfoPrint
Manager .............57
2. Sample input record exit C language header 74
3. Sample output record exit C language header 77
4. Sample resource exit C language header 79
5. Sample print file attributes C language header 81
6. Brief and Full Styles of Start Sheets ....86
7. Brief and Full Styles of Separator Sheets 87
8. Brief and Full Styles of End Sheets .....87
9. Brief and Full Styles of Accounting-Log Sheets 88
10. Brief and Full Styles of Audit Sheets ....89
11. User exits for InfoPrint.........89
12. Sample PostScript or PDF configuration file 158
13. Sample High Performance PDF Daemon
configuration file ..........159
14. Sample PostScript Daemon configuration file
sections with staple and punch options . . . 162
15. Sample TIFF configuration file ......166
16. Sample PDF parallel transform (pdf2afp.cfg)
configuration file ..........177
17. Sample PDF parallel transform (8264.cfg)
configuration file for color .......178
18. Sample PDF parallel transform (8264.cfg)
configuration file for black and white . . . 179
19. Sample PPML configuration file .....182
20. Scenarios for using XML data that has been
transformed to AFP or PDF .......184
21. Process for transforming XML data to AFP or
PDF...............185
22. Create Transform dialog: Define a transform
that copies an AFP file to a folder without
printing on Windows .........201
23. Create Transform dialog: Define a transform
that copies an AFP file to a directory without
printing on AIX ...........202
24. Create Transform dialog: Define a
conditionally terminating transform ....203
25. Create Transform dialog: Define a transform
to pass job attributes .........205
26. Sample file for a character set ......244
27. Sample file for a code page .......244
28. Sample file for a global identifier .....244
29. Sample file for a code page identifier 244
30. Sample to run the host server program in a 311
31. Sample to run the host server program as a
job...............311
32. Sample spl_error.cfg file provided by
InfoPrint Manager ..........313
33. Sample notifyd_error.cfg file provided by
InfoPrint Manager ..........314
© Copyright InfoPrint Solutions Company 1998, 2010 iii

iv InfoPrint Manager for AIX: Procedures

Tables
1. Output from sample fstshow - o command 3
2. -S flag options ...........21
3. Screen Frequencies for InfoPrint 4000 IR3/IR4
and ID5/ID6 and InfoPrint 4100 HD3/HD4
and HS2 printers with Version 3 or 7 Toner . . 24
4. Screen Frequencies for InfoPrint 4000 IR3/IR4
and ID5/ID6 and InfoPrint 4100 HD1/HD2,
HD5/HD6, PD1/PD2, HS1, HS3, and PS1
printers with Version 2 (enhanced printing
toner) or Standard Toner ........24
5. Screen Frequencies for InfoPrint 4000 IR1/IR2
printers with Version 2, 3, or Standard Toner . 24
6. Screen Frequencies for InfoPrint 4100 TD1-2
printer with Version 2 Toner and InfoPrint
4100 TS1, TS2, TS3, TD3-4, TD5-6 printers with
Version 7 Toner ...........24
7. -U flag options ...........26
8. Sample user-exit programs .......58
9. Default auxiliary sheet objects ......84
10. User-exit programs ..........90
11. PSF DSS accounting, post-print, and audit
user-exit programs ..........104
12. File extensions for resources.......114
13. InfoPrint notification delivery method
characteristics ...........121
14. Default notification profile settings ....124
15. Files that the ismu utility automatically backs
up and restores ...........144
16. Default PCL, PostScript, and PDF transform
configuration files ..........158
17. Default staple locations ........163
18. Additional PostScript staple details ....163
19. Default punch locations ........164
20. Additional PostScript punch details ....164
21. Punch Setting for the /Pattern value 165
22. Default TIFF, JPEG, and GIF transform
configuration files ..........165
23. Processors required to use the Parallel PDF
RIP client .............175
24. Default parallel PDF transform configuration
files ...............177
25. Default PPML transform configuration file 181
26. Transform substitution variables .....197
27. InfoPrint PCL5e bin numbers ......210
28. Sample mapping table for an InfoPrint 20 211
29. Paper tray chart...........212
30. Default bin mappings .........218
31. Mapping for code pages T1001038, T1001108,
and T1001109 ...........231
32. Special symbols added for code page
T1001038 .............237
33. Special symbols added for code page
T1001108 .............237
34. Special symbol added for code page T1001109 238
35. Font mapping table for use with the chars
keyword .............240
36. Print options passed to InfoPrint MVS
Download shell script.........292
37. Specific InfoPrint Manager attributes to pass
values to an MVS host system ......305
38. Using the destination-pass-through attributes
to pass values to an MVS host system . . . 306
39. Options to set for paper fed LEF on the
InfoPrint 45 ............322
40. Options to set for paper fed LEF on the
InfoPrint 60 ............322
41. Options to set for paper fed LEF on the
InfoPrint 2000 ...........323
42. Options to set for paper fed SEF on the
InfoPrint 45 ............323
43. Options to set for paper fed SEF on the
InfoPrint 60 ............324
44. Staple positions for InfoPrint 2060ES,
InfoPrint 2075ES, and InfoPrint 2090ES
mapped to InfoPrint Manager values . . . 325
45. Staple positions for InfoPrint 2105ES mapped
to InfoPrint Manager values ......325
46. Options to set for paper fed LEF for the
InfoPrint 70 ............329
47. Options to set for paper fed SEF for the
InfoPrint 70 ............329
48. Staple positions for InfoPrint 2085 and
InfoPrint 2105 mapped to InfoPrint Manager
values ..............329
49. Staple positions for InfoPrint 2060ES,
InfoPrint 2075ES, and InfoPrint 2090ES
mapped to InfoPrint Manager values . . . 330
50. Staple positions for InfoPrint 2105ES mapped
to InfoPrint Manager values ......330
51. Face down punch positions for the InfoPrint
Pro C900 AFP printer mapped to InfoPrint
Manager values, paper orientation, and job
rotation .............331
52. Face up punch positions for the InfoPrint Pro
C900 AFP printer mapped to InfoPrint
Manager values, paper orientation, and job
rotation .............331
53. Paper loading positions ........332
54. 2–up duplex print job: front and back views 338
55. 2–up duplex print job: front and back views 345
56. 2–up duplex print job: front and back views 348
© Copyright InfoPrint Solutions Company 1998, 2010 v
|
|
||
|
|
|
||

vi InfoPrint Manager for AIX: Procedures

About this publication
This publication helps you use InfoPrint®Manager for AIX®. This publication
assumes that you are up and running. It contains procedures to help you do
various tasks and troubleshoot problems. It also contains procedures for using
orderable features you can use with InfoPrint Manager.
This publication contains advanced configuration and operation tasks for the
administrators who configure the InfoPrint Manager environment.
See InfoPrint Manager: Reference for information about the various InfoPrint
Manager commands, utilities, and attributes available to you while maintaining the
system.
The InfoPrint publication library
For the most current information, see the InfoPrint Solutions Company Web site at
http://www.infoprint.com.
InfoPrint Manager common publication library
These publications are common to both InfoPrint Manager for AIX and InfoPrint
Manager for Windows®:
vInfoPrint Manager: SAP R/3 Planning and Configuration Guide, S550-1051. For print
administrators who need to create and configure both the SAP R/3 environment.
We recommend that users possess a detailed knowledge of a SAP R/3
environment, as well as administering and maintaining either AIX or Windows
operating systems. This publication describes how a business enterprise that
uses SAP R/3 can use either InfoPrint Manager for AIX or InfoPrint Manager for
Windows to manage its print environment.
vInfoPrint Manager: Reference, S550-1052. For print administrators, operators, and
application programmers with the need to do command-line functions. This
publication describes the commands, utilities, transforms, attributes, and
attribute values associated with InfoPrint.
vInfoPrint Manager: PSF and Server Messages, G550-1053. This publication lists the
PSF and Server messages and explanations from InfoPrint Manager.
vInfoPrint Manager Print-on-Demand Feature: Submit Express User's Guide,
S550-1054. This publication is for the user who installs, configures, and uses
Submit Express on a Windows or Macintosh workstation. Although you can use
this publication for general guidance in using Submit Express, you should use
the online Help to find more detailed instructions.
vInfoPrint Job Ticketer: Job Ticketer User's Guide, S550-1055. This publication is a
guide for using the InfoPrint Job Ticketer Web application. This guide provides
descriptions of tasks and procedures that an end-user needs to know to set up
their workstation to use the application, and then to create, layout, store, retrieve
print jobs, and submit the jobs to a print server for printing.
vInfoPrint Job Ticketer: Administrator's Guide, S550-1056. This publication is a guide
for system administrators who are responsible for the InfoPrint Job Ticketer Web
application. This guide provides information about the Job Ticketer system
requirements, installation and configuration, system maintenance, security, and
problem determination.
© Copyright InfoPrint Solutions Company 1998, 2010 vii

vPage Printer Formatting Aid: User's Guide, S550-0801. This publication describes
how to use the Page Printer Formatting Aid (PPFA) to create and compile page
definitions and form definitions for printing or viewing files with Advanced
Function Presentation products.
InfoPrint Manager for AIX publication library
InfoPrint Manager for AIX includes publications in PDF format on a CD-ROM
supplied with the product.
The publications for InfoPrint Manager for AIX are:
vInfoPrint Manager for AIX: Introduction and Planning Guide, G550-1060. This
publication gives an overview of InfoPrint Manager for AIX, introduces the
concepts, and helps you prepare to use it. It addresses migration from previous
versions of the product, and it explains the differences between the AIX and
Windows versions of InfoPrint Manager.
vInfoPrint Manager for AIX: Installation Instructions, G550-1059. This publication
describes how to install InfoPrint Manager for AIX 4.3. These instructions
explain the procedures for local and remote installations.
vInfoPrint Manager for AIX: Getting Started, G550-1061. This publication helps you
install and configure InfoPrint Manager for AIX. It focuses on the software
configuration of server and client system.
vInfoPrint Manager for AIX: Configuration and Tuning Guide, S550-1062. This
publication provides information about configuring and tuning the InfoPrint
Manager for AIX, Version 4.3. This book is designed for the InfoPrint Manager
administrator who needs to understand how to configure and tune an InfoPrint
Manager system. It helps administrators to evaluate, develop, and maintain both
a logical and hardware configuration for their environment.
vGuidelines for Installing InfoPrint Manager for AIX 4.2 in an HACMP Configuration,
G550-1063. This publication helps you install and configure HACMP™with
InfoPrint Manager for AIX. It also describes how to use HACMP with InfoPrint
Manager for AIX.
vInfoPrint Manager for AIX: Using Generalized Fax, S550-1064. This publication
describes how to configure and use the Generalized Fax support that is included
with InfoPrint Manager for AIX. This publication includes information about
sending and receiving faxes from an InfoPrint Manager server.
vInfoPrint Manager for AIX: Procedures, G550-1066. This publication describes how
to set up an InfoPrint environment, to submit print jobs, to schedule jobs, and to
manage the print environment.
InfoPrint Manager for Windows publication library
InfoPrint Manager for Windows includes publications in PDF format on a
CD-ROM supplied with the product.
The publications for InfoPrint Manager for Windows are:
vInfoPrint Manager for Windows: Introduction and Planning Guide, G550-1071. This
publication gives an overview of InfoPrint Manager for Windows, introduces its
concepts, and helps you prepare to use it. It describes features of this product.
Finally, this publication explains the differences between the AIX and Windows
versions of InfoPrint.
viii InfoPrint Manager for AIX: Procedures

vInfoPrint Manager for Windows: Getting Started, G550-1072. This publication helps
you install and configure InfoPrint Manager for Windows. It focuses primarily
on server and client system software configuration.
vInfoPrint Manager for Windows: Procedures, G550-1073. This publication describes
the primary tasks necessary for setting up an InfoPrint environment, submitting
print jobs, scheduling jobs, and managing the print environment.
Related information
For information about InfoPrint products, see:
vInfoPrint Solutions Company Web site (http://www.infoprint.com)
vInfoPrint Information Center (http://www.infoprint.com/infocenter)
For information about related products, see:
vAdvanced Function Presentation: Font Summary, G544-3810
vAFP Conversion and Indexing Facility: User's Guide, G550-1342
vAIX Commands Reference books
vColor Management Object Content Architecture Reference, S550-0511
vData Stream and Object Architectures: Mixed Object Document Content Architecture
Reference, SC31-6802
vData Stream and Object Architectures: Graphics Object Content Architecture for
Advanced Function Presentation Reference, S544-5498
vFont Summary, G550-1140
vInfoPrint 4005 Hi-Lite Color Application Design Reference, S544-5794
vInfoPrint Data Stream and Object Architectures: Bar Code Object Content Architecture
Reference, S544-3766
vInfoPrint Data Stream and Object Architectures: Font Object Content Architecture
Reference, S544-3285
vInfoPrint Data Stream and Object Architectures: Graphics Object Content Architecture
Reference, S544-5498
vInfoPrint Data Stream and Object Architectures: Image Object Content Architecture
Reference, SC31-6805
vInfoPrint Data Stream and Object Architectures: Mixed Object Document Content
Architecture Reference, SC31-6802
vInfoPrint Hi-Lite Color Introduction and Planning Guide for 4005, G544-5741
vPrinting for Fun and Profit under AIX, GG24-3570
vPSF/MVS MVS Download Guide, G544-5294
vTCP/IP Tutorial and Technical Overview, GG24-3376
vUsing OpenType Fonts in an AFP System, G544-5876
About this publication ix

Manual (man) pages for InfoPrint commands, utilities, and transforms
Online information, in manual (man) page format, is available for all InfoPrint
commands and utilities. You can use the AIX man command to view man pages
for these InfoPrint commands:
vlistconv
vlprafp
vlsippgw
vmkfntmap
vpdaccount
vpdclean
vpdcreate
vpddelete
vpddeviceop
vpddisable
vpdenable
vpdls
vpdmod
vpdpause
vpdpr
vpdpromote
vpdq
vpdreorder
vpdresubmit
vpdresume
vpdrm
vpdset
vpdshutdown
vpdspace
vpsfstat
vuconv
For example, to view online information for the pdpr command, enter:
man pdpr
You can use the AIX man command to view these man page for the -o flag, which
is used to pass information to InfoPrint on AIX print commands:
voflag
You can use the AIX man command to view man pages for these InfoPrint utilities:
xInfoPrint Manager for AIX: Procedures

vadmingui
vafpsplit
vainupod1
vainupod2
vainupod3
vainurpt1
vainurpt2
vainurpt3
vainurpt4
vainurpt5
vainurpt6
vainurpt7
vainurpt8
vainurpt9
vallocatefs
vcfu
vcmt
vipguiadv
vipguibasic
vipguiadvadm
vipguibasicadm
vjsmigr
vopergui
vpdadmin
vpdcrcds
vpdcrdflt
vpdcrmed
vpdinitports
vpdmigpp
vpdmincfg
vpdmsg
vpdnetifspri
vpdwsinitports
vrc.iprsap
vrc.pd
vsetup
vstartppo
vstart_server
vstartsrv
vstop_server
You can use the AIX man command to view man pages for these InfoPrint daemon
utilities:
vmvsprsd
vpcl2afpd
vps2afpd
vstartcbd
vstartippgw
vstartnotd
vstartsapconnectd
vstopcbd
vstopippgw
vstopnotd
vstopsapconnectd
You can use the AIX man command to view man pages for these InfoPrint
transform commands:
vdb2afp
vd2afp
vgif2afp
vimg2afp
vjpeg2afp
vline2afp
vpcl2afp
vpdf2afp
vppml2afp
vps2afp
vsap2afp
vtiff2afp
vxml2afp
vxml2pdf
About this publication xi

For information about the flags that you can use with the man command, see the
man manpage or the AIX Commands Reference.
xii InfoPrint Manager for AIX: Procedures

Part 1. Administrative procedures: Configuring InfoPrint
Manager
© Copyright InfoPrint Solutions Company 1998, 2010 1

2InfoPrint Manager for AIX: Procedures

Chapter 1. Creating and managing servers
The InfoPrint server manages and controls all other InfoPrint objects in your
InfoPrint system. During InfoPrint installation, one server was created that
contains a logical destination, a queue, and an actual destination (a physical
printer). Use the information in this chapter to add additional servers and to
perform server configuration and maintenance tasks.
Preparing to create additional servers in a distributed environment
If you are configuring for a distributed environment and need to define many
instances of the InfoPrint server process on the same machine, use the fstshow
command to see what intercommunication ports are available on your server.
For example, entering fstshow —o on an AIX command line produces a display
similar to the contents of this table:
Table 1. Output from sample fstshow - o command
IN-USE? PORT# PID DIR-ID NAME
Y 2050 23266 2 server1
Y 2051 24272 0 notifyd
N 2052 99
N 2053 99
N 2054 99
N 2055 99
N 2056 99
N 2057 99
N 2058 99
N 2059 99
Once you have a list of the server intercommunication ports that are either in use
or available (2050 through 2059 in the display above), you can see if you have
enough ports to start more InfoPrint Manager server processes. If not, you can use
the pdinitports utility to initialize a larger range of port numbers for interprocess
communication. Note that InfoPrint Manager processes, such as notifyd and the
SAP callback daemons also use server intercommunication ports.
Because InfoPrint defaults to reserving only 10 ports, to define more than 10 server
processes, you must use the pdinitports utility to initialize more than 10 ports. For
example, to initialize InfoPrint to use the server interprocess communication ports
2050 through 2069 for twenty server processes, enter this at the AIX command line:
pdinitports 2050 2069
For a complete description of the pdinitports utility, see InfoPrint Manager:
Reference. Once you have completed this process, you can begin “Creating
additional servers or starting existing servers” on page 4.
© Copyright InfoPrint Solutions Company 1998, 2010 3

Creating additional servers or starting existing servers
You can create a new server or start an existing server through the InfoPrint SMIT
administrator's interface. If you are not familiar with how to start the InfoPrint
SMIT administrator's interface, see "Using the InfoPrint Interfaces" in InfoPrint
Manager for AIX: Getting Started.
To create a new server or start an existing server:
1. From the InfoPrint Printing System panel, click Start/Stop Servers. A new
menu displays.
2. Click Start a Server. The Start a Server dialog window opens.
3. Enter the name of the InfoPrint server in the * SERVER name field. By default,
InfoPrint fills in this field with the name of the AIX system on which you are
running the SMIT session.
4. To use a port number other than the default of 6874 as the communications
port for InfoPrint, enter the port number in the PORT number field.
Note: When selecting your own port number, always increment the choice by
two because the InfoPrint server uses two numbers: the one you specify and
the next one, for example, 6874 and 6875.
5. If you want the InfoPrint server to run in a locale other than your current
locale, enter the locale name in the LOCALE field.
6. Press Enter. The result of this step depends on whether the server exists:
vIf the server does not exist, InfoPrint displays a confirmation message asking
if you want to create a new server. Respond to the prompt to continue.
vIf the server exists but is not currently running, InfoPrint displays status
information and issues a message when it successfully starts the server.
vIf the server exists and is running, InfoPrint issues a message to indicate that
the server is already operational.
Notes:
1. Normally you will only run one InfoPrint server on an AIX system.
2. You also use this procedure to start a server that you have shut down.
Important:
Following Daylight Savings Time changes, some customers have reported
discrepancies in their server accounting logs and others have reported job
submission failures. The problem was resolved by stopping and starting the
InfoPrint Manager server. If you are already experiencing these symptoms or want
to avoid them in the future, arrange to have your servers restarted immediately
following a Daylight Savings Time change.
Configuring servers with a mixed language environment
If your InfoPrint environment is a mixed language environment with separate
locales, you must use “Creating additional servers or starting existing servers” to
create separate servers running in each language of your environment. Each of
these servers can be named for the locale they support (such as english,french,or
german).
4InfoPrint Manager for AIX: Procedures

These InfoPrint Manager servers do not need to contain any InfoPrint Manager
objects, such as queues or destinations. Instead, these servers handle the
locale-specific processing of the commands and forward those commands to the
InfoPrint Manager server that contains the objects.
For each InfoPrint client that is not running on the same AIX server as the
InfoPrint AIX servers, such as the InfoPrint Manager Operations GUI, InfoPrint
Submit Express, JobTicketer, or InfoPrint Select, you must make sure that it
connects to the correct InfoPrint server by setting the PD_SOCKET environment
variable to contain the port number of the InfoPrint AIX server supporting the
locale of your client. If your client is running in a locale not supported by the
InfoPrint server then connect it to an InfoPrint server running in English. To do
this task, see Chapter 12, “Setting InfoPrint Manager and AIX environment
variables,” on page 133.
Shutting down a server
You can shut down a server immediately or after it finishes processing some or all
of its current jobs.
InfoPrint prevents the server from accepting new jobs while the server is shutting
down and after it has shut down. Logical destinations and actual destinations in
the server that were enabled at shut down time are enabled when the server is
restarted. Logical destinations and actual destinations in the server that were
disabled at shut down time are disabled when the server is restarted.
Note: See “Creating additional servers or starting existing servers” on page 4 for
the restart procedure.
You can shut down an existing server through the InfoPrint SMIT administrator's
interface. If you are not familiar with how to start the InfoPrint SMIT
administrator's interface, see "Using the InfoPrint Interfaces" in InfoPrint Manager
for AIX: Installation Instructions.
To shut down an existing server:
1. From the InfoPrint Printing System panel, click Start/Stop Servers. A new
menu displays.
2. Click Stop a Server. The Stop a Server dialog window opens.
3. Enter the name of the InfoPrint server in the * SERVER name field. By default,
InfoPrint fills in this field with the name of the AIX system on which you are
running the SMIT session.
4. Press Enter. The result of this step depends on whether the server is running:
vIf the server is currently running, InfoPrint issues a message when it
successfully stops the server.
vIf the server is not running, InfoPrint issues a message to indicate that the
server is not operational.
Notes:
1. Normally you will only run one InfoPrint server on an AIX system.
2. You also use this procedure to start a server that you have shut down.
Chapter 1. Creating and managing servers 5

6InfoPrint Manager for AIX: Procedures