Change PSF Configuration (CHGPSFCFG)

Use the Change PSF Configuration (CHGPSFCFG) command to modify an existing 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:

Parameters

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

PSF configuration (PSFCFG)

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

This is a required parameter.

Qualifier 1: PSF configuration

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

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 list and then those in the device 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.

*SAME
This value does not change.
*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 values

*SAME
This value does not change.
*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 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.

*SAME
This value does not change.
*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 IPDS 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.

*SAME
This value does not change.
*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:

  • 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 ready 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 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.

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.

*SAME
This value does not change.
*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:

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.

*SAME
This value does not change.
*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.

*SAME
This value does not change.
*NOMAX
No limit is put on the number of retries. Print Services Facility (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.

*SAME
This value does not change.
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.

*SAME
This value does not change.
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.

*SAME
This value does not change.
*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 values

*SAME
This value does not change.
*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.

*SAME
This value does not change.
*IP40240
Emulate an IP40 printer device configured at 240 pel resolution.
*IP40300
Emulate an IP40 printer device configured at 300 pel resolution.
*P4028
Emulate a 4028 printer device.
*P3812
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.

*SAME
This value does not change.
*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.

*SAME
This value does not change.
*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 values

*SAME
This value does not change.
*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".

*SAME
This value does not change.
*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 values

*SAME
This value does not change.
*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 values

*SAME
This value does not change.
*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.

*SAME
This value does not change.
*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.

*SAME
This value does not change.
*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

*SAME
This value does not change.
*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 the *IBMPGM on the PDFMAPPGM parameter.

The PSF configuration object will not be modified 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 values

*SAME
This value does not change.
*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 created by the transform will be owned by QSPLJOB. These subdirectories will have public data authority of *RX and public object authority of *NONE. The files created by the transform will be owned by the original spooled file owner. QSPLJOB will have data authority of *RWX and object authority of *ALL. The public authority will be *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:

'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.

*SAME
This value does not change.
*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 the following conditions:
  • the print request is segmented and the PDF mapping program requests that the segment be respooled, or
  • 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.

*SAME
This value does not change.
*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 values

*SAME
This value does not change.
*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:

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:

*SAME
This value does not change.
*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:

*SAME
This value does not change.
*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.

*SAME
This value does not change.
*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).

*SAME
This value does not change.
*YES
Print Services Facility (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)

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.

*SAME
This value does not change.
*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.

*SAME
This value does not change.
*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.

*SAME
This value does not change.
*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 the operating system. 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.

*SAME
This value does not change.
*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.

*SAME
This value does not change.
*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:

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.

*SAME
This value does not change.
*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:

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 values

*SAME
This value does not change.
*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.

*SAME
This value does not change.
*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 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.

*SAME
This value does not change.
*NO
Do not substitute DBCS simulation fonts for DBCS raster fonts.
*YES
Substitute DBCS simulation fonts for DBCS raster fonts.

Examples 

CHGPSFCFG    PSFCFG(QGPL/P5002)  PDFGEN(*MAIL)
             PDFDEVTYPE(*P3812)  PDFPPRDWR1(*LETTER)
             PDFPPRDWR2(*LEGAL)  PDFMULT(*NO)
             PDFDTAQ(QGPL/PDF)  PDFINCFNT(*NO)
             PDFMAILSVR(MAIL.EARTHLINK.NET)
             PDFSENDER(*SPLFOWN) PDFMAPPGM(*NONE)

This command changes a Print Services Facility (PSF) configuration object named P5002 in the QGPL library. The PDFGEN parameter specifies that the spooled file is to be transformed to PDF and e-mailed by the mail server found at mail.earthlink.net. The transform is told to emulate a 3812 printer with paper sizes in drawers 1 and 2 to be letter and legal, respectively.

There will be a single PDF output file because the PDFMULT parameter is *NO. The fonts used by the file will not be inline so the user of the output file will need access to the fonts to display or print the file. The sender is the owner of the spooled file. Since there is no mapping program, the mail tag information associated with the file is assumed to be valid e-mail addresses.

Transform completion messages will be logged to data queue PDF in the QGPL library.

Error messages

*ESCAPE Messages

CPF2112
Object &1 in &2 type *&3 already exists.
CPF2182
Not authorized to library &1.
CPF2283
Authorization list &1 does not exist.
CPF88D2
PSF configuration &1 in library &2 not changed.
CPF9810
Library &1 not found.
CPF9820
Not authorized to use library &1.
CPF9822
Not authorized to file &1 in library &2.