Creating an aopstart EXEC

z/OS Infoprint Server Printer Inventory for PSF

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;

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®.
_______________________________________________________
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.
_______________________________________________________
Change to the directory where the aopstart EXEC exists:
```
cd /usr/local/bin 
```
_______________________________________________________
Change the owner of the aopstart file to UID 0:
```
chown 0 aopstart  
```
_______________________________________________________
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
```
_______________________________________________________
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.

_______________________________________________________
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.

_______________________________________________________
Switch back to your own UID:
```
exit
```
_______________________________________________________
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:

Notices | Terms of use | Support | Contact z/OS | zFavorites