The agspdld, apped, ps2afp, and ps2afpd configuration files

Instead of typing flags on the command line with the ps2afp or pdf2afp command, you can use the -C flag to specify a configuration file that contains the flags. In this way, you can simply specify a configuration file name, rather than typing many flags. You might find it convenient to use a configuration file if you repeatedly use the same flags with the ps2afp or pdf2afp command, or if you are using different PostScript or PDF processing values than the defaults defined by your system support group.

When your system support group installed the ps2afp transform and its alias, pdf2afp, a default ps2afp command configuration file, ps2afp.cfg, was installed in this directory:

With AIX or Linux
/usr/lpp/psf/ps2afp
With Windows
install_path\ps2afp
To create your own files, copy the ps2afp.cfg file and then use a system editor to modify the options in this ASCII file to suit your needs.

These figures show an example of a configuration file.

Sample agspdld Configuration File

The default agspdld daemon configuration file agspdld.cfg was installed in this directory: /usr/lpp/psf/ps2afp

The agspdld daemon configuration file contains most of the keywords as the ps2afp daemon. The agspdld daemon configuration file also contains some keywords that control the operation of the agspdld daemon. Values in the command configuration file override values in the daemon configuration file.

# agspdld configuration file

######################################################################
# KEYWORD                                                      PURPOSE
######################################################################

port = 8254              #                    which TCP/IP port to use

work_directory = /var/psf/agspdl
                         #            directory to put work files into
log_file = /var/psf/agspdl/agspdl.log
                         #                 where to write log messages
log_size = 1024          #                      maximum log size in KB

ps_font_directory = /var/psf/agspdl/Resource
                         #                      list of resource files

ps_output_type = IO1_G4  #               type of AFP image to generate
ps_width = 8.5i          #                    width of generated image
ps_length = 11i          #                   length of generated image
ps_resolution = 300      #                resolution of target printer
agspdl_is = 1            #                  the is afp compliance flag

#agspdl_compress_type = lzw   
                         #                             lzw compression
                         #               other options: jpeg, jpeg-sub

#agspdl_page_size_control
                         #                   page size control options
                         #          ArtBox, BleedBox, CropBox, TrimBox

Sample apped Configuration File

The default apped daemon configuration file apped.cfg was installed in this directory:

With AIX or Linux
/usr/lpp/psf/ps2afp
With Windows
install_path\ps2afp

The apped daemon configuration file contains most of the keywords as the ps2afp daemon. The apped daemon configuration file also contains some keywords that control the operation of the apped daemon. Values in the command configuration file override values in the daemon configuration file.

Sample apped daemon configuration file for AIX and Linux:

 apped configuration file

######################################################################
# KEYWORD                                                      PURPOSE
######################################################################

port = 8250                    #              which TCP/IP port to use

appe_work_directory = /var/psf/appe
                               # directory to put APPE work files into

log_file = /var/psf/appe/apped.log
                               #    where to write daemon log messages
log_size = 100                 #                maximum log size in KB

#transform_trace_file = /var/psf/appe/appeTraceFile.log
                               #  where to write APPE transform traces
                               #        comment out to disable tracing

#transform_trace_size = 200    #              maximum trace size in KB
                               #  use 0 to disable trace size checking

#transform_trace_level = MDFL@-1
               #                                     APPE traces level
               # MMST@-1                  output most trace statements
               # MINT@-1          output intermediate level of tracing
               # MDFL@-1               output default trace statements

#appe_fonts_path = 
               #list of directories where extra APPE fonts are located

appe_font_map_files = /usr/lpp/psf/appe/fontmaps/FontMapSample.cfg

appe_width = 8.5i              #              width of generated image
appe_length = 11i              #             length of generated image
appe_x_offset = 0i             #                left and right margins
appe_y_offset = 0i             #                top and bottom margins
appe_resolution = 300          #          resolution of target printer
appe_output_type = IO1_G4      #         type of AFP image to generate
#appe_is = 1                   #            the is afp compliance flag
#appe_compress_type = jpeg-sub 
               # JPEG subsampled compression. Other options: jpeg, lzw
#appe_pagetype = DOCUMENT       
               # type of afp structured field for each individual page

Sample apped daemon configuration file for Windows:

# apped configuration file

######################################################################
# KEYWORD                                                      PURPOSE
######################################################################

port = 8250                    #              which TCP/IP port to use

appe_work_directory = <AFP Support Path>\appe
                               # directory to put APPE work files into

log_file = <AFP Support Path>\appe\apped.log
                               #    where to write daemon log messages
log_size = 100                 #                maximum log size in KB

#transform_trace_file = <AFP Support Path>\appe\appeTraceFile.log
                               #  where to write APPE transform traces
                               #        comment out to disable tracing

#transform_trace_size = 200    #              maximum trace size in KB
                               #  use 0 to disable trace size checking

#transform_trace_level = MDFL@-1
               #                                     APPE traces level
               # MMST@-1                  output most trace statements
               # MINT@-1          output intermediate level of tracing
               # MDFL@-1               output default trace statements

#appe_fonts_path = 
               #list of directories where extra APPE fonts are located

appe_font_map_files = <Install Path>\appe\fontmaps\FontMapSample.cfg

appe_width = 8.5i              #              width of generated image
appe_length = 11i              #             length of generated image
appe_x_offset = 0i             #                left and right margins
appe_y_offset = 0i             #                top and bottom margins
appe_resolution = 300          #          resolution of target printer
appe_output_type = IO1_G4      #         type of AFP image to generate
#appe_is = 1                   #            the is afp compliance flag
#appe_compress_type = jpeg-sub 
               # JPEG subsampled compression. Other options: jpeg, lzw
#appe_pagetype = DOCUMENT       
               # type of afp structured field for each individual page

Sample ps2afp Configuration File

# ps2afp configuration file

######################################################################
#                CPSI, APPE and AGSPDL GENERAL SETTINGS
# KEYWORD            EQUIVALENT ps2afp FLAG                    PURPOSE
######################################################################

port = 8251              # -P                 which TCP/IP port to use
appe_port = 8250         # -P        which TCP/IP port to use for appe
agspdl_port = 8254       # -P      which TCP/IP port to use for agspdl
server = localhost       # -S             which server to connect with

ps_max_memory = 48000K   # -M            maximum amount of memory that
                         #         PostScript uses; the 'K' is ignored

ps_job_timeout = 9999    # -j                maximum number of minutes
                         #                   to process PostScript job
ps_server_timeout = 360  # -s                maximum number of minutes
                         #                   server waits between jobs
ps_document_processor = agspdl  # -psproc            which ps document 
                              #                       processor to use
pdf_document_processor = agspdl # -pdfproc          which pdf document 
                              #                       processor to use

######################################################################
#                    CPSI SPECIFIC SETTINGS
# KEYWORD            EQUIVALENT ps2afp FLAG                    PURPOSE
######################################################################

ps_width = 8.5i          # -w                 width of generated image
ps_length = 11i          # -l                length of generated image
ps_x_offset = 0i         # -x                   left and right margins
ps_y_offset = 0i         # -y                   top and bottom margins
ps_resolution = 300      # -r             resolution of target printer
ps_output_type = IO1_G4  # -a            type of AFP image to generate
ps_imgsmall = 0.5i       #                  default value for imgsmall
ps_linesmall = 0.5i      #                 default value for linesmall
ps_txtsmall = 0.5i       #                  default value for txtsmall
#ps_is = 1                #                 the is afp compliance flag
#ps_compress_type = jpeg-sub
                         # -cmp            JPEG subsampled compression
                         #                    other options: jpeg, lzw

######################################################################
#                    APPE SPECIFIC SETTINGS
# KEYWORD            EQUIVALENT ps2afp FLAG                    PURPOSE
######################################################################

appe_width = 8.5i          # -w                width of generated image
appe_length = 11i          # -l               length of generated image
appe_x_offset = 0i         # -x                  left and right margins
appe_y_offset = 0i         # -y                  top and bottom margins
appe_resolution = 300      # -r            resolution of target printer
appe_output_type = IO1_G4  # -a           type of AFP image to generate
#appe_is = 1                #                the is afp compliance flag
#appe_compress_type = jpeg-sub
                           # -cmp          JPEG subsampled compression
                           #                  other options: jpeg, lzw
#appe_pagetype = DOCUMENT       
                           #              type of afp structured field
                           #                  for each individual page



######################################################################
#                    AGSPDL SPECIFIC SETTINGS
# KEYWORD            EQUIVALENT ps2afp FLAG                    PURPOSE
######################################################################
agspdl_output_type = IO1_G4  # -a        type of AFP image to generate
agspdl_resolution = 300      # -r         resolution of target printer
agspdl_width = 8.5i          # -w             width of generated image
agspdl_length = 11i          # -l            length of generated image
agspdl_is     = 1            #              the is afp compliance flag

#agspdl_compress_type = lzw
                             # -cmp        JPEG subsampled compression
                             #           other options: jpeg, jpeg-sub
#agspdl_page_size_control
                             # -psc          page size control options
                             #      ArtBox, BleedBox, CropBox, TrimBox

######################################################################

# ENABLING THE PLEX COMMAND AND MAPPING BINS TO TRAYS
# NOTE: Uncomment only one of the options below.

######################################################################

# ENABLING THE FINISHING FLAG ONLY
# If you want your users to be able to allow finishing operations,
# such as staple operations or punch operations, uncomment the  
# following line.

# device_controls = finishing

######################################################################

# ENABLING THE PLEX COMMAND ONLY
# If you want your users to be able to choose between single-sided and 
# double-sided (duplexed) output, uncomment the following line.

# device_controls = plex

######################################################################

# ENABLING BOTH PLEX AND FINISHING
# If you want your users to be able to both choose between single-
# sided and double-sided (duplexed) output AND allow finishing 
# operations, such as staple operations or punch operations, 
# uncomment the following line.

# device_controls = plex,finishing

######################################################################

# ENABLING THE PLEX COMMAND AND MAPPING BINS TO TRAYS
# If you want your users to be able to both choose between single-
# sided and double-sided (duplexed) output AND specify which paper 
# tray to use, uncomment the line below and fill in the correct values:

# Replace the Xs with the number of the AFP tray (between 1 and 255).
# Replace the Zs with the appropriate values.
# Replace size with one of the supported paper sizes \
(LETTER, LEGAL, A3, A4, B4, B5, LEDGER)

# device_controls = plex,inputX=(size,type=ZZZ,weight=ZZZ,color=ZZZ), \
inputX=(size,type=ZZZ,weight=ZZZ,color=ZZZ)

######################################################################

# ENABLING THE PLEX COMMAND AND MAPPING BINS TO TRAYS
# If you want your users to be able to both choose between single-
# sided and double-sided (duplexed) output, AND allow finishing
# operations, AND specify which paper tray to use, uncomment the line 
# below and fill in the correct values:

# Replace the Xs with the number of the AFP tray (between 1 and 255).
# Replace the Zs with the appropriate values.
# Replace size with one of the supported paper sizes \
(LETTER, LEGAL, A3, A4, B4, B5, LEDGER)

# device_controls = plex,finishing,inputX=(size,type=ZZZ,weight=ZZZ,\
color=ZZZ), inputX=(size,type=ZZZ,weight=ZZZ,color=ZZZ)

Sample ps2afpd Configuration File

The default ps2afpd daemon configuration file ps2afpd.cfg was installed in this directory:

With AIX or Linux
/usr/lpp/psf/ps2afp
With Windows
install_path/ps2afp

The ps2afpd daemon configuration file contains most of the keywords as the ps2afp daemon. Values in the command configuration file override values in the daemon configuration file.

This is an example of the configuration file.

# ps2afpd configuration file

######################################################################
# KEYWORD                                                      PURPOSE
######################################################################

port = 8251              #                    which TCP/IP port to use

work_directory = <AFP Support Path>\ps2afp
                         #            directory to put work files into
log_file = <AFP Support Path>\ps2afp\ps2afpd.log
                         #                 where to write log messages
log_size = 100           #                      maximum log size in KB

ps_program = <Install Path>\cpsibin\ps2afpi.exe
                         #      name of PostScript interpreter program
ps_init_file = <Install Path>\ps\ps2afp.ps
                         #              name of PostScript interpreter
                         #                         initialization file
ps_files_path = <Install Path>\ps;\
        <Install Path>\config;\
        <Install Path>\reslib
                         #            path to search for jobInit files

ps_max_memory = 48000K   #               maximum amount of memory that
                         #         PostScript uses; the 'K' is ignored

ps_job_timeout = 9999    #                   maximum number of minutes
                         #                   to process PostScript job
ps_server_timeout = 360  #                   maximum number of minutes
                         #                   server waits between jobs

ps_font_map_files = <Install Path>\ps\fonts.map
                         #                  list of font mapping files

ps_width = 8.5i          #                    width of generated image
ps_length = 11i          #                   length of generated image
ps_x_offset = 0i         #                      left and right margins
ps_y_offset = 0i         #                      top and bottom margins
ps_resolution = 300      #                resolution of target printer
ps_output_type = IO1_G4  #               type of AFP image to generate
#following three parameters will apply only if threshsmall specified
ps_imgsmall = 0.5i       #                  default value for imgsmall
ps_linesmall = 0.5i      #                 default value for linesmall
ps_txtsmall = 0.5i       #                  default value for txtsmall
#ps_is = 1                #                  the is afp compliance flag
ps_compress_type = jpeg-sub  # JPEG subsampled compression. \
Other options: jpeg, lzw

######################################################################

# ENABLING THE PLEX COMMAND AND MAPPING BINS TO TRAYS
# NOTE: Uncomment only one of the options below.

######################################################################

# ENABLING THE FINISHING FLAG ONLY
# If you want your users to be able to allow finishing operations,
# such as staple operations or punch operations, uncomment the  
# following line.

# device_controls = finishing

######################################################################

# ENABLING THE PLEX COMMAND ONLY
# If you want your users to be able to choose between single-sided and 
# double-sided (duplexed) output, uncomment the following line.

# device_controls = plex

######################################################################

# ENABLING BOTH PLEX AND FINISHING
# If you want your users to be able to both choose between single-
# sided and double-sided (duplexed) output AND allow finishing 
# operations, such as staple operations or punch operations, 
# uncomment the following line.

# device_controls = plex,finishing

######################################################################

# ENABLING THE PLEX COMMAND AND MAPPING BINS TO TRAYS
# If you want your users to be able to both choose between single-
# sided and double-sided (duplexed) output AND specify which paper 
# tray to use, uncomment the line below and fill in the correct values:

# Replace the Xs with the number of the AFP tray (between 1 and 255).
# Replace the Zs with the appropriate values.
# Replace size with one of the supported paper sizes \
(LETTER, LEGAL, A3, A4, B4, B5, LEDGER)

# device_controls = plex,inputX=(size,type=ZZZ,weight=ZZZ,color=ZZZ), \
inputX=(size,type=ZZZ,weight=ZZZ,color=ZZZ)

######################################################################

# ENABLING THE PLEX COMMAND AND MAPPING BINS TO TRAYS
# If you want your users to be able to both choose between single-
# sided and double-sided (duplexed) output, AND allow finishing
# operations, AND specify which paper tray to use, uncomment the line 
# below and fill in the correct values:

# Replace the Xs with the number of the AFP tray (between 1 and 255).
# Replace the Zs with the appropriate values.
# Replace size with one of the supported paper sizes \
(LETTER, LEGAL, A3, A4, B4, B5, LEDGER)

# device_controls = plex,finishing,inputX=(size,type=ZZZ,weight=ZZZ,\
color=ZZZ), inputX=(size,type=ZZZ,weight=ZZZ,color=ZZZ)

The next table shows the ps2afp flags and their equivalent configuration file keywords. To override the values in the default configuration file, ps2afp.cfg, you can take one of these actions:

  • Specify flags with the ps2afp or pdf2afp command at transform time.
  • Specify a configuration file with ps2afp -C at transform time.
  • Specify ps2afp flags with -o flags on an AIX print command, or with equivalent attributes with the -x flag or in an attributes file on the pdpr command, to transform a file and print it at the same time.

PostScript and PDF printing and processing options

ps2afp or pdf2afp Flag Keyword in ps2afp and ps2afpd Configuration Files
Note: The valid values for configuration file keywords are the same as for the corresponding ps2afp or pdf2afp command flag. For keywords used only in the ps2afpd daemon configuration file, which have no corresponding command flag, see ps2afpd utility: starts the ps2afpd daemon.
 -aOutputType
agspdl_output_type=value
(agspdl)
appe_output_type=value
(appe)
ps_output_type=value
(cpsi)
 -CConfigurationFile
 None
 -c
 None (cpsi only)
 -cmp
ps_compress_type=value
agspdl_compress_type=value
appe_compress_type=value
 -device
device_control=
plex
,
inputn=(size,
type=x,color=y,weight=z,insert
)
inputn=(size,
type=x,color=y,weight=z,insert
)
inputn=()
(appe and cpsi)
 -FFontMapFile
,
ps_font_map_file=PathName
(cpsi only)
appe_font_map_file=PathName
(appe only)
 -gPageRange
 None (appe and cpsi)
InputFile
 None
 -is
ps_is=value
agspdl_is=value
appe_is=value
(agspdl, appe, and cpsi)
-imgsmall sizeunnnn.nnnu
ps_imgsmall=nnnn.nnn
(cpsi only)
 -jnnnn
ps_job_timeout=nnnn
(cpsi only)
 -lnnnn.nnnu
ps_length= nnnn.nnnu
agspdl_length= nnnn.nnnu
appe_length= nnnn.nnnu
(agspdl, appe, and cpsi)
-linesmall sizeunnnn.nnnu
ps_linesmall=nnnn.nnnu
(cpsi only)
 -Mnnnnn
ps_max_memory=nnnnn
(cpsi only)
 -oOutputFile
 None
 -Pnnnnn
 port=PortNumber
(agspdl, appe, and cpsi)
 -pPageRange
 None (agspdl, appe, and cpsi)
 -pagetype
 appe_pagetype=value
(appe only)
 -pdfproc
 pdf_document_processor=value
 -psproc
 ps_document_processor=value
 -pragma ps_x_origin=nnnn.nnnu
pragma=ps_x_origin=nnnn.nnnu
(appe and cpsi)
 -pragma ps_y_origin=nnnn.nnnu
pragma=ps_y_origin=nnnn.nnnu
(appe and cpsi)
 -pragma OutputFaceUp=
PSenabledisable
 None (appe and cpsi)
-psc
agspdl_page_size_control=value
(agspdl only)
 -q
 None
 -rnnn
ps_resolution=nnn
agspdl_resolution=nnn
appe_resolution=nnn
(agspdl, appe, and cpsi)
  Keyword in ps2afp Configuration File Keyword in ps2afpd Configuration Files
 -SServerName
server=ServerName
 None
 -snnnn
ps_server_timeout=nnnn
(cpsi only)
–threshsmall
sc_ellsc_euc
 None (cpsi only)
-txtsmall sizeunnnn.nnnu
ps_txtsmall=nnnn.nnnu
(cpsi only)
 -wnnnn.nnnu
ps_width=nnnn.nnnu
agspdl_width=nnnn.nnnu
appe_width=nnnn.nnnu
(agspdl, appe, and cpsi)
 -xnnnn.nnnu
ps_x_offset=nnnn.nnnu
appe_x_offset=nnnn.nnnu
(appe and cpsi)
 -ynnnn.nnnu
-y nnnn.nnnu
ps_y_offset=nnnn.nnnu
appe_y_offset=nnnn.nnnu
(appe and cpsi)
  Keyword in ps2afp Configuration File Keyword in ps2afpd, agspdld, and apped Configuration Files
None None
log_file=PathName
None None
log_size=Size
None None
transform_trace_file=Pathname
transform_trace_size=Size
transform_trace_level=TraceLevel
(appe only)
None None
mail_command=PathName
(cpsi only)
None None
notify=UserID
(cpsi only)
None None
ps_font_directory=PathName

(agspdl only)
None None
ps_init_file=PathName
(cpsi only)
None None
ps_program=PathName
(cpsi only)
None None
ps_support_program=PathName
(cpsi only)
None None
work_directory=PathName
(agspdl and cpsi)
None None
appe_fonts_path =PathName
(appe only)
None None
appe_work_directory=PathName
(appe only)
Parent topic: pdf2afp and ps2afp commands: transform PDF or PostScript data to AFP