z/OS Infoprint Server Printer Inventory for PSF
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF


Creating an aopstart EXEC

z/OS Infoprint Server Printer Inventory for PSF
SA38-0694-00

Creating an aopstart EXEC

Infoprint Server provides an aopstart EXEC in /usr/lpp/Printsrv/bin that sets the required environment variables to the default values and starts Infoprint Server. If you need to change the value of the environment variables or specify additional ones, or if you installed Infoprint Server files in a non-default directory, you must create an aopstart EXEC for your installation.

In the aopstart EXEC, you can:

  • Change the value of any environment variable that is set in the EXEC.
  • Set a new environment variable in this format:
    n=n+1;env.n='environment_variable=value'
    Specify all environment variables before this statement that is in the EXEC:
    env.0=n

    Example:

    n=n+1;env.n='AOPTRACEDIR=/mydirectory/trace'
    env.0=n
  • Edit this statement to change the name of the directory where Infoprint Server files are installed:
    install_path='/usr/lpp/Printsrv'  

Rule: The owner of the aopstart file must be UID 0. In addition, for a secure environment, only users with a UID of 0 should be permitted to write the file.

To create an aopstart EXEC;

  1. Switch to an effective UID of 0:
    su  
    To use the z/OS® UNIX su command, you must be permitted to the BPX.SUPERUSER profile in the FACILITY class in RACF®.

    _______________________________________________________

  2. Copy the default aopstart EXEC to another directory, such as /usr/local/bin/:
    cp /usr/lpp/Printsrv/bin/aopstart /usr/local/bin/
    You must copy the file because you should not modify the directory that contains Infoprint Server executable files.

    _______________________________________________________

  3. Change to the directory where the aopstart EXEC exists:
    cd /usr/local/bin 

    _______________________________________________________

  4. Change the owner of the aopstart file to UID 0:
    chown 0 aopstart  

    _______________________________________________________

  5. Change the group owner of the aopstart file to AOPOPER. AOPOPER is the suggested RACF group name for Infoprint Server operators. However, you might have used a different name for this group.
    chgrp AOPOPER aopstart

    _______________________________________________________

  6. Edit the new aopstart file using your preferred editor and save your changes. For example:
    oedit aopstart 

    Edit this file using the IBM-1047 code page. For additional instructions, see the comments in the aopstart EXEC.

    _______________________________________________________

  7. Change the permissions for the file. Make the file writeable by only UID 0, readable by everyone, and executable only by UID 0 and members of the AOPOPER group. Also, set the set-uid-flag on. For example:
    chmod 4754 aopstart
    Tip:
    Do this step after you edit the file because the set-uid-flag is turned off when you edit a file.

    _______________________________________________________

  8. Switch back to your own UID:
    exit

    _______________________________________________________

  9. Specify the full path name of the aopstart EXEC on the PARM parameter in the AOPSTART JCL procedure. For example:
    //AOPSTART EXEC PGM=AOPBATCH,PARM='//usr/local/bin/aopstart',
    //    TIME=NOLIMIT

    _______________________________________________________

Related information:

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014