Control-D/WebAccess Server Resource Management

Control-D/WebAccess Server uses print resources, saved in the Resource Manager directory, to transform reports from Control-D. All report resources must be available to successfully transform reports. A report fails to transform when a critical resource is unavailable. Resources might include the following:

• Fonts

• Page definitions.

• Segments

• Form definitions.

• Report Cliques.

• Graphics and images.

• Overlay definitions.

• Color management.

• Index and data resources.

You can configure how the transformers behaves with the FailOnMissingResources Report Clique parameter when any of the required resources is missing.

• Never: Transformation does not fail when non-critical resources are unavailable. The transformation resources use substitute resources when resources are unavailable, such as, missing fonts.

• Always: Transformation fails when any resource is unavailable.

• Decollate: The transformation fails when you request normalized data or text but does not fail when you transform a report to PDF, HTML, or PCL report formats.

The following sections describe report format resources.

• AFP Resources

• XEROX Resources

• PCL Fonts

• Font Mapping Resources

AFP Resources

AFP is an IBM architecture and file format and defines the parameters, which controls the appearance and layout of reports. The resource files must be available in the \transformer\res folder to successfully transform an AFP report.

The following table describes AFP resources you need to transform reports.

File extension	Description	Example
*.fnt	Code	SYS1.FONT*(C*)
*.ccp	Code pages	SYS1.FONT*(T*)
*.cdf	Coded fonts	SYS1.FONT*(X*)
*.fde	Formdefs	SYS1.FDEFLIB(F*)
*.oly	Overlay	SYS1.OVERLIB(O*)
*.psg	Page segments	SYS1.PSEGLIB(S*)

XEROX Resources

XEROX resources define parameters that controls the appearance and layout of reports. The resource files must be available in the \transformer\res folder to successfully transform an AFP report.

The following table describes XEROX resources required to transform reports, which appears in the \res directory when you install Control-D/WebAccess Server.

File extension	Description
Forms$.fnt	Font
Formsx.fnt	Font
L0112B.fnt	Default Font
Syscatlg.cat	Reference to more JSL resources.
Zzzres.jsl	Basic JSL

The following table lists additional resource files to downloaded from the XEROX printer, as described in Adding XEROX Resources.

File Extension	Description
*.frm	Forms
*.lgo	Logos
*.jsl	JSLs
*.fnt	Fonts
*.img	Images

Adding XEROX Resources

This procedure describes how to download XEROX resource files and save them in the Resource Directory.

Begin

• Do one of the following:

  • XEROX Printer: 

    1. Download resources from a XEROX printer by running the following command:

       XEROX LPS FLOPPY

    2. Download the following resource files:

       • *.frm

       • *.lgo

       • *.jsl

       • *.fnt

       • *.img

       • *.ict

       You can download JSL members from any location, such as Control-D. All resources must be in binary format. JSL and Syscalg files must be in text format.

    3. Save the resources in the Resource Manager directory located in the following folder:

       <installation_folder>\transformer\res

  • Mainframe: 

    1. Download resources from Control-D Mainframe by running the following commands:

       TAPE VOLINIT 6250

       COPY TAPE WRITE LABEL *.JSL

       COPY TAPE WRITE LABEL *.FNT

       COPY TAPE WRITE LABEL *.FRM

       COPY TAPE WRITE LABEL *.IMG

       COPY TAPE WRITE LABEL *.LGO

       COPY TAPE WRITE LABEL *.ICT

       TAPE ENDFILE

       END

    2. Save the resources in the Resource Manager directory located in the following folder:

       <installation_folder>\transformer\res folder

  XEROX resource files are saved in the Resource Manager directory.

PCL Fonts

PCL print jobs use characteristics that describe the print job and do not use font names to transform reports. The printer selects the font that best matches the defined attributes, from installed fonts, and prints with that font.

You need a pclglue.glu file to transform PCL fonts with the Control-D/WebAccess Server.

pclglue.glu File

The pclglue.glu File maps original fonts to font characteristics and consists of two sections:

• Installed Font: Includes fonts copied from the operating system.

• Not Installed Font Includes fonts that do not appear in the operating system.

You must provide the following information for each font in each of these sections.

FONT=font_name--name of the original font

/characteristic

. . .

/characteristic

The list of installed fonts and the list of non-installed fonts are maintained in separate sections of the pclglue.glu file or the results might be unpredictable. The following table lists the valid font characteristics.

Characteristics	Explanation of values
/spacing =	Determines one of the following word spacings in a report. Valid values: 0: Fixed spaces. 1: Proportional.
/style = number	Determines one of the following font styles to use in a report: Valid values: 0: Upright, solid. 1: Italic 4: Condensed. 5: Condensed italic.
/weight = (-7)-7	Determines the thickness or darkness of the characters in a font. Valid values: (-7) -7 -3: Light. 0: Medium. 3: Bold. 4: Extra Bold.
/typeface = number	Defines the font type number.
/font file =	Defines font filename.

The following table describes additional PCP font characteristics.

Characteristics	Explanation of values
/symset = font_symbol_set	Defines the font symbol set name.
/pitch = pitch	Determines the number of characters per inch, which is only valid for fixed fonts.
/height = font height	Defines the font height, in points.
/orient = <0-3>	Determines the font orientation. Valid values: 0−3

Adding PCL Printer Fonts

This procedure describes how to add a PCL printer font to the <installation_folder>\transformer\res folder, which enables you to print reports on different systems.

Begin

1. Navigate to the TTF font file in the following location in the system directory:

   winnt\fonts

2. Copy the fonts and save them in the installation_folder\transformer\res folder.

3. From the pclglue.glu file, in the Not Installed Font section, type the font's characteristics as described in the following example.

   Your report uses the Strider font and h is not available in the resource directory. Follow the steps, as described in Adding PCL Printer Fonts, and add the following entry to the pclglue.glu file to include the Strider font:

   FONT = Strider

   /spacing = 1

   /style = 0

   /weight = 0

   /typeface = 774

   /font file = strr59w.ttf