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
1 – Restrictions
o Will only operate on PMDF-FAX G3 files; files with other
formats will be rejected.
o Requires SYSLCK privilege to operate.
o This utility is supplied only with the PMDF-FAX optional
layered product.
2 – Prompts
Input file: G3-file-spec
Output file: DDIF-file-spec
3 – 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.
4 – 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.
5 – Command Qualifiers
5.1 /CDA
/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.
5.2 /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.
5.3 /INFORMATION
/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.
5.4 /MAGNIFICATION
/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.
6 – 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