Activating Powertech Powertech Exit Point Manager for IBM i

Powertech Exit Point Manager for IBM i uses several exit programs that interact with the various serversservers on IBM i. For the servers to use the exit programsexit programs, the exit programs must be registered. The Powertech Exit Point Manager for IBM i activation process uses the Add Exit Program (ADDEXITPGM) command to add the exit programs to the system registration. (You can use the Work with Registration Info [WRKREGINF] command to see a list of registered exit programs.)

You can select from either of two methods to register the exit programs:

• The Silent method (performed during an IPL)
• The Interactive method

Activation requires the following special authorities:

• *ALLOBJ
• *IOSYSCFG
• *JOBCTL
• *SECADM

Powertech Exit Point Manager for IBM i provides several activation/deactivation options and information on your activation/deactivation setup.

To activate Powertech Powertech Exit Point Manager for IBM i

1. From the Powertech Exit Point Manager for IBM i Main Menu, select option 5, Configuration Menu.
2. On the Configuration Menu, select option 2, Exit Point Manager Activation, to display the Work with Activation panel.
   NOTE: The Interactive method stops and starts QCMN and QSERVER. Other jobs are also restarted, like QZDASOINIT if *SQLSRV is activated. If you want to use the interactive method on a production system, you should perform it at a time when it will not interfere with your critical business processes. Due to time-sensitive interactions with IBM i system processes, there is a small possibility that the IBM i NetServer will not be running after activation. Also, if IBM Tivoli Directory Server is active before the activation, it will need to be restarted after activation.
   
   Use the following table to check if either server is active before the activation:
   
   

   Server	Function	How to check if active
   IBM i NetServer	File server (for example, for access to the IFS from Windows Explorer)	WRKACTJOB JOB(QZLSSERVER) If a job is displayed, the server is active.
   IBM Tivoli Directory Server	LDAP	WRKACTJOB JOB(QUSRDIR) If a job is displayed, the server is active.

   
   See also Manual Restart After Activation.

3. Enter a 1 next to a server to mark it for activation.
   WARNING: Registering any exit program over the *SQLSRV server can impact system performance since this server is called for each SQL request. High SQL traffic environments, or systems known to be underpowered, can experience significant delays when processing these requests. Consider object level security before Activating *SQLSRV in Powertech Exit Point Manager for IBM i.

4. When you press Enter, *ACTIVATE displays in the Pending Change column on the Work with Activation panel.

   Pending Activate request

5. After you set the Pending Change field to *ACTIVATE, you must run the activation request to apply the Powertech Exit Point Manager for IBM i exit program to each selected exit point. You can select to run an Interactive activation request (F20, Run activation) or a Silent activation request (F18, Add silent activation).
   NOTE: To activate all exit points, press F13 (Set all to Activate). The *DDM and *DRDA servers, as well as the four ShowCase servers, are physically the same server and are activated (or deactivated) together. If you choose to activate one, both/all are activated. They appear as separate servers in the list so that you can define different rules for each, and are interpreted as different servers at run time.

An activated Work with Activation panel

Using Silent Activation (F18)

For Powertech Exit Point Manager for IBM i to activate itself at the next IPL, it changes the QSTRUPPGM system value to LNUR004, which is a Powertech Exit Point Manager for IBM i-supplied program. During the Silent Activation process, the program does the following after the IPL has completed and QCTL is started (or when the controlling subsystem next starts):

1. Sets the IPL attribute STRTCP to *YES if it was *YES before.
2. Registers all Powertech Exit Point Manager for IBM i exit programs to the associated exit point.
3. Restores the QSTRUPPGM system value to the name of your original startup program.
4. Calls your startup program.

If you decide you don't want to use Silent Activation, display the Work with Activation panel and press F19, Remove silent activation.

Do not delete the Powertech Exit Point Manager for IBM i product library after selecting Silent Activation without canceling the activation.

• Powertech Exit Point Manager for IBM i activation recognizes the presence of an existing exit program and gives you the option to register it as a supplemental exit program. You do not need to do this, but you should be aware of the consequences if the current exit programs are being used for other processes on your system.
• A Powertech Powertech Exit Point Manager for IBM i exit program cannot be made supplemental to itself.

Manual Restart After Activation

After an interactive activation, restart the following (if they were running prior to activation):

Server	Commands to Restart
IBM i NetServer	If server was active prior to activation: Check if active now using: WRKACTJOB SBS(QSERVER) JOB(QZLSSERVER) If not active, restart: STRTCPSVR *NETSVR
IBM Tivoli Directory Server for IBM i*	If server was active prior to activation and if *RMTSVR, *RQSVR, or both servers were included in the activation. ENDTCPSVR *DIRSRV STRTCPSVR *DIRSRV

See also Work with Activation.