Enable IBM Z NetView to authorize Take Action commands

About this task

In addition to configuring Tivoli Enterprise Monitoring Server address spaces to forward z/OS® Take Action commands to IBM Z® NetView, you must also enable NetView to receive and execute the commands. NetView does command authorization as part of the execution.

To enable execution of forwarded commands, complete the following steps:

Note:
  1. If a NetView operator ID exists that matches a Tivoli Enterprise Portal user ID, the command will be executed on the existing NetView operator ID, if appropriate command authorization exists.
  2. Be careful about mapping a Tivoli Enterprise Portal user ID to a NetView operator ID that is used to log on to a 3270 terminal. The Take Action command might be run on an active NetView operator with unwanted results. Mapping Tivoli Enterprise Portal user IDs to NetView autotasks is preferable.

Procedure

  1. Define Tivoli Enterprise Portal user IDs to NetView. To define a user ID to NetView, perform one or more of the following actions:
    • Create a new Tivoli Enterprise Portal user ID that matches a new or existing NetView operator ID.
    • Define an existing Tivoli Enterprise Portal user ID as a NetView operator ID.
    • Map the TEP user ID to a valid NetView operator ID by using the NACMD.OPID.TEPLogonid CNMSTYLE statement.

    See CNMSTYLE Initialization Statements in IBM Z NetView Administration Reference for more information on the NACMD.OPID statement. For information on defining user IDs, see Defining Tivoli® Enterprise Portal User IDs in the IBM Z NetView Security Reference.

  2. Perform one of the following actions:
    • Define the NetView PPI receiver in the NetView DSIPARM member CNMSTYLE (see the following figure).
      Figure 1. CNMSTYLE member after editing
      ************************************************************************
*       Tivoli Management Services infrastructure server               *
*                                                                      *
* Uncomment the following (and, optionally, supply preferred OPID) to  *
* initialize support for commands and messages from Tivoli Management  *
* Services infrastructure and/or other APF authorized clients. See    *
* command help for APSERV for information about the function and       *
* clients depending on it.                                             *
*                                                                      *
************************************************************************
function.autotask.APSERV = AUTOTMSI                                   
*                                                                       
AUTOTASK.?APSERV.Console = *NONE*      //                               
AUTOTASK.?APSERV.InitCmd = APSERV CNMPCMDR

      Follow the instructions in the member. The PPI receiver for APSERV will be started during NetView initialization.

      After editing, the member should look like the following figure:
      Figure 2. CNMSTYLE member after editing
      ************************************************************************
*       Tivoli Management Services infrastructure server               *
*                                                                      *
* Uncomment the following (and, optionally, supply preferred OPID) to  *
* initialize support for commands and messages from Tivoli Management  *
* Services infrastructure and/or other APF authorized clients. See     *
* command help for APSERV for information about the function and       *
* clients depending on it.                                             *
*                                                                      *
************************************************************************
function.autotask.APSERV = AUTOTMSI                                   
*                                                                       
AUTOTASK.?APSERV.Console = *NONE*      //                               
AUTOTASK.?APSERV.InitCmd = APSERV CNMPCMDR
    • If you do not customize CNMSTYLE to define the receiver, start the NetView PPI receiver manually by issuing the APSERV command.

      The APSERV command is a command server that runs on a NetView autotask or on a virtual OST (VOST). APSERV accepts commands or messages from APF authorized programs only. The APSERV command must be running, whether started during NetView initialization or manually, to receive the system commands from the TEMS and agent. Refer to the NetView online help or to the IBM Z NetView Application Programmer's Guide for more information on the APSERV command.

  3. Verify that the IBM Z NetView Subsystem Address Space is active with the PPI enabled.

    The PPI is enabled by specifying the PPIOPT keyword in sample procedure CNMSJ010 (CNMPSSI), located in the NetView CNMSAMP data set.