EXTENSIONS
Specifies the extended options that ACIF uses. Extensions are MO:DCA-P data stream advanced features that might not be supported for all presentation devices. You must use care when you are choosing these options to ensure that they are supported by your print server, viewer, or printer.
EXTENSIONS={NONE | ALL | [BOX][,CELLED][,EMPTYOK] [,FRACLINE][,IDXCPGID][,PASSOID][,PASSPF][,PRCOLOR] [,RESORDER][,SPCMPRS]}
The values are:
- NONE
- ACIF does not use any extended options.
- ALL
- ACIF uses all extended options.
- Note:
- Many options apply only to specific data; for example IDXCPGID applies only to line data. Therefore, when you specify ALL, make sure that all of the options apply to your data. For best results, specify only the extended options that apply to the specific type of data you are using.
- More options might be added in the future that might not be supported by your presentation device.
- BOX
- Specifies that GOCA box drawing orders are supported. This option is required when you are using the DRAWGRAPHIC command in a record formatting page definition. See Drawing graphics with record format page definitions for an example of using this option.
- CELLED
- Specifies the IOCA Replicate and Trim function when you are converting IM1 celled images. This option might reduce the number of bytes needed for a raster image, and it might display or print faster. It requires that IMAGEOUT=IOCA is specified (the default).
- EMPTYOK
- When a job requests indexing, indicates that if the input file specified with the INPUTDD parameter is empty, ACIF ignores the indexing request, issues message 0425-422 with return code 64, and ends processing with RC=0. ACIF does not issue message 0425-448 when the indexing request is not successful and does not produce a resource file
- FRACLINE
- Specifies that GOCA fractional line width drawing orders are supported. This option is required when you are using the DRAWGRAPHIC command in a record formatting page definition. See Drawing graphics with record format page definitions for an example of using this option.
- IDXCPGID
- Specifies that ACIF processes code page identifiers for these Unicode code pages:
- 1200
- UTF-16 BE
- 1208
- UTF-8
- 13488
- UTF-16 BE
- 17584
- UTF-16 BE
- Note:
- This value is used only with line data, not MO:DCA-P or mixed-mode data.
- ACIF issues an error message if IDXCPGID is specified with the PASSPF parameter. If EXTENSIONS=ALL is specified, PASSPF is ignored and IDXCPGID is used.
See Indexing considerations for information about using the CPGID parameter when you are processing code page identifiers for Unicode data.
- PASSOID
- Specifies that ACIF passes OID information from the resource access table (RAT) to the Begin Resource (BRS or BR) structured field when it is saving TrueType and OpenType fonts. For more information about the RAT, see Using OpenType Fonts in an AFP System, G544-5876.
- PASSPF
- Specifies that ACIF passes the Begin Print File (BPF) and End Print File (EPF) structured
fields, which define the boundaries of the print data, to the output file when they
are found in the input file. If this value is not specified, ACIF discards the BPF/EPF
pair.
This parameter also controls whether a BPF/EPF structured field pair that the input record exit tries to insert is inserted. If this value is not specified, and the input record tries to insert a BPF/EPF pair, the attempt fails, and the pair is discarded.
- Note:
- Be careful when you are using PASSPF. If the output file contains BPF and EPF structured fields and it is concatenated with the resource file, the resulting MO:DCA-P data stream is not valid.
- This value is not used when the input file is line data because line data does not contain BPF and EPF structured fields.
- When PASSPF is specified and there is a BPF and EPF structured field pair in the input file, ACIF passes all Begin Document (BDT) and End Document (EDT) structured field pairs from the MO:DCA-P input file to the output data stream without adding the normal comment and time stamp triplets.
- ACIF issues an error message if PASSPF is specified with the IDXCPGID parameter. If EXTENSIONS=ALL is specified, PASSPF is ignored and IDXCPGID is used.
- ACIF does not verify whether the input file is MO:DCA IS/3 compliant.
For more information about BPF and EPF structured fields, see Begin Print File (BPF) and End Print File (EPF) structured fields.
- PRCOLOR
- Specifies that GOCA process color drawing orders are supported. This option is required when you are using the DRAWGRAPHIC command in a record format page definition. See Drawing graphics with record format page definitions for an example of using this option.
- RESORDER
- Specifies that inline resources do not need to appear in any particular order in the
input file; only before the Begin Document (BDT) structured field. When RESORDER is
not specified, inline resources must appear in the input file in the order in which
they are used. For example, if a coded font is inline, the character set and code
page that the coded font points to must occur inline first. When RESORDER is specified,
ACIF reads into memory only the inline resources that are actually needed to print
the job and uses them when they are requested; inline resources that are not needed
are not saved in the resource library.
- Note:
- When RESORDER is specified, TrueType and OpenType fonts that were originally inline in the input file are not saved in the resource library.
- Specifying RESORDER impacts performance and storage use.
- SPCMPRS
- Specifies the repeat string PTOCA order to compress embedded blanks.