CHGPSFCFG (Change Print Services Facility Configuration) Command Description

CHGPSFCFG Command syntax diagram

 

Purpose

The Change Print Services Facility Configuration (CHGPSFCFG) command changes a PSF* (Print Services Facility*) configuration object with the information specified on this command.

A PSF configuration object allows the user to specify additional parameters for an AFP printer device that are not supported on the CRTDEVPRT command.

The Change Print Services Facility Configuration command changes the object in the library specified on the command. This PSF configuration object is stored on the OS/400 as a new object (*PSFCFG).

 

Restrictions

  1. One of the four PSF/400 features must be licensed and installed to use this command.

  2. *IOSYSCFG special authority is required to use this command.

 

Required Parameters

PSFCFG
Specifies the name and library of the PSF/400 configuration object to be changed.

The name of the PSF configuration object can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

PSF/400-configuration-name: Specify the name of the PSF configuration object being changed.

 

Optional Parameters

USRRSCLIBL
Specifies the user resource library list to be used for searching AFP resources. The user resource library list (USRRSCLIBL) is searched first and then the device resource library list (DEVRSCLIBL) is searched when attempting to find an AFP resource specified with the spool file.

*SAME: The value does not change.

*JOBLIBL: The job's library list at the time the spool file is created is used to search for AFP list resources.

*CURLIB: The current library for the job that created the spool file is used for searching for AFP resources. If no library is specified as the current library for the job, then library QGPL is used.

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

DEVRSCLIBL
Specifies the device resource library list to be used for searching AFP resources. The user resource library list (USRRSCLIBL) is searched first and then the device resource library list (DEVRSCLIBL) is searched when attempting to find an AFP resource specified with the spool file.

*SAME: The value does not change.

*DFT: The following libraries (if present on system) are used in searching for AFP resources.

  • QFNTCPL

  • QFNT01 - QFNT19

  • QFNT61 - QFNT69


Note: Should the user choose the *DFT option on the DEVRSCLIBL parameter, and all the system libraries in the above list have not been created, it is possible for the user to create libraries by the name of the missing system libraries. The user could then place resources in the libraries that could subsequently be found by other users. To prevent this from occurring, the system administrator can create all of the missing system libraries with PUBLIC *USE authority.

device-resource-library-names: Specify a list of up to 30 library names to be used to search for AFP resources.

IPDSPASTHR
Specifies whether IPDS pass-through is done for the device.

Not all SCS or IPDS spooled files are eligible for IPDS pass-through. They may contain special functions that require transform to AFPDS for correct printing. Specifying IPDS pass-through on this command or the 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: The value does not change.

*NO: No IPDS pass-through is done.

*YES: IPDS pass-through is to be done for the device for all spool files that are eligible for IPDS pass-through.

IPDS pass-through is not valid for all PSF/400 supported printer devices. Any printer device (or attachment) that does not support resident fonts cannot support IPDS pass-through. This is because the resident font references in the data stream must be mapped to host fonts which are downloaded to the printer device. The following IPDS printer devices can support IPDS pass-through (when AFP(*YES) is specified):

  • Any printer which supports resident fonts.

The following IPDS printer devices cannot support IPDS pass-through (when AFP(*YES) is specified):

  • 3820, 3825, 3827, 3828

  • 3829, 3831, 3835, 3900-001

  • Any DPF attached printer device. DPF (Distributed Print Function) is a function supported by the PSF for OS/2 print server which blocks the usage of printer-resident fonts.


ACTRLSTMR
Specifies the point at which the release timer (RLSTMR) is activated.

*SAME: The value does not change.

*NORDYF: The release timer is to be activated when there are no spooled files in the printer device's output queue with a status of RDY and the last page of the last spooled file processed has printed. If the release timer expires, the session to the printer device is released; the writer does not terminate. When the session is released, another PSF can start a session to the printer device.

Use this value when you want the writer to print all files with a status of RDY before the releasing the session.

The value of *NORDYF is supported only for printers and devices attached to an iSeries 400 using APPC or TCP/IP. For an APPC connection, use this value only with the PSF Direct support provided by PSF for OS/2 and PSF for AIX. For a TCP/IP connection, this value can be used for any printer device. This value is not supported for Twinax-attached printer devices.

*IMMED: The release timer is to be activated immediately after PSF has successfully linked to the printer device. If the release timer expires, the session to the printer device is released; PSF does not terminate. 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 device.

Use this value when you want the writer to time-share the printer device. The value used for release timer determines the length of time the writer will "keep" the printer device before releasing the session.

The value of *NORDYF is supported only for printers and devices attached to an iSeries 400 using APPC or TCP/IP. For an APPC connection, use this value only with the PSF Direct support provided by PSF for OS/2 and PSF for AIX. For a TCP/IP connection, this value can be used for any printer device. This value is not supported for Twinax-attached printer devices.

*PRTNORDYF: This value can be specified if you are using a printer device that allows control over the exchange of IPDS data (the IPDS dialog).

This value specifies that the release timer is to be activated:

  • After the writer receives an indication from the printer device to release the IPDS dialog,

  • There are no spooled files in the printer device's output queue with a status of RDY, and

  • 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 device; the session is not released. The port in use by the writer is not available to another PSF. However, another print driver can start a dialog with the printer device on a different printer port.

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

Use this value when you want the writer to print all files with a status of RDY before releasing the IPDS dialog.

The value of *PRTNORDYF is supported on a Twinax, TCP/IP or APPC connection.

*PRTIMMED: This value can be specified if you are using a printer device that allows control over the exchange of IPDS data (the IPDS dialog).

This value specifies that the release timer is to be activated immediately after the writer receives an indication from the printer device to release the IPDS dialog. If the release timer expires, the writer releases the IPDS dialog with the printer device; the session is not released. The port in use by the writer is not available to another PSF. However, another print driver may start a dialog with the printer device 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 device after the printer has indicated that it is needed by a print driver at another printer port.

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

The value of *PRTIMMED is supported on a Twinax, TCP/IP or APPC connection.

RLSTMR
Specifies the amount of time to wait, after the last page of the last ready spooled file has printed, before releasing the printer device. PSF/400 does not terminate, but closes the connection with the printer device. When a spooled file becomes ready, PSF/400 will attempt to establish a session with the printer device.

*SAME: The value does not change.

*NOMAX: The session with the printer device is not closed unless the ENDWTR command is issued.

*SEC15: PSF/400 waits 15 seconds before closing the session with the printer device.

*SEC30: PSF/400 waits 30 seconds before closing the session with the printer device.

length-of-wait: Specify the number of minutes PSF/400 will wait before closing the session with the printer device.

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

  • What value was specified for ACTRLSTMR.

  • Whether or not the printer device supports IPDS dialog management.

  • Whether the type of link is Twinax, APPC or TCP/IP.

If ACTRLSTMR(*NORDYF) or ACTRLSTMR(*IMMED) are specified, the session is retried.

If ACTRLSTMR(*PRTNORDYF) or ACTRLSTMR(*PRTIMMED) are specified, the dialog is retried.

*SAME: The value does not change.

*IMMED: The writer should attempt to re-establish the session or dialog as soon as a spooled file has a status of RDY.

number-of-minutes: Specify the number of minutes the writer waits, after a session or dialog have been released, before attempting to connect. Valid values range from 1 through 1440.

RETRY
Specifies the number of retry attempts to establish a session. This parameter applies to printers and devices configured as AFPATTACH(*APPC) in the printer device description.

This is the number of retries PSF/400 will make to establish a connection with a printer device.

*SAME: The value does not change.

*NOMAX: No limit is put on the number of retry attempts to establish a session. PSF/400 continues retrying until the session is established or the user cancels the printer writer.

number-of-retries: Specify the number of retry attempts to establish a session. Valid values are 0 through 99 and *NOMAX.

RETRYDLY
Specifies the number of seconds to wait between retry attempts to establish a session. This parameter applies to printers and devices configured as AFPATTACH(*APPC) in the printer device description. This parameter only applies if the RETRY parameter has a value greater than 0. Valid values are 0 through 999. The default is 0 (no waiting between retry attempts).

*SAME: The value does not change.

number-of-seconds-between-retries: Specify the number of seconds to wait between retry attempts to establish a session.

AUTOSSNRCY
Specifies whether PSF/400 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 as either

  • AFPATTACH(*APPC) and AFP(*YES), or

  • DEVCLS(*LAN), LANATTACH(*IP) and AFP(*YES).

Single Values

*SAME: The value does not change.

*NO: Specifies that PSF/400 ends when a session has been unexpectedly ended by a device.

Element 1: Enabled

*YES: Specifies that PSF/400 attempts to re-establish a session which has been unexpectedly ended by a device.

  • If you are using a printer device description which specifies AFPATTACH(*APPC) and AFP(*YES), note the following:

    • PSF configuration object parameters RETRY and RETRYDLY are used when PSF/400 is attempting to re-establish a session.

    • If a PSF configuration object is not specified in a printer device description, then a maximum of 15 retries with a 90-second delay between them are used.>

    • You must use an APPC controller description and an APPC device description which specify APPN(*YES). Additionally, the APPC controller description must have MINSWTSTS(*VRYONPND) specified.

  • If you are using a printer device description which specifies DEVCLS(*LAN), LANATTACH(*IP) and AFP(*YES), then PSF configuration object parameter RETRY is used when PSF/400 is attempting to re-establish a session.

    If a PSF configuration object is not specified in a printer device description, then a maximum of 15 retries is used.>

To avoid reprinting pages, you may want to consider the setting for this parameter's second element, or the value used for ACKFRQ (Acknowledgment frequency).

Element 2: Message option

The possible values are:

*INFO: An informational message is sent to the message queue associated with the writer when PSF/400 is performing automatic session recovery.

*INQ: An inquiry message is sent to the message queue associated with the writer when PSF/400 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.

ACKFRQ
Specifies the frequency, in pages, with which PSF/400 sends IPDS acknowledgment requests to a printer device. The acknowledgment request responses from the printer device contain information as to the status of pages sent to the printer device.

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 device is abnormally terminated, PSF/400 may reprint pages because the printer device 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.

The possible values are:

*SAME: The value does not change.

100: Specifies that an acknowledgement is sent to the printer device after every 100 pages.

number-of-pages: Specifies the number of pages after which PSF/400 sends an acknowledgment to the printer device. Valid values range from 1 through 32767.

PRTRSPTMR
Specifies the length of time for which a writer should wait for a response from a printer device. This parameter is used only for printer devices configured in a printer device description as DEVCLS(*LAN), LANATTACH(*IP) and AFP(*YES).

*SAME: The value does not change.

*NOMAX: Specifies that there is no limit on the length of time for which a writer waits for a response from a printer device.

number-of-seconds: Specify the number of seconds for which a writer waits for a response from a printer device. Valid values range from 5 through 3600.

BLANKPAGE
Specifies whether PSF/400 issues a blank page after every separator page and spool file copy that contains an odd number of pages. The blank pages assure that the printer device output is placed into the output stacker in a manner suitable for bursting. This parameter applies to the following continuous forms printer devices only:

  1. 3831

  2. 3835

  3. 3900-001

  4. 3900-0W1

  5. 3900 Duplex Printing System and 3900 Wide Duplex Printing System

*SAME: The value does not change.

*YES: PSF/400 issues a blank page after every separator page and spool file copy that contains an odd number of pages.

*NO: PSF/400 does not issue a blank page after every separator page and spool file copy that contains an odd number of pages.

PAGSIZCTL
Specifies whether PSF/400 sets the page size (forms) in the printer device. This parameter only applies to the 4224, 4230, 4234, 4247, 4028, 6404, 6408, and 6412 printer devices.

*SAME: The value does not change.

*NO: PSF/400 does not set the page size (forms) in the printer device.

*YES: PSF/400 sets the page size (forms) in the printer device.

RESFONT
Specifies whether PSF/400 should use resident fonts to print the spooled file.

*SAME: The value does not change.

*YES: PSF/400 can use resident fonts to print the spooled file.

*NO: PSF/400 does not use the resident fonts to print the spooled file. PSF/400 maps the resident font referenced in the spool file to it's equivalent host font and then downloads the host font to the printer device.

RSCRET
Specifies whether PSF/400 should use resource retention across spool files.

*SAME: The value does not change.

*YES: PSF/400 stores page segments and overlays in the printer device across spool file boundaries. This minimizes data transfers, especially when a user is printing multiple spooled files that reference the same resources.

*NO: PSF/400 does not store page segments and overlays in the printer device across spool file boundaries. They are deleted after each spool file.

Note that the page segments and overlays are deleted in the printer device when the printer writer is terminated.

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. When *YES is specified, PSF/400 rotates the output 270 degrees instead of 90 degrees.

*SAME: The value does not change.

*NO: The output remains at its original orientation.

*YES: Landscape output of 90 or 270 degrees is rotated an additional 180 degrees before printing.

USEOUTLFNT
Specifies whether the user would like the requested downloadable AFP raster fonts replaced with the equivalent downloadable outline fonts.

See the Printer Device Programming book for more information regarding this parameter's relationship with the FNTRSL parameter.

*SAME: The 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.

PSFDFNOPT
*SAME: The value does not change.

*NONE: No PSF defined options are specified. For V3R2 this value is a restricted value since no new options are defined for this release.

PSF-defined-option: Specifies 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.

FNTSUBMSG
Specifies whether PSF/400 will issue messages indicating that a successful font substitution was performed.

*SAME: The value does not change.

*YES: Specifies that messages indicating that a successful font substitution was performed are to be issued.

*NO: Specifies that messages indicating that a successful font substitution was performed are not to be issued. The following messages will not be issued:

PQT2066
Font substitution was performed.
PQT2077
Font substitution was performed.
PQT2072
Font substitution was performed.
PQT3531
Font substitution was performed.
PQT3533
Font substitution was performed.
PQT3535
Font substitution was performed.
PQT3537
Font substitution was performed.
PQT3539
Font substitution was performed.
PQT3541
Font substitution was performed.
PQT3542
Font substitution was performed.
PQT3544
Font substitution was performed.
PQT3545
Font substitution was performed.
PQT3546
Font substitution was performed.

Messages indicating that a font substitution attempt failed will still be issued.

FNTCAPTURE
Specifies whether the printer device should capture host downloaded fonts. Host character sets and code pages may be marked as eligible for capturing using the CHGFNTRSC or CHGFNTRSC commands. The OS/2 Type Transformer(5648-113) product will also create font resources marked as eligible for capture.

*SAME: The value does not change.

*NO: Specifies that the printer device should not capture the host fonts.

*YES: Specifies that the printer device should capture the host fonts.

FNTRSL
Specifies the resolution PSF/400 should use to print the spooled file when printing to a multiple resolution printer device and the printer file is configured to report support of multiple resolutions and 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 device is configured to report support of either 240 pels per inch or 300 pels per inch only, then PSF/400 will produce the same results as if going to a single resolution printer device.

For more information regarding the algorithm used for searching a library list for a font resource, see the Printer Device Programming book section entitled User and Device Resource Library Lists in the chapter called Working With PSF Configuration Objects.

*SAME: The value for this parameter remains unchanged.

*SEARCH: Specifies to 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: Specifies that the font resolution used to print the spooled file should be 240 pels per inch.

300: Specifies that the font resolution used to print the spooled file should be 300 pels per inch.

FNTTBL
Specifies the name of a printer resident to printer resident font table. This printer resident font table is used by PSF/400 when printing to a printer device that supports printer resident fonts and the print job specifies a printer resident font which is not supported by the printer device.

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 device, then it is used. The printer resident to print resident font substitution table is not searched.

  • If the printer resident font specified in the print job is not supported by the printer device, 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 device, 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 device, then the system will use its internal font substitution tables to perform the font substitution.

Refer to Appendix D in the Printer Device Programming book for more information on supported printer resident fonts. See the CRTFNTTBL, DSPFNTTBL, ADDFNTTBLE, CHGFNTTBLE, and RMVFNTTBLE commands for more information on user font tables.

*SAME: The value for this parameter remains unchanged.

*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 device, then the system will substitute another resident font.

The name of the printer resident to printer resident font table can be qualified by one of the following library values:

The font table must exist in a library in the job's library list when the CHGPSFCFG command is run. The library name where the font table is found is stored in the PSF configuration object.>

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

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

CSEMODE
Specifies to what degree PSF/400 will do size checking of the document when using Cute Sheet Emulation.

*SAME: The value does not change.

*NONE: Specifies that no checking will be done to verify that the document page will fit on half the continuous forms physical page.

*CHKFIRST: Specifies that the first page of each copy group will be checked to determine if the page will fit on half the continuous forms physical page.

*CHKALL: Specifies that each front side page will be checked to determine if the page will fit on half the continuous forms physical page.

MAPIGCFNT
Specifies whether to use outline DBCS simulation fonts. Outline DBCS simulation fonts are outline coded fonts which simulate older raster DBCS fonts. The writer processes all coded font names beginning with X0 by changing the first two characters of the name to XZ and searching for a coded font of this name. If no match is found for the XZnnnnnn coded font the writer performs a second search using the original X0nnnnnn name.

*SAME: The value does not change.

*NO: No mapping of coded fonts will be done.

*YES: All coded font references will be mapped to outline coded font equivalents.> Coded font names of the form X0nnnnnn will be mapped to XZnnnnnn. If the XZnnnnnn coded font is found it will be used, else the original X0nnnnnn coded font will be used.

PDFGEN
Specifies whether the user would like the spooled file converted to PDF via the IPDS to PDF transform and if so what to do with the associated PDF output. This parameter is valid only for devices configured AFP(*YES).

*SAME: The value does not change.

*NONE: Specifies that no PDF generation of the spooled file should be performed.

*SPLF: Specifies that the PDF output should be placed on the output queue identified in parameter PDFOUTQ.

*STMF: Specifies that the PDF output should be placed into a stream file in the directory specified in the PDFDIR parameter.

*MAIL: Specifies that the PDF output should be electronically mailed.

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

*SAME: The value does not change.

*IP40240: Specifies that the virtual printer device should emulate an IP40 printer device configured at 240 pels per inch resolution.

*IP40300: Specifies that the virtual printer device should emulate an IP40 printer device configured at 300 pels per inch resolution.

*4028: Specifies that the virtual printer device should emulate a 4028 printer device.

*3812: Specifies that the virtual printer device should emulate a 3812 printer device.

PDFPPRDWR1
Specifies the paper size to use for drawer 1 during the IPDS to PDF transform process.

*SAME: The value does not change.

*LETTER: Specifies to use the dimensions of letter paper.

*LEGAL: Specifies to use the dimensions of legal paper.

*STATEMENT: Specifies to use the dimensions of statement paper.

*EXECUTIVE: Specifies to use the dimensions of executive paper.

*LEDGER: Specifies to use the dimensions of ledger paper.

*A5: Specifies to use the dimensions of A5 paper.

*A4: Specifies to use the dimensions of A4 paper.

*A3: Specifies to use the dimensions of A3 paper.

*B5: Specifies to use the dimensions of B5 paper.

*B4: Specifies to use the dimensions of B4 paper.

PDFPPRDWR2
Specifies the paper size to use for drawer 2 during the IPDS to PDF transform process.

*SAME: The value does not change.

*LETTER: Specifies to use the dimensions of letter paper.

*LEGAL: Specifies to use the dimensions of legal paper.

*STATEMENT: Specifies to use the dimensions of statement paper.

*EXECUTIVE: Specifies to use the dimensions of executive paper.

*LEDGER: Specifies to use the dimensions of ledger paper.

*A5: Specifies to use the dimensions of A5 paper.

*A4: Specifies to use the dimensions of A4 paper.

*A3: Specifies to use the dimensions of A3 paper.

*B5: Specifies to use the dimensions of B5 paper.

*B4: Specifies to use the dimensions of B4 paper.

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

Single Values

*SAME: The value does not change.

*NO: Specifies the groups should be ignored and a single output file should be created.

Element 1: Separate PDF Files

*YES: Specifies that the IPDS to PDF transform should process the multiple groups.

Element 2: Separation Option

The possible values are:

*SPLIT: Multiple PDF output files should be generated at the group boundaries.

*INDEX: An index tag should be placed at the group boundaries in the single output file.

PDFINCFNT
Specifies whether the PDF output generated by the IPDS to PDF transform should carry the necessary fonts inline.

*SAME: The value does not change.

*YES: Specifies that the fonts should be carried inline with the PDF output.

*NO: Specifies that the fonts should not be carried inline with the PDF output. The user will need access to the fonts for printing or displaying the file.>

PDFDTAQ
Specifies the name and library of the data queue where PSF will log the IPDS to PDF transformation completion notifications.

Note: Keyed data queues are not supported for this parameter. If a keyed data queue is specified, a run-time error will occur; but because it is not required that a data queue exist at the time this command is issued, the error will not be detected.

*SAME: The value does not change.

*NONE: Specifies that no data queue should be used to log completions.

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

data-queue-name: Specifies the library-qualified name of the data queue used for logging transformation completions.

PDFMAILSVR
Specifies what mail server to use for emailing the resulting PDF files from the IPDS to PDF transform.

*SAME: The value does not change.

*SNDDST: Specifies that the SNDDST (Send Distribution) command should be used for emailing PDF output. The SMTP protocol is used for sending the email.

*LOCAL: Specifies the local machine as a mail server. The SMTP protocol is used for sending the email. *LOCAL may be specified in any position in a list of mail servers.

mail-server-name: Specifies the mail server at the provided domain name or Internet address be used for mailing PDF output.

You may 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 additional servers you have specified. If another server can be used, the writer will reorder the list of servers so that the current working server is the first one in the list. The re-organized list is used while a writer is active. The PSF configuration object is not modified.If all specified servers cannot be used, the action taken by the writer is determined by the value specified for PRTERRMSG in the printer device description. If PRTERRMSG(*INFO) is specified, the writer is ended. If PRTERRMSG(*INQ) is specified, then an inquiry message is issued. Replies to the inquiry message are Retry and Cancel.>

PDFSENDER
Specifies the owner/sender from whom the PDF output file is electronically mailed. The sender must be a valid user profile on the the system and be enrolled in the System Distribution Directory.

If you have specified PDFMAILSVR(mail-server-name), the entry in the System Distribution Directory must have both an SMTP user ID and SMTP domain specified.> This parameter is only valid when the PDFGEN parameter has a value of *MAIL.

*SAME: The value does not change.

*SPLFOWN: Specifies that the owner of the original spooled file should be the sender of the electronically mailed PDF file.

QSPLJOB: Specifies that owner of the electronically mailed PDF file will be QSPLJOB.

mail-file-sender: Specifies the name of a valid user profile to be used as the sender of the electronically mailed PDF file.

PDFMAPPGM
Specifies the qualified name of a user-defined mail mapping program. The mail mapping program will resolve the mail tag found in the data stream and return one or more mail addresses to use for electronically mailing the PDF output. It is possible that the mail tag is an actual/real electronic mailing address that will simply be returned from the mapping program. This parameter is only valid when the PDFGEN parameter has a value of *MAIL. The user mapping program must exist and the user must have the appropriate authority at the time the command is issued.

*SAME: The value does not change.

*NONE: Specifies that no user program was specified. When this occurs, PSF/400 will assume that the mail tag is a valid mail address and will attempt to use it for electronic mailing purposes.

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

PDF-mapping-program-name: Specifies the library-qualified name of the user program to use for mapping mail tags.>

PDFOUTQ
Specifies the qualified name of an output queue that should be used when spooling PDF output. This parameter is only valid when the PDFGEN parameter has a value of *SPLF.

Note: Because it is not required that an output queue exist at the time the command is issued, the error will not be flagged. Existance and authority errors will be detected at run-time. The name of the PDF output queue can be qualified by one of the following library values:

library-name: Specify the name of the library where the output queue is located.>

PDF-output-queue: Specifies the library-qualified name of the output queue to use for spooling the PDF output from the IPDS to PDF transform.

PDFDIR>
Specifies the directory where the PDF file should be stored if it is not electronically mailed by PSF/400 or spooled by the IPDS to PDF transform. If the user plans to use the PDF file with SNDDST, the PDF file must be stored in the /QDLS file system. This parameter is valid only when the PDFGEN parameter has a value of *STMF.

PDF-directory-name:> Specifies the path where the PDF file should be stored. The field must begin with a /. The directory name(s) in the path cannot contain any of the following characters: \ < > " ? : * |.

TEXT
Specifies the text that briefly describes the object.

*SAME: The value does not change.

*BLANK: No text is specified.

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

Example for CHGPSFCFG 

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

This command creates a Print Services Facility configuration object named P5002 in library QGPL. The PSF configuration (via the PDFGEN parameter) is requesting that the IPDS to PDF transform be performed and that the output be emailed using 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 are assumed to be valid email addresses.

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

Error messages for CHGPFSCFG

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