Table of Contents (exploded view)
Abstract for PSF for z/OS: Customization
Summary of changes
Understanding PSF for z/OS
PSF's capabilities
Printers supported by PSF
PSF support for intermediate devices
What is included with PSF
Optional programs
Tools and samples
Configuring the system for PSF for z/OS
Enabling PSF in the SYS1.PARMLIB member
Changing the system environment
Default PPT entry
Using channel-attached printers with PSF
Overview
Special considerations for using channel-attached printers
Sharing channel-attached printers
Parallel channel: two-channel switch feature
ESCON and FICON channel
Defining channel-attached printers
Basic definitions
Sharing parallel-channel printers with a two-channel switch
Sharing printers with an ESCON or FICON channel
Sharing printers through a director
Establishing network nodes for SNA-attached printers
Overview of a network
Defining the communications control unit to z/OS
Local-attached devices
Communication-attached devices
VTAM definitions for PSF network nodes
SNA devices, attachment mode, and requirements
VTAM syntax rules
Defining a PSF application node
Defining the logon-mode table entry
Local-attached entries (excluding InfoPrint Manager)
Communication-attached entries (excluding InfoPrint Manager and token ring)
Defining local major nodes
Defining switched major nodes
Defining network control program (NCP) major nodes
NCP generation
Switched line
Nonswitched line
Multipoint nonswitched line
Token-ring subsystem connection
General network considerations
Logon-mode table
VTAM definition names and PSF
LOGAPPL and the LU statement
Considerations for switched lines
AFCCU printer configuration
DPF considerations
PSF direct considerations
Connecting a TCP/IP-attached IPDS printer
Overview
Requirements for using a TCP/IP-attached IPDS printer
Migrating channel-attached printers to TCP/IP
Displaying intervention messages on the console
Displaying communications failure messages
Using commands to backspace and advance printer output
Connecting TCP/IP-attached printers
Modifying the TCP/IP profile in z/OS
Installing the i-data 7913 IPDS Printer LAN Attachment
Pinging the printer
Ping is not successful
Ping is successful
Defining the printer to JES
Defining the printer to PSF
Operating a TCP/IP-attached printer
Overview of the TCP/IP and PSF interface
Starting a TCP/IP-attached printer
Displaying TCP/IP status
Stopping a TCP/IP-attached printer
Understanding performance issues
Working with libraries
Library format
Concatenating defined libraries to system libraries
User libraries in deferred-printing mode
Controlling access to USERLIB libraries
Controlling access to USERPATH libraries
Constraints to dynamic allocation
Using the Infoprint Server Printer Inventory
Accessing the Printer Inventory
Customizing PSF to use the Printer Inventory
How PSF uses the Printer Inventory
Infoprint Central
Common message log
SNMP support
PSF parameters
Specifying Printer Inventory parameters
Specifying PRINTDEV parameters
Specifying AFPPARMS control statement parameters
How the AFPPARMS data set is allocated
How members in the data set are specified
Selection hierarchy for AFPPARMS parameters
Syntax of the AFPPARMS control statement
Parameters for the AFPPARMS control statement
APSJPRM1 sample member for AFPPARMS
Setting up MO:DCA IS/3 auxiliary pages
Using PSF parameters to attach and share printers
Selecting PSF parameters for a dedicated network-attached printer
Selecting PSF parameters for shared printers
JES spool-driven
VTAM release request
Port switching
Printer-controlled port switching
IPDS port switching
Recommended values for PSF timers
Using deferred-printing mode
Defining PSF FSSs and FSAs for printers
Sample initialization statements for JES2
Parameters for the JES2 initialization statement
FSS statement
PRTnnnn statement
Sample initialization statements for JES3
Parameters for the JES3 initialization statement
FSSDEF statement
DEVICE statement
PSF startup procedures for AFP printers
Sample PSF startup procedures
JCL for PSF startup procedures
PARM parameters on the EXEC statement
Starting PSF FSAs
Stopping PSF FSAs and FSSs
Issuing other operator commands
Identifying output from a printer
Separating jobs
Job separator pages
Additional distribution information
Separator page resources
Printing copies of a separator page
Distributed Print Function (DPF) considerations
PSF and DPF on a JES3 system
Forms marking
Forms marking of multiple-page job trailers
Forms marking of the interrupt message page
Carrier-strip marking
Copy marking and offset stacking
Suppressing copy marks
Separating copy marking and offset stacking
Separating data sets or copies of data sets
Disabled mechanisms
System Management Facilities type 6 records
Structure of SMF type 6 records
Using direct-printing mode
How to use direct-printing mode
Defining the DPSS
Application program JCL for direct-printing mode
Requesting multiple copies
3800 considerations
Managing resources
Maintaining resource integrity
How PSF selects resources
Selecting a forms flash for a 3800 printer
Selecting a copy group
Selecting form definitions, page definitions, and fonts
Form definitions in deferred-printing mode
Form definitions in direct-printing mode
Page definitions in deferred-printing mode
Page definitions in direct-printing mode
FOCA fonts in deferred-printing mode
FOCA fonts in direct-printing mode
TrueType and OpenType fonts in deferred-printing mode
TrueType and OpenType fonts in direct-printing mode
Searching for resources specified by a print job
Using form definitions for basic N_UP printing
Using form definitions for enhanced N_UP printing
Using PSF, the interface attachment feature, and the MICR postprocessor
Obtaining data about print file resources
Specifying the AFPSTATS repository
Understanding AFP performance
The printer
Mechanical speed
Internal processing speed
Attachment bandwidth
Paper size
Printer features
The print job
Data density and complexity
Characteristics of print data sets
Number and type of resources
Inline resources
Resident fonts
Font pruning of raster fonts
Captured fonts
Size of print jobs
Using outline fonts
Transmission and compression of data
The attachment hardware
Host-connected, channel-attached printer
Local-attached printer
Communication-attached printer
PSF Direct or Distributed Print Function (DPF)
PSF Direct
DPF
Size of the VTAM request unit (RU)
VTAM PSNDPAC and DELAY parameters
NCP MAXOUT value
TCP/IP-attached printer
The host system
Processing capability
Amount of real storage available
Capacity of the I/O subsystem
Selecting region sizes
Installation options
Requirements for each FSA
System tuning
Setting Workload Manager goals
Blank compression for line data
ACK per sheet
Printer data rate requirements
Printer data checks
Buffers
Block size
Data separation
Functional subsystem interface (FSI)
Checkpointing
Using PSF display functions
Displaying TCP/IP status
Displaying AFP Download Plus status
Displaying printer information
Requesting printer information with the PSF startup procedure
Allocating the partitioned data set
Specifying the DD statement
Viewing and printing the report
Requesting printer information with the MODIFY command
Finishing all pages in a job as a group
Enabling PSF for print job finishing
What if you don't want to finish all jobs sent to a printer
Things to consider when using print job finishing
Using cut-sheet emulation mode
How do I get cut-sheet emulation working
Do I have any control over using cut-sheet emulation
Will cut-sheet emulation work with 3800 Line-Mode Conversion
Things to consider when using cut-sheet emulation
Using Side and Edge Sensitive Paper Handling
Understanding side and edge sensitive paper
Existing support for side sensitive paper
Existing support for edge sensitive paper
Selecting input paper bins for simplex and duplex printing
Using Exit 7
Using the Printer Inventory
Handling job streams that are formatted at different resolutions
Multiple resolution printers
Printers with switchable resolution mode
Printers with automatic or auto-resolution mode
Resource libraries segmented for multiple resolution
Format resolution specified from the application
Specifying format resolution in JCL
Specifying format resolution in the print data stream
Specifying font fidelity in the print data stream
Specifying format resolution
Format resolution order
Understanding PSF data protection and security
Security labeling
Controlling print complete notification
Supporting resident fonts
PSF resident font table (APSRFTBL)
Changing APSRFTBL
PSF resident font utility—APSRMARK
APSRMARK considerations
Using APSRMARK
Syntax of APSRMARK control statements
APSRMARK control statement parameters for resident fonts
Using control statements to mark a font
APSRMARK control statement parameters (general)
Sample control statements for APSRMARK
Marking a member with resident font information
Generating a short report of resident font marking
Generating a long report of resident font marking
Diagnosing problems with printer-resident fonts
Marking fonts for font capture
Single-byte raster font capture
Single-byte outline font capture
Double-byte raster font capture
Double-byte outline font capture
TrueType and OpenType font capture
Using FOCA outline fonts
IBM’s font strategy
Understanding outline fonts
Sending default characters in single-byte outline fonts
Concatenating outline fonts with other library resources
Creating new fonts
Capturing new outline fonts
Font mapping
Mapping to outline fonts
Recovering from font not found
Timing of mapping operations
Mapping algorithms
Using the font mapping tables
Adding a new mapping of a raster font to an outline font
Adding a new mapping of an outline font to a raster font
Disabling the mapping of a raster font to an outline font
Adding a new mapping of a GRID to a raster font
Adding a new mapping of a GRID to an outline font
Using TrueType and OpenType Fonts
PSF limitations for TrueType and OpenType fonts
Obtaining TrueType and OpenType fonts
Setting up PSF to use TrueType and OpenType fonts
Marking resources for Distributed Print Function
Using APSRMARK to mark resources
Control-statement syntax for APSRMARK
Control-statement parameters for APSRMARK
Examples of control statements for APSRMARK
Creating a PSF resource library with all members marked PUBLIC
Creating a PSF resource library with some members marked PRIVATE
Modifying an existing PSF resource library
Printing a report of resource markings in a partitioned data set
Using page segments
Using DPF fonts and printer-resident fonts with APSRMARK
Changing how fonts are marked
Fonts already marked for use by DPF only
Fonts already marked for DPF and printer-resident use
Fonts already marked PRIVATE
Using resources for color management
PSF limitations for color management resources
Setting up PSF to use resources for color management
Using installation exits
General do’s and do not's
JCL for assembler exits
Specific do's and don'ts for C exits
JCL for C exits
Compiling a C exit
Prelinking a C exit
Link-editing a C exit
Link-editing APSUMACC and APSUTIMC
Changing exit routines
Installation exit control blocks
APSGEXTP area
Exit-communication areas: APSUECA and APSUECE
Sequence of exit invocation
Control flow with Exit 7
Separator-page exits: Exit 1, Exit 2, and Exit 3
Input for separator-page exits
Output for separator-page exits
Considerations for separator-page exits with multiple pages
Processing multiple-page job trailers with forms marking
Programming with separator-page exits
JES job-separator-page area—IAZJSPA
Exit table, APSUCOM
Block-letter tables, APSUBTBL
Service routines
Block-letter routine interface, APSUBLKC
Input for APSUBLKC
Output for APSUBLKC
Block-letter routine, APSUBLK
Input for APSUBLK
Output for APSUBLK
Programming considerations for APSUBLK
Exit-put routine interface, APSUPUTC
Input for APSUPUTC
Output for APSUPUTC
Exit-put routine, APSUPUT
Input for APSUPUT
Output for APSUPUT
SWBTUREQ macro-call routine, APSUMACC
Input for APSUMACC
Output for APSUMACC
TIME SVC routine, APSUTIMC
Input for APSUTIMC
Output for APSUTIMC
Logical-record processing exit: Exit 4
Input for Exit 4
Output for Exit 4
Programming considerations for Exit 4
SMF type 6 record exit: Exit 5
Input for Exit 5
Output for Exit 5
Programming considerations for Exit 5
Message exit: Exit 6
Input for Exit 6
Output for Exit 6
Programming considerations for Exit 6
Resource-management exit: Exit 7
Invoking Exit 7
Sequence of events
Exit 7 subroutine calls
Programming considerations for Exit 7
Page segment considerations
Special performance considerations
IOCA considerations
BCOCA, GOCA, and PTOCA considerations
Overlay considerations
Considerations on restartable abends
Considerations related to page definitions and form definitions
Processing considerations
Selection hierarchy
Considerations for ending the processing of data sets
Considerations related to user libraries
Considerations related to inline resources
Considerations for resource substitution
Considerations related to FOCA outline fonts
Initialization (INIT) call
Input and output indicators for INIT
Programming considerations for INIT
Begin-data-set call (BDSC)
Input and output indicators for BDSC
Programming considerations for BDSC
Resource-access call (RAC)
Input and output indicators for RAC
Programming considerations for RAC
RAC and overlays
RAC and page segments
RAC and fonts
Restrictions
RAC, page definitions, and form definitions
Using RAC in processing page definitions and form definitions
Resource-load call (RLC)
Input and output indicators for RLC
Programming considerations for RLC
Resource-deletion call (RDC)
Input and output indicators for RDC
Partial control of resource deletion
Full control of resource deletion
Using RDC to control resources
Termination call (TERM)
Input and output indicators for TERM
Line-mode migration exit: Exit 8
Input for Exit 8
Output for Exit 8
Programming considerations for Exit 8
Direct-printing, line-mode exit: Exit 14
Input for Exit 14
Output for Exit 14
Programming considerations for Exit 14
Print parameter exit: Exit 15
Input for Exit 15
Output for Exit 15
Programming considerations for Exit 15
Direct-print exit: Exit 16
Begin-data-set call (BDSC)
Input for Exit 16 begin-data-set call
Output for Exit 16 begin-data-set call
Message call for Exit 16
Input for Exit 16 message call
Output for Exit 16 message call
End-data-set call (EDSC)
Input for Exit 16 end-data-set call
Output for Exit 16 end-data-set call
Programming considerations for Exit 16
Recovering from print errors
Normal PSF recovery
Disposition of spool data sets during repositioning
Inhibiting PSF recovery
Printer-hardware problems
Responding to error conditions
Using PSF messages
Message data set
Printing PSF error messages
Redirecting the message data set
Interrupt message page
Operator messages
Stopping a printer FSA
Restarting from an abend
Requesting traces and memory dumps
Line-Mode Migration
Understanding Line-Mode Migration
Enabling Line-Mode Migration
Considerations and limitations of the Line-Mode Migration function
Considerations and limitations when using AFP Download Plus
3800 considerations
Font selection
Forms marking
Migration
Media origin
Line-Mode Conversion
What is IBM 3800 Line-Mode Conversion
How does 3800 Line-Mode Conversion work
How can PSF 3800 Line-Mode Conversion be enabled
Considerations and limitations of the 3800 Line-Mode Conversion function
Implementation checklist for PSF 3800 Line-Mode Conversion
Considerations when using AFP Download Plus
Supporting AFP output on microfilm
PSF hardware attachment requirements for microfilm devices
PSF system programmer tasks for microfilm devices
Defining the microfilm device as channel-attached or ESCON-attached
Defining the microfilm device to z/OS
Defining the microfilm device to JES2 and JES3
Defining the microfilm device to PSF
PRINTDEV parameters for microfilm devices
Sample JCL startup procedure for microfilm devices
Redirecting message data sets for microfilm jobs
Working with resource libraries required by microfilm devices
Working with the microfilm setup resource object container library
Working with FOCA font libraries
Managing resources and selecting special processing parameters
Generating microfilm setup resource object containers
Using the Font Library Update (FLU) utility
Considerations when using the FLU
Running the FLU
FLU return codes
Printing to microfilm
Operating a microfilm device
Microfilm data protection and security considerations for PSF
Using PSF installation exits for microfilm devices
Understanding PSF performance issues that pertain to microfilm devices
Responding to PSF errors reported by microfilm devices
Recovering or restarting AFP print jobs for microfilm
Migrating PSF parameters to the Printer Inventory
Running the migration program
Running the migration program using the aopmig command
Format
Description
Options
Usage notes
Example
Running the migration program from TSO
Using the migration program report
Running the Printer Inventory Definition Utility (PIDU)
Running the PIDU program using the pidu command
Running the PIDU program from TSO
Rerunning the migration program and the PIDU program
Viewing and editing the Printer Inventory
Printer information reports and system log output
Hardcopy report
Softcopy report
Softcopy record format
APSRMARK sample jobs
APSRMARK long report format
Data categories
Resource type
Internal ID
Time(Created)
Time(Revised)
Time(Marked)
Change Level
Management
Object Origin
Enabled For
FOCA font resource tables supplied by PSF
APSRFTBL font resource table
Field descriptions for Exit 7
XTP7 parameter area (DSECT)
XTP7 fields
APSLCRL parameter area (concatenation retrieval list)
APSLCRL fields
CRL data area
APSURLST parameter area (resource list)
APSURLST fields
RLSTFEXT parameter area (font extension area)
RLSTFEXT fields
Processing indicator cross-reference for Exit 7
APTRCONV resource conversion utility for VSE
Converting a resource
Reasonable resource loading values (RRLV)
Font conversion program, 240-pel to 300-pel (APSRCF30)
Understanding APSRCF30
Using APSRCF30
Error handling
APSRCF30 considerations
APSRCF30 sample jobs
Converting all 240-Pel fonts in source library (APSRAL30)
Input to APSRAL30
Output from APSRAL30
APSRAL30 processing
APSRAL30 considerations
Example for selected font conversion
Installation verification program example
PSF programming interfaces
Mapping tables for outline fonts
Installing the i-data 7913 IPDS Printer LAN Attachment
Understanding how the i-data 7913 IPDS Printer LAN Attachment works
Checking the i-data 7913 IPDS Printer LAN Attachment
Configuring the bootp daemon
Understanding how the bootp daemon works
Completing the bootp configuration worksheet
Editing the bootptab file
Example 1: Basic bootp configuration
Example 2: More complex bootp configuration
Setting up the bootp daemon on AIX
Configuring a twinaxial printer
Setting the controls for the i-data 7913 IPDS Printer LAN Attachment
IBM token-ring network model
Ethernet LAN model
Operating the i-data 7913 IPDS Printer LAN Attachment
Attaching the i-data 7913 IPDS Printer LAN Attachment
Starting the i-data 7913 IPDS Printer LAN Attachment
Shutting down the i-data 7913 IPDS Printer LAN Attachment
Testing the i-data 7913 IPDS Printer LAN Attachment
Troubleshooting the i-data 7913 IPDS Printer LAN Attachment
APSGPPCT point counting tool
Overview
Using the point counting tool
JCL for the point counting tool
PSF Tier Level Report
APSGPSPD printer speed table
Glossary