Use the Create PSF Configuration (CRTPSFCFG) command to create a Print Services Facility (PSF) configuration object from the information specified on this command.

A PSF configuration object allows you to specify additional parameters for an AFP printer that are not supported on the Create Device Description (Printer) CRTDEVPRT command, such as setting the device release timer. The object type for a PSF configuration object is *PSFCFG.

Restrictions:

• The PSF feature is required to use this command.
• You must have input/output system configuration (*IOSYSCFG) special authority to use this command.

Parameters

Keyword	Description	Choices	Notes
PSFCFG	PSF configuration	Qualified object name	Required, Positional 1
	Qualifier 1: PSF configuration	Name
	Qualifier 2: Library	Name, *CURLIB
USRRSCLIBL	User resource library list	*JOBLIBL, *CURLIB, *NONE	Optional
DEVRSCLIBL	Device resource library list	Single values: *DFT Other values (up to 30 repetitions): Name	Optional
IPDSPASTHR	IPDS pass through	*NO, *YES	Optional
ACTRLSTMR	Activate release timer	*NORDYF, *IMMED, *PRTNORDYF, *PRTIMMED	Optional
RLSTMR	Release timer	1-1440, *NOMAX, *SEC15, *SEC30	Optional
RESTRTMR	Restart timer	1-1440, *IMMED	Optional
RETRY	APPC and TCP/IP retry count	1-99, 15, *NOMAX	Optional
RETRYDLY	Delay between APPC retries	0-999, 90	Optional
ACKFRQ	Acknowledgment frequency	1-32767, 100	Optional
PRTRSPTMR	Printer response timer	5-3600, *NOMAX	Optional
PDFGEN	Generate PDF output	Single values: *NONE Other values (up to 3 repetitions): *SPLF, *STMF, *MAIL	Optional
PDFDEVTYPE	PDF device emulation type	*IP40240, *IP40300, *P4028, *P3812	Optional
PDFPPRDWR1	PDF paper size drawer 1	*LETTER, *LEGAL, *STATEMENT, *EXECUTIVE, *LEDGER, *A5, *A4, *A3, *B5, *B4	Optional
PDFPPRDWR2	PDF paper size drawer 2	*LETTER, *LEGAL, *STATEMENT, *EXECUTIVE, *LEDGER, *A5, *A4, *A3, *B5, *B4	Optional
PDFMULT	Multiple PDF files	Single values: *NO Other values: Element list	Optional
	Element 1: Acknowledge multiple groups	*YES
	Element 2: Process option	*SPLIT, *INDEX
PDFINCFNT	PDF fonts inline	*YES, *NO	Optional
PDFDTAQ	PDF data queue	Single values: *NONE Other values: Qualified object name	Optional
	Qualifier 1: PDF data queue	Name
	Qualifier 2: Library	Name
PDFMAILSVR	PDF mail server name	Single values: *SNDDST Other values (up to 4 repetitions): Character value, *LOCAL	Optional
PDFSENDER	Sender of electronic mail	Name, *SPLFOWN, QSPLJOB	Optional
PDFADMIN	PDF administrator	Character value, *NONE	Optional
PDFMAPPGM	PDF user program	Single values: *NONE, *IBMPGM Other values: Qualified object name	Optional
	Qualifier 1: PDF user program	Name
	Qualifier 2: Library	Name
PDFMAP	PDF mapping object	Single values: *NONE Other values: Qualified object name	Optional
	Qualifier 1: PDF mapping object	Name
	Qualifier 2: Library	Name
PDFOUTQ	PDF output queue	Qualified object name	Optional
	Qualifier 1: PDF output queue	Name
	Qualifier 2: Library	Name
PDFDIR	PDF directory	Character value	Optional
AFPSAVE	Save AFP data	*NO, *YES	Optional
AFPOUTQ	AFP output queue	Qualified object name	Optional
	Qualifier 1: AFP output queue	Name
	Qualifier 2: Library	Name
TEXT	Text 'description'	Character value, *BLANK	Optional
AUTOSSNRCY	Automatic session recovery	Single values: *NO Other values: Element list	Optional
	Element 1: Enabled	*YES
	Element 2: Message option	*INFO, *INQ
BLANKPAGE	Blank page	*YES, *NO	Optional
PAGSIZCTL	Page size control	*NO, *YES	Optional
RESFONT	Resident fonts	*YES, *NO	Optional
RSCRET	Resource retention	*YES, *NO	Optional
EDGEORIENT	Edge orient	*YES, *NO	Optional
USEOUTLFNT	Use outline fonts	*YES, *NO	Optional
PSFDFNOPT	PSF defined option	Single values: *NONE Other values (up to 6 repetitions): Character value, *NONE	Optional
FNTSUBMSG	Font substitution messages	*YES, *NO	Optional
FNTCAPTURE	Capture host fonts at printer	*NO, *YES	Optional
FNTRSL	Font resolution for formatting	*SEARCH, 240, 300	Optional
FNTTBL	Font mapping table	Single values: *NONE Other values: Qualified object name	Optional
	Qualifier 1: Font mapping table	Name
	Qualifier 2: Library	Name
CSEMODE	Cut sheet emulation mode	*NONE, *CHKFIRST, *CHKALL	Optional
MAPIGCFNT	Use DBCS simulation fonts	*YES, *NO	Optional
REPLACE	Replace	*YES, *NO	Optional
AUT	Authority	Name, *LIBCRTAUT, *CHANGE, *ALL, *USE, *EXCLUDE	Optional

Top

PSF configuration (PSFCFG)

Specifies the Print Services Facility (PSF) configuration object to be created.

This is a required parameter.

Qualifier 1: PSF configuration

name

Specify the name of the PSF configuration object to be created.

Qualifier 2: Library

*CURLIB

Store the PSF configuration object in the current library. If no library is specified as the current library for the job, the QGPL library is used.

name

Specify the name of the library where you want to store the PSF configuration object.

User resource library list (USRRSCLIBL)

Specifies the user resource library list to use when searching for AFP resources. When searching for an AFP resource specified with a spooled file, Print Services Facility (PSF) first searches the libraries in the user resource library list and then those in the device resource library list.

*PRTF has been removed as a valid value for the USRRSCLIBL parameter. PSF configuration objects migrated from other releases that were created with USRRSCLIBL(*PRTF) will be supported exactly as in prior releases as long as the new USRRSCLIBL parameter on the printer file has the a value of *DEVD. When a CHGPSFCFG command is run in this environment, a value of *SAME will be displayed where a value of *PRTF would have been displayed on a prior release.

*JOBLIBL

Use the library list for the job that created the spooled file when searching for AFP resources. Each time the user creates a new spooled file, the job library list at that point in time is saved.

*CURLIB

Use the current library for the job that created the spooled file when searching for AFP resources. If no library is specified as the current library for the job, then the QGPL library is used.

*NONE

No user resource library list is used for searching for AFP resources. Only the device resource library list is used.

Device resource library list (DEVRSCLIBL)

Specifies the device resource library list to use when searching for AFP resources. When searching for an AFP resource specified with a spooled file, Print Services Facility (PSF) first searches the libraries in the user resource library list and then the libraries in the device resource library list.

Single value

*DFT

PSF searches these libraries, if they exist, when searching for AFP resources:

• QFNTCPL
• QFNT01 - QFNT19
• QFNT61 - QFNT69

Note: If not all the system libraries in the above list have been created, a user can create libraries using the names of the missing system libraries. If this occurs and you specify *DFT on the DEVRSCLIBL parameter, the resources in those user-created libraries could be mistakenly found by other users. To prevent this, the system administrator should create all of the missing system libraries with PUBLIC *USE authority.

Other values

name

Specify up to 30 names of libraries PSF will use to search for AFP resources.

IPDS pass through (IPDSPASTHR)

Specifies whether IPDS pass-through is done for the device. IPDS pass-through is a mechanism by which unnecessary datastream conversions can be eliminated, thus improving throughput and decreasing CPU utilitization. Full page-level error recovery is supported.

IPDS pass-through can be used for SCS and IPDS files which do not specify any AFP processing features, such as a front or back overlay on the printer file. SCS data is transformed to a generic IPDS. Specifying IPDS pass-through on the device configuration or printer file allows only those spooled files eligible for IPDS pass-through to bypass the extra transforms. Those spooled files not eligible for IPDS pass-through will still undergo the transforms to AFPDS and back to IPDS.

*NO

No IPDS pass-through is done.

*YES

IPDS pass-through is performed for the device for all spooled files that are eligible for IPDS pass-through.

IPDS pass-through is not valid for all Print Services Facility (PSF) supported printers. Only printers that support resident fonts can be used with IDPS pass-through. If a printer does not support resident fonts, font references in the data stream must be mapped to host fonts, which are then downloaded to the printer. This requires the transform to AFPDS and back to IPDS.

The following IPDS printers cannot support IPDS pass-through:

• 3820, 3825, 3827, 3828, 3829, 3831, 3835, 3900-001
• Any Distributed Print Function (DPF)-attached printer. DPF is a function supported by Infoprint Manager for Windows NT and Windows 2000, which blocks the use of printer-resident fonts.

Activate release timer (ACTRLSTMR)

Specifies the point at which the release timer is activated. The value specified for Release timer (RLSTMR) determines the length of time the writer will "keep" the printer before releasing the session.

*NORDYF

The release timer is activated when there are no ready (RDY) spooled files in the printer's output queue and the last page of the last spooled file processed has printed. If the release timer expires, the session to the printer is released but the writer does not end. When the session is released, another Print Services Facility (PSF) can start a session to the printer.

Use this value when you want the writer to print all ready spooled files before releasing the session.

*NORDYF is supported only for printers and devices attached to the system using APPC or TCP/IP. For an APPC connection, use this value only with the PSF Direct support provided by Infoprint Manager for AIX or Infoprint Manager for Windows NT and Windows 2000. For a TCP/IP connection, this value can be used for any printer. This value is not supported for twinaxial-attached printers.

*IMMED

The release timer is activated immediately after PSF has successfully linked to the printer. If the release timer expires, the session to the printer is released but the writer does not end. If a file is being printed when the release timer expires, the writer releases the session after all pages of the spooled file have printed. When the session is released, another PSF can start a session to the printer.

Use this value when you want the writer to share the printer with another print writer.

*IMMED is supported only for printers and devices attached to the system using APPC or TCP/IP. For an APPC connection, use this value only with the PSF Direct support provided by Infoprint Manager for AIX or Infoprint Manager for Windows NT and Windows 2000. For a TCP/IP connection, this value can be used for any printer. This value is not supported for twinaxial-attached printers.

*PRTNORDYF

This value can be specified if you are using a printer that allows control over the exchange of IPDS data (the IPDS dialog). Refer to Printer Information, S544-5750 to determine if your printer supports this feature.

This value specifies that the release timer is to be activated after all of these conditions are met:

• The writer receives an indication from the printer to release the IPDS dialog.
• There are no ready spooled files in the printer's output queue.
• The last page of the last spooled file processed has printed.

If the release timer expires, the writer releases the IPDS dialog with the printer. The session is not released and the port in use by the writer is not available to another PSF. Another printer driver can start a dialog with the printer on a different printer port.

If the writer detects that the printer is not capable of controlling the IPDS dialog, then the value is ignored and PSF behaves as if RLSTMR(*NOMAX) was specified.

Use this value when you want the writer to print all ready spooled files with before releasing the IPDS dialog.

*PRTNORDYF is supported on a twinaxial, TCP/IP or APPC connection.

*PRTIMMED

This value can be specified if you are using a printer that allows control over the exchange of IPDS data (the IPDS dialog). Refer to Printer Information, S544-5750 to determine if your printer supports this feature.

This value specifies that the release timer is to be activated immediately after the writer receives an indication from the printer to release the IPDS dialog. If the release timer expires, the writer releases the IPDS dialog with the printer, but the session is not released. The port in use by the writer is not available for use by another PSF, however another printer driver can start a dialog with the printer on a different printer port. If a file is being printed when the release timer expires, the writer releases the dialog after all pages of the spooled file have printed.

Use this value when you want to specify the length of time the writer controls the printer after the printer has indicated that it is needed by a printer driver at another printer port.

If the writer detects that the printer is not capable of telling the writer to stop the flow of data, then this value is ignored, and PSF behaves as if RLSTMR(*NOMAX) was specified.

*PRTIMMED is supported on a twinaxial, TCP/IP or APPC connection.

Release timer (RLSTMR)

Specifies the amount of time to wait after the release timer has been activated and the last page of the last ready spooled file has printed before releasing the printer. Print Services Facility (PSF) does not end, but releases the connection or IPDS dialog with the printer. See the Activate release timer (ACTRLSTMR) parameter description for additional information on the release timer.

When a spooled file becomes ready, PSF attempts to establish a session with the printer. See the Restart timer (RESTRTMR) parameter description for additional information.

*NOMAX

The printer is not released unless the End Writer (ENDWTR) command is run.

*SEC15

PSF waits 15 seconds before releasing the printer.

*SEC30

PSF waits 30 seconds before releasing the printer.

1-1440

Specify the number of minutes the printer writer waits before releasing the printer or IPDS dialog.

Restart timer (RESTRTMR)

Specifies the amount of time to wait before the printer writer attempts to re-establish either a session or dialog. To determine whether a session or dialog is to be re-established, the printer writer considers the following:

• The value specified for ACTRLSTMR.
• Whether the printer supports IPDS dialog management.
• The type of link: twinaxial, APPC or TCP/IP.

If ACTRLSTMR(*NORDYF) or ACTRLSTMR(*IMMED) are specified, the session is restarted if the printer is attached using APPC or TCP/IP.

If ACTRLSTMR(*PRTNORDYF) or ACTRLSTMR(*PRTIMMED) are specified, the dialog is restarted if the printer supports dialog management.

See the Activate release timer (ACTRLSTMR) parameter description for additional information about session and dialog management control.

*IMMED

The printer writer attempts to re-establish the session or dialog as soon as a spooled file has a status of RDY.

1-1440

Specify the number of minutes the printer writer waits, after a session or dialog have been released and a spooled file has a status of RDY, before attempting to connect.

APPC and TCP/IP retry count (RETRY)

Specifies the number of times to retry a session start request when attempting to establish a session with a printer. This parameter applies to printers and devices configured for either TCP/IP or APPC.

15

Fifteen retry attempts are made to establish a session. If after fifteen retries Print Services Facility (PSF) still cannot establish a session, the printer writer ends.

*NOMAX

No limit is put on the number of retries. PSF continues issuing session start requests until the session is established or the printer writer is ended using ENDWTR OPTION(*IMMED).

1-99

Specify the number of retry attempts to establish a session.

Delay between APPC retries (RETRYDLY)

Specifies the number of seconds Print Services Facility (PSF) pauses after it receives notification that a session start request has failed. After the specified time has elapsed, another session start request is issued. The number of retries performed by PSF is controlled by parameter RETRY. This parameter applies to printers and devices configured for APPC.

90

A 90-second delay will be used between retry attempts.

0-999

Specify the number of seconds to pause between retry attempts to establish a session.

Acknowledgment frequency (ACKFRQ)

Specifies the frequency, in pages, with which Print Services Facility (PSF) sends IPDS acknowledgment requests to a printer. The acknowledgment request responses from the printer contain information about the status of pages sent to the printer.

If a spooled file contains fewer pages than specified for ACKFRQ, an acknowledgment is requested after the last page of the spooled file is sent.

Consider adjusting this value when specifying AUTOSSNRCY(*YES). When a connection with a printer is abnormally ended, PSF may reprint pages because the printer was unable to return the status of pages printed. By increasing the frequency with which acknowledgments are sent, the number of pages which might be reprinted is decreased when a severed connection is restored. However, if acknowledgments are requested with great frequency, such as once per page, you may notice a performance degradation.

Acknowledgment frequency is supported on all attachments: twinaxial, APPC and TCP/IP. Note that AUTOSSNRCY is supported on APPC and TCP/IP attachments only.

100

Specifies that an acknowledgment request is sent to the printer after every 100 pages.

1-32767

Specifies the number of pages after which PSF sends an acknowledgment request to the printer.

Printer response timer (PRTRSPTMR)

Specifies the time, in seconds, to wait for a response from a TCP/IP attached printer.

*NOMAX

The printer writer will wait for a response from the printer until one is received. If the writer does not receive a message, it is never ended.

5-3600

Specifies the time, in seconds, the printer writer should wait for a response from the printer. The writer is ended if the printer does not respond within the specified amount of time. If this happens, the writer ends and a message is sent to the message queue.

Generate PDF output (PDFGEN)

Specifies whether to generate a PDF output file through an IPDS to PDF transform when processing the spooled file. You can spool the generated PDF file, store it as a stream file, send it as electronic mail, or any combination of those. You must have Infoprint Server installed to support this feature.

In order to generate PDF, the remote location name for the printer device description must either be a valid loopback address or a name associated with a valid loopback address. An Internet address representing a valid loopback address must have 127 as the first octet of the Internet address.

Single value

*NONE

Do not generate a PDF output file.

Other values (up to 3 repetitions)

*SPLF

Place the generated PDF output file in a spooled file. The value specified for the PDF output queue (PDFOUTQ) parameter identifies the output queue to be used.

*STMF

Place the generated PDF output file in a stream file. The value specified for the PDF directory (PDFDIR) parameter identifies the integrated file system (IFS) directory to be used.

*MAIL

Electronically mail the PDF output file.

PDF device emulation type (PDFDEVTYPE)

Specifies the type of device that the IPDS to PDF transform's virtual printer should emulate.

*IP40240

Emulate an IP40 printer device configured at 240 pel resolution.

*IP40300

Emulate an IP40 printer device configured at 300 pel resolution.

*4028

Emulate a 4028 printer device.

*3812

Emulate a 3812 printer device.

PDF paper size drawer 1 (PDFPPRDWR1)

Specifies the size of paper in drawer one of the device associated with the IPDS to PDF transform. This information is used to determine the generated PDF page size.

*LETTER

North American letter size media (8.5 x 11 inches).

*LEGAL

North American legal size media, (8.5 x 14 inches).

*STATEMENT

North American statement size media (5.5 x 8.5 inches).

*EXECUTIVE

North American executive size media (7.5 x 10.5 inches).

*LEDGER

North American ledger size media (11 x 17 inches).

*A5

ISO A5 size media (148.5 x 210 mm).

*A4

ISO A4 size media (210 x 297 mm).

*A3

ISO A3 size media (297 x 420 mm).

*B5

ISO B5 size media (176 x 250 mm).

*B4

ISO B4 size media (257 x 364 mm).

PDF paper size drawer 2 (PDFPPRDWR2)

Specifies the size of paper in drawer two of the device associated with the IPDS to PDF transform. This information is used to determine the generated PDF page size.

*LETTER

North American letter size media (8.5 x 11 inches).

*LEGAL

North American legal size media, (8.5 x 14 inches).

*STATEMENT

North American statement size media (5.5 x 8.5 inches).

*EXECUTIVE

North American executive size media (7.5 x 10.5 inches).

*LEDGER

North American ledger size media (11 x 17 inches).

*A5

ISO A5 size media (148.5 x 210 mm).

*A4

ISO A4 size media (210 x 297 mm).

*A3

ISO A3 size media (297 x 420 mm).

*B5

ISO B5 size media (176 x 250 mm).

*B4

ISO B4 size media (257 x 364 mm).

Multiple PDF files (PDFMULT)

Specifies the action the IPDS to PDF transform should take when encountering multiple groups within the input data.

Single value

*NO

Ignore group boundaries and create a single output file.

Element 1: Acknowledge multiple groups

*YES

Process multiple groups with the IPDS to PDF transform based on the value specified for element 2 of this parameter.

Element 2: Process option

*SPLIT

Multiple PDF output files will be generated. The file will be split at group boundaries.

*INDEX

An index tag or bookmark will be placed at the group boundaries in a single output file.

If *INDEX is requested, bookmarks will be labeled according to:

• the group name on the DDS STRPAGGRP keyword or
• index entries generated by CRTAFPDTA or
• BNG tags inserted by Toolbox

If characters in the group name are not available in the standard PDF encoding they will be presented as a space.

PDF fonts inline (PDFINCFNT)

Specifies whether the PDF output generated by the IPDS to PDF transform carries the necessary fonts inline. Including the fonts inline guarantees font fidelity but increases the PDF file size.

If the user chooses not to have the fonts embedded, the IPDS Type 1 font name character string is moved to the PDF font controls. When the document is viewed the Acrobat Reader will map IBM's core font names to the equivalent Adobe or client environment set of core fonts. For any font name character strings that Adobe Acrobat does not have an equivalent for, Adobe Acrobat will use the Adobe multi-master font substitution program to select the available font that will constitute the "best fit".

*YES

The fonts should be carried inline with the PDF output.

*NO

The fonts should not be carried inline with the PDF output.

PDF data queue (PDFDTAQ)

Specifies the name of the data queue where Print Services Facility (PSF) will log the IPDS to PDF transformation completion notifications.

This parameter is optional, but if a data queue is specified, the data queue must exist when this command is run.

Single value

*NONE

IPDS to PDF transformation completion notifications will not be logged to any data queue.

Qualifier 1: PDF data queue

name

Specify the name of the data queue to be used.

Qualifier 2: Library

name

Specify the name of the library where the data queue is located.

PDF mail server name (PDFMAILSVR)

Specifies which mail server to use for electronically mailing the resulting PDF file from the IPDS to PDF transform. This parameter is only valid if PDFGEN(*MAIL) is specified.

Single value

*SNDDST

Use the Send Distribution (SNDDST) command to e-mail the PDF output.

Other values (up to 4 repetitions)

*LOCAL

Use the local machine as the mail server. The SMTP protocol is used for sending the e-mail. You can specify *LOCAL in any position in the list of mail servers.

character-value

Specify the domain name or Internet address of the mail server to use to electronically mail the PDF output.

You can specify up to 4 mail servers. The writer uses the mail servers in the order in which they are listed. If the writer detects that the first mail server cannot be used, the writer will attempt to use the additional servers that have been specified in the list. Print Services Facility (PSF) internally reorganizes the list of servers, making certain to always first attempt to use the last server that was working.

If no usable server can be found in the list, the action taken is determined by the value specified for the PRTERRMSG parameter of the printer device description. If PRTERRMSG(*INFO) is specified, the writer is ended. If PRTERRMSG(*INQ) is specified, then an inquiry message is issued.

Sender of electronic mail (PDFSENDER)

Specifies the name to use as the sender for a PDF file sent by electronic mail.

*SPLFOWN

Print Services Facility (PSF) uses the user profile for the spooled file's owner to obtain the sender of the electronic mail.

QSPLJOB

The electronic mail is being sent from PSF.

name

Specify a valid user profile. PSF uses this user profile to obtain the sender of the electronic mail.

When PSF uses a user profile to determine the electronic mail sender, the user profile must exist on the system and must have an entry in the System Distribution Directory with a user ID specified. If you are using an SMTP mail server to send the mail, the directory entry must also have an SMTP user ID. If the profile has an SMTP User ID, that User ID is used as the sender, even if you use SNDDST to send the mail. Otherwise, if you use SNDDST to send the mail and there is no SMTP User ID, the profile's User ID is used.

For example, if user profile MY_PROFILE has a User ID of JIM and an SMTP User ID of JIMJ, the electronic mail sender is JIMJ, regardless of the mail server used. If the user profile had no SMTP User ID and you use SNDDST to send the mail, the electronic mail sender is JIM.

PDF administrator (PDFADMIN)

Specifies the e-mail address for the designated PDF administrator. The administrator will be notified when files cannot be delivered to the designated destination. Not all failures will be recoverable, as some errors occur after control of the delivery has passed to other components of the system. For example, the PDF administrator is not notified of undeliverable e-mails.

*NONE

No PDF administrator is specified. If e-mail notification was to be sent to a PDF administrator, the notification will not be sent.

'character-value'

Specify no more than 80 characters of text that constitutes a valid e-mail address, enclosed in apostrophes.

PDF user program (PDFMAPPGM)

Specifies the name of a mapping program that Print Services Facility (PSF) will call to customize the PDF transform, such as specifying encryption or, when the PDF is being sent as e-mail, resolving one or more mail tags in the spooled file. If a mapping program is not specified, PSF assumes that the mail tag is a valid electronic mail address and will attempt to send the file using the information in the mail tag.

The PSF configuration object will not be created if the mapping program specified does not exist. If the mapping program is deleted before the spooled file is processed, the PDF output file will be deleted, an error message will be issued to the message queue associated with the printer writer, and the original spooled file will be held.

Single values

*NONE

No mapping program will be used to customize the PDF transform.

*IBMPGM

The default IBM-supplied mapping program will be used to customize the PDF transform. If the value *IBMPGM is specified, you must also specify a value for the PDFMAP parameter.

Qualifier 1: PDF user program

name

Specify the name of the user mapping program to be used.

Qualifier 2: Library

name

Specify the name of the library where the user mapping program is located.

PDF mapping object (PDFMAP)

Specifies the name of a mapping object that Print Services Facility (PSF) will pass to the PDF mapping program. If no mapping object is specified, PSF assumes that the mapping program does not require one. A mapping object is required if *IBMPGM is specified as the mapping program on the PDFMAPPGM parameter. Also, if you specify a mapping object, you must specify *IBMPGM on the PDFMAPPGM parameter.

The PSF configuration object will not be created if the mapping object specified does not exist. If the mapping object is deleted before the spooled file is processed, the PDF output file will be deleted, an error message will be issued to the message queue associated with the printer writer, and the original spooled file will be held.

Single value

*NONE

No mapping object will be passed to the specified mapping program to resolve file destination.

Qualifier 1: PDF mapping object

name

Specify the name of the user mapping object.

Qualifier 2: Library

name

Specify the name of the library where the user mapping object is located.

PDF output queue (PDFOUTQ)

Specifies the output queue to be used when *SPLF is specified for the Generate PDF output (PDFGEN) parameter. A value is required for this parameter when *SPLF is specified for the PDFGEN parameter.

Qualifier 1: PDF output queue

name

Specify the name of the output queue to be used.

Qualifier 2: Library

name

Specify the name of the library where the output queue is located.

PDF directory (PDFDIR)

Specifies the path where the PDF file should be stored. An integrated file system directory must be specified when *STMF is specified for the PDFGEN parameter. The name must begin with a /. The directory name in the path cannot contain any of the following characters: \ < > " ? : * |

The subdirectories and files created by the transform will be owned by the original spooled file owner and will have public authority of *EXCLUDE.

If you want to e-mail this file later, specify QDLS/directory-name for the PDF directory. This will cause your file to be stored in the following location:

/QDLS/directory-name/job-name/job-number/job-user-name/file-number/date/sequence-number/

For storage in the root file system, simply specify the subdirectory where the file should be stored (directory-name). This will cause your file to be stored in the following location:

/directory-name/job-name/job-number/job-user-name/job-number_file-number_date_sequence-number/

Note: The last subdirectory is a concatenation of a number of values to guarantee a unique file name.

The file name components are explained below:

• job-name The ten character job name of the original spooled file
• job-number The job number assigned to the original spooled file, prefixed by the last two characters of the job name
• job-user-name The ten character name of the original spooled file owner
• file-number The file number of the original spooled file, prefixed by the last two characters of the job-user-name
• date The two digit month appended to the two digit day appended to the four digit year when the PDF transform completed
• sequence-number A six character sequence number. It will be set to 000001 if PDFMULT is *NO. If PDFMULT is *YES, the sequence number is incremented to uniquely identify each PDF file generated for the job.

'character-value'

Specify the name of the integrated file system (IFS) directory to be used.

Save AFP data (AFPSAVE)

Specifies whether the Print Services Facility (PSF) product should activate the capability to retain the generated AFPDS file on an output queue upon completion of processing. This parameter specifies that PSF should generate an AFPDS file from an SCS, AFPDS, IPDS, PostScript, PCL, or PDF input data stream and place the AFPDS on an output queue. The output queue will be determined by a user exit program in the case of segmented print requests, or by the value provided by the AFPOUTQ parameter in the PSF configuration object. The AFPOUTQ parameter is required if AFPSAVE is set to *YES.

This setting will be ignored for input data streams of line and mixed mode data and when IPDS passthrough is active. You must have Infoprint Server installed to support PostScript, PCL, and PDF input data streams.

Note: If you are not processing segmented print requests using a PDF mapping program, you must also specify a value for the AFPRESPOOL argument to the USRDFNDTA parameter when submitting your print request for this function to be performed. Refer to Printer Device Programming, SC41-5713 for more information on using the USRDFNDTA parameter.

*NO

The file should not be saved after processing has been completed.

*YES

The generated AFPDS file may be saved after processing has been completed. For the AFPDS file to be saved, the input data stream must support the saving of AFPDS data and must meet one of these conditions:

• The print request is segmented and the PDF mapping program requests that the segment be respooled.
• The print request is not segmented and the user has specified the AFPRESPOOL argument in the USRDFNDTA parameter on the print request.

AFP output queue (AFPOUTQ)

Specifies the output queue to use when *YES is specified for the Save AFP data (AFPSAVE) parameter. A value is required for this parameter when *YES is specified for the AFPSAVE parameter. Segmented print requests using a PDF mapping program can override this value.

Qualifier 1: PDF output queue

name

Specify the name of the output queue to use.

Qualifier 2: Library

name

Specify the name of the library where the output queue is located.

Text 'description' (TEXT)

Specifies the text that briefly describes the Print Services Facility (PSF) configuration object.

*BLANK

No text is specified.

'text description'

Specify no more than 50 characters of text, enclosed in apostrophes.

Automatic session recovery (AUTOSSNRCY)

Specifies whether Print Services Facility (PSF) will automatically attempt to resume printing when a session has been unexpectedly ended by a device. This parameter applies to devices configured in a printer device description for an APPC or TCP/IP attachment.

Single value

*NO

Specifies that PSF ends when a session has been unexpectedly ended by a device.

Element 1: Enabled

*YES

Specifies that PSF attempts to re-establish a session which has been unexpectedly ended by a device.

If you are using a printer device description which specifies an APPC attachment, note the following:

• PSF configuration object parameters RETRY and RETRYDLY are used when PSF is attempting to re-establish a session.
• You must use an APPC controller description and an APPC device description that specifies APPN(*YES). Additionally, the APPC controller description must have MINSWTSTS(*VRYONPND) specified.

If you are using a printer device description which specifies a TCP/IP connection, then PSF configuration object parameter RETRY is used when PSF is attempting to re-establish a session.

To avoid reprinting pages, you may want to specify *INQ for this parameter's second element or decrease the value specified for the Acknowledgment frequency (ACKFRQ) parameter.

If you decrease the Acknowledgment frequency, PSF will be able to track printed pages more closely. However, there could be some degradation in performance. This depends on your network and your perception of the performance.

If you select inquiry message notification (*INQ), then you can be very specific about the page at which printing should resume.

Element 2: Message option

*INFO

An informational message is sent to the message queue associated with the writer when PSF is performing automatic session recovery.

*INQ

An inquiry message is sent to the message queue associated with the writer when PSF is performing automatic session recovery. This message lets you specify the page number from which a writer should begin printing the last spooled file being processed.

Blank page (BLANKPAGE)

Specifies whether Print Services Facility (PSF) issues a blank page after every separator page and spooled file copy that contains an odd number of pages. The blank pages assure that the printer output is placed into the output stacker in a manner suitable for bursting. This parameter only applies to the following continuous forms printers:

• 3831
• 3835
• 3900-001
• All AFCCU continuous forms printers.

*YES

PSF issues a blank page after every separator page and spooled file copy that contains an odd number of pages.

*NO

PSF does not issue a blank page after every separator page and spooled file copy that contains an odd number of pages.

Page size control (PAGSIZCTL)

Specifies whether the page size (forms) in the printer is set by Print Services Facility (PSF). This parameter only applies to IPDS printers which support the Set Media Size (SMS) operation. Refer to Printer Information, S544-5750 for new device support, but the list includes:

• Impact printers: 4224, 4230, 4234, 4247, 6400, 6408, 6412
• Workgroup printers: 3112, 3116, 3812, 3816, 3912, 3916, 3930, 4028, Network printer 12/17/24, Infoprint 20/21/32/40/70/70+/2085/2105
• Lexmark printers: Infoprint 1120/1125/1130/1140/1145/1226, Infoprint Color 1220/1228 4224, 4230, 4234, 4247, 4028, 6404, 6408, 6412 and IBM Network Printers.
• Thermal printer: 4400

*NO

The page size (forms) in the printer is not set by PSF.

*YES

The page size (forms) in the printer is set by PSF.

Resident fonts (RESFONT)

Specifies whether Print Services Facility (PSF) supports resident fonts on a printer that has resident fonts. Not supporting resident fonts causes PSF to map the resident font reference to its equivalent host font and then download the host font to the printer.

*YES

Resident fonts for the printer are supported by PSF.

*NO

Resident fonts for the printer are not supported by PSF. PSF maps the resident font referenced in the spooled file to its equivalent host font and then downloads the host font to the printer.

Resource retention (RSCRET)

Specifies whether resource retention across spooled files is supported by Print Services Facility (PSF).

*YES

PSF stores page segments and overlays in the printer across spooled file boundaries. This minimizes data transfers, especially when printing multiple spooled files that reference the same resources.

*NO

PSF does not store page segments and overlays in the printer across spooled file boundaries. They are deleted after each spooled file.

Note: The page segments and overlays are deleted in the printer when the printer writer is ended.

Edge orient (EDGEORIENT)

Specifies whether additional page rotation should be performed. When the page rotation value of a spooled file is *COR or *AUTO and the system rotates the output, 90 degree rotation is normally used.

*NO

The output remains at its original orientation.

*YES

*COR and *AUTO output of 90 degrees is rotated an additional 180 degrees before printing.

Use outline fonts (USEOUTLFNT)

Specifies whether the requested downloadable AFP raster fonts should be replaced with the equivalent downloadable outline fonts.

*NO

The raster fonts will be used.

*YES

If the equivalent downloadable outline font exists, it will be used in place of the raster font.

PSF defined option (PSFDFNOPT)

Specifies a value as defined by IBM.

*NONE

No Print Services Facility (PSF) defined options are specified.

character-value

Specify a value as defined by IBM. One or more values may be made available between releases of OS/400. If a value is made available, a PTF cover letter will contain the required syntax.

Font substitution messages (FNTSUBMSG)

Specifies whether Print Services Facility (PSF) will issue messages indicating that a successful font substitution was performed.

*YES

Messages indicating that a successful font substitution was performed are issued.

*NO

Messages indicating that a successful font substitution was performed are not issued. Messages indicating that a font substitution attempt failed will still be issued.

Capture host fonts at printer (FNTCAPTURE)

Specifies whether the printer should capture host downloaded fonts.

*NO

The printer should not capture host fonts.

*YES

The font character set or code page is eligible to be captured after downloading to the printer. If the printer does not support font capturing, this information is ignored and the font is downloaded.

Font resolution for formatting (FNTRSL)

Specifies the resolution Print Services Facility (PSF) should use under these conditions:

• you are printing to a multiple-resolution printer
• the printer is configured to report support of multiple resolutions
• the spooled file does not specify the font metrics and resolution with which to print the spooled file or the font is not available at that resolution

If the printer is configured to report support of either 240 pels per inch or 300 pels per inch only, then PSF will produce the same results as if going to a single resolution printer.

Refer to Printer Device Programming, SC41-5713 for more information regarding the algorithm used for searching a library list for a font resource.

*SEARCH

Search the library list for the first occurrence of a host font with a name match. The resolution of that font will be used to print the spooled file. Message PQT3546 will be issued when this value is selected to indicate to the user the resolution of the font that was finally selected.

240

The font resolution used to print the spooled file should be 240 pels per inch.

300

The font resolution used to print the spooled file should be 300 pels per inch.

Font mapping table (FNTTBL)

Specifies the name of a printer-resident to printer-resident font mapping table. Print Services Facility (PSF) uses this font mapping table when printing to a printer which supports printer-resident fonts but the spooled file specifies a printer-resident font that the printer does not support.

For the printer-resident to printer-resident font substitution table, the following processing is done by the system:

• If the printer-resident font specified in the print job is supported by the printer, then it is used. The printer-resident to printer-resident font substitution table is not searched.
• If the printer-resident font specified in the print job is not supported by the printer, then the printer-resident to printer-resident font substitution table is searched.
  • If a matching entry is found in the printer-resident font substitution table and the entry is supported by the printer, then the specified substitute font in the printer-resident font substitution table is used.
  • If a matching entry is not found in the printer-resident font substitution table or if the specified substitute font is not supported by the printer, then the system will use its internal font substitution tables to perform the font substitution.

Refer to Printer Device Programming, SC41-5713 for more information on supported printer-resident fonts. See the CRTFNTTBL, DSPFNTTBL, ADDFNTTBLE, CHGFNTTBLE, and RMVFNTTBLE commands for more information on user font tables.

Single value

*NONE

No printer-resident to printer-resident font table is specified. For a print job that references a printer-resident font, if the font is not supported by the printer, the system will substitute another resident font.

Qualifier 1: Font mapping table

name

Specify the name of the printer-resident to printer-resident font table.

Qualifier 2: Library

name

Specify the name of the library where the font table is located.

Cut sheet emulation mode (CSEMODE)

Specifies to what degree Print Services Facility (PSF) will do size checking of the document when using Cut Sheet Emulation.

*NONE

No checking will be done to verify that the document page will fit on half the continuous forms physical page.

*CHKFIRST

The first page of each copy group will be checked to determine if the page will fit on half the continuous forms page.

*CHKALL

The front side page will be checked to determine if the page will fit on half the continuous forms page.

Use DBCS simulation fonts (MAPIGCFNT)

Specifies to use DBCS simulation fonts instead of the DBCS raster fonts specified in the data stream when printing the spooled file.

DBCS simulation fonts are outline fonts that are positioned like raster fonts. This allows the use of outline fonts to print applications that use DBCS raster fonts without changing the application or the appearance of the printed output. Outline fonts are scalable, so it is not necessary to store font character sets for each point size on your system, and neither is it necessary to download a different font to the printer for every change in point size. This increases your system storage space and enhances printing performance.

*NO

Do not substitute DBCS simulation fonts for DBCS raster fonts.

*YES

Substitute DBCS simulation fonts for DBCS raster fonts.

Replace (REPLACE)

Specifies whether an existing Print Services Facility (PSF) configuration object with the same name as the one being created, is replaced.

*YES

The existing PSF configuration object is replaced.

*NO

If a PSF configuration object with same name exists in the library specified, the create operation fails. The existing PSF configuration object is not replaced.

Authority (AUT)

Specifies the authority you are giving to users who do not have specific authority to the object, who are not on an authorization list, and whose group profile has no specific authority to the object.

*LIBCRTAUT

The system determines the authority for the object by using the value specified for the Create authority (CRTAUT) parameter on the Create Library (CRTLIB) command for the library containing the object to be created. If the CRTAUT value for a library is changed by running the Change Library (CHGLIB) command, the new CRTAUT value will not affect any existing objects.

*CHANGE

Change authority allows the user to change and perform basic functions on the object. Change authority provides object operational authority and all data authorities.

*ALL

The user can perform all operations except those limited to the owner or controlled by authorization list management authority. The user can control the object's existence, specify the security for the object, change the object, perform basic functions on the object, and change ownership of the object.

*USE

Use authority provides object operational authority, read authority, and execute authority.

*EXCLUDE

The user cannot access the object.

name

Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.

Examples

CRTPSFCFG   PSFCFG(QGPL/P5001)  PDFGEN(*MAIL)
            PDFDEVTYPE(*4028)  PDFPPRDWR1(*LETTER)
            PDFPPRDWR2(*LEGAL)  PDFMULT(*YES *INDEX)
            PDFDTAQ(*NONE)  PDFINCFNT(*YES)
            PDFMAILSVR(*SNDDST)
            PDFSENDER(QSPLJOB)  PDFMAPPGM(*NONE)

This command creates a Print Services Facility (PSF) configuration object named P5001 in the QGPL library. The PDFGEN parameter specifies that the spooled file is to be transformed to PDF and e-mailed by the SNDDST command. The transform is told to emulate a 4028 printer with paper sizes in drawers 1 and 2 to be letter and legal, respectively.

The requested output will have PDF index tags at the group boundaries, the necessary fonts will be placed inline with the output file, the sender is PSF. Since there is no mapping program, the mail tag information associated with the file is assumed to be valid e-mail addresses.

There will be no completion message logged to a data queue because this parameter has a value of *NONE.

Error messages

*ESCAPE Messages

CPF2283

Authorization list &1 does not exist.

CPF88C1

Printer resource type &1 &2 was not created in library &3.

CPF9810

Library &1 not found.

CPF9820

Not authorized to use library &1.

CPF9845

Error occurred while opening file &1.