CRTPSFCFG (Create Print Services Facility Configuration) Command Description
CRTPSFCFG Command syntax diagram
Purpose
The Create Print Services Facility Configuration (CRTPSFCFG) command creates 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 device that are not supported on the CRTDEVPRT command.
The Create Print Services Facility Configuration command creates the object in the specified library. This PSF configuration object is stored on the OS/400 as object type *PSFCFG.
Restrictions
- One of the four PSF/400 features must be licensed and installed to use this command.
- *IOSYSCFG authority is required to use this command.
Required Parameters
- PSFCFG
- Specifies the name and library of the PSF configuration object to be created.
The name of the PSF configuration object can be qualified by one of the following library values:
*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-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.
*JOBLIBL: The job's library list at the time the spool file is created is used to search for AFP 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.
*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 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 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.
*NORDYF: The release timer is activated when there are no spooled files in the printer'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 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 printers device.
*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 of *PRTNORDYF is treated as if *NORDYF has been specified.
Use this value when you want the writer to print all files with a status of RDY before the 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 activated immediately after the writer receives an indication from 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 can 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 device 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 before a session or dialog is released without terminating the writer. The ACTRLSTMR parameter specifies when this timer is to be activated.
*NOMAX: The dialog or session with the printer device is not released unless ENDWTR is executed.
*SEC15: PSF/400 waits 15 seconds before releasing the session or dialog with the printer device.
*SEC30: PSF/400 waits 30 seconds before releasing the session or dialog with the printer device.
length-of-wait: Specify the number of minutes PSF/400 waits before releasing the session or dialog 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.
*IMMED: The writer attempts 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 times to retry a session start request when attempting to establish a session with a printer device. This parameter applies to printers and devices configured in a printer device description as either
- AFPATTACH(*APPC) and AFP(*YES), or
- DEVCLS(*LAN), LANATTACH(*IP) and AFP(*YES).
The possible values are:
15: Fifteen retry attempts are made to establish a session. If after fifteen retries, PSF/400 still cannot establish a session, the printer writer terminates.
*NOMAX: No limit is put on the number of retries. PSF/400 continues issuing session start requests until either the session is established or the printer writer is ended using ENDWTR OPTION(*IMMED).
number-of-retries: Specify the number of retry attempts to establish a session. Valid values range from 1 through 99.
- RETRYDLY
- Specifies the number of seconds PSF/400 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/400 is controlled by parameter RETRY. This parameter applies to printers and devices configured as AFPATTACH(*APPC) and AFP(*YES) in the printer device description.
The possible values are:
90: Specifies that there is a 90 second delay between retry attempts.
number-of-seconds-between-retries: Specify the number of seconds to pause between retry attempts to establish a session. Valid values range from 0 through 999.
- 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 printer devices configured in a printer device description as either
- AFPATTACH(*APPC) and AFP(*YES), or
- DEVCLS(*LAN), LANATTACH(*IP) and AFP(*YES).
You may also specify whether an information or inquiry message is to be issued when automatic session recovery is being performed.
*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.
This element is ignored if the value for element 1 is *NO.
- 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:
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 timer is used after a session has been started and PSF/400 is sending data. This parameter is used only for printer devices configured for a TCP/IP connection.
*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. The writer is ended if the printer does not respond within the specified amount of time. If this happens, a message is sent to the message queue.
- 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 only to the following continuous forms printer devices:
- 3831
- 3835
- 3900-001
- All AFCCU continuous forms printers.
*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.
*NO: PSF/400 does not set the page size (forms) in the printer devices.
*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.
*YES: PSF/400 can use resident fonts to print the spooled file.
*NO: PSF/400 will not use 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 download the host font to the printer device.
- RSCRET
- Specifies whether PSF/400 should use resource retention across spool files.
*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 this parameter is *YES, PSF/400 rotates the output 270 degrees instead of 90 degrees.
*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 downloadable AFP raster font character sets and coded fonts should be 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.
*NO: No mapping to outline font character set equivalents will be done. All references to font character sets will be used as is.
*YES: All references to font character sets will be mapped to the equivalent downloadable outline font character set if possible.
- PSFDFNOPT
- Specifies a value as defined by IBM.
*NONE: No PSF-defined options are specified. For V3R2, this is a restricted value since no new options are defined for this release.
PSF-defined-option: 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.
- FNTSUBMSG
- Specifies whether PSF/400 will issue messages indicating that a successful font substitution was performed.
*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 CRTFNTRSC or CHGFNTRSC commands. The OS/2 Type Transformer(5648-113) product will also create font resources marked as eligible for capture.
*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 device 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.
*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.
*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 an 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 CRTPSFCFG 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 Cut Sheet Emulation.
*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.
*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 printer devices configured AFP(*YES).
*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.
*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.
*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.
*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
*NO: Specifies that 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.
*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. *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: Specify the name of the data queue.
- PDFMAILSVR
- Specifies what mail server to use for emailing the resulting PDF files from the IPDS to PDF transform.
*SNDDST: Specifies that the SNDDST (Send Distribution) command should be used for emailing PDF output.
*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. The SMTP protocol is used for sending the email.
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 any 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.
*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 electronic mailing of the PDF output. It is possible that the mail tag is an actual/real electronic mail address that will simply be returned from the mapping program. This parameter is only valid when PDFGEN 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.
*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.
user-program-name: Specify the name of the user mapping program.
- 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.
library-name: Specify the name of the library where the output queue is located.
output-queue-name: Specify the name of the output queue.
- PDFDIR
- Specifies the directory where the PDF file should be stored. If the user plans to use the PDF file with the Send Distribution (SNDDST) command, the PDF file needs to be stored in the /QDLS file system. The 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: \ < > " ? : * |.
- REPLACE
- Specifies whether an existing 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.
- 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 on the Create authority prompt (CRTAUT parameter) on the Create Library command (CRTLIB) for the library containing the object to be created. If the value specified on the Create authority prompt (CRTAUT parameter) is changed, the new 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, and perform basic functions on the object. The user can change ownership of the object.
*USE: Use authority provides object operational authority, read authority, and execute authority.
*EXCLUDE: The user cannot access the object.
authorization-list-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.
- TEXT
- Specifies the text that briefly describes the object.
*BLANK: No text is specified.
'text-description': Specify no more than 50 characters of text, enclosed in apostrophes.
Example for CRTPSFCFG
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 configuration object named P5001 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 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 email addresses.
There will be no completion message logged to a data queue because this parameter has a value of *NONE.>
Error messages for CRTPFSCFG
*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.