Parameters used by PARMGEN

The comprehensive list of parameters for this monitoring agent are used by the PARMGEN configuration method are grouped logically in the configuration profile.

The PARMGEN configuration method is the preferred method for configuring the Tivoli® Management Services on z/OS® components and the OMEGAMON® products.

With the PARMGEN configuration method, you edit a comprehensive list of parameters for configuring all installed products and components. You then submit a series of jobs to create a complete runtime environment with the parameter values you specified.

If you are an existing Configuration Tool user and already have an existing runtime environment that you want to convert to PARMGEN, you can do this. Refer to the IBM Tivoli OMEGAMON and Tivoli Management Services on z/OS: PARMGEN Reference for information about migrating to PARMGEN.

These parameters are found in the configuration profile, which can be generated from an existing RTE. If this is a new installation or if you do not want to base the configuration profile on an existing RTE, a default configuration profile is provided and can be edited. Refer to the IBM Tivoli OMEGAMON and Tivoli Management Services on z/OS: PARMGEN Reference to understand the other scenarios for using PARMGEN.

In the configuration profile, the OMEGAMON parameters are organized into the groups found in Table 1:

Table 1. IBM® Z OMEGAMON® AI for Networks parameters divided into the groups found in the configuration profile
PARMGEN classification	Parameters in this group	Explanation
Additional IBM® Z OMEGAMON® AI for Networks Agent settings	KN3_X_AGT_CONFIRM_SHUTDOWN KN3_X_AGT_KDC_DEBUG KN3_X_AGT_DEBUG_TRACE KN3_X_AGT_LGSA_VERIFY KN3_X_AGT_LSRPOOL_BUFFER_NUM KN3_X_AGT_LSRPOOL_BUFSIZE KN3_X_AGT_SDUMP_SVC_SYS1_DUMP KN3_X_AGT_STORAGE_LIMIT_EXTEND KN3_X_AGT_STORAGE_LIMIT_PRIMARY KN3_X_AGT_STORAGE_RESERVE_EXT KN3_X_AGT_STORAGE_RESERVE_PRI KN3_X_AGT_STORAGE_STGDEBUG KN3_X_AGT_TASKS_ATTACHED_NUM KN3_X_SECURITY_USER_EXIT KN3_X_SECURITY_RESOURCE_CLASS	Specifies settings for initializing Tivoli Monitoring: Services (TMS: Engine). These values are usually found in the KN3SYSIN member in the rhilev.midlev.rtename. RKANPARU library and are usually updated only with the assistance of IBM® Software Support.
Advanced Agent configuration values	KN3_AGT_FLUSH_LSR_BUFR_INT_HR KN3_AGT_FLUSH_LSR_BUFR_INT_MIN KN3_AGT_ICU_LANGUAGE_LOCALE KN3_AGT_KGL_WTO KN3_AGT_KLX_TCP_TOLERATERECYCLE KN3_AGT_STORAGE_DETAIL_INT_HR KN3_AGT_STORAGE_DETAIL_INT_MIN KN3_AGT_STORAGE_MINIMUM_EXTEND KN3_AGT_VIRTUAL_IP_ADDRESS KN3_AGT_VTAM_APPL_NCS KN3_AGT_WTO_MSG	Specifies a wide range of essential agent configuration parameters, including parameters that define such values as where console messages are displayed, whether TCP/IP can be recycled, language of the interface, virtual addresses, and storage-related values.
Agent nonstandard parameters	KN3_AGT_NSNEWn_VALUE KN3_AGT_NONSTDn_DSN KN3_AGT_NONSTDn_MBR KN3_AGT_NONSTDn_PARM KN3_AGT_NSOLDn_VALUE	Nonstandard parameters are customer-defined or hidden options that do not correspond to fields in the Configuration Tool interactive panels. This set of parameters defines the values required to establish a nonstandard parameter. Create these parameters under the guidance of IBM Software Support.
Agent parameters: TCP/IP information	KN3_SNA_VTAM_COLLECT_DATA KN3_SNA_VTAM_SNAC_SNACINTV KN3_SNMP_CONFIG_FILE KN3_TCP_ALLHPR KN3_TCP_COLLECT_STACK KN3_TCP_CONN KN3_TCP_CSM KN3_TCP_EEHPR KN3_TCP_FTP KN3_TCP_FTP_DSPINTV KN3_TCP_GLBS KN3_TCP_INTE KN3_TCP_INTS KN3_TCP_IPSEC KN3_TCP_OSA KN3_TCP_ROUTE_TBL KN3_TCP_ROUTE_TBL_FREQ KN3_TCP_SAMPLE_INTERVAL KN3_TCP_TN3270 KN3_TCP_TN3270_DSPINTV KN3_TCP_VIO_UNIT	Sets the global values for all configurable parameters unique to the IBM® Z OMEGAMON® AI for Networks monitoring agent.
Agent's Applids	KN3_AGT_VTAM_APPL_AA KN3_AGT_VTAM_APPL_KN3INVPO KN3_AGT_VTAM_APPL_NCS KN3_AGT_VTAM_APPL_OPERATOR KN3_AGT_VTAM_APPL_CNM_SPO	Specifies the VTAM application IDs (applids) that the agent uses to define communication with the Tivoli Enterprise Monitoring Server. Applids are used for communication with the monitoring server except for KN3_AGT_VTAM_ APPL_CNM_SPO, which is used to collect CNM data. These parameters are not used unless you are using SNA (instead of TCP/IP) to communicate with the monitoring server.
Agent's local TCP/IP information	KN3_AGT_TCP_HOST KN3_AGT_TCP_STC KN3_AGT_TCP_KDEB_INTERFACELIST (If the Agent requires network interface list support) KN3_AGT_PARTITION_NAME (If the Agent requires address translation support–optional)	Provides the TCP/IP information that the Tivoli Enterprise Monitoring Server uses to communicate with the monitoring agent.
Agent's local VTAM and logon information	KN3_AGT_VTAM_APPL_PREFIX KN3_AGT_VTAM_NODE	Specifies the values used by the agent for defining VTAM definitions specific to the monitoring agent.
Agent's primary TEMS TCP/IP information	KN3_TEMS_TCP_HOST Note: KN3_TEMS_TCP_HOST and KN3_AGT_TCP_HOST must be the same value if KN3_TEMS_LOCAL _CONNECT_FLAG=Y (Agent connects to local TEMS).	Specifies the host name of the Tivoli Enterprise Monitoring Server specific to this monitoring agent. This field is required if you plan to have this server communicate with agents using TCP/IP.
Agent's Primary TEMS VTAM information:	KN3_TEMS_VTAM_LU62_DLOGMOD KN3_TEMS_VTAM_LU62_MODETAB KN3_TEMS_VTAM_NETID KN3_TEMS_VTAM_APPL_LLB_BROKER	Specifies the VTAM information used by the Tivoli Enterprise Monitoring Server to communicate with the monitoring agent.
Audit parameters	KN3_AGT_AUDIT_ITM_DOMAIN KN3_AGT_AUDIT_MAX_HIST KN3_AGT_AUDIT_TRACE	Specifies the amount of detail, maximum number of entries, and identifier for z/OS SAF tracing.
Define TCP monitoring systems member Note: Specify KN3_TCPXxx_* row for each TCP/IP monitored stack. Global default is $$$$ (monitor all TCP/IP stacks).	KN3_TCPX KN3_TCPXnn_OVRD_GLBS KN3_TCPXnn_OVRD_INTE KN3_TCPXnn_OVRD_INTS KN3_TCPXnn_OVRD_OSA KN3_TCPXnn_ROW KN3_TCPXnn_SYS_NAME KN3_TCPXnn_TCP_STC KN3_TCPXnn_TCPIP_PROFILES_DSN KN3_TCPXnn_OVRD_GLOBAL_FLAG KN3_TCPXnn_OVRD_COLLECT_STACK KN3_TCPXnn_OVRD_CONN KN3_TCPXnn_OVRD_IPSEC KN3_TCPXnn_OVRD_ROUTE_TBL KN3_TCPXnn_OVRD_ROUTE_TBL_FREQ KN3_TCP_ROUTE_TBL KN3_TCP_ROUTE_TBL_FREQ KN3_TCPXnn_OVRD_FTP KN3_TCPXnn_OVRD_FTP_DSPINTV KN3_TCPXnn_OVRD_TN3270 KN3_TCPXnn_OVRD_TN3270_DSPINTV KN3_TCPXnn_TCPIP_PROFILES_MBR	Sets the stack-specific values that override the global parameters for all configurable parameters unique to the IBM® Z OMEGAMON® AI for Networks monitoring agent.
Define TN3270 Telnet session link user values	KN3_TN3270_DXL_APPLID KN3_TN3270_DXL_USERDATA	Specifies the IBM Tivoli NetView for z/OS user ID and password that IBM® Z OMEGAMON® AI for Networks logs onto dynamically. The applid is the applid for the Tivoli NetView on z/OS application. The user data is the user ID and password that must be passed to NetView for z/OS to complete the login.
Enable self-describing agent processing	KN3_AGT_TEMA_SDA	Specifies whether this monitoring agent plans to use the self-describing agent feature.
If the Agent requires address translation support	KN3_AGT_PARTITION_NAME	Specifies the partition name that identifies the location of this TEMS (namespace) relative to the firewall(s) used for address translation.
If the Agent requires network interface list support	KN3_AGT_TCP_KDEB_INTERFACELIST	Specifies a list of network interfaces you want the monitoring agent to use. This parameter is required for sites that are running multiple TCP/IP interfaces or network adapters on the same z/OS image.
Persistent datastore table space allocation overrides	KN3_PD KN3_PD_CYL KN3_PD_GRP KN3_PD_ROW KN3_X_PD_HISTCOLL_DATA_AGT_STC KN3_X_PD_HISTCOLL_DATA_TEMS_STC	Specifies the information required for this monitoring agent to override the global RTE defaults for space allocation for the persistent data store libraries and for overhead information such as the product dictionary, table records, index records, and buffers to hold overflow data.
Protocol port numbers for Agent connection to TEMS	KN3_TEMS_TCP_PIPE_PORT_NUM KN3_TEMS_TCP_PIPES_PORT_NUM KN3_TEMS_TCP_PIPE6_PORT_NUM KN3_TEMS_TCP_PIPE6S_PORT_NUM KN3_TEMS_TCP_UDP_PORT_NUM KN3_TEMS_TCP_UDP6_PORT_NUM	Specifies the port numbers used by the protocols specified under Specify communication protocols preference for TEMS connection for communication between the monitoring agent and Tivoli Enterprise Monitoring Server.
Secondary TEMS configuration	KN3_TEMS_BKUP1_NAME_NODEID	Specifies the name of that server if you have defined a backup Tivoli Enterprise Monitoring Server. The BKUP1 values are found in the KN3ENV member in the rhilev.midlev.rtename. RKANPARU library to communicate with the backup Tivoli Enterprise Monitoring Server.
Secondary TEMS TCP/IP information	KN3_TEMS_BKUP1_TCP_HOST	Specifies TCP/IP information for a backup Tivoli Enterprise Monitoring Server if you have defined a backup monitoring server. The BKUP1 values are found in the KN3ENV member in the rhilev.midlev.rtename. RKANPARU library to communicate with the backup Tivoli Enterprise Monitoring Server.
Secondary TEMS VTAM information:	KN3_TEMS_BKUP1_VTAM_APPL_LLB_BKR KN3_TEMS_BKUP1_VTAM_LU62_DLOGMOD KN3_TEMS_BKUP1_VTAM_NETID	Specifies VTAM or SNA information for the backup Tivoli Enterprise Monitoring Server if you have defined a backup monitoring server. The BKUP1 values are found in the KN3ENV member in the rhilev.midlev.rtename. RKANPARU library to communicate with the backup Tivoli Enterprise Monitoring Server.
Specify communication protocols preference for TEMS connection	KN3_AGT_COMM_PROTOCOLn	Details the protocol possibilities for communication between the monitoring agent and Tivoli Enterprise Monitoring Server in the order in which the protocols will be used.
Take Action commands security settings	KN3_AGT_PPI_RECEIVER KN3_AGT_PPI_SENDER KN3_SECURITY_ACTION_CLASS	Defines the connection between IBM® Z OMEGAMON® AI for Networks and Tivoli NetView for z/OS if you use Tivoli NetView for z/OS and specifies whether to override at the agent the SAF security value specified for the runtime environment.
Values that describe the address space	KN3_AGT_CONFIGURATION_MODE KN3_AGT_STC	Specifies the name of the address space where you are running in and the name of your agent PROC.
Values that describe the Primary TEMS the Agent will connect to	KN3_TEMS_LOCAL_CONNECT_FLAG KN3_TEMS_NAME_NODEID	Defines the information required to connect to the local Tivoli Enterprise Monitoring Server.
VTAM Secondary Program Operator (SPO) for Communication Network Management (CNM) interface (optional)	KN3_AGT_VTAM_NODE_OMXE KN3_AGT_VTAM_APPL_CNM_SPO	Defines how the IBM® Z OMEGAMON® AI for Networks monitoring agent communicates with the VTAM CNM interface to collect monitoring information.