Front cover ABCs of z/OS System Programming Volume 7 Infoprint Server IP PrintWay, NetSpool, Infoprint Server Transforms Infoprint Central Paul Rogers Juha Vainikainen ibm.com/redbooks International Technical Support Organization ABCs of z/OS System Programming Volume 7 October 2008 SG24-6987-01 Note: Before using this information and the product it supports, read the information in “Notices” on pageix. Second Edition (October 2008) This edition applies to Version 1 Release 9 of z/OS (5637-A01), and 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 2006, 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .x Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi The team that wrote this book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xii Become a published author. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xii Comments welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xii Chapter 1. Infoprint Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.1 z/OS Infoprint Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1.2 Data streams on JES spool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 1.3 Infoprint Server components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 1.4 Print Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 1.5 LPR/LPD Protocol - RFC1179 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 1.6 IP PrintWay basic mode support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 1.7 IP PrintWay extended mode support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 1.8 Printer Inventory Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 1.9 Infoprint Server Transforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 1.10 NetSpool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 1.11 SNMP Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 1.12 Print work submission to Infoprint Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 1.13 Printing using LPR command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 1.14 z/OS UNIX shell printing commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 1.15 Using Internet Printing Protocol (IPP). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 1.16 Printing with Infoprint Port Monitor for Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 1.17 Printing SAP R/3 documents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 1.18 Infoprint Central overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Chapter 2. UNIX System Services overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 2.1 RACF OMVS segments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 2.2 Infoprint Server and RACF OMVS segments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 2.3 z/OS UNIX users and groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 2.4 RACF commands to define groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 2.5 RACF commands to define users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 2.6 Superusers with appropriate privileges. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 2.7 BPX.SUPERUSER authority. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 2.8 SUPERUSER.FILESYS profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 2.9 Assigning UIDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 2.10 Shared UID prevention . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 2.11 Initializing z/OS UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 2.12 z/OS UNIX File Security Packet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 2.13 z/OS UNIX interactive interfaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 2.14 ISPF Option 6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 2.15 ISHELL ISPF dialog (ISH). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 2.16 Files and directories in /var/Printsrv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 2.17 OMVS command shell session. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 2.18 Environment variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 Chapter 3. Infoprint Server customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 © Copyright IBM Corp. 2006, 2008. All rights reserved. iii 3.1 Enabling the Infoprint Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 3.2 Basics of the z/OS UNIX file system. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 3.3 z/OS UNIX files and Infoprint Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 3.4 Infoprint Server directories/files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 3.5 Infoprint Server configuration file (aopd.conf). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 3.6 Full format of the aopd.conf file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 3.7 Infoprint Server daemons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 3.8 Customizing the Printer Inventory Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 3.9 Functions using Printer Inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 3.10 Printer Inventory directories and files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 3.11 Printer Inventory and security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 3.12 Create users for administration and operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 3.13 SYS1.SAMPLIB(AOPRACF) commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 3.14 Create a user file system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 3.15 Starting Printer Inventory Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 3.16 AOPSTART JCL procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 3.17 Environment variables in /etc/profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 3.18 Additional environment variables in /etc/profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 3.19 Editing aopstart rexx exec. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 3.20 Stopping Infoprint Server daemons. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 3.21 AOPSTOP JCL procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 3.22 Infoprint Server address spaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 3.23 Working with Printer Inventory Manager (AOPD) . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 3.24 Enabling Infoprint Server ISPF panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 3.25 Inforpint Server configuration panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 3.26 An alternative REXX EXEC - Start ISPF application. . . . . . . . . . . . . . . . . . . . . . . . . 116 3.27 Infoprint Server ISPF primary panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 3.28 Add a printer using ISPF panels. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 3.29 Add a printer using ISPF panels. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 3.30 Component name list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 3.31 Component definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 3.32 Specifying printer definition attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 3.33 Components for IP PrintWay printer definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 3.34 Add a printer using ISPF panels - Allocation(1/3). . . . . . . . . . . . . . . . . . . . . . . . . . . 129 3.35 Add a printer using ISPF panels - Allocation(2/3). . . . . . . . . . . . . . . . . . . . . . . . . . . 131 3.36 Add a printer using ISPF panels - Allocation(3/3). . . . . . . . . . . . . . . . . . . . . . . . . . . 133 3.37 Add a printer using ISPF panels - Processing (1/3) . . . . . . . . . . . . . . . . . . . . . . . . . 134 3.38 Add a printer using ISPF panels - Processing(2/3). . . . . . . . . . . . . . . . . . . . . . . . . . 136 3.39 Add a printer using ISPF panels - Processing(3/3). . . . . . . . . . . . . . . . . . . . . . . . . . 138 3.40 Add a printer using ISPF panels - IP PrintWay Options (1/2) . . . . . . . . . . . . . . . . . . 139 3.41 Add a printer using ISPF panels - IP PrintWay Options(2/2). . . . . . . . . . . . . . . . . . . 141 3.42 Add a printer using ISPF panels - LPR Protocol. . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 3.43 Printer Inventory Definition Utility (pidu) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 3.44 pidu commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 3.45 pidu -c "display printer pokeps ; " . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 3.46 Backing up and restoring Printer Inventory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 3.47 Setting Workload Manager goals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 Chapter 4. Print Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 4.1 Print Interface software requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 4.2 Functions provided by Print Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 4.3 LPR/LPD protocol - RFC 1179 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 4.4 Print Interface customization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 iv ABCs of z/OS System Programming Volume 7 4.5 Print Interface - aoplpd daemon (LPR/LPD). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 4.6 Print Interface validating requests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 4.7 Print Interface and z/OS UNIX printing commands. . . . . . . . . . . . . . . . . . . . . . . . . . . 165 4.8 Print requests from z/OS to Print Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 4.9 Print Interface processing for print requests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 4.10 Printing commands customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 4.11 Using attribute files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171 4.12 RACF OMVS segment and aopd.conf file updates. . . . . . . . . . . . . . . . . . . . . . . . . . 173 4.13 Customizing the AOPPRINT JCL procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176 4.14 AOPPRINT examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 4.15 Print Interface and IPP protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 4.16 Customization tasks for Print Interface IPP server . . . . . . . . . . . . . . . . . . . . . . . . . . 181 4.17 AFP authorization for Java libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183 4.18 Customizing z/OS Communication Server (TCP/IP). . . . . . . . . . . . . . . . . . . . . . . . . 185 4.19 Other hlq.PROFILE.TCPIP and JES considerations. . . . . . . . . . . . . . . . . . . . . . . . . 188 4.20 Print Interface subsystem customization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 4.21 Transform configuration file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 4.22 Infoprint Server Transform Manager and transforms . . . . . . . . . . . . . . . . . . . . . . . . 194 4.23 Infoprint Server transforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 4.24 Customizing the Transform Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 4.25 Transform classes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201 4.26 Format of a PCL to AFP transform entry. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203 4.27 PostScript and PDF to AFP transform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205 4.28 Security for the PostScript and PDF to AFP transform. . . . . . . . . . . . . . . . . . . . . . . 207 4.29 AFP to PCL, AFP to PDF, and AFP to PostScript transforms. . . . . . . . . . . . . . . . . . 209 4.30 AFP to PCL, AFP to PostScript, or AFP to PDF transform entry . . . . . . . . . . . . . . . 212 4.31 AFP to PCL, AFP to PostScript, or AFP to PDF environment variables. . . . . . . . . . 214 4.32 Customization of AFP resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216 4.33 Specify AFP resource libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219 4.34 Mapping AFP raster and AFP outline fonts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221 4.35 Optional environment variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223 4.36 Example afp2pcl transform class entry. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225 4.37 Enhanced PDF documents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 4.38 To use PDF encryption. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228 4.39 Example - Create an encrypted PDF document. . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 4.40 Scaling fonts using the AOXCF30 program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232 Chapter 5. IP PrintWay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 5.1 IP PrintWay. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236 5.2 IP PrintWay modes of operation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 5.3 SAPI process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 5.4 SAPI client request to JES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243 5.5 IP PrintWay extended mode SAPI processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245 5.6 IP PrintWay extended mode printing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246 5.7 IP PrintWay basic mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247 5.8 IP PrintWay basic mode FSS/FSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249 5.9 IP PrintWay basic mode printing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252 5.10 One IP PrintWay basic mode FSS/JES and several FSAs. . . . . . . . . . . . . . . . . . . . 253 5.11 Multiple IP PrintWay basic mode FSS address spaces . . . . . . . . . . . . . . . . . . . . . . 254 5.12 TCP/IP customization tasks for IP PrintWay basic mode . . . . . . . . . . . . . . . . . . . . . 255 5.13 IP PrintWay basic mode customization steps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258 5.14 ANFWPROC - IP PrintWay basic mode startup procedure. . . . . . . . . . . . . . . . . . . . 261 5.15 RACF for IP PrintWay basic mode startup procedure. . . . . . . . . . . . . . . . . . . . . . . . 262 Contents v 5.16 IP PrintWay transmission-queue and message-log . . . . . . . . . . . . . . . . . . . . . . . . . 264 5.17 View IP Printway basic mode transmission-queue . . . . . . . . . . . . . . . . . . . . . . . . . . 266 5.18 IP PrintWay Transmission Queue Selection panel. . . . . . . . . . . . . . . . . . . . . . . . . . 267 5.19 IP PrintWay basic mode message log view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268 5.20 VTAM APPL resource definition and LE run-time. . . . . . . . . . . . . . . . . . . . . . . . . . . 269 5.21 Define IP PrintWay basic mode functional subsystem . . . . . . . . . . . . . . . . . . . . . . . 271 5.22 IP PrintWay basic mode default font and page definitions . . . . . . . . . . . . . . . . . . . . 273 5.23 JES FSS/FSA definitions for IP PrintWay basic mode . . . . . . . . . . . . . . . . . . . . . . . 275 5.24 Infoprint Server extended mode versus basic mode. . . . . . . . . . . . . . . . . . . . . . . . . 277 5.25 IP PrintWay extended mode enhancements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278 5.26 Enhanced functions with extended mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279 5.27 IP PrintWay extended mode customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281 5.28 Job selection rules - IP PrintWay extended mode . . . . . . . . . . . . . . . . . . . . . . . . . . 284 5.29 Create IP PrintWay extended mode job selection rules . . . . . . . . . . . . . . . . . . . . . . 286 5.30 Add IP PrintWay extended mode job selection rule . . . . . . . . . . . . . . . . . . . . . . . . . 287 5.31 Job selection rules in the Printer Inventory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288 5.32 Job selection rule security profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289 5.33 Authorizing JES spool and SMF for Infoprint Server. . . . . . . . . . . . . . . . . . . . . . . . . 290 5.34 Customizing z/OS UNIX sendmail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292 Chapter 6. NetSpool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295 6.1 NetSpool overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 6.2 NetSpool features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299 6.3 NetSpool owner definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301 6.4 Embedding job attributes in the NetSpool print data. . . . . . . . . . . . . . . . . . . . . . . . . . 302 6.5 Customizing NetSpool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304 6.6 Customizing the NetSpool startup procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306 6.7 Defining NetSpool user ID and LUs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308 6.8 Defining NetSpool printer LUs to VTAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310 6.9 Defining NetSpool printers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313 6.10 Defining printer pools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315 6.11 Writing NetSpool exits. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317 6.12 Starting and stopping NetSpool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319 6.13 NetSpool operator commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321 Chapter 7. Infoprint Central . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325 7.1 Infoprint Central and Infoprint Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 7.2 Infoprint Central. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328 7.3 Customizing the z/OS HTTP Server configuration file . . . . . . . . . . . . . . . . . . . . . . . . 330 7.4 Protecting Infoprint Central Web pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332 7.5 z/OS HTTP Server environment variables file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333 7.6 z/OS HTTP Server JCL procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337 7.7 Customization tasks for Infoprint Central . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338 7.8 Customizing aopd.conf file and RACF for Infoprint Central. . . . . . . . . . . . . . . . . . . . . 340 7.9 Infoprint Central Security - Printer Inventory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342 7.10 Infoprint Central Security - Protecting IP PrintWay printers . . . . . . . . . . . . . . . . . . . 343 7.11 Infoprint Central and operator command security. . . . . . . . . . . . . . . . . . . . . . . . . . . 344 7.12 Infoprint Central and NetSpool security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346 7.13 Infoprint Central and job selection rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347 7.14 Infoprint Central security checks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348 7.15 Logging on to Infoprint Central from the Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350 7.16 Infoprint Central action access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352 7.17 PIDU command to create printer security profiles. . . . . . . . . . . . . . . . . . . . . . . . . . . 354 vi ABCs of z/OS System Programming Volume 7 7.18 Work with Printers panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355 7.19 Working with printers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 7.20 IP PrintWay Information window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359 7.21 Ping a printer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361 7.22 Redirect a printer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363 7.23 Using the stop button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365 7.24 Stop a printer options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 7.25 View log for a printer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367 7.26 Viewing printer log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368 7.27 Infoprint Server messages in the OPERLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369 7.28 Attributes for the message configuration file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371 7.29 Infoprint Central work with Print Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372 7.30 Infoprint Server print jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374 7.31 Print job information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376 7.32 Change print output priority. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377 7.33 Work with NetSpool Logical Units. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378 7.34 System Status - System Daemons and Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379 7.35 System Status - IP PrintWay Job Selection Rules panel . . . . . . . . . . . . . . . . . . . . . 380 7.36 Find Printer Definitions panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381 7.37 Printer Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383 Chapter 8. User interfaces to Infoprint Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385 8.1 Printing from z/OS UNIX System Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386 8.2 z/OS UNIX user prints a file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387 8.3 lpstat command options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389 8.4 z/OS UNIX transform commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390 8.5 Infoprint Server and transforms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392 8.6 Infoprint Server job attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393 8.7 Job attributes and JCL equivalents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394 8.8 Using job attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395 8.9 Job attributes and NetSpool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396 8.10 Printing from batch applications using IP PrintWay . . . . . . . . . . . . . . . . . . . . . . . . . 397 8.11 OUTPUT JCL for IP PrintWay. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398 8.12 Infoprint Server sendmail support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400 8.13 Processing options for e-mail printers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401 8.14 Infoprint Server ISPF e-mail protocol panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402 8.15 Flow for batch job output. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403 8.16 AOPBATCH Program for Data Transforms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404 8.17 AOPPRINT JCL procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406 8.18 Creating an alias file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407 8.19 Infoprint Central e-mail display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408 8.20 Printing from workstations overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409 8.21 Adding a z/OS printer to a Windows environment(1 of 5). . . . . . . . . . . . . . . . . . . . . 411 8.22 Adding a z/OS printer to a Windows environment (2 of 5) . . . . . . . . . . . . . . . . . . . . 413 8.23 Adding a z/OS printer to a Windows environment (3 of 5) . . . . . . . . . . . . . . . . . . . . 414 8.24 Adding a z/OS printer to a Windows environment (4 of 5) . . . . . . . . . . . . . . . . . . . . 415 8.25 Adding a z/OS printer to a Windows environment (5 of 5) . . . . . . . . . . . . . . . . . . . . 416 8.26 Printing from Windows with the z/OS printer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417 8.27 Using LPR command to submit print requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418 8.28 z/OS LPR command syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419 8.29 SDSF view of IP PrintWay data sets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421 8.30 JES2 filter to display PS output. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422 8.31 Viewing Infoprint Server messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423 Contents vii 8.32 Viewing messages with aoplogu command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425 8.33 Format of common message log messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427 8.34 Viewing IP PrintWay basic mode messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428 8.35 IP PrintWay and the JSPA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429 Related publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431 IBM Redbooks documents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431 Other publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431 Online resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431 How to get IBM Redbooks publications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432 Help from IBM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432 viii ABCs of z/OS System Programming Volume 7