z/OS Infoprint Server Customization
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF


Customizing IP PrintWay

z/OS Infoprint Server Customization
SA38-0691-00

Customizing IP PrintWay

This information describes how to customize the IP PrintWay™ component of Infoprint Server. You must customize IP PrintWay if you want to transmit output data sets from the JES spool to (1) TCP/IP-attached ASCII printers or print servers, (2) VTAM-controlled printers in an SNA network, or (3) email destinations. For an overview of IP PrintWay and how this component fits into your system, see IP PrintWay.

You can run either IP PrintWay basic mode or IP PrintWay extended mode:

  • IP PrintWay basic mode uses the Functional Subsystem Interface (FSI) to obtain output data sets from the JES spool.
  • IP PrintWay extended mode uses the z/OS® Sysout Application Programming Interface (SAPI) to obtain output data sets from the JES spool.

Tip: Run IP PrintWay extended mode to obtain better performance, improved usability, and additional functions. IBM® does not plan to add new functions to IP PrintWay basic mode in future releases. For comparison information, see Comparing IP PrintWay extended mode to basic mode. For information about actions you need to take to migrate from IP PrintWay basic mode to extended mode, see Migrating from IP PrintWay basic mode to extended mode.

Table 27 summarizes the tasks to customize IP PrintWay extended mode. Required tasks are required by all installations. Optional tasks are required only if the listed condition applies.

Table 27. Customization tasks for IP PrintWay extended mode
Task (IP PrintWay extended mode)ConditionSee topic
Comparing IP PrintWay extended mode to basic modeRequiredComparing IP PrintWay extended mode to basic mode
Identifying software requirements for IP PrintWayRequiredIdentifying software requirements for IP PrintWay
Editing the aopd.conf file for IP PrintWay (extended mode)RequiredEditing the aopd.conf file for IP PrintWay (extended mode)
Increasing the space available in /var/Printsrv directory (extended mode)RequiredIncreasing the space available in /var/Printsrv directory (extended mode)
Updating the BPXPRMxx member of SYS1.PARMLIB (extended mode)RequiredUpdating the BPXPRMxx member of SYS1.PARMLIB (extended mode)
Creating IP PrintWay job-selection rules (extended mode)RequiredCreating IP PrintWay job-selection rules (extended mode)
Authorizing IP PrintWay to select data sets from the JES spool (extended mode)RequiredAuthorizing IP PrintWay to select data sets from the JES spool (extended mode)
Authorizing IP PrintWay to write SMF type 6 records (extended mode)RequiredAuthorizing IP PrintWay to write SMF type 6 records (extended mode)
Setting environment variables for IP PrintWay (extended mode)Optional: To customize IP PrintWay processingSetting environment variables for IP PrintWay (extended mode)
Editing the system configuration definition for IP PrintWay (extended mode)Optional: To specify dynamic attributesEditing the system configuration definition for IP PrintWay (extended mode)
APF-authorizing SYS1.IMAGELIB (extended mode)Optional: To use FCBsAPF-authorizing SYS1.IMAGELIB (extended mode)
Customizing from AFP transforms for IP PrintWay (extended mode)Optional: If you use the AFP to PCL or AFP to PostScript transformCustomizing from AFP transforms for IP PrintWay (extended mode)
Defining printer host names in the DNSRequiredDefining printer host names in the DNS
Customizing z/OS Communications ServerRequiredCustomizing z/OS Communications Server , Customizing z/OS Communications Server
Creating a VTAM APPL resource definition for IP PrintWayOptional: To print on VTAM-controlled printersCreating a VTAM APPL resource definition for IP PrintWay
Writing IP PrintWay exit and filter programsOptional: To customize IP PrintWay processingWriting IP PrintWay exit and filter programs
Customizing PSF for sharing network printersOptional: To share printers with PSFCustomizing PSF for sharing network printers

Table 28 summarizes the tasks to customize IP PrintWay basic mode. Required tasks are required by all installations. Optional tasks are required only if the listed condition applies.

Table 28. Customization tasks for IP PrintWay basic mode
Task (IP PrintWay basic mode)ConditionSee topic
Comparing IP PrintWay extended mode to basic modeRequiredComparing IP PrintWay extended mode to basic mode
Identifying software requirements for IP PrintWayRequiredIdentifying software requirements for IP PrintWay
Defining printer host names in the DNSRequiredDefining printer host names in the DNS
Customizing z/OS Communications ServerRequiredCustomizing z/OS Communications Server , Customizing z/OS Communications Server
Creating a VTAM APPL resource definition for IP PrintWayOptional: To print on VTAM-controlled printersCreating a VTAM APPL resource definition for IP PrintWay
Writing IP PrintWay exit and filter programsOptional: To customize IP PrintWay processingWriting IP PrintWay exit and filter programs
Updating the BPXPRMxx member of SYS1.PARMLIB (basic mode)Optional: To start multiple IP PrintWay FSAsUpdating the BPXPRMxx member of SYS1.PARMLIB (basic mode)
APF-authorizing SYS1.IMAGELIB (basic mode)Optional: To use FCBsAPF-authorizing SYS1.IMAGELIB (basic mode)
Defining the IP PrintWay functional subsystem (basic mode)RequiredDefining the IP PrintWay functional subsystem (basic mode)
Creating FSS and FSA definitions in the Printer Inventory (basic mode)Optional: To print on VTAM-controlled printers or to change default configuration optionsCreating FSS and FSA definitions in the Printer Inventory (basic mode)
Creating the transmission-queue data set (basic mode)RequiredCreating the transmission-queue data set (basic mode)
Creating the IP PrintWay message-log data set (basic mode)RequiredCreating the IP PrintWay message-log data set (basic mode)
Customizing the IP PrintWay startup procedure (basic mode)RequiredCustomizing the IP PrintWay startup procedure (basic mode)
Changing Language Environment runtime options (basic mode)Optional: To change default optionsChanging Language Environment runtime options (basic mode)
Customizing PSF for sharing network printersOptional: To share printers with PSFCustomizing PSF for sharing network printers

If you have already customized IP PrintWay to use the LPR or direct sockets transmission protocol and you now want to use the VTAM®, email, or IPP protocol, you need to do the additional customization tasks summarized in Table 29.

Table 29. Customization tasks for IP PrintWay protocols
Protocol
TaskLPRDirect socketsIPPVTAMEmailSee topic
Install Coax Printer SupportNoNoNoYesNoIdentifying software requirements for IP PrintWay
Create a VTAM APPL definitionNoNoNoYesNoCreating a VTAM APPL resource definition for IP PrintWay
Specify the IP PrintWay APPL ID in an FSS definition (basic mode)NoNoNoYesNoCreating FSS definitions (basic mode)
Specify the IP PrintWay APPL ID in the AOP_APPLID environment variable (extended mode)NoNoNoYesNoSetting environment variables for IP PrintWay (extended mode)
Customize z/OS UNIX sendmailNoNoNoNoYesCustomizing z/OS UNIX sendmail
Specify environment variables in the IP PrintWay startup procedure (basic mode)NoNoYesNoYesCustomizing the IP PrintWay startup procedure (basic mode)
Specify environment variables in the aopstart EXEC (extended mode)NoNoNoYesYesSetting environment variables for IP PrintWay (extended mode)

Table 30 lists other components of Infoprint Server that you might need to customize:

Table 30. Other components to customize for IP PrintWay
TaskConditionSee topic
Customizing the Printer Inventory ManagerRequiredCustomizing the Printer Inventory Manager
Customizing Infoprint CentralOptional but suggested (extended mode only)Customizing Infoprint Central
Customizing Transform InterfaceOptional: To transform data from one format to anotherCustomizing Transform Interface
Customizing the Print Interface LPDOptional: To transform data from one format to another (basic mode only)Common customization for Print Interface and Customizing the Print Interface LPD

Related tasks: After you customize IP PrintWay, do these tasks. For information about these tasks, see z/OS Infoprint Server Operation and Administration:

  • Create a printer definition in the Printer Inventory for each target printer and specify attributes required by IP PrintWay. To transform data, also specify attributes required by the transforms. IP PrintWay extended mode and basic mode use the same printer definitions.
  • Start IP PrintWay:
    • IP PrintWay basic mode: Start the IP PrintWay basic mode functional subsystems (FSAs).
    • IP PrintWay extended mode: Use either the aopstart command or the AOPSTART JCL procedure to start the IP PrintWay extended mode daemons.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014