other-transform-options

Specifies the command line that executes when this transform is run.

GUI label

Transform options

Type

Resettable, single-valued

Allowed Values

You can enter a text string of up to 255 characters that contains the command line for this transform.

Default Value

No default value

Usage Guidelines

  • You should not use the pdset command with the other-transform-options transform attribute.
  • For transform-library=command-line-transform, this attribute contains the command line that specifies the transform. The supported substitution control sequences that can be used in other-transform-options follow:
    %i
    The name of the input-file to transform.
    %o
    The name of the file in which to store the output transform.
    %e
    The name of the file in which to store any transform information or error messages. If anything is written to this file, it is logged in the InfoPrint Manager for AIX server log.
      Note:
    1. If the transform exits with an exit code of 0 or the value set in the conditional-terminating-return-code transform attribute, the error messages from the transform are logged as debug severity.
    2. If the transform exits with a non-zero exit code, but not the value set with the conditional-terminating-return-code transform attribute, the error messages from the transform are logged as error severity.
    3. Transform error messages can be written to the file specified through the %e substitution variable, or they can be written to standard error (stderr). You should not mix output to %e and stderr in a single run of the exit program. You should use one or the other in any given run.
    %j
    The name of the original print file name, minus the path (from document-file-name attribute).
    Note: This file might not be accessible. This should only be used to construct another name, for example, for a temporary file.
    %n
    The name of the original print file name, minus the path and minus the extension (from document-file-name attribute).
    Note: This file might not be accessible. This should only be used to construct another name, for example, for a temporary file.
    %d
    A string representing the document-format of the input file:
    ascii
    ASCII
    afpds
    AFPDS
    pcl
    PCL
    postscript
    PS
    Note: You can also use %%Ddocument-format%% to pass the document format value from the document.
    %p
    The value of the destination-pass-through document attribute from the document. The value can be used as job specific information that can be passed to the transform and the actual destination.
    %q
    The name of the actual destination that is doing this transform.
    %s
    The document-sequence-number for the document.
    %t
    The other-transform-options for the document.

    To write one transform, but use it differently for different jobs, you can pass values into the transform with this parameter.

    %g
    The global job identifier for the job.
    %u
    The name of the file to be used to update the job's pages-completed and the document's page-count attributes. Updating the document's page-count changes the job's job-page-count attribute.
    Note: This file should never be accessed directly; only the transform_update utility should be used to modify this file. For more information about the transform_update utility, see “Using the transform_update utility” in the appropriate InfoPrint Manager procedures manual.
    %#
    The 10-digit job-identifier of the job.
    %%Jattribute-name
    Passes the job attribute value from the job containing the document being transformed.
    %%Dattribute-name
    Passes the document attribute value from the document being transformed.
    %%Aattribute-name
    Passes the actual destination attribute value from the actual destination processing the job.

    Considerations when using the %%Nattributename substitution control sequences:

    • InfoPrint Manager accepts standard abbreviations for the attribute name, as long as they are not ambiguous. For example, you can enter res-prof for results-profile. When ambiguous text is used, it is passed to the transform as entered.
    • The %%Nattributename substitution control sequences must be followed by a blank or %%.
    • You can put quotes around the single percent values (for example, '%u'), but you should never put quotes around the double-percent values, such as %%A.
    • Values with spaces are enquoted so they pass as a single argument. You should not enquote %%substitution%% controls.