Configure PDFing

Send to Destination: Specify the default destination for the documents. This can be a disk storage location, email address or email addresses separated by a semi-colon (;) character. See the Supported Destinations section of our programming document for further details.
Destination Type Button: Click the button for visual confirmation of the destination type.
Create Folders ?: If the destination is a disk storage location, this control allows you to specify whether the folder must exist or can be created by PDFing. Select YES if you want to create the folder in which documents are to be saved. Select NO if the folder must exist.
Hold before Mail ?: Select YES if you want documents with an email destination to be "Held" in a queue, where they can be released for emailing after you have had a chance to check the converted spooled-file and email address. Select NO if you want documents with an email destination to be sent to that destination automatically, without user intervention.
Notify Address.: It is possible to save documents to disk and also email a notification of the file location. Specify an email address here for the recipient of the notification. This address is only used when the Send to Destination specifies a disk storage location. This address is ignored when the Send to Destination specifies e-mail addresses.
Notify + Attachments.: Select YES if you also want to send the converted spooled-files as attachments to the notification email.
Notify URL: Specifies the "root" URL of the web-server that can serve documents saved to disk. If the special characters &R are entered in email subject or body text thay are replaced by this URL concatenated with the saved document's file-name.

The Markup defaults options are described in detail in our programming page. The printing controls are described in our printer documentation.

Use the convert page to specify the file format(s) to which spooled-files should be converted.

Convert to PDF ?: Select YES, if you require conversion of spooled-files to PDF (Adobe Portable Document Format).
PDF Compression.: Selects the degree of compression applied to PDF documents. In most cases this should be set to "MAX" for maximum compression. However if you chose to archive the PDF file inside a ZIP file, then compression should be set to "MIN" for minimum compression
Use OS400 Dimensions.: Provided a spooled-file has been written from an output-queue configured as DESTTYPE(*OS400) PDFing can use the page-size, font-size and margin dimensions specified in the spooled-file itself. Select "YES" to use the OS400 dimensions (if available). Select "NO" to use the page size specified on the paper page. This option only applies to "un-transformed" *SCS spooled-files.
Convert to RTF ?: Select YES, if you require conversion of spooled-files to RTF (Rich-text-format). This format is useful as most word-processing programs can open this file type. This option only applies to "un-transformed" *SCS spooled-files.
Convert to ASCII ?: Select YES, if you require conversion of spooled-files to plain ascii text.
Ascii extension is .txt ?: By default spooled-files converted to ascii text files have a file extension of .asc. Select YES to specify that the file extension is .txt instead.
Ascii Form Feeds ?: By default spooled-files converted to ascii text files contain the ascii form-feed character to indicate the end of each page of text. Select NO to specify that the form-feed character is not required.
Convert to Excel ?: Select YES , if you require conversion of spooled-files to a Microsoft Excel spreadsheet file. Spooled-file conversion to Excel requires that an "example" excel file, containing a LuateX script, exists in the \Markup directory.
Excel Example: Enter the name (without extension) of the "example" excel file to be used. If you select one of the pre-defined special values; *FILENAME, *USRPRF, *FORMTYPE or *USERDATA, then the the corresponding attribute value from each spooled-file will be used to search, in the \Markup directory, for an excel-file with a matching name. For instance, if you select *FILENAME as a default markup and create an excel-file named QPRINT.xls in the \Markup directory, then every time a spooled-file named QPRINT is received PDFing will convert the spooled-file to excel, using the LuateX script in this "example" excel-file.
Archive in ZIP ?: Select YES , if you require the files resulting from the conversion of spooled-files to be archived within a ZIP file. This format has the advantage of containing multiple files inside a single file. The ZIP file may also be password protected.
ZIP Password: Enter text in this control when you require the contents of the ZIP file to be password protected. Only users who know this password text will be able to inspect the archived files.

Use the paper page to specify the page-size of the PDF files. PDFing will attempt to automatically select page-size. The Portrait dimensions are used when a document is longer than it is wide.

These dimensions are used when "un-transformed" *SCS spooled-files are processed and the "Use OS400 Dimensions" control on the [Convert] page is set to NO.

Unit-of-Measure: You may select Points, Inches or Centimeters as the unit-of-measure in which paper sizes are defined.
Darker Font ?: Specify YES to make PDF text appear darker. This may be helpful if your users think the default font appears too light.
Landscape Length: Enter the length (vertical dimension) of the landscape page here.
Landscape Width: Enter the width (horizontal dimension) of the landscape page here.
Landscape Top Margin: Enter the length of the top margin of the landscape page here.
Landscape Left Margin: Enter the width of the left margin of the landscape page here.
Landscape Bottom Margin: Enter the length of the bottom margin of the landscape page here.
Landscape Right Margin: Enter the width of the right margin of the landscape page here.
Portrait Length: Enter the length (vertical dimension) of the portrait page here.
Portrait Width: Enter the width (horizontal dimension) of the portrait page here.
Portrait Top Margin: Enter the length of the top margin of the portrait page here.
Portrait Left Margin: Enter the width of the left margin of the portrait page here.
Portrait Bottom Margin: Enter the length of the bottom margin of the portrait page here.
Portrait Right Margin: Enter the width of the right margin of the portrait page here.

Use the message page to specify the subject and body text of the email messages sent by PDFing. See our programming document for information about inserting attribute values in this text.

Subject: Enter the email subject text here.
Message: Enter the email body text here.
Body Quote Type: Select a quote type. The default type, PLAIN is required when sending accented characters. If you the message text contains HTML codes, then select HTML.
Receipt Required: Select YES to request that the email recipient should return a receipt-message.
Maximum Attachment: Specify the maxiumum size (in KiloBytes) of files attached to an email.
BCC ?: Select YES to specify that all email addresses should be processed as "blind copies", so that no email addresses will be displayed in received emails.

Use the security page to specify the encryption/protection and digital-signature options to be applied to PDF files produced by PDFing.

The encryption settings on this page are only effective when using a copy of PDFing which has been licensed as the NT Service version. If your copy of PDFing is not licensed in this way, then any password you enter is always replaced by Easy when the PDF is secured.

Master Password: Enter the "change security settings" password here. If you set any security restrictions in your file you should also specify a change security setting password (master password) otherwise anyone who opens the file with the full version of Acrobat can remove the security restrictions.
User Password: Enter the "open document" password here. This password should be different from the master password entered above.
Printing Allowed ?: Select NO, if you wish to prevent users printing the PDF file.
Changing Allowed ?: Select NO, if you wish to prevent users editing the PDF file.
Copying Allowed ?: Select NO, if you wish to prevent users copying text or graphics from the PDF file.
Notes Allowed ?: Select NO, if you wish to prevent users adding notes or comments to the PDF file.
128 Bit Encryption ?: Select YES, if you wish the strongest possible encryption algorithm to be used. Please note that PDF files protected by 128 bit encryption can only be opened by Adobe Acrobat Reader 5.0 or above.

Digital signature controls: Please refer to our digital-signature document for more details.

Use the system page to specify the email server you use to send emails. You will need to supply the mail-server's host-name or IP address and values for the other parameters, as listed below the image.

Server Name: Enter the Internet address or name of your SMTP server here. Please note that PDFing will not automatically dial-up a remote server.
Auto-Start?: Select YES, if you require PDFing to be ready to send emails as soon as the program is started.
Use Domain Address?: Select YES, if your SMTP server requires PDFing to log-on with the domain name from the SMTP return address. The default value will only need changing in exceptional circumstances.
Port: Enter the port number that PDFing will use to communicate with your SMTP Server. The default value of 25 will generally be correct.
Time-Out: Enter the time (in seconds) that PDFing will wait for a response from the mail server, before reporting an error.
Minimum Wait: Enter the time (in milliseconds) that PDFing will wait before checking for a response from the mail server. A value of zero is generally correct but mail-servers that are slow to respond may require you to enter some positive value here.
Delay Before Retry: Enter the time (in seconds) before each retry after a failure.
Retries: Enter the number of times that PDFing will re-try after failure. If PDFing cannot send a document after the specified number of tries, then an error will be reported.
Return Address: Enter the email address that the receiving e-mail client can reply to. For most servers the return address must be in the same domain as the server.
ESMTP User Name: Some mail servers require that PDFing supply authentication information before allow connection. If your mail-server requires authentication then specify an authorised user name here.
ESMTP Password: If your mail-server requires authentication then specify the password for the ESMTP user name here.

The EBCDIC/ASCII options are described in detail on our national-languages page.

Use the advanced page to specify (when required) the advanced operation options

LPD Auto-Start ?: Select YES, if you require the interactive version of PDFing to be ready to process OS400 spooled-files as soon as the program starts.
LPD Port: Enter the port number that PDFing will use to listen for incoming spooled-files. You should not change the LPD port from its default value of 515, unless you know how to make OS400 send spooled-files to another port!
LPD Time-Out: Enter the time (in minutes) that PDFing will wait for data from OS400 once a print job has started. If you are processing exceptionally large spooled-files, you may need to increase the time-out value.
LPD Socket-Delay: Enter the time (in milliseconds) before PDFing responds to data received from OS400. This value may be changed, if you find that the spooled-files are being written from OS400 at a faster rate than PDFing can convert and e-mail them, thus giving a false impression of progress to OS400 operators. Values of up to 10,000 milliseconds should not cause OS400 any problems but please use caution!

Use the log page to specify how long PDFing will keep its work files and the logging that PDFing will perform.

Log LPD Activity ?: Select YES to log LPD activity and preserve the spooled-file text that arrives from OS400. If PDFing can convert all your spooled-files correctly, you should select YES in order to reduce disk-space requirements.
SMTP Log File: Enter the name of a file where PDFing will log SMTP activity.
Keep Attachments ?: Select YES to preserve the converted spooled-files after these files have been stored to disk or sent as email attachments. You may select NO in order to reduce disk-space requirements but this is not advisable, except in extreme circumstances.
Keep Control Files For: Enter the time (in days) before PDFing deletes all the supporting files for a converted spooled-file. The interactive version of PDFing will perform the purge when the program is started. The NT service version will perform the purge once on start-up and repeat the purge at six hours intervals.