When the PRINT/CDAM parameter in the decollation mission is defined as TRANSTO=(PDF,STORE) and the STORE parameter in the print mission is set to Y, the following report formats can be transformed to PDF format:
AFP Category 3, 4, and 5 reports
Xerox LCDS and Metacode reports
Plain text reports
This feature has the following advantages:
Avoids the need for on-the-fly transformation under Control-D®/WebAccess Server
Enables retention of all AFP and Xerox resources on z/OS
The PDF transformation can be performed for regular reports and for normalized reports created by the ON TRNDSN and ON TRNCLASS decollation parameters. Control-V indexes created by decollation are adjusted for the resulting PDF file.
The transformed PDF report can be accessed by Control-D/WebAccess Server users through index navigation.
AFP and Xerox normalized reports do not require steps 2, or 8, below, but may require additional resources that are used for rendering, specifically, FONTMAP.tbl, as described in step 1 below.
AFP category 5 reports require the FORMDEF parameter. If the report has a FORMDEF in the resource section it is used, and the report can be transformed without a Report Clique or TRANSTO member. In this case you should define all the AFP Resource Libraries in the * entry in the $$TRNRES member. For more details see Collecting resources for transformation.
Text reports can be transformed without a Report Clique or TRANSTO member, using default parameters. If non-standard parameters (such as font name, font size, or add background image) are needed, a Report Clique or overriding parameters in the TRANSTO member can be used.
Xerox reports that are not normalized are printed under Control-D with Xerox DJDE parameters (in the DJDEPARM library). These parameters are also added when Xerox reports are transformed to PDF. For more information on DJDE parameters, see Printing Using XEROX LCDS (DJDE) Parameters.
The following steps describe the report transformation procedure:
It is important to map AFP and Xerox fonts to True Type fonts so the Transformation will run faster. The mapping is done with the fontmap table specified in the Report Clique. A default FONTMAP.tbl is supplied in the IOA SAMPREPS library, and it will be available to the Transformer if the following lines are included in the entry for the report in the $$TRNRES member:
AFP,ALL=IOA.SAMPREPS library name
or
XRX,ALL=IOA.SAMPREPS library name
The FONTMAP table can be created by Control-D/Desktop in Control‑D/WebAccess installations and then uploaded to the IOA SAMPREPS library on the mainframe, with translation to EBCDIC. There can be multiple font mapping tables for different reports, each table with a different name. Specify the name of the table in the Font Mapping Table Name parameter of the Report Clique.
Font mapping considerations
If a font mapping table is not found, the report will be transformed without any mapping. AFP and Xerox fonts that are not mapped, by default, are converted to Type 3 fonts and are embedded into the resulting PDF file.
If there are many fonts and the transformed PDF has a few pages, you may use the following Report Clique parameter for reducing the size of the resulting PDF:
PDF Raster = {Text | All}
For more information see the "Font Mapping and Text Rendering" section in the Report Transformation chapter of the Control‑D/WebAccess Server Administrator Guide.
Define Report Clique in the DO.1 screen and specify the parameters that describe the report and its resources. For more information see the Online Facilities chapter of the Control‑D and Control‑V User Guide.
In the decollation definition, define PRINT/CDAM parameters as TRANSTO=(PDF,STORE).
Do one of the following:
For AFP category 3 and category 4 reports, in the decollation definition define PRINT/CDAM parameters as ASSOC=AFP4. (AFP category 5 reports are automatically defined as ASSOC=AFP.)
For Xerox LCDS reports and Metacode reports, in the decollation definition define PRINT/CDAM parameters as ASSOC=XRX.
Define a DO PRINT statement in a decollation definition for referencing a print mission from the next step.
Set the print mission STORE parameter to Y.
Specify either MIGRATE or BACKUP fields (or both) if transformed reports in PDF format must be migrated or backed up.
Create a member in the TRANSTO library, assigning the jobname of the report as the member name.
TRANSTO Library Member Syntax
Each member in the TRANSTO library should employ the following syntax:
++++report name mask
[PROG=CTDRPDF]
[CLIQUE=Report Clique name]
[parameter name=parameter value] [;comment]
You can specify entries for each report name in one of the following ways:
Specify a Report Clique name. All parameters will be taken from the Report Clique.
Specify Report Clique parameters. All parameters that are not specified will have default values.
Specify both a Report Clique name and Report Clique parameters.
In this case the specified parameters override corresponding parameters from the Report Clique.
The following is an example of a TRANSTO member:
++++report name mask
CLIQUE=name of the clique defined in the DO.1 screen
+++REP1*
Rotation=90
++++*
CLIQUE=name of the clique defined in the DO.1 screen
PDFResolution=240
FontMappingTableName=TTFONT
Report Clique parameters are listed in the "Common Report Clique Parameters" table in the Report Clique section of the Online Facilities chapter of the Control‑D and Control‑V User Guide.
Run the Print mission.
By default, two print missions can concurrently transform to PDF. You can increase the number of concurrently running print missions to a maximum of five by applying the WD2375 Wish.
Check that the print mission ended OK and use Control‑D/WebAccess Server to view the PDF report. If the report is displayed correctly, all Report Clique parameters were correctly defined and all resources are available. If the PDF report does not look like the printed report, check one of the following options:
Missing resources
Locate the resource library that has the missing resource, and add this library to the list of libraries in the correct entry in $$TRANSTO member (see step 2).
Wrong font mapping table
The fonts of the PDF report do not look like the original fonts.
Wrong parameters in the Report Clique
For example,
if the report is rotated, use the Rotation=parameter
In case of an incorrect form check the AFP FORMDEF and PAGEDEF
for Xerox check the XEROX JSL and JDE.
When you activate trace, the Report Clique parameters used for transformation are written to the SYSPRIN DD statement in the CTDPRINT monitor.
After fixing the problems rerun the print mission until the PDF report appearance is improved.
Tip: If a report is extremely large, transformation to PDF can take a long time. In such cases, try to create a special, smaller report with the same structure and print it until it displays correctly. After the smaller report is correctly displayed you can then transform the large report.