S550-0433-05

Configuring AFP Download Plus so files remain MO:DCA IS/3 compliant

Configuring AFP Download Plus so files remain MO:DCA IS/3 compliant

AFP Download Plus accepts input files that are identified as MO:DCA IS/3 compliant and transmits them as MO:DCA IS/3. For MO:DCA IS/3 files to remain compliant, AFP Download Plus must transmit them to receivers that support MO:DCA IS/3. All applications that process the print file must also support MO:DCA IS/3.

Even though a receiver supports MO:DCA IS/3, you must still make sure that it preserves IS/3 compliant files on output. For example, the AFP Download Plus receiver on z/OS® uses the afpconcat exit program to concatenate a multiple data set job to a single data set. This concatenation process preserves the files as MO:DCA IS/3 compliant. However, another receiver might use an exit program that concatenates multiple data sets and removes all Begin Print File (BPF) and End Print File (EPF) structured fields, resulting in a single data set print file that is no longer MO:DCA IS/3 compliant.

To ensure that all MO:DCA IS/3 files that AFP Download Plus transmits remain compliant with MO:DCA IS/3, check these items:

  • To make sure the auxiliary files that AFP Download Plus sends to the receiver, such as separator pages and message files, are MO:DCA IS/3 compliant, do these:
    1. Create or update a PRINTDEV statement in the startup procedure that specifies a message OUTPUT statement with these entries:
      • A page definition that uses only TrueType and OpenType fonts, not FOCA fonts. For example, the OUTPUT statement can specify the P1TT6462 sample page definition that is shipped with PSF. P1TT6462 is equivalent to the P1A06462 default message page definition, except that it uses TrueType and OpenType fonts.
      • A form definition that either is compiled with the COMPIS3 PPFA parameter or is one of the sample IS/3 form definitions that is shipped with PSF: F1I30110 for simplex or F1I30111 for duplex. To use the COMPIS3 parameter in PPFA, you must have PTF UK79320 installed.
      See PRT004 in Figure 6 for more information.
    2. When sending separator pages, create or update a PRINTDEV statement in the startup procedure that specifies separator OUTPUT statements with these entries:
      • A page definition that uses only TrueType and OpenType fonts, not FOCA fonts. For example, the OUTPUT statements can specify the P1TT6483 sample page definition that is shipped with PSF. P1TT6483 is equivalent to the P1V06483 default separator page definition, except that it uses TrueType and OpenType fonts.
      • A form definition that either is compiled with the COMPIS3 PPFA parameter or is one of the sample IS/3 form definitions that is shipped with PSF: F1I30110 for simplex or F1I30111 for duplex. To use the COMPIS3 parameter in PPFA, you must have PTF UK79320 installed.
      See PRT004 in Figure 6 for more information.
    3. Set a parameter in the AFPPARMS control statement or the Printer Inventory to the IS/3 level (see auxiliary-files-modca-level or Auxiliary files MO:DCA level). When processing auxiliary files, AFP Download Plus checks that the files contain TrueType and OpenType fonts. If they contain FOCA fonts, AFP Download Plus stops processing.
    4. Test that the auxiliary files are MO:DCA IS/3 compliant by doing these:
      1. Set a parameter in the AFPPARMS control statement or the Printer Inventory to Yes (see save-auxiliary-files or Save auxiliary files) and then run AFP Download Plus. During processing, AFP Download Plus ignores the parameters for compression, direct download, and send messages on failure; saves the auxiliary files in the job submitter's default message directory, /var/psf/userinfo/userid; and does not send any files to the receiver.
      2. Run the MO:DCA validation tool of your choice on the saved auxiliary files to determine whether your files are compliant. The AFP Consortium, http://www.afpcinc.org, provides an IS/3 validation tool that you can use. The validation tool indicates whether MO:DCA errors are present in the file. See Mixed Object Document Content Architecture Reference, AFPC-0004 for more information about resolving IS/3-related errors.
      3. Fix the files if they contain errors, run AFP Download Plus, and then run the MO:DCA validation tool. Do this until the files are compliant. The saved auxiliary files are replaced each time that you run AFP Download Plus.
      4. When testing is complete, set the parameter for saving auxiliary files to No.
  • If you have a multiple data set job with one or more MO:DCA IS/3 compliant data sets and you want the data sets and any auxiliary files to remain compliant, do one of these:
    • Send the job to a receiver that does not concatenate data sets.
    • Send the job to a receiver that preserves MO:DCA IS/3 files during the concatenation process.
    • Set an AFPPARMS parameter or Printer Inventory parameter to No (see Data set grouping or dataset-grouping), and send the job to a receiver that does not preserve MO:DCA IS/3 files during the concatenation process.