Configuring Control-D Delivery Server Report Cliques

Report Cliques are a group of parameters that provides information about the report accessed in the Control-D Mainframe repository and how to transform the report in the Control-D Delivery Server. The Report Clique issues instructions, which determines how a report appears after you transform a report and includes information, such as, the number of rows and columns, image to insert, digital signatures requests, and font size. A report cannot transform without a defined report clique.

This procedure describes how to define a report clique with the Control-D Delivery Server which enables you to transform reports.

Begin

From the Root directory, navigate to the following location:

Definitions > Common > Report Clique > Report Click Root>
From the Report Click Root folder, select one of the following options:
- AFP Report Cliques.
- PCL Report Cliques.
- PDF Report Cliques.
- PS Report Cliques.
- TXT Report Cliques.
- XEROX Report Cliques.
Right-click the selected folder and click Add.

The New Item report clique window appears.
For each field, define the required parameters, as described in Report Clique Parameters.

A new report clique appears in the folder.

Report Clique Parameters

The following table describes Common Report Clique parameters:

Parameter	Description
General Parameters	Determines the Report Clique file properties.
Row Col Parameters	Determines the number of columns and rows on a report, and the text direction.
Rendering Parameters	Determines the appearance and settings of the transformed report.
PDF Rendering Parameters	Determines whether the user, can edit, copy, or print PDF reports.
HTML Rendering Parameters	Determines the appearance and settings of the transformed report, such as, background colors, fonts, and images.
PCL Rendering Parameters	Determines the appearance and settings of a report transformed in PCL format.
AFP Report Clique Parameters	Determines the appearance and settings of a report transformed in AFP format.
PostScript (PS) Report Clique Parameters	Determines the appearance and settings of a report transformed in PostScript format.
Text Report Clique Parameters	Determines how text appears in a transformed report.
Xerox Report Clique Parameters	Determines the appearance and settings of a report transformed in PostScript format.

General Parameters

The following table describes the General Report Clique parameters.

Each report type, except PDF, has its own unique parameter section.

Report Clique Parameter	transformer.ini Parameter	Description
Report Format	reportformat	Determines the report format file type. Valid values: AFP XRX PCL TXT PDF PS
Report Clique Name	reportcliquename	Defines the Report Clique name. Default: Untitled.
Owner of Report Clique	owner	Defines the Report Clique owner name.
Report Clique Change Date	changedate	Determines the Report Clique edit date.
Report Clique Change Time	changetime	Determines the Report Clique edit time.
Page Width in Inches	pagewidthininches	Determines the number of inches on the report page width. Default: 600 In Text reports, the width does not affect the text view. This parameter does not influence Xerox reports.
Page Height in Inches	pageheightininches	Determines the number of inches on the report page height. Default: 600 BMC recommends that you use the default page width and height for all formats.
OS390 Resource Library List Name	os390resourceliblistname	Defines the name of a set of System Resource Libraries. Valid values: Eight characters. Default: * You cannot leave this field empty.
Fail on missing resources	failonmissingresources	Determines whether the transformation process aborts when non-critical resources are missing. Valid values: Never: Never abort when resources are missing. Always: Always abort when resources are missing. Decollate: Only abort when you decollate the report, but not when you view the report. Default: Decollate
Default Resource Directory	defaultresdir	(Optional) Defines the resource directory filename path.

Row Col Parameters

The following table describes the Row Col parameters for Report Clique.

Report Clique Parameter	transformer.ini Parameter	Description
Number of Rows	rowcolnrows	Determines the number of grid rows, which divides the report page. Default: 150.
Number of Columns	rowcolncolumns	Determines the number of grid columns, which divides the report page. Default: 150
Text Orientation 0	rowcoltext_0_degrees	Determines whether the transformer checks for text at 0 degrees. Valid values: Yes No Default: Yes.
Text Orientation 90	rowcoltext_90_degrees	Determines whether the transformer checks for text at 90 degrees. Valid values: Yes No Default: Yes.
Text Orientation 180	rowcoltext_180_degrees	Determines whether the transformer checks for text at 180 degrees. Valid values: Yes No Default: Yes.
Text Orientation 270	270 rowcoltext_270_degrees	Determines whether the transformer checks for text at 270 degrees. Valid values: Yes No Default: Yes.
Fonts to Ignore	rowcolfontstoignore	(Optional) Defines a list of fonts to ignore. Default: None (all fonts included). AFP fonts names must begin with C0, such as C0H1001B even when the font name is C1H1001B.
Include External Overlays	rowcolincludeexternaloverlays	(Optional) Determines whether the transformation includes text in an external overlay. Default: Yes
Include Internal Overlays	rowcolincludeinternaloverlays	(Optional) Determines whether the transformation includes text in an internal overlay. Default: Yes
Include Comments in Rowcol Page	rowcolincludecomments	(Optional) Determines whether the transformation includes comments. Default: Yes.

Rendering Parameters

The following table descries the Report Clique Rendering parameters.

Report Clique Parameter	transformer.ini Parameter	Description
Rotation	rotation	Determines the clockwise rotation degree of a report. Valid values: 0 90 180 270 Default: 0
Shadowing	shadowing	Determines whether shadowing appears on a report. Valid values: Yes: Allows shadowing to appear. No: Removes shadowing. Only High: Shadowing only appears in high resolution output. Default: Only High.
Shadowing Style	shadowingstyle	Determines the type of shadowing that appears on a report. Valid values: Gray: Gray shadowing appears. Pattern: A pattern of lines appears. Default: Gray BMC recommends that you use gray to view reports and a pattern and a pattern to print reports.
Half Tone	halftone	Determines whether you must use a Halftone algorithm to draw bitmap images. Valid values: Yes: Use the Halftone algorithm. No: Use the Black on White algorithm. All text only appears in black or white. Default: Yes.
Max Render Pages	maxrenderpages	Determines the maximum number of pages to transform. Default: 2000.
Font Mapping Table Name	fontmappingtablename	(Optional) Defines the table name to map fonts in to transform reports. Default: fontmap
Split Words	splitwords	(Optional) Determines whether you must split words when you transform a report. Valid values: Yes: Split words according to blanks. This value is useful when the original font is wider than rendering font, and the report contains tables. It results in a larger PDF. No: Leave the words as a sentence when there is one blank between words. Default: No.
Color	color	(Optional) Determines whether the colors appear in a report. Valid values: Yes: -A PDF or HTML report contains colors. No: The report appears only in black and white. Default: Yes.
Font File Name		Defines the font name.
Font Size		Determines the font size. Default: 10

PDF Rendering Parameters

The following table describes the PDF rendering parameters for Report Clique.

Report Clique Parameter	transformer.ini Parameter	Description
Add Background Image	addbackgroundimage	(Optional) Defines the image filename to add onto each PDF page. The image appears default resource directory: installation /transformer/res. Valid file types .gif .tif .jpg .png .bmp. Default: No image.
Print	pdfprint	(Optional) Enables you to giver the user permission to print a PDF report. Valid values: Yes No Default: Yes
Copy	pdfcopy	(Optional) Enables you to giver the user permission to copy a PDF report. Valid values: Yes No Default: Yes
Modify	pdfmodify	(Optional) Enables you to giver the user permission to modify a PDF report. Valid values: Yes No Default: Yes
Assembly	assembly	(Optional) Enables you to use the Assembly security option when you transform a PDF report.
Copy for Accessibility	pdfaccesscopy	(Optional) Enables you to enhance accessibility in PDF Files with the Copy for Accessibility feature.
Commenting	pdfcomment	(Optional) Enables you to give the user permission to add comments to a PDF report.
High Resolution Printing	pdfhiresprint	(Optional) Determines whether the report must print in a high resolution.
Filling of the form fields	pdfformfield	(Optional) Determines whether the user can type in the form fields on a report.
Font Subsetting	pdffontsubsetting	(Optional) Determines whether to embed font characters in a report. Valid values: Yes No Default: Yes
Master Password	pdfmasterpassword	(Optional) Enables you to define a master password to change security settings in a PDF report. Valid values: Yes No Default: No
PDF Resolution	pdfresolution	(Optional) Enables you to define the resolution of the PDF image file. Valid values: 72−300 Yes No Default: 300
PDF Raster	pdfraster	(Optional) Enables you to define which elements are rastered on a bitmap and inserted into the PDF as a background image. Valid values: None: All elements appear as PDF elements. Rastered text that does not appear in the fontmap.tbl appears in the PDF file as TYPE3 fonts. All: All elements, except mapped fonts, are rastered on a bitmap and appear as a background image on the PDF. Graphics: All graphics elements, such as, lines, and filled areas, raster on a bitmap and appear in the PDF as a background image. Other elements appear as PDF elements. Text: All text rasters on a bitmap and appears as a background image on the. Other elements appear as PDF elements. Default: None
PDF Encoding	encoding	(Optional) Enables you to encode text in different character sets. Valid values: None: Latin-1 encoding only. Unicode: All text in the PDF is in Unicode. Default: None (Latin-1 encoding).
Code Page	code_page_num	(Optional) Enables you to code PDF pages.
PDF Debug	pdfebug	Determines whether to generate a trace file when you debug the PDF creation process.
PDF Logging	pdflogging	Generates a log file when you debug PDFs
Digital Sign: For This Report	DIGSIG	Enables you to add a digital signature request to a PDF report. Valid values: Yes No Default: No report.
Digital Sign: Key Store File	DIGKSF	Defines the key store filename.
Digital Sign: Key Store Type	DIGKST	Determines one of the following key store file types. Valid values: JKS PKCS12 Default: JKS
Digital Sign: Key Store Password	DIGKSP	Defines the key store file password.
Digital Sign: Alias in Key Store	DIGKKA	Defines the key alias in the key store file.
Digital Sign: Hash Algorithm	DIGHA	Determines the type of the hash algorithm when you create a digital signature. Default: SHA256

The following example defines the Digital Signature definitions in the Report Clique.

The following example isa Java Key Store definition:

Copy

Digital Sign: For This Report - Yes
Digital Sign: Key Store File - C:\Program Files (x86)\BMC Software\Control-D\delivery\config\bmc-ctd-ds-server.jks
Digital Sign: Key Store Type - JKS
Digital Sign: Key Store Password - abcd1234
Digital Sign: Alias in Key Store -
Digital Sign: Hash Algorithm - SHA256

The following example is a PKCS12 definition:

Copy

Digital Sign: For This Report - Yes
Digital Sign: Key Store File - C:\Program Files (x86)\BMC Software\Control-D\delivery\config\IOAGATE.pck12
Digital Sign: Key Store Type - PKCS12
Digital Sign: Key Store Password - ctm_zos_1202
Digital Sign: Alias in Key Store -
Digital Sign: Hash Algorithm - SHA256

PCL Rendering Parameters

The following table describes the PCL rendering parameters for Report Clique.

Report Clique Parameter	transformer.ini Parameter	Description
PCL Paper Source	pclpapersource	(Optional) Determines the PCL paper size. Default: A4
PCL Paper Tray	pclpapertray	(Optional) Determines which PCL paper tray to use when you print reports. Default: Automatic
PCL Resolution	pclprinterresolution	Determines number of bytes per inch in the PCL printout resolution. Valid values: 300−600 Default: 300
PCL Scale	pclscale	Determines the percent by which to decrease the size of the output page. Valid values: 0−80 Default: 0
PCL Y Offset	pclyoffset	(Optional) Enables you to shift the text and images on the rendered page vertically, according to the number of pixels specified. Negative numbers shift the data up, and positive numbers shift the data down. Valid values: −12000−12000 Default: 0
PCL X Offset	pclxoffset	(Optional) Enables you to shift the text and images on the rendered page horizontally, according to the number of pixels specified. Negative numbers shift the data left, and positive numbers shift the data right. Valid values: −12000−12000 Default: 0

HTML Rendering Parameters

The following table describes the HTML rendering parameters for Report Clique.

Report Clique Parameter	transformer.ini Parameter	Description
XResolution	xresolution	Determines one of the following X-resolution values in the PNG or HTML output. This does not affect PDF output. Valid values: 10−300 Default: 96
YResolution	yresolution	Determines one of the following Y-resolution values in the PNG or HTML output. This does not affect PDF output. Valid values: 10−300 Default: 96
Background Image Url	htmlbackgroundimageurl	(Optional) Defines a background image URL that appears in the HTML output.
Use EOT Fonts	htmluseeotfonts	Determines whether to use EOT fonts when EOT Web-enabled fonts appear in the font-mapping table. Default: Yes
Use PFR Fonts	htmlusepfrfonts	Determines whether to use PFR fonts when PFR Web-enabled fonts appear in the font-mapping table. Default: Yes
X Offset	htmlxoffset	Enables you to move text and images horizontally in pixels. Negative numbers shift the data left, and positive numbers shift the data right. Default: 0
Y Offset	htmlyoffset	Enables you to move text and images vertically in pixels. Negative numbers shift the data up, and positive numbers shift the data down. Default: 0
Background Color	htmlbackgroundcolor	(Optional) Defines the HTML background color.
Foreground Color	htmlforegroundcolor	(Optional) Defines the HTML foreground color.
Image XResolution	imagexres	Determines the X resolution of the output background image. The Image XResolution uses the same Image YResolution when you do not set the Image XResolution. Valid values: 0−300 Default: 0
Image YResolution	imageyres	Determines the Y resolution of the output BACKGROUND image. The Image TResolution uses the same Image XResolution when you do not set the Image YResolution. Valid values: 0−300 Default: 0

PostScript (PS) Report Clique Parameters

The following table describes the Report Clique parameters that, which are unique to PostScript reports.

Report Clique Parameter	transformer.ini Parameter	Description
Raster Embedded Fonts	embedded_raster	(Optional) Enables you to raster embedded PostScript fonts when you use the PostScript Interpreter. Valid values: No: The font appears as text when it maps to an existing True Type font. Yes: The font rasters even when mapping exists in the fontmap table and appears as an image. Default: No.
Raster All Text	raster_text	(Optional) Enables you to force of all the text to raster when you use the Post Script Interpreter. Valid values: No: The font appears as text when it maps to an existing True Type font. Yes: The font rasters even when mapping exists in the fontmap table and appears as an image. Default: No.
PostScript Transformation Resolution	transformres	Determines the bitmap resolution when you transform PostScript reports. High resolution produces better quality images. Low resolution results in a faster processing. Values: 50−300 Default: 240

Report Clique

Parameter

transformer.ini Parameter

Description

Raster Embedded Fonts

embedded_raster

(Optional) Enables you to raster embedded PostScript fonts when you use the PostScript Interpreter.

Valid values:

No: The font appears as text when it maps to an existing True Type font.
Yes: The font rasters even when mapping exists in the fontmap table and appears as an image.

Default: No.

Raster All Text

raster_text

(Optional) Enables you to force of all the text to raster when you use the Post Script Interpreter.

Valid values:

No: The font appears as text when it maps to an existing True Type font.
Yes: The font rasters even when mapping exists in the fontmap table and appears as an image.

Default: No.

PostScript Transformation

Resolution

transformres

Determines the bitmap resolution when you transform PostScript reports.

High resolution produces better quality images. Low resolution results in a faster processing.

Values: 50−300

Default: 240

AFP Report Clique Parameters

The following table describes the Report Clique parameters that, which are unique to AFP reports.

Report Clique Parameter	transformer.ini Parameter	Description
Afp Formdef Name	afpformdefname	Defines the FORMDEF name. Default: The first FORMDEF in the resource section of the report.
AFP Input Type	afpinputtype	Determines the type of AFP input. Valid values: AfpCategory4: AFP Category 4. AfpCategory5: AFP Category 5. Anything less than AfpCategory5 appears as AfpCategory4. Default: AfpCategory5
Afp Pagedef Name	afppagedefname	(Optional) (AFP Category 4 only) Defines the Pagedef name in a report. Default: The first Pagedef in the resource section of the report.
Record Delimiter	afprecdelim	Determines the input report record type. Valid values: RDW: Variable length data, each record starting with XXYY, where XX designates the record length and YY is binary zeros. Fixed: (AFP Category 4 only) All records have the same length.
Length of input records	recordlength	(AFP Category 4 only) Determines the record length of input fixed-type AFP records. Valid values: 133−32760
Print control character	afpprintcontrolchar	(AFP Category 4 only) Determines one of the following Print control characters types in a report. Valid values: ASA MACHINE Default: ASA
Code of input AFP	afpinputcode	(AFP Category 4 only) Determines of the following AFP input codes. Valid values: ASCII EBCDIC Default: EBCDIC
TRC character used	Afpinputtrc	(AFP Category 4 only) Determines whether a report can contain TRC characters. Used for AFP Category 4 input only. Valid values: Yes No Default: No
AFP Default Medium Map	afpstartimm	(Optional) Determines the Medium Map to use when you define the Formdef.
AFP Default Data Map	afpstartidm	(Optional) Determines the Medium Map to use when you define the Pagedef.

Text Report Clique Parameters

The following table describes the general Report Clique parameters:

Report Clique Parameter	transformer.ini Parameter	Description
Report Encoding	reportencoding	Defines the report encoding. The report transforms from the defined coding to Latin-1 in LEGACY mode or to UTF-8 in UNICODE mode, and then kept in the translated encoding. Default: Latin1 in LEGACY; or UTF-8 in UNICODE
Report Language	reportlanguage	Defines the report language and correct font. You must only use define this field when Control-D/WebAccess Server is in UNICODE mode. Default: English
Report Normalized Encoding	normalizedencoding	(Optional) Defines the internal report encoding in Control-D Mainframe. The report transforms from the encoding defined in the Report Encoding parameter to Normalized encoding. You must only define this field when Control-D/WebAccess Server is in Legacy mode Default: Latin-1 in Legacy mode or UTF-8 in UNICODE mode.
Print Control Char	printcontrolchar	Determines which Print Control characters to use when you view reports. Valid values: ASA Machine None Default: None
TRC character used	inputtrc	Determines whether the report contains TRC characters. Valid values: Yes No Default: No

The following tables describes the Decollation Rendering parameters, which are unique to text Report Cliques.

Report Clique Parameter	transformer.ini Parameter	Description
The following three parameters are mutually exclusive. You must only one define one of the parameters, which ensures that the results are predictable.
Page Delimiter String	pagedelimiterstring	Defines the string to end a page and start a new page.
Page Delimiter Hex	pagedelimiterhex	Determines the Hex value to end a page and start a new page.
Page Delimiter Dec	pagedelimiterdec	Determines the decimal value to end a page and start a new page.
The following three parameters are mutually exclusive. You must only one define one of the parameters, which ensures that the results are predictable.
Line Delimiter String	linedelimiterstring	Defines the string to end a indicate the end of a line and start a new line.
Line Delimiter Hex	linedelimiterhex	Determines the Hex value end a line and start a new line. Default: X'0D0A' (crlf-carriage return line feed).
Line Delimiter Dec	linedelimiterdec	Determines the decimal value end a line and start a new line.
Line Delimiter Length	linedelimiterlength	Determines the number of characters for each line. Valid values: 0−32768.
The following parameters are NOT mutually exclusive.
Page Delimiter At End	Pagedelimiteratend	Determines whether the page delimiter appears the end of the page. Valid values: Yes: Page delimiter appears at the end of the page. No: Page delimiter appears at the beginning of page.
Line Delimiter Delete	linedelimiterdelete	Determines whether the line delimiter deleted from the Normalized data.
Page Delimiter Delete	pagedelimiterdelete	Determines whether the page delimiter deleted from the Normalized data.
Page Delimiter Pos	pagedelimiterpos	(Optional) Determines which column contains a delimiter line. Default: 0 (delimiter located at beginning of line).
Max Chars in Line	maxcharsinline	Determines the maximum number of characters that appear in a line. Valid values: 0−32768 Default: 1000.
Max Lines in Page	maxlinesinpage	Determines the maximum number of lines that appear on a page. Valid values: 0−32768 Default: 1000.
Add Page Delimiter Hex	addpagedelimiterhex	(Optional) Determines the hexadecimal value to indicate the End of Page. Default: 0x0c (FF)
Add Line Delimiter Hex	addlinedelimiterhex	(Optional) Determines the hexadecimal value to indicate the End of Line. Default: 0x0DOA (CR LF)
Line Delimiter Type	linedelimitertype	Determines the type of line delimiter that appears in reports. Valid values: Delimited: Each line ends with a line delimiter according to the line delimiter parameters. rdw: Variable-length data. Each record starts with xxyy: xx: record length. yy: binary zeros. Fixed: All the lines have the same length. None: One line appears on a page. Default: Delimited
Add Line Feed	addlinefeed	(Optional) Enables you to add a line feed at end of each line. Valid values: Yes No Default: No.

The following tables describes Rendering parameters, which are unique to text Report Cliques.

Report Clique Parameter	transformer.ini Parameter	Description
Font File Name	fontfilename	Defines the font filename that appears text reports. The encoding font is Latin 1, the default filename is cour.ttf, which is the True Type filename of Courier New.
Font Name	fontname	Defines the font name that appears in text reports.
Font Size	fontsize	(Optional) Determines the font size. Valid values: 1−99 Default: 10

Report Clique

Parameter

transformer.ini Parameter

Description

Font File Name

fontfilename

Defines the font filename that appears text reports.

The encoding font is Latin 1, the default filename is cour.ttf, which is the True Type filename of Courier New.

Font Name

fontname

Defines the font name that appears in text reports.

Font Size

fontsize

(Optional) Determines the font size.

Valid values: 1−99

Default: 10

Xerox Report Clique Parameters

The following tables describes the Xerox Report Clique parameters that are unique to Xerox reports are located in the Xerox Parameters section. You must include the following parameters and their values:

JSL Name: JSL filename
JDE Name: JDE section name in the JSL file.

Report Clique Parameter	transformer.ini Parameter	Description
Record Delimiter	xeroxrecdelim	Determines one of the following Input report record types. Valid values: rdw: Variable-length data. Each record starts with xxyy: xx: Record length. yy: Binary zeros. fixed: Record length appears from the start JSL statement: RECORD LENGTH = number. Default: rdw
JSLName	xeroxjslname	Defines the JSL filename.
JDE Name	xeroxjdename	Defines the JDE section name in the JSL resource.
SysCatalog Name	xeroxsyscatalogname	(Optional) Defines the member name, which refers to other JSL resources in the report. Default: syscatlg. You must add a line to the syscatlg resource when the JSL resource refers to a JDE/PDE that is not available. The syscatlg resource is located in the default resource directory, installation_folder\transformer\res. SYSCATTYPE=PDE,RESNAME=PP0010,FILE=PDE001,CRDATE=1997250,CRT E=132200,SIZE=0,PATH='PDE001.JSL'; In this example, the JDE/PDE name is PP0010, located in the PDE001 JSL file.
DEBUG	debug	(Optional) Determines whether to send debug messages to a file. Valid values: Yes No Default: No
Debug File Name	debugfile	(Optional) Defines the filename that receives debug messages.
Error File Name	errorfile	(Optional) Defines the filename that receives error messages.
Form X Offset	formxoffset	(Optional) Enables you to shift the page form horizontally in pixels. Negative numbers shift the data left, and positive numbers shift the data right. Default: 0
Form Y Offset	formyoffset	(Optional) Enables you to shift the page form vertically in pixels. Negative numbers shift the data up, and positive numbers shift the data down. Default: 0
Page Data X Offset	pagedataxoffset	(Optional) Enables you to only move the data in the page horizontally (the overlays do not move). Negative numbers shift the data left, and positive numbers shift the data right. Default: 0
Page Data Y Offset	pagedatayoffset	(Optional) Enables you to only move the data in the page horizontally in pixels. Negative numbers shift the data up, and positive numbers shift the data down. Default: 0
Line Advance Method	xeroxlcdslineadvancemethod	(Optional) Determines one of the following methods to calculate the line height. Valid values: Max: Height of the largest font in the line. Last: Height of the last font in the line. Default: Max.
Report Identifier	report_id	(Optional) Defines the report ID that needs special handling.
Scan Origin point	xeroxscanorigin	(Optional) Determines the origin point on the physical page and uses it as a reference point for metacode on a XEROX printer. On 9790 printers, this origin point is scan=22 and dot=100. These values might differ on your printer. Adjust the origin point parameters when forms do not align with the line-data. Default: Scan Origin point = 22.
Dot Origin point	xeroxdotorigin	(Optional) Determines the origin point on the physical page and uses it as a reference point for metacode on a XEROX printer. Default: Dot Origin point = 100.