EXTENSIONS

Determines the extended options that ACIF uses.

Required
No
Default Value
NONE
Data Type
AFP, Line

Extensions are MO:DCA data stream advanced features that might not be supported for all presentation devices. You should use care when choosing these options and make sure that they are available on your print server, viewer, or printer.

Syntax

EXTENSIONS=value

Options and values

The value can be:
NONE
ACIF does not use any extended options.
ALL
ACIF uses all of the extended options.
Remember: Use caution when specifying ALL. More options might be added in the future that might not be supported by your presentation device.
ADDTLE
If the input file is fully composed AFP, ACIF will add group TLEs to the output and index files. The TLE attribute name is specified as an INDEX parameter, and the TLE attribute value is specified as a FIELD parameter containing a constant value. For example, given the following definitions ACIF will add two TLEs: the first will have an attribute name of "DEPT" and a value of "111", the second will have an attribute name of "CODE" and a value of "R7". The TLEs will be added to each group. Note that the index name and value must be encoded in the correct code page.
CC=YES
CCTYPE=A
CPGID=500
FORMDEF=F1A10110
EXTENSIONS=ADDTLE
RESTYPE=FDEF,PSEG,OVLY
FIELD1=X'F1F1F1'
INDEX1=X'C4C5D7E3',FIELD1
FIELD2=X'D9F7'
INDEX2=X'C3D6C4C5',FIELD2
Usage notes:
  1. Input must be AFP that contains BNG/ENG pairs.
  2. No TRIGGER parameters can be specified with ADDTLE; the FIELD parameters must contain constant values.
  3. By default ACIF will use the value of INDEX1 for the GROUPNAME. INDEX1 must be defined or the GROUPNAME parameter must be specified to indicate which of the constant fields ACIF should use for the GROUPNAME, for example: 
    CC=YES
CCTYPE=A
CPGID=500
FORMDEF=F1A10110
EXTENSIONS=ADDTLE
RESTYPE=FDEF,PSEG,OVLY
FIELD3=X'F1F1F1'
INDEX3=X'C4C5D7E3',FIELD3
GROUPNAME=INDEX3
BOX
ACIF uses the GOCA box drawing order when using a Record Formatting Page Definition.
CELLED
ACIF uses the IOCA Replicate and Trim function when converting IM1 celled images. This image might reduce the number of bytes needed for a raster image. It requires that IMAGEOUT=IOCA be specified (the default).
EMPTYOK
If indexing is requested by specifying the TRIGGER, FIELD, and INDEX parameters, ACIF must find a group indexing field before the page specified by the INDEXSTARTBY parameter. Under normal processing, if ACIF fails to find a group indexing field, ACIF issues error message APK448S and ends with RC 16. When EMPTYOK is specified and a group indexing field is not found, ACIF will issue message 422 with RC 64 and then issue message 440 and RC 0.

If no indexing information is found, the file will not load into Content Manager OnDemand.

FRACLINE
ACIF uses the GOCA fractional line width drawing order when using a Record Formatting Page Definition.
IDXCPGID
Specify this option for Unicode documents. ACIF adds extensive code page information to the AFP document if ACIF is converting the document to AFP and to the index file so that the document can load correctly into Content Manager OnDemand and display properly. This parameter does not affect printing. Only the following four Unicode code pages are supported:
1200
UTF-16 BE ( previously UCS-2)
1208
UTF-8
13488
UTF-16 BE
17584
UTF-16 BE
When you specify this parameter, note the following restrictions:
  • Ensure that you indicate the code page of the document and the extracted index values by using the CPGID parameter. Ensure that all the extracted index values are in the same code page.
  • Ensure that you express the trigger and index names in the TRIGGER and INDEX parameters in the code page that is specified by the CPGID parameter.
  • Ensure that you express the trigger and index names in Big Endian.
  • Ensure that you extract the field values from the document in Big Endian format.
  • The IDXCPGID parameter can be used with both CONVERT=YES and CONVERT=NO.
  • Do not use a mask on the FIELD parameter when you use the IDXCPGID parameter.
  • Do not use the IDXCPGID parameter if the input is AFP or mixed-mode.
  • ACIF issues an error message if the IDXCPGID parameter is specified with the PASSPF parameter. If EXTENSIONS=ALL is specified, PASSPF is ignored and the IDXCPGID parameter is used.
This example contains sample ACIF parameters for a code page 1200 (UCS-2) document: 
CC=YES
CCTYPE=A
CPGID=1200
FILEFORMAT=RECORD,401
TRIGGER1=*,228,X'0050004100470045',(TYPE=GROUP)            /*  P A G E */
FIELD1=0,246,10,(TRIGGER=1,BASE=0)
FIELD2=0,-76,16,(TRIGGER=1,BASE=TRIGGER)
INDEX1=X'0070006100670065',FIELD1,(TYPE=GROUP,BREAK=YES)   /*  page  */
INDEX2=X'006E0061006D0065',FIELD2,(TYPE=GROUP,BREAK=YES)  /* name */
EXTENSIONS=IDXCPGID
FORMDEF=F1IBMTU3
PAGEDEF=P1IBMTU3
RESLIB=\acif\reslib2
The example illustrates these points:
  • The trigger and index names are expressed in Big Endian UCS-2. The trigger and index names must be in the code page given by the CPGID parameter.
  • The field values must be extracted from the document in Big Endian format. In the example, on the first page, the following 10 bytes are extracted for FIELD1: 
    X’00200020002000200031’    /*     1 */
    and the following 16 bytes are extracted for FIELD2: 
    X’002000500045004C0053004800320032’         /*  PELSH22 */
PASSPF
Specifies that ACIF should pass 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 verifies whether a BPF/EPF structured field pair that the input record exit tried to insert is actually 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:
  1. Be careful 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.
  2. This value is not used when the input file is line data because line data does not contain BPF and EPF structured fields.
  3. When PASSPF is specified, 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 timestamp triplets.
  4. 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.
  5. ACIF does not verify whether the input file is MO:DCA IS/3 compliant.
PRCOLOR
ACIF uses GOCA process color drawing orders when using a Record Formatting Page Definition.
RESORDER
When the RESORDER value is specified, inline resources do not have to appear in any particular order in the input file, although they must all appear before the beginning of the document. ACIF will read the inline resources into memory and use them when they are requested.

If there are many inline resources and little internal memory available, the system might run out of memory when using this option.

When the RESORDER value is not specified, inline resources must appear in the input file in the order in which they are used.

SPCMPRS
ACIF uses the repeat string PTOCA order to remove trailing blanks from line data and compress embedded blanks.
extension,...extension
A comma-separated list of two or more specific types of extended options. For example, to specify that ACIF should use the PRCOLOR and BOX extended options, use the following format of the parameter: 
EXTENSIONS=prcolor,box

Related parameters