ABCs of z/OS System Programming

450 Pages·2008·3.915 MB·English

by  Paul Rogers, Alvaro Salla

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