z/OS Infoprint Server Customization
Previous topic |
Next topic
|
Contents
|
Index
|
Contact z/OS
|
Library
|
PDF
Contents (exploded view)
z/OS Infoprint Server Customization
SA38-0691-00
Infoprint Server Customization
Abstract for Infoprint Server Customization
Summary of changes
z/OS Version 2 Release 1
Introducing Infoprint Server
Printer Inventory Manager
Windows client
Print Interface
Print Interface with an SAP R/3 application server on the z/OS system
Print Interface with an SAP R/3 application server on a remote system
NetSpool
IP PrintWay
Transform Interface
Transforms
Infoprint Central
SNMP subagent
Customization roadmap
Customizing the Printer Inventory Manager
Identifying software requirements for Printer Inventory Manager
Enabling the Infoprint Server feature
Updating the BPXPRMxx member of SYS1.PARMLIB
Making Language Environment and C++ runtime libraries available
Creating Infoprint Server directories
/etc/Printsrv directory
/var/Printsrv directory
Calculating DASD space requirements for the /var/Printsrv directory
Creating the Infoprint Server configuration file (aopd.conf)
Steps for creating the Infoprint Server configuration file (aopd.conf)
Steps for editing the Infoprint Server configuration file (aopd.conf)
Setting environment variables for the Printer Inventory Manager
Setting up security for the Printer Inventory and operator commands
AOP.ADMINISTRATOR profile
AOP.CONFIGURATION profile
AOPADMIN and AOPOPER groups
AOPCONF group
Steps for setting up security for the Printer Inventory, common message log, and operator commands
Setting permissions for directories and executable files -- aopsetup
Steps for running aopsetup
Customizing startup and shutdown commands and procedures
Editing the aopstart EXEC
Steps for copying and editing the aopstart EXEC
Steps for editing the aopstart EXEC
Creating a user ID to assign to the AOPSTART and AOPSTOP procedures
Defining the AOPSTART and AOPSTOP procedures to RACF
Editing the AOPSTART startup procedure
Editing the AOPSTOP shutdown procedure
Starting Infoprint Server daemons automatically
Enabling Infoprint Server ISPF panels
Defining libraries in the TSO logon procedure
Displaying the Infoprint Server panel option
Modifying the AOPINIT EXEC
Enabling dynamic configuration
Dynamic attributes
Cross-system coupling facility (XCF)
Steps for enabling dynamic configuration
Steps for disabling dynamic configuration
Steps for determining whether dynamic configuration is enabled
Editing the system configuration definition for Printer Inventory Manager
Steps for editing the system configuration definition
Sending non-console messages to the hardcopy log
Creating the message configuration file (aopmsg.conf)
Editing the message configuration file (aopmsg.conf)
Setting up the MVS system logger for the common message log
Deciding whether to use the MVS system logger
Deciding the type of log stream
Deciding on a naming convention for log streams
Determining how long to retain messages
Determining the size of log-stream data sets and interim storage
Setting up security for log streams
Setting up security for a DASD-only log stream
Setting up security for a coupling-facility log stream
Defining log streams to the MVS system logger
Defining a DASD-only log stream to the MVS system logger
Defining a coupling-facility log stream to the MVS system logger
Activating a log stream in Infoprint Server
Switching from one log stream to another
Deactivating a log stream in Infoprint Server
Handling system logger errors
Viewing messages in the log stream
Backing up and restoring the Printer Inventory
Steps for backing up the Printer Inventory to an HFS or zFS file
Steps for restoring the Printer Inventory from an HFS or zFS file
Steps for backing up the Printer Inventory to a generation data group (GDG)
Steps for restoring the Printer Inventory from a GDG
Saving messages in the common message log in the z/OS UNIX file system
Reducing the size of the common message log in the z/OS UNIX file system
Setting Workload Manager goals
Customizing Print Interface
Identifying software requirements for Print Interface
Common customization for Print Interface
Customizing z/OS Communications Server
Editing the hlq.PROFILE.TCPIP data set
TCPCONFIG statement
PORT and PORTRANGE statements
AUTOLOG statement
Updating the BPXPRMxx member of SYS1.PARMLIB
Working with JES spool limits
Editing the aopd.conf file for Print Interface
Writing a filter program
Filter options
Examples
Writing a DLL filter
Input to a DLL filter
Output from a DLL filter
Writing a UNIX filter
Input to a UNIX filter
Output from a UNIX filter
Invoking a DLL or UNIX filter
Programming considerations
Testing filters
Modifying filters
Filters provided with Infoprint Server
Customizing JES to specify no blank truncation
Setting environment variables for Print Interface
Editing the system configuration definition for Print Interface
Customizing the z/OS UNIX printing commands
Customizing the AOPPRINT JCL procedure
Customizing the Print Interface LPD
Customizing z/OS Communications Server (TCP/IP)
Running only the Print Interface LPD on the z/OS system
Running the Print Interface LPD and the Communications Server LPD on the same z/OS system
Running each LPD on a separate TCP/IP stack
Running both LPDs on the same TCP/IP stack
Editing the aopd.conf file for the LPD
Editing the system configuration definition for the LPD
Using the LPD compatibility filter
Customizing LPR clients
Sending the control file first
Increasing the time-out value on an AIX system
Customizing the z/OS SMB server to use Print Interface
Customizing the z/OS SMB server
Customizing the Print Interface IPP Server
Ensuring sufficient memory is available to start the IPP Server
Editing the aopd.conf file for the IPP Server
Setting environment variables for the IPP Server
Editing the system configuration definition for the IPP Server
Customizing the IPP workstation client
Customizing SAP R/3
Defining an SAP user for the callback daemon
Creating the SAP callback daemon configuration file (aopsapd.conf)
Format of an entry in the SAP callback daemon configuration file
Example -- SAP callback daemon
Syntax rules
Setting environment variables for the SAP OMS
Defining a ROMS and LOMS to the SAP R/3 application server
Modifying the LOMS to specify job attributes
Creating an SAP R/3 output device
Creating an SAP output device using access method E
Creating an SAP output device using access method U
Viewing job status and job events, querying jobs, canceling jobs
Customizing the Print Interface subsystem
Editing the aopd.conf file for the Print Interface subsystem
Increasing the maximum number of active transform daemons
Customizing Transform Interface
Identifying software requirements for Transform Interface
Editing the aopd.conf file for the Transform Manager
Creating the transform configuration file (aopxfd.conf)
Transform classes
Format of an entry in the transform configuration file
Example of a transform entry
Steps for creating the transform configuration file
Steps for editing the transform configuration file
Creating the remote transform configuration file (aoprxf.conf)
Format of the remote transform configuration file
Steps for creating the remote transform configuration file
Setting environment variables for Transform Interface
Customizing the TCP/IP network firewall
Setting up security for transform resources
Creating a code page conversion table
Customizing NetSpool
Identifying software requirements for NetSpool
Updating the BPXPRMxx member of SYS1.PARMLIB
Editing the aopd.conf file for NetSpool
Customizing the NetSpool message log
Customizing the NetSpool startup procedure
Determining the number of NetSpool tasks to start
Using the Japanese version
Using an extended MCS console
Creating a user ID to assign to the NetSpool startup procedure
Steps for creating a RACF user ID with access to z/OS UNIX
Defining the NetSpool startup procedure to RACF
Editing the NetSpool startup procedure
Steps for editing the NetSpool startup procedure
APIJPJCL procedure
Working with JES spool limits
Changing Language Environment runtime options
Writing NetSpool exit and filter programs
Programming considerations
APIPP1X2 control block
Beginning of File exit for SCS data streams (APIPPTD1)
Input to APIPPTD1
Output from APIPPTD1
Examples
Beginning of File exit for 3270 data streams (APIUBF3)
Input to APIUBF3
Output from APIUBF3
Examples
Transparent Data Control exit (APIPPTD2)
Input to APIPPTD2
Output from APIPPTD2
Examples
Graphic Escape exit (APIUGEX)
Input to APIUGEX
Output from APIUGEX
Examples
Sample exits and macro
Installing the exits
Modifying the exits
Setting environment variables for NetSpool
Editing the system configuration definition for NetSpool
Customizing IP PrintWay
Comparing IP PrintWay extended mode to basic mode
Identifying software requirements for IP PrintWay
Editing the aopd.conf file for IP PrintWay (extended mode)
Increasing the space available in /var/Printsrv directory (extended mode)
Updating the BPXPRMxx member of SYS1.PARMLIB (extended mode)
Creating IP PrintWay job-selection rules (extended mode)
Creating job-selection rules in the Printer Inventory (extended mode)
Starting and stopping job-selection rules (extended mode)
Authorizing IP PrintWay to select data sets from the JES spool (extended mode)
Authorizing IP PrintWay to write SMF type 6 records (extended mode)
Setting environment variables for IP PrintWay (extended mode)
Editing the system configuration definition for IP PrintWay (extended mode)
APF-authorizing SYS1.IMAGELIB (extended mode)
Customizing from AFP transforms for IP PrintWay (extended mode)
Defining printer host names in the DNS
Customizing z/OS Communications Server
Customizing the TCPIP.DATA data set
Customizing the PROFILE.TCPIP data set
Customizing z/OS UNIX sendmail
Creating a VTAM APPL resource definition for IP PrintWay
Writing IP PrintWay exit and filter programs
Comparing IP PrintWay basic mode and extended mode exits
Resubmit for filtering considerations (basic mode)
Programming considerations
Common control blocks
JES job separator page data area (IAZJSPA)
Scheduler work block text unit (SWBTU)
IP PrintWay exit parameter area (ANFUEXTP)
Routing exit (ANFUXRTG)
Input to the Routing exit
Output from the Routing exit
Examples -- Routing exit
Begin Data Set exit
Input to the Begin Data Set exit
Output from the Begin Data Set exit
Examples -- Begin Data Set exit
Record exit
Input to the Record exit
Output from the Record exit
Examples -- Record exit
End Data Set exit
Input to the End Data Set exit
Output from the End Data Set exit
Examples -- End Data Set exit
SMF exit (ANFUXSMF)
Input to the SMF exit
Output from the SMF exit
Examples -- SMF exit
Message exit (ANFUXMSG) — basic mode
Input to the Message exit
Output from the Message exit
Examples -- Message exit
Response Notification exit (ANFUXRSP)
Input to the Response Notification exit
Output from the Response Notification exit
Examples
Using the block letter program (ANFUBLK)
Input to ANFUBLK
Output from ANFUBLK
IP PrintWay sample exits
Installing IP PrintWay exits
Modifying IP PrintWay exits
Updating the BPXPRMxx member of SYS1.PARMLIB (basic mode)
APF-authorizing SYS1.IMAGELIB (basic mode)
Defining the IP PrintWay functional subsystem (basic mode)
Determining how many functional subsystems to define (basic mode)
Determining how many functional subsystem applications to define (basic mode)
Determining work-selection criteria (basic mode)
Specifying a default font and page definition for data transforms (basic mode)
Defining the IP PrintWay functional subsystem in JES2 (basic mode)
Sample JES2 initialization statements
FSS(fss_name) statement
PRTnnnnn statement
Defining the IP PrintWay functional subsystem in JES3 (basic mode)
Sample JES3 initialization statements
FSSDEF statement
DEVICE statement
Creating FSS and FSA definitions in the Printer Inventory (basic mode)
Creating FSS definitions (basic mode)
Creating FSA definitions (basic mode)
Creating the transmission-queue data set (basic mode)
Sharing the transmission-queue data set (basic mode)
Allocating and initializing the transmission-queue data set (basic mode)
Restricting access to the transmission-queue data set (basic mode)
Creating the IP PrintWay message-log data set (basic mode)
Customizing the IP PrintWay startup procedure (basic mode)
Creating a user ID to assign to the IP PrintWay startup procedure (basic mode)
Defining the IP PrintWay startup procedure to RACF (basic mode)
Editing the ANFWPROC startup procedure (basic mode)
Steps for editing the IP PrintWay startup procedure
ANFWPROC procedure
Changing Language Environment runtime options (basic mode)
Customizing PSF for sharing network printers
Customizing Infoprint Central
Identifying software requirements for Infoprint Central
Editing the aopd.conf file for Infoprint Central
Initializing the search database
Customizing the z/OS HTTP Server
Editing the z/OS HTTP Server configuration file (httpd.conf)
Adding required directives
Protecting Infoprint Central web pages
Tuning the z/OS HTTP Server
Editing the z/OS HTTP Server environment variables file (httpd.envvars)
Setting up security for Infoprint Central
Authorizing the AOPOPER group to RACF profiles
Defining Infoprint Central users as z/OS UNIX users
Activating the PRINTSRV class
Authorizing users to read the Printer Inventory
Setting up security for printers
Protecting printers with profiles in the PRINTSRV class
Protecting PSF printers with profiles in the OPERCMDS class
Setting up security for NetSpool logical units (LUs)
Setting up security for IP PrintWay job-selection rules
Setting up security for print jobs
Protecting actions on print jobs with profiles in the OPERCMDS class
Protecting print jobs with profiles in the JESSPOOL class
Protecting the change priority action with a profile in the PRINTSRV class
Setting up security for Infoprint Server daemons
Setting up security for printer and printer pool definitions
Requesting RACF notification and auditing
Editing the system configuration definition for Infoprint Central
Customizing web browsers
Logging on to Infoprint Central from the web
Customizing PSF for z/OS to use the Printer Inventory
Customizing JES3 console standards (CONSTD statement)
Installing and customizing the Infoprint Server Windows client
Customizing the SNMP subagent
Identifying software requirements
Customizing and starting the z/OS Communications Server SNMP agent
Editing the aopd.conf file for the SNMP subagent
Editing the system configuration definition for the SNMP subagent
Enabling SNMP reporting in the Printer Inventory
Customizing the SNMP manager
Customizing PSF for z/OS to use the Printer Inventory
Identifying software requirements
Creating PSF FSS and FSA definitions in the Printer Inventory
Customizing PSF for z/OS to use the Printer Inventory
Customizing PSF for z/OS to write messages to the common message log
Checklist of Infoprint Server customization tasks
Infoprint Server files
aopd.conf -- Infoprint Server configuration file
Purpose
Format
Usage notes
aopmsg.conf -- Infoprint Server message configuration file
Purpose
Format
Usage notes
aoprxf.conf -- Infoprint Server remote transform configuration file
Purpose
Format
Usage notes
aopxfd.conf -- Infoprint Server transform configuration file
Purpose
Format
Example
Usage notes
aopsapd.conf -- Infoprint Server SAP callback daemon configuration file
Purpose
Format
Usage notes
Examples -- aopsapd.conf
Environment variables
Configuration attributes
AOPBATCH program
Format
Description
Parameters
Usage notes
Exit values
Examples -- AOPBATCH
Sample jobs
Application programming interface (API)
API files
API data structures
DocumentInfo - information about a document in a job
JobInfo - information about an Infoprint Server print job and each document in the job
JobToken - identifies an Infoprint Server print job
PrinterInfo - information about an Infoprint Server printer
QueryToken - identifies an Infoprint Server query request
Transform - information about a transform connection
API functions
Determining the API version number
Initializing and terminating the API
Creating a print job
Canceling a print job
Querying print jobs
Querying printers
Connecting to the Infoprint Server Transform Manager
Handling errors
AbortPrintFile -- terminate an Infoprint Server print job
Format
Description
Returned value
BeginEnumJobs -- begin an enumeration of Infoprint Server print jobs for a printer
Format
Description
Returned value
BeginEnumPrinters -- begin an enumeration of Infoprint Server printers
Format
Description
Returned value
BufferSizeRequired -- return the required size of the buffer after a buffer overflow error
Format
Description
Returned value
CancelJob -- cancel a print job
Format
Description
Returned value
ClosePrintFile -- close an Infoprint Server print job
Format
Description
Returned value
CreatePrintFile -- create an Infoprint Server print job
Format
Description
Returned value
EndEnumJobs -- end the enumeration of Infoprint Server print jobs for a printer
Format
Description
Returned value
EndEnumPrinters -- end the enumeration of Infoprint Server printers
Format
Description
Returned value
EnumJobs -- enumerate Infoprint Server print jobs for a printer
Format
Description
Returned value
EnumPrinters -- enumerate Infoprint Server printers
Format
Description
Returned value
ErrorNumber -- return the API error code
Format
Description
Returned value
ErrorString -- return a pointer to the API error message
Format
Description
Returned value
GetJobInfo -- return the status of an Infoprint Server print job
Format
Description
Returned value
Example
GetPrinterInfo -- return information about an Infoprint Server printer
Format
Description
Returned value
InitAPI -- initialize the API
Format
Description
Returned value
ReleaseTransform -- release a connection with a transform daemon
Format
Description
Returned value
RequestTransform -- establish a connection with a transform daemon
Format
Description
Returned value
SetTerminationHandler -- register a termination function
Format
Description
Returned value
TermAPI -- terminate the API
Format
Description
Returned value
WritePrintFile -- write data to an Infoprint Server print job
Format
Description
Returned value
Programming considerations
Redefining API function names
Linking to API functions
APF-authorizing your application
Writing a termination handler function
Customization requirements
Migrating from IP PrintWay basic mode to extended mode
Exploiting new functions in z/OS V2R1
Dynamic configuration
MVS system logger
SMF type 6 record enhancements
Glossary
Index for Infoprint Server Customization
Copyright IBM Corporation 1990, 2014
z/OS Infoprint Server Customization
z/OS Infoprint Server Customization
Copyright IBM Corporation 1990, 2014
