agile principles patterns and practices in c# free pdf : Acrobat pdf additional metadata software SDK dll windows winforms .net web forms CoolSpoolsUserGuideV5R113-part1217

Page: 
131 
EXITPGMPRM - Exit Program Parameters 
Parameter 
EXITPGMPRM 
Applies to 
commands: 
CVTSPLSTMF, CVTSPLCSV, CVTSPLHTML, CVTSPLPDF, 
CVTSPLRTF, CVTSPLSAV, CVTSPLSPLF, CVTSPLTIFF, 
CVTSPLTXT, CVTSPLXLS, SAVSPLF 
Dependent on:  CVTSPLSTMF: PMTADLPARM(*YES) and not EXITPGM(*NO). 
Others: Not EXITPGM(*NONE) 
This parameter allows you to define whether CoolSpools should pass any user-
definable parameter strings to the exit program(s) defined on the EXITPGM 
parameter, and, if so, on what basis.  
Refer to the CoolSpools Programmer‟s Guide for further details of how to write and 
call an exit program. 
If EXITPGM(*VAR) is specified,  no  exit programs will be called but you can use the 
EXITPGMPRM,  EXITPGMPOS and/or EXITPGMKEY parameters for the purposes 
of defining variables to be extracted from the spooled file and referred to through the 
CoolSpools  variable names <:EXITPGMPOSn:> (where n = 1-99) or 
<:EXITPGMKEYn:> (where n = 1-99). 
This parameter consists of two elements: 
 Type of parameters 
 CCSID of parameter data 
Type of parameters 
Options are: 
*NONE 
No text will be extracted from the report.  
For an exit program with a Type 1 parameter list, the user-
definable parameter will consist of all blanks.  
For an exit program with a Type 2 or Type 3 parameter list, 
the user-definable parameter count will be zero and no user-
definable parameters will be passed. 
*POS 
You will use the EXITPGMPOS parameter to define one or 
more areas of the page from which text will be extracted and 
passed to the exit program(s) as user-definable parameters. 
*KEY  
You will use the EXITPGMKEY parameter to define one or 
more areas of the page from which text will be extracted and 
passed to the exit program(s) as user-definable parameters. 
*POSKEY  
You will use both the EXITPGMPOS and EXITPGMKEY 
parameters to define one or more areas of the page from which 
text will be extracted and passed to the exit program(s) as 
user-definable parameters. 
Acrobat pdf additional metadata - 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
change pdf metadata; bulk edit pdf metadata
Acrobat pdf additional metadata - 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
edit multiple pdf metadata; remove metadata from pdf
Page: 
132 
*BOTH  
Same as *POSKEY. Available from CVTSPLSTMF and 
provided for reasons of backwards compatibility only. 
CCSID of parameter data 
Determines the CCSID (Coded Character Set Identifier) which should be used when 
passing data to exit programs. 
Some spooled files (notably those of type *USERASCII) will hold data internally in 
ASCII. If the data is passed in its original form, it may not be easy to process in an 
exit program. If you would like CoolSpools to convert this data to a more user-
friendly CCSID (e.g. an EBCDIC CCSID) before passing it to the exit program, 
specify the CCSID to be used on this parameter. 
Options are: 
*SPLF
The data is passed in it original form as extracted from the 
spooled file. 
*JOB     
The CCSID of the current job is used. 
*SYSVAL  
The system CCSID (QCCSID system value) is used. 
*USER    
The CCSID of the current user (from the user profile) is used. 
CCSID_value  
Specify the CCSID in which the data should be passed. 
VB.NET PDF: How to Create Watermark on PDF Document within
logo) on any desired PDF page. And with our PDF Watermark Creator, users need no external application plugin, like Adobe Acrobat.
pdf xmp metadata viewer; batch pdf metadata
Page: 
133 
EXITPGMKEY - Exit program parameters string key 
Parameter 
EXITPGMKEY 
Applies to 
commands: 
CVTSPLSTMF, CVTSPLCSV, CVTSPLHTML, CVTSPLPDF, 
CVTSPLRTF, CVTSPLSAV, CVTSPLSPLF, CVTSPLTIFF, 
CVTSPLTXT, CVTSPLXLS, SAVSPLF 
Dependent on:  CVTSPLSTMF: PMTADLPARM(*YES) and EXITPGMPRM(*POS) 
Others: EXITPGMPRM(*POS) or EXITPGMPRM(*POSKEY) 
This parameter allows you to define key strings which CoolSpools will use as triggers 
for extracting text from the report to pass as parameters to the exit program(s) you 
specified on the EXITPGM parameter. 
If EXITPGM(*VAR) is specified,  no  exit programs will be called but you can use the 
EXITPGMKEY parameter for the purposes of defining variables to be extracted from 
the spooled file and referred to through the CoolSpools variable name 
<:EXITPGMKEYn:> (where n = 1-99, corresponding to the order in which the 
different parameters are defined on the EXITPGMKEY parameter). 
Up to 100 parameters may be selected in this way. 
Refer to the CoolSpools Programmer‟s Guide for further details of how to write and 
call an exit program. 
Each item consists of six elements: 
 Page number  
 Key string  
 Occurrence 
 Offset 
 Length 
 Measurement method 
Page number 
The page number from which the text should be extracted. CoolSpools will extract 
the text from the position on the page specified below and will pass it as a parameter 
to the exit program(s) defined on the EXITPGM parameter, but only for the page 
specified here. 
Note that this is the page number from the output file, not the input file. For example, 
if CoolSpools splits a 10-page spooled file into two 5-page stream files, then a page 
number of 1 on this parameter would refer to the first page in the two stream files, 
i.e. pages 1 and 6 from the original spooled file.  
Alternatively, specify *ALL and CoolSpools will pass the value at the specified 
location on each page in the output file. If the output file consists of 5 pages, 5 
parameters will be passed, one for each page. 
Key string 
Specify the key string which will trigger the selection of parameter text. 
This value is case-sensitive. 
Page: 
134 
Occurrence 
Where the key string appears more than once on each page, the number you enter 
on this parameter element will determine which occurrence of the key string will 
trigger the selection of parameter text. 
Offset 
Depending on the value specified for the “Measurement method” below, enter the 
offset in either characters (*ROWCOL) or measurement units(*MM, *CM, *INCH) 
from the start of the key string to the start of the text to be selected as a parameter. 
If a positive number is entered, this is interpreted as indicating that the parameter 
text is to the right of the key string, whereas a negative number indicates that the 
parameter text is to the left of the key string. 
Length 
Depending on the value specified for the “Measurement method” below, enter either 
the length of the parameter text in characters (*ROWCOL) or in measurement units 
on the page (*MM, *CM or *INCH). 
Measurement method  
Options are: 
*ROWCOL
Rows and columns.  
Use DSPSPLF as your guide and ensure that TEXT(*CPI) is 
also specified if using CVTSPLSTMF. 
*MM 
Millimeters  
*CM 
Centimeters 
*INCH 
Inches 
Example:    
CVTSPLPDF  
FROMFILE(INVOICES) 
TOSTMF(invoice.pdf)… 
SPLIT(*PAGE) 
SPLITPAGE(1) 
EXITPGM((Invexit)) 
EXITPGMPRM(*KEY) 
EXITPGMKEY((  1  
‘Customer name:’  
15  
50 
*ROWCOL)) 
In this example, the invoices spooled file is converted to separate PDF files for each 
page of the report. Every time a file has been completed, a program called INVEXIT 
will be called. The program will be passed 50 characters of text extracted from the 
spooled file starting 15 characters to the right of the first occurrence of the string 
„Customer name:‟ on the first page written to each stream file. 
Page: 
135 
EXITPGMPOS - Exit program parameters string position 
Parameter 
EXITPGMPOS 
Applies to 
commands: 
CVTSPLSTMF, CVTSPLCSV, CVTSPLHTML, CVTSPLPDF, 
CVTSPLRTF, CVTSPLSAV, CVTSPLSPLF, CVTSPLTIFF, 
CVTSPLTXT, CVTSPLXLS, SAVSPLF 
Dependent on:  CVTSPLSTMF: PMTADLPARM(*YES) and EXITPGMPRM(*POS) 
Others: EXITPGMPRM(*POS) or EXITPGMPRM(*POSKEY) 
This parameter allows you to define positions in the report from which CoolSpools 
will extract items of text and pass them as parameters to the exit program(s) you 
specified on the EXITPGM parameter. 
If EXITPGM(*VAR) is specified,  no  exit programs will be called but you can use the 
EXITPGMPOS parameter for the purposes of defining variables to be extracted from 
the spooled file and referred to through the CoolSpools variable name 
<:EXITPGMPOSn:> (where n = 1-99, corresponding to the order in which the 
different parameters are defined on the EXITPGMPOS parameter). 
Up to 100 parameters may be selected in this way. 
Refer to the CoolSpools Programmer‟s Guide for further details of how to write and 
call an exit program. 
Each item consists of five elements: 
 Page number  
 Line number or y coordinate 
 Char. position or x coordinate 
 Length 
 Measurement method 
Page number 
The page number from which the text should be extracted.  
CoolSpools will extract the text from the position on the page specified below and will 
pass it as a parameter to the exit program(s) defined on the EXITPGM parameter, 
but only for the page specified here. 
Note that this is the page number from the output file, not the input file. For example, 
if CoolSpools splits a 10-page spooled file into two 5-page stream files, then a page 
number of 1 on this parameter would refer to the first page in the two stream files, 
i.e. pages 1 and 6 from the original spooled file.  
Alternatively, specify *ALL and CoolSpools will pass the value at the specified 
location on each page in the output file. If the output file consists of 5 pages, 5 
parameters will be passed, one for each page. 
Line number or y coordinate 
Depending on the value specified for the “Measurement method” below, enter either 
the line number on which the parameter text appears in the spooled file (*ROWCOL) 
or the vertical coordinate on the page at which the start of the text appears 
(measured in millimeters for *MM, centimeters for *CM or inches for *INCH). 
Page: 
136 
Char. position or x coordinate 
Depending on the value specified for the “Measurement method” below, enter either 
the column number on which the parameter text appears in the spooled file 
(*ROWCOL) or the horizontal coordinate on the page at which the start of the text 
appears (measured in millimeters for *MM, centimeters for *CM or inches for *INCH). 
Length 
Depending on the value specified for the “Measurement method” below, enter either 
the number of characters which the parameter text occupies in the spooled file 
(*ROWCOL) or the horizontal space it occupies on the page (measured in 
millimeters for *MM, centimeters for *CM or inches for *INCH). 
Measurement method  
Options are: 
*ROWCOL
Rows and columns.  
Use DSPSPLF as your guide and ensure that TEXT(*CPI) is 
also specified if using CVTSPLSTMF. 
*MM 
Millimeters  
*CM 
Centimeters 
*INCH 
Inches 
Example:    
CVTSPLPDF  
FROMFILE(INVOICES) 
TOSTMF(invoice.pdf)… 
SPLIT(*PAGE) 
SPLITPAGE(5) 
EXITPGM((Invexit) 
EXITPGMPOS((*ALL 10 20 50 *ROWCOL) ) 
In this example, the invoices spooled file is converted to separate PDF every 5 
pages. Every time a file has been completed, a program called INVEXIT will be 
called. The program will be passed 5 user-defined parameters representing the 50 
characters of text located on line 10 starting at column 20 on each of the 5 pages of 
the stream file. 
Page: 
137 
FONT – Font options 
Parameter 
FONT 
Applies to 
commands: 
CVTSPLHTML, CVTSPLPDF, CVTSPLRTF, CVTSPLSTMF, 
CVTSPLXLS 
Dependent on:  CVTSPLSTMF: PMTADLPARM(*YES) and TOFMT(*PDF), 
TOFMT(*HTML), TOFMT(*HTMLCSS) or TOFMT(*RTF). 
This parameter lets you manage the way CoolSpools handles fonts when creating a 
stream file from your spooled file.  
It consists of the two elements: 
 Face 
 Size 
A third element is available only in relation to PDF: 
 Font types to embed 
Face 
The first element is the Font Face.  
The following special options are available: 
*MAP
In relation to PDF, CoolSpools maps iSeries fonts to an 
equivalent PC font from the PDF basic font set (listed below). 
This option will minimize the size of the PDF file created, but 
the appearance of the text in the PDF file may not necessarily 
exactly reproduce the appearance of the text in the iSeries 
spooled file when printed, but will normally be very close to 
it. 
In relation to HTML and RTF, CoolSpools will likewise select 
a standard PC font equivalent to the font used in the iSeries 
spooled file. Typically this will be Courier for fixed-pitch 
fonts, Arial for sans-serif proportional fonts and Times for 
other proportional fonts. 
This is a single value on the CVTSPLHTML, and 
CVTSPLRTF commands and is not available for 
CVTSPLXLS. 
*CONVERT 
Same as *MAP, which has replaced it. This value is available 
only from CVTSPLSTMF, where it is supported for reasons 
of backwards compatibility.  
*EMBED 
This option is only available with CVTSPLPDF or 
CVTSPLSTMF with TOFMT(*PDF).  
Where possible, CoolSpools will embed the font in the PDF 
file. This guarantees that the font will be available when the 
Page: 
138 
PDF file is viewed in Acrobat, and will reproduce the 
appearance of the iSeries font on the printed page as closely as 
possible. However, it may also significantly increase the size 
of the resultant PDF.  
Please note also that embedding low-resolution iSeries raster 
fonts in PDF may not give good results when the resultant 
PDF file is viewed online. This is simply due to limitations of 
the raster font technology. When printed, the appearance 
should be comparable to the quality when the font is use to 
print documents from your iSeries (though clearly this 
depends to some extent on the printers used in each case). 
In addition, you can select one of the following predefined font names corresponding 
to the basic PDF font set. When used with PDF, these fonts are guaranteed by 
Adobe Acrobat to be always available when you view a PDF file that uses them. All 
text in the stream file will use the font selected. 
*COURIER 
Courier. All text will appear in Courier font. 
*COURIERB 
Courier Bold 
*COURIERO 
Courier Oblique 
*COURIERBO 
Courier Bold Oblique 
*HELVETICA 
Helvetica 
*HELVB 
Helvetica Bold 
*HELVO 
Helvetica Oblique 
*HELVB 
Helvetica Bold 
*HELVBO 
Helvetica Bold Oblique 
*TIMES 
Times Roman 
*TIMESB 
Times Roman Bold 
*TIMESI 
Times Roman Italic 
*TIMESBI 
Times Roman Bold Italic  
*SYMBOL 
Symbol 
*DINGBATS 
Zapf Dingbats 
*ARIAL 
Arial. This option is available only from CVTSPLXLS where 
it is the default. 
Page: 
139 
Size 
The second element is the Font Size.  
Options are: 
*SCALE 
CoolSpools selects an appropriate font size based on the font, 
CPI and LPI information in the spooled file. This method is 
the same as *CALC (see below) except in relation to fonts 
specified by FGID (font identifier), such as those defined with 
the DDS FONT keyword. In the case of fonts specified by 
FGID, when the font is reproduced in PDF by a mapping, the 
font point size is calculated based on the LPI value and then 
condensed using a horizontal scaling to the appropriate CPI 
value. This usually reproduces the appearance of the original 
printed spooled file more closely than *CALC. 
This option is only available from CVTSPLPDF (where it is 
the default value) and CVTSPLSTMF. 
*CALC 
CoolSpools selects an appropriate font size based on the font 
and CPI information in the spooled file.  
This is the default for CVTSPLSTMF, CVTSPLHTML and 
CVTSPLRTF. 
font_size 
Specify a font size in points to be applied to all text. 
For CVTSPLXLS, the default is 10 points.  
Font types to embed 
The third element is only relevant when *EMBED is selected and is only available in 
relation to PDF output. It allows you to control which types of iSeries fonts are 
embedded in the resultant PDF.  
Single options are: 
*NONE
No fonts are embedded. This value is not allowed if *EMBED 
is specified for the first element of the FONT parameter.  
*ALL   
CoolSpools will embed all font types which can currently be 
embedded. 
Other options are: 
*PSTYPE1 
Postscript Type 1 fonts (also called outline fonts on iSeries) 
will be embedded. 
*CIDKEYED 
CID-keyed fonts (PostScript Type 0 fonts) will be embedded. 
These are DBCS fonts. 
*RASTER  
Raster (bitmap) fonts are embedded.  
Page: 
140 
*FONTID 
Fonts specified by a font identifier (e.g. by means of the DDS 
FONT keyword) are embedded. This is dependent on a 
suitable font resource object being available for embedding. 
Please note that iSeries raster (bitmap) fonts are relatively low resolution (typically 
240 or 300 pels per inch) and are imported into PDF in the form of bitmap images. 
When displayed on screen in Adobe Acrobat, these bitmaps can appear jagged and 
uneven and the presentation quality is generally rather poor. This is a feature of the 
font technology, not a deficiency on the part of CoolSpools. When printed, the PDF 
accurately reproduces the print quality of the iSeries font on the page. 
Example:    
CVTSPLPDF  
FROMFILE(SALES)… 
FONT(*MAP) 
Here the sales report is converted to PDF format and CoolSpools will attempt to 
select suitable replacement fonts for those used in the spooled file. 
Example:    
CVTSPLPDF  
FROMFILE(SALES)… 
FONT(*EMBED) 
The same report is converted, but where possible CoolSpools will embed a copy of 
each iSeries font in the resultant PDF.  
Example:    
CVTSPLXLS  
FROMFILE(SALES)… 
FONT(*ARIAL 10) 
Here the same report is converted, but this time to Excel format, and 10-pt Arial will 
be used throughout. 
CoolSpools will also assist you in improving the appearance of your reports in PDF, 
RTF and HTML format by providing messages in the job log to inform you about the 
font mappings it has made. If you are not satisfied with the appearance of your report 
in PDF, RTF or HTML, you should examine the job log of the job in which the 
command was executed, and locate any messages of the form: 
Courier 10 substituted for font id 11 
or 
Courier Bold 10 substituted for font resource C0S0CB10 
These messages are intended to help you identify which font is and font resource 
names need to be mapped. You can try alternative font mappings through the user-
definable font mapping facility, implemented via the CVTFONTID and CVTFNTRSC 
parameters described below. 
Documents you may be interested
Documents you may be interested