Steps for creating the Infoprint Server configuration file (aopd.conf)

These steps show how to create the aopd.conf configuration file in the /etc/Printsrv directory, which is the default directory for Infoprint Server configuration files. You must create the aopd.conf file before you start Infoprint Server for the first time.

To edit an existing aopd.conf file, follow the steps in Steps for editing the Infoprint Server configuration file (aopd.conf).

Before you begin: You must have permission to create files in the /etc/Printsrv directory. If you did not change the owner and permissions for /etc/Printsrv after installation, you must have an effective UID of 0 to create files in this directory.
  1. Switch to an effective UID of 0:
    su
    Tip: To use the su command, you must have authority to the BPX.SUPERUSER profile in the FACILITY class in RACF®.
  2. Copy the sample configuration file, /usr/lpp/Printsrv/samples/aopd.conf, to /etc/Printsrv/aopd.conf:
    cp /usr/lpp/Printsrv/samples/aopd.conf  /etc/Printsrv/aopd.conf
    If you copy the sample configuration file to a different location, specify the full path name of the configuration file in the AOPCONF environment variable in the aopstart EXECStart of change, in the aopdemon environment variables file,End of change and in the /etc/profile file.
    Tip: You can use the sample job that is provided in SYS1.SAMPLIB(AOPCPETC) to copy all Infoprint Server sample configuration files, including the Infoprint Server configuration file, from /usr/lpp/Printsrv/samples to the /etc/Printsrv directory. Review the comments in the sample job to determine which configuration files you require, and then run the job to create the configuration files. IBM® suggests that a user with an effective UID of 0 run this job.
  3. Change the owner of the file to UID 0:
    chown 0 /etc/Printsrv/aopd.conf
  4. Change the group owner to AOPADMIN. AOPADMIN is the suggested RACF group name for Infoprint Server administrators. However, you can use a different name for this group (see AOPADMIN and AOPOPER groups).
    chgrp AOPADMIN /etc/Printsrv/aopd.conf
  5. Change the permissions of the file so that it is readable by everyone and writable only by UID 0 and members of the AOPADMIN group.
    chmod 664 /etc/Printsrv/aopd.conf
  6. Edit the configuration file to specify configuration attributes and save your changes. For example, enter:
    oedit /etc/Printsrv/aopd.conf
    Edit this file by using the IBM-1047 code page. For the syntax rules for editing the file, see "Syntax rules".
    Tip: You can select the ISPF z/OS Unix Shell option (ISPF 13.11) to edit z/OS® UNIX files.
  7. If you switched to an effective UID of 0 in step 1, switch back to your own UID:
    exit
Syntax rules: When you edit this file, follow these syntax rules:
  1. Use lowercase characters for the attributes and use uppercase or lowercase characters for the values. Use blank characters before or after the equal sign, if wanted.
  2. If a value contains blank characters or special characters (such as {}-> =,# &), enclose the value in single or double quotation marks.
  3. Start comments with the # symbol.
  4. Include blank lines, if wanted.