Analyze the contents of a PMDF-FAX G3 file and generate a DDIF file containing the G3 file's bitmaps.

Syntax

PMDF G3 G3-file-spec [DDIF-file-spec]

Command Qualifiers	Defaults
/CDA	/CDA
/EDIT	None
/INFORMATION	/INFORMATION
/MAGNIFICATION=factor	/MAGNIFICATION=1

restrictions

• Will only operate on PMDF-FAX G3 files; files with other formats will be rejected.
• Requires SYSLCK privilege to operate.
• This utility is supplied only with the PMDF-FAX optional layered product.

prompts

Input file:	G3-file-spec
Output file:	DDIF-file-spec

Parameters

G3-file-spec

The name of a PMDF-FAX G3 file. G3 will check that a proper G3 file is specified and will abort execution when supplied the name of a non-G3 file. Only a single input file name may be supplied; wildcards are not allowed.

DDIF-file-spec

The name of a DDIF file (CDA document) to which to write the input file's bitmaps. This file will be created by G3 and may subsequently be viewed with the CDA viewer as shown in the example below. If the /NOCDA or /EDIT qualifies are used, then this parameter must be omitted.

Description

The G3 utility may be used to analyze the contents of a G3 file in a G3_TO_FAX channel queue directory. In addition, the G3 utility is capable of converting a G3 file to a DDIF file which may then be viewed with the HP CDA Viewer. If you merely want to view header and delivery information in a G3 file, then use the /NOCDA qualifier. This will disable the time-consuming output of a DDIF file containing the bitmap images stored in the G3 file.

Information about each of the To: recipients in a G3 file may be edited using the edit mode invoked with the /EDIT qualifier. This allows incorrect FAX telephone numbers to be edited, delivery to specific recipients to be cancelled, etc.

Note The G3 utility is part of the PMDF-FAX software product. It is not part of the base PMDF distribution.

Command Qualifiers

/CDA (default)

/NOCDA

By default a CDA document is output by G3. This document is a DDIF file containing the individual bitmaps stored in the G3 file. When the /CDA qualifier is used, the DDIF-file-spec parameter must be supplied. The DDIF-file-spec parameter must be omitted when the /NOCDA qualifier is specified. The /MAGNIFICATION qualifiers may not be used in conjunction with the /NOCDA qualifier.

/EDIT

When the /EDIT qualifier is given, the G3 utility operates in edit mode, presenting each To: address contained in the G3 file for editing. The /CDA, /MAGNIFICATION, and /INFORMATION qualifiers may not be used in conjunction with the /EDIT qualifier. In addition, the output DDIF file specification may not be given when this qualifier is used.

/INFORMATION (default)

/NOINFORMATION

By default, information about the G3 file is displayed (e.g., the recipients of the FAX message embodied by the G3 file and the delivery status associated with each recipient). When the /NOINFORMATION qualifier is used, the display of this information is suppressed.

/MAGNIFICATION=factor

When a CDA document is output, it is scaled to be the same size as the actual FAX message (approximately 8.5 by 10.5 inches). This corresponds to a magnification of 1 (a scaling by a factor of unity). With the /MAGNIFICATION qualifier, the document may be scaled upwards or downwards by a prescribed scaling factor. For instance, to reduce the document to half size, use the qualifier /MAGNIFICATION=0.5. This qualifier may not be used in conjunction with the /NOCDA qualifier.

EXAMPLES

The following example illustrates the use of the CDA Viewer to view the FAX images contained in a G3 file.

$ PMDF G3 PMDF_QUEUE:[g3_to_fax]xyzzy.01 fax.ddif $ VIEWER/INTERFACE=DECWINDOWS/OVERRIDE fax.ddif