Front cover IBM Infoprint Server for z/OS Implementation Planning Basic to extended mode migration, HTTP server Sample tools for customization ICONV customization Paul Rogers Klaus Goetze ibm.com/redbooks International Technical Support Organization IBM Infoprint Server for z/OS Implementation Planning July 2008 SG24-7458-00 Note: Before using this information and the product it supports, read the information in “Notices” on page vii. First Edition (July 2008) This edition applies to Version 1 Release 8 of z/OS (5694-A01), Version 1 Release 8 of z/OS.e (5655-G52), and to all subsequent releases and modifications until otherwise indicated in new editions. © Copyright International Business Machines Corporation 2008. All rights reserved. Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Notices . vii Trademarks . viii Preface . ix The team that wrote this book . ix Become a published author . ix Comments welcome. .x Chapter 1. Infoprint Server. 1 1.1 Infoprint Server overview . 2 1.2 Tasks required to implement Infoprint Server . 3 1.2.1 Create a UNIX System Service file system. 3 1.2.2 Define environment variables . 4 1.2.3 Define users for administration and operations. 4 1.2.4 Set permissions for directories and executable files. 5 1.2.5 Customize Infoprint Server configuration files. 5 1.2.6 Start Infoprint Server. 5 1.2.7 Stop Infoprint Server daemons . 6 1.3 Infoprint Server ISPF panels . 6 1.4 Tasks required to implement IP PrintWay. 7 1.4.1 IP PrintWay extended mode customization . 7 1.4.2 IP PrintWay basic mode customization. 7 1.5 Implementation of NetSpool . 9 Chapter 2. Using the Security Authorization Facility for Infoprint Server security . 11 2.1 Security processing. 12 2.1.1 MVS security versus z/OS UNIX security . 12 2.1.2 File and directory permission bits . 13 2.1.3 File security packet (FSP). 14 2.1.4 Setting permissions for directories and executable files . 16 2.2 Summary of UNIX commands. 16 2.3 Summary of RACF commands . 18 2.4 Establishing SAF security with RACF . 18 2.4.1 Activating the FACILITY class. 19 2.4.2 Activating the JESSPOOL class . 20 2.4.3 Activating the OPERCMDS class . 21 2.4.4 Activating the PRINTSRV class . 23 2.5 Controlling UNIX System Service environment. 25 2.5.1 User profiles with OMVS segments . 25 2.5.2 Setting limits for z/OS UNIX users . 26 2.5.3 Controlling the number of processes and threads . 27 Chapter 3. Printer definitions. 31 3.1 Printer Inventory overview. 32 3.1.1 Components . 32 3.1.2 Infoprint Server components. 34 3.2 Utility programs . 34 3.2.1 Using the AOPBATCH utility. 35 © Copyright IBM Corp. 2008. All rights reserved. iii 3.3 FSS definitions for IP Printway basic mode . 36 3.4 FSS definition for a PSF functional subsystem . 36 3.5 FSA definitions for PSF and IP Printway basic mode . 37 3.6 Attributes for the allocation object class . 39 3.7 Attributes for the processing object class . 41 3.8 Attributes for the netspool-eof-rules object . 42 3.9 Attributes for the NetSpool-options object. 43 3.10 Attributes for the printway-options object . 43 3.11 Attributes for the protocol object . 44 3.12 Attributes for the printer object . 45 3.13 Attributes for a printer-pool object . 46 3.14 Attributes for a job-selection-rule . 47 3.15 The default printer definition . 47 3.15.1 Batch job submission . 48 3.16 Objects and attributes . 49 3.16.1 A printer object in the Printer Inventory. 50 3.17 AOPPRINT procedure usage examples . 54 3.17.1 Remote print server . 55 3.17.2 Remote PSF print server. 56 Chapter 4. Migrating from basic mode to extended mode . 59 4.1 IP PrintWay extended mode . 60 4.2 Extended mode versus basic mode . 60 4.2.1 Extended mode enhanced function and other advantages. 61 4.3 Tasks required to migrate . 61 4.3.1 Edit the Infoprint Server configuration file aopd.conf . 61 4.3.2 Infoprint Server message configuration file aopmsg.conf . 63 4.4 Printer Inventory directories and files . 64 4.4.1 /var/Printsrv directory . 65 4.4.2 Calculate the space needed for temporary files . 66 4.4.3 Space allocation for /var/Printsrv file system . 67 4.4.4 Specify environment variables for IP PrintWay extended mode . 69 4.4.5 Define IP PrintWay job-selection rules . 69 4.4.6 Customize Infoprint Central. 70 4.5 Migration issues and concerns . ..