aspose pdf c# example : Creating bookmarks in pdf documents software SDK dll windows wpf .net web forms CoolSpools_Spool_Converter_User_Guide_V6R11-part1227

CoolSpools Spool Converter User Guide V6R1  
Page: 
11
www.ariadnesoftware.co.uk
If security or confidentiality is a concern, PDF files created with CoolSpools can be 
secured so that they cannot be modified or printed, or if you want them to be really 
secure, you can password-protect them. 
Information sharing 
However many copies of a report you print, it's never enough. There's always 
someone else who'd like to see it but is in an office on the other side of the country 
and can't get access to a copy. 
Files created by CoolSpools can be stored on a central corporate server, such as 
your system i or a Windows or UNIX server, and shared amongst your users as a 
corporate information resource.  
Alternatively, you could publish them on your Web site for customers worldwide to 
see, or on a secure Intranet or Extranet. 
Report Enhancement 
CoolSpools doesn’t just convert your reports, it enhances them too. 
For example, when converting to PDF format, you can add bookmarks that index the 
pages of your report so your users can find the information they want quickly and 
easily. When you create a PDF or HTML document from a spooled file, you can add 
color to improve the presentation as well. Maybe you couldn’t afford 
a system i color 
printer: now that’s no longer an issue since you can 
simply convert your spooled file 
to PDF and print your document on an inexpensive PC color printer!  
Archiving and offline storage 
The system i provides no built in means of saving and restoring spooled files. Yet for 
many companies their system i reports are a critical part of their business process, 
and may not be easy to re-create. Maybe you have to waste large amounts of 
expensive system i disk just keeping copies of old reports online. Doing this can also 
impact your system's performance, since jobs which created spooled files remain in 
the system even when they have ended if they created spooled files which still exist 
on an output queue, 
Files created by CoolSpools can be stored on inexpensive storage media such as 
PC disk or CD-ROM for easy retrieval. Once CoolSpools has converted your report 
to a stream file, you can move this file to a PC server, or save it to tape or to CD-
ROM, then delete the original spooled file, freeing up precious system i resources.  
CoolSpools offers several options for archiving spooled files. You can convert the 
spooled file to a PDF file, in which case you would use Adobe Acrobat reader to re-
print the report; you can convert it to an RTF (Rich Text Format) file, in which case 
you would use a Word Processor such as MS Word; or you can use the CoolSpools 
SAVSPLF command to create a stream file in CoolSpools’ own stream file archive 
format, in which case the RSTSPLF command can be used to restore the original 
spooled file from the stream file archive at a later date. 
Both PDF and archive format use data compression to minimize the size of the 
archived spooled file. PDFs can be created in PDF/A format, which is ISO 19005-
1:2005, an international standard for document archiving.
Creating bookmarks in pdf documents - add, remove, update PDF bookmarks in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Empower Your C# Project with Rapid PDF Internal Navigation Via Bookmark and Outline
adding bookmarks to pdf document; export pdf bookmarks to excel
Creating bookmarks in pdf documents - VB.NET PDF bookmark library: add, remove, update PDF bookmarks in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Empower Your VB.NET Project with Rapid PDF Internal Navigation Via Bookmark and Outline
bookmark pdf documents; add bookmarks pdf
CoolSpools Spool Converter User Guide V6R1  
Page: 
12
www.ariadnesoftware.co.uk
Document Formats
CoolSpools converts system i spooled files to a stream file in one of several different 
formats. Where the stream file is created, where you will store it permanently, and 
how you will access it, will depend on a number of factors.  Some typical approaches 
are discussed below in the secti
on “Where did my output go?”
You can choose several different formats for your files, depending on your particular 
requirements.  
Adobe® PDF (Portable Document Format) 
Adobe® Portable Document Format (PDF) is the de facto standard for electronic 
document distribution. PDF is a universal file format that preserves the fonts and 
formatting of the source document. PDF files are compact and can be shared, 
viewed, navigated, and printed exactly as intended by anyone with a copy of the free 
Adobe Acrobat Reader, which can be downloaded from many places on the Internet, 
including the Adobe site at http://www.adobe.com/products/acrobat/readstep.html.
Adobe PDF is the ideal format for electronic document distribution because it 
overcomes the problems commonly encountered in electronic file sharing. If you 
create a document in PDF format and e-mail it to a customer, so long as the 
recipient has a copy of the Acrobat reader, you can be confident that they will be 
able to read and print the document and that it will appear to them just as it did to 
you when you created it.  
PDF files can be published and distributed anywhere. You can attach them to e-mail, 
make them available on a corporate server, an Intranet or Extranet, post them on 
Web sites or circulate them on CD-ROM.   
If you want to use CoolSpools to distribute and archive your system i reports, PDF is 
the format to choose. 
XML 
Starting with Version 6, CoolSpools can convert your system i spooled files to XML. 
XML is used by a variety of applications, such as EDI. 
Conversion to XML requires the use of a report definition
which defines the semantic 
structure and content of the spooled file. 
HTML (Hypertext Mark-up Language) 
HTML is the language in which web pages are written. If you would like to view your 
reports in a browser, such as Netscape® Navigator or Microsoft ® Internet Explorer, 
CoolSpools can convert your spooled files to HTML format so you can do so. 
Excel Format 
If your users would prefer to have their data in the form of a spreadsheet rather than 
just columns of number on a sheet of paper, CoolSpools can create a native Excel 
(™) spreadsheet (.xls file) from your spooled file. 
Options allow you to exclude unwanted lines from your report as it is converted to 
Excel format (for example, report headings not required in the spreadsheet). 
C# Create PDF Library SDK to convert PDF from other file formats
Gratis control for creating PDF from multiple image formats PDF with a blank page, bookmarks, links, signatures Load PDF from existing documents and image in
how to create bookmarks in pdf file; creating bookmarks in pdf documents
VB.NET Create PDF Library SDK to convert PDF from other file
Gratis control for creating PDF from multiple image formats PDF with a blank page, bookmarks, links, signatures Load PDF from existing documents and image in
how to create bookmark in pdf automatically; create pdf bookmark
CoolSpools Spool Converter User Guide V6R1  
Page: 
13
www.ariadnesoftware.co.uk
RTF (Rich Text Format) 
If you want to access your spooled file data in a word processing application, RTF is 
the format to choose.  
RTF (Rich Text Format) is a format understood and handled by most if not all 
modern WP programs, including MS Word, Lotus WordPro, MS WordPad etc. 
Delimited ASCII Text  
CoolSpools can also convert your report to a delimited ASCII text file, such as a CSV 
(comma-separated variable file) or TSV (tab-separated variable file). This format is 
ideal for loading reports containing columns of numbers into a spreadsheet, 
Business Intelligence tool or other application for further manipulation.  
CoolSpools can use any field delimiter you like (by default a comma, but also tabs, 
semicolons, blanks etc.) and any string separator you specify (by default a double 
quote “), allowing you to generate files in the precise format required by your PC 
application. 
Plain ASCII Text  
CoolSpools can also simply convert your system i spooled file to a basic ASCII text 
file. This file can then be loaded into virtually any PC application, such as a word 
processor or spreadsheet. ASCII text versions of your spooled files may also be 
useful for indexing purposes as part of a document management solution. 
TIFF format 
CoolSpools can also create a TIFF (Tagged Image Format File) image from your 
spooled file. This is suitable for viewing in an imaging application such as Windows 
Image and Fax Viewer. 
Archive format 
You can also save spooled files as stream files in a highly compressed spooled file 
archive format using the CoolSpools SAVSPLF command. Spooled files saved in 
this way can be restored from the stream using the CoolSpools RSTSPLF command. 
Please note that (depending on the IFS file system selected) the stream files created 
using this option may still reside on your system i disks, albeit in the IFS rather than 
as a spooled file. You should use the OS/400 SAV command to back these stream 
files up to tape, or copy them to CD-ROM or to a PC server, before considering that 
your spooled files are truly secure. Please note also that these archive files are not 
viewable in any PC application.  
XDoc.Word for .NET, Advanced .NET Word Processing Features
Viewing, editing, converting, processing, creating, annotating and zooming & rotation; Outlines, bookmarks, & thumbnail Create Word from PDF; Create Word from
add bookmark pdf; auto bookmark pdf
PDF Image Viewer| What is PDF
such as text extraction, hyperlinks, bookmarks and metadata as version among a suite of PDF-based standards to develop specifications for creating, viewing, and
create pdf bookmarks from word; how to bookmark a pdf page
CoolSpools Spool Converter User Guide V6R1  
Page: 
14
www.ariadnesoftware.co.uk
Upgrade Notes
Please read the following notes carefully before upgrading to CoolSpools Spool 
Converter V6R1M0 from an earlier version of CoolSpools or CoolSpools PLUS. 
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: 
Product 
Library Name 
Licensed 
Program Id 
Version 
CVTSPLV2R1 
2CVTSPL 
CoolSpools 
Version 2 
CVTSPLV3R1 
3CVTSPL 
CoolSpools 
Version 3 
CVTSPLV4R1 
4CVTSPL 
CoolSpools 
Version 4 
CVTSPLV5R1 
5CVTSPL 
CoolSpools 
Version 5 
COOLSPV5R1 
5COOLSP 
CoolSpools 
PLUS 
V5R1M0 
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. 
CoolSpools Spool Converter was previously available as both a standalone module 
and also as part of the complete CoolSpools PLUS suite. Now, CoolSpools Spool 
Converter is packaged as a product option (option 1) of CoolSpools V6R1M0. 
License Keys
You are entitled to upgrade to V6R1M0 of CoolSpools Spool Converter free of 
charge if: 
the machine on which you wish to run CoolSpools Spool Converter V6R1M0 
has a valid license for an earlier version of CoolSpools or CoolSpools PLUS 
and 
you are either in your first 12 months’ maintenance period after purchase or 
have paid your latest annual maintenance invoice. 
Please note that if your system has multiple logical partitions (LPARs), you must 
purchase a license for each partition on which you wish to run the software. 
How to C#: Basic SDK Concept of XDoc.PDF for .NET
annotation features can be integrated into your C# project, such as annotation creating, deleting, modifying This class describes bookmarks in a PDF document
how to add bookmarks to pdf document; bookmarks pdf file
VB.NET PDF: Basic SDK Concept of XDoc.PDF
features can be integrated into your VB.NET project, such as annotation creating, deleting, modifying This class describes bookmarks in a PDF document.
adding bookmarks in pdf; bookmarks pdf
CoolSpools Spool Converter User Guide V6R1  
Page: 
15
www.ariadnesoftware.co.uk
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 Spool Converter, you will need to request a license key for the 
new version. Simply e-mail support@ariadnesoftware.co.uk
and ask for your key for 
V6R1M0 of CoolSpools Spool Converter. 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 Spool Converter V6R1M0 will allow you a 30-day 
grace period and will then no longer run. 
If you have not paid your annual maintenance invoice, and if you need longer than 
30 days to test CoolSpools V6R1M0, 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 
V6R1M0, 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 V6R1M0 of CoolSpools Spool 
Converter is OS/400 V5R3M0. 
If you are running V5R2M0 or an earlier version of OS400, you will not be able to 
install V6R1M0 of CoolSpools Spool Converter.  
How to C#: Basic SDK Concept of XDoc.PowerPoint
Conversely, conversion from PDF to PowerPoint (.PPTX C# project, such as annotation creating, deleting, modifying This class describes bookmarks in a PowerPoint
create bookmarks in pdf; add bookmark to pdf reader
How to C#: Basic SDK Concept of XDoc.Word
Conversely, conversion from PDF to Word (.docx) is C# project, such as annotation creating, deleting, modifying This class describes bookmarks in a Word document
convert word pdf bookmarks; pdf reader with bookmarks
CoolSpools Spool Converter User Guide V6R1  
Page: 
16
www.ariadnesoftware.co.uk
Product Library
All product options of CoolSpools V6R1M0 install into the single product library 
COOLSPV6R1. This means that you no longer have to manage multiple product 
libraries for the separate modules that made up CoolSpools PLUS V5R1M0 
(Slipstream, Communiqué, CoolSpools etc.) 
You will probably 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. 
This change of library name has the advantage that it allows you to run both 
V6R1M0 and the earlier versions on the same machine. You are therefore able to 
test V6R1M0 before swapping your production applications over to the new version, 
as we strongly advise you to do. 
Memo to Users
Please refer to the Memo to Users
for important information about changes you 
need to take account of before migrating to CoolSpools Spool Converter from an 
earlier version of CoolSpools or CoolSpools PLUS. 
Changes between V4 and V5
This section lists changes affecting users upgrading from Version 4 of CoolSpools or 
earlier. 
Please note that V5 was a major modification from V4 and this list is not exhaustive. 
You should re-test your applications before going live with a later version 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 introduced two alternatives: the Conversion API and the format-specific 
commands (CVTSPLPDF for PDF, CVTSPLXLS for Excel, CVTSPLRTF for RTF 
etc.) 
While CVTSPLSTMF remained backwards compatible with previous releases, and 
existing code that runs CVTSPLSTMF would 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 enabled us to enhance the functionality of those 
parameters, rationalize their behavior or simplify their use, it did of course also mean 
that running one of the format-specific commands would not necessarily give the 
same results as CVTSPLSTMF with the same parameters. In some instances you 
need to modify parameters in order to obtain the same results. 
How to C#: Basic SDK Concept of XDoc.Excel
Conversely, conversion from PDF to Excel (.XLSX) is also C# project, such as annotation creating, deleting, modifying This class describes bookmarks in a Excel
bookmarks pdf documents; create bookmarks in pdf reader
CoolSpools Spool Converter User Guide V6R1  
Page: 
17
www.ariadnesoftware.co.uk
Color values 
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 was consistent with the industry standard colors adopted for 
HTML. This means that the same color name in V5 might generate a slightly different 
color in PDF from that generated in V4. However, the previous color could 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.  
CoolSpools Spool Converter User Guide V6R1  
Page: 
18
www.ariadnesoftware.co.uk
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 e
ach 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 have 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 an 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 
always reflected in PDF output. The third element of the PAGESIZE parameter now 
CoolSpools Spool Converter User Guide V6R1  
Page: 
19
www.ariadnesoftware.co.uk
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.  
CoolSpools Spool Converter User Guide V6R1  
Page: 
20
www.ariadnesoftware.co.uk
What’s new in 
CoolSpools Version 6?
Highlights include: 
Report Definitions and Report Maps 
Define the structure of reports to be converted by creating Report 
Definitions 
Define the structure of Excel files and XML documents to be generated 
by creating Report-to-Excel maps or Report-to-XML maps 
By using a Report-to-Excel map with the new CVTSPLXL (Convert 
Spooled File to Excel) and CVTSPLDLM (Convert Spooled File to 
Delimited Text) commands, it is possible to achieve much greater 
control over the structure and formatting of Excel and delimited files 
such as CSVs than was previously possible.  
By using a Report-to-XML map with the new CVTSPLXML command, 
complex XML documents can be generated from a spooled file. 
XML 
CoolSpools Spool Converter can now generate XML by means of the 
new CVTSPLXML command 
A simple schema (or XSD or DTD) can be automatically generated or 
the XML can be linked to an existing schema 
A simple stylesheet (XSLT or CSS) can be automatically generated or 
the XML can be linked to an existing stylesheet 
Excel 2007 .xlsx (Office Open XML) format 
CVTSPLXLS and the new CVTSPLXL command can now optionally 
generate Excel 2007 Office Open XML format files (.xlsx)  
BIFF 8 (Excel 97+) .xls files is still the default Excel format 
Support for BIFF 5 (Excel 95) files is now withdrawn. 
Styles and formatting options 
When converting to Excel using CVTSPLXL and when converting to 
XML with CVTSPLXML, named styles can be defined on the new 
DFNSTYLES parameter. 
Style definitions can also be defined and stored permanently using the 
WRKSTLDFN, CRTSTLDFN, etc, commands and referred to 
subsequently on commands such as CVTSPLXLS, CVTSPLXL and 
CVTSPLXML. 
The styles can be associated with particular types of data (details, 
headings, titles etc.) or, using the APYSTYLES parameter, with 
individual fields to control the visual formatting of the output such as 
font, text color, background color, numeric formatting etc. 
Conditional formatting 
Documents you may be interested
Documents you may be interested