z/OS Take Action commands fail

If forwarding of z/OS® Take Action commands to NetView is enabled, the commands may fail to execute because forwarding has been incorrectly configured or Tivoli Enterprise Portal user IDs have not been correctly defined to NetView.

Authorization for z/OS Take Action commands can be restricted to a limited number of trusted users by routing the commands to IBM® Tivoli® NetView on z/OS for execution. Take Action commands issued in NetVew make full SAF calls for authorization.

Forwarding or authorization of commands may fail for several reasons:
  • The PPI receiver specified during configuration does not match the receiver specified on the NetView APSERV command or is incorrectly specified.

    If the specified name is incorrect or the receiver is not active on NetView, default command routing is performed and commands are not authorized.

    Confirm that the name of the NetView PPI receiver specified during configuration of theTivoli Enterprise Monitoring Server (the KGLHC_PPI_RECEIVER parameter in the KDSENV member of the &rhilev.&rtename.RKANPARU library) is correctly specified and matches the receiver name that is specified on the NetView APSERV command.

    The receiver must be a 1-8 character, unique identifier for the receiver program. It can contain alphabetic characters A-Z or a-z, numeric characters 0-9, and the following special characters: dollar sign (’$’), percent sign (’%’), ampersand (’&’), at sign (’@’), and number sign (’#’). This value must match the value specified in the NetView DSIPARM initialization member, CNMSTYLE. For more information, see the IBM Z OMEGAMON AI for z/OS: Planning and Configuration Guide.

  • The Tivoli Enterprise Monitoring Server cannot locate the NetView CNMLINK data set.

    To connect to NetView, the monitoring server needs to reference the NetView CNMLINK data set. This data set must be concatenated tto the RKANMODL statement in the monitoring server started task (by default, CANSDSST). For more information, see the IBM Z OMEGAMON AI for z/OS: Planning and Configuration Guide.

  • The Tivoli Enterprise Portal user IDs forwarded with the commands are not defined to NetView.

    If Tivoli Enterprise Monitoring Server address spaces are configured to forward z/OS Take Action commands to NetView, NetView must also be configured to receive and execute the commands. You enable NetView by defining the Tivoli Enterprise Portal user IDs. For instructions, see the section on "Defining operators for the NetView for z/OS Tivoli Enterprise Portal agent" in the Tivoli NetView on z/OS: Security Reference. You can find the NetView documentation in the Tivoli Netview for z/OS documentation knowledge center.

  • NetView is not at the correct level.

    Take Action forwarding requires NetView on z/OS V5.2 with APAR OA18449 applied.