afpsplit utility: extracts pages from a MO:DCA-P file

Syntax

afpsplit [-f page] [-p page] [-r ranges] [-fext Formdef [-def]] [-c paths] [-o OutputFile] [InputFile]

Description

Enter the afpsplit command to extract a page or a range of pages from an AFP MO:DCA-P document and create MO:DCA-P output.

You might use the afpsplit command to create a separate file starting at the 25th page and ending at the 50th page of a 200-page document. After you use the afpsplit command to create a file, you can view, store, print, or send that file.

    Note:
  1. afpsplit removes structured index fields from MO:DCA-P files. This does not affect the appearance of printed files, but index entries are no longer available for viewing.
  2. afpsplit writes error messages to STDERR.

Flags

-f page
Specifies the forward space function, where page indicates the number of pages (0-999999999) that you can forward space from the beginning of the input file to start extracting the page or range of pages. To start extracting on page n, forward space n-1 pages.

If you do not specify the -f flag, the extraction starts at the beginning of the file. If you specify more than one -f flag, the last one you specify is used.

-p page
Specifies the page end function, where page indicates the number of pages (0-999999999) to be extracted.

If you do not specify the -p flag, all pages from the forward space point to the end of the input file are included in the output file. If you specify more than one -p flag, the last one you specify is used.

-r ranges
Specifies the page ranges that can be extracted from the input file, where the ranges syntax is -rs1:e1,s2:e2..., si is the start value and ei is the end value of the i interval. Up to 10 intervals can be specified with this parameter.
    Note:
  • If the -fext flag is used, then the start and end interval values might be modified internally by the medium controls. As a result, some pages can appear more than once in the MO:DCA-P output.

The delimitator between start and end value is ‘:’. The delimitator between page ranges is ‘,’. If no start value is specified for an interval, the first page is considered as start value. If no end value is specified for an interval, 999999999 is considered as end value. There must be at least one valid interval for the -r flag to work properly. The intervals are sorted ascending internally. This flag cannot be used in combination with -mm, -f, and -p flags.

-fext Formdef
Specifies an external form definition as a source for the medium controls. In this case, the medium controls are read only from the specified Formdef.
  • Any medium controls invocation in the InputFile need to refer to a medium map defined in the external formdef.
  • Any medium controls defined inline, in the input document inline resource group, are ignored.
    Note:
  • If the external Formdef is not located in the default system resources directory, use the -c flag for defining custom resource paths.
-def
Specifies the external formdef as a default source for the medium controls. In this case, the medium controls are first searched inline, in the input document resource group. If any medium maps are found, they are used in the output document. Any medium map invocation need to refer a medium map defined here. If no medium maps are found in the document resource group, then the search continues in the external formdef.
The -def flag can only be used together with the -fext flag. Otherwise, no medium controls are applied to the output document, even if the input file contains medium maps.
-c paths
Specifies custom paths to search for the external formdef. One or more paths can be specified. Paths format:
Windows:
path;path;path
AIX/Linux:
path:path:path
The -c flag can only be used together with the -fext flag.
    Note:
  • At least one path needs to be defined for afpsplit to search for it. If the -fext flag is not used, then the -c flag has no effect. If no formdef is found in any of the path supplied, an error is triggered.
-o OutputFile
Specifies the name of the file for the page or range of pages produced by afpsplit.

If you do not specify this flag, afpsplit uses standard output (STDOUT).

Argument

The valid argument value for the afpsplit utility is:

InputFile
Specifies the input file.

If you do not specify an input file, afpsplit uses standard input (STDIN).