Page: 
11 
Merge PDF files into one 
With MRGPDF you can take two or more existing PDF files and merge them 
together into a single PDF. The PDF files do not have to have been created with 
CoolSpools. 
You can also now append a PDF to an existing PDF with STMFOPT(*ADD) when 
running CVTSPLPDF or CVTSPLSTMF.
Convert spooled files to spooled files 
The CVTSPLSPLF command lets you copy a spooled file or split it into multiple 
spooled files. You can drop unwanted pages as you go. 
Pdf metadata editor online - add, remove, update PDF metadata in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Allow C# Developers to Read, Add, Edit, Update and Delete PDF Metadata
add metadata to pdf; online pdf metadata viewer
Pdf metadata editor online - VB.NET PDF metadata library: add, remove, update PDF metadata in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Enable VB.NET Users to Read, Write, Edit, Delete and Update PDF Document Metadata
remove metadata from pdf acrobat; modify pdf metadata
Page: 
12 
Upgrade Notes
Please read the following notes carefully before upgrading to Version 5 from an 
earlier version of CoolSpools. 
To determine which version of CoolSpools you are running, check the name of the 
library in which the CVTSPLSTMF command object you are using resides, e.g.: 
DSPOBJD OBJ(CVTSPLSTMF) OBJTYPE(*CMD) 
The library name corresponds to the version of CoolSpools as shown in the table 
below: 
Library Name 
Version 
CVTSPLSTMF  Version 2 
CVTSPLV3R1  Version 3 
CVTSPLV4R1  Version 4 
CVTSPLV5R1  Version 5 
If you have installed the CoolSpools Plus product, which bundles CoolSpools with a 
number of other modules, the product library will be COOLSPV5R1. 
If your command is in a library other than those shown, you are either running an 
unsupported, unlicensed version or have moved or copied the command object from 
its original location. Contact support@ariadnesoftware.co.uk
for assistance. 
License Keys
You are entitled to upgrade to Version 5 of CoolSpools free of charge if: 
  the machine on which you wish to run CoolSpools V5 has a valid license for 
an earlier version of CoolSpools 
and 
  you are either in your first 12 months‟ maintenance period after purchase or 
have paid your latest annual maintenance invoice. 
If you wish to upgrade, you can simply download the software from 
www.ariadnesoftware.co.uk
and install it according to the instructions contained in 
the “Installation” section of this User Guide. However, if you licensed an earlier 
version of CoolSpools, you will need to request a license key for the new version. 
Simply e-mail support@ariadnesoftware.co.uk
rand ask for your key for V5 of 
CoolSpools. Please quote your system serial number(s) and processor group 
code(s) in your e-mail. These are shown at the top of the WRKLICINF screen. 
Without a license key, CoolSpools V5 will allow you a 30-day grace period and will 
then no longer run. 
C# HTML5 PDF Viewer SDK to view, annotate, create and convert PDF
RasterEdge C#.NET HTML5 PDF Viewer and HTML5 PDF Editor are professional online PDF manipulation tools, which are compatible with both 32-bit and 64-bit
read pdf metadata java; view pdf metadata in explorer
VB.NET PDF- HTML5 PDF Viewer for VB.NET Project
ASP.NET PDF Viewer; VB.NET: ASP.NET PDF Editor; VB.NET to PDF. Image: Remove Image from PDF Page. Image Link: Edit URL. Bookmark: Edit Bookmark. Metadata: Edit, Delete
pdf metadata extract; remove metadata from pdf
Page: 
13 
If you have not paid your annual maintenance invoice, and if you need longer than 
30-days to test V5, we will, on request, send you a temporary license key to extend 
the trial period. 
If you require additional temporary license keys to assist with testing CoolSpools V5, 
or if you run into any problems during your testing, please do not hesitate to contact 
us at support@ariadnesoftware.co.uk
Warning/Disclaimer
We recommend strongly that all production applications are re-tested 
thoroughly using the new version in your development environment before 
you switch over to running the new version in your production environment. 
All CoolSpools versions are packaged as separate licensed programs and install into 
different libraries. This means that all versions of CoolSpools can coexist and run 
alongside one another on the same machine. You can switch an application from 
using one version to using another simply by changing the library list of the job to 
include the appropriate version library or by specifying a different library name when 
you run the command. Hence it is quite a simple matter to test your applications 
using the new version while continuing to run the older version in production. 
Please note that while ariadne makes every effort to ensure that CoolSpools 
functions in the same way with the same parameters from one version to the next, it 
is not possible to guarantee this. This is why you should re-test your applications 
against a new version before going live with it as it is possible that in some cases 
different parameter settings will be necessary to obtain the same results as before. 
ariadne software accepts no responsibility for any damage, expense or loss of 
income incurred as a result of unforeseen and unwanted effects resulting from 
installing new versions of its software or applying PTFs. 
Minimum OS/400 Release Level
The minimum OS/400 release level required to run V5 of CoolSpools is OS/400 
V5R2M0. 
If you are running V4R5M0 or an earlier version of OS400, you will not be able to 
install V5 of CoolSpools.  
Product Library
The product library for CoolSpools V5 is now CVTSPLV5R1. If you have installed the 
CoolSpools Plus product, however, it is COOLSPV5R1. CoolSpools Plus bundles 
CoolSpools with a number of other modules to give even more functionality.  
You may need to change library lists in job descriptions and other system objects in 
order to pick up the new version of the code rather than the old. 
C# TIFF: TIFF Metadata Editor, How to Write & Read TIFF Metadata
C# TIFF - Edit TIFF Metadata in C#.NET. Allow Users to Read and Edit Metadata Stored in Tiff Image in C#.NET Application. How to Get TIFF XMP Metadata in C#.NET.
pdf metadata editor online; rename pdf files from metadata
C# HTML5 PDF Viewer SDK to create PDF document from other file
WPF Viewer & Editor. WPF: View PDF. WPF: Annotate PDF. WPF NET edit PDF bookmark, C#.NET edit PDF metadata, C#.NET NET read barcodes from PDF, C#.NET OCR scan PDF
pdf keywords metadata; edit multiple pdf metadata
Page: 
14 
This change of library name has the advantage that it allows you to run both V5 and 
the earlier versions on the same machine. You are therefore able to test V5 before 
swapping your production applications over to the new version, as we strongly 
advise you to do. 
Licensed Program Id
The licensed program identifiers for the various CoolSpools versions are as follows: 
Licensed 
Program Id 
Version 
2CVTSPL 
Version 2 
3CVTSPL 
Version 3 
4CVTSPL 
Version 4 
5CVTSPL 
Version 5 
Changes between V4 and V5
This section lists only those changes that may require existing users to modify 
parameters or re-code applications that run CoolSpools. Refer to the “What‟s New” 
section for new features and enhancements. 
Please note that V5 is a major modification from V4 and this list is not exhaustive. 
You should re-test your applications before going live with V5 and should not rely on 
checking this list alone. 
  CVTSPLxxxx commands 
In previous releases, the only way to convert a spooled file using CoolSpools was to 
run the CVTSPLSTMF (Convert Spooled File to Stream File) command.  
V5 introduces two alternatives: the Conversion API and the format-specific 
commands (CVTSPLPDF for PDF, CVTSPLXLS for Excel, CVTSPLRTF for RTF 
etc.) 
While CVTSPLSTMF has remained backwards compatible with previous releases, 
and existing code that runs CVTSPLSTMF will normally produce the same results as 
before, you cannot simply replace a call to CVTSPLSTMF with a call to the 
equivalent format-specific command and assume that you will obtain equivalent 
output.  
One of the main reasons for introducing the format-specific commands was to allow 
parameter formats and defaults to be modified compared with those in 
CVTSPLSTMF. Whilst this has enabled us to enhance the functionality of those 
parameters, rationalize their behavior or simplify their use, this does of course also 
mean that running one of the format-specific commands will not necessarily give the 
same results as CVTSPLSTMF with the same parameters. In some instances you 
will need to modify parameters in order to obtain the same results. 
  Color values 
C# PDF Library SDK to view, edit, convert, process PDF file for C#
HTML5 PDF Editor enable users to edit PDF text, image, page, password and so on. C#.NET: WPF PDF Viewer & Editor. C#.NET: Edit PDF Metadata.
remove metadata from pdf file; clean pdf metadata
C# TIFF: TIFF Editor SDK to Read & Manipulate TIFF File Using C#.
Tiff File Processing in C#. Refer to this online tutorial page, you will see: 2. Render text to text, PDF, or Word file. Tiff Metadata Editing in C#.
embed metadata in pdf; pdf metadata
Page: 
15 
In Version 4 and earlier, the colors generated in PDF when the various predefined 
color names were used (e.g. *GRAY, *BROWN etc.) were proprietary, i.e. they were 
set to values selected by ariadne. The RGB color values associated with the new set 
of color names in V5 is consistent with the industry standard colors adopted for 
HTML. This means that the same color name in V5 may generate a slightly different 
color in PDF from that generated in V4. However, the previous color can be 
generated by means of the new V5 feature which allows the specification of user-
defined colors. 
Changes between V3 and V4
  TODIR parameter 
Under V3, a second element of the TODIR parameter allowed you to specify the 
directory in which work files were created when generating a PDF file.  This element 
was removed in V4, which does not use work files in the same way as V3. 
  PMTADLPARM parameter 
The Prompt Additional Parameters parameter was introduced to control the 
displaying of many less frequently used options. 
Changes between V2 and V3
If you are currently running CoolSpools Version 2 in production, you must read the 
notes below before upgrading to a higher version.  
V3 fixed a number of problems in V2. However, having fixed these problems, we do 
not and cannot guarantee that the results you obtain with a later version of 
CoolSpools will be the same as those you obtained with V2, using the same 
parameters. You may therefore need to modify your parameters to obtain the same 
results. 
These comments apply in particular if you are using any of these features: 
  Bookmarks 
  Spooled file splitting 
  Exit program parameters 
  Additional page or overlay margins 
  Page size changes 
  Bookmarks, Split keys and Exit Program Parameters 
In the creation of V3, a lot of effort was put into improving the accuracy of 
CoolSpools text selection features, i.e. the identification of text strings in the spooled 
file (e.g. for SPLIT(*KEY) processing) and extraction of text strings from the spooled 
file (e.g. for bookmark purposes or as exit program parameters). These features 
worked very well in V2 in relation to traditional row-and-column based spooled files, 
but perhaps not quite so well when dealing with complex AFP spooled files, 
especially those using proportional fonts.  
VB.NET PDF- View PDF Online with VB.NET HTML5 PDF Viewer
NET PDF Viewer; VB.NET: ASP.NET PDF Editor; VB.NET Online. |. Home ›› XDoc.PDF ›› VB.NET PDF: View PDF Online. PDF bookmark, C#.NET edit PDF metadata, C#.NET
view pdf metadata; pdf xmp metadata
C# PDF Convert to Tiff SDK: Convert PDF to tiff images in C#.net
C#.NET PDF SDK - Convert PDF to TIFF in C#.NET. Online C# Tutorial for How to Convert PDF File to Tiff Image File with .NET XDoc.PDF Control in C#.NET Class.
read pdf metadata online; pdf remove metadata
Page: 
16 
With a proportional font, the positioning of a piece of text on the page is dependent 
not only on the font itself but also on the text content. For example, the string 
“WWWWWWWWWW” takes up much more space on the page than the string 
“iiiiiiiiii”, even though each string contains 10 characters in the same font. Previously 
CoolSpools did not take account of the text content and estimated the position of text 
on the page based on the number of characters and the average width of a character 
in the font being used. In V3 CoolSpools handles proportional fonts much better, and 
the accuracy with which text string identification and extraction works is much 
improved. 
However, this does has implications for existing applications. If you have production 
applications which use text functions (bookmarks, splitting or exit program 
parameters), it is possible that the results you obtain with V3 and later versions will 
not be identical to those you obtained previously with V2. Although we believe that 
V3 and later versions will deliver more accurate results, it may be that you are 
already running CoolSpools live with parameters which produce the results you 
desire (arrived at perhaps by trial and error). Running V3 and later versions with the 
same parameters may not give the same results, which could have undesirable 
effects on live applications. 
We strongly recommend therefore that any applications using text string features 
(bookmarks, splitting or exit program parameters) are re-tested and, if necessary, the 
parameters readjusted, before you go live with V3. 
  EXITPGMPOS and EXITPGMKEY parameters 
The EXITPGMPOS and EXITPGMKEY parameters were modified in V3 to allow 
multiple exit program parameters to be defined so that more than one string 
extracted from the spooled file could be passed as parameters to an exit program. 
If you have applications which run V2 of CoolSpools and specify an EXITPGMPOS 
or EXITPGMKEY parameter, please note that it is likely these will need to be 
modified to take account of this change before V3 or any later version will run 
properly. Specifically, an extra set of parentheses is necessary around the elements 
of the parameter. 
For example, if you currently have something like: 
CVTSPLSTMF...EXITPGMPOS(1 2 3 4 *INCH)  
this needs to be changed to: 
CVTSPLSTMF... EXITPGMPOS((1 2 3 4 *INCH))  
otherwise your application will report and error when running CVTSPLSTMF. 
  PAGESIZE parameter 
Please note that the operation of the PAGESIZE parameter was changed slightly 
between V2 and V3 in response to a number of improvements we made in the way 
CoolSpools handles rotated pages, overlays, images and text. 
The third element of this parameter previously allowed you to control whether text 
rotation was implemented in PDF or not. Text rotation in the spooled file is now 
Page: 
17 
always reflected in PDF output. The third element of the PAGESIZE parameter now 
controls whether or not rotated pages are viewed in rotated mode, or displayed 
without rotation for easier viewing. 
The fourth element of this parameter previously controlled whether CoolSpools took 
any account of page rotation. CoolSpools now always implements page rotation 
where it exists. Now this parameter element allows you to instruct CoolSpools to 
operate as if the spooled file were being directed to a printer which caused an 
automatic page rotation to occur. 
  MARGINS parameter 
A new element was added to the MARGINS parameter in V3 which allows you to 
instruct CoolSpools to shift text outside of an overlay by a distance on the page that 
you specify. This is necessary because some printers automatically shift text which 
would otherwise encroach on their non-print borders. This often happens when page 
rotation is in effect. The result of this automatic shifting is that text is printed on the 
page perhaps ¼ inch below where it would be expected to print based on the content 
of the spooled file alone. Since CoolSpools cannot anticipate whether this kind of 
shift occurs on your particular printer or not, you will need to instruct it to apply the 
shift using this new parameter element, in order to achieve proper alignment of text 
on the page. 
Previously you may have handled this kind of text misalignment by applying an 
additional overlay margin. You may obtain better results now using the text shift 
option.  
Page: 
18 
What’s new in this release?
Version 5 of CoolSpools adds many major new features.  
Highlights include: 
  CoolSpools API 
CoolSpools now provides an API for easier integration with your applications. 
  New command interfaces 
New format-specific commands (CVTSPLPDF for PDF, CVTSPLXLS for Excel 
etc.) simplify, streamline and rationalize parameter definition. 
  TOSTMF (*FTP) option 
Output stream files by FTP directly to a server (e.g. UNIX or Windows). 
  PDF merge and STMFOPT(*ADD) support with PDF 
The new MRGPDF command and the Merge API allow you to merge one or more 
existing PDFs into a single PDF. This includes PDFs created by applications 
other than CoolSpools. This functionality is used internally to provide support for 
STMFOPT(*ADD) in conjunction with TOFMT(*PDF), which was previously not 
allowed. 
  Improved Excel output 
The CVTSPLXLS command and the CVTSPLSTMF command when used with 
the EXCEL(*NEW) parameter employ an improved method for deciding how to 
allocate text in the spooled file to columns in an Excel spreadsheet. 
Other improvements to Excel output include: BIFF8-compatible output, control 
over the font used in the spreadsheet, improved column formatting, the ability to 
exclude page and column headings automatically, improved national language 
support and much more. 
  Support for *LINE and *AFPDSLINE spooled files 
CoolSpools can now convert *LINE and *AFPDSLINE spooled files. 
  Support for *USERASCII spooled files (HP PCL format) 
CoolSpools can now convert *USERASCII spooled files where the spooled file 
content is in HP PCL format (which is normally the case). 
The new RTVPCLRSC (Retrieve PCL Resources) command allows PCL 
resources such as soft fonts and macros to be retrieved from a PCL spooled file 
and saved for later use when converting spooled files that refer to those 
resources. 
  Nested bookmarks 
The new CVTSPLPDF command supports the definition of multiple bookmark 
strings to be used to generate a nested (hierarchical) bookmark structure. 
  New color names and user-definable colors 
The CVTSPLPDF, CVTSPLHTML and CVTSPLRTF commands support the 
entire range of color names normally supported in HTML by browsers. The 
CVTSPLSTMF command has been modified to support a subset of this full list. 
Page: 
19 
In addition, the COLOR parameter now allows the specification of user-defined 
colors in the form of an RGB (Red Green Blue) color number, similar to color 
numbers that can be used in HTML. 
  CVTSPLSPLF (Convert Spooled File to Spooled Files) 
Allows one or more new spooled files to be created from an existing spooled file. 
Supports exclusion of unwanted pages, splitting based on various criteria etc. 
  CoolSpools variables  
Requires PTF Q5CV0081 or higher. Lets you specify variable names in the 
form<:variable_name:> on certain parameters  such as TOSTMF,EMAILTO, FTP, 
TITLE etc. These variables are replaced at  run time by information 
corresponding to the variable, e.g. spooled file attributes. In addition, the 
variables<:exitpgmpos1:>,<:exitpgmpos2:>…,<:exitpgmkey1:>,<:exitpgmkey2:> 
can be used and are replaced at run time with the value of the first, second  etc. 
user-defined parameters specified through the use of the EXITPGMPOS and 
EXITPGMKEY command parameters. See the section on CoolSpools variables 
below for  further details. 
Page: 
20 
Installation
If you are installing CoolSpools Plus, please refer to the installation instructions in 
the CoolSpools Plus User Guide. These instructions apply only where you are 
installing the standalone version of CoolSpools.  
If you downloaded CoolSpools from the Internet, or received the product via e-mail, 
you will have received a zip file called CVTSPLV5R1.ZIP. This zip files contain 
everything you need to get started with CoolSpools. This section describes two 
possible procedures for installing CoolSpools on your iSeries.  
Please select one of the two methods described below and follow the steps carefully 
and in the order indicated. Method 1 is the simplest, but requires the use of FTP to 
your iSeries. If FTP is unavailable to you, for whatever reason, you may use Method 
2 instead. 
Steps to be carried out on the PC are shown in green, steps to be carried out on the 
iSeries in blue
Method 1: Installing CoolSpools using FTP
This method uses FTP (File Transfer Protocol) to transfer the CoolSpools product 
files from your PC to your iSeries. It is assumed that you have stored the 
CVTSPLV5R1.ZIP file which you downloaded from the Internet or received via e-mail 
on your PC and that you have enabled an FTP link between your PC and your 
iSeries. 
Step 1
On your PC, create an install directory for CoolSpools, either within Windows 
Explorer, or from the DOS prompt, e.g.: 
md c:\cvtspl 
Save or copy the zip file that you downloaded or received into this directory. 
Step 2
On your PC, unzip the contents of the zip file into the directory you just created 
using pkunzip, WinZip, Norton UnZip etc. 
Step 3
On your iSeries, decide which library you wish to use for the install procedure and 
create a save file in that library, e.g. 
crtsavf lib_name/cvtspl 
where lib_name is the name of the library you chose to use. 
Step 4
On your PC, start an FTP session to your iSeries. You may use FTP packages such 
as CuteFTP or simply go to the DOS prompt and type: 
ftp AS400_name 
where AS400_name is the name of your iSeries. 
Documents you may be interested
Documents you may be interested