IBM Tivoli OMEGAMON XE e IBM Tivoli Management Services en z
Transcripción
IBM Tivoli OMEGAMON XE e IBM Tivoli Management Services en z
Version 6.2.3 Fix Pack 1 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference SC14-7280-01 Version 6.2.3 Fix Pack 1 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference SC14-7280-01 Notices This edition applies to version 4, release 2 of the IBM Tivoli OMEGAMON XE products and to version 6, release 2, modification 2 of IBM Tivoli Management Services on z/OS (product number 5698-A79) and to all subsequent releases and modifications until otherwise indicated in new editions. © Copyright IBM Corporation 2010, 2012. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents About this information . . . . . . . . vii Chapter 1. Overview . . . . . . . . . 1 Where configured parameters are stored . How parameter values are set . . . . PARMGEN method . . . . . . . Configuration Tool (ICAT) method . . Default values . . . . . . . . . . Parameter names . . . . . . . . . Determining what products are configured runtime environment . . . . . . . Parameters covered in this guide . . . . . . . . . in . . . . . . . . . . . . . . each . . . . . . . . . . 1 1 2 2 2 3 . 4 . 5 Chapter 2. Common agent (KPP) parameters . . . . . . . . . . . . . 7 KPP_AGT_AUDIT_ITM_DOMAIN . . . . KPP_AGT_AUDIT_MAX_HIST . . . . . KPP_AGT_AUDIT_TRACE . . . . . . KPP_AGT_CONFIGURATION_MODE . . KPP_AGT_COMM_PROTOCOLn . . . . KPP_AGT_FLUSH_LSR_BUFR_INT_HR . . KPP_AGT_FLUSH_LSR_BUFR_INT_MIN . KPP_AGT_ICU_LANGUAGE_LOCALE . . KPP_AGT_KGL_WTO . . . . . . . . KPP_AGT_KLX_TCP_TOLERATERECYCLE KPP_AGT_NSNEWn_VALUE . . . . . KPP_AGT_NONSTDn_DSN . . . . . . KPP_AGT_NONSTDn_MBR . . . . . . KPP_AGT_NONSTDn_PARM . . . . . KPP_AGT_NSOLDn_VALUE . . . . . KPP_AGT_PARTITION_NAME. . . . . KPP_AGT_PPI_RECEIVER . . . . . . KPP_AGT_PPI_SENDER . . . . . . . KPP_AGT_STC . . . . . . . . . . KPP_AGT_STORAGE_DETAIL_INT_HR . KPP_AGT_STORAGE_DETAIL_INT_MIN . KPP_AGT_STORAGE_MINIMUM_EXTEND KPP_AGT_TCP_HOST . . . . . . . KPP_AGT_TCP_KDEB_INTERFACELIST . KPP_AGT_TCP_STC . . . . . . . . KPP_AGT_TEMA_SDA . . . . . . . KPP_AGT_TEMS_NAME_NODEID . . . KPP_AGT_VIRTUAL_IP_ADDRESS . . . KPP_AGT_VTAM_APPL_AA . . . . . KPP_AGT_VTAM_APPL_KPPINVPO. . . KPP_AGT_VTAM_APPL_NCS . . . . . KPP_AGT_VTAM_APPL_OPERATOR . . KPP_AGT_VTAM_APPL_PREFIX . . . . KPP_AGT_VTAM_NODE . . . . . . KPP_AGT_WTO_MSG. . . . . . . . KPP_PD . . . . . . . . . . . . KPP_PD_CYL . . . . . . . . . . KPP_PD_GRP . . . . . . . . . . KPP_PD_HISTCOLL_DATA_IN_AGT_STC . KPP_PD_HISTCOLL_DATA_IN_TEMS_STC © Copyright IBM Corp. 2010, 2012 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 . 8 . 9 . 10 . 11 . 13 . 14 . 14 . 16 . 17 . 18 . 19 . 20 . 21 . 22 . 22 . 24 . 25 . 26 . 27 . 28 . 29 . 30 . 31 . 32 . 33 . 34 . 35 . 36 . 37 . 38 . 38 . 39 . 40 . 41 . 42 . 43 . 44 . 45 . 46 KPP_PD_ROW . . . . . . . . . . . KPP_SECURITY_ACTION_CLASS. . . . . KPP_TEMS_BKUP1_NAME_NODEID . . . KPP_TEMS_BKUP1_TCP_HOST . . . . . KPP_TEMS_BKUP1_VTAM_APPL_LLB_BKR . KPP_TEMS_BKUP1_VTAM_LU62_DLOGMOD KPP_TEMS_BKUP1_VTAM_NETID . . . . KPP_TEMS_HUB_TCP_HOST . . . . . . KPP_TEMS_LOCAL_CONNECT_FLAG . . . KPP_TEMS_NAME_NODEID . . . . . . KPP_TEMS_TCP_HOST . . . . . . . . KPP_TEMS_TCP_PIPE_PORT_NUM . . . . KPP_TEMS_TCP_PIPES_PORT_NUM . . . KPP_TEMS_TCP_PIPE6_PORT_NUM. . . . KPP_TEMS_TCP_PIPE6S_PORT_NUM . . . KPP_TEMS_TCP_UDP_PORT_NUM . . . . KPP_TEMS_TCP_UDP6_PORT_NUM. . . . KPP_TEMS_VTAM_APPL_LLB_BROKER . . KPP_TEMS_VTAM_LU62_DLOGMOD . . . KPP_TEMS_VTAM_LU62_MODETAB . . . KPP_TEMS_VTAM_NETID . . . . . . . KPP_X_AGT_CONFIRM_SHUTDOWN . . . KPP_X_AGT_DEBUG_TRACE . . . . . . KPP_X_AGT_KDC_DEBUG . . . . . . . KPP_X_AGT_LGSA_VERIFY . . . . . . KPP_X_AGT_LSRPOOL_BUFFER_NUM. . . KPP_X_AGT_LSRPOOL_BUFSIZE . . . . . KPP_X_AGT_SDUMP_SVC_SYS1_DUMP . . KPP_X_AGT_STORAGE_LIMIT_EXTEND . . KPP_X_AGT_STORAGE_LIMIT_PRIMARY . . KPP_X_AGT_STORAGE_RESERVE_EXT. . . KPP_X_AGT_STORAGE_RESERVE_PRI . . . KPP_X_AGT_STORAGE_STGDEBUG . . . KPP_X_AGT_TASKS_ATTACHED_NUM . . KPP_X_HUB_BKUP1_TCP_HOST . . . . . KPP_X_HUB_BKUP1_TEMS_VTAM_NETID . KPP_X_HUB_BKUP1_VTAM_APPL_GLBBKR . KPP_X_HUB_TCP_HOST. . . . . . . . KPP_X_HUB_TEMS_VTAM_NETID . . . . KPP_X_HUB_VTAM_APPL_GLBBKR. . . . KPP_X_PD_HISTCOLL_DATA_AGT_STC . . KPP_X_PD_HISTCOLL_DATA_TEMS_STC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 48 49 50 51 52 53 54 54 55 57 58 59 60 61 61 62 63 64 65 66 67 68 68 69 70 71 71 72 73 73 74 75 75 76 76 77 77 78 78 79 79 Chapter 3. Global (GBL) parameters . . 81 GBL_DSN_ACF2_MACLIB . GBL_DSN_CBC_SCCNOBJ . GBL_DSN_CBC_SCLBSID . GBL_DSN_CEE_SCEEBIND . GBL_DSN_CEE_SCEEBND2 . GBL_DSN_CEE_SCEECPP . GBL_DSN_CEE_SCEELIB. . GBL_DSN_CEE_SCEELKED . GBL_DSN_CEE_SCEELKEX . GBL_DSN_CEE_SCEEMSGP. GBL_DSN_CEE_SCEERUN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 81 82 82 82 83 83 83 84 84 85 iii GBL_DSN_CEE_SCEESPC . . . . . . GBL_DSN_CICS_CTG_DLL . . . . . . GBL_DSN_CICS_SCTGSID . . . . . . GBL_DSN_CICS_SDFHC370 . . . . . . GBL_DSN_CICS_SDFHLOAD . . . . . GBL_DSN_CSF_SCSFMOD0 . . . . . . GBL_DSN_DB2_DSNEXIT . . . . . . GBL_DSN_DB2_LOADLIB_Vn . . . . . GBL_DSN_DB2_RUNLIB_Vn . . . . . GBL_DSN_DB2_SDSNLOAD . . . . . GBL_DSN_HZSPROC_LOADLIB . . . . GBL_DSN_IMS_RESLIB . . . . . . . GBL_DSN_IMS_SCEXLINK . . . . . . GBL_DSN_IMS_SFUNLINK . . . . . . GBL_DSN_ISP_SISPLOAD . . . . . . GBL_DSN_NETVIEW_CNMLINK . . . . GBL_DSN_SYS1_BRODCAST . . . . . GBL_DSN_SYS1_CSSLIB . . . . . . . GBL_DSN_SYS1_HSMLOGY . . . . . GBL_DSN_SYS1_LINKLIB . . . . . . GBL_DSN_SYS1_MACLIB . . . . . . GBL_DSN_SYS1_MODGEN . . . . . . GBL_DSN_SYS1_PARMLIB . . . . . . GBL_DSN_SYS1_PROCLIB . . . . . . GBL_DSN_SYS1_SAXREXEC . . . . . GBL_DSN_SYS1_SBLSCLI0 . . . . . . GBL_DSN_SYS1_SBPXEXEC. . . . . . GBL_DSN_SYS1_SISTMAC1 . . . . . . GBL_DSN_SYS1_VTAMLIB . . . . . . GBL_DSN_SYS1_VTAMLST . . . . . . GBL_DSN_TCP_ETC_SERVICES . . . . GBL_DSN_TCP_SEZACMTX . . . . . GBL_DSN_TCP_SEZARNT1 . . . . . GBL_DSN_TCP_SEZATCP . . . . . . GBL_DSN_TCP_SYSTCPD_TCPDATA . . GBL_DSN_TCP_SYSTCPD_TCPDATA_MFN GBL_DSN_WMQ_SCSQANLE. . . . . GBL_DSN_WMQ_SCSQAUTH . . . . GBL_DSN_WMQ_SCSQLOAD . . . . GBL_HFS_JAVA_DIRn . . . . . . . GBL_INST_HILEV. . . . . . . . . GBL_TARGET_HILEV . . . . . . . GBL_USER_JCL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 . 85 . 86 . 86 . 87 . 87 . 87 . 88 . 89 . 89 . 90 . 90 . 91 . 91 . 92 . 92 . 93 . 93 . 94 . 94 . 94 . 95 . 95 . 96 . 96 . 96 . 97 . 98 . 98 . 99 . 99 . 99 . 100 . 100 . 101 . 101 . 102 . 102 . 103 . 103 . 104 . 104 . 105 Chapter 4. Runtime environment (RTE) parameters. . . . . . . . . . 107 RTE_BASE_NAME . . . . . . RTE_CANSCN_STC . . . . . . RTE_CANSETE_STC . . . . . . RTE_DEBUG_SYSOUT . . . . . RTE_DESCRIPTION . . . . . . RTE_HCK_STC_INTERVAL . . . RTE_HILEV . . . . . . . . . RTE_JCL_SUFFIX . . . . . . . RTE_KCNDLSSI_IEFSSN00_FORMAT RTE_KCNSTR00_SSID . . . . . RTE_KCNSTR00_WTO . . . . . RTE_KCNSTR00_XCFGROUP . . . RTE_LOAD_OPTIMIZE . . . . . RTE_LOAD_SHARED_LIBS . . . RTE_LOG_SYSOUT . . . . . . iv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 107 108 109 109 110 110 111 112 113 113 114 115 116 116 RTE_NAME . . . . . . . . . . . RTE_PDS_BATCHINIT_FLAG . . . . . RTE_PDS_BACKUP_FLAG . . . . . . RTE_PDS_EXPORT_FLAG . . . . . . RTE_PDS_EXTRACT_FLAG . . . . . RTE_PDS_FILE_COUNT . . . . . . RTE_PDS_HILEV . . . . . . . . . RTE_PDS_KPDPROC_PREFIX . . . . . RTE_PDS_SMS_MGMTCLAS . . . . . RTE_PDS_SMS_STORCLAS . . . . . RTE_PDS_SMS_UNIT . . . . . . . RTE_PDS_SMS_VOLUME . . . . . . RTE_REMOTE_LPAR_FLAG . . . . . RTE_SECURITY_CLASS . . . . . . . RTE_SECURITY_FOLD_PASSWORD_FLAG RTE_SECURITY_USER_LOGON . . . . RTE_SHARE . . . . . . . . . . RTE_SMS_MGMTCLAS . . . . . . . RTE_SMS_PDSE_FLAG . . . . . . . RTE_SMS_STORCLAS . . . . . . . RTE_SMS_UNIT . . . . . . . . . RTE_SMS_VOLUME . . . . . . . . RTE_SMS_VSAM_MGMTCLAS . . . . RTE_SMS_VSAM_STORCLAS . . . . . RTE_SMS_VSAM_VOLUME . . . . . RTE_STC_PREFIX . . . . . . . . . RTE_SYSV_BASE_ALIAS . . . . . . RTE_SYSV_NAME . . . . . . . . RTE_SYSV_SYSVAR_FLAG . . . . . . RTE_SYSV_TEMS_NAME_NODEID . . . RTE_SYSV_VTAM_APPLID_MODEL . . RTE_SYSV_VTAM_APPLID_PREFIX . . RTE_SYSV_VTAM_NETID . . . . . . RTE_TCP_HOST . . . . . . . . . RTE_TCP_PORT_NUM . . . . . . . RTE_TCP_STC . . . . . . . . . . RTE_TEMS_CONFIGURED_FLAG . . . RTE_TEMS_NAME_NODEID . . . . . RTE_TN3270_DXL_HOSTADDRESS . . . RTE_TN3270_DXL_LUGROUP . . . . RTE_TN3270_DXL_TN3270PORT . . . . RTE_TYPE . . . . . . . . . . . RTE_USERMODS_FLAG . . . . . . RTE_USS_RTEDIR . . . . . . . . . RTE_VSAM_HILEV . . . . . . . . RTE_VTAM_APPLID_PREFIX . . . . . RTE_VTAM_GBL_MAJOR_NODE . . . RTE_VTAM_LU62_DLOGMOD . . . . RTE_VTAM_LU62_MODETAB . . . . RTE_VTAM_NETID . . . . . . . . RTE_X_KCNDLSSI_INITPARM_FLAG . . RTE_X_KCNSTR00_PLEXCOLLECT . . . RTE_X_KCNSTR00_REFRESH . . . . . RTE_X_SECURITY_DATA_ABOVE . . . RTE_X_SECURITY_EXIT_LIB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 117 118 119 120 120 121 122 122 123 123 124 125 125 126 127 128 129 129 130 131 131 132 133 133 134 134 135 136 137 137 138 139 139 140 140 141 142 143 144 144 145 146 146 148 148 149 150 150 151 151 152 153 154 154 Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters . 157 KDS_AUDIT_ITM_DOMAIN . KDS_AUDIT_MAX_HIST . . KDS_AUDIT_TRACE. . . . . . . . . . IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference . . . . . . . . . . . . . 157 . 157 . 158 KDS_HUB_TCP_HOST . . . . . . . . KDS_HUB_TCP_PIPE_PORT_NUM . . . . KDS_HUB_TCP_PIPE6_PORT_NUM . . . KDS_HUB_TCP_PIPE6S_PORT_NUM . . . KDS_HUB_TCP_PIPES_PORT_NUM . . . KDS_HUB_TCP_UDP_PORT_NUM . . . . KDS_HUB_TCP_UDP6_PORT_NUM . . . KDS_HUB_TEMS_HA_TYPE . . . . . . KDS_HUB_VTAM_APPL_GLB_BROKER . . KDS_HUB_VTAM_NETID . . . . . . . KDS_KMS_SDA . . . . . . . . . . KDS_MIG_TAPE_HILEV . . . . . . . KDS_MIG_TAPE_UNIT . . . . . . . . KDS_MIG_TAPE_VOL . . . . . . . . KDS_MIG_VER. . . . . . . . . . . KDS_MIG_VSAM_HILEV . . . . . . . KDS_NONSTDnn_DSN . . . . . . . . KDS_NONSTDnn_MBR . . . . . . . . KDS_NONSTDnn_PARM . . . . . . . KDS_NSNEWnn_VALUE . . . . . . . KDS_NSOLDnn_VALUE. . . . . . . . KDS_PA . . . . . . . . . . . . . KDS_PA_PARTITION_ADDRESS . . . . . KDS_PA_PARTITION_NAME . . . . . . KDS_PA_ROW . . . . . . . . . . . KDS_PD . . . . . . . . . . . . . KDS_PD_CYL . . . . . . . . . . . KDS_PD_GRP . . . . . . . . . . . KDS_PD_ROW . . . . . . . . . . . KDS_PH . . . . . . . . . . . . . KDS_PH_ROW . . . . . . . . . . . KDS_PH_TEMS_ALIAS_NAME . . . . . KDS_PH_TEMS_COMM_PROTOCOL1 . . . KDS_PH_TEMS_KSH_SECURE . . . . . KDS_PH_TEMS_NAME_NODEID . . . . KDS_PH_TEMS_RTE . . . . . . . . . KDS_PH_TEMS_SYSV_FLAG . . . . . . KDS_PH_TEMS_TCP_HOST . . . . . . KDS_PH_TEMS_TCP_HOST_LEN . . . . KDS_PH_TEMS_TCP_PORT_NUM . . . . KDS_PH_TEMS_USER_QUERY . . . . . KDS_PH_TEMS_USER_UPDATE . . . . . KDS_PH_TEMS_VTAM_APPL_GLB_BROKER KDS_PH_TEMS_VTAM_LU62_DLOGMOD . KDS_PH_TEMS_VTAM_NETID . . . . . KDS_PPI_RECEIVER . . . . . . . . . KDS_PPI_SENDER . . . . . . . . . KDS_PU . . . . . . . . . . . . . KDS_PU_ROW . . . . . . . . . . . KDS_PU_TEMS_NAME_NODEID . . . . KDS_PU_TEMS_RTE . . . . . . . . . KDS_PU_TEMS_USER_ID . . . . . . . KDS_PU_TEMS_USER_QUERY . . . . . KDS_PU_TEMS_USER_UPDATE . . . . . KDS_TEMA_SDA . . . . . . . . . . KDS_TEMS_COMM_ADDRESS_XLAT . . . KDS_TEMS_COMM_PROTOCOLn . . . . KDS_TEMS_DRA_FLAG . . . . . . . KDS_TEMS_EIF_BUFFER_EVENT_MAXSZE . KDS_TEMS_EIF_DISABLE_TEC_EMITTER . KDS_TEMS_EIF_EVENT_LISTENER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 159 160 161 162 163 164 165 166 166 167 168 168 169 170 170 171 172 173 174 174 175 176 177 177 178 178 179 180 180 181 181 182 182 183 184 184 185 186 186 187 187 188 188 189 190 191 192 192 192 193 194 194 195 196 196 197 198 199 200 201 KDS_TEMS_EIF_FLAG . . . . . . . . KDS_TEMS_EIF_HOST . . . . . . . . KDS_TEMS_EIF_PORT_NUM . . . . . . KDS_TEMS_FLUSH_LSR_BUFR_INT_HR . . KDS_TEMS_FLUSH_LSR_BUFR_INT_MIN . KDS_TEMS_HA_EXCL_LIST . . . . . . KDS_TEMS_HA_TYPE . . . . . . . . KDS_TEMS_HTTP_PORT_NUM . . . . . KDS_TEMS_ICU_LANGUAGE_LOCALE . . KDS_TEMS_KDC_DEBUG . . . . . . . KDS_TEMS_KGL_WTO . . . . . . . . KDS_TEMS_KLX_TCP_TOLERATERECYCLE KDS_TEMS_PARTITION_NAME . . . . . KDS_TEMS_SECURITY_KAES256_ENCKEY . KDS_TEMS_SECURITY_KDS_VALIDATE . . KDS_TEMS_SOAP_SERVER_FLAG . . . . KDS_TEMS_STC . . . . . . . . . . KDS_TEMS_STORAGE_DETAIL_INT_HR . . KDS_TEMS_STORAGE_DETAIL_INT_MIN . KDS_TEMS_STORAGE_DETAIL_LOG_FLAG KDS_TEMS_STORAGE_LIMIT_EXTEND . . KDS_TEMS_STORAGE_LIMIT_PRIMARY . . KDS_TEMS_STORAGE_MINIMUM_EXTEND KDS_TEMS_TCP_HOST . . . . . . . . KDS_TEMS_TCP_KDEB_INTERFACELIST . KDS_TEMS_TCP_PIPE_PORT_NUM . . . KDS_TEMS_TCP_PIPE6_PORT_NUM . . . KDS_TEMS_TCP_PIPE6S_PORT_NUM . . . KDS_TEMS_TCP_PIPES_PORT_NUM . . . KDS_TEMS_TCP_STC . . . . . . . . KDS_TEMS_TCP_UDP_PORT_NUM . . . KDS_TEMS_TCP_UDP6_PORT_NUM . . . KDS_TEMS_TYPE . . . . . . . . . . KDS_TEMS_VIRTUAL_IP_ADDRESS . . . KDS_TEMS_VTAM_APPL_CUA_OPER. . . KDS_TEMS_VTAM_APPL_GLB_BROKER . . KDS_TEMS_VTAM_APPL_KDS_VTAMID . . KDS_TEMS_VTAM_APPL_KDSINVPO . . . KDS_TEMS_VTAM_APPL_LLB_BROKER . . KDS_TEMS_VTAM_APPL_OPERATOR. . . KDS_TEMS_VTAM_APPL_PREFIX . . . . KDS_TEMS_VTAM_LU62_DLOGMOD . . . KDS_TEMS_VTAM_LU62_MODETAB . . . KDS_TEMS_VTAM_NETID. . . . . . . KDS_TEMS_VTAM_NODE . . . . . . . KDS_X_HUB_BKUP1_TCP_HOST . . . . KDS_X_HUB_BKUP1_TEMS_VTAM_NETID . KDS_X_HUB_BKUP1_VTAM_APPL_GLBBKR KDS_X_KDCFC_RXLIMIT . . . . . . . KDS_X_KDE_TRANSPORT_HTTP_OPTIONS KDS_X_KDE_TRANSPORT_OPTIONS . . . KDS_X_KDE_TRANSPORT_POOL_OPTIONS KDS_X_SECURITY_RESOURCE_CLASS . . KDS_X_SECURITY_USER_EXIT . . . . . KDS_X_STC_SYSTCPD_INCLUDE_FLAG . . KDS_X_TEMS_CONFIRM_SHUTDOWN . . KDS_X_TEMS_DEBUG_TRACE . . . . . KDS_X_TEMS_EIF_BFR_EVT . . . . . . KDS_X_TEMS_EIF_BFR_EVT_PATH. . . . KDS_X_TEMS_EIF_FLT_ATTR1 . . . . . KDS_X_TEMS_EIF_FLT_CLASS1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202 203 203 204 205 206 206 207 208 210 211 212 213 214 214 215 216 216 217 218 219 220 221 222 222 224 225 226 227 228 229 230 232 233 233 234 234 235 236 237 237 238 238 239 240 240 241 241 242 242 243 244 244 245 245 246 247 247 248 249 249 Contents v KDS_X_TEMS_EIF_FLT_MODE . . . . . KDS_X_TEMS_FRAME_STACK_SIZE . . . KDS_X_TEMS_LGSA_VERIFY . . . . . . KDS_X_TEMS_LOGBLOCK_RKLVLOG_SIZE KDS_X_TEMS_LOGBUFS_RKLVLOG_BUFSZ KDS_X_TEMS_LSRPOOL_BUFFER_NUMn . KDS_X_TEMS_LSRPOOL_BUFSIZEn . . . KDS_X_TEMS_LSRSTRNO_CONCURRENT . KDS_X_TEMS_SDUMP_SVC_SYS1_DUMP . KDS_X_TEMS_STORAGE_RESERVE_PRI . . KDS_X_TEMS_STORAGE_STGDEBUG . . . KDS_X_TEMS_TASKS_ATTACHED_NUM . KDS_X_TEMS_WTO . . . . . . . . . Parameters for the high-availability hub monitoring server . . . . . . . . . . KDS_TEMS_HA_TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250 250 251 251 252 252 253 254 254 255 256 257 257 . . . 258 . 258 KOB_TOM_STC . . . . . . . KOB_TOM_VTAM_APPL_LOGON . KOB_TOM_VTAM_NODE . . . . Documentation library . . . . . . . . . . . . . 259 . 260 . 261 . . . . . . . 263 IBM Tivoli Monitoring library . . Documentation for the base agents Related publications . . . . . Other sources of documentation . . . . . . . . . . . . . . . . . . . . . . . . . 263 264 265 265 Support information . . . . . . . . 267 Notices . . . . . . . . . . . . . . 269 Trademarks . . . . . . . . . . . . . . 270 Glossary . . . . . . . . . . . . . 271 Chapter 6. Enhanced 3270 user interface (KOB) parameters . . . . . 259 vi Index . . . . . . . . . . . . . . . 287 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference About this information IBM® Tivoli® OMEGAMON® and IBM Tivoli Management Services on z/OS®: Common Parameter Reference Version 6 Release 2 Modification Level 0 (Version 6.2.0) provides reference information on parameters used for setting up runtime environments and configuring hub and remote Tivoli Enterprise Monitoring Servers on z/OS. This information is for the z/OS systems programmer or analyst who is responsible for installing applications, automating tasks on the system, monitoring new applications, and providing solutions for operators when they have problems. Users of this information should be familiar with the z/OS operating system and its associated concepts, UNIX System Services, TCP/IP, and performance monitoring concepts. This edition applies to version 4, release 2 and version 5, release 1 of the IBM Tivoli OMEGAMON XE products and to version 6, release 2, modification 2 of IBM Tivoli Management Services on z/OS (product number 5698-A79) and to all subsequent releases and modifications until otherwise indicated in new editions. Before using this information and the product it supports, read the information in “Notices” on page 269. New in this release The following updates apply to the IBM Tivoli Monitoring Version 6.2.3 Fix Pack 1 update of this book: v A new $GBL* configuration profile is now available. This addition profile provides a clearer categorization of GBL-like candidate parmeters and differentiates them from LPAR-candidate parameters. The content of this configuration file varies, depending on customer deployment practices. The profiles are called in this order. The LPAR-specific one ($CFG$IBM or the &rte_name) member takes precedence over the $GBL* configuration profile: rhilev.midlev.WCONFIG($SYSIN) v A number of the existing GBL_* parameters that were previously found in the $CFG* configuration file have been moved to $GBL$IBM/$GBL$USR. The latest version of this file is in rhilev.midlev.WCONFIG($GBL$IBM). v IBM Tivoli Monitoring v6.2.3 includes a new auditing facility that provides detailed messages for certain major state changes or events that occur within the environment (in Tivoli Enterprise Portal Server, the Tivoli Enterprise Monitoring Server, and the monitoring agents). Audit Events in the system reflect major and minor state changes, such as authorization and authentication failures, and do not reflect minor service messages stored in the RAS logs. These audit parameters can be customized for inclusion in the KDSENV member of the KDCSSITE member of the rhilev.midlev.RKANPARU library for the monitoring server for monitoring agents on z/OS or by editing the KDSENV values for the distributed monitoring agents. The following new parameters were added: – Kpp_AGT_AUDIT_ITM_DOMAIN – Kpp_AGT_AUDIT_MAX_HIST – Kpp_AGT_AUDIT_TRACE – Kpp_AGT_TEMA_SDA – Kpp_SECURITY_ACTION_CLASS – KDS_AUDIT_ITM_DOMAIN – KDS_AUDIT_MAX_HIST – KDS_AUDIT_TRACE – KDS_KMS_SDA – KDS_TEMA_SDA – KDS_TEMS_DRA_FLAG © Copyright IBM Corp. 2010, 2012 vii – GBL_HFS_JAVA_DIRn – GBL_DSN_SYS1_SBPXEXEC – RTE_SECURITY_CLASS – RTE_USS_RTEDIR – KOB_TOM_STC – KOB_TOM_VTAM_APPL_LOGON – KOB_TOM_VTAM_NODE v The list of parameters that describe a high-availability hub monitoring server has been enhanced considerably; the new parameters are: KDS_KCF_EXT_SECURITY KDS_KCF_MAX_ERROR KDS_KCF_SAFCLASS KDS_KMC_MQ_MAXROWS KDS_TEMS_HA_INCLUDE_Kpp KDS_TEMS_HA_TYPE KDS_TEMS_TCP_KDEB_INTERFACELIST KDS_TEMS_TYPE KMC_CFG_AUDIT_FLAG KMC_CFG_DATABASE_TYPE KMC_CFG_DB_DB2_DATABASE KMC_CFG_DB_DB2_NAME KMC_DEFAULT_RCACFG_NODENAME KMC_I_CFG_AUDIT_SETTING KMC_I_KCF_DB2_NAME KMC_NODENAME KMC_X_KCF_MAX_ERROR KMC_X_KMC_MQ_MAXROWS KMC_X_SECURITY_KCF_SAFCLASS KMC_X_SECURITY_KCF_EXT_SECURITY Kpp_AGT_TCP_KDEB_INTERFACELIST v The OMEGAMON enhanced 3270 user interface has its own set of common configuration parameters, each of which begins with "KOB". The new KOB parameters are: – KOB_TOM_STC – KOB_TOM_VTAM_APPL_LOGON – KOB_TOM_VTAM_NODE These parameters are described in a new chapter, Chapter 6, “Enhanced 3270 user interface (KOB) parameters,” on page 259. viii IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Chapter 1. Overview This guide provides reference information about the parameters that are used for setting and storing configuration values for the common components of IBM Tivoli Management Services on z/OS and for the runtime environments in which the IBM Tivoli OMEGAMON XE monitoring agents are configured. For agent parameter information, see the documentation for each product. Changes to this guide since the initial release of Tivoli Management Services on z/OS version 6.2.2, Fix Pack 2, are marked with revision bars (|) in the left margin of pages in the PDF book. Where configured parameters are stored Most configuration parameters and their configured values are stored in the KppENV or KppSYSIN members of the rhilev.rte.RKANPARU data set for each runtime environment. Where: pp is the 2-character product or component code rhilev is the high-level qualifier for the runtime environment data sets rte is the runtime environment name, which is used as the mid-level qualifier for the runtime environment data sets For information about runtime environments, see the "Planning your deployment" chapter of IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. The parameters stored in the KppENV member are environment variables, which determine the operating characteristics of the runtime environment in which products and components are configured. The parameters stored in the KppSYSIN member are startup parameters, which determine the default startup values for each product or component. Some environment variables and startup parameters are stored in members other than KppENV and KppSYSIN, or in data sets other than RKANPARU. In addition, some parameters that are neither environment variables nor startup parameters must be included in the runtime libraries for the products and components. How parameter values are set Most parameters are provided with default values that you can accept or change. Some parameters are included in the runtime libraries by default, and others are excluded by default. You can set parameter values by either of two basic methods: v “PARMGEN method” on page 2 v “Configuration Tool (ICAT) method” on page 2 For instructions on using both configuration methods, see IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. If you decide to use the PARMGEN tool to create or update your site’s runtime environments, you might want to take advantage of the detailed scenarios in the IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: PARMGEN Reference. © Copyright IBM Corp. 2010, 2012 1 PARMGEN method 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. The PARMGEN method can be used for creating new runtime environments and for upgrading existing ones that were created from product versions for which the PARMGEN configuration method was enabled. To upgrade from a product version lower than the first PARMGEN-enabled version, you must use the Configuration Tool (ICAT). To determine the lowest PARMGEN-enabled version of each of your products, see the PARMGEN Technote at http://www.ibm.com/support/docview.wss?uid=swg21417935. If you have runtime environments that are already configured by the Configuration Tool (ICAT) method, a conversion tool (the KCIJPCNV job) is provided for using the existing parameter values in those runtime environments to set up initial values for new runtime environments to be configured by the PARMGEN method. After you use the PARMGEN method to configure new runtime environments, you cannot use the Configuration Tool to edit or maintain them. Configuration Tool (ICAT) method The Configuration Tool (also called the Installation and Configuration Assistance Tool, or ICAT) is software provided for configuring the Tivoli Enterprise Monitoring Server and monitoring agents on z/OS systems. The Configuration Tool operates in two modes: v Interactive mode, where an ISPF panel-driven facility assists you in specifying parameters and tailoring jobs for configuring new products and new versions of products. v Batch mode, where you create a single batch job that you can use to build, configure, and load a runtime environment for the Tivoli Enterprise Monitoring Server, monitoring agents, or both. The batch job performs the same processing as the interactive Configuration Tool. Batch mode is a quick way to configure your runtime environments and is particularly useful for replicating a configured runtime environment to other z/OS systems. For details, see the "Batch mode" chapter of IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. In most cases, you use interactive mode to set parameter values for a runtime environment and for the products and components in the runtime environment, and then you use batch mode to propagate the parameter values to other LPARs. (See Part 4, “Replicating configured environments,” and Part 5, “Configuration and deployment scenarios,” in IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide.) Default values Some parameters have only one default value, and some have more than one. For example, TMS:Engine sets this global default value for the “KDS_TEMS_STORAGE_LIMIT_EXTEND” on page 219 parameter: LIMIT(16,X) However, the Configuration Tool panels and PARMGEN files override the TMS:Engine default and show a different default value for the Tivoli Enterprise Monitoring Server: LIMIT(23,X) When you edit a default value on a Configuration Tool panel or in a PARMGEN file, your edited value overrides the Configuration Tool or PARMGEN default value, which has already overridden the TMS:Engine default value (if a TMS:Engine default value exists). 2 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference The default values provided by an individual monitoring agent product often differ from the TMS:Engine default values, the Tivoli Enterprise Monitoring Server default values, and the default values of other monitoring agents. Default values for monitoring agents are shown in the Configuration Tool panels, batch mode data dictionaries, parameter maps (described in IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide), and PARMGEN configuration profiles (also described in IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide). These values are also included in the documentation for each monitoring agent product. This guide includes information about the default values for runtime environment and Tivoli Enterprise Monitoring Server parameters. Parameter names Most parameters have several different names in the Configuration Tool, in Batch mode, and in PARMGEN. Stored parameter name Name of the parameter as stored in a runtime library. Example: LIMIT Configuration Tool field name Name of the field that identifies the parameter on an interactive panel. Example: Maximum storage request size (extended) Batch parameter name Name of the parameter in the batch parameter member. Example: KDS_CMS_EXT_LIM PARMGEN name Name of the parameter in the PARMGEN parameter list. Example: KDS_TEMS_STORAGE_LIMIT_EXTEND In this guide, the parameters in each chapter are documented in alphabetical order by PARMGEN name, and all other applicable names for each parameter are shown. You can use the Index to look up a parameter by one of the names other than the PARMGEN name. Parameters with n or nn in their names Some parameters include n or nn in their names. These are not the actual names of these commands as you will see them in the configuration profile. The n or nn means that you can have multiple instances of this parameter in your configuration profile. For example, you will most likely have multiple instances of the set of monitoring agent component override commands (for example, KN3_TCPXnn_OVRD_CONN or KN3_TCPXnn_OVRD_FTP) because you have one set of values for every instance in which you override the global (all stacks) collection values for a specific stack. Likewise, you would have multiple instances of the KN3_AGT_NONSTDn_DSN, KN3_AGT_NONSTDn_MBR, KN3_AGT_NONSTDn_PARM values if you defined several nonstandard parameters. If you cannot find a parameter by searching on its full name, try searching on a part of the name, omitting the numbers that define instance. Parameters designated N/A Some parameters have "N/A" (not applicable) designated in the field description. This designation means that these parameter cannot be set using the mode being described. Certain groups of parameters cannot be set using the Configuration Tool and cannot be updated in your environment using Batch. Examples include the KN3_X and KON_X parameters, most of which are stored in either the KN3SYSIN or KONSYSIN member in the rhilev.midlev.rtename.RKANPARU library. You can set these values using PARMGEN because they are part of the configuration profile. If you configure your monitoring agent using the Configuration Tool and the default values provided for this product do no meet your needs, you must modify these values using the Non-Standard Parameter panels Chapter 1. Overview 3 in the Configuration Tool. Refer to the common configuration guide for information about nonstandard parameters. If you do not use this method to modify these values, then the values will revert to the default values when the Configuration Tool is updated. There is a difference in how PARMGEN designates multiple instances of sets of parameters for stack-specific configuration (as opposed to global values) in the configuration profile file and how Batch mode handles these same parameters. As noted previously, override commands in PARMGEN have a two-digit number (represented as nn) appended to the middle of the parameter name (for example, KN3_TCPXnn) indicating a stack-specific override of a global value (for example, KN3_TCPX01_OVRD_CONN or KN3_TCPX02_OVRD_CONN to override the global value KN3_TCP_CON). Batch mode does not append the two-digit number to indicate a stack-specific override. Instead, Batch overrides are indicated with a KN3_TCPX BEGIN or KON_TCPX BEGIN statement and concluded with a KN3_TCPX END or KON_TCPX END statement, as shows in the following sample Batch mode file: ** TCP/IP Information: KN3_TCP_DATA KN3_TCP_SAMP_INTERVAL KN3_TCP_STACK KN3_TCP_CON . . ** Define TCP monitoring KN3_TCPX KN3_TCPX_ROW KN3_TCPX_SYS_NAME KN3_TCPX_ADDR_SPACE KN3_TCPX_PROF_DATASET KN3_TCPX_OGBL KN3_TCPX_OSTACK KN3_TCPX_OTCPC . . **KN3_TCPX_PROF_MEMBER KN3_TCPX_ROW KN3_TCPX_SYS_NAME KN3_TCPX_ADDR_SPACE KN3_TCPX_PROF_DATASET KN3_TCPX_OGBL KN3_TCPX_OSTACK KN3_TCPX_OTCPC . . KN3_TCPX_PROF_MEMBER . . KN3_TCPX SYS1.TCPPARMS(TCPDATA) 1 Y Y <-- global default systems member: BEGIN * Table begin $$$$ $$$$$$$$ TCPIP.PROFILE.TCPIP N Y Y <-- stack specific-default (this is also global) $$$$ SAMPLESTACK USER.PARMLIB Y Y Y <-- stack specific for SAMPLESTACK SAMPLESTACK END <-- End of SAMPLESTACK parameters <--End of all overrides for all stacks Therefore, parameters such as KN3_TCPX or KON_TCPX can be set using the Non-Standard Parameters panels in the Configuration Tool, but do not have Batch names (they are designated "N/A" in this guide). The Configuration Tool sets these parameters internally unless you set them using the Non-Standard Parameter panels. You can override the system-defined defaults by editing the stack-specific instance of the KPPSYSIN file or by using the Non-Standard Parameter Panels, which persist after Configuration Tool maintenance has been applied. Determining what products are configured in each runtime environment One of the first sections in the configuration profile is the set of flags that define the set of monitoring agents running in this runtime environment. These configuration flag statements are in the following format: 4 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference * Tivoli Enterprise Monitoring Server: KDS flag CONFIGURE_TEMS_KDS "Y" Where the first line, which is commented out, identifies the product or component to be configured and the second statement is the PARMGEN command to configure the specified product. Specify Y if the product-specific configuration flag if the product is to be configured in this runtime environment. Specify N if you do not plan to configure the specified product in this runtime environment. The full set of configuration flags are found in the table that follows. Table 1. Master Flags from CONFIGURE_PRODUCTS USER SECTION Product Configuration statement (Y or N) Tivoli Enterprise Monitoring Server CONFIGURE_TEMS_KDS IBM Tivoli OMEGAMON XE for CICS on z/OS CONFIGURE_CICS_KC5 IBM Tivoli OMEGAMON XE for CICS TG on z/OS: CONFIGURE_CICS_TG_KGW IBM Tivoli OMEGAMON XE for DB2 PE/PM CONFIGURE_DB2_AGENT_KD5 IBM Tivoli OMEGAMON XE for IMS on z/OS CONFIGURE_IMS_KI5 IBM Tivoli OMEGAMON XE on z/OS CONFIGURE_ZOS_KM5 IBM Tivoli System Automation for z/OS CONFIGURE_SA_KAH IBM OMEGAMON z/OS Management Console CONFIGURE_ZMC_KHL IBM Tivoli OMEGAMON XE for Messaging - WebSphere MQ Configuration CONFIGURE_MESSAGING_KMC IBM Tivoli OMEGAMON XE for Messaging - WebSphere MQ Monitoring: CONFIGURE_MESSAGING_KMQ IBM Tivoli OMEGAMON XE for Messaging - WebSphere Message Broker CONFIGURE_MESSAGING_KQI IBM Tivoli NetView for z/OS Agent CONFIGURE_NETVIEW_KNA IBM Tivoli OMEGAMON XE for Mainframe Networks CONFIGURE_MFN_KN3 IBM Tivoli OMEGAMON XE for Storage on z/OS CONFIGURE_STORAGE_KS3 IBM Tivoli OMEGAMON DE on z/OS - OMEGAVIEW and OMEGAVIEW II CONFIGURE_OMEGAVIEW_KWO IBM Tivoli Decision Support for z/OS CONFIGURE_TDS_KDO IBM Tivoli Composite Application Manager for SOA CONFIGURE_SOA_KD4 IBM Tivoli Advanced Audit for DFSMShsm CONFIGURE_AAD_KRG IBM Tivoli Advanced Reporting for DFSMShsm CONFIGURE_ARD_KRH IBM Tivoli Advanced Allocation Management for z/OS CONFIGURE_AAM_KRJ IBM Tivoli Automated Tape Allocation Manager for z/OS CONFIGURE_ATAM_KRK IBM Tivoli Advanced Catalog Management for z/OS CONFIGURE_ACM_KRN IBM Tivoli Advanced Backup and Recovery for z/OS CONFIGURE_ABR_KRV IBM Tivoli Tape Optimizer for z/OS CONFIGURE_TOZ_KRW ITCAM for Application Diagnostics on z/OS CONFIGURE_ITCAMAD_KYN Parameters covered in this guide This guide documents several types of parameters: v Chapter 2, “Common agent (KPP) parameters,” on page 7 The parameters common to all agents had been documented in the OMEGAMON XE for Mainframe Networks parameter reference guide. The definitions of these parameters have been broadened and moved to this common location since the parameters are common to all agents configured with PARMGEN. Chapter 1. Overview 5 v Chapter 3, “Global (GBL) parameters,” on page 81 The global parameters provide default settings for installation and common system library names. v Chapter 4, “Runtime environment (RTE) parameters,” on page 107 The runtime environment parameters provide configuration settings for an individual runtime environment and default settings for the components and products configured in the runtime environment. v Chapter 5, “Tivoli Enterprise Monitoring Server (KDS) parameters,” on page 157 The Tivoli Enterprise Monitoring Server parameters provide configuration settings for hub and remote monitoring servers on z/OS. In addition, the “Parameters for the high-availability hub monitoring server” on page 258 section of this chapter describes parameters specific to a HA hub TEMS. v Chapter 6, “Enhanced 3270 user interface (KOB) parameters,” on page 259 The OMEGAMON enhanced 3270 user interface has its own set of common configuration parameters, each of which begins with "KOB". The KOB parameters are: – “KOB_TOM_STC” on page 259 – “KOB_TOM_VTAM_APPL_LOGON” on page 260 – “KOB_TOM_VTAM_NODE” on page 261 6 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Chapter 2. Common agent (KPP) parameters The KPP common agent configuration parameters in this section. The definitions for the PP variable are found in the table that follows. The following The three-letter agent prefixes for the agents are supported by the PARMGEN configuration method: Table 2. Common agent parameter prefixes Agent name Agent prefixes IBM Tivoli System Automation for z/OS KAH IBM Tivoli OMEGAMON enhanced 3270 user interface KOB IBM Tivoli OMEGAMON XE for CICS on z/OS KOC, KC2, KC5 IBM Tivoli OMEGAMON XE for CICS TG on z/OS KGW IBM Tivoli Decision Support for z/OS KDO IBM Tivoli Composite Application Manager for SOA KD4 IBM Tivoli OMEGAMON XE for DB2 PE/PM KO2, KD2, KD5 IBM OMEGAMON z/OS Management Console KHL IBM Tivoli OMEGAMON XE for Messaging - WebSphere KMC MQ Configuration IBM Tivoli OMEGAMON XE for Messaging - WebSphere KMQ MQ Monitoring IBM Tivoli OMEGAMON XE for Messaging - WebSphere KQI Message Broker OMEGAVIEW and OMEGAVIEW II KMV, KWO IBM Tivoli OMEGAMON XE on z/OS KOM, KM2, KM5 IBM Tivoli NetView for z/OS Agent KNA IBM Tivoli OMEGAMON XE for Mainframe Networks KON, KN3 IBM Tivoli Advanced Audit for DFSMShsm KRG IBM Tivoli Advanced Reporting for DFSMShsm KRH IBM Tivoli Advanced Allocation Management for z/OS KRJ IBM Tivoli Automated Tape Allocation Manager for z/OS KRK IBM Tivoli Advanced Catalog Management for z/OS KRN IBM Tivoli Advanced Backup and Recovery for z/OS KRV IBM Tivoli Tape Optimizer for z/OS KRW ITCAM for Application Diagnostics on z/OS KYN KPP_AGT_AUDIT_ITM_DOMAIN This parameter is the audit domain name. Required or optional Optional Location where the parameter value is stored KppENV member of the rhilev.rte.RKANPARU library for the agent’s runtime environment © Copyright IBM Corp. 2010, 2012 7 Parameter name and syntax ITM_DOMAIN=%Kpp_AGT_AUDIT_ITM_DOMAIN% Default value None Permissible values Character string, maximum length 32. In the Configuration Tool (ICAT) Panel name Specify Advanced Agent Configuration Values Panel ID KAG62P5 Field z/OS Audit collection values: Domain Default value None Permissible values Character string, maximum length 32. Batch parameter name Kpp_AGT_AUDIT_ITM_DOMAIN PARMGEN name Kpp_AGT_AUDIT_ITM_DOMAIN Description This field specifies an identifier that may be used to associate audit records. It is suited for commonly identifying agents that are associated with each other. An example use may be for sorting records by a particular customer. This field will also be used to create unique namespaces for RBAC. Related parameters v “KPP_AGT_AUDIT_TRACE” on page 9 v “KPP_AGT_AUDIT_MAX_HIST” v “KDS_AUDIT_TRACE” on page 158 v “KDS_AUDIT_MAX_HIST” on page 157 v “KDS_AUDIT_ITM_DOMAIN” on page 157 KPP_AGT_AUDIT_MAX_HIST This parameter specifies the maximum in-memory cache entries; it is the maximum number of records kept in short-term memory for direct queries. Required or optional Optional Location where the parameter value is stored The AUDIT_MAX_HIST parameter in the RKANPARU data set, member KPPENV for the agent’s runtime environment. Parameter name and syntax AUDIT_MAX_HIST=%Kpp_AGT_AUDIT_MAX_HIST% Default value None 8 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Permissible values 10–1000 In the Configuration Tool (ICAT) Panel name Specify Advanced Agent Configuration Values Panel ID KAG62P5 Field z/OS Audit collection values: Maximum in-memory cache entries Default value None Permissible values 10–1000 Batch parameter name Kpp_AGT_AUDIT_MAX_HIST PARMGEN name Kpp_AGT_AUDIT_MAX_HIST Description The maximum number of records kept in short-term memory for direct queries. Related parameters v “KPP_AGT_AUDIT_TRACE” v “KPP_AGT_AUDIT_ITM_DOMAIN” on page 7 v “KDS_AUDIT_TRACE” on page 158 v “KDS_AUDIT_MAX_HIST” on page 157 v “KDS_AUDIT_ITM_DOMAIN” on page 157 KPP_AGT_AUDIT_TRACE This parameter indicates the trace level to pass messages. Required or optional Optional Location where the parameter value is stored KppENV member of the rhilev.rte.RKANPARU library for the agent’s runtime environment. Parameter name and syntax AUDIT_TRACE=%Kpp_AGT_AUDIT_TRACE% Default value None Permissible values M, B, D, X In the Configuration Tool (ICAT) Panel name Specify Advanced Agent Configuration Values Panel ID KAG62P5 Field z/OS Audit collection values: Enable/Disable z/OS audit collection Chapter 2. Common agent (KPP) parameters 9 Default value None Permissible values M, B, D, X Batch parameter name Kpp_AGT_AUDIT_TRACE PARMGEN name Kpp_AGT_AUDIT_TRACE Description This indicates the trace level to pass messages. Message trace levels, from low to high, are: X disabled M minimum B basic D detail Higher levels imply all lower levels. Related parameters v “KPP_AGT_AUDIT_MAX_HIST” on page 8 v “KPP_AGT_AUDIT_ITM_DOMAIN” on page 7 v “KDS_AUDIT_TRACE” on page 158 v “KDS_AUDIT_MAX_HIST” on page 157 v “KDS_AUDIT_ITM_DOMAIN” on page 157 KPP_AGT_CONFIGURATION_MODE Use the KPP_AGT_CONFIGURATION_MODE parameter to specify how you want to run the monitoring agent you are defining, in the agent address space or the server address space. Required or optional Required Location where parameter value is stored The parameter value is not stored, but is used for internal processing. Parameter name N/A Default value STANDALONE Permissible values One of the following: v STANDALONE v CMS In the Configuration Tool (ICAT) Panel name CONFIGURE monitoring_agent Panel ID KppVVMCU, where VV is the agent-specific panel ID. Field 10 Configure monitoring_agent IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference This value is set when you select Option 3 on this panel and complete the resulting set of panels. If you choose Option 3 then the value for this parameter is set to AGTCMS, which is strongly recommended for more monitoring agents, (meaning that the agent runs in its own address space). If you choose PF5 Advanced on Panel KppvvvMCU, then the value for this parameter will be set to CMS, which means that the agent runs in the run in the Tivoli Enterprise Monitoring Server (CMS) address space. This value must be selected for the IBM Tivoli OMEGAMON XE on z/OS monitoring agent and the IBM Tivoli OMEGAMON XE for Storage on z/OS monitoring agent since these agents run only in the monitoring server address space. Default value No default Permissible values One of the following: v STANDALONE v CMS v AGTCMS Batch parameter name KPP_AGT_CONFIG PARMGEN name KPP_AGT_CONFIGURATION_MODE PARMGEN classification Values that describe the address space Description Agent configuration option This parameter specifies how you want to run the monitoring agent you are defining. When defining an agent, you have the option to run the agent in an agent address space or in the server address space. For performance reasons, you should run the agent in an agent address space. If you plan to run the agent in the server address space, the runtime environment must contain a server. To run the agent in an agent address space, choose Option 3 (AGTCMS) in the Configuration Tool, which is the preferred configuration or specify STANDALONE in PARMGEN. Otherwise, by choosing PF5 Advanced from the KPPVVMCU panel (the monitoring_agent’s main menu panel), you specify CMS in the Configuration Tool or TEMS in PARMGEN to run the agent in the server. The procedures outlined in the product-specific planning and configuration guide assumes that you are running the recommended configuration for this agent, which is running in the agent address space. Related parameters None KPP_AGT_COMM_PROTOCOLn Use the KPP_AGT_COMM_PROTOCOLn parameter to specify the communication protocol for the TEMS connection. Valid values are IPPIPE, IP, SNA, IP6PIPE, IP6, IPSPIPE, and IP6SPIPE. When communication with the TEMS is initiated, the agent first tries protocol 1, then goes to protocol 2, and so on, in case of failure. Note: Update the corresponding Kpp_TEMS_TCP_*_PORT_NUM parameter for each Kpp_AGT_COMM_PROTOCOLx parameter enabled. For example, if Kpp_AGT_COMM_PROTOCOL1="IPPIPE", set the corresponding Kpp_TEMS_TCP_PIPE_PORT_NUM parameter. If Kpp_TEMS_COMM_PROTOCOL2="IP" (for IP.UDP), set the corresponding Kpp_TEMS_TCP_UDP_PORT_NUM parameter. Chapter 2. Common agent (KPP) parameters 11 Required or optional Required Location where the parameter value is stored In the KPPENV member of the rhilev.rtename.RKANPARU library Parameter name N/A Default value None Permissible values IP.PIPE, IP.UDP, IP6.PIPE, IP6.UDP, IP.SPIPE, IP6.SPIPE, and SNA.PIPE In the Configuration Tool (ICAT) Panel name SPECIFY AGENT ADDRESS SPACE PARAMETERS Panel ID KAG62P2 Field Specify the communication protocols in priority sequence. v IP.PIPE v IP.UDP v IP6.PIPE v IP6.UDP v IP.SPIPE v IP6.SPIPE v SNA.PIPE Example: KDE_TRANSPORT=\ HTTP:1920\ IP6.PIPE PORT:1918 USE:N\ IP6.UDP PORT:1918 USE:N\ IP.SPIPE PORT:3660 USE:N\ IP6.SPIPE PORT:3660 USE:N\ IP.PIPE PORT:1918\ IP.UDP PORT:1918\ SNA.PIPE PORT:135 Default value None Permissible values 1-7 Batch parameter name KPP_AGT_COMM_PROn PARMGEN name KPP_AGT_COMM_PROTOCOLn PARMGEN classification Specify communication protocols preference for TEMS connection Description Agent Communication protocol n This parameter specifies the communication protocol to be supported by the monitoring agent, where n corresponds to a number between 1 and 7 to indicate the priority sequence for the communication protocols. 12 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference In the Configuration Tool (ICAT), the seven fields corresponding to the communication protocols that can be supported are shown, and you can set the priority sequence for these protocols by assigning each field a value from 1 to 7, with 1 as the highest priority and 7 as the lowest. Leave blank any fields that represent unsupported communication protocols. The protocols, both supported and unsupported, are listed along with assigned port numbers in the KPPENV member, as shown in the Example section. Unused protocols are indicated by USE:N. Supported protocols are listed in priority order. Related parameters None KPP_AGT_FLUSH_LSR_BUFR_INT_HR Use the KPP_AGT_FLUSH_LSR_BUFR_INT_HR parameter to specify the interval to force all deferred VSAM writes to DASD. Required or optional Required Location where the parameter value is stored In the KPPAGST member in the rhilev.midlev.rtename.RKANCMDU library Parameter name EVERY HH:MM:SS FLUSH (Flush VSAM buffers interval - hours) Default value 0 hours, 30 minutes Permissible values 0 - 24 In the Configuration Tool (ICAT) Panel name Specify Advanced Agent Configuration Values Panel ID KAG62P5 Field Flush VSAM buffers: Hours Default value 0 hours, 30 minutes, 0 seconds (seconds is not configurable) Permissible values 0 - 24 Batch parameter name KPP_AGT_FLUSH_INT_HR PARMGEN name KPP_AGT_FLUSH_LSR_BUFR_INT_HR PARMGEN classification Advanced Agent configuration values Description Flush VSAM buffers interval - hours This parameter specifies the interval to force all deferred VSAM writes to DASD. The interval values are written as part of the third EVERY command in the KPPAGST member in the rhilev.midlev.rtename.RKANCMDU library. The default is 0 hours (hh) and 30 minutes (mm). Chapter 2. Common agent (KPP) parameters 13 Related parameters None KPP_AGT_FLUSH_LSR_BUFR_INT_MIN Use the KPP_AGT_FLUSH_LSR_BUFR_INT_MIN parameter to specify the interval to force all deferred VSAM writes to DASD. Required or optional Required Location where the parameter value is stored In the KPPAGST member in the rhilev.midlev.rtename.RKANCMDU library Parameter name EVERY HH:MM:SS FLUSH (Flush VSAM buffers interval - mins) Default value 0 hours 30 minutes Permissible values 0 - 60 In the Configuration Tool (ICAT) Panel name Specify Advanced Agent Configuration Values Panel ID KAG62P5 Field Flush VSAM buffers: Minutes Default value 0 hours 30 minutes 0 seconds (seconds is not configurable) Permissible values 0 - 60 Batch parameter name KPP_AGT_FLUSH_INT_MIN PARMGEN name KPP_AGT_FLUSH_LSR_BUFR_INT_MIN Description Flush VSAM buffers interval - mins This parameter specifies the interval to force all deferred VSAM writes to DASD. The interval values are written as part of the third EVERY command in: rhilev.midlev.rtename.RKANCMDU(KPPAGST) The default is 0 hours (hh) and 30 minutes (mm). Related parameters None KPP_AGT_ICU_LANGUAGE_LOCALE Use the KPP_AGT_ICU_LANGUAGE_LOCALE parameter to specify the language and codeset (system's locale) that you want the monitoring agent to use. Required or optional Required 14 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Location where the parameter value is stored Generated in the KPPENV member in the rhilev.midlev.rtename.RKANPARU library Parameter name LANG= (Language locale of z/OS system) In the Configuration Tool (ICAT) Panel name Specify Advanced Agent Configuration Values Panel ID KAG62P5 Field Language locale Default value 1 (English - United States) Permissible values v 1 (English - United States) v 2 (English - United Kingdom) v 3 (German - Germany) v 4 (German - Switzerland) v 5 (French - Belgium) v 6 (French - France) v 7 (French - Switzerland) v 8 (Spanish - Spain) v 9 (Italian - Italy) v 10 (Portuguese - Portugal) v 11 (Portuguese - Brazil) v 12 (Norwegian - Norway) v 13 (Swedish - Sweden) v 14 (Danish - Denmark) v 15 (Finnish - Finland) v 16 (Japanese - Japan) v 17 (French - Canada) v 18 (Traditional Chinese - Taiwan) v 19 (Simplified Chinese - China) v 20 (Albanian - Albania) v 21 (Bulgarian - Bulgaria) v 22 (Czech - Slovenia) v 23 (Dutch - Belgium) v 24 (Dutch - Netherlands) v 25 (Greek - Greece) v 26 (Hebrew - Israel) v 27 (Korean - Korea) v 28 (Lithuanian - Lithuania) v 29 (Macedonian - Macedonia) v 30 (Romanian - Romania) v 31 (Russian - Russia) v 32 (Serbian - Serbia) v 33 (Slovak - Slovakia) v 34 (Slovenian - Slovenia) v 35 (Thai - Thailand) v 36 (Turkish - Turkey) Batch parameter name KPP_AGT_ICU_LANG Chapter 2. Common agent (KPP) parameters 15 PARMGEN name KPP_AGT_ICU_LANGUAGE_LOCALE PARMGEN classification Advanced Agent configuration values Description Language and region for the z/OS system. This parameter specifies the language and codeset (system's locale) that you want the monitoring agent to use. The language locale value is used for National Language support. This field requires the numeric value (1-36) representing the Language and Region in the table below. As an example, specify 1 for "English - United States". The country and character set that this language represents (for example, country is en_US and character set is ibm-037) make up the LANG= environmental variable value generated in the KPPENV member in the rhilev.midlev.rtename.RKANPARU library. For English - United States, LANG=en_US.ibm-037 is generated in KPPENV. From the Configuration Tool panel, press F1 (Help) and select Language locale for a list of the possible values. If you accept the default value of 1 (English - United States), the Configuration Tool generates this environment variable in KPPENV: LANG=en_US.ibm-037 If the z/OS UNIX System Services (USS) codepage (en_US.ibm-1047) is required, you can specify either en_US.ibm-1047 or 1A in the Language locale field on the Configuration Tool panel. In batch mode, you can specify either of these values: KPP_AGT_ICU_LANG KPP_AGT_ICU_LANG en_US.ibm-1047 1 In PARMGEN mode, you can specify either of these values for the USS codepage: KPP_AGT_ICU_LANGUAGE_LOCALE en_US.ibm-1047 The USS codepage (en_US.ibm-1047) is required for agent autonomy and for private situation XML files. Related parameters None KPP_AGT_KGL_WTO Use the KPP_AGT_KGL_WTO parameter to activate write-to-operator messages for a particular agent. Required or optional Required Location where the parameter value is stored In the KPPENV member of the rhilev.midlev.rtename.RKANPARU library Parameter name KGL_WTO= (Enable agent WTO messages) Default value YES Permissible values YES or NO In the Configuration Tool (ICAT) Panel name Specify Agent Advanced Configuration Values 16 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Panel ID KAG62P5 Field Enable startup console messages Default value N Permissible values Y, N Batch parameter name KPP_AGT_KGL_WTO PARMGEN name KPP_AGT_KGL_WTO PARMGEN classification Advanced Agent configuration values Description Enable agent WTO messages Specify Y to this parameter if you want a SYSLOG message on the console to indicate when the monitoring agent finishes initializing. You can use this message in an automation script. See the automation package for your site for further instructions on how to capture the monitoring agent startup automation message IDs. If you specify Y, the KGL_WTO=YES parameter is added to the rhilev.midlev.rtename.RKANPARU(KPPENV) member. The default is N for the Configuration Tool and YES for PARMGEN. Note: The existence of the KGL_WTO= parameter triggers the startup console messages. Therefore this parameter must not be present in the KPPENV member if you do not want this feature enabled. When it is enabled after configuration, the parameter is added to the KPPENV member. If you want to turn it off again, you must regenerate the Configuration Tool PP#3xxx job created in the monitoring agent "Create runtime members" step to refresh PP3ENV, where xxx is the JCL suffix. If you configured using PARMGEN, you can edit the configuration profile and recycle the monitoring agent. Related parameters None KPP_AGT_KLX_TCP_TOLERATERECYCLE Use the KPP_AGT_KLX_TCP_TOLERATERECYCLE parameter to determine whether the monitoring agent address space reconnects to its TCP/IP stack without being recycled after the stack is recycled. Required or optional Optional Location where the parameter value is stored In the KPPINTCP member of the rhilev.midlev.rtename.RKANPARU library Parameter name TCP/IP_USERID=’&tcpip_stc’ TOLERATERECYCLE Default value N Permissible values Y, N In the Configuration Tool (ICAT) Chapter 2. Common agent (KPP) parameters 17 Panel name Specify Advanced Agent Configuration Values Panel ID KAG62P5 Field Reconnect after TCP/IP recycle Batch parameter name KPP_AGT_KLX_TCP_RECYCLE PARMGEN name KPP_AGT_KLX_TCP_TOLERATERECYCLE PARMGEN classification Advanced Agent configuration values Description Reconnect after TCP/IP recycle The parameter determines whether the monitoring agent address space reconnects to its TCP/IP stack without being recycled after the stack is recycled. Set this parameter to Y to allow the monitoring agent address space to reconnect to the z/OS Communications Server without having to subsequently recycle the address space. When this parameter is set to Y, the "TOLERATERECYCLE" keyword is added in the KPPINTCP member of the RKANPARU library. The parameter line is generated as: TCP/IP_USERID=&tcp_userid TOLERATERECYCLE. If this parameter is set to N, when the z/OS Communications Server is recycled, the monitoring agent address space must also be recycled to establish connectivity to TCP/IP. The default is N for the Configuration Tool and TOLERATERECYCLE (meaning yes) for PARMGEN. Note: This parameter may be specified only when the monitoring agent is reporting to Tivoli Enterprise Monitoring Server V6.2.0 and later versions. Related parameters None KPP_AGT_NSNEWn_VALUE The KPP_AGT_NSNEWn_VALUE parameter specifies the value for a nonstandard parameter (a parameter that is not presented in a Configuration Tool interactive panel). Required or optional Optional Attention: Use extreme caution in specifying nonstandard parameters. No error-checking is provided at present. Syntax is not validated. The presence of the data set and member specified is not validated. If faulty syntax or other errors cause your edits to fail, no warning or error message is issued. Use this facility only under the guidance of IBM Software Support. Location where the parameter value is stored Data set, member, and parameter specified in the “KPP_AGT_NONSTDn_MBR” on page 20, “KPP_AGT_NONSTDn_DSN” on page 19, and “KPP_AGT_NONSTDn_PARM” on page 21 parameters, respectively. In the Configuration Tool (ICAT) Panel name Specify Nonstandard Parameters Panel ID KAGPNSTn 18 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Field New Value Default value None Permissible values Character string, maximum length 50 Batch parameter name KPP_NSNEWn_VALUE Description Value for a nonstandard parameter (a parameter that is not presented in a Configuration Tool interactive panel). In specifying the value, be sure to include format characters. For example, if the format in the runtime member is parameter=value, precede the value with an equal sign; or if the format is parameter(value), surround the value with parentheses. If you want to delete an existing parameter that is specified in “KPP_AGT_NONSTDn_PARM” on page 21, leave the value of the corresponding KPP_NSNEWnn_VALUE parameter blank. Each KPP_NSNEWnn_VALUE parameter has a unique name, in which nn represents a number between 1 and 6, corresponding to the number set for “KPP_AGT_NONSTDn_PARM” on page 21. For more information about specifying nonstandard parameters, see the "Parameters" section of the IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Related parameters v “KPP_AGT_NONSTDn_DSN” v “KPP_AGT_NONSTDn_MBR” on page 20 v “KPP_AGT_NONSTDn_PARM” on page 21 KPP_AGT_NONSTDn_DSN The KPP_AGT_NONSTDn_DSN parameter specifies the low-level qualifier of the data set containing the member with the parameter to be added, replaced, or deleted by specifying a nonstandard parameter (a parameter that is not presented in a Configuration Tool interactive panel). Required or optional Optional Attention: Use extreme caution in specifying nonstandard parameters. No error-checking is provided at present. Syntax is not validated. The presence of the data set and member specified is not validated. If faulty syntax or other errors cause your edits to fail, no warning or error message is issued. Use this facility only under the guidance of IBM Software Support. Location where the parameter value is stored Member specified in the “KPP_AGT_NONSTDn_MBR” on page 20 parameter In the Configuration Tool (ICAT) Panel name Specify Nonstandard Parameters Panel ID KAGPNSTn Field Low-level dataset qualifier Default value None Chapter 2. Common agent (KPP) parameters 19 Permissible values Character string, maximum length 8 Batch parameter name KPP_AGT_NONSTDn_DSN Description Low-level dataset qualifier This parameter specifies the low-level qualifier of the data set containing the member with the parameter to be added, replaced, or deleted by specifying a nonstandard parameter (a parameter that is not presented in a Configuration Tool interactive panel). Each “KPP_AGT_NONSTDn_DSN” on page 19 parameter has a unique name, in which n represents a number between 1 and 6, corresponding to the number set for “KPP_AGT_NONSTDn_PARM” on page 21. For more information about specifying nonstandard parameters, see the "Parameters" section of the IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Related parameters None KPP_AGT_NONSTDn_MBR The KPP_AGT_NONSTDn_MBR parameter specifies the name of the name of the KPP_AGT_NONSTDn_DSN data set member that contains the parameter to be added, replaced, or deleted by specifying a nonstandard parameter (a parameter that is not presented in a Configuration Tool interactive panel). Required or optional Optional Attention: Use extreme caution in specifying nonstandard parameters. No error-checking is provided at present. Syntax is not validated. The presence of the data set and member specified is not validated. If faulty syntax or other errors cause your edits to fail, no warning or error message is issued. Use this facility only under the guidance of IBM Software Support. Location where the parameter value is stored Member specified in this parameter, in the data set specified in the “KPP_AGT_NONSTDn_DSN” on page 19 parameter In the Configuration Tool (ICAT) Panel name Specify Nonstandard Parameters Panel ID KAGPNSTn Field Member Default value None Permissible values Character string, maximum length 8 Batch parameter name KPP_NONSTDnn_MBR Description Name of the “KPP_AGT_NONSTDn_DSN” on page 19 data set member that contains the 20 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference parameter to be added, replaced, or deleted by specifying a nonstandard parameter (a parameter that is not presented in a Configuration Tool interactive panel). The asterisk (*) wildcard character can be used as a suffix in column 4, 5, 6, 7, or 8 of the member name (provided that column is the final one in the name). Each KPP_NONSTDnn_MBR parameter has a unique name, in which nn represents a number between 1 and 6, corresponding to the number set for “KPP_AGT_NONSTDn_PARM.” For more information about specifying nonstandard parameters, see the "Parameters" section of the IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Related parameters None KPP_AGT_NONSTDn_PARM The KPP_AGT_NONSTDn_PARM parameter specifies the name of the configuration parameter to be added, replaced, or deleted. Required or optional Optional Attention: Use extreme caution in specifying nonstandard parameters. No error-checking is provided at present. Syntax is not validated. The presence of the data set and member specified is not validated. If faulty syntax or other errors cause your edits to fail, no warning or error message is issued. Use this facility only under the guidance of IBM Software Support. Location where the parameter value is stored Data set and member specified in the “KPP_AGT_NONSTDn_MBR” on page 20 and “KPP_AGT_NONSTDn_DSN” on page 19 parameters, respectively In the Configuration Tool (ICAT) Panel name Specify Nonstandard Parameters Panel ID KAGPNSTn Field Parameter Default value None Permissible values Character string, maximum length 40 Batch parameter name KPP_AGT_NONSTDn_PARM Description Name of the configuration parameter to be added, replaced, or deleted. You can specify up to 6 nonstandard parameters (parameters that are not presented in the Configuration Tool interactive panels). Each nonstandard parameter has a unique name in which nn represents a number between 1 and 6. For more information about specifying nonstandard parameters, see the "Parameters" section of the IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Chapter 2. Common agent (KPP) parameters 21 Related parameters None KPP_AGT_NSOLDn_VALUE The KPP_AGT_NSOLDn_VALUE parameter specifies the existing value to be replaced or deleted in the parameter definition corresponding to KPP_AGT_NONSTDN_PARM. Required or optional Optional Attention: Use extreme caution in specifying nonstandard parameters. No error-checking is provided at present. Syntax is not validated. The presence of the data set and member specified is not validated. If faulty syntax or other errors cause your edits to fail, no warning or error message is issued. Use this facility only under the guidance of IBM Software Support. Location where the parameter value is stored Replaced in the data set, member, and parameter specified in the “KPP_AGT_NONSTDn_MBR” on page 20, “KPP_AGT_NONSTDn_DSN” on page 19, and “KPP_AGT_NONSTDn_PARM” on page 21 parameters, respectively. In the Configuration Tool (ICAT) Panel name Specify Nonstandard Parameters Panel ID KAGPNSTn Field Old Value (if replacing) Default value None Permissible values Character string, maximum length 50 Batch parameter name KPP_AGT_NSOLDn_VALUE Description Existing value to be replaced or deleted in the parameter definition corresponding to “KPP_AGT_NONSTDn_PARM” on page 21. The character string that you specify must match exactly the existing value for the parameter in the runtime member, or the value is not replaced. For example, if the format in the runtime member is parameter=value, precede the value with an equal sign; or if the format is parameter(value), surround the value with parentheses. Each KPP_NSOLDnn_VALUE parameter has a unique name, in which nn represents a number between 1 and 6, corresponding to the number set for “KPP_AGT_NONSTDn_PARM” on page 21. For more information about specifying nonstandard parameters, see the "Parameters" section of the IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Related parameters “KPP_AGT_NONSTDn_PARM” on page 21 KPP_AGT_PARTITION_NAME The KPP_AGT_PARTITION_NAME parameter specifies the partition name that identifies the location of this monitoring server (TEMS namespace) relative to the firewalls used for address translation. 22 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Required or optional Optional Location where the parameter value is stored In the KPPENV member of the rhilev.midlev.rtename.RKANPARU library Parameter name KDC_PARTITION= (Agent IP.PIPE partition name) Default value None Permissible values Character string, maximum length 32 In the Configuration Tool (ICAT) Panel name SPECIFY AGENT IP.PIPE CONFIGURATION VALUES Panel ID KAG62P2C Field Partition name Default value None Permissible values Character string, maximum length 32 Batch parameter name KPP_AGT_PIPE_NAME PARMGEN name KPP_AGT_PARTITION_NAME PARMGEN classification If the Agent requires address translation support Description Agent IP.PIPE partition name This parameter specifies the partition name that identifies the location of this monitoring server (TEMS namespace) relative to the firewalls used for address translation. Note: The Tivoli Enterprise Monitoring Server that this monitoring agent connects to must have a corresponding partition reference entry. This parameter is put into the partition table that contains labels and associated socket addresses that are provided by the firewall administrator. The labels in the partition table are configured into and used by IBM products on an external network, outside a firewall, during the Tivoli Enterprise Monitoring Server (TEMS) connection establishment phase. The first part of this connection establishment is the lb lookup, which requires that the location brokers return the socket address of the monitoring agent. The partition table is used by the brokers, matching a partition name for a client to the labels in the partition table. On a match, the associated socket address in the partition table is returned to the client outside the firewall. This socket address is used by the IBM products to traverse the firewall and connect to the monitoring server. Each entry consists of a label or partition name, a protocol (IP for UDP or IP.PIPE for TCP), and a host name or dotted-decimal IP address. The well-known port (Hub port) must be authorized by the firewall administrator. Chapter 2. Common agent (KPP) parameters 23 v If UDP is the protocol configured in the partition table, then a range of (UDP) ports must be authorized by the firewall administrator (in addition to the well-known port). v If TCP is the protocol, no additional ports other than the well-known TEMS port need be authorized. Related parameters None KPP_AGT_PPI_RECEIVER The KPP_AGT_PPI_RECEIVER parameter specifies the Program-to-Program Interface (PPI) values that enable the monitoring agent to forward Take Action commands to IBM Tivoli NetView® for z/OS V5.2, or later. Required or optional Required if the monitoring agent will be forwarding Take Action commands to the IBM Tivoli NetView for z/OS Program-to-Program Interface (PPI). Location where the parameter value is stored In the KPPENV member of the rhilev.midlev.rtename.RKANPARU library Parameter name KGLHC_PPI_RECEIVER= (NetView for z/OS PPI receiver) Default value This value defaults to the IBM Tivoli NetView for z/OS PPI receiver used by the server if one is configured in this RTE. Otherwise, specify the default of CNMPCMDR. Permissible values Character string, maximum length 8 In the Configuration Tool (ICAT) Panel name Specify Advanced Agent Configuration Values Panel ID KAG62P5 Field NetView PPI receiver Default value This value defaults to the IBM Tivoli NetView for z/OS PPI receiver used by the server if one is configured in this RTE. Otherwise, specify the default of CNMPCMDR. Permissible values Character string, maximum length 8 Batch parameter name KPP_AGT_PPI_RECEIVER PARMGEN name KPP_AGT_PPI_RECEIVER PARMGEN classification Take Action commands security settings Description NetView for z/OS PPI receiver The parameter specifies the Program to Program Interface (PPI) values that enable the monitoring agent to forward Take Action commands to IBM Tivoli NetView for z/OS V5.2, or later. The Tivoli Enterprise Portal user ID is passed to Tivoli NetView for z/OS. 24 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Specify the name of the PPI receiver on IBM Tivoli NetView for z/OS that will receive Take Action commands. If the specified name is invalid or the receiver is not active on Tivoli NetView for z/OS, default (MGCR) command routing is performed. The value should 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: v dollar sign ($) v percent sign (%) v ampersand (&) v number sign (#) This value must match the xyz value coded on statement AUTOTASK.?APSERV.InitCmd = APSERV xyz" in the Tivoli NetView DSIPARM initialization member, CNMSTYLE. The Configuration Tool generates the KGLHC_PPI_RECEIVER parameter in the KPPENV member of the rhilev.midlev.rtename.RKANPARU library. This value defaults to the Tivoli NetView for z/OS PPI receiver used by the Server if one is configured in this RTE. Otherwise, specify the default of CNMPCMDR. See the Tivoli NetView for z/OS online help for command APSERV for more details. To enable this function, specify a value on the KPP_AGT_PPI_RECEIVER parameter. Ensure that the parameter is not commented out and the value is enclosed in double quotation marks (""). To disable this function, simply comment out the parameter with asterisks ('**'). For complete instructions, see the "Configuring NetView authorization of z/OS commands" section of IBM Tivoli Monitoring: Configured Tivoli Enterprise Monitoring Server on z/OS. Related parameters None KPP_AGT_PPI_SENDER The KPP_AGT_PPI_SENDER parameter specifies the Program-to-Program Interface (PPI) values that enable the monitoring agent to forward Take Action commands to IBM Tivoli NetView for z/OS V5.2, or later. Required or optional Required if the monitoring agent will be forwarding Take Action commands to the IBM Tivoli NetView for z/OS Program-to-Program Interface (PPI). Location where the parameter value is stored In the KPPENV member of the rhilev.midlev.rtename.RKANPARU library Parameter name KGLHC_PPI_SENDER (Agent PPI sender) Default value None Permissible values Character string, maximum length 8 In the Configuration Tool (ICAT) Panel name Specify Advanced Agent Configuration Values Panel ID KAG62P5 Field Agent PPI sender Default value None Chapter 2. Common agent (KPP) parameters 25 Permissible values Character string, maximum length 8 Batch parameter name KPP_AGT_PPI_SENDER PARMGEN name KPP_AGT_PPI_SENDER PARMGEN classification Take Action commands security settings Description Agent PPI sender The parameter specifies the Program to Program Interface (PPI) values that enable the monitoring agent to forward Take Action commands to IBM Tivoli NetView for z/OS V5.2, or later. The Tivoli Enterprise Portal user ID gets passed to IBM Tivoli NetView for z/OS. Specify the optional name of the PPI sender. The value should be a 1-8 character, unique identifier for the sender 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 name should not conflict with any NetView for z/OS domain name, as it is used in logging the command and command response in the NetView for z/OS log. If a value is specified on this field, the Configuration Tool generates the KGLHC_PPI_SENDER parameter in the KPPENV member of the rhilev.midlev.rtename.RKANPARU library. If a value is not specified on this field, the default is the current monitoring agent jobname that is the source of the command. For complete instructions, see the "Configuring NetView authorization of z/OS commands" section of IBM Tivoli Monitoring: Configured Tivoli Enterprise Monitoring Server on z/OS. Related parameters None KPP_AGT_STC Use the KPP_AGT_STC parameter to specify the started task name for the agent. Required or optional Required if you configure the monitoring agent in its own address space Location where the parameter value is stored Value becomes the name of the monitoring agent started task procedure member in the rhilev.midlev.rtename.RKANSAMU library for stand-alone agents. Parameter name N/A Default value CANSPP Permissible values Character string, maximum length 8 In the Configuration Tool (ICAT) Panel name SPECIFY AGENT ADDRESS SPACE PARAMETERS Panel ID KAG62P2 Field 26 Agent started task IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Default value CANSPP Permissible values Character string, maximum length 8 Batch parameter name KPP_AGT_STC PARMGEN name KPP_AGT_STC PARMGEN classification Values that describe the address space Description Agent started task name This parameter specifies the started task name for the agent. This started task must be copied to your system procedure library. The default is CANSPP. The Configuration Tool created started task procedures in rhilev.midlev.rtename.RKANSAMU that you must copy to your started task library. If you have configured an agent address space, copy the monitoring agent started task (the default name is CANSPP) from rhilev.midlev.rtename.RKANSAMU to your started task library (PROCLIB). If you have configured the agent in the TEMS address space, then the TEMS started task procedure will be updated in rhilev.midlev.rtename.RKANSAMU (the default name is CANSDSST) and this started task must be copied to your started task library (PROCLIB). Note: You might also use the sample system copy JCL to copy the system procedures and the VTAM major node members from the rhilev.midlev.rtename.RKANSAMU library to the system libraries (if applicable). The sample JCL can be generated from the RTE Utility option using the Configuration Tool. See the "Copy the started task procedures to your procedure library" task in the agent-specific planning and configuration guide for more information. Related parameters None KPP_AGT_STORAGE_DETAIL_INT_HR Use the KPP_AGT_STORAGE_DETAIL_INT_HR parameter to set the interval to monitor storage. Required or optional Required Location where the parameter value is stored Part of the second EVERY command in the KPPAGST member of the rhilev.midlev.rtename.RKANCMDU library Parameter name EVERY HH:MM:SS STORAGE D (Storage detail logging interval - hours) Default value 0 Permissible values 0 - 24 In the Configuration Tool (ICAT) Chapter 2. Common agent (KPP) parameters 27 Panel name Specify Advanced Agent Configuration Values Panel ID KAG62P5 Field Storage detail logging: Hours Default value 0 Permissible values 0 - 24 Batch parameter name KPP_AGT_STOR_DTL_INT_HR PARMGEN name KPP_AGT_STORAGE_DETAIL_INT_HR PARMGEN classification Advanced Agent configuration values Description Storage detail logging interval - hours This parameters sets the interval to monitor storage. The interval values are written as part of the second EVERY command in: rhilev.midlev.rtename.RKANCMDU(KPPAGST) The default is 0 hours (hh) and 60 minutes (mm). Related parameters None KPP_AGT_STORAGE_DETAIL_INT_MIN Use the KPP_AGT_STORAGE_DETAIL_INT_MIN parameter to set the interval to monitor storage. Required or optional Required Location where the parameter value is stored Part of the second EVERY command in the KPPAGST member of the rhilev.midlev.rtename.RKANCMDU library Parameter name EVERY HH:MM:SS STORAGE D (Storage detail logging interval - minutes) Default value 60 Permissible values 0 - 60 In the Configuration Tool (ICAT) Panel name Specify Advanced Agent Configuration Values Panel ID KAG62P5 Field Storage detail logging: Minutes Default value 60 28 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Permissible values 0 - 60 Batch parameter name KPP_AGT_STOR_DTL_INT_MIN PARMGEN name KPP_AGT_STORAGE_DETAIL_INT_MIN PARMGEN classification Advanced Agent configuration values Description Storage detail logging interval - minutes This parameters sets the interval to monitor storage. The interval values are written as part of the second EVERY command in: rhilev.midlev.rtename.RKANCMDU(KPPAGST) The default is 0 hours (hh) and 60 minutes (mm). Related parameters None KPP_AGT_STORAGE_MINIMUM_EXTEND Use the KPP_AGT_STORAGE_MINIMUM_EXTEND parameter to specify the amount of virtual storage the monitoring agent must acquire to run at your site. Required or optional Required Location where the parameter value is stored In the KPPSYSIN member of the rhilev.midlev.rtename.RKANPARU library Parameter name MINIMUM (256000,X) (Minimum extended storage) Default value 256000 Permissible values 0 - 9999999 In the Configuration Tool (ICAT) Panel name Specify Advanced Agent Configuration Values Panel ID KAG62P5 Field Minimum extended storage Default value 256000 Permissible values 0 - 9999999 Batch parameter name KPP_AGT_STOR_MIN_EXT PARMGEN name KPP_AGT_STORAGE_MINIMUM_EXTEND Chapter 2. Common agent (KPP) parameters 29 PARMGEN classification Advanced Agent configuration values Description Minimum extended storage This parameter specifies the amount of virtual storage the monitoring agent must acquire to run at your site. The default is 256000. Related parameters None KPP_AGT_TCP_HOST Use the KPP_AGT_TCP_HOST parameter to specify the hostname of the system that the agent is running on. Required or optional Optional. This field is required if you plan to have this agent communicate with Tivoli Enterprise Monitoring Server using TCP/IP. Location where the parameter value is stored KDCSSITE member of the rhilev.midlev.rtename.RKANPARU library Parameter name N/A Default value Value set for the RTE_TCP_HOST parameter for the runtime environment Permissible values Character string, maximum length 32 In the Configuration Tool (ICAT) Panel name v SPECIFY AGENT IP.UDP CONFIGURATION VALUES (KAG62P2B) v SPECIFY AGENT IP.PIPE CONFIGURATION VALUES (KAG62P2C) Panel ID v KAG62P2B (IP.UDP) v KAG62P2C (IP.PIPE) Field Network address (Hostname): Default value Value set for the RTE_TCP_HOST parameter for the runtime environment Permissible values Character string, maximum length 32 Batch parameter name KPP_AGT_TCP_HOST PARMGEN name KPP_AGT_TCP_HOST PARMGEN classification Agent's local TCP/IP information Description Agent TCP/IP hostname 30 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference This parameter specifies the hostname of the system that the agent is running on. This value is the TCP/IP host name or dotted decimal IP address of the z/OS system where the hub monitoring server is installed. To obtain the host name or IP address, enter TSO HOMETEST at the command line. If the z/OS domain name resolver configuration specifies a search path that includes the target domain suffix, specify only the first qualifier of the host name. (Example: sys is the first qualifier of the fully qualified host name sys.ibm.com.) Otherwise, specify the fully qualified host name. This field is required if you plan to have this agent communicate with the server using TCP/IP. Related parameters None KPP_AGT_TCP_KDEB_INTERFACELIST Use the KPP_AGT_TCP_KDEB_INTERFACELIST parameter to specify a list of network interfaces you want the monitoring agent to use. If the agent requires network interface list support and your site runs more than one TCP/IP interface or network adapter on the same z/OS image, you can specify network interfaces to be used by monitoring servers and monitoring agents running on a z/OS system. You specify the network interfaces in the IP communication protocol parameters for each component. Note: Specify !* as the value if this agent runs on the same candidate z/OS image where a High Availability (HA) Hub TEMS is running. Required or optional Optional Location where the parameter value is stored In the KPPENV member of the rhilev.midlev.rtename.RKANPARU library Parameter name and syntax KDEB_INTERFACELIST=%KPP_AGT_TCP_KDEB_INTERFACELIST Default value None Permissible values Character string, maximum length 44 In the Configuration Tool (ICAT) Panel name v SPECIFY AGENT IP.UDP CONFIGURATION VALUES (KAG62P2B) v SPECIFY AGENT IP.PIPE CONFIGURATION VALUES (KAG62P2C) Panel ID v KAG62P2B (for IP.UDP) v KAG62P2C (for IP.PIPE) Field Network interface list Default value None Permissible values Character string, maximum length 44 Batch parameter name KPP_AGT_TCP_KDEBLST PARMGEN name KPP_AGT_TCP_KDEB_INTERFACELIST Chapter 2. Common agent (KPP) parameters 31 PARMGEN classification If the Agent requires network interface list support Description TCP/IP network interface list This parameter 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. Setting this parameter allows you to direct the monitoring agent to connect to a specific TCP/IP local interface. Specify the network adapters as one or more of the following values: v A fully-qualified hostname, for example sys.ibm.com v The first qualifier of the fully-qualified hostname, for example sys from sys.ibm.com v An IPv4 address in dotted decimal notation, for example 9.67.1.100 If your site supports DNS, you can enter the short hostname or an IP address. If your site does not support DNS, you must enter the fully qualified hostname. This field is only applicable for networks with multiple interface cards for which a specific output network interface list is required. If an interface address or a list of interface addresses is specified, the Configuration Tool generates the KDEB_INTERFACELIST parameter in the KPPENV member of the rhilev.midlev.rtename.RKANPARU library. Note: This value defaults to the IPv4 network interface list setting used by the Tivoli Enterprise Monitoring Server if one is configured in this IPL16 RTE. Also, separate the entries using a blank space between interface addresses. For example: ==> 129.0.131.214 SYS1 SYS.IBM.COM In addition, special considerations apply when specifying !<&value> or * for this field. Type README COM on the command line when you are in the Configuration Tool to see more information about network interface list considerations and usage. Related parameters v “KDS_TEMS_TYPE” on page 232 v “KDS_TEMS_HA_TYPE” on page 206 v “KDS_TEMS_TCP_KDEB_INTERFACELIST” on page 222 KPP_AGT_TCP_STC Use the KPP_AGT_TCP_STC parameter to specify the name of the TCP/IP started task running on the monitoring agent host. Required or optional Optional. Required if you plan to have this agent communicate with Tivoli Enterprise Monitoring Server using TCP/IP. Location where the parameter value is stored In the KPPINTCP member of the rhilev.midlev.rtename.RKANPARU library Parameter name TCP/IP_USERID=’*’ (TCP/IP started task) Default value * Permissible values Character string, maximum length 8 32 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference In the Configuration Tool (ICAT) Panel name v SPECIFY AGENT IP.UDP CONFIGURATION VALUES (KAG62P2B) v SPECIFY AGENT IP.PIPE CONFIGURATION VALUES (KAG62P2C) Panel ID v KAG62P2B (IP.UDP) v KAG62P2C (IP.PIPE) Field Started task Default value * Permissible values Character string, maximum length 8 Batch parameter name KPP_AGT_TCP_STC PARMGEN name KPP_AGT_TCP_STC PARMGEN classification Agent's local TCP/IP information Description TCP/IP started task This parameter specifies the name of the TCP/IP started task running on the monitoring agent host. This a required field if you plan to have this agent communicate with the server using TCP/IP. This parameter identifies the TCP/IP stack to be used. If the LPAR contains a single TCP/IP stack, accept the default value of an asterisk (*), which uses the first TCP/IP stack that was started. If the LPAR contains more than one TCP/IP stack, specify the started task name of the TCP/IP stack you want to use. Alternatively, you can specify the number sign (#), which is translated to a blank and allows the TCP/IP environment to choose the stack to use, either through TCP/IP definitions or through the use of the SYSTCPD DD statement. Whichever method is used to select a TCP/IP stack in a multi-stack environment, the Tivoli Management Services components continue to use that stack, even if a different stack becomes the primary stack. Therefore, in a multi-stack environment, it is best to specify the started task name of the TCP/IP stack to be used, rather than specifying a wildcard or a blank. Related PARMGEN CONFIG profile parameters v “GBL_DSN_TCP_SYSTCPD_TCPDATA” on page 101 v “KDS_X_STC_SYSTCPD_INCLUDE_FLAG” on page 245 KPP_AGT_TEMA_SDA This parameter indicates whether the agent has enabled the self-describing agent (SDA) function in the agent address space. Required or optional Required Location where the parameter value is stored KppENV member of the rhilev.rte.RKANPARU library for the agent’s runtime environment. Chapter 2. Common agent (KPP) parameters 33 Parameter name and syntax TEMA_SDA=%Kpp_AGT_TEMA_SDA% Default value Y Permissible values Y, N In the Configuration Tool (ICAT) Panel name Specify Advanced Agent Configuration Values Panel ID KAG62P5 Field Enable Self-Describing Agent processing Default value Y Permissible values Y, N Batch parameter name Kpp_AGT_TEMA_SDA PARMGEN name Kpp_AGT_TEMA_SDA Description This parameter indicates whether the agent has enabled the self-describing agent (SDA) function in the agent address space. Related parameters v “GBL_HFS_JAVA_DIRn” on page 103 v “GBL_DSN_SYS1_SBPXEXEC” on page 97 v “RTE_USS_RTEDIR” on page 146 v “KDS_KMS_SDA” on page 167 v “KDS_TEMA_SDA” on page 196 KPP_AGT_TEMS_NAME_NODEID Use the KPP_AGT_TEMS_NAME_NODEID parameter to specify the primary Tivoli Enterprise Monitoring Server values for configuring an agent in its own address space. Required or optional Optional Location where the parameter value is stored In the KPPENV member in the rhilev.midlev.rtename.RKANPARU library Parameter name and syntax CT_CMSLIST=%KPP_AGT_TEMS_NAME_NODEID Default value &rtename:CMS Permissible values A string of up to 8 case-sensitive characters defining the node ID of the Tivoli Enterprise Monitoring Server to which you are connecting the agent. In the Configuration Tool (ICAT) 34 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Panel name Specify Agent Primary TEMS Values Panel ID KAG62P1 Field TEMS Name This value is created if you specify use of a local Tivoli Enterprise Monitoring Server (TEMS) on the same system where you created the runtime environment (RTE). This field is prefilled if you specified a local monitoring server on z/OS and cannot be changed. Default value No default Permissible values A string of up to 8 case-sensitive characters defining the node ID of the Tivoli Enterprise Monitoring Server to which you are connecting the agent. Batch parameter name KPP_AGT_TEMS_NAME_NODEID PARMGEN name KPP_AGT_TEMS_NAME_NODEID PARMGEN classification Values that describe the primary TEMS this agent will connect to: specify the primary TEMS (Kpp_TEMS_TCP_* and Kpp_TEMS_VTAM_*) parameter values that the agent will connect to. Related parameters v “KPP_TEMS_NAME_NODEID” on page 55 Related PARMGEN CONFIG profile parameters Kpp_TEMS_BKUP1_* Agent's backup TEMS parameter values. The agent's primary and backup TEMS parameter values are used in the CT_CMSLIST parameter in the agent's xKANPARU(KppENV) member. KPP_AGT_VIRTUAL_IP_ADDRESS Use the KPP_AGT_VIRTUAL_IP_ADDRESS parameter to set this parameter to the type of VIPA defined for this z/OS system. Required or optional Required Location where the parameter value is stored The parameter value is not stored, but is used for internal processing. Parameter name AGVIPA (VIPA type for the z/OS system) Default value N Permissible values S (static), D (dynamic), or N (none) In the Configuration Tool (ICAT) Panel name Specify Advanced Agent Configuration Values Chapter 2. Common agent (KPP) parameters 35 Panel ID KAG62P5 Field Virtual IP Address (VIPA) type Default value N Permissible values S (static), D (dynamic), or N (none) Batch parameter name KPP_AGT_VIPA PARMGEN name KPP_AGT_VIRTUAL_IP_ADDRESS PARMGEN classification Advanced Agent configuration values Description VIPA type for the z/OS system Set this parameter to the type of VIPA defined for this z/OS system. If the monitoring agent address space is a VIPA-defined application, specify if the VIPA definition is Static or Dynamic. If VIPA is in use, the VIPA name is resolvable through the Domain Name Server (DNS). Note: The IP.PIPE protocol is required when dynamic VIPA is in use. Related parameters None KPP_AGT_VTAM_APPL_AA Use the KPP_AGT_VTAM_APPL_AA parameter to specify the Alert Adapter application identifier for the agent address space. Required or optional Required Location where the parameter value is stored In the VTAM® major node (CTDPPN is the default) member of the of the rhilev.midlev.rtename.RKANSAMU library Parameter name N/A Default value CTDPPAA Permissible values A valid applid name no longer than 8 characters in length In the Configuration Tool (ICAT) Panel name SPECIFY VTAM APPLID VALUES Panel ID KAG62P6 Field VTAM applid for Alert Adapter Default value CTDPPAA 36 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Permissible values A valid applid name no longer than 8 characters in length Batch parameter name KPP_AGT_VTM_APPL_AA PARMGEN name KPP_AGT_VTAM_APPL_AA Description VTAM applid for Alert Adapter This parameter specifies the Alert Adapter application identifier for the agent address space. This value is normally specified in “KPP_AGT_VTAM_APPL_PREFIX” on page 39, with the characters AA appended to it. Related parameters None KPP_AGT_VTAM_APPL_KPPINVPO Use the KPP_AGT_VTAM_APPL_KPPINVPO parameter to specify the VPO VTAM application identifier for the agent address space. Required or optional Required Location where the parameter value is stored In the CTDPPN member of the of the rhilev.midlev.rtename.RKANSAMU library Parameter name N/A Default value CTDPPVP Permissible values A valid applid name no longer than 8 characters in length In the Configuration Tool (ICAT) Panel name SPECIFY VTAM APPLID VALUES Panel ID KAG62P6 Field TMS:Engine VTAM program operator Default value CTDPPVP Batch parameter name KPP_AGT_VTM_APPL_VPO PARMGEN name KPP_AGT_VTAM_APPL_KPPINVPO PARMGEN classification Agent applids Description VTAM applid for VPO interface Chapter 2. Common agent (KPP) parameters 37 This parameter specifies the VPO VTAM application identifier for the agent address space. This value is normally specified in “KPP_AGT_VTAM_APPL_PREFIX” on page 39, with the characters VP appended to it. Related parameters None KPP_AGT_VTAM_APPL_NCS Use the KPP_AGT_VTAM_APPL_NCS parameter to specify the Network Computing System (NCS) application identifier for the agent address space. Required or optional Required Location where the parameter value is stored In the CTDPPN member of the of the rhilev.midlev.rtename.RKANSAMU library Parameter name N/A Default value CTDPPNC Permissible values A valid node name no more than 8 characters in length In the Configuration Tool (ICAT) Panel name SPECIFY VTAM APPLID VALUES Panel ID KAG62P6 Field Agent to TEMS connection Default value CTDPPNC Batch parameter name KPP_AGT_VTM_APPL_NCS PARMGEN name KPP_AGT_VTAM_APPL_NCS PARMGEN classification Agent applids Description Agent to server connection applid This parameter specifies the Network Computing System (NCS) application identifier for the agent address space. This value is normally specified in “KPP_AGT_VTAM_APPL_PREFIX” on page 39, with the characters NC appended to it. Related parameters v “KPP_AGT_VTAM_APPL_PREFIX” on page 39 KPP_AGT_VTAM_APPL_OPERATOR Use the KPP_AGT_VTAM_APPL_OPERATOR parameter to specify the operator VTAM application identifier for the agent address space. 38 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Required or optional Required Location where the parameter value is stored In the CTDPPN member of the of the rhilev.midlev.rtename.RKANSAMU library Parameter name N/A Default value CTDPPOR Permissible values A valid applid name no longer than 8 characters in length In the Configuration Tool (ICAT) Panel name SPECIFY VTAM APPLID VALUES Panel ID KAG62P6 Field TMS:Engine (non-CUA) Default value CTDPPOR Batch parameter name KPP_AGT_VTM_APPL_OPR PARMGEN name KPP_AGT_VTAM_APPL_OPERATOR PARMGEN classification Agent applids Description VTAM applid for non-CUA operator This parameter specifies the operator VTAM application identifier for the agent address space. This is normally the value specified in “KPP_AGT_VTAM_APPL_PREFIX,” with the characters OR appended to it. Related parameters None KPP_AGT_VTAM_APPL_PREFIX Use the KPP_AGT_VTAM_APPL_PREFIX parameter to build the VTAM applids for the agent. Required or optional Required for SNA communications Location where the parameter value is stored The VTAMLST definition is created in the rhilev.midlev.rtename.RKANSAMU library. Copy this definition to your SYS1.VTAMLST library. Parameter name VTAMLST Default value CTDPP Chapter 2. Common agent (KPP) parameters 39 Permissible values A character string of up to 6 characters In the Configuration Tool (ICAT) Panel name Specify Configuration Values/ RTE: rtename Panel ID KAG62P2A Field Applid prefix Default value CTDPP Permissible values A character string of up to 6 characters Batch parameter name KPP_AGT_VTM_APPL_PREF PARMGEN name KPP_AGT_VTAM_APPL_PREFIX PARMGEN classification Agent applids Description Agent Applid prefix This parameter is a prefix that is used to build the VTAM applids for the agent. This is a required field if you plan to have the monitoring agent communicate with the server using VTAM. This parameter specifies the applid prefix to establish the VTAM node and applid list. The product creates a customized VTAMLST definition in the rhilev.midlev.rtename.RKANSAMU library, which you then copy to your SYS1.VTAMLST library after the Configuration Tool work is complete. The default is CTDPP. Note: 1. Each product requires its own set of IDs. Make sure that the product identifiers are unique. Type README APP on the command line from the Configuration Tool to get more information about how the Configuration Tool processes VTAM applids. Use the F6=Applids key to specify the VTAM major node and applid values. 2. If System Variable support is enabled, type README SYS on the command line from the Configuration Tool to get more information on how the Configuration Tool processes VTAM applids using MVS™ system symbols. 3. Do not confuse this value with “KPP_AGT_VTAM_NODE,” the value for specifying the VTAM major node. Related parameters None KPP_AGT_VTAM_NODE Use the KPP_AGT_VTAM_NODE parameter to specify the name that will be used to build the VTAM node entry for the agent. Required or optional Required for SNA communications Location where the parameter value is stored In the CTDPPN member of the rhilev.midlev.rtename.RKANSAMU library 40 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Parameter name XPPAPLN Default value CTDPPN Permissible values A valid node name no more than 8 characters in length In the Configuration Tool (ICAT) Panel name Specify VTAM Applid Values Panel ID KPP41P6 Field Major Node Default value CTDPPN Permissible values A valid node name no more than 8 characters in length Batch parameter name KPP_AGT_VTM_NODE PARMGEN name KPP_AGT_VTAM_NODE PARMGEN classification Agent's local VTAM and logon information Description Agent node name This parameter specifies the name that will be used to build the VTAM node entry for the agent. This is a required field if you plan to have the agent communicate with the server using VTAM. Specify the name of the VTAM major node name that contains all the VTAM APPLID definitions for OMEGAMON XE for Mainframe Networks. This member must be moved to your VTAMLST concatenation. The name of this major node is also the name used to activate the VTAM APPLIDs. The default is CTDPPN. Related parameters v “RTE_VTAM_GBL_MAJOR_NODE” on page 149 KPP_AGT_WTO_MSG Use the KPP_AGT_WTO_MSG parameter to specify whether you want the monitoring agent address space to issue Write To Operator (WTO) messages. Required or optional Required Location where the parameter value is stored In the KPPSYSIN member of the rhilev.midlev.rtename.RKANPARU library Parameter name WTO(N) (Enable WTO messages) Default value N Chapter 2. Common agent (KPP) parameters 41 Permissible values Y, N In the Configuration Tool (ICAT) Panel name SPECIFY CONFIGURATION VALUES / RTE: rtename Panel ID KAG62P5 Field Enable WTO messages Default value N Permissible values Y, N Batch parameter name KPP_AGT_WTO_MSG PARMGEN name KPP_AGT_WTO_MSG PARMGEN classification Advanced Agent configuration values Description Enable WTO messages Specify Y as the value for this parameter if you want the monitoring agent address space to issue Write To Operator (WTO) messages. WTOs write information and exception condition messages to the operator consoles. Alert messages are always written to the consoles. The default is N. Related parameters None KPP_PD The KPP_PD parameter specifies the beginning and ending syntax markers for the KPP_PD_* group of parameters. Required or optional Required Location where the parameter value is stored The KPPAL member of the rhilev.midlev.rtename.RKANPARU library Parameter name N/A Default value BEGIN Permissible values BEGIN, END In the Configuration Tool (ICAT) This value cannot be updated using the Configuration Tool. Batch parameter name KPP_PD PARMGEN name KPP_PD 42 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference PARMGEN classification Persistent datastore table space allocation overrides Description Specifies the beginning and ending syntax markers for the KPP_PD_* group of parameters. Related parameters v “RTE_PDS_HILEV” on page 121 v “RTE_PDS_KPDPROC_PREFIX” on page 122 v “RTE_PDS_BACKUP_FLAG” on page 118 v “RTE_PDS_BATCHINIT_FLAG” on page 117 v “RTE_PDS_EXPORT_FLAG” on page 119 v “RTE_PDS_EXTRACT_FLAG” on page 120 v “RTE_PDS_FILE_COUNT” on page 120 v “RTE_PDS_SMS_VOLUME” on page 124 v “RTE_PDS_SMS_UNIT” on page 123 v “RTE_PDS_SMS_STORCLAS” on page 123 v “RTE_PDS_SMS_MGMTCLAS” on page 122 v “KPP_PD_CYL” v “KPP_PD_GRP” on page 44 v “KPP_PD_ROW” on page 47 v “KPP_PD_HISTCOLL_DATA_IN_AGT_STC” on page 45 v “KPP_PD_HISTCOLL_DATA_IN_TEMS_STC” on page 46 KPP_PD_CYL Use the KPP_PD_CYL parameter to specify the 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 when the libraries are full. Required or optional Optional Location where the parameter value is stored The KPPAL member of the rhilev.midlev.rtename.RKANPARU library Parameter name DSG3390 (Datastore group space) Default value The Configuration Tool computes this value using a formula using the SIZE, WINDOW, and UNIT TYPE values. The default in batch mode is 290. The default in interactive mode is 261. Permissible values 1 - 9999 In the Configuration Tool (ICAT) Panel name Modify and Review Datastore Specifications Panel ID KPD62PP3 Field Est Cyl Space Default value The Configuration Tool computes this value using a formula using the SIZE, WINDOW, and UNIT TYPE values. The default in batch mode is 290. The default in interactive mode is 261. Chapter 2. Common agent (KPP) parameters 43 Permissible values 1 - 9999 Batch parameter name KPP_PD_CYL PARMGEN name KPP_PD_CYL PARMGEN classification Persistent datastore table space allocation overrides Description Datastore group space The parameter specifies the 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 when the libraries are full. Allocate enough storage so that maintenance procedures are run only once a day. For more information about maintaining the persistent data store, see the IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Related parameters v “RTE_PDS_HILEV” on page 121 v “RTE_PDS_KPDPROC_PREFIX” on page 122 v “RTE_PDS_BACKUP_FLAG” on page 118 v “RTE_PDS_BATCHINIT_FLAG” on page 117 v “RTE_PDS_EXPORT_FLAG” on page 119 v “RTE_PDS_EXTRACT_FLAG” on page 120 v “RTE_PDS_FILE_COUNT” on page 120 v “RTE_PDS_SMS_VOLUME” on page 124 v “RTE_PDS_SMS_UNIT” on page 123 v “RTE_PDS_SMS_STORCLAS” on page 123 v “RTE_PDS_SMS_MGMTCLAS” on page 122 v “KPP_PD” on page 42 v “KPP_PD_GRP” v “KPP_PD_ROW” on page 47 v “KPP_PD_HISTCOLL_DATA_IN_AGT_STC” on page 45 v “KPP_PD_HISTCOLL_DATA_IN_TEMS_STC” on page 46 KPP_PD_GRP Use the KPP_PD_GRP parameter to specify the name of a single persistent data store group. Required or optional Optional Location where the parameter value is stored The KPPPG member of the rhilev.midlev.rtename.RKANPARU library Parameter name PDV1GRP (Datastore group name) Default value KPP Permissible values Character string, maximum length 8 In the Configuration Tool (ICAT) 44 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Panel name Modify and Review Datastore Specifications Panel ID KPD62PP3 Field Datastore group name Default value PP Permissible values Character string, maximum length 8 Batch parameter name KPP_PD_GRP PARMGEN name KPP_PD_GRP PARMGEN classification Persistent datastore table space allocation overrides Description Datastore group name This parameter specifies the name of a single persistent data store group. KPP is the name of the default group. Each group contains the number of data sets specified in the Group Count field. The default for the Group Count field is 3, the minimum. Related parameters v “RTE_PDS_HILEV” on page 121 v “RTE_PDS_KPDPROC_PREFIX” on page 122 v “RTE_PDS_BACKUP_FLAG” on page 118 v “RTE_PDS_BATCHINIT_FLAG” on page 117 v “RTE_PDS_EXPORT_FLAG” on page 119 v “RTE_PDS_EXTRACT_FLAG” on page 120 v “RTE_PDS_FILE_COUNT” on page 120 v “RTE_PDS_SMS_VOLUME” on page 124 v “RTE_PDS_SMS_UNIT” on page 123 v “RTE_PDS_SMS_STORCLAS” on page 123 v “RTE_PDS_SMS_MGMTCLAS” on page 122 v “KPP_PD” on page 42 v “KPP_PD_CYL” on page 43 v “KPP_PD_ROW” on page 47 v “KPP_PD_HISTCOLL_DATA_IN_AGT_STC” v “KPP_PD_HISTCOLL_DATA_IN_TEMS_STC” on page 46 KPP_PD_HISTCOLL_DATA_IN_AGT_STC Use the KPP_PD_HISTCOLL_DATA_IN_AGT_STC parameter to specify that historical collection is being performed by the monitoring agent address space. Required or optional Optional Location where parameter value is stored KppAL, KppPG, KppDEFIN, and KppPCTL members of the rhilev.rte.RKANPARU library for the runtime environment of the Agent Parameter name N/A Chapter 2. Common agent (KPP) parameters 45 Default value Y Permissible values Y, N In the Configuration Tool This flag is set upon selecting the "Configure persistent datastore" option on the Agent menu. Panel name Configure persistent datastore (in Agent) Panel ID KPD62PP0 Field N/A Default value Y Permissible values Y, N Batch parameter name Kpp_PDS_IRA PARMGEN name Kpp_PD_HISTCOLL_DATA_IN_AGT_STC Related parameters v “RTE_PDS_HILEV” on page 121 v “RTE_PDS_KPDPROC_PREFIX” on page 122 v “RTE_PDS_BACKUP_FLAG” on page 118 v “RTE_PDS_BATCHINIT_FLAG” on page 117 v “RTE_PDS_EXPORT_FLAG” on page 119 v “RTE_PDS_EXTRACT_FLAG” on page 120 v “RTE_PDS_FILE_COUNT” on page 120 v “RTE_PDS_SMS_VOLUME” on page 124 v “RTE_PDS_SMS_UNIT” on page 123 v “RTE_PDS_SMS_STORCLAS” on page 123 v “RTE_PDS_SMS_MGMTCLAS” on page 122 v “KPP_PD” on page 42 v “KPP_PD_CYL” on page 43 v “KPP_PD_GRP” on page 44 v “KPP_PD_ROW” on page 47 v “KPP_PD_HISTCOLL_DATA_IN_TEMS_STC” KPP_PD_HISTCOLL_DATA_IN_TEMS_STC Use the KPP_PD_HISTCOLL_DATA_IN_TEMS_STC parameter to specify whether historical collection is being performed by the Tivoli Enterprise Monitoring Server address space. Required or optional Required Location where parameter value is stored KPDAL/KppAL, KPDPG/KppAL, KPDDEFIN, and KPDPCTL members of the rhilev.rte.RKANPARU library for the runtime environment of the TEMS. Parameter name N/A 46 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Default value Y Permissible values Y, N In the Configuration Tool (ICAT) This flag is set upon selecting the "Configure persistent datastore" option on the Agent main menu. Panel name Configure persistent datastore (in TEMS) Panel ID KPD62PP0 Field N/A Default value Y Permissible values Y, N Batch parameter name Kpp_PDS_CMS PARMGEN name Kpp_PD_HISTCOLL_DATA_IN_TEMS_STC Related parameters v “RTE_PDS_HILEV” on page 121 v “RTE_PDS_KPDPROC_PREFIX” on page 122 v “RTE_PDS_BACKUP_FLAG” on page 118 v “RTE_PDS_BATCHINIT_FLAG” on page 117 v “RTE_PDS_EXPORT_FLAG” on page 119 v “RTE_PDS_EXTRACT_FLAG” on page 120 v “RTE_PDS_FILE_COUNT” on page 120 v “RTE_PDS_SMS_VOLUME” on page 124 v “RTE_PDS_SMS_UNIT” on page 123 v “RTE_PDS_SMS_STORCLAS” on page 123 v “RTE_PDS_SMS_MGMTCLAS” on page 122 v “KPP_PD” on page 42 v “KPP_PD_CYL” on page 43 v “KPP_PD_GRP” on page 44 v “KPP_PD_ROW” v “KPP_PD_HISTCOLL_DATA_IN_AGT_STC” on page 45 KPP_PD_ROW Use the KPP_PD_ROW parameter to specify the beginning or end of a single persistent datastore group for the server product. Required or optional Optional Location where the parameter value is stored The KPPPG member of the rhilev.midlev.rtename.RKANPARU library Parameter name PDV1ROW (Row begin group end indicator) Chapter 2. Common agent (KPP) parameters 47 Default value BEGIN Permissible values BEGIN, END In the Configuration Tool (ICAT) This value cannot be updated using the Configuration Tool. Batch parameter name KPP_PD_ROW PARMGEN name KPP_PD_ROW PARMGEN classification Persistent datastore table space allocation overrides Description Row begin group end indicator This parameter indicates the beginning or end of a single persistent datastore group for the server product. If the value is BEGIN, then the variables up to either the next BEGIN or the next END contain all the information required to construct the group information for a single group. If no value is specified, the default is BEGIN. Related parameters v “RTE_PDS_HILEV” on page 121 v “RTE_PDS_KPDPROC_PREFIX” on page 122 v “RTE_PDS_BACKUP_FLAG” on page 118 v “RTE_PDS_BATCHINIT_FLAG” on page 117 v “RTE_PDS_EXPORT_FLAG” on page 119 v “RTE_PDS_EXTRACT_FLAG” on page 120 v “RTE_PDS_FILE_COUNT” on page 120 v “RTE_PDS_SMS_VOLUME” on page 124 v “RTE_PDS_SMS_UNIT” on page 123 v “RTE_PDS_SMS_STORCLAS” on page 123 v “RTE_PDS_SMS_MGMTCLAS” on page 122 v “KPP_PD” on page 42 v “KPP_PD_CYL” on page 43 v “KPP_PD_GRP” on page 44 v “KPP_PD_HISTCOLL_DATA_IN_AGT_STC” on page 45 v “KPP_PD_HISTCOLL_DATA_IN_TEMS_STC” on page 46 KPP_SECURITY_ACTION_CLASS This parameter lists security options for Take Action commands. Specify the System Authorization Facility (SAF) security class name override that will be used to validate the agent's Take Action commands. If the specified class is invalid or is not active in the security manager, the command will not be executed. The value should conform to the definition rules dictated by the security manager. The value is used in the Kpp_SECURITY_ACTION_CLASS parameter in the: v xKANPARU(KppENV) member, if the agent runs in its own agent address space (that is, Kpp_AGT_CONFIGURATION_MODE="STANDALONE") or 48 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference v xKANPARU(KDSENV) member, if the agent runs in the TEMS address space (that is, Kpp_AGT_CONFIGURATION_MODE="CMS") Note: 1. If using ACF2 as your external security resource manager, specify a maximum of three characters. 2. Parameter RTE_SECURITY_CLASS applies to the Tivoli Enterprise Portal’s and the OMEGAMON enhanced 3270 user interface’s Take Action security. Related PARMGEN CONFIG profile parameter v “RTE_SECURITY_CLASS” on page 125 KPP_TEMS_BKUP1_NAME_NODEID Use the KPP_TEMS_BKUP1_NAME_NODEID parameter to specify the backup monitoring server values for configuring an agent for your site. Required or optional Optional Location where the parameter value is stored In the KPPENV member in the rhilev.midlev.rtename.RKANPARU library to communicate with the backup Tivoli Enterprise Monitoring Server Parameter name N/A Default value No default Permissible values A string of up to 32 case-sensitive characters In the Configuration Tool (ICAT) Panel name SPECIFY AGENT SECONDARY TEMS VALUES Panel ID KAG62P8 Field Backup TEMS name Default value No default Permissible values A string of up to 32 case-sensitive characters Batch parameter name KPP_CMSB_NAME PARMGEN name KPP_TEMS_BKUP1_NAME_NODEID PARMGEN classification Secondary TEMS VTAM information Description Server that the monitoring agent will connect to if the primary Tivoli Enterprise Monitoring Server (monitoring server) fails. This parameter specifies backup monitoring server values for configuring an agent for your site. This name must match the name of a non-z/OS monitoring server, or the CMS_NODEID Chapter 2. Common agent (KPP) parameters 49 parameter value, in the KPPENV member of the rhilev.midlev.rtename.RKANPARU library for a z/OS TEMS. If the parameter value contains the SMFID, you must enter the z/OS system's SMFID in place of this literal. Note: The value of this field is case-sensitive for both z/OS and non-z/OS monitoring server names. Related parameters None KPP_TEMS_BKUP1_TCP_HOST Use the KPP_TEMS_BKUP1_TCP_HOST to specify the TCP/IP hostname identifier for the backup Tivoli Enterprise Monitoring Server that this agent should try to connect to if the primary server is unavailable. Required or optional Optional. Required field if you plan to have this monitoring agent communicate with the backup server using TCP/IP. Location where the parameter value is stored In the KPPENV member in the rhilev.midlev.rtename.RKANPARU library Parameter name CT_CMSLIST=\ (Agent backup Server TCP/IP hostname) Default value No default Permissible values A string of up to 32 characters In the Configuration Tool (ICAT) Panel name SPECIFY AGENT SECONDARY TEMS VALUES Panel ID KAG62P8 Field Network address (Hostname of Secondary TEMS) Default value No default Permissible values A string of up to 32 characters Batch parameter name KPP_CMSB_TCP_HOST PARMGEN name KPP_TEMS_BKUP1_TCP_HOST PARMGEN classification Secondary TEMS TCP/IP information Description Agent backup Server TCP/IP hostname This parameter specifies the TCP/IP hostname identifier for the backup Tivoli Enterprise Monitoring Server that this agent should try to connect to if the primary server is unavailable. This is a required field if you plan to have this agent communicate with the backup server using TCP/IP. 50 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Specify the network address of the system on which the secondary monitoring server that this monitoring agent connects to is running. A network address may be specified as one of the following values: 1. A fully-qualified hostname (for example: sys.ibm.com) 2. The first qualifier of the fully-qualified hostname (for example: sys for sys.ibm.com) 3. An IPv4 address in dotted decimal notation (for example: 9.67.1.100) If the secondary monitoring server is running on a z/OS platform, you can find this value by issuing the TSO HOMETEST command from the system where the secondary monitoring server is running. If you will specify the hostname value for network address, use the first qualifier of the fully qualified hostname if the z/OS domain name resolver configuration specifies a search path that would include the target domain suffix. Otherwise, specify the fully-qualified hostname when using a Domain Name Server (DNS). If you will specify the IP address value for network address, use the assigned IPv4 address written in dotted decimal notation. This scheme is numeric and consists of four groups separated by a period (.). Related parameters None KPP_TEMS_BKUP1_VTAM_APPL_LLB_BKR Required or optional Optional. This is a required field if this monitoring agent needs to communicate with the backup server using VTAM protocol. Location where the parameter value is stored In the KPPENV member in the rhilev.midlev.rtename.RKANPARU library if you use SNA to communicate with the backup Tivoli Enterprise Monitoring Server Parameter name N/A Default value No default Permissible values A string of up to 8 characters In the Configuration Tool (ICAT) Panel name Specify Agent Secondary TEMS Values Panel ID KAG62P8 Field Local location broker applid Default value No default Default value No default Permissible values A string of up to 8 characters Batch parameter name KPP_CMSB_VTM_APPL_LLB PARMGEN name KPP_TEMS_BKUP1_VTAM_APPL_LLB_BKR Chapter 2. Common agent (KPP) parameters 51 PARMGEN classification Secondary TEMS VTAM information Description Backup Server Location Broker applid This parameter identifies the Local Location Broker that is to be used for VTAM-type communication to the backup server. Enter the Local Location Broker applid of the secondary Tivoli Enterprise Monitoring Server that this agent communicates with. This is a required field if this agent needs to communicate with the backup server using SNA protocol. This field is not required if you use TCP/IP for communication with the backup monitoring server. Related parameters None KPP_TEMS_BKUP1_VTAM_LU62_DLOGMOD Use the KPP_TEMS_BKUP1_VTAM_LU62_DLOGMOD parameter to specify the name of the LU6.2 LOGMODE that was defined for the backup server. Required or optional Optional. This is a required field if you plan to have the backup server communicate with monitoring agents using VTAM. Location where the parameter value is stored In the KPPENV member in the rhilev.midlev.rtename.RKANPARU library if you use SNA to communicate with the backup Tivoli Enterprise Monitoring Server Parameter name N/A Default value CANCTDCS Permissible values A string of up to 8 characters In the Configuration Tool (ICAT) Panel name Specify Agent Secondary TEMS Values Panel ID KAG62P8 Field LU6.2 logmode Default value CANCTDCS Permissible values A string of up to 8 characters Batch parameter name KPP_CMSB_VTM_LU62_LOG PARMGEN name KPP_TEMS_BKUP1_VTAM_LU62_DLOGMOD PARMGEN classification Secondary TEMS VTAM information Description Agent backup Server LU6.2 logmode 52 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference This parameter specifies the name of the LU6.2 LOGMODE that was defined for the backup server. The default is CANCTDCS. This is a required field if you plan to have the backup server communicate with agents using SNA. This field is not needed if you use TCP/IP for communication with the backup monitoring server. Related parameters None KPP_TEMS_BKUP1_VTAM_NETID Use the KPP_TEMS_BKUP1_VTAM_NETID parameter to identify your SNA network. Required or optional Optional. This is a required field if you plan to have the backup server communicate with monitoring agents using VTAM. Location where the parameter value is stored In the PP3ENV member in the rhilev.midlev.rtename.RKANPARU library if you use SNA to communicate with the backup Tivoli Enterprise Monitoring Server Parameter name N/A Default value No default Permissible values A string of up to 8 characters In the Configuration Tool (ICAT) Panel name Specify Agent Secondard TEMS Values Panel ID KAG62P8 Field Network ID Default value No default Permissible values A string of up to 8 characters Batch parameter name KPP_CMSB_VTM_NETID PARMGEN name KPP_TEMS_BKUP1_VTAM_NETID PARMGEN classification Secondary TEMS VTAM information Description Agent backup Sever Network ID This parameter identifies your SNA network. You can locate this value on the NETID parameter within the VTAMLST startup member, ATCSTRnn. This is a required field if you plan to have the backup server communicate with monitoring agents using SNA. This field is not needed if you use TCP/IP for communication with the backup monitoring server. Related parameters None Chapter 2. Common agent (KPP) parameters 53 KPP_TEMS_HUB_TCP_HOST Use the KPP_TEMS_HUB_TCP_HOST parameter to specify the hostname or IP address of the system where the primary Tivoli Enterprise Monitoring Server (local or remote) is running. Required or optional Optional. Required for remote Tivoli Enterprise Monitoring Servers that use TCP/IP for communications with the hub monitoring server Location where the parameter value is stored In the KDCSSITE member in the rhilev.midlev.rtename.RKANPARU library Parameter name AGLOCCN (Connect agent to local TEMS) Default value None Permissible values Character string, maximum length 32 In the Configuration Tool (ICAT) Panel name Specify Agent Primary TEMS Values Panel ID KAG62P1 Field Network Address (Hostname of the primary TEMS) Default value None Permissible values Character string, maximum length 32 Batch parameter name KPP_CMS_HUB_TCP_HOST PARMGEN name KPP_TEMS_HUB_TCP_HOST PARMGEN classification Values that describe the Primary TEMS the Agent will connect to Description Hostname of the primary TEMS This parameter specifies the hostname or IP address of the system where the primary Tivoli Enterprise Monitoring Server (local or remote) is running. The value specified for this parameter must match the value set for the KDS_TEMS_TCP_HOST parameter in the runtime environment where the hub is configured, or the value set for an equivalent parameter of a distributed hub. Related parameters None KPP_TEMS_LOCAL_CONNECT_FLAG Use the KPP_TEMS_LOCAL_CONNECT_FLAG parameter to specify values that describe the primary TEMS the agent will connect to. Note: Specify the Kpp_TEMS_TCP_* or Kpp_TEMS_VTAM_* parameter values for the primary TEMS that the agent will connect to. 54 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Required or optional Optional Location where the parameter value is stored The parameter value is not stored, but is used for internal processing. Parameter name AGLOCCN (Connect agent to local TEMS) Default value Y Permissible values Y, N In the Configuration Tool (ICAT) Panel name SPECIFY AGENT ADDRESS SPACE PARAMETERS Panel ID KAG62P2 Field Connect to TEMS in this RTE Default value Y Permissible values Y, N Batch parameter name KPP_CMS_LOCAL_CONNECT PARMGEN name KPP_TEMS_LOCAL_CONNECT_FLAG PARMGEN classification Values that describe the Primary TEMS the Agent will connect to Description Connect agent to local TEMS This parameter specifies how you want to connect the agent you are defining. When defining an agent, you have the option to connect the agent to a local server or a remote server. When connecting to a local server you are connecting the agent to the server in this runtime environment. Specify Y to connect the agent to the server in this RTE. Otherwise, specify N to have the agent connect to a remote server. Related PARMGEN CONFIG profile parameter Kpp_TEMS_BKUP1_* Agent's backup TEMS parameter values The agent's primary and backup TEMS parameter values are used in the CT_CMSLIST parameter in the agent's xKANPARU(KppENV) member. KPP_TEMS_NAME_NODEID Use the KPP_TEMS_NAME_NODEID parameter to specify the primary Tivoli Enterprise Monitoring Server values for configuring an agent for your site. Chapter 2. Common agent (KPP) parameters 55 Required or optional Optional Location where the parameter value is stored In the KPPENV member in the rhilev.midlev.rtename.RKANPARU library Parameter name CT_CMSLIST=%KPP_TEMS_NAME_NODEID (TEMS name) Default value No default Permissible values A string of up to 8 case-sensitive characters defining the nodeid of the server to which you are connecting the agent In the Configuration Tool (ICAT) Panel name Specify Agent Primary TEMS Values Panel ID KAG62P1 Field TEMS Name This value is created if you specify use of a local Tivoli Enterprise Monitoring Server (TEMS) on the same system where you created the runtime environment (RTE). This field is prefilled if you specified a local monitoring server on z/OS and cannot be changed. Default value No default Permissible values A string of up to 8 case-sensitive characters defining the nodeid of the server to which you are connecting the agent Batch parameter name KPP_CMS_NAME PARMGEN name KPP_TEMS_NAME_NODEID PARMGEN classification Values that describe the Primary TEMS the Agent will connect to Description Primary monitoring server that this monitoring agent connects to This parameter specifies the primary Tivoli Enterprise Monitoring Server values for configuring an agent for your site. This name must match the name of a non-z/OS monitoring server, or the CMS_NODEID parameter value, in the KDSENV member of the rhilev.midlev.rtename.RKANPARU library for a z/OS TEMS. If the parameter value contains the SMFID, you must enter the z/OS system's SMFID in place of this literal. Note: The value of this field is case-sensitive for both z/OS and non-z/OS monitoring server names. Related parameters None 56 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference KPP_TEMS_TCP_HOST Use the KPP_TEMS_TCP_HOST parameter to specify the agent's primary TEMS TCP/IP information. Note: Kpp_TEMS_TCP_HOST and Kpp_AGT_TCP_HOST must specify the same value if Kpp_TEMS_LOCAL_CONNECT_FLAG=Y ("Agent connects to local TEMS"). Required or optional This is a required field if you plan to have this agent communicate with Tivoli Enterprise Monitoring Server using TCP/IP. Location where the parameter value is stored In the KPPENV member in the rhilev.midlev.rtename.RKANPARU library Parameter name and syntax CT_CMSLIST=%KPP_TEMS_TCP_HOST Default value Value set for the RTE_TCP_HOST parameter for the runtime environment Permissible values Character string, maximum length 32 In the Configuration Tool (ICAT) Panel name Specify Agent Primary TEMS Values Panel ID KAG62P1 Field Network Address Default value Value set for the RTE_TCP_HOST parameter for the runtime environment Permissible values Character string, maximum length 32 Batch parameter name KPP_CMS_TCP_HOST PARMGEN name KPP_TEMS_TCP_HOST PARMGEN classification Agent's Primary TEMS TCP/IP information Description Server hostname This parameter specifies the server hostname. To obtain the host name or IP address, enter TSO HOMETEST at the command line. If the z/OS domain name resolver configuration specifies a search path that includes the target domain suffix, specify only the first qualifier of the host name. (Example: sys is the first qualifier of the fully qualified host name sys.ibm.com.) Otherwise, specify the fully qualified host name. This is a required field if you plan to have this server communicate with agents using TCP/IP. Attention: “KPP_TEMS_TCP_HOST” and “KPP_AGT_TCP_HOST” on page 30 must be the same value if “KPP_TEMS_LOCAL_CONNECT_FLAG” on page 54=Y (that is, if the agent connects to local monitoring server). Related parameters Chapter 2. Common agent (KPP) parameters 57 v “KPP_AGT_TCP_HOST” on page 30 v “KPP_TEMS_TCP_HOST” on page 57 KPP_TEMS_TCP_PIPE_PORT_NUM Use the KPP_TEMS_TCP_PIPE_PORT_NUM parameter to specify the IP.PIPE port number that you want to use. Required or optional Required if you specified a value of IPPIPE as one of the “KPP_AGT_COMM_PROTOCOLn” on page 11 protocol parameters Location where the parameter value is stored The KPPENV member of the rhilev.rte.RKANPARU library Parameter name IP.PIPE PORT: (Agent IP.PIPE port number) Default value 1918 Permissible values 1 - 65535 In the Configuration Tool (ICAT) Panel name v Specify Agent Primary TEMS Values (KAG62P1 for a non-local TEMS) v Specify IP.PIPE Communication Protocol (KDS62PPD for a local TEMS) Panel ID v KAG62P1 for a non-local TEMS v KDS62PPD for a local TEMS Field Port number (IP.PIPE) Default value 1918 Permissible values 1 - 65535 Batch parameter name KPP_CMS_TCP_PIPE_PORT PARMGEN name KPP_TEMS_TCP_PIPE_PORT_NUM PARMGEN classification Protocol port numbers for Agent connection to TEMS Description Agent IP.PIPE port number This parameter specifies the IP.PIPE port number that you want to use. This port number is used by the non-secure Network Computing System (NCS) IP.PIPE protocol. The default is 1918. Note: Port numbers for non-secure IP.PIPE protocol and IP.UDP protocol must match. Related parameters v “KPP_AGT_COMM_PROTOCOLn” on page 11 58 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference KPP_TEMS_TCP_PIPES_PORT_NUM Use the KPP_TEMS_TCP_PIPES_PORT_NUM parameter to specify the IP.SPIPE port number that you want to use. Required or optional Required if you specified a value of IPSPIPE in one of the “KPP_AGT_COMM_PROTOCOLn” on page 11 protocol parameters. Location where the parameter value is stored The KDSENV member of the rhilev.rte.RKANPARU library Parameter name IP.SPIPE PORT: (Agent IP.SPIPE port number) Default value 3660 Permissible values 1 - 65535 In the Configuration Tool (ICAT) Panel name v Specify Agent Primary TEMS Values (KAG62P1 for a non-local TEMS) v Specify IP.PIPE Communication Protocol (KDS62PPD for a local TEMS) Panel ID v KAG62P1 for a non-local TEMS v KDS62PPD for a local TEMS Field Port number (Secure IP.PIPE) Default value 3660 Permissible values 1 - 65535 Batch parameter name KPP_CMS_TCP_PIPES_PORT PARMGEN name KPP_TEMS_TCP_PIPES_PORT_NUM PARMGEN classification Protocol port numbers for Agent connection to TEMS Description Agent IP.SPIPE port number This parameter specifies the IP.SPIPE port number that you want to use. This port number is used by the secure Network Computing System (NCS) IP.PIPE protocol. The default is 3660. Note: Port numbers for non-secure IP.SPIPE protocols must match This parameter is required if you specified a value of IPSPIPE in one of the KPP_AGT_COMM_PROn protocol parameters. Related parameters v “KPP_AGT_COMM_PROTOCOLn” on page 11 Chapter 2. Common agent (KPP) parameters 59 KPP_TEMS_TCP_PIPE6_PORT_NUM Use the KPP_TEMS_TCP_PIPE6_PORT_NUM parameter to specify the IP6.PIPE port number that you want to use. Required or optional Required if you specified a value of IP6PIPE in one of the “KPP_AGT_COMM_PROTOCOLn” on page 11 protocol parameters. Location where the parameter value is stored The KPPENV member of the rhilev.midlev.rtename.RKANPARU library Parameter name PORT: IP6.PIPE PORT: (Agent IP6.PIPE port number) Default value No default Permissible values 1 - 65535 In the Configuration Tool (ICAT) Panel name v Specify Agent Primary TEMS Values (KAG62P1 for a non-local TEMS) v Specify IP.PIPE Communication Protocol (KDS62PPD for a local TEMS) Panel ID v KAG62P1 for a non-local TEMS v KDS62PPD for a local TEMS Field Port number (IP.PIPE for IPV6) Default value No default Permissible values 1 - 65535 Batch parameter name KPP_CMS_TCP_PIPE6_PORT PARMGEN name KPP_TEMS_TCP_PIPE6_PORT_NUM PARMGEN classification Protocol port numbers for Agent connection to TEMS Description Agent IP6.PIPE port number This parameter specifies the IP6.PIPE port number that you want to use. This port number is used by the non-secure Network Computing System (NCS) IP.PIPE protocol. The default is 1918. Note: Port numbers for non-secure IP6.PIPE and IP.UDP protocols must match. This parameter is required if you specified a value of IP6PIPE in one of the KPP_AGT_COMM_PROn protocol parameters. Related parameters v “KPP_AGT_COMM_PROTOCOLn” on page 11 60 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference KPP_TEMS_TCP_PIPE6S_PORT_NUM Use the KPP_TEMS_TCP_PIPE6S_PORT_NUM parameter to specify the IP6.SPIPE port number that you want to use. Required or optional Required if you specified a value of IP6SPIPE in one of the “KPP_AGT_COMM_PROTOCOLn” on page 11 protocol parameters. Location where the parameter value is stored The KPPENV member of the rhilev.midlev.rtename.RKANPARU library Parameter name IP6.SPIPE: PORT: (Agent IP.PIPE port number) Default value 3660 Permissible values 1 - 65535 In the Configuration Tool (ICAT) Panel name v Specify Agent Primary TEMS Values (KAG62PI1 for a non-local TEMS) v Specify IP.PIPE Communication Protocol (KDS62PPD for a local TEMS) Panel ID v KAG62P1 for a non-local TEMS v KDS62PPD for a local TEMS Field Port number (Secure IP.PIPE for IPV6) Default value 3660 Permissible values 1 - 65535 Batch parameter name KPP_CMS_TCP_PIPE6S_PORT PARMGEN name KPP_TEMS_TCP_PIPE6S_PORT_NUM Description Agent IP6.SPIPE port number This parameter specifies the IP6.SPIPE port number that you want to use. This port number is used by the secure Network Computing System (NCS) IP.PIPE protocol. The default is 3660. Note: Port numbers for non-secure IP.PIPE and IP.UDP protocols must match. This parameter is required if you specified a value of IP6.SPIPE in one of the KPP_AGT_COMM_PROn protocol parameters. Related parameters v “KPP_AGT_COMM_PROTOCOLn” on page 11 KPP_TEMS_TCP_UDP_PORT_NUM Use the KPP_TEMS_TCP_UDP_PORT_NUM parameter to specify the IP.UDP port number that you want to use. Chapter 2. Common agent (KPP) parameters 61 Use the KPP_TEMS_TCP_UDP_PORT_NUM parameter to specify the IP.UDP port number that you want to use. Required or optional Required if you specified a value of IP in one of the “KPP_AGT_COMM_PROTOCOLn” on page 11 protocol parameters. Location where the parameter value is stored The KPPENV member of the rhilev.midlev.rtename.RKANPARU library Parameter name IP.UDP PORT: (Agent IP.UDP port number) Default value 1918 Permissible values 1 - 65535 In the Configuration Tool (ICAT) Panel name v Specify Agent Primary TEMS Values (KAG62P1 for a non-local TEMS) v Specify IP.PIPE Communication Protocol (KDS62PPD for a local TEMS) Panel ID v KAG62P1 for a non-local TEMS v KDS62PPD for a local TEMS Field Port number (IP.UDP) Default value 1918 Permissible values 1 - 65535 Batch parameter name KPP_CMS_TCP_UDP_PORT PARMGEN name KPP_TEMS_TCP_UDP_PORT_NUM Description Agent IP.UDP port number This parameter specifies the IP.UDP port number that you want to use. This port number is used by the non-secure Network Computing System (NCS) IP (UDP) protocol. The default is 1918. Note: Port numbers for non-secure IP.PIPE protocol and IP.UDP protocol must match. This parameter is required if you specified a value of IP in one of the KPP_AGT_COMM_PROn protocol parameters. Related parameters v “KPP_AGT_COMM_PROTOCOLn” on page 11 KPP_TEMS_TCP_UDP6_PORT_NUM Use the KPP_TEMS_TCP_UDP6_PORT_NUM parameter to specify the IP6.UDP port number that you want to use. 62 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Required or optional Required if you specified a value of IP6 in one of the “KPP_AGT_COMM_PROTOCOLn” on page 11 protocol parameters. Location where the parameter value is stored The KPPENV member of the rhilev.midlev.rtename.RKANPARU library Parameter name IP6.UDP PORT: (Agent IP.UDP port number) Default value No default Permissible values 1 - 65535 In the Configuration Tool (ICAT) Panel name v Specify Agent Primary TEMS Values (KAG62P1 for a non-local TEMS) v Specify IP.PIPE Communication Protocol (KDS62PPD for a local TEMS) Panel ID v KAG62P1 for a non-local TEMS v KDS62PPD for a local TEMS Field Port number (IP6.UDP) Default value No default Permissible values 1 - 65535 Batch parameter name KPP_CMS_TCP_UDP6_PORT PARMGEN name KPP_TEMS_TCP_UDP6_PORT_NUM Description Agent IP6.UDP port number for IPv6 This parameter specifies the IP6.UDP port number that you want to use. This port number is used by the non-secure Network Computing System (NCS) IP (UDP) protocol. The default is 1918. Note: Port numbers for non-secure IP.PIPE protocols must match. This parameter is required if you specified a value of IP6 in one of the KPP_AGT_COMM_PROn protocol parameters. Related parameters v “KPP_AGT_COMM_PROTOCOLn” on page 11 KPP_TEMS_VTAM_APPL_LLB_BROKER Use the KPP_TEMS_VTAM_APPL_LLB_BROKER parameter to identify which Local Location Broker is to be used for VTAM-type communication. Required or optional Required if you use SNA to communicate with the Tivoli Enterprise Monitoring Server Chapter 2. Common agent (KPP) parameters 63 Location where the parameter value is stored The KPPENV member of the rhilev.midlev.rtename.RKANPARU library Parameter name and syntax CT_CMSLIST=%KPP_TEMS_VTAM_APPL_LLB_BROKER Default value CTDDSLB Permissible values A string of up to 8 characters In the Configuration Tool Panel name Specify Agent Primary TEMS Values Panel ID KAG62P1 Field Local Location Broker applid Default value CTDDSLB Permissible values A string of up to 8 characters Batch parameter name KPP_CMS_VTM_APPL_LLB PARMGEN name KPP_TEMS_VTAM_APPL_LLB_BROKER PARMGEN classification Agent's Primary TEMS VTAM information Description Local Location Broker applid This parameter identifies which Local Location Broker is to be used for VTAM-type communication. This is a required field if you use SNA to communicate with the Tivoli Enterprise Monitoring Server. Related parameters None KPP_TEMS_VTAM_LU62_DLOGMOD Use the KPP_TEMS_VTAM_LU62_DLOGMOD parameter to specify the name of the LU6.2 LOGMODE that was defined for the server. Required or optional Required if you use SNA to communicate with the Tivoli Enterprise Monitoring Server Location where the parameter value is stored The CTDPPN member of the rhilev.midlev.rtename.RKANSAMU library Parameter name and syntax CT_CMSLIST=%KPP_TEMS_VTAM_LU62_DLOGMOD Default value CANCTDCS 64 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Permissible values Character string, maximum length 8 In the Configuration Tool (ICAT) Panel name Specify Agent Primary TEMS Values Panel ID KAG62P1 Field LU6.2 logmode Default value CANCTDCS Permissible values Character string, maximum length 8 Batch parameter name KPP_CMS_VTM_LU62_LOG PARMGEN name KPP_TEMS_VTAM_LU62_DLOGMOD PARMGEN classification Agent's Primary TEMS VTAM information Description LU6.2 LOGMODE This parameter specifies the name of the LU6.2 LOGMODE that was defined for the server. This is a required field if you plan to have the server communicate with agents using VTAM. The IBM default is CANCTDCS. Related parameters None KPP_TEMS_VTAM_LU62_MODETAB Use the KPP_TEMS_VTAM_LU62_MODETAB parameter to specify the name of the LOGMODE table containing the LU6.2 LOGMODE definition. Required or optional Required if you use SNA to communicate with the Tivoli Enterprise Monitoring Server Location where the parameter value is stored The CTDPPN member of the rhilev.midlev.rtename.RKANSAMU library Parameter name and syntax CT_CMSLIST=%KPP_TEMS_VTAM_LU62_MODETAB Default value KDSMTAB1 Permissible values Character string, maximum length 8 In the Configuration Tool (ICAT) Panel name Specify Agent Primary TEMS Values Panel ID KAG62P1 Chapter 2. Common agent (KPP) parameters 65 Field LOGMODE table name Default value KDSMTAB1 Permissible values Character string, maximum length 8 Batch parameter name KPP_CMS_VTM_LU62_LOGTAB PARMGEN name KPP_TEMS_VTAM_LU62_MODETAB PARMGEN classification Agent's Primary TEMS VTAM information Description LOGMODE table name This parameter specifies the name of the LOGMODE table containing the LU6.2 LOGMODE definition. This is a required field if you plan to have the server communicate with agents using SNA. Related parameters None KPP_TEMS_VTAM_NETID Use the KPP_TEMS_VTAM_NETID parameter to specify the identifier of your VTAM network. Required or optional Required if you use SNA to communicate with the Tivoli Enterprise Monitoring Server Location where the parameter value is stored The KPPENV member of the rhilev.midlev.rtename.RKANPARU library Parameter name and syntax CT_CMSLIST=%KPP_TEMS_VTAM_NETID Default value Value set for the RTE_VTAM_NETID or RTE_SYSV_VTAM_NETID parameter Permissible values Character string, maximum length 8 In the Configuration Tool (ICAT) Panel name Specify Agent Primary TEMS Values Panel ID KAG62P1 Field Network ID Default value Value set for the RTE_VTAM_NETID or RTE_SYSV_VTAM_NETID parameter Permissible values Character string, maximum length 8 Batch parameter name KPP_CMS_VTM_NETID 66 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference PARMGEN name KPP_TEMS_VTAM_NETID PARMGEN classification Agent's Primary TEMS VTAM information Description Network ID This parameter specifies the identifier of your VTAM network. You can locate this value on the NETID parameter within the VTAMLST startup member (ATCSTRnn). This is a required field if you plan to have this server communicate to agents using VTAM. Related parameters None KPP_X_AGT_CONFIRM_SHUTDOWN Use the KPP_X_AGT_CONFIRM_SHUTDOWN PARMGEN-only parameter to specify the maximum number of seconds between two successive SHUTDOWN commands or MVS STOP (P) commands to terminate the monitoring agent address space. Required or optional Required Location where parameter value is stored In the KPPSYSIN member of the rhilev.midlev.rtename.RKANPARU library Parameter name CONFIRM(&XPPFIRM) (Confirm shutdown option) Default value 0 Permissible values 0 to 15 PARMGEN name KPP_X_AGT_CONFIRM_SHUTDOWN PARMGEN classification Additional agent settings Description Confirm shutdown option This parameter sets the maximum number of seconds between two successive SHUTDOWN commands or MVS STOP (P) commands to terminate the monitoring agent address space. CONFIRM(0) allows TMS:Engine shutdown to begin immediately without an additional, confirming SHUTDOWN command. CONFIRM(n) prevents accidental shutdowns by requiring you to confirm the command by entering it a second time within the specified number of seconds. For example, CONFIRM(15) requires you enter SHUTDOWN twice within 15 seconds to terminate the address space. The default for the monitoring agent CONFIRM is 0, which is also the Tivoli Enterprise Monitoring Server default. Related parameters None Chapter 2. Common agent (KPP) parameters 67 KPP_X_AGT_DEBUG_TRACE Use the KPP_X_AGT_DEBUG_TRACE PARMGEN-only parameter to specify whether TMS:Engine debugging services are to be activated. Required or optional Optional Location where parameter value is stored In the KPPSYSIN member of the rhilev.midlev.rtename.RKANPARU library Parameter name DEBUG(&XPPDEBG) (TMS:Engine Debugging Services) Default value N Permissible values Y, N PARMGEN name KPP_X_AGT_DEBUG_TRACE PARMGEN classification Additional agent settings Description TMS:Engine Debugging Services Attention: Do not modify this parameter except under the guidance of IBM Software Support. This parameter specifies whether TMS:Engine debugging services are to be activated. N means that basic debugging information will not be recorded. Y means that basic debugging information will be recorded. DEBUG and STGDEBUG may affect each other. If DEBUG(Y) is specified and STGDEBUG is omitted, basic storage debugging is turned on, causing an increase in storage use. STGDEBUG must also be specified after DEBUG in the initialization deck for proper functioning of these turned on, causing an increase in storage use. DEBUG will override STGDEBUG if it follows STGDEBUG. The default for the monitoring agent DEBUG is N. Related parameters None KPP_X_AGT_KDC_DEBUG Use the KPP_X_AGT_KDC_DEBUG PARMGEN-only parameter to instruct the data communications layer to report communications problems using a minimal, summary format. Required or optional Optional Location where parameter value is stored In the KPPENV member in the rhilev.midlev.rtename.RKANPARU library Parameter name KDC_DEBUG=(&XPPDBUG) (TCP/IP communication trace debug) Default value N 68 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Permissible values Y, N, D, M, A PARMGEN name KPP_X_AGT_KDC_DEBUG PARMGEN classification Additional agent settings Description TCP/IP communication trace debug Attention: Do not modify this parameter except under the guidance of IBM Software Support. TCP/IP communication trace debug Set this parameter to Y if you want KDC_DEBUG=Y as the override setting in RKANPARU(KPPENV) member. Otherwise, the default setting of KDC_DEBUG=N is used. This default parameter instructs the data communications layer to report communications problems using a minimal, summary format. This parameter is intended for stable applications in production. Note that the default KDC_DEBUG=N generates standard RAS1 trace data in the Agent RKLVLOG, in addition to the summary information diagnosing possible timeout conditions. The following settings report on data communications problems: v KDC_DEBUG=N: minimal tracing (default) v KDC_DEBUG=Y: full-packet tracing v KDC_DEBUG=D: KDC_DEBUG=Y plus STATE & FLOW tracing v KDC_DEBUG=M: KDC_DEBUG=D plus INPUT & OUTPUT HELPs tracing v KDC_DEBUG=A: KDC_DEBUG=M plus all format tracing Note: Do not set KDC_DEBUG=A unless directed to by IBM Software Support. Related parameters None KPP_X_AGT_LGSA_VERIFY Use the KPP_X_AGT_LGSA_VERIFY PARMGEN-only parameter to specify whether TMS:Engine checks that the $GSA address is available. Required or optional Required Location where parameter value is stored In the KPPSYSIN member of the rhilev.midlev.rtename.RKANPAU library Parameter name LGSA(&XPPLGSA) (Verify $GSA address availability) Default value Y Permissible values Y, N PARMGEN name KPP_X_AGT_LGSA_VERIFY PARMGEN classification Additional agent settings Chapter 2. Common agent (KPP) parameters 69 Description Verify $GSA address availability Attention: Do not modify this parameter except under the guidance of IBM Software Support. This parameter determines whether TMS:Engine checks that the $GSA address is available. Y, N are the only options. Y means you want to check if available. N means you do not want to check if available. The default for the monitoring agent LGSA is Y, which is also the Tivoli Enterprise Monitoring Server default value. Related parameters None KPP_X_AGT_LSRPOOL_BUFFER_NUM Use the KPP_X_AGT_LSRPOOL_BUFFER_NUM PARMGEN-only parameter to specify the number of virtual storage buffers to be allocated for the specified buffer pool in the VSAM resource pool. Required or optional Required Location where parameter value is stored In the KPPSYSIN member of the rhilev.midlev.rtename.RKANPARU library Parameter name LSRPOOL(&XPPBNUM,number) (Number of buffers) Default value 32 Permissible values 3 - 65535 (to the maximum amount of available virtual storage in the monitoring agent address space) PARMGEN name KPP_X_AGT_LSRPOOL_BUFFER_NUM PARMGEN classification Additional agent settings Description Number of buffers This parameter specifies the number of virtual storage buffers to be allocated for buffer pool "n" in the VSAM resource pool. You must specify a size for each buffer pool individually. You cannot string the definitions because they must be specified individually. Permissible values: 3-65535. This parameter has size of buffers and number of buffer and is specified as LSRPOOL(32768,32). The default for the monitoring agent LSRPOOL buffer number is 32. Related parameters None 70 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference KPP_X_AGT_LSRPOOL_BUFSIZE Use the KPP_X_AGT_LSRPOOL_BUFSIZE PARMGEN-only parameter to specify the size in bytes of each virtual storage buffer in the specified buffer pool in the VSAM resource pool. Required or optional Required Location where parameter value is stored In the KPPSYSIN member of the rhilev.midlev.rtename.RKANPARU library Parameter name LSRPOOL(&XPPBSIZ,number) (Size of virtual storage buffer in pool) Default value 32768 Permissible values 512, 1024, 2048, 8192, 12288, 16384, 20480, 24576, 28672, or 32768 PARMGEN name KPP_X_AGT_LSRPOOL_BUFSIZE PARMGEN classification Additional agent settings Description Size of virtual storage buffer in pool This parameter specifies the size in bytes of each virtual storage buffer in buffer pool "n" in the VSAM resource pool. You must specify a size for each buffer pool individually. You cannot string the definitions because they must be specified individually. Permissible values are one of the following: 512, 1024, 2048, 8192, 12288, 16384, 20480, 24576, 28672, or 32768. This parameter has size of buffers and number of buffer and specified as LSRPOOL(32768,32). The default for the monitoring agent LSRPOOL buffer size is 32768. Related parameters None KPP_X_AGT_SDUMP_SVC_SYS1_DUMP Use the KPP_X_AGT_SDUMP_SVC_SYS1_DUMP PARMGEN-only parameter to specify whether SVC dumps are generated. Required or optional Required Location where parameter value is stored In the KPPSYSIN member of the rhilev.midlev.rtename.RKANPARU library Parameter name SDUMP(&XPPDSVC) (Generate SVC dump) Default value Y Permissible values Y, N, S ,M PARMGEN name KPP_X_AGT_SDUMP_SVC_SYS1_DUMP Chapter 2. Common agent (KPP) parameters 71 PARMGEN classification Additional agent settings Description Generate SVC dump This parameter determines whether SVC dumps are generated. Y directs the SVC dump to a system dump data set (SYS1.DUMPxx). Before you specify Y as the value of this parameter, ensure that the TMS:Engine job step is APF-authorized and that the SYS1.DUMPxx data sets are large enough to hold the contents of the TMS:Engine address space. N directs formatted dumps to the RKLVSNAP data set. Avoid formatted dumps if possible because they disable the TMS:Engine address space for a longer time than either SVC dumps or SYSMDUMPs, and are more difficult to analyze. S directs summary dumps to the RKLVSNAP data set. A summary dump consistes of an ABEND summary and dispatcher summary and does not provide enough information for reliable problem analysis. Use this setting for specific testing purposes only. M directs ABEND dumps to the data set with the SYSMDUMP DD name. This type of dump is not formatted by the operating system and must be analyzed with IPCS. Only the first dump taken is captured in the SYSMDUMP data set unless JCL specifies DISP=MOD. TMS:Engine automatically initializes the SYSMDUMP data set with an end-of-file mark. The default for the monitoring agent SDUMP is Y. Related parameters None KPP_X_AGT_STORAGE_LIMIT_EXTEND The KPP_X_AGT_STORAGE_LIMIT_EXTEND PARMGEN-only parameter specifies the maximum size for TMS:Engine primary storage (above-the-line) requests. Required or optional Required Location where parameter value is stored In the KPPSYSIN data set of the rhilev.midlev.rtename.RKANPARU library Parameter name LIMIT(&XPPELIM,X) Default value 22 Permissible values A power of 2 between 16 and 25. PARMGEN name KPP_X_AGT_STORAGE_LIMIT_EXTEND PARMGEN classification Additional agent settings Description Extended maximum storage request This parameter specifies the maximum size for the TMS:Engine primary storage (above-the-line) request. The maximum extended storage request size is specified as a power of 2. The minimum extended storage size is 16, which specifies a limit of 64K. The maximum is 25, which specifies a limit of 32 MB. 72 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference The default for the monitoring agent extended storage is 22, which specifies a limit of 4 MB. Related parameters None KPP_X_AGT_STORAGE_LIMIT_PRIMARY Use the KPP_X_AGT_STORAGE_LIMIT_PRIMARY PARMGEN-only parameter to specify the maximum size for the TMS:Engine primary storage request. Required or optional Required Location where parameter value is stored In the KPPSYSIN member of the rhilev.midlev.rtename.RKANPARU library Parameter name LIMIT(&XPPPLIM,P) (Primary maximum storage request) Default value 20 Permissible values A power of two between 16 and 25 PARMGEN name KPP_X_AGT_STORAGE_LIMIT_PRIMARY PARMGEN classification Additional agent settings Description Primary maximum storage request This parameter specifies the maximum size for the TMS:Engine primary storage request. The maximum primary storage request size is specified as a power of 2. The minimum primary storage size is 16, which specifies a limit of 64K. The maximum is 25, which specifies a limit of 32 MB The default for the monitoring agent primary storage is 20, which specifies a limit of 1 MB. Related parameters None KPP_X_AGT_STORAGE_RESERVE_EXT Use the KPP_X_AGT_STORAGE_RESERVE_EXT PARMGEN-only parameter to specify the number of kilobytes of extended (above-the-line) storage to set aside for other routines that might perform their own GETMAINs in this address space. Required or optional Required Location where parameter value is stored In the KPPSYSIN member of the rhilev.midlev.rtename.RKANPARU library Parameter name RESERVE(&XAGERES,X) (Extended 31-bit region reserve) Default value 2048 Permissible values 0 to 9999 Chapter 2. Common agent (KPP) parameters 73 PARMGEN name KPP_X_AGT_STORAGE_RESERVE_EXT PARMGEN classification Additional agent settings Description Extended 31-bit region reserve This parameter specifies the number of kilobytes of extended (above-the-line) storage to set aside for other routines that might perform their own GETMAINs in this address space. If your RESERVE value is too small, you might encounter IST566I messages from VTAM or S80A, S878, S066, S40D, or S0F9 abends. The default for the monitoring agent primary storage reserve is 2048 KB. Related parameters None KPP_X_AGT_STORAGE_RESERVE_PRI Use the KPP_X_AGT_STORAGE_RESERVE_PRI PARMGEN-only parameter to specify the number of KB of primary (below-the-line) storage to set aside for other routines (for example, ACF2 and RACF®) that might perform their own GETMAINs in this address space. Required or optional Required Location where parameter value is stored In the KPPSYSIN member of the rhilev.midlev.rtename.RKANPARU library Parameter name RESERVE(&XPPPRES,P) (Primary 24-bit region reserve) Default value 2048 Permissible values 0 to 9999 PARMGEN name KPP_X_AGT_STORAGE_RESERVE_PRI PARMGEN classification Additional agent settings Description Primary 24-bit region reserve This parameter specifies the number of KB of primary (below-the-line) storage to set aside for other routines (for example, ACF2 and RACF) that might perform their own GETMAINs in this address space. ACF2 and RACF use approximately 1 KB of primary storage per logged-on user. If your RESERVE value is too small, you might encounter IST566I messages from VTAM or S80A, S878, S066, S40D, or S0F9 abends. The default for the monitoring agent primary storage reserve is 2048 KB. Related parameters None 74 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference KPP_X_AGT_STORAGE_STGDEBUG Use the KPP_X_AGT_STORAGE_STGDEBUG PARMGEN-only parameter to specify whether TMS:Engine storage debugging services are to be activated. Required or optional Optional Location where parameter value is stored The KPPSYSIN member of the rhilev.midlev.rtename.RKANPARU library Parameter name STGDEBUG(&XPPSTDB) (Storage Debugging Services) Default value N Permissible values Y, N, X PARMGEN name KPP_X_AGT_STORAGE_STGDEBUG PARMGEN classification Additional agent settings Description Storage Debugging Services This parameter specifies whether TMS:Engine storage debugging services are to be activated. N means that storage debugging information will not be recorded. Y means that basic storage debugging information will be recorded. X means that extended storage debugging information will be recorded. DEBUG and STGDEBUG can affect each other. If DEBUG(Y) is specified and STGDEBUG is omitted, basic storage debugging is turned on, causing an increase in storage use. STGDEBUG must also be specified after DEBUG in the initialization deck for proper functioning of these turned on, causing an increase in storage use. DEBUG will override STGDEBUG if it follows STGDEBUG. The default for the monitoring agent STGDEBUG is N. This parameter is usually omitted from the KPPSYSIN member. Related parameters None KPP_X_AGT_TASKS_ATTACHED_NUM Use the KPP_X_AGT_TASKS_ATTACHED_NUM PARMGEN-only parameter to specify the number of general-purpose subtasks to be attached in the TMS:Engine address space. Required or optional Required Location where parameter value is stored In the KPPSYSIN member of the rhilev.midlev.rtename.RKANPARU library Parameter name TASKS(&XPPTASK) (Default number of available processors) Chapter 2. Common agent (KPP) parameters 75 Default value 1 Permissible values Do not modify this parameter except under the guidance of IBM Software Support. PARMGEN name KPP_X_AGT_TASKS_ATTACHED_NUM PARMGEN classification Additional agent settings Description Default number of available processors Attention: Do not modify this parameter except under the guidance of IBM Software Support. This parameter specifies the number of general-purpose subtasks to be attached in the TMS:Engine address space. If TMS:Engine is running on a multiprocessor, the TASKS default increases both throughput and CPU usage. Reducing the number of tasks decreases both throughput and CPU usage. The default for the monitoring agent TASKS is 1. Related parameters None KPP_X_HUB_BKUP1_TCP_HOST Use the KPP_X_HUB_BKUP1_TCP_HOST PARMGEN-only parameter to specify the TCP/IP hostname identifier for the hub Tivoli Enterprise Monitoring Server that this agent should try to connect to if the primary server is unavailable. Required or optional Required field if you plan to have this monitoring agent communicate with the backup server using TCP/IP. Location where the parameter value is stored In the KPPENV member in the rhilev.midlev.rtename.RKANPARU library In the Configuration Tool (ICAT) Permissible values A string of up to 32 characters Batch parameter name KPP_X_HUB_BKUP1_TCP_HOST Related parameters None KPP_X_HUB_BKUP1_TEMS_VTAM_NETID Use the KPP_X_HUB_BKUP1_TEMS_VTAM_NETID PARMGEN-only parameter to identify the SNA.PIPE protocol for communications with the secondary hub Tivoli Enterprise Monitoring Server. Required or optional Required, if you plan to have the backup server communicate with monitoring agents using VTAM. Location where the parameter value is stored In the KPPENV member in the rhilev.midlev.rtename.RKANPARU library if you use SNA to communicate with the backup Tivoli Enterprise Monitoring Server. 76 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference In the Configuration Tool (ICAT) Permissible values A string of up to eight characters Batch parameter name KPP_X_HUB_BKUP1_TEMS_VTAM_NETID Related parameters None KPP_X_HUB_BKUP1_VTAM_APPL_GLBBKR Use the KPP_X_HUB_BKUP1_VTAM_APPL_GLBBKR PARMGEN-only parameter to identify the global hub backup server location broker APPLID. Enter the Global Location Broker APPLID of the hub Tivoli Enterprise Monitoring Server that this agent uses for communication. This is a required field, if this agent needs to communicate with the backup server using SNA protocol. This field is not required, if you use TCP/IP for communication with the backup monitoring server. Required or optional Required if this monitoring agent needs to communicate with the backup server using VTAM protocol. Location where the parameter value is stored In the KPPENV member in the rhilev.midlev.rtename.RKANPARU library if you use SNA to communicate with the backup Tivoli Enterprise Monitoring Server In the Configuration Tool (ICAT) Field Global location broker applid Default value No default Default value No default Permissible values A string of up to eight characters Batch parameter name KPP_X_HUB_BKUP1_VTAM_APPL_GLBBKR Related parameters None KPP_X_HUB_TCP_HOST Use the KPP_X_HUB_TCP_HOST PARMGEN-only parameter to specify the hub server hostname. This is a required field if you plan to have this hub server communicate with agents using TCP/IP. Required or optional Required if you plan to have this agent communicate with the hub Tivoli Enterprise Monitoring Server using TCP/IP. Location where the parameter value is stored In the KPPENV member in the rhilev.midlev.rtename.RKANPARU library Permissible values Character string, maximum length 32 Chapter 2. Common agent (KPP) parameters 77 In the Configuration Tool (ICAT) Permissible values Character string, maximum length of 32 Batch parameter name KPP_X_HUB_TCP_HOST Related parameters None KPP_X_HUB_TEMS_VTAM_NETID Use the KPP_X_HUB_TEMS_VTAM_NETID PARMGEN-only parameter to specify the VTAM identifier associated with the hub monitoring server. Required or optional Required if you use SNA to communicate with the hub Tivoli Enterprise Monitoring Server. Location where the parameter value is stored The KPPENV member of the rhilev.midlev.rtename.RKANPARU library Permissible values Character string, maximum length of eight In the Configuration Tool (ICAT) Permissible values Character string, maximum length of eight. Batch parameter name KPP_X_HUB_TEMS_VTAM_NETID Related parameters None KPP_X_HUB_VTAM_APPL_GLBBKR Use the KPP_X_HUB_VTAM_APPL_GLBBKR PARMGEN-only parameter to identify the global hub server location broker APPLID. Enter the Global Location Broker APPLID of the hub Tivoli Enterprise Monitoring Server that this agent uses for communication. This is a required field, if this agent needs to communicate with the backup server using SNA protocol. This field is not required, if you use TCP/IP for communication with the backup monitoring server. Required or optional Required if this monitoring agent needs to communicate with the hub monitoring server using the VTAM applid for the global location broker. Location where the parameter value is stored In the KPPENV member in the rhilev.midlev.rtename.RKANPARU library if you use SNA to communicate with the hub Tivoli Enterprise Monitoring Server. Default value No default Permissible values A string of up to 8 characters In the Configuration Tool (ICAT) Field 78 Global location broker applid IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Default value No default Permissible values A string of up to 8 characters Batch parameter name KPP_X_HUB_VTAM_APPL_GLBBKR Related parameters None KPP_X_PD_HISTCOLL_DATA_AGT_STC Use the KPP_X_PD_HISTCOLL_DATA_AGT_STC PARMGEN-only parameter to specify historical collection is being performed by the Tivoli Enterprise Monitoring Server address space. Required or optional Optional Location where parameter value is stored This parameter is used for internal processing to enable a flag to be set if persistent datastore configuration is being set for the product. When this flag is set, the KPPPG, KPPAL, KPPPCTL, KPPPCTL2 and KPPDEFIN members are created in rhilev.midlev.rtename.RKANPARU library. Parameter name N/A Default value Y Permissible values Y, N PARMGEN name KPP_X_PD_HISTCOLL_DATA_AGT_STC PARMGEN classification Persistent datastore Description This parameter indicates whether historical collection is being performed by the Tivoli Enterprise Monitoring Server address space. Y means that the monitoring server address space is collecting historical data. N means that the monitoring server address space is not collecting historical data. The default in N This parameter defines the started task name for historical data collection when this collection takes place on the Tivoli Enterprise Monitoring Server and the monitoring agent is running in the monitoring server address space (which is the recommended configuration for this monitoring agent). Y means that the monitoring server is collecting historical data. The KPDPG, KP3AL, KPPPCTL, KPDPCTL2, and KPDDEFIN members of the rhilev.midlev.rtename.RKANPARU library are created when this flag is set. Related parameters None KPP_X_PD_HISTCOLL_DATA_TEMS_STC Use the KPP_X_PD_HISTCOLL_DATA_TEMS_STC PARMGEN-only parameter to specify whether historical collection is being performed by the monitoring agent address space. Chapter 2. Common agent (KPP) parameters 79 Required or optional Optional Location where parameter value is stored The parameter value is not stored, but is used for internal processing. Parameter name N/A Default value N Permissible values Y, N PARMGEN name KPP_X_PD_HISTCOLL_DATA_TEMS_STC PARMGEN classification Persistent datastore Description This parameter indicates whether historical collection is being performed by the monitoring agent address space. Y means that this agent address space is collecting historical data. N means that the agent address space is not collecting historical data. The default in N. This parameter determines whether historical data collection takes place on the Tivoli Enterprise Monitoring Server or on the monitoring agents where the monitoring agent is running in the monitoring server address space (which is the recommended configuration for this monitoring agent). The KPDPG, KPDPCTL, KPDPCTL2, and KPDDEFIN members of the rhilev.midlev.rtename.RKANPARU library are updated with KPP*-specific parameters when this flag is set. Related parameters None 80 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Chapter 3. Global (GBL) parameters The global parameters are explained in this chapter. GBL_DSN_ACF2_MACLIB This parameter contains the name of an ACF2 macro library. Required or optional Optional In the Configuration Tool (ICAT) Panel name Add Runtime Environment (2 of 3) Panel ID KCIPRTA1 Field ACF2 macro library Default value SYS1.ACF2.MACLIB Permissible values Character string, maximum length 44 Batch parameter name RTE_ACF2_MACLIB PARMGEN name GBL_DSN_ACF2_MACLIB Description Name of an ACF2 macro library. This parameter is required if the value specified for the RTE_SECURITY_USER_LOGON environment variable is ACF2. To include more than one ACF2 macro library, define more than one GBL_DSN_ACF2_MACLIBn parameter, with a unique number substituted for n at the end of each parameter name (example: GBL_DSN_ACF2_MACLIB1, GBL_DSN_ACF2_MACLIB2, and so on). Related parameters v “RTE_SECURITY_USER_LOGON” on page 127 GBL_DSN_CBC_SCCNOBJ This PARMGEN-only parameter contains the name of the XL C Compiler object library Required or optional Optional Default value CBC.SCCNOBJ Permissible values Character string, maximum length 44. PARMGEN name GBL_DSN_CBC_SCCNOBJ Description This is the name of the XL C Compiler object library. © Copyright IBM Corp. 2010, 2012 81 Related parameters None GBL_DSN_CBC_SCLBSID This PARMGEN-only parameter contains the name of the XL C/C++ side-deck library. Required or optional Optional Default value CBC.SCCNOBJ Permissible values Character string, maximum length 44. PARMGEN name GBL_DSN_CBC_SCLBSID Description This is the name of the XL C/C++ side-deck library. Related parameters None GBL_DSN_CEE_SCEEBIND This PARMGEN-only parameter contains the location of the LE/370 C XPLINK resident routines. Required or optional Optional Default value CEE.SCEEBIND Permissible values Character string, maximum length 44. PARMGEN name GBL_DSN_CEE_SCEEBIND Description This is the name of the library containing LE/370 C XPLINK resident routines. Related parameters None GBL_DSN_CEE_SCEEBND2 This PARMGEN-only parameter contains the location of the LE/370 C XPLINK LP64 library. Required or optional Optiional Default value CEE.SCEEBND2 Permissible values CEE.SCEEBND2 PARMGEN name GBL_DSN_CEE_SCEEBND2 82 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Description This is the name of the LE/370 C XPLINK LP64 library. Related parameters None GBL_DSN_CEE_SCEECPP This PARMGEN-only parameter contains the name of the LE/370 C++ class library. Required or optional Optional Default value CEE.SCEECPP Permissible values Character string, maximum length 44. PARMGEN name GBL_DSN_CEE_SCEECPP Description This is the name of the LE/370 C++ class library. Related parameters None GBL_DSN_CEE_SCEELIB This PARMGEN-only parameter contains the name of the LE/370 C side-deck library. Required or optional Optional Default value CEE.SCEELIB Permissible values Character string, maximum length 44. PARMGEN name GBL_DSN_CEE_SCEELIB Description This is the name of the LE/370 C side-deck library. Related parameters None GBL_DSN_CEE_SCEELKED This parameter contains the name of the LE/370 C link-edit library. Required or optional Required Default value CEE.SCEELKED Permissible values Character string, maximum length 44. In the Configuration Tool (ICAT) Chapter 3. Global (GBL) parameters 83 Panel name Specify Linkedit Libraries Panel ID KQI70PLE Field LE/370 C support libraries (Required) Batch parameter name KQI_CEE_LE370_LKED PARMGEN name GBL_DSN_CEE_SCEELKED Description This is the LE/370 C link-edit library that contains the link-edit stubs for C/C++, PL/I, COBOL, and Fortran languages and Language Environment-provided routines. Related parameters None GBL_DSN_CEE_SCEELKEX This PARMGEN-only parameter contains the location of the LE/370 C non-XPLINK long names. Required or optional Optional Default value CEE.SCEELKEX Permissible values Character string, maximum length 44. PARMGEN name GBL_DSN_CEE_SCEELKEX Description This is the location of the LE/370 C non-XPLINK long names. Related parameters None GBL_DSN_CEE_SCEEMSGP This PARMGEN-only parameter contains the name of the library containing the LE/370 C prelinker messages. Required or optional Optional Default value CEE.SCEEMSGP Permissible values Character string, maximum length 44. PARMGEN name GBL_DSN_CEE_SCEEMSGP Description This is the name of the library containing the LE/370 C prelinker messages. Related parameters None 84 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference GBL_DSN_CEE_SCEERUN This parameter contains the name of the LE/370 C Runtime Library. Required or optional Required In the Configuration Tool (ICAT) Panel name Specify Linkedit Libraries Panel ID KQI70PLE Field LE/370 C support libraries (Required) Default value CEE.SCEERUN Permissible values Character string, maximum length 44. Batch parameter name KQI_CEE_LE370_RUN PARMGEN name GBL_DSN_CEE_SCEERUN Description This is the LE/370 C runtime library that contains the routines needed during execution of applications written in C/C++, PL/I, COBOL and Fortran. Related parameters None GBL_DSN_CEE_SCEESPC This PARMGEN-only parameter contains the name of the LE/370 system programmer’s C facility. Required or optional Optional Default value CEE.SCEESPC Permissible values Character string, maximum length 44. PARMGEN name GBL_DSN_CEE_SCEESPC Description This is the name of the LE/370 system programmer’s C facility. Related parameters None GBL_DSN_CICS_CTG_DLL This parameter is the name of the CICS TG Dynamic Link Library. Chapter 3. Global (GBL) parameters 85 Required or optional Required In the Configuration Tool (ICAT) Panel name Specify Configuration Parameters Panel ID KGW41P1 Field CICS TG DLL DSN Default value SYS1.SCTGDLL Permissible values Character string, maximum length 44. Batch parameter name KGW_CTG_DLL_DSN PARMGEN name GBL_DSN_CICS_CTG_DLL Description This is the name of the CICS TG Dynamic Link Library. Related parameters None GBL_DSN_CICS_SCTGSID This PARMGEN-only parameter contains the name of the CICS TG side-deck library. Required or optional Optional Default value CTG.V8R0M0.SCTGSID Permissible values Character string, maximum length 44. PARMGEN name GBL_DSN_CICS_SCTGSID Description This is the name of the CICS TG side-deck library. Related parameters None GBL_DSN_CICS_SDFHC370 This PARMGEN-only parameter contains the name of the CICS load libraries for C support. Required or optional Optional Default value DFH.V4R2M5P.SDFHC370 Permissible values Character string, maximum length 44. 86 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference PARMGEN name GBL_DSN_CICS_SDFHC370 Description This is the name of the CICS load libraries for C support. Related parameters None GBL_DSN_CICS_SDFHLOAD This parameter contains the name of the CICS load libraries. Required or optional Optional Default value DFH.V4R2M5P.SDFHLOAD Permissible values Character string, maximum length 44. PARMGEN name GBL_DSN_CICS_SDFHLOAD Description This is the CICS load library, as described by the SDFHLOAD low-level qualifier in the IBM CICS documentation. Related parameters None GBL_DSN_CSF_SCSFMOD0 This PARMGEN-only parameter contains the ICSF load library that contains the CSNB* modules used for password encryption (if ICSF is installed and configured on the z/OS system). Required or optional Required if password encryption is to be enabled Batch parameter name KDS_CMS_SEC_ICSF_LOADLIB PARMGEN name GBL_DSN_CSF_SCSFMOD0 Description ICSF load library that contains the CSNB* modules used for password encryption (if ICSF is installed and configured on the z/OS system). Related parameters v “KDS_TEMS_SECURITY_KAES256_ENCKEY” on page 214 GBL_DSN_DB2_DSNEXIT This parameter contains the name of the DB2 exit library. Required or optional Optional In the Configuration Tool (ICAT) Chapter 3. Global (GBL) parameters 87 Panel name OMEGAMON XE for DB2 PE - DB2 libraries Panel ID KD261P0 Field Specify a DB2 exit library Default value DSN.V9R1M0.DSNEXIT Permissible values Character string, maximum length 44. Batch parameter name KD2_OMPE_DB2EXIT PARMGEN name GBL_DSN_DB2_DSNEXIT Description The name of the data set in which the DB2 exit load modules reside that should be used by the OMEGAMON collector. Related parameters v “GBL_DSN_DB2_LOADLIB_Vn” v “GBL_DSN_DB2_RUNLIB_Vn” on page 89 GBL_DSN_DB2_LOADLIB_Vn This parameter contains the name of the load library for the version of DB2 your site is running. Required or optional Required In the Configuration Tool (ICAT) Panel name OMEGAMON XE for DB2 PE - DB2 libraries Panel ID KD261P0 Field Specify DB2 load libraries Default value DSN.Vn.SDSNLOAD Permissible values Character string, maximum length 44. Batch parameter name KD2_OMPE_DB2LOADLIB_Vn PARMGEN name GBL_DSN_DB2_LOADLIB_Vn Description The name of the dataset in which the DB2 load modules reside. Specify one DB2 load library for each DB2 subsystem version that you want to monitor. Related parameters v “GBL_DSN_DB2_DSNEXIT” on page 87 v “GBL_DSN_DB2_RUNLIB_Vn” on page 89 88 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference GBL_DSN_DB2_RUNLIB_Vn This parameter contains the name of the run library for the version of DB2 your site is running. Required or optional Required In the Configuration Tool (ICAT) Panel name OMEGAMON XE for DB2 PE - DB2 libraries Panel ID KD261P0 Field Specify DB2 run libraries Default value DSN.Vn.RUNLIB Permissible values Character string, maximum length 44. Batch parameter name KD2_OMPE_DB2RUNLIB_Vn PARMGEN name GBL_DSN_DB2_RUNLIB_Vn Description The name of the dataset in which the DB2 RUNLIB load modules reside. Specify one DB2 run library for each DB2 subsystem version that you want to monitor. This library should contain the modules DSNTIAD and DSNTIAUL to be used to run in batch. The run library is used to generate GRANT and BIND jobs that prepare the DB2 subsystems for monitoring. Related parameters v “GBL_DSN_DB2_DSNEXIT” on page 87 v “GBL_DSN_DB2_LOADLIB_Vn” on page 88 GBL_DSN_DB2_SDSNLOAD This parameter contains the name of the DB2 load library. Required or optional N/A In the Configuration Tool (ICAT) Panel name Specify Configuration Values Panel ID KDO18P2 Field Load library: DB2 (DSNLOAD) Default value DSN.Vn.SDSNLOAD Permissible values Character string, maximum length 44. Batch parameter name KDO_DB2_LOADLIB KMC_CFG_MCDB2_LIB Chapter 3. Global (GBL) parameters 89 PARMGEN name GBL_DSN_DB2_SDSNLOAD Description The name of the data set in which the DB2 load modules reside. GBL_DSN_HZSPROC_LOADLIB This parameter contains the name of a load library that is usable by the Health Checker started task HZSPROC for assembling and linking health check modules. Required or optional Optional In the Configuration Tool (ICAT) Panel name Generate Health Check Configuration Parameters Panel ID KCIPHCK1 Field DSNAME Default value USER.LOADLIB Permissible values Character string, maximum length 44 Batch parameter name RTE_HCK_LOADLIB PARMGEN name GBL_DSN_HZSPROC_LOADLIB Description Name of a load library that is usable by the Health Checker started task HZSPROC for assembling and linking health check modules. This library can be in the HZSPROC STEPLIB or it can be a library in LNKLIST. Related parameters v “GBL_DSN_SYS1_SAXREXEC” on page 96 v “RTE_HCK_STC_INTERVAL” on page 110 GBL_DSN_IMS_RESLIB This parameter contains the name of the IMS RESLIB BMP interface. Required or optional Optional In the Configuration Tool (ICAT) Panel name IMS Subsystems Monitored Panel ID KI541P2 Field Specify the IMS.RESLIB Default value DFS.V12R0M0.SDFSRESL 90 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Permissible values Character string, maximum length 44. Batch parameter names KI5_IMS_RESLIB KI2_CLA_BMP_RESLIB KI2_I1_CLA_IMS_RESLIB PARMGEN name GBL_DSN_IMS_RESLIB Description The IMS.RESLIB library contains the CQSREG00 action module required to enable the Common Queue Server. The CQS and shared queues allow users to take advantage of the Parallel Sysplex environment. Related parameters None GBL_DSN_IMS_SCEXLINK This parameter contains the name of the IMS Connect product load library. Required or optional Optional In the Configuration Tool (ICAT) Panel name Job Names of Monitored IMS Connects Panel ID KI541PO4 Field IMS.SCEXLINK Default value IMS.SCEXLINK Permissible values Character string, maximum length 44. Batch parameter name KI5_ICT_SCEXLINK KI5_X_ICT_IMS_CONNECT_FLAG PARMGEN name GBL_DSN_IMS_SCEXLINK Description This specifies the IMS.SCEXLINK library. OMEGAMON XE for IMS on z/OS uses the IMS Connect Extensions Publisher API. The IMS Connect Extensions product and functional support libraries are required for the OMEGAMON XE for IMS agent to connect to and collect performance and statistics data from the IMS Connect address space. Related parameters None GBL_DSN_IMS_SFUNLINK This parameter contains the name of the IMS Connect functional load library. Chapter 3. Global (GBL) parameters 91 Required or optional Optional In the Configuration Tool (ICAT) Panel name Job Names of Monitored IMS Connects Panel ID KI541PO4 Field IMS.SFUNLINK Default value IMS.SFUNLINK Permissible values Character string, maximum length 44. Batch parameter name KI5_ICT_SFUNLINK KI5_X_ICT_IMS_CONNECT_FLAG PARMGEN name GBL_DSN_IMS_SFUNLINK Description OMEGAMON XE for IMS on z/OS uses the IMS Connect Extensions Publisher API. The IMS Connect Extensions product and functional support libraries are required for the OMEGAMON XE for IMS agent to connect to and collect performance and statistics data from the IMS Connect address space. Related parameters None GBL_DSN_ISP_SISPLOAD This PARMGEN-only parameter contains the name of the library that contains ISPLINK (SISPLOAD for ISPF Version 4 and above, or ISPLOAD for ISPF version 3 and below). Required or optional Optional Default value ISP.SISPLOAD Permissible values Character string, maximum length 44. PARMGEN name GBL_DSN_ISP_SISPLOAD Description This gives the name of the ISPF load library. Related parameters None GBL_DSN_NETVIEW_CNMLINK This parameter contains the name of the IBM Tivoli NetView CNMLINK load library, required for NetView authorization of Take Action commands. 92 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Required or optional Optional Batch parameter name KNA_NETV_LNKLIB PARMGEN name GBL_DSN_NETVIEW_CNMLINK Default value NETVIEW.VnRnMn.CNMLINK Description Name of the IBM Tivoli NetView CNMLINK load library, required for NetView authorization of Take Action commands. Contact your NetView or z/OS system programmer for the CNMLINK link library name, if necessary. The CNMLINK library must be APF-authorized. Related parameters v “KDS_PPI_RECEIVER” on page 190 v “KDS_PPI_SENDER” on page 191 GBL_DSN_SYS1_BRODCAST This PARMGEN-only parameter contains the name of the TSO broadcast data set name. Required or optional Optional Default value SYS1.BRODCAST Permissible values Character string, maximum length 44. PARMGEN name GBL_DSN_SYS1_BRODCAST Description SEND stores messages in the broadcast data set, and LISTBC retrieves them from the broadcast data set. GBL_DSN_SYS1_CSSLIB This PARMGEN-only parameter contains the name of the Unix System Services library. Required or optional Optional Default value SYS1.CSSLIB Permissible values Character string, maximum length 44. PARMGEN name GBL_DSN_SYS1_CSSLIB Description This library contains Assembler Callable Services. Related parameters None Chapter 3. Global (GBL) parameters 93 GBL_DSN_SYS1_HSMLOGY This parameter contains the name of the HSM LOGY dataset. Required or optional Optional In the Configuration Tool (ICAT) Panel name HSM Log Analysis Options Panel ID KDF55PO Field HSM LOGY dataset Default value SYS1.HSMLOGY Permissible values Character string, maximum length 44. Batch parameter name KDF_HSM_LOG_DSN PARMGEN name GBL_DSN_SYS1_HSMLOGY Description HSM log analysis periodically scans the HSM LOGY data set for new messages. Related parameters None GBL_DSN_SYS1_LINKLIB This PARMGEN-only parameter contains the name of the SYSLIB link library. Required or optional Optional Default value SYS1.LINKLIB Permissible values Character string, maximum length 44. PARMGEN name GBL_DSN_SYS1_LINKLIB Description This is typically the SYS1.LINKLIB library in the OMEGAMON Classic security jobs. Related parameters None GBL_DSN_SYS1_MACLIB This PARMGEN-only parameter contains the name of a system macro library for installed components and products. Required or optional Optional 94 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Batch parameter name Kpp_SYS1_MACLIB PARMGEN name GBL_DSN_SYS1_MACLIB Default value SYS1.MACLIB Description Name of a system macro library for installed components and products. To include more than one system macro library, define more than one GBL_DSN_SYS1_MACLIBn parameter, with a unique number substituted for n at the end of each parameter name (example: GBL_DSN_SYS1_MACLIB1, GBL_DSN_SYS1_MACLIB2, and so on). Related parameters None GBL_DSN_SYS1_MODGEN This PARMGEN-only parameter contains the name of the System Macro Library. Required or optional Optional Default value SYS1.MODGEN Permissible values Character string, maximum length 44. PARMGEN name GBL_DSN_SYS1_MODGEN Description This is the name of the system macro library. Related parameters None GBL_DSN_SYS1_PARMLIB This PARMGEN-only parameter contains the name of the system parameter library for installed components and products. Required or optional Required Batch parameter name KPP_ICS_DATASET PARMGEN name GBL_DSN_SYS1_PARMLIB Default value SYS1.PARMLIB Description Name of the system parameter library for installed components and products. Related parameters None Chapter 3. Global (GBL) parameters 95 GBL_DSN_SYS1_PROCLIB This parameter contains the name of the system library that is to contain the started tasks and procedures. In the Configuration Tool (ICAT) Panel name Generate Sample System Copy JCL Panel ID KCIPSYSP Field System procedure Default value SYS1.PROCLIB Permissible values Character string, maximum length 44 Batch parameter name RTE_SYS_PROCLIB PARMGEN name GBL_DSN_SYS1_PROCLIB Description Name of the system library that is to contain the started tasks and procedures. You can specify any system library if you do not want to update your PROCLIB library directly. Related parameters None GBL_DSN_SYS1_SAXREXEC This PARMGEN-only parameter contains the name of the system library where the Health Checker REXX code is stored. Required or optional Optional PARMGEN name GBL_DSN_SYS1_SAXREXEC Default value SYS1.SAXREXEC Description Name of the system library where the Health Checker REXX code is stored. Related parameters v “GBL_DSN_HZSPROC_LOADLIB” on page 90 v “RTE_HCK_STC_INTERVAL” on page 110 GBL_DSN_SYS1_SBLSCLI0 This PARMGEN-only parameter contains the name of the system library that contains interactive problem control system (IPCS) CLISTs and REXX execs. Required or optional Optional 96 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference PARMGEN name GBL_DSN_SYS1_SBLSCLI0 Default value SYS1.SBLSCLI0 Description Name of the system library that contains interactive problem control system (IPCS) CLISTs and REXX execs. Related parameters None GBL_DSN_SYS1_SBPXEXEC This parameter is the z/OS UNIX System Services (USS) CLIST/EXEC library name. Required or optional Required Location where the parameter value is stored N/A In the Configuration Tool (ICAT) Panel name TEMS: Specify TEMS Self-Describing Agent Values Agents: Specify Linkedit Libraries Panel ID KDS62PP4 KD471PPM KQI70PLE Field USS CLIST library Default value SYS1.SBPXEXEC Permissible values Character string, maximum length 44. Batch parameter name TEMS: KDS_USS_EXEC Agents: Kpp_USS_EXEC PARMGEN name GBL_DSN_SYS1_SBPXEXEC Description This is the z/OS USS CLIST/EXEC library that contains the oshell command to perform the symbolic link. These are described by the SBPXEXEC low-level qualifier in the IBM z/OS UNIX System Services documentation. Related parameters v “RTE_USS_RTEDIR” on page 146 v v v v “KDS_KMS_SDA” on page 167 “KDS_TEMA_SDA” on page 196 “KPP_AGT_TEMA_SDA” on page 33 “GBL_HFS_JAVA_DIRn” on page 103 Chapter 3. Global (GBL) parameters 97 GBL_DSN_SYS1_SISTMAC1 This parameter contains the name of the system library that contains the VTAM macros. Required or optional Optional In the Configuration Tool (ICAT) Panel name Create LU6.2 Logmode Panel ID KDS62PLU Field IBM VTAM macro library Default value SYS1.SISTMAC1 Permissible values Character string, maximum length 44 Batch parameter name KDS_CMS_VTM_MACLIB PARMGEN name GBL_DSN_SYS1_SISTMAC1 Description Name of the system library that contains the VTAM macros. The default is SYS1_SISTMAC1. Related parameters None GBL_DSN_SYS1_VTAMLIB This parameter contains the name of the system library that contains the VTAM logmode tables. Required or optional Optional In the Configuration Tool (ICAT) Panel name Create LU6.2 Logmode Panel ID KDS62PLU Field VTAM load library Default value SYS1.VTAMLIB Permissible values Character string, maximum length 44 Batch parameter name KDS_CMS_VTM_LOADLIB PARMGEN name GBL_DSN_SYS1_VTAMLIB Description Name of the system library that contains the VTAM logmode tables. 98 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Related parameters v “RTE_VTAM_LU62_MODETAB” on page 150 GBL_DSN_SYS1_VTAMLST This parameter contains the name of the system VTAMLST library. Required or optional Required In the Configuration Tool (ICAT) Panel name Generate Sample System Copy JCL Panel ID KCIPSYSP Field System VTAMLST Default value SYS1.VTAMLST Permissible values Character string, maximum length 44 Batch parameter name RTE_SYS_VTAMLST PARMGEN name GBL_DSN_SYS1_VTAMLST Description Name of the system VTAMLST library. Related parameters v “RTE_VTAM_NETID” on page 151 GBL_DSN_TCP_ETC_SERVICES This PARMGEN-only parameter contains the name of the TCP/IP network services. Required or optional Optional Default value TCPIP.ETC.SERVICES Permissible values Character string, maximum length 44. PARMGEN name GBL_DSN_TCP_ETC_SERVICES Description TCP/IP network services such as NIS, DNS, and the /etc/hosts file. Related parameters None GBL_DSN_TCP_SEZACMTX This PARMGEN-only parameter contains the name of the TCP/IP load libraries. Chapter 3. Global (GBL) parameters 99 Required or optional Optional Default value EZA.SEZACMTX Permissible values Character string, maximum length 44. PARMGEN name GBL_DSN_TCP_SEZACMTX Description This is the TCP/IP load library for linking user modules and programs, as described for the SEZACMTX low-level qualifier in the IBM TCP/IP for z/OS documentation. This is a required field if any of the directory services use TCP/IP communications, such as a directory service that has been configured as a directory server. Related parameters None GBL_DSN_TCP_SEZARNT1 This PARMGEN-only parameter contains the name of the TCP/IP Reentrant Object Module Library. Required or optional Optional Default value EZA.SEZARNT1 Permissible values Character string, maximum length 44. PARMGEN name GBL_DSN_TCP_SEZARNT1 Description This is the TCP/IP Reentrant object module library for linking user modules and programs, as described for the SEZARNT1 low-level qualifier in the IBM TCP/IP for MVS documentation. This is a required field if any of the directory services use TCP/IP communications, such as a directory service that has been configured as a directory server. Related parameters None GBL_DSN_TCP_SEZATCP This PARMGEN-only parameter contains the name of the TCP/IP executable libraries. Required or optional Optional Default value EZA.SEZATCP Permissible values Character string, maximum length 44. PARMGEN name GBL_DSN_TCP_SEZATCP Description This is the TCP/IP executable load library used for STEPLIB or LINKLIB concatenation, as 100 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference described for the SEZATCP low-level qualifier in the IBM TCP/IP for MVS documentation. This is a required field if any of the directory services use TCP/IP communications, such as a directory service that has been configured as a directory server. Related parameters None GBL_DSN_TCP_SYSTCPD_TCPDATA This parameter contains the name of the system library to use in obtaining the parameters defined by TCPIP.DATA when no GLOBALTCPIPDATA statement is configured. Required or optional Optional Default value TCPIP.SEZAINST Batch parameter name Kpp_TCP_DATA PARMGEN name GBL_DSN_TCP_SYSTCPD_TCPDATA Description Name of the system library to use in obtaining the parameters defined by TCPIP.DATA when no GLOBALTCPIPDATA statement is configured. If IP domain name resolution is not fully configured on the z/OS system, SYSTCPD must be supported by the monitoring server and monitoring agents on z/OS. Related parameters None GBL_DSN_TCP_SYSTCPD_TCPDATA_MFN This parameter contains the name of the TCP/IP data file. Required or optional Required In the Configuration Tool (ICAT) Panel name SPECIFY COMPONENT CONFIGURATION (Page 1) Panel ID KN341P2 Field TCP/IP data file Default value TCPIP.SEZAINST(TCPDATA) Permissible values Character string, maximum length 54 (with the member name). Batch parameter name Kpp_TCP_DATA PARMGEN name GBL_DSN_TCP_SYSTCPD_TCPDATA_MFN Description This specifies the data set name of the library described in the z/OS Communications Server IP Chapter 3. Global (GBL) parameters 101 Configuration Reference", section "Configuration Datasets", which provides parameters for TCP/IP client programs. Specify this dsname if your site is running z/OS V1R4 or above. Related parameters None GBL_DSN_WMQ_SCSQANLE This parameter contains the name of the IBM WebSphere MQ language library. Required or optional Optional In the Configuration Tool (ICAT) Panel name Specify Configuration Parameters Panel ID KMC70PPM KMQ70PPM Field IBM-supplied WebSphere MQ language library Default value IBM.WMQ.SCSQANLE Permissible values Character string, maximum length 44. Batch parameter name Kpp_MQS_LANGLIB PARMGEN name GBL_DSN_WMQ_SCSQANLE Description This is the IBM-supplied library that provides national language support. Related parameters None GBL_DSN_WMQ_SCSQAUTH This parameter contains the name of the IBM WebSphere MQ authorized load library. Required or optional Required In the Configuration Tool (ICAT) Panel name Specify Configuration Parameters Panel ID KMC70PPM KMQ70PPM KQI70PLE Field IBM-supplied WebSphere MQ authorized load library Default value IBM.WMQ.SCSQAUTH 102 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Permissible values Character string, maximum length 44. Batch parameter name Kpp_MQS_AUTHLIB PARMGEN name GBL_DSN_WMQ_SCSQAUTH Description This is the IBM-supplied library that contains the WebSphere MQ API modules required to execute OMEGAMON XE for WebSphere MQ. The data set name you specify here will be added to the started task JCL. Related parameters v “GBL_DSN_WMQ_SCSQANLE” on page 102 v “GBL_DSN_WMQ_SCSQLOAD” GBL_DSN_WMQ_SCSQLOAD This parameter contains the name of the WebSphere MQ load library. Required or optional Required In the Configuration Tool (ICAT) Panel name Specify Linkedit Libraries Panel ID KQI70PLE Field Load library (SCSQLOAD) Default value IBM.WMQ.SCSQLOAD Permissible values Character string, maximum length 44. Batch parameter name KQI_MQS_LOADLIB PARMGEN name GBL_DSN_WMQ_SCSQLOAD Description This is the WebSphere MQ load library that contains load modules for non-APF code, user exits, utilities, samples, installation verification programs, and adapter stubs. Related parameters v “GBL_DSN_WMQ_SCSQAUTH” on page 102 GBL_HFS_JAVA_DIRn This parameter contains the name of the Java home directory. Required or optional Required Location where the parameter value is stored The TEMS_JAVA_BINPATH parameter in the RKANDATV data set, member KDSDPROF. Chapter 3. Global (GBL) parameters 103 In the Configuration Tool (ICAT) Panel name Specify TEMS Self-Describing Agent Values Panel ID KDS62PP4 Field JavaRoot home directory for TEMS_JAVA_BINPATH Default value /usr/lpp/java/IBM/J6.0 Permissible values Character string, maximum length 38 Batch parameter name KDS_HFS_JAVA_DIRn PARMGEN name GBL_HFS_JAVA_DIRn Description The name of the Java home directory. The default is /usr/lpp/java/IBM/J6.0. This directory must begin with a "/". Related parameters v “RTE_USS_RTEDIR” on page 146 v “KDS_KMS_SDA” on page 167 v “KDS_TEMA_SDA” on page 196 v “KPP_AGT_TEMA_SDA” on page 33 v “GBL_DSN_SYS1_SBPXEXEC” on page 97 GBL_INST_HILEV This PARMGEN-only parameter contains the high-level qualifier (shilev) of the installation libraries (INSTJOBS, INSTDATA, and so on). Required or optional Required PARMGEN name GBL_INST_HILEV Description High-level qualifier (shilev) of the installation libraries (INSTJOBS, INSTDATA, and so on). Related parameters v “GBL_TARGET_HILEV” GBL_TARGET_HILEV This PARMGEN-only parameter contains the high-level qualifier (thilev) of the target libraries that were installed by SMP/E (for example, TKANDATV and TKANMOD). Required or optional Required PARMGEN name GBL_TARGET_HILEV 104 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Description High-level qualifier (thilev) of the target libraries that were installed by SMP/E (for example, TKANDATV and TKANMOD). Related parameters v “GBL_INST_HILEV” on page 104 GBL_USER_JCL This PARMGEN-only parameter contains the user JCL library where the KCIJPCFG PARMGEN configuration job is to be customized. Required or optional Required PARMGEN name GBL_USER_JCL Description User JCL library where the KCIJPCFG PARMGEN configuration job is to be customized. Related parameters None Chapter 3. Global (GBL) parameters 105 106 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Chapter 4. Runtime environment (RTE) parameters The runtime environment parameters provide configuration settings for an individual runtime environment and default settings for the OMEGAMON components and products configured in that runtime environment, including the end-to-end response-time analysis feature. The runtime environment parameters are explained in this section. RTE_BASE_NAME This parameter contains the mid-level qualifier for base runtime library allocations. Required or optional Optional In the Configuration Tool (ICAT) Panel name Add Runtime Environment Panel ID KCIPRTAB Field Mid-level qualifier Default value Base runtime environment name Permissible values Character string, maximum length 8 Batch parameter name RTE_BASE_MIDLEV PARMGEN name RTE_BASE_NAME Description Mid-level qualifier for base runtime library allocations. Accept the default value (the base runtime environment name), even though this parameter is modifiable for base runtime environments. For full and sharing runtime environments, the mid-level qualifier is set to the runtime environment name (RTE_NAME parameter value) and cannot be changed. Related parameters v “RTE_NAME” on page 117 v “RTE_TYPE” on page 145 v “RTE_HILEV” on page 110 v “RTE_VSAM_HILEV” on page 148 RTE_CANSCN_STC This parameter gives the name of the Candle subsystem started task. Required or optional Optional In the Configuration Tool (ICAT) © Copyright IBM Corp. 2010, 2012 107 Panel name Specify Configuration Parameters Panel ID KCNPPR1 Field Started task Default value CANSCN Permissible values Character string, maximum length 8. Batch parameter name RTE_CAN_SS_STC PARMGEN name RTE_CANSCN_STC Description This is the name of the started task that will be constructed for the Candle subsystem. Related parameters v “RTE_KCNSTR00_SSID” on page 113 v “RTE_KCNSTR00_XCFGROUP” on page 114 v “RTE_KCNSTR00_WTO” on page 113 v “RTE_KCNDLSSI_IEFSSN00_FORMAT” on page 112 v “RTE_X_KCNSTR00_REFRESH” on page 153 v “RTE_X_KCNSTR00_PLEXCOLLECT” on page 152 v “RTE_X_KCNDLSSI_INITPARM_FLAG” on page 151 RTE_CANSETE_STC This parameter contains the name of the started task that measures end-to-end response-time performance. Required or optional Optional In the Configuration Tool (ICAT) Panel name Specify Configuration values Panel ID KC256PR KI256PP KM255P1 Field End-to-End (ETE) Default value CANSETE Permissible values Character string, maximum length 8. Batch parameter name RTE_ETE_STC PARMGEN name RTE_CANSETE_STC 108 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Description The started task name for the end-to-end server. Related parameters None RTE_DEBUG_SYSOUT This parameter contains the SYSOUT class for diagnostic output DDNAMEs, such as SYSUDUMP and SYSABEND, in generated JCL. Required or optional Required In the Configuration Tool (ICAT) Panel name v (For a base runtime environment) Add Runtime Environment v (For a full or sharing runtime environment) Add Runtime Environment (1 of 3) Panel ID v (For a base runtime environment) KCIPRTAB v (For a full or sharing runtime environment) KCIPRTEA Field Diagnostic SYSOUT class Default value X Permissible values 1 character Batch parameter name RTE_DEBUG_SYSOUT PARMGEN name RTE_DEBUG_SYSOUT Description SYSOUT class for diagnostic output DDNAMEs, such as SYSUDUMP and SYSABEND, in generated JCL. Related parameters v “RTE_LOG_SYSOUT” on page 116 RTE_DESCRIPTION This parameter contains the description of the runtime environment. Required or optional Optional In the Configuration Tool (ICAT) Panel name Runtime Environments (RTEs) Panel ID KCIPRTE Field Description Default value None Chapter 4. Runtime environment (RTE) parameters 109 Permissible values Character string, maximum length 46 Batch parameter name RTE_DESC PARMGEN name RTE_DESCRIPTION Description Description of the runtime environment. Related parameters v “RTE_NAME” on page 117 v “RTE_TYPE” on page 145 v “RTE_SHARE” on page 128 RTE_HCK_STC_INTERVAL This parameter contains the Interval (in minutes) for running a health check to verify that all started tasks configured for a runtime environment are running. Required or optional Optional In the Configuration Tool (ICAT) Panel name Generate Health Check Configuration Parameters Panel ID KCIPHCK1 Field Interval Default value 30 Permissible values 10 - 1440 Batch parameter name RTE_HCK_INTERVAL PARMGEN name RTE_HCK_STC_INTERVAL Description Interval (in minutes) for running a health check to verify that all started tasks configured for a runtime environment are running. Related parameters v “GBL_DSN_HZSPROC_LOADLIB” on page 90 v “GBL_DSN_SYS1_SAXREXEC” on page 96 RTE_HILEV This parameters contains the non-VSAM high-level qualifier to be used for allocating the runtime data sets. Required or optional Required 110 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference In the Configuration Tool (ICAT) Panel name v (For a base runtime environment) Add Runtime Environment v (For a full or sharing runtime environment) Add Runtime Environment (1 of 3) Panel ID v (For a base runtime environment) KCIPRTAB v (For a full or sharing runtime environment) KCIPRTEA Field High-level Qualifier (Non-VSAM) Default value None Permissible values Character string, maximum length 26 Batch parameter name RTE_HILEV PARMGEN name RTE_HILEV Description Non-VSAM high-level qualifier to be used for allocating the runtime data sets. If you plan to allocate SMS-managed data sets for the runtime environment, the high-level qualifier that you specify must be eligible for SMS-managed volumes. For PARMGEN configuration, the value of this parameter for a sharing runtime environment must be the same as the value for the shared runtime environment. For detailed information about sharing and shared runtime environments, see the "Planning your deployment" chapter of IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Related parameters v “RTE_VSAM_HILEV” on page 148 v “RTE_BASE_NAME” on page 107 v “RTE_TYPE” on page 145 RTE_JCL_SUFFIX This parameter contains the unique JCL suffix to identify the batch job members created by the Configuration Tool for this runtime environment in the shilev.INSTJOBS data set. Required or optional Required In the Configuration Tool (ICAT) Panel name v (For a base runtime environment) Add Runtime Environment v (For a full or sharing runtime environment) Add Runtime Environment (1 of 3) Panel ID v (For a base runtime environment) KCIPRTAB v (For a full or sharing runtime environment) KCIPRTEA Field JCL suffix Chapter 4. Runtime environment (RTE) parameters 111 Default value None Permissible values Character string, maximum length 4 Batch parameter name RTE_JCL_SUFF PARMGEN name RTE_JCL_SUFFIX Description Unique JCL suffix to identify the batch job members created by the Configuration Tool for this runtime environment in the shilev.INSTJOBS data set. If possible, specify the runtime environment name (or an abbreviated version of the runtime environment name) as the JCL suffix. This setup makes it easy to identify the runtime environment associated with each job generated by the Configuration Tool and stored in the INSTJOBS data set. Related parameters None RTE_KCNDLSSI_IEFSSN00_FORMAT This parameter contains the IEFSSN00 format. Required or optional Optional In the Configuration Tool (ICAT) Panel name Specify Configuration values Panel ID KCNPPR1 Field IEFSSN00 format Default value K Permissible values P, K Batch parameter name RTE_CAN_SS_IEFSSN_FMT PARMGEN name RTE_KCNDLSSI_IEFSSN00_FORMAT Description This field specifies the format found in the IEFSSN00 member in the PARMLIB dataset. This member can have one of two formats: Keyword format allows for dynamic subsystem processing. This is the preferred format for this member when your version of z/OS allows it. Specify K for this field if the member is in Keyword format. Positional format is for compatibility. Specify P for this field if the member appears as follows: CNDL,KCNDLINT,’SSPROC=CANSCN’ 112 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Although both formats can be used, z/OS requires that all the commands in a single concatenation member follow the same format. Related parameters v “RTE_KCNSTR00_SSID” v “RTE_KCNSTR00_WTO” v “RTE_KCNSTR00_XCFGROUP” on page 114 RTE_KCNSTR00_SSID This parameter contains the Candle subsystem ID. Required or optional Optional In the Configuration Tool (ICAT) Panel name Specify Configuration Parameters Panel ID KCNPPR1 Field Subsystem ID Default value CNDL Permissible values Character string, maximum length 4. Batch parameter name RTE_CAN_SSID PARMGEN name RTE_KCNSTR00_SSID Description This field specifies the four-character identifier of the Candle subsystem. The Candle subsystem is shipped with a predefined ID set to CNDL. If you change this value, be sure that all references to the subsystem ID in other products configured in this runtime environment are consistent with this value. Related parameters v “RTE_CANSCN_STC” on page 107 v “RTE_KCNDLSSI_IEFSSN00_FORMAT” on page 112 v “RTE_KCNSTR00_WTO” v “RTE_KCNSTR00_XCFGROUP” on page 114 RTE_KCNSTR00_WTO This parameter writes the IXCQUERY message to the z/OS console. Required or optional Optional In the Configuration Tool (ICAT) Panel name Specify Configuration Parameters Chapter 4. Runtime environment (RTE) parameters 113 Panel ID KCNPPR1 Field IXCQUERY WTO message Default value ERROR Permissible values NO, ALL, ERROR Batch parameter name RTE_CAN_SS_WTO PARMGEN name RTE_KCNSTR00_WTO Description This field specifies the IXCQUERY WTO messaging mode to determine if warning and error messages will be written to the z/OS operator console. It allows error, warnings, and key informational messages from the Candle subsystem that are associated with the Coupling Facility Collection enhancement. It also allows automation to take action for problem conditions. All Candle subsystems within a sysplex must have the same value for this parameter. Error is the default. All allows warning, error, and full diagnostic processing messages that are associated with the Coupling Facility Collection enhancement. No prevents all messages from the Candle subsystem that are associated with the Coupling Facility Collection enhancement from being written to the z/OS operator console. Related parameters v “RTE_CANSCN_STC” on page 107 v “RTE_KCNDLSSI_IEFSSN00_FORMAT” on page 112 v “RTE_KCNSTR00_SSID” on page 113 v “RTE_KCNSTR00_XCFGROUP” RTE_KCNSTR00_XCFGROUP This parameter contains the Candle subsystem XCF group name. Required or optional Optional In the Configuration Tool (ICAT) Panel name Specify Configuration Parameters Panel ID KCNPPR1 Field XCF group name Default value KCNXCFCF Permissible values Character string, maximum length 8. Batch parameter name RTE_CAN_SS_XCF_GRP 114 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference PARMGEN name RTE_KCNSTR00_XCFGROUP Description This is the XCF group name to be used by the Candle subsystems to share collected data within a sysplex. This value must be a unique name for this sysplex conforming to the naming rules for XCF groups (characters comprising alphabetics, numerals, and national characters). Every Candle subsystem configured within a sysplex must use the same value. Related parameters v “RTE_CANSCN_STC” on page 107 v “RTE_KCNDLSSI_IEFSSN00_FORMAT” on page 112 v “RTE_KCNSTR00_SSID” on page 113 v “RTE_KCNSTR00_WTO” on page 113 RTE_LOAD_OPTIMIZE The parameter determines whether to optimize the loading of the runtime environment after maintenance is applied or products are reconfigured. Required or optional Required In the Configuration Tool (ICAT) Panel name v (For a base runtime environment) Add Runtime Environment v (For a full or sharing runtime environment) Add Runtime Environment (1 of 3) Panel ID v (For a base runtime environment) KCIPRTAB v (For a full or sharing runtime environment) KCIPRTEA Field Load optimization Default value N Permissible values Y or N Batch parameter name RTE_LOAD_OPTIMIZE PARMGEN name RTE_LOAD_OPTIMIZE Description Determines whether to optimize the loading of the runtime environment after maintenance is applied or products are reconfigured. (Load optimization takes effect on the second and subsequent load operations but not on the initial loading.) If v v v v you specify Y, the load job has the following characteristics: Copies only modified modules from target to runtime libraries. Requires access to IBM's SuperC (ISRSUPC) utility. Uses less DASD space. Performs additional analysis, which uses more CPU processing and file I/O. If you specify N (the default), the load job has the following characteristics: v Copies all members from target to runtime libraries, whether or not they were modified. v Requires more DASD space. Chapter 4. Runtime environment (RTE) parameters 115 v Uses less CPU time. Related parameters None RTE_LOAD_SHARED_LIBS This parameter determines whether to include the shared libraries of a base or full runtime environment in the Load job of a sharing-with-base or sharing-with-full runtime environment. Required or optional Required In the Configuration Tool (ICAT) Panel name Confirmation - Load Shared RTE Datasets Panel ID KCIPSHLD Field Do you want to include these datasets in the RTE Load? Default value Y Permissible values Y or N Batch parameter name RTE_LOAD_SHARED_LIBS PARMGEN name RTE_LOAD_SHARED_LIBS Description Determines whether to include the shared libraries of a base or full runtime environment in the Load job of a sharing-with-base or sharing-with-full runtime environment. Accept the default value (Y) to ensure that all maintenance is loaded properly into the runtime environment. Related parameters v “RTE_TYPE” on page 145 v “RTE_SHARE” on page 128 RTE_LOG_SYSOUT This parameter contains the SYSOUT class for non-diagnostic output DDNAMEs, such as RKPDLOG, in generated JCL. Required or optional Required In the Configuration Tool (ICAT) Panel name v (For a base runtime environment) Add Runtime Environment v (For a full or sharing runtime environment) Add Runtime Environment (1 of 3) Panel ID v (For a base runtime environment) KCIPRTAB v (For a full or sharing runtime environment) KCIPRTEA Field 116 SYSOUT class IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Default value X Permissible values 1 character Batch parameter name RTE_LOG_SYSOUT PARMGEN name RTE_LOG_SYSOUT Description SYSOUT class for non-diagnostic output DDNAMEs, such as RKPDLOG, in generated JCL. Related parameters v “RTE_DEBUG_SYSOUT” on page 109 RTE_NAME This parameter contains the unique name that identifies the runtime environment. Required or optional Required In the Configuration Tool (ICAT) Panel name Runtime Environments (RTEs) Panel ID KCIPRTE Field Name Default value None Permissible values Character string, maximum length 8 Batch parameter name RTE_NAME PARMGEN name RTE_NAME Description Unique name that identifies the runtime environment. This name is appended to the high-level qualifiers specified in the “RTE_HILEV” on page 110 and “RTE_VSAM_HILEV” on page 148 parameters, to make each set of runtime libraries unique. Related parameters v “RTE_HILEV” on page 110 v “RTE_VSAM_HILEV” on page 148 RTE_PDS_BATCHINIT_FLAG This PARMGEN-only parameter determines if the BATCHINIT parameter is generated in the &rhilev.&rte.RKANSAMU(KppPCTL) Persistent Datastore RKPDIN DD command EXEC startup member. rte_pds_batchinit_flag Chapter 4. Runtime environment (RTE) parameters 117 Required or optional Optional Location where the parameter value is stored Value determines if the BATCHINIT parameter is generated in the &rhilev. &rte.RKANSAMU(KppPCTL) Persistent Datastore RKPDIN DD command EXEC startup member. Parameter name and syntax BATCHINIT if the flag is Y. Syntax is: MAINTPRC PROC=KPDPROC1 GENPROC BATCHINIT Default value N Permissible values Y, N PARMGEN name RTE_PDS_BATCHINIT_FLAG Description This parameter determines if the BATCHINIT parameter is generated in the &rhilev. &rte.RKANSAMU(KppPCTL) Persistent Datastore RKPDIN DD command EXEC startup member. Determines the Persistent Datastore (PDS) settings for xKANPARU(KppPCTL), xKANPARU(KppPG), xKANPARU(KppDEFIN) and xKANPARU(KppAL) Persistent Datastore control member options. Related parameters v “KPP_PD” on page 42 v “KPP_PD_CYL” on page 43 v “KPP_PD_GRP” on page 44 v “KPP_PD_HISTCOLL_DATA_IN_AGT_STC” on page 45 v “KPP_PD_HISTCOLL_DATA_IN_TEMS_STC” on page 46 v “KPP_PD_ROW” on page 47 v “KPP_X_PD_HISTCOLL_DATA_AGT_STC” on page 79 v “KPP_X_PD_HISTCOLL_DATA_TEMS_STC” on page 79 v “RTE_PDS_BACKUP_FLAG” v v v v v “RTE_PDS_BATCHINIT_FLAG” on page 117 “RTE_PDS_EXPORT_FLAG” on page 119 “RTE_PDS_EXTRACT_FLAG” on page 120 “RTE_PDS_FILE_COUNT” on page 120 “RTE_PDS_HILEV” on page 121 v “RTE_PDS_KPDPROC_PREFIX” on page 122 v “RTE_PDS_SMS_MGMTCLAS” on page 122 v “RTE_PDS_SMS_STORCLAS” on page 123 v “RTE_PDS_SMS_UNIT” on page 123 v “RTE_PDS_SMS_VOLUME” on page 124 RTE_PDS_BACKUP_FLAG This parameter determines whether to perform backup operations on data sets used by the persistent data store. Required or optional Optional In the Configuration Tool (ICAT) 118 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Panel name Modify and Review Datastore Specifications Panel ID KPD62PP3 Field Backup Default value N Permissible values Y or N Batch parameter name RTE_PDS_BU PARMGEN name RTE_PDS_BACKUP_FLAG Description Determines whether to perform backup operations on data sets used by the persistent data store. Backups enable you to keep a copy of the data sets on either tape or DASD. You can then make the data available to the persistent data store again whenever you want. For detailed information on maintaining the persistent data store, see IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Related parameters v “RTE_PDS_KPDPROC_PREFIX” on page 122 v “RTE_PDS_EXPORT_FLAG” v “RTE_PDS_EXTRACT_FLAG” on page 120 RTE_PDS_EXPORT_FLAG This parameter determines whether to export data sets used by the persistent data store. Required or optional Optional In the Configuration Tool (ICAT) Panel name Modify and Review Datastore Specifications Panel ID KPD62PP3 Field Export Default value N Permissible values Y or N Batch parameter name RTE_PDS_EXP PARMGEN name RTE_PDS_EXPORT_FLAG Description Determines whether to export data sets used by the persistent data store. The Export option converts the data sets to flat (ASCII) files in an internal format that can be used by other Chapter 4. Runtime environment (RTE) parameters 119 applications. The exported data can also be used for recovery when the persistent data store detects potential problems with its data. To make the exported file available to the persistent data store program again requires the restore program, KPDREST, to be run against the exported data. For detailed information on maintaining the persistent data store, see IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Related parameters v “RTE_PDS_KPDPROC_PREFIX” on page 122 v “RTE_PDS_BACKUP_FLAG” on page 118 v “RTE_PDS_EXTRACT_FLAG” RTE_PDS_EXTRACT_FLAG This parameters determines whether to write the data to a flat file in human-readable form, which is suitable for loading into other database management systems. Required or optional Optional In the Configuration Tool (ICAT) Panel name Modify and Review Datastore Specifications Panel ID KPD62PP3 Field Extract Default value N Permissible values Y or N Batch parameter name RTE_PDS_EXT PARMGEN name RTE_PDS_EXTRACT_FLAG Description Determines whether to write the data to a flat file in human-readable form, which is suitable for loading into other database management systems. The data is extracted from a full data set in EBCDIC form, but the extraction does not empty the data set. The data set is not initialized until it becomes a candidate for being emptied, so the most current data becomes available in an extracted form without that data being lost. For detailed information on maintaining the persistent data store, see IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Related parameters v “RTE_PDS_KPDPROC_PREFIX” on page 122 v “RTE_PDS_BACKUP_FLAG” on page 118 v “RTE_PDS_EXPORT_FLAG” on page 119 RTE_PDS_FILE_COUNT This parameter contains the number of historical data sets in the group defined by the Kpp_PD_GRP parameter. 120 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Required or optional Optional In the Configuration Tool (ICAT) Panel name Modify and Review Datastore Specifications Panel ID KPD62PP3 Field Count Default value 3 Permissible values See Description. Batch parameter name RTE_PDS_CNT PARMGEN name RTE_PDS_FILE_COUNT Description Number of historical data sets in the group defined by the Kpp_PD_GRP parameter. The value specified for this parameter is applied to every product configured in the runtime environment. The default value is 3, but the best value for the following products is 7: v IBM Tivoli OMEGAMON XE for CICS® on z/OS v IBM Tivoli OMEGAMON XE for Mainframe Networks v IBM Tivoli OMEGAMON XE on z/OS Therefore, set a value of 7 if OMEGAMON XE for CICS on z/OS, OMEGAMON XE for Mainframe Networks, or OMEGAMON XE on z/OS is to be configured in the runtime environment. Related parameters v “KDS_PD_GRP” on page 179 v Product-specific Kpp_PD_GRP parameters RTE_PDS_HILEV This parameter contains the high-level qualifier for the persistent data store libraries. Required or optional Required In the Configuration Tool (ICAT) Panel name Specify Persistent Datastore Values Panel ID KCIPIR4 or KDSPP3 Field Datastore high-level prefix Default value rhilev.rte Permissible values Character string, maximum length 35 Chapter 4. Runtime environment (RTE) parameters 121 Batch parameter name RTE_PDS_HILEV PARMGEN name RTE_PDS_HILEV Description High-level qualifier for the persistent data store libraries. Related parameters None RTE_PDS_KPDPROC_PREFIX This parameter contains the prefix of the started task name that will be used to perform maintenance on the data sets written by the persistent data store. Required or optional Required In the Configuration Tool (ICAT) Panel name Specify Persistent Datastore Values Panel ID KCIPIR4 or KDSPP3 Field Maintenance procedure prefix Default value KPDPROC Permissible values Character string, maximum length 7 Batch parameter name RTE_PDS_PROC_PREF PARMGEN name RTE_PDS_KPDPROC_PREFIX Description Prefix of the started task name that will be used to perform maintenance on the data sets written by the persistent data store. For detailed information on maintaining the persistent data store, see IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Related parameters v “RTE_PDS_BACKUP_FLAG” on page 118 v “RTE_PDS_EXPORT_FLAG” on page 119 v “RTE_PDS_EXTRACT_FLAG” on page 120 RTE_PDS_SMS_MGMTCLAS This parameter contains the SMS management class to be used for data set allocation for the persistent data store. Required or optional Optional In the Configuration Tool (ICAT) 122 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Panel name Specify Persistent Datastore Values Panel ID KCIPIR4 or KDSPP3 Field Allocation MGMTCLAS Default value None Permissible values Character string, maximum length 8 Batch parameter name RTE_PDS_SMS_MGMT_CLAS PARMGEN name RTE_PDS_SMS_MGMTCLAS Description SMS management class to be used for data set allocation for the persistent data store. Related parameters v “RTE_PDS_SMS_STORCLAS” RTE_PDS_SMS_STORCLAS This parameters contains the SMS storage class to be used for data set allocation for the persistent data store. Required or optional Optional In the Configuration Tool (ICAT) Panel name Specify Persistent Datastore Values Panel ID KCIPIR4 or KDSPP3 Field Allocation STORCLAS Default value None Permissible values Character string, maximum length 8 Batch parameter name RTE_PDS_SMS_STOR_CLAS PARMGEN name RTE_PDS_SMS_STORCLAS Description SMS storage class to be used for data set allocation for the persistent data store. Related parameters v “RTE_PDS_SMS_MGMTCLAS” on page 122 RTE_PDS_SMS_UNIT This parameter contains the default unit for non-SMS data set allocation for the persistent data store. Chapter 4. Runtime environment (RTE) parameters 123 Required or optional Required if the runtime data sets are not to be managed by SMS; optional otherwise. In the Configuration Tool (ICAT) Panel name Specify Persistent Datastore Values Panel ID KCIPIR4 or KDSPP3 Field Allocation unit Default value None Permissible values Character string, maximum length 8 Batch parameter name RTE_PDS_UNIT PARMGEN name RTE_PDS_SMS_UNIT Description Default unit for non-SMS data set allocation for the persistent data store. Related parameters v “RTE_PDS_SMS_VOLUME” RTE_PDS_SMS_VOLUME This parameter contains the default volume serial number for non-SMS data set allocation for the persistent data store. Required or optional Required if the runtime data sets are not to be managed by SMS; optional otherwise. In the Configuration Tool (ICAT) Panel name Specify Persistent Datastore Values Panel ID KCIPIR4 or KDSPP3 Field Allocation volume Default value None Permissible values Character string, maximum length 6 Batch parameter name RTE_PDS_VOL PARMGEN name RTE_PDS_SMS_VOLUME Description Default volume serial number for non-SMS data set allocation for the persistent data store. Related parameters v “RTE_PDS_SMS_UNIT” on page 123 124 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference RTE_REMOTE_LPAR_FLAG This parameter determines whether this runtime environment will be run on the local system (N, the default) or transported to other systems (Y). Required or optional Required In the Configuration Tool (ICAT) Panel name v (For a base runtime environment) Add Runtime Environment v (For a full or sharing runtime environment) Add Runtime Environment (1 of 3) Panel ID v (For a base runtime environment) KCIPRTAB v (For a full or sharing runtime environment) KCIPRTEA Field Remote RTE for transport Default value N Permissible values Y or N Batch parameter name RTE_REMOTE PARMGEN name RTE_REMOTE_LPAR_FLAG Description Determines whether this runtime environment will be run on the local system (N, the default) or transported to other systems (Y). If the value of this parameter is Y, the value of the “RTE_USERMODS_FLAG” on page 146 parameter must be N, and vice versa. Related parameters v “RTE_USERMODS_FLAG” on page 146 RTE_SECURITY_CLASS This parameter specifies a common System Authorization Facility (SAF) security class name for OMEGAMON enhanced 3270 user interface security controls. Required or optional Optional Location where the parameter value is stored The RTE_SECURITY_CLASS parameter in the KPPENV member of the xKANPARU library. In the Configuration Tool (ICAT) Panel name Add Runtime Environment Panel ID KCIPRTA1 Field Global SAF class name Chapter 4. Runtime environment (RTE) parameters 125 Default value None. If this field is not specified, the RTE_SECURITY_CLASS parameter is generated as a placeholder comment in the xKANPARU(KPPENV) member for components exploiting this parameter. Permissible values A valid SAF class name, comprising a character string, maximum length 8. If using ACF2 as your external security resource manager, specify a maximum of 3 characters. Batch parameter name RTE_SECURITY_CLASS PARMGEN name RTE_SECURITY_CLASS Description Security validation processing by the OMEGAMON enhanced user interface: which validates the user identity using the SAF interface. The existence of the SAF user and its validity (that is, not suspended) are always checked. Note: 1. Applies only to the OMEGAMON enhanced 3270 user interface and OMEGAMON XE/IBM Tivoli Monitoring-based components that take advantage of the enhanced 3270 user interface. 2. The individual products have additional SAF security settings that are specific to them (for example, how to secure product-specific Take Action requests); see the product-specific documentation for information. Related parameters v “KDS_TEMS_DRA_FLAG” on page 198 v “KOB_TOM_STC” on page 259 v “KOB_TOM_VTAM_APPL_LOGON” on page 260 v “KOB_TOM_VTAM_NODE” on page 261 v “KPP_SECURITY_ACTION_CLASS” on page 48 RTE_SECURITY_FOLD_PASSWORD_FLAG This parameter determines whether mixed case passwords are supported and being used. Required or optional Required for full and sharing runtime environments; does not apply to base runtime environments. In the Configuration Tool (ICAT) Panel name Add Runtime Environment (2 of 3) Panel ID KCIPRTA1 Field Fold password to upper case Default value Y Permissible values Y or N Batch parameter name RTE_FOLD_PWD 126 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference PARMGEN name RTE_SECURITY_FOLD_PASSWORD_FLAG Description By default, TMS:Engine folds logon passwords to uppercase. However, IBM RACF V1.7 and later supports mixed-case passwords. If you want to implement mixed-case passwords and if all your monitoring agents support them, set this field to N. If any of your monitoring agents do not support mixed-case passwords, do not activate the SETROPTS PASSWORD(MIXEDCASE) option in RACF and do not enable mixed-case passwords in your runtime environments. Accept the default value of Y for this parameter For more information about the MIXEDCASE option in RACF, see the z/OS V1R8.0 Security Server RACF Security Administrator's Guide. Related parameters v “RTE_SECURITY_USER_LOGON” RTE_SECURITY_USER_LOGON This parameters contains the security system to be used for the runtime environment. Required or optional Required Location where the parameter value is stored N/A Parameter name and syntax Various Default value None Permissible values RACF, ACF2, TSS, NAM, SAF, or None In the Configuration Tool (ICAT) Panel name Add Runtime Environment (2 of 3) Panel ID KCIPRTA1 Field Security system Default value None Permissible values RACF, ACF2, TSS, NAM, or None Batch parameter name RTE_CUA_SECURITY PARMGEN name RTE_SECURITY_USER_LOGON Description Security system to be used for the runtime environment. If you specify a security system, verify that it is installed and configured correctly for your site. If you specify ACF2, you must also provide the name of the ACF2 macro library as the value of the GBL_DSN_ACF2_MACLIB parameter. Chapter 4. Runtime environment (RTE) parameters 127 The PARMGEN configuration method supports one additional permissible value: SAF. The System Authorization Facility (SAF) provides a generic API to interface to z/OS security software. Specifying a security system here indicates which system will be used for security validation of users signing on to the Tivoli Enterprise Portal, but it does not enable validation. Security validation of users is enabled by the KDS_TEMS_SECURITY_KDS_VALIDATE parameter. In addition, the security-related parameters are used in the PARMGEN WKANSAMU(KCIJPSEC) composite security job and product-specific, stand-alone versions of these security jobs. They are also used in several xKANPARU runtime members such as: xKANPARU(KppINNAM) for the TMS:Engine security member xKANPARU(KDSENV) for the KDS_TEMS_SECURITY_KDS_VALIDATE parameter xKANPARU(KppENV) for the RTE_SECURITY_CLASS parameter xKANMODU(&module) for product-specific security exits Related parameters v v v v v “RTE_SECURITY_FOLD_PASSWORD_FLAG” on page 126 “RTE_X_SECURITY_EXIT_LIB” on page 154 “RTE_X_SECURITY_DATA_ABOVE” on page 154 “GBL_DSN_ACF2_MACLIB” on page 81 “RTE_SECURITY_CLASS” on page 125 v “KDS_TEMS_SECURITY_KDS_VALIDATE” on page 214 RTE_SHARE This parameters contains the name of the base or full runtime environment from which the sharing runtime environment obtains its base library information. Required or optional Required for a sharing runtime environment definition In the Configuration Tool (ICAT) Panel name Runtime Environments (RTEs) Panel ID KCIPRTE Field Sharing Default value None Permissible values Character string, maximum length 8 Batch parameter name RTE_SHARE PARMGEN name RTE_SHARE Description Name of the base or full runtime environment from which the sharing runtime environment obtains its base library information. If target libraries that were installed by SMP/E are to be shared, provide the value SMP. This parameter applies to sharing runtime environments only. 128 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Related parameters v “RTE_TYPE” on page 145 RTE_SMS_MGMTCLAS This parameter specifies whether the runtime data sets are to be managed by SMS. Required or optional Optional In the Configuration Tool (ICAT) Panel name v (For a base runtime environment) Add Runtime Environment v (For a full or sharing runtime environment) Add Runtime Environment (1 of 3) Panel ID v (For a base runtime environment) KCIPRTAB v (For a full or sharing runtime environment) KCIPRTEA Field Mgmtclas Default value None Permissible values Character string, maximum length 8 Batch parameter name RTE_SMS_MGMT_CLAS PARMGEN name RTE_SMS_MGMTCLAS Description If the runtime data sets are to be managed by SMS, specify the SMS management class to be used for the allocation of non-VSAM data sets. If your site does not require the SMS MGMTCLAS parameter, you can leave this field blank. Related parameters v “RTE_SMS_VSAM_MGMTCLAS” on page 132 v “RTE_SMS_STORCLAS” on page 130 RTE_SMS_PDSE_FLAG This parameter specifies whether the non-VSAM data sets are to be managed by SMS, and therefore you want to allocate PDSE data sets instead of PDS data set Required or optional Required In the Configuration Tool (ICAT) Panel name v (For a base runtime environment) Add Runtime Environment v (For a full or sharing runtime environment) Add Runtime Environment (1 of 3) Panel ID v (For a base runtime environment) KCIPRTAB v (For a full or sharing runtime environment) KCIPRTEA Chapter 4. Runtime environment (RTE) parameters 129 Field PDSE Default value N Permissible values Y or N Batch parameter name RTE_PDSE PARMGEN name RTE_SMS_PDSE_FLAG Description If the non-VSAM data sets are to be managed by SMS, you can specify Y to allocate PDSE data sets instead of PDS data sets. PDSE data sets do not require compression and are not limited by a predefined number of directory entries. Even if you specify Y, most load module libraries (RKANMOD, RKANMODL, RKANMODR, and RKANMODU) are not allocated as PDSE data sets. The main exception is RKANMODP, a load module library used for the SMP/E CALLLIBS facility. Related parameters None RTE_SMS_STORCLAS This parameter specifies whether the runtime data sets are to be managed by SMS and therefore it is necessary to specify the SMS storage class to be used for the allocation of non-VSAM data sets. Required or optional Optional In the Configuration Tool (ICAT) Panel name v (For a base runtime environment) Add Runtime Environment v (For a full or sharing runtime environment) Add Runtime Environment (1 of 3) Panel ID v (For a base runtime environment) KCIPRTAB v (For a full or sharing runtime environment) KCIPRTEA Field Storclas Default value None Permissible values Character string, maximum length 8 Batch parameter name RTE_SMS_STOR_CLAS PARMGEN name RTE_SMS_STORCLAS Description If the runtime data sets are to be managed by SMS, specify the SMS storage class to be used for the allocation of non-VSAM data sets. If your site does not require the SMS STORCLAS parameter, you can leave this parameter value blank. Related parameters 130 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference v “RTE_SMS_VSAM_STORCLAS” on page 133 v “RTE_SMS_MGMTCLAS” on page 129 RTE_SMS_UNIT This parameter specifies the unit name to be used for allocating the non-VSAM runtime data sets, if the data sets are not managed by SMS. Required or optional Required if the runtime data sets are not to be managed by SMS; optional otherwise. In the Configuration Tool (ICAT) Panel name v (For a base runtime environment) Add Runtime Environment v (For a full or sharing runtime environment) Add Runtime Environment (1 of 3) Panel ID v (For a base runtime environment) KCIPRTAB v (For a full or sharing runtime environment) KCIPRTEA Field Unit Default value None Permissible values Character string, maximum length 8 Batch parameter name RTE_UNIT PARMGEN name RTE_SMS_UNIT Description If the runtime data sets are not to be managed by SMS, specify the unit name to be used for allocating the non-VSAM runtime data sets. Otherwise, leave the parameter value blank. Related parameters v “RTE_SMS_VOLUME” RTE_SMS_VOLUME This parameter specifies the volume serial numbers to be used for allocating the non-VSAM runtime data sets if the runtime data sets are not to be managed by SMS. Required or optional Required if the runtime data sets are not to be managed by SMS; optional otherwise. In the Configuration Tool (ICAT) Panel name v (For a base runtime environment) Add Runtime Environment v (For a full or sharing runtime environment) Add Runtime Environment (1 of 3) Panel ID v (For a base runtime environment) KCIPRTAB v (For a full or sharing runtime environment) KCIPRTEA Field Volser Chapter 4. Runtime environment (RTE) parameters 131 Default value None Permissible values Character string, maximum length 6 Batch parameter name RTE_VOL PARMGEN name RTE_SMS_VOLUME Description If the runtime data sets are not to be managed by SMS, specify the volume serial numbers to be used for allocating the non-VSAM runtime data sets. Otherwise, leave the parameter value blank. Related parameters v “RTE_SMS_UNIT” on page 131 v “RTE_SMS_VSAM_VOLUME” on page 133 RTE_SMS_VSAM_MGMTCLAS This parameter specifies the SMS management class to be used for the allocation of VSAM data sets, if the runtime data sets are to be managed by SMS. Required or optional Optional In the Configuration Tool (ICAT) Panel name v (For a base runtime environment) Add Runtime Environment v (For a full or sharing runtime environment) Add Runtime Environment (1 of 3) Panel ID v (For a base runtime environment) KCIPRTAB v (For a full or sharing runtime environment) KCIPRTEA Field Mgmtclas Default value None Permissible values Character string, maximum length 8 Batch parameter name RTE_SMS_VSAM_MGMT_CLAS PARMGEN name RTE_SMS_VSAM_MGMTCLAS Description If the runtime data sets are to be managed by SMS, specify the SMS management class to be used for the allocation of VSAM data sets. If your site does not require the SMS MGMTCLAS parameter, you can leave this field blank. Related parameters v “RTE_SMS_MGMTCLAS” on page 129 v “RTE_SMS_VSAM_STORCLAS” on page 133 132 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference RTE_SMS_VSAM_STORCLAS This parameter specifies the SMS storage class to be used for the allocation of VSAM data sets if the runtime data sets are to be managed by SMS. Required or optional Optional In the Configuration Tool (ICAT) Panel name v (For a base runtime environment) Add Runtime Environment v (For a full or sharing runtime environment) Add Runtime Environment (1 of 3) Panel ID v (For a base runtime environment) KCIPRTAB v (For a full or sharing runtime environment) KCIPRTEA Field Storclas Default value None Permissible values Character string, maximum length 8 Batch parameter name RTE_SMS_VSAM_STOR_CLAS PARMGEN name RTE_SMS_VSAM_STORCLAS Description If the runtime data sets are to be managed by SMS, specify the SMS storage class to be used for the allocation of VSAM data sets. If your site does not require the SMS STORCLAS parameter, you can leave this field blank. Related parameters v “RTE_SMS_STORCLAS” on page 130 v “RTE_SMS_VSAM_MGMTCLAS” on page 132 RTE_SMS_VSAM_VOLUME This parameter specifies the volume serial numbers to be used for allocating the VSAM runtime data sets, if the runtime data sets are not managed by SMS. Required or optional Required if the runtime data sets are not to be managed by SMS; optional otherwise. In the Configuration Tool (ICAT) Panel name v (For a base runtime environment) Add Runtime Environment v (For a full or sharing runtime environment) Add Runtime Environment (1 of 3) Panel ID v (For a base runtime environment) KCIPRTAB v (For a full or sharing runtime environment) KCIPRTEA Field Volser Chapter 4. Runtime environment (RTE) parameters 133 Default value None Permissible values Character string, maximum length 6 Batch parameter name RTE_VSAM_VOL PARMGEN name RTE_SMS_VSAM_VOLUME Description Volume serial numbers to be used for allocating the VSAM runtime data sets. This value is required if the runtime data sets are not to be managed by SMS. Otherwise, leave this parameter value blank. Related parameters v “RTE_SMS_VOLUME” on page 131 RTE_STC_PREFIX This parameter specifies a prefix to be used when generating started task procedures for products configured in the runtime environment. Required or optional Required for full and sharing runtime environments; does not apply to base runtime environments. In the Configuration Tool (ICAT) Panel name Add Runtime Environment (1 of 3) Panel ID KCIPRTEA Field STC prefix Default value CANS Permissible values Character string, maximum length 4 Batch parameter name RTE_STC_PREFIX PARMGEN name RTE_STC_PREFIX Description For full and sharing runtime environments, specify a prefix to be used when generating started task procedures for products configured in the runtime environment. The default value of CANS is provided, but specifying your own prefix prevents confusion with jobs generated by other runtime environments on the same system. Related parameters None RTE_SYSV_BASE_ALIAS This parameter specifies a system variable for the base runtime environment for a sharing-with-base runtime environments with system variables enabled. 134 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Required or optional Required for full and sharing runtime environments with system variables enabled; does not apply to base runtime environments In the Configuration Tool (ICAT) Panel name Add Runtime Environment (2 of 3) Panel ID KCIPRTA1 Field RTE base alias specification Default value None Permissible values Character string, maximum length 20 Batch parameter name RTE_SYSV_BASE_ALIAS PARMGEN name RTE_SYSV_BASE_ALIAS Description For a sharing-with-base runtime environment with system variables enabled (RTE_SYSV_SYSVAR_FLAG = Y), specify a system variable for the base runtime environment. This value is then inserted into the base runtime environment data set references in all started tasks. The resolved name must be a valid data set name qualifier. For other types of runtime environments, the label n/a is displayed beside this field. Related parameters v “RTE_SYSV_SYSVAR_FLAG” on page 136 v “RTE_BASE_NAME” on page 107 RTE_SYSV_NAME This parameter contains the system variable for the name of the runtime environment. Required or optional Required for full and sharing runtime environments with system variables enabled; does not apply to base runtime environments In the Configuration Tool (ICAT) Panel name Add Runtime Environment (2 of 3) Panel ID KCIPRTA1 Field RTE name specification Default value SYSNAME Permissible values Character string, maximum length 20 Batch parameter name RTE_SYSV_NAME Chapter 4. Runtime environment (RTE) parameters 135 PARMGEN name RTE_SYSV_NAME Description System variable for the name of the runtime environment. The resolved name must be a single valid JCL symbol, as defined in the z/OS MVS JCL Reference. This field becomes the value of the SYS= parameter (for example, SYS=’SYSNAME’) in all started task members. This field can contain both literals and symbolics. For example, if you specify a value of OMXSYSNAME, the value resolves to a runtime environment name of OMXSYSA when SYSNAME = SYSA. Related parameters v “RTE_SYSV_SYSVAR_FLAG” v “RTE_NAME” on page 117 RTE_SYSV_SYSVAR_FLAG This parameter determines whether to enable z/OS system variables, which are elements that allow systems to share PARMGEN definitions while retaining unique values in those definitions. Required or optional Required for full and sharing runtime environments; does not apply to base runtime environments. In the Configuration Tool (ICAT) Panel name Add Runtime Environment (2 of 3) Panel ID KCIPRTA1 Field Use z/OS system variables? Default value N Permissible values Y or N Batch parameter name RTE_SYSV PARMGEN name RTE_SYSV_SYSVAR_FLAG Description Determines whether to enable z/OS system variables, which are elements that allow systems to share PARMGEN definitions while retaining unique values in those definitions. Each system that shares a definition replaces the system variable with a unique value during initialization. If you use system variables, the components inherit the system values for the system on which they are started (the host z/OS system). These system-specific values are then automatically loaded into dynamic in-memory parameter members that exist only while the component runs. The result is that the software runs correctly by using the system-specific parameter values for the host z/OS system. Note: You cannot use system variables in the runtime environment of a high-availability hub. For complete information about using system variables, see the chapter "Enabling system variable support" in IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Related parameters 136 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference v v v v “RTE_SYSV_NAME” on page 135 “RTE_SYSV_BASE_ALIAS” on page 134 “RTE_SYSV_VTAM_APPLID_PREFIX” on page 138 “RTE_SYSV_VTAM_APPLID_MODEL” RTE_SYSV_TEMS_NAME_NODEID The parameters specifies the system variable for the name that identifies the monitoring server for internal processing. Required or optional Required for runtime environments with system variables enabled In the Configuration Tool (ICAT) Panel name Runtime Environment (1 of 3) Panel ID KCIPRTEA Field TEMS name Default value None Permissible values Character string, maximum length 32 Batch parameter name RTE_SYSV_CMS_NAME PARMGEN name RTE_SYSV_TEMS_NAME_NODEID Description System variable for the name that identifies the monitoring server for internal processing. The resolved name must follow the rules for the RTE_TEMS_NAME_NODEID parameter. Related parameters v “RTE_TEMS_NAME_NODEID” on page 142 v “RTE_SYSV_SYSVAR_FLAG” on page 136 RTE_SYSV_VTAM_APPLID_MODEL This parameter determines whether the runtime environment will use VTAM model applids; that is, applids with wildcard suffixes such as ? or *. Required or optional Required for full and sharing runtime environments with system variables enabled; does not apply to base runtime environments In the Configuration Tool (ICAT) Panel name Add Runtime Environment (2 of 3) Panel ID KCIPRTA1 Field Use VTAM model applids? Chapter 4. Runtime environment (RTE) parameters 137 Default value N Permissible values Y or N Batch parameter name RTE_SYSV_VTM_APPL_MODEL PARMGEN name RTE_SYSV_VTAM_APPLID_MODEL Description Determines whether the runtime environment will use VTAM model applids; that is, applids with wildcard suffixes such as ? or *. These model applids allow the use of any applids that match the pattern in the VTAM node. Related parameters v “RTE_SYSV_SYSVAR_FLAG” on page 136 v “RTE_SYSV_VTAM_APPLID_PREFIX” RTE_SYSV_VTAM_APPLID_PREFIX This parameter specifies the a VTAM applid prefix that contains system variables, if system variables are enabled and you intend to use SNA communications. Required or optional Optional for runtime environments with system variables enabled In the Configuration Tool (ICAT) Panel name Add Runtime Environment (2 of 3) Panel ID KCIPRTA1 Field Applid prefix Default value KSYSCLONE. Permissible values Character string, maximum length 20 Batch parameter name RTE_SYSV_VTM_APPL_PREF PARMGEN name RTE_SYSV_VTAM_APPLID_PREFIX Description If system variables are enabled (RTE_SYSV_SYSVAR_FLAG = Y) and if you intend to use SNA communications, supply a VTAM applid prefix that contains system variables. The resolved prefix can have a maximum of 4 characters. Be sure to place a period (.) after the last symbolic in the specification. If none of the products or components you intend to configure require SNA communications, delete the default value and leave this parameter value blank. Related parameters v “RTE_SYSV_SYSVAR_FLAG” on page 136 v “RTE_VTAM_APPLID_PREFIX” on page 148 138 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference RTE_SYSV_VTAM_NETID This parameter specifies a system variable for the VTAM network identifier, if system variables are enabled and you intend to use SNA communications. Required or optional Required for SNA communications if system variables are enabled In the Configuration Tool (ICAT) Panel name Add Runtime Environment (2 of 3) Panel ID KCIPRTA1 Field Network ID Default value None Permissible values Character string, maximum length 20 Batch parameter name RTE_SYSV_VTM_NETID PARMGEN name RTE_SYSV_VTAM_NETID Description If system variables are enabled (RTE_SYSV_SYSVAR_FLAG = Y) and if you intend to use SNA communications, supply a system variable for the VTAM network identifier, as defined in the NETID parameter of the VTAMLST startup member ATCSTRnn. The resolved value can have a maximum of 8 characters. This value is required for SNA communications. If none of the products or components you intend to configure in this runtime environment require SNA communications, leave this parameter value blank. Related parameters v “RTE_SYSV_SYSVAR_FLAG” on page 136 v “RTE_VTAM_NETID” on page 151 RTE_TCP_HOST This parameter contains the TCP/IP host name or dotted decimal IPV4 address of the z/OS system where the runtime environment is being defined. Required or optional Required In the Configuration Tool (ICAT) Panel name Add Runtime Environment (2 of 3) Panel ID KCIPRTA1 Field Hostname Default value None Chapter 4. Runtime environment (RTE) parameters 139 Permissible values Character string, maximum length 32 Batch parameter name RTE_TCP_HOST PARMGEN name RTE_TCP_HOST Description TCP/IP host name or dotted decimal IPV4 address of the z/OS system where the runtime environment is being defined. The value you specify becomes the default host name for the products and components configured in the runtime environment. To obtain the host name and IP address, enter TSO HOMETEST at a command line. Related parameters v “RTE_TCP_PORT_NUM” v “KDS_TEMS_TCP_HOST” on page 222 v “KDS_HUB_TCP_HOST” on page 159 RTE_TCP_PORT_NUM This parameter contains the number of the well-known port to be used for IP communications. Required or optional Required In the Configuration Tool (ICAT) Panel name Add Runtime Environment (2 of 3) Panel ID KCIPRTA1 Field Port number Default value 1918 Permissible values 1 - 65535 Batch parameter name RTE_TCP_PORT PARMGEN name RTE_TCP_PORT_NUM Description Number of the well-known port to be used for IP communications. For detailed information about assigning port numbers, see "Port number assignments" in IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Related parameters v “RTE_TCP_HOST” on page 139 v “KDS_TEMS_TCP_PIPE_PORT_NUM” on page 224 RTE_TCP_STC This parameter identifies the TCP/IP stack to be used. 140 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Required or optional Required In the Configuration Tool (ICAT) Panel name Add Runtime Environment (2 of 3) Panel ID KCIPRTA1 Field Started task Default value * Permissible values Character string, maximum length 8 Batch parameter name RTE_TCP_STC PARMGEN name RTE_TCP_STC Description Identifies the TCP/IP stack to be used. If the LPAR contains a single TCP/IP stack, accept the default value (the wildcard character *) to select the first TCP/IP stack that was started. If the LPAR contains more than one TCP/IP stack, you can specify the started task name of the TCP/IP stack you want to use; or you can specify the number sign (#), which is translated to a blank and allows the TCP/IP environment to choose the stack to use, either through TCP/IP definitions or through the use of the SYSTCPD DD statement. Whichever method is used to select a TCP/IP stack in a multi-stack environment, the Tivoli Management Services components continue to use that stack, even if a different stack becomes the primary stack. Therefore, in a multi-stack environment, it is best to specify the started task name of the TCP/IP stack to be used, rather than specifying a wildcard or a blank. Related parameters v “KDS_TEMS_TCP_STC” on page 228 RTE_TEMS_CONFIGURED_FLAG This parameter specifies whether a Tivoli Enterprise Monitoring Server is to be configured in this runtime environment. Required or optional Required for full and sharing runtime environments; does not apply to base runtime environments. In the Configuration Tool (ICAT) Panel name Runtime Environment (1 of 3) Panel ID KCIPRTEA Field Will this RTE have a Tivoli Enterprise Monitoring Server? Default value Y Chapter 4. Runtime environment (RTE) parameters 141 Permissible values Y or N Batch parameter name RTE_CMS PARMGEN name RTE_TEMS_CONFIGURED_FLAG Description Determines whether a Tivoli Enterprise Monitoring Server is to be configured in this runtime environment. If you are creating a runtime environment for stand-alone monitoring agents without a monitoring server, specify N. Otherwise, specify Y (the default) to allocate libraries for the monitoring server. Related parameters v “RTE_TEMS_NAME_NODEID” RTE_TEMS_NAME_NODEID This parameter specifies the unique name that identifies the monitoring server for internal processing. Required or optional Required for a full or sharing runtime environment that contains a Tivoli Enterprise Monitoring Server; does not apply to base runtime environments. In KDSENV Parameter name CMS_NODEID Default value rtename:CMS Permissible values Character string, maximum length 32 In the Configuration Tool (ICAT) Panel name Add Runtime Environment (1 of 2) Panel ID KCIPRTEA Field TEMS name Default value rtename:CMS Permissible values Character string, maximum length 32 Batch parameter name RTE_CMS_NAME PARMGEN name RTE_TEMS_NAME_NODEID Description Unique name that identifies the monitoring server for internal processing. In general, it is best to accept the default TEMS name (the runtime environment name followed by :CMS). If you want to specify a different name, follow these guidelines: v The TEMS name must be unique. 142 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference v The name is alphanumeric and must begin with an alphabetic character. v The length of the name must be at least 2 characters and no more than 32 characters. v The name cannot contain blanks or special characters ($#@). An underscore (_) is permitted and conforms to ISO 9660 standards. A period (.) is also valid. v The TEMS name is case-sensitive on all platforms. If you use a mixed-case name, you must supply the same mixed-case name when you configure all components and monitoring agents that will connect to the monitoring server. Be sure to make a note of the TEMS name. You will have to specify it when you configure components and products in the runtime environment, and when you set up communications with the distributed components of Tivoli Management Services (IBM Tivoli Monitoring). Related parameters v “RTE_TEMS_CONFIGURED_FLAG” on page 141 v “RTE_SYSV_TEMS_NAME_NODEID” on page 137 RTE_TN3270_DXL_HOSTADDRESS This parameter specifies the network address of an LPAR that does have an active Telnet listener, if you are configuring products that support the Dynamic XE to 3270 (Classic) linking feature and if the LPAR in which you are defining a runtime environment does not have an active Telnet listener. Required or optional Optional In the Configuration Tool (ICAT) Panel name Add Runtime Environment (3 of 3) Panel ID KCIPRTA2 Field Hostname Default value None Permissible values Character string, maximum length 44 Batch parameter name RTE_TN3270_TCP_HOST PARMGEN name RTE_TN3270_DXL_HOSTADDRESS Description If you are configuring products that support the Dynamic XE to 3270 (Classic) linking feature and if the LPAR in which you are defining a runtime environment does not have an active Telnet listener, specify the network address of an LPAR that does have an active Telnet listener. A network address can be specified as one of the following values: v Fully qualified hostname (for example, sys.ibm.com) v First qualifier of the fully qualified hostname (for example, sys for sys.ibm.com) v 32-bit IPV4 address in dotted decimal notation (for example, 9.67.1.100) To get this value, issue the TSO HOMETEST command on the LPAR of the Telnet listener. The values you specify on this panel are displayed during TN3270 logon and can be modified then for an individual TN3270 session. Chapter 4. Runtime environment (RTE) parameters 143 Related parameters v “RTE_TN3270_DXL_TN3270PORT” RTE_TN3270_DXL_LUGROUP This parameter specifies the name of a Logical Unit (LU) group if the default Telnet USS screen does not accept the requires the LOGON APPLID() DATA() command required by the Dynamic XE to 3270 (Classic) linking feature. Required or optional Required In the Configuration Tool (ICAT) Panel name Add Runtime Environment (3 of 3) Panel ID KCIPRTA2 Field LUGROUP Default value None Permissible values Character string, maximum length 8 Batch parameter name RTE_TN3270_LUGROUP PARMGEN name RTE_TN3270_DXL_LUGROUP Description The Dynamic XE to 3270 (Classic) linking feature requires the VTAM Unformatted System Services (USS) screen to accept a LOGON APPLID() DATA() command. If the default Telnet USS screen does not accept this command, supply the name of a Logical Unit (LU) group that does accept it. The TN3270 session will be joined to that LU group. Related parameters None RTE_TN3270_DXL_TN3270PORT This parameter contains the port number on which the TN3270 server is listening. Required or optional Optional In the Configuration Tool (ICAT) Panel name Add Runtime Environment (3 of 3) Panel ID KCIPRTA2 Field Port number Default value 23 Permissible values 1 - 65535 144 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Batch parameter name RTE_TN3270_TCP_PORT PARMGEN name RTE_TN3270_DXL_TN3270PORT Description Port number on which the TN3270 server is listening. Related parameters v “RTE_TN3270_DXL_HOSTADDRESS” on page 143 RTE_TYPE This parameter specifies the type of runtime environment being created. Required or optional Required In the Configuration Tool (ICAT) Panel name Runtime Environments (RTEs) Panel ID KCIPRTE Field Type Default value None Permissible values FULL, BASE, or SHARING Batch parameter name RTE_TYP PARMGEN name RTE_TYPE Description Type of runtime environment being created. If you intend to create any sharing environments, start by creating the base or full runtime environment that they will share, so that you can then add the sharing runtime environment later. The following types are valid: Full Allocates both private and base libraries. Use this if you only one runtime environment or if you a runtime environment for a unique set of products. This is the default if no value is provided in the Configuration Tool. Base Allocates read-only base libraries and does not execute alone. Use this only in conjunction with sharing runtime environments. Create the base runtime environment first. Note: You cannot configure products in base runtime environments, which contain shared, read-only libraries exclusively. Sharing Allocates private libraries only. This type can either share base libraries with a base or full runtime environment, or use target libraries that were installed by SMP/E for its base libraries. Define one sharing runtime environment for each z/OS image. For detailed information about types of runtime environments, see IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Chapter 4. Runtime environment (RTE) parameters 145 Related parameters v “RTE_SHARE” on page 128 v “RTE_BASE_NAME” on page 107 RTE_USERMODS_FLAG This parameter determines whether the Configuration Tool will identify user-modified data set members that each configuration batch job will affect. Required or optional Required In the Configuration Tool (ICAT) Panel name v (For a base runtime environment) Add Runtime Environment v (For a full or sharing runtime environment) Add Runtime Environment (1 of 3) Panel ID v (For a base runtime environment) KCIPRTAB v (For a full or sharing runtime environment) KCIPRTEA Field Runtime members analysis Default value Y Permissible values Y or N Batch parameter name RTE_USERMODS PARMGEN name RTE_USERMODS_FLAG Description Determines whether the Configuration Tool will identify user-modified data set members that each configuration batch job will affect. If runtime members analysis is enabled, a report of user-modified members is displayed. If the value of this parameter is Y, the value of the “RTE_REMOTE_LPAR_FLAG” on page 125 parameter must be N, and vice versa. Related parameters v “RTE_REMOTE_LPAR_FLAG” on page 125 RTE_USS_RTEDIR This parameter specifies the main Hierarchical File System/zSeries File System (HFS/zFS) directory name for the runtime environment, if a product to be configured in the runtime environment requires that UNIX System Services (USS) directories be created. Required or optional Optional Location where the parameter value is stored The KDSENV member of the rhilev.midlev.rtename.RKANPARU library Parameter name and syntax TEMS_MANIFEST_PATH=#rtedir/%RTE_NAME%/kds/support/TEMS Default value /rtehome 146 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Permissible values See description. In the Configuration Tool (ICAT) Panel name Add Runtime Environment (3 of 3) Panel ID KCIPRTA2 Field RTE directory Batch parameter name RTE_USS_RTEDIR PARMGEN name RTE_USS_RTEDIR Description (Conditional) If any products in this runtime environment require that Unix System Services (USS) directories be created, specify the RTE HFS/zFS home directory (#rtedir). Note: 1. Specify the main RTE HFS/zFS home directory name if you are enabling the self-describing agents (SDA) function in the z/OS TEMS and agents. SDA applies to Tivoli Management Services V6.2.3 and higher versions. 2. The RTE_USS_RTEDIR value (#rtedir) is used in this TEMS parameter in the xKANPARU library: TEMS_MANIFEST_PATH=\ #rtedir/%RTE_NAME%/kds/support/TEMS 3. 4. 5. 6. The TEMS_MANIFEST_PATH parameter is the name of the USS home directory where agent-uploaded jar files and other application support files will be stored by the TEMS. The #rtedir value is also used in the KDS* members in RKANDATV; these members contain the commands that create the USS directories and send files to the USS subdirectories. Product configuration USS jobs (KCIJ%USP/KCIJ%USS) that use the RTE_USS_RTEDIR home directory parameter must be invoked by a user ID wither either superuser authority (UID=0) or read access to resource BPX.SUPERUSER under the FACILITY profile (in which case, superuser authority must be activated). The user ID must have read access to the BPX.FILEATTR.APF resource profile in the RACF FACILITY class. If you plan to create a new file system for products that use the RTE_USS_RTEDIR home directory parameter, ensure it is created before submitting the product USS jobs to define file system paths. See the KCIUSSJB sample job in the %GBL_TARGET_HILEV%.TKANSAM SMP/E target library. When issuing the MOUNT FILESYSTEM command, the MOUNTPOINT() parameter equates to the value you are supplying for the RTE_USS_RTEDIR. A sample MOUNT FILESYSTEM command is shown below: MOUNT FILESYSTEM(’&hlq_rte_home’) TYPE(ZFS) MODE(RDWR) MOUNTPOINT(’/rtehome’) AGGRGROW 7. The file system must be in read/write mode when the product USS jobs are run. Related parameters v “GBL_HFS_JAVA_DIRn” on page 103 v “GBL_DSN_SYS1_SBPXEXEC” on page 97 v “KDS_KMS_SDA” on page 167 v “KDS_TEMA_SDA” on page 196 Chapter 4. Runtime environment (RTE) parameters 147 v “KPP_AGT_TEMA_SDA” on page 33 RTE_VSAM_HILEV This parameter specifies the VSAM high-level qualifier to be used for allocating the runtime data sets Required or optional Required In the Configuration Tool (ICAT) Panel name v (For a base runtime environment) Add Runtime Environment v (For a full or sharing runtime environment) Add Runtime Environment (1 of 3) Panel ID v (For a base runtime environment) KCIPRTAB v (For a full or sharing runtime environment) KCIPRTEA Field High-level Qualifier (VSAM) Default value None Permissible values Character string, maximum length 26 Batch parameter name RTE_VSAM_HILEV PARMGEN name RTE_VSAM_HILEV Description VSAM high-level qualifier to be used for allocating the runtime data sets. If you plan to allocate SMS-managed data sets for the runtime environment, the high-level qualifier that you specify must be eligible for SMS-managed volumes. For PARMGEN configuration, the value of this parameter for a sharing runtime environment must be the same as the value for the shared runtime environment. For detailed information about sharing and shared runtime environments, see the "Planning your deployment" chapter of IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Related parameters v “RTE_HILEV” on page 110 v “RTE_BASE_NAME” on page 107 v “RTE_TYPE” on page 145 RTE_VTAM_APPLID_PREFIX This parameter specifies the global VTAM applid prefix to be used when building the VTAM applids for products in this runtime environment. Required or optional Optional In the Configuration Tool (ICAT) Panel name Add Runtime Environment (2 of 3) 148 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Panel ID KCIPRTA1 Field Applid prefix Default value CTD Permissible values Character string, maximum length 4 Batch parameter name RTE_VTM_APPL_PREF PARMGEN name RTE_VTAM_APPLID_PREFIX Description Global VTAM applid prefix to be used when building the VTAM applids for products in this runtime environment. If none of the products or components you intend to configure in this runtime environment require SNA communications, delete the default value and leave this parameter value blank. If system variables are enabled, the value supplied for the RTE_SYSV_VTAM_APPLID_PREFIX parameter is used. Related parameters v “RTE_SYSV_VTAM_APPLID_PREFIX” on page 138 v “RTE_VTAM_NETID” on page 151 RTE_VTAM_GBL_MAJOR_NODE This parameter specifies the name of the global VTAM major node in the RKANSAMU member with the same name. Required or optional Required In the Configuration Tool (ICAT) Panel name Create VTAM Major Node Panel ID KCIPSVU2 Field VTAM major node name Default value KCANDLE1 Permissible values Character string, maximum length 8 Batch parameter name RTE_VTM_CANDLE_NODE PARMGEN name RTE_VTAM_GBL_MAJOR_NODE Description Name of the global VTAM major node in the RKANSAMU member with the same name. This major node contains all applid definitions required for the runtime environment. Chapter 4. Runtime environment (RTE) parameters 149 Related parameters None RTE_VTAM_LU62_DLOGMOD This parameter specifies the LU6.2 logmode for this runtime environment. Required or optional Required for SNA communications In the Configuration Tool (ICAT) Panel name Add Runtime Environment (2 of 3) Panel ID KCIPRTA1 Field LU6.2 logmode Default value CANCTDCS Permissible values Character string, maximum length 8 Batch parameter name RTE_VTM_LU62_LOG PARMGEN name RTE_VTAM_LU62_DLOGMOD Description LU6.2 logmode for this runtime environment. The default is CANCTDCS. If none of the products or components you intend to configure in this runtime environment require SNA communications, delete the default value and leave this parameter value blank. Related parameters v “RTE_VTAM_LU62_MODETAB” RTE_VTAM_LU62_MODETAB This parameter specifies the logmode table name for LU6.2 logmode entries Required or optional Optional In the Configuration Tool (ICAT) Panel name Add Runtime Environment (2 of 3) Panel ID KCIPRTA1 Field Logmode table Default value KDSMTAB1 Permissible values Character string, maximum length 8 Batch parameter name RTE_VTM_LU62_LOGTAB 150 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference PARMGEN name RTE_VTAM_LU62_MODETAB Description Logmode table name for LU6.2 logmode entries. The default is KDSMTAB1. If none of the products or components you intend to configure in this runtime environment require SNA communications, delete the default value and leave this parameter value blank. This table is assembled into the system library (usually SYS1.VTAMLIB) that contains VTAM logmode tables. Related parameters v “RTE_VTAM_LU62_DLOGMOD” on page 150 v “GBL_DSN_SYS1_VTAMLIB” on page 98 RTE_VTAM_NETID This parameter specifies the VTAM network identifier, as defined in the NETID parameter of the VTAMLST startup member. Required or optional Required for SNA communications In the Configuration Tool (ICAT) Panel name Add Runtime Environment (2 of 3) Panel ID KCIPRTA1 Field Network ID Default value None Permissible values Character string, maximum length 8 Batch parameter name RTE_VTM_NETID PARMGEN name RTE_VTAM_NETID Description VTAM network identifier, as defined in the NETID parameter of the VTAMLST startup member (ATCSTRnn). If none of the products or components you intend to configure in this runtime environment require SNA communications, leave this parameter value blank. If system variables are enabled, the value supplied for “RTE_SYSV_VTAM_NETID” on page 139 is used. Related parameters v “RTE_SYSV_VTAM_NETID” on page 139 v “RTE_VTAM_APPLID_PREFIX” on page 148 v “GBL_DSN_SYS1_VTAMLST” on page 99 RTE_X_KCNDLSSI_INITPARM_FLAG This PARMGEN-only parameter determines if the INITPARM(’SSPROC=%RTE_CANSCN_STC%’) parameter is generated in the &rhilev.&rte.RKANSAMU(KCNDLSSI) OMEGAMON subsystem member. Chapter 4. Runtime environment (RTE) parameters 151 Required or optional Optional Location where the parameter value is stored Value determines if the INITPARM(’SSPROC=%RTE_CANSCN_STC%’) parameter should be generated in the &rhilev.&rte.RKANSAMU(KCNDLSSI) member. Parameter name and syntax N/A Default value Y Permissible values Y, N PARMGEN name RTE_X_KCNDLSSI_INITPARM_FLAG Description This is the flag that generates the INITPARM(’SSPROC=%RTE_CANSCN_STC%’) parameter in the KCNDLSSI member in RKANSAMU. A value of Y generates the INITPARM(). Member KCNDLSSI contains a sample IEFSSNcc update. In addition to identifying the subsystem to z/OS, this sample causes an automatic start of the subsystem address space. Related parameters v “RTE_CANSCN_STC” on page 107 v “RTE_KCNDLSSI_IEFSSN00_FORMAT” on page 112 v v v v “RTE_KCNSTR00_SSID” on page 113 “RTE_KCNSTR00_XCFGROUP” on page 114 “RTE_KCNSTR00_WTO” on page 113 “RTE_X_KCNSTR00_REFRESH” on page 153 v “RTE_X_KCNSTR00_PLEXCOLLECT” RTE_X_KCNSTR00_PLEXCOLLECT This PARMGEN-only parameter specifies whether or not the OMEGAMON subsystem address space may become the collector for this sysplex. Required or optional Optional Location where the parameter value is stored KCNSTR00 OMEGAMON subsystem startup member in the &rhilev.&rte.RKANPARU library. Parameter name and syntax PLEXCOLLECT=%RTE_X_KCNSTR00_PLEXCOLLECT% Default value YES Permissible values YES, NO PARMGEN name RTE_X_KCNSTR00_PLEXCOLLECT Description This parameter specifies whether or not the OMEGAMON subsystem address space may become the collector for this Sysplex. There are two values: YES 152 This OMEGAMON subsystem may become the Coupling Facility data collector for this IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference sysplex. Only one OMEGAMON subsystem at a time is the collector, but OMEGAMON subsystems with this value may take over collection should the current collector fail or be terminated. YES is the default. NO This OMEGAMON subsystem may not become the collector for this sysplex. This OMEGAMON subsystem may initiate local collection if the sysplex collector cannot be located. Related parameters v “RTE_CANSCN_STC” on page 107 v “RTE_KCNDLSSI_IEFSSN00_FORMAT” on page 112 v “RTE_KCNSTR00_SSID” on page 113 v “RTE_KCNSTR00_XCFGROUP” on page 114 v “RTE_KCNSTR00_WTO” on page 113 v “RTE_X_KCNDLSSI_INITPARM_FLAG” on page 151 v “RTE_X_KCNSTR00_REFRESH” RTE_X_KCNSTR00_REFRESH This PARMGEN-only parameter specifies the interval at which the OMEGAMON subsystem refreshes Coupling Facility data in the address space. Required or optional Optional Location where the parameter value is stored KCNSTR00 OMEGAMON subsystem startup member in the &rhilev.&rte.RKANPARU library. Parameter name and syntax REFRESH=%RTE_X_KCNSTR00_REFRESH% Default value 60 (in seconds) Permissible values Numeric range 1–300 PARMGEN name RTE_X_KCNSTR00_REFRESH Description This parameter shows the refresh interval in effect. The value is in seconds. This interval determines how frequently Coupling Facility data gets refreshed in this address space. All OMEGAMON subsystems that are part of the same XCF group should have the same refresh interval. The smaller this number, the higher the overhead incurred. Related parameters v “RTE_CANSCN_STC” on page 107 v “RTE_KCNDLSSI_IEFSSN00_FORMAT” on page 112 v “RTE_KCNSTR00_SSID” on page 113 v “RTE_KCNSTR00_XCFGROUP” on page 114 v “RTE_KCNSTR00_WTO” on page 113 v “RTE_X_KCNDLSSI_INITPARM_FLAG” on page 151 v “RTE_X_KCNSTR00_PLEXCOLLECT” on page 152 Chapter 4. Runtime environment (RTE) parameters 153 RTE_X_SECURITY_DATA_ABOVE This PARMGEN-only parameter determines if the DATA=ABOVE parameter or the DATA=BELOW parameter is generated in the &rhilev.&rte.RKANPARU(KppINNAM) security member for TMS:Engine to control the allocation of security control blocks. Required or optional Optional Location where the parameter value is stored v KppINNAM member in &rhilev.&rte.RKANPARU for the TEMS, the agents, and most of the agent CUA interfaces v KC2NAMnn in &rhilev.&rte.RKANPARU for OMEGAMON II for CICS/OMEGAMON XE for CICS on z/OS, where nn=00..15 (one pair per Classic 3270 or CUA started tasks) v KD2INNAM in &rhilev.&rte.RKD2PAR for OMEGAMON XE for DB2 on z/OS (Classic 3270 started task) Parameter name and syntax DATA=ABOVE|BELOW Default value Y Permissible values Y, N PARMGEN name RTE_X_SECURITY_DATA_ABOVE Description Controls where the security control blocks are allocated by the TMS/Engine NAM routines, as follows: BELOW Control blocks are allocated in 24-bit storage (RMODE 24). ABOVE Control blocks are allocated in 31-bit storage (RMODE 31). If RTE_X_SECURITY_DATA_ABOVE is set to Y, then a DATA=ABOVE parameter is written to the KppINNAM member in the RKANPARU library. If RTE_X_SECURITY_DATA_ABOVE is set to N, then a DATA=BELOW parameter is written out to the KppINNAM member in the RKANPARU library. Related parameters v “RTE_SECURITY_USER_LOGON” on page 127 v “RTE_SECURITY_FOLD_PASSWORD_FLAG” on page 126 RTE_X_SECURITY_EXIT_LIB This parameter specifies the name of the global RTE library that houses all the OMEGAMON/ITMrelated product security exits (KOBSUPDT OMEGAMON KppSUPDI exits, TMS:Engine security exits, external security exits, etc.). Required or optional Required Location where the parameter value is stored N/A 154 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Parameter name and syntax N/A Default value &rhilev.&rte.RKANSAM Permissible values Character string, maximum length 44 PARMGEN name RTE_X_SECURITY_EXIT_LIB Description Library where user security exits are located. Overrides the SYSIN DD statement where the user exits may have been customized (if other than the default RKANSAM location). The KppJPSC3 input members to the composite KCIJPSEC security job point the SYSIN DD statement to RKANSAM by default. If you need to make further changes to the sample exit, copy the user exit to the xKANSAMU library, and make your changes accordingly. Then modify the RTE_X_SECURITY_EXIT_LIB parameter and change the value to RKANSAMU instead. ICAT-to-PARMGEN conversion considerations: If you are converting an ICAT-built runtime environment, the security exit source library varies for each product. Refer to the application-specific security jobs for more information. See the master PARMGEN Technote's FAQ Security category for more information. Related parameters v “RTE_SECURITY_USER_LOGON” on page 127 v v v v v v “RTE_SECURITY_FOLD_PASSWORD_FLAG” on page 126 “RTE_X_SECURITY_EXIT_LIB” on page 154 “RTE_X_SECURITY_DATA_ABOVE” on page 154 “GBL_DSN_ACF2_MACLIB” on page 81 “RTE_SECURITY_CLASS” on page 125 “KDS_TEMS_SECURITY_KDS_VALIDATE” on page 214 Chapter 4. Runtime environment (RTE) parameters 155 156 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters The Tivoli Enterprise Monitoring Server parameters provide configuration settings for hub and remote monitoring servers on z/OS. The Tivoli Enterprise Monitoring Server parameters are explained in this section. KDS_AUDIT_ITM_DOMAIN This parameter specifies an identifier that may be used to associate audit records. Required or optional Optional Location where the parameter value is stored The value you specify on the KDS_AUDIT_ITM_DOMAIN parameter generates an ITM_DOMAIN parameter in KDSENV. Configuration Tool (ICAT) information Panel name Specify Advanced Configuration Values Panel ID KDS62PP3 Field Domain Default value None Permissible values Character string, maximum length 32 Batch parameter name KDS_AUDIT_ITM_DOMAIN PARMGEN name KDS_AUDIT_ITM_DOMAIN Description Audit domain name This field is used to specify an identifier that may be used to associate audit records. It is suited for commonly identifying agents that are associated with each other. An example use may be for sorting records by a particular customer. This field will also be used to create unique namespaces for RBAC. The value you specify generates an ITM_DOMAIN parameter in KDSENV. Related parameters None KDS_AUDIT_MAX_HIST This parameter specifies an identifier that may be used to associate audit records Required or optional Optional © Copyright IBM Corp. 2010, 2012 157 Location where the parameter value is stored AUDIT_MAX_HIST parameter in the RKANPARU data set, member KDSENV. Configuration Tool (ICAT) information Panel name Specify Advanced Configuration Values Panel ID KDS62PP3 Field Maximum in-memory cache entries Default value None Permissible values 10-1000 Batch parameter name KDS_AUDIT_MAX_HIST PARMGEN name KDS_AUDIT_MAX_HIST Description The maximum number of records kept in short term memory for direct queries. Related parameters None KDS_AUDIT_TRACE Required or optional Optional Location where the parameter value is stored AUDIT_TRACE parameter in the RKANPARU data set, member KDSENV. In the Configuration Tool (ICAT) Panel name Specify Advanced Configuration Values Panel ID KDS62PP3 Field Enable/Disable z/OS audit collection Default value None Permissible values M, B, D, X Batch parameter name KDS_AUDIT_TRACE PARMGEN name KDS_AUDIT_TRACE Description This indicates the trace level to pass messages. Message trace levels (from low to high) are X (Disabled), M (Minimum), B (Basic), and D(Detail). Higher levels imply all lower levels. 158 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Related parameters None KDS_HUB_TCP_HOST This parameter specifies the TCP/IP host name or the dotted decimal IPV4 address of the system where the hub monitoring server is installed. Required or optional Required for remote Tivoli Enterprise Monitoring Servers that use TCP/IP for communications with the hub Location where the parameter value is stored KDCSSITE member of the rhilev.rte.RKANPARU library for the runtime environment of the remote monitoring server Configuration Tool (ICAT) information Panel name Specify Configuration - Hub Values for Remote TEMS Panel ID KDS62PP2 Field Network address (Hostname of Hub) Default value None Permissible values Character string, maximum length 32 Batch parameter name KDS_HUB_TCP_HOST PARMGEN name KDS_HUB_TCP_HOST Description The TCP/IP host name or the dotted decimal IPV4 address of the system where the hub monitoring server is installed. This parameter applies only to a remote monitoring server that uses TCP/IP for communications. The value specified for this parameter must match the value set for the “KDS_TEMS_TCP_HOST” on page 222 parameter in the runtime environment where the hub is configured, or the value set for an equivalent parameter of a distributed hub. Related parameters v “RTE_TCP_HOST” on page 139 v “KDS_TEMS_TCP_HOST” on page 222 KDS_HUB_TCP_PIPE_PORT_NUM This parameter contains the well-known port for the hub monitoring server for the IP.PIPE communication protocol (the TCP/IP protocol that supports IPV4), specified during configuration of a remote monitoring server. Required or optional Required for remote Tivoli Enterprise Monitoring Servers that use the IP.PIPE protocol for communications with the hub Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the remote monitoring server Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 159 Parameter name KDE_TRANSPORT (IP.PIPE PORT option) Example: KDE_TRANSPORT=\ IP.PIPE PORT:1918 Default value 1918 Permissible values 1 - 65535 Configuration Tool (ICAT) information Panel name Specify Configuration - Hub Values for Remote TEMS Panel ID KDS62PP2 Field IP.PIPE port number Default value 1918 or the value set for the “KDS_TEMS_TCP_PIPE_PORT_NUM” on page 224 parameter for the hub Permissible values 1 - 65535 Batch parameter name KDS_HUB_TCP_PIPE_PORT PARMGEN name KDS_HUB_TCP_PIPE_PORT_NUM Description Well-known port for the hub monitoring server for the IP.PIPE communication protocol (the TCP/IP protocol that supports IPV4), specified during configuration of a remote monitoring server. The value specified for this parameter must match the value set for the “KDS_TEMS_TCP_PIPE_PORT_NUM” on page 224 parameter in the runtime environment where the hub is configured, or the value set for an equivalent parameter of a distributed hub. Related parameters v “KDS_TEMS_TCP_PIPE_PORT_NUM” on page 224 KDS_HUB_TCP_PIPE6_PORT_NUM This parameter contains the well-known port for the hub monitoring server for the IP6.PIPE communication protocol (the TCP/IP protocol that supports IPV6), specified during configuration of a remote monitoring server. Required or optional Required for remote Tivoli Enterprise Monitoring Servers that use the IP6.PIPE protocol for communications with the hub Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the remote monitoring server Parameter name KDE_TRANSPORT (IP6.PIPE PORT option) Example: 160 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference KDE_TRANSPORT=\ IP6.PIPE PORT:1918 Default value 1918 Permissible values 1 - 65535 Configuration Tool (ICAT) information Panel name Specify Configuration - Hub Values for Remote TEMS Panel ID KDS62PP2 Field IP6.PIPE port number Default value 1918 Permissible values 1 - 65535 Batch parameter name KDS_HUB_TCP_PIPE6_PORT PARMGEN name KDS_HUB_TCP_PIPE6_PORT_NUM Description Well-known port for the hub monitoring server for the IP6.PIPE communication protocol (the TCP/IP protocol that supports IPV6), specified during configuration of a remote monitoring server. This protocol is available for a monitoring server on a z/OS system at release level V1R7 or higher, with IPV6 installed and operational. The value specified for this parameter must match the value set for the “KDS_TEMS_TCP_PIPE6_PORT_NUM” on page 225 parameter in the runtime environment where the hub is configured, or the value set for an equivalent parameter of a distributed hub. Related parameters v “KDS_TEMS_TCP_PIPE6_PORT_NUM” on page 225 KDS_HUB_TCP_PIPE6S_PORT_NUM This parameter contains the well-known port for the hub monitoring server for the IP6.SPIPE communication protocol (the TCP/IP protocol that supports Secure Sockets Layer communications over IPV6), specified during configuration of a remote monitoring server. Required or optional Required for remote Tivoli Enterprise Monitoring Servers that use the IP6.SPIPE protocol for communications with the hub Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the remote monitoring server Parameter name KDE_TRANSPORT (IP6.SPIPE PORT option) Example: KDE_TRANSPORT=\ IP6.SPIPE PORT:3660 Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 161 Default value 3660 Permissible values 1 - 65535 Configuration Tool (ICAT) information Panel name Specify Configuration - Hub Values for Remote TEMS Panel ID KDS62PP2 Field IP6.SPIPE port number Default value 3660 or the value set for the “KDS_TEMS_TCP_PIPE6S_PORT_NUM” on page 226 parameter for the hub Permissible values 1 - 65535 Batch parameter name KDS_HUB_TCP_PIPE6S_PORT PARMGEN name KDS_HUB_TCP_PIPE6S_PORT_NUM Description Well-known port for the hub monitoring server for the IP6.SPIPE communication protocol (the TCP/IP protocol that supports Secure Sockets Layer communications over IPV6), specified during configuration of a remote monitoring server. This protocol is available for a monitoring server on a z/OS system at release level V1R7 or higher, with IPV6 installed and operational. The value specified for this parameter must match the value set for the “KDS_TEMS_TCP_PIPE6S_PORT_NUM” on page 226 parameter in the runtime environment where the hub is configured, or the value set for an equivalent parameter of a distributed hub. Related parameters v “KDS_TEMS_TCP_PIPE6S_PORT_NUM” on page 226 KDS_HUB_TCP_PIPES_PORT_NUM This parameter contains the well-known port for the hub monitoring server for the IP.SPIPE communication protocol (the TCP/IP protocol that supports Secure Sockets Layer communications over IPV4), specified during configuration of a remote monitoring server Required or optional Required for remote Tivoli Enterprise Monitoring Servers that use the IP.SPIPE protocol for communications with the hub Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the remote monitoring server Parameter name KDE_TRANSPORT (IP.SPIPE PORT option) Example: KDE_TRANSPORT=\ IP.SPIPE PORT:3660 162 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Default value 3660 Permissible values 1 - 65535 Configuration Tool (ICAT) information Panel name Specify Configuration - Hub Values for Remote TEMS Panel ID KDS62PP2 Field IP.SPIPE port number Default value 3660 or the value set for the “KDS_TEMS_TCP_PIPES_PORT_NUM” on page 227 parameter for the hub Permissible values 1 - 65535 Batch parameter name KDS_HUB_TCP_PIPES_PORT PARMGEN name KDS_HUB_TCP_PIPES_PORT_NUM Description Well-known port for the hub monitoring server for the IP.SPIPE communication protocol (the TCP/IP protocol that supports Secure Sockets Layer communications over IPV4), specified during configuration of a remote monitoring server. This protocol is available for a monitoring server on a z/OS system at release level V1R7 or higher. The value specified for this parameter must match the value set for the “KDS_TEMS_TCP_PIPES_PORT_NUM” on page 227 parameter in the runtime environment where the hub is configured, or the value set for an equivalent parameter of a distributed hub. Related parameters v “KDS_TEMS_TCP_PIPES_PORT_NUM” on page 227 KDS_HUB_TCP_UDP_PORT_NUM This parameter contains the well-known port for the hub monitoring server for the IP.UDP communication protocol (the TCP/IP protocol that uses the packet-based, connectionless User Datagram Protocol under IPV4), specified during configuration of a remote monitoring server. Required or optional Required for remote Tivoli Enterprise Monitoring Servers that use the IP.UDP protocol for communications with the hub Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the remote monitoring server Parameter name KDE_TRANSPORT (IP.UDP PORT option) Example: KDE_TRANSPORT=\ IP.UDP PORT:1918 Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 163 Default value 1918 Permissible values 1 - 65535 Configuration Tool (ICAT) information Panel name Specify Configuration - Hub Values for Remote TEMS Panel ID KDS62PP2 Field IP.UDP port number Default value 1918 or the value set for the “KDS_TEMS_TCP_UDP_PORT_NUM” on page 229 parameter for the hub Permissible values 1 - 65535 Batch parameter name KDS_HUB_TCP_UDP_PORT PARMGEN name KDS_HUB_TCP_UDP_PORT_NUM Description Well-known port for the hub monitoring server for the IP.UDP communication protocol (the TCP/IP protocol that uses the packet-based, connectionless User Datagram Protocol under IPV4), specified during configuration of a remote monitoring server. The value specified for this parameter must match the value set for the “KDS_TEMS_TCP_UDP_PORT_NUM” on page 229 parameter in the runtime environment where the hub is configured, or the value set for an equivalent parameter of a distributed hub. Related parameters v “KDS_TEMS_TCP_UDP_PORT_NUM” on page 229 KDS_HUB_TCP_UDP6_PORT_NUM This parameter specifies the well-known port for the hub monitoring server for the IP6.UDP communication protocol (the packet-based, connectionless User Datagram Protocol that supports IPV6), specified during configuration of a remote monitoring server. Required or optional Required for remote Tivoli Enterprise Monitoring Servers that use the IP6.UDP protocol for communications with the hub Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the remote monitoring server Parameter name KDE_TRANSPORT (IP6.UDP PORT option) Example: KDE_TRANSPORT=\ IP6.UDP PORT:1918 Default value 1918 164 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Permissible values 1 - 65535 Configuration Tool (ICAT) information Panel name Specify Configuration - Hub Values for Remote TEMS Panel ID KDS62PP2 Field IP6.UDP port number Default value 1918 or the value set for the “KDS_TEMS_TCP_UDP6_PORT_NUM” on page 230 parameter for the hub Permissible values 1 - 65535 Batch parameter name KDS_HUB_TCP_UDP6_PORT PARMGEN name KDS_HUB_TCP_UDP6_PORT_NUM Description Well-known port for the hub monitoring server for the IP6.UDP communication protocol (the packet-based, connectionless User Datagram Protocol that supports IPV6), specified during configuration of a remote monitoring server. This protocol is available for a monitoring server on a z/OS system at release level V1R7 or higher, with IPV6 installed and operational. The value specified for this parameter must match the value set for the “KDS_TEMS_TCP_UDP6_PORT_NUM” on page 230 parameter in the runtime environment where the hub is configured, or the value set for an equivalent parameter of a distributed hub. Related parameters v “KDS_TEMS_TCP_UDP6_PORT_NUM” on page 230 KDS_HUB_TEMS_HA_TYPE This parameter specifies whether the hub with which a remote Tivoli Enterprise Monitoring Server communicates is a high-availability hub. Required or optional Required for remote Tivoli Enterprise Monitoring Servers Location where the parameter value is stored The parameter value is not stored, but is used for internal processing. Configuration Tool (ICAT) information Panel name Specify Configuration Values Panel ID KDS62PP1 Field Hub TEMS type Default value None Permissible values HA or none Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 165 Batch parameter name KDS_HUB_HA_TYP PARMGEN name KDS_HUB_TEMS_HA_TYPE Description Specifies whether the hub with which a remote Tivoli Enterprise Monitoring Server communicates is a high-availability hub. Related parameters v “KDS_TEMS_HA_TYPE” on page 206 KDS_HUB_VTAM_APPL_GLB_BROKER This parameter specifies the VTAM applid for the global location broker of the hub monitoring server. Required or optional Required for remote Tivoli Enterprise Monitoring Servers that use the SNA.PIPE protocol for communications with the hub Location where the parameter value is stored v KDCSSITE member of the rhilev.rte.RKANPARU library for the runtime environment of the remote monitoring server v XCF_PLEXGROUP parameter in the KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the remote monitoring server Configuration Tool (ICAT) information Panel name Specify Configuration - Hub Values for Remote TEMS Panel ID KDS62PP2 Field Global location broker applid of Hub Default value None Permissible values Character string, maximum length 8 Batch parameter name KDS_HUB_GLB_APPL PARMGEN name KDS_HUB_VTAM_APPL_GLB_BROKER Description VTAM applid for the global location broker of the hub monitoring server. You can find this applid in the VTAM major node definition in SYS1.VTAMLST for the hub. Related parameters v “KDS_TEMS_VTAM_APPL_GLB_BROKER” on page 234 KDS_HUB_VTAM_NETID This parameter specifies the VTAM network identifier associated with the hub monitoring server. Required or optional Required for remote Tivoli Enterprise Monitoring Servers that use the SNA.PIPE protocol for communications with the hub 166 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Location where the parameter value is stored KDCSSITE member of the rhilev.rte.RKANPARU library for the runtime environment of the remote monitoring server Configuration Tool (ICAT) information Panel name Specify Configuration - Hub Values for Remote TEMS Panel ID KDS62PP2 Field Network ID of hub Default value None Permissible values Character string, maximum length 8 Batch parameter name KDS_HUB_VTM_NETID PARMGEN name KDS_HUB_VTAM_NETID Description VTAM network identifier associated with the hub monitoring server. Related parameters v “KDS_TEMS_VTAM_NETID” on page 239 KDS_KMS_SDA This parameter indicates whether the server supports self-describing agents. Required or optional Required Location where the parameter value is stored The KMS_SDA parameter in the RKANPARU data set, member KDSENV. In the Configuration Tool (ICAT) Panel name TEMS Self-Describing Agent Values Panel ID KDS62PP4 Field Enable TEMS Self-Description processing (KMS_SDA) Default value Y for a remote TEMS N for a hub TEMS Permissible values Y, N Batch parameter name KDS_KMS_SDA PARMGEN name KDS_KMS_SDA Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 167 Description This field indicates whether the server supports and runs the self-description feature. Related parameters v “GBL_HFS_JAVA_DIRn” on page 103 v “GBL_DSN_SYS1_SBPXEXEC” on page 97 v “RTE_USS_RTEDIR” on page 146 v “KDS_TEMA_SDA” on page 196 v “KPP_AGT_TEMA_SDA” on page 33 KDS_MIG_TAPE_HILEV This parameter specifies the high-level qualifier (with DISP=NEW) for the backup VSAM clusters on tape. Required or optional Required for migrating customized objects (for example, modified situations, templates, and managed objects) from a previous version to a later version of the Tivoli Enterprise Monitoring Server Location where the parameter value is stored KDSDMG4B member of the rhilev.rte.RKANSAMU library for the runtime environment of the monitoring server Configuration Tool (ICAT) information Panel name Generate Sample Migration JCL Panel ID KDS62PMG Field Tape high-level qualifier Default value None Permissible values Character string, maximum length 35 Batch parameter name KDS_MIG_TAPE_HILEV PARMGEN name KDS_MIG_TAPE_HILEV Description High-level qualifier (with DISP=NEW) for the backup VSAM clusters on tape. For complete upgrade instructions, see IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Upgrade Guide. Related parameters v “KDS_MIG_TAPE_UNIT” v “KDS_MIG_TAPE_VOL” on page 169 v “KDS_MIG_VSAM_HILEV” on page 170 KDS_MIG_TAPE_UNIT This parameter specifies the unit device name for the backup VSAM clusters on tape. Required or optional Optional 168 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Location where the parameter value is stored KDSDMG4B member of the rhilev.rte.RKANSAMU library for the runtime environment of the monitoring server Configuration Tool (ICAT) information Panel name Generate Sample Migration JCL Panel ID KDS62PMG Field Tape unit type Default value None Permissible values Character string, maximum length 8 Batch parameter name KDS_MIG_TAPE_UNIT PARMGEN name KDS_MIG_TAPE_UNIT Description Unit device name for the backup VSAM clusters on tape. Leave this field blank if your environment does not require the unit name. For complete upgrade instructions, see IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Upgrade Guide. Related parameters v “KDS_MIG_TAPE_VOL” KDS_MIG_TAPE_VOL This parameter specifies the volume serial for the backup VSAM clusters on tape. Required or optional Optional Location where the parameter value is stored KDSDMG4B member of the rhilev.rte.RKANSAMU library for the runtime environment of the monitoring server Configuration Tool (ICAT) information Panel name Generate Sample Migration JCL Panel ID KDS62PMG Field Tape volser Default value None Permissible values Character string, maximum length 6 Batch parameter name KDS_MIG_TAPE_VOL PARMGEN name KDS_MIG_TAPE_VOL Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 169 Description Volume serial for the backup VSAM clusters on tape. Leave this field blank if your environment does not require the volume serial number. For complete upgrade instructions, see IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Upgrade Guide. Related parameters v “KDS_MIG_TAPE_UNIT” on page 168 KDS_MIG_VER This parameter specifies the version number of the Tivoli Enterprise Monitoring Server whose customized objects you want to migrate. Required or optional Required for migrating customized objects (for example, modified situations, templates, and managed objects) from a previous version to a later version of the Tivoli Enterprise Monitoring Server Location where the parameter value is stored KDSDMG4B member of the rhilev.rte.RKANSAMU library for the runtime environment of the monitoring server Configuration Tool (ICAT) information Panel name Generate Sample Migration JCL Panel ID KDS62PMG Field TEMS version Default value None Permissible values Version number, in nnn format Batch parameter name KDS_MIG_VER PARMGEN name KDS_MIG_VER Description Version number of the Tivoli Enterprise Monitoring Server whose customized objects you want to migrate. For complete upgrade instructions, see IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Upgrade Guide. Related parameters v “KDS_MIG_VSAM_HILEV” v “KDS_MIG_TAPE_HILEV” on page 168 KDS_MIG_VSAM_HILEV This parameter specifies complete high-level qualifier (rvhilev.rte) of the VSAM runtime libraries from which you want to migrate customized objects. Required or optional Required for migrating customized objects (for example, modified situations, templates, and managed objects) from a previous version to a later version of the Tivoli Enterprise Monitoring Server 170 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Location where the parameter value is stored KDSDMG4B member of the rhilev.rte.RKANSAMU library for the runtime environment of the monitoring server Configuration Tool (ICAT) information Panel name Generate Sample Migration JCL Panel ID KDS62PMG Field VSAM high-level qualifier Default value None Permissible values Character string, maximum length 35 Batch parameter name KDS_MIG_VSAM_HILEV PARMGEN name KDS_MIG_VSAM_HILEV Description Complete high-level qualifier (rvhilev.rte) of the VSAM runtime libraries from which you want to migrate customized objects. For complete upgrade instructions, see IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Upgrade Guide. Related parameters v “KDS_MIG_TAPE_HILEV” on page 168 KDS_NONSTDnn_DSN This parameter specifies the low-level qualifier of the data set containing the member with the parameter to be added, replaced, or deleted by specifying a nonstandard parameter (a parameter that is not presented in a Configuration Tool interactive panel). Required or optional Optional in the Configuration Tool interactive and batch modes; does not apply to PARMGEN configuration Location where the parameter value is stored Member specified in the “KDS_NONSTDnn_MBR” on page 172 parameter Configuration Tool (ICAT) information Panel name Specify Nonstandard Parameters Panel ID KDSPNSTn Field Low-level dataset qualifier Default value None Permissible values Character string, maximum length 8 Batch parameter name KDS_NONSTDnn_DSN Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 171 PARMGEN name KDS_NONSTDnn_DSN Description The low-level qualifier of the data set containing the member with the parameter to be added, replaced, or deleted by specifying a nonstandard parameter (a parameter that is not presented in a Configuration Tool interactive panel). Each KDS_NONSTDnn_DSN parameter has a unique name, in which nn represents a number between 1 and 18, corresponding to the number set for “KDS_NONSTDnn_PARM” on page 173. For more information about specifying nonstandard parameters, see the "Parameters" section of IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. For examples of commonly specified nonstandard parameters, see the "Configuration, and Deployment: Highlights of Common z/OS Configuration Tool Enhancements" Technote at http://www.ibm.com/support/docview.wss?uid=swg21338430. Related parameters v “KDS_NONSTDnn_PARM” on page 173 v “KDS_NONSTDnn_MBR” KDS_NONSTDnn_MBR This parameter specifies the name of the KDS_NONSTDnn_DSN data set member that contains the parameter to be added, replaced, or deleted by specifying a nonstandard parameter (a parameter that is not presented in a Configuration Tool interactive panel). Required or optional Optional in the Configuration Tool interactive and batch modes; does not apply to PARMGEN configuration Location where the parameter value is stored Member specified in this parameter, in the data set specified in the “KDS_NONSTDnn_DSN” on page 171 parameter Configuration Tool (ICAT) information Panel name Specify Nonstandard Parameters Panel ID KDSPNSTn Field Member Default value None Permissible values Character string, maximum length 8 Batch parameter name KDS_NONSTDnn_MBR PARMGEN name KDS_NONSTDnn_MBR Description Name of the “KDS_NONSTDnn_DSN” on page 171 data set member that contains the parameter to be added, replaced, or deleted by specifying a nonstandard parameter (a parameter that is not presented in a Configuration Tool interactive panel). The asterisk (*) wildcard character can be used as a suffix in column 4, 5, 6, 7, or 8 of the member name (provided that column is the final one in the name). 172 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Each KDS_NONSTDnn_MBR parameter has a unique name, in which nn represents a number between 1 and 18, corresponding to the number set for “KDS_NONSTDnn_PARM.” For more information about specifying nonstandard parameters, see the "Parameters" section of IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. For examples of commonly specified nonstandard parameters, see the "Configuration, and Deployment: Highlights of Common z/OS Configuration Tool Enhancements" Technote at http://www.ibm.com/support/docview.wss?uid=swg21338430. Related parameters v “KDS_NONSTDnn_PARM” v “KDS_NONSTDnn_DSN” on page 171 KDS_NONSTDnn_PARM This parameter specifies the name of the configuration parameter to be added, replaced, or deleted. Required or optional Optional in the Configuration Tool interactive and batch modes; does not apply to PARMGEN configuration Location where the parameter value is stored Data set and member specified in the “KDS_NONSTDnn_MBR” on page 172 and “KDS_NONSTDnn_DSN” on page 171 parameters, respectively Configuration Tool (ICAT) information Panel name Specify Nonstandard Parameters Panel ID KDSPNSTn Field Parameter Default value None Permissible values Character string, maximum length 40 Batch parameter name KDS_NONSTDnn_PARM PARMGEN name KDS_NONSTDnn_PARM Description Name of the configuration parameter to be added, replaced, or deleted. You can specify up to 18 nonstandard parameters (parameters that are not presented in the Configuration Tool interactive panels). Each nonstandard parameter has a unique name in which nn represents a number between 1 and 18. For more information about specifying nonstandard parameters, see the "Parameters" section of IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. For examples of commonly specified nonstandard parameters, see the "Configuration, and Deployment: Highlights of Common z/OS Configuration Tool Enhancements" Technote at http://www.ibm.com/support/docview.wss?uid=swg21338430. Related parameters v “KDS_NSNEWnn_VALUE” on page 174 v “KDS_NSOLDnn_VALUE” on page 174 Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 173 KDS_NSNEWnn_VALUE This parameter specifies the value for a nonstandard parameter (a parameter that is not presented in a Configuration Tool interactive panel). Required or optional Optional in the Configuration Tool interactive and batch modes; does not apply to PARMGEN configuration Location where the parameter value is stored Data set, member, and parameter specified in the “KDS_NONSTDnn_MBR” on page 172, “KDS_NONSTDnn_DSN” on page 171, and “KDS_NONSTDnn_PARM” on page 173 parameters, respectively. Configuration Tool (ICAT) information Panel name Specify Nonstandard Parameters Panel ID KDSPNSTn Field New Value Default value None Permissible values Character string, maximum length 50 Batch parameter name KDS_NSNEWnn_VALUE PARMGEN name KDS_NSNEWnn_VALUE Description Value for a nonstandard parameter (a parameter that is not presented in a Configuration Tool interactive panel). In specifying the value, be sure to include format characters. For example, if the format in the runtime member is parameter=value, precede the value with an equal sign; or if the format is parameter(value), surround the value with parentheses. If you want to delete an existing parameter that is specified in “KDS_NONSTDnn_PARM” on page 173, leave the value of the corresponding KDS_NSNEWnn_VALUE parameter blank. Each KDS_NSNEWnn_VALUE parameter has a unique name, in which nn represents a number between 1 and 18, corresponding to the number set for “KDS_NONSTDnn_PARM” on page 173. For more information about specifying nonstandard parameters, see the "Parameters" section of IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. For examples of commonly specified nonstandard parameters, see the "Configuration, and Deployment: Highlights of Common z/OS Configuration Tool Enhancements" Technote at http://www.ibm.com/support/docview.wss?uid=swg21338430. Related parameters v “KDS_NONSTDnn_PARM” on page 173 v “KDS_NSOLDnn_VALUE” KDS_NSOLDnn_VALUE This parameter specifies the existing value to be replaced or deleted in the parameter definition corresponding to KDS_NONSTDnn_PARM. 174 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Required or optional Optional in the Configuration Tool interactive and batch modes; does not apply to PARMGEN configuration Location where the parameter value is stored Replaced in the data set, member, and parameter specified in the “KDS_NONSTDnn_MBR” on page 172, “KDS_NONSTDnn_DSN” on page 171, and “KDS_NONSTDnn_PARM” on page 173 parameters, respectively. Configuration Tool (ICAT) information Panel name Specify Nonstandard Parameters Panel ID KDSPNSTn Field Old Value (if replacing) Default value None Permissible values Character string, maximum length 50 Batch parameter name KDS_NSOLDnn_VALUE PARMGEN name KDS_NSOLDnn_VALUE Description Existing value to be replaced or deleted in the parameter definition corresponding to “KDS_NONSTDnn_PARM” on page 173. The character string that you specify must match exactly the existing value for the parameter in the runtime member, or the value is not replaced. For example, if the format in the runtime member is parameter=value, precede the value with an equal sign; or if the format is parameter(value), surround the value with parentheses. Each KDS_NSOLDnn_VALUE parameter has a unique name, in which nn represents a number between 1 and 18, corresponding to the number set for “KDS_NONSTDnn_PARM” on page 173. For more information about specifying nonstandard parameters, see the "Parameters" section of IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. For examples of commonly specified nonstandard parameters, see the "Configuration, and Deployment: Highlights of Common z/OS Configuration Tool Enhancements" Technote at http://www.ibm.com/support/docview.wss?uid=swg21338430. Related parameters v “KDS_NONSTDnn_PARM” on page 173 v “KDS_NSNEWnn_VALUE” on page 174 KDS_PA This parameter indicates the beginning or end of the partition reference table for address translation. Required or optional Required for broker partitioning Location where the parameter value is stored KDCPART member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 175 Batch parameter name KDS_PA PARMGEN name KDS_PA Description Indicates the beginning or end of the partition reference table for address translation. The partition table contains labels and associated socket addresses provided by the firewall administrator. This parameter is for IBM internal use only. Related parameters v “KDS_TEMS_COMM_ADDRESS_XLAT” on page 196 v “KDS_PA_PARTITION_ADDRESS” v “KDS_PA_PARTITION_NAME” on page 177 v “KDS_TEMS_PARTITION_NAME” on page 213 KDS_PA_PARTITION_ADDRESS This parameter contains the IP address or SNA reference assigned to the Tivoli Enterprise Monitoring Server from a location on the other side of the firewall. Required or optional Required for broker partitioning Location where the parameter value is stored KDCPART member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Configuration Tool (ICAT) information Panel name Specify IP.PIPE Partition References Panel ID KDS62PPE Field Partition address Default value None Permissible values Character string, maximum length 19 Batch parameter name KDS_PA_ADDR PARMGEN name KDS_PA_PARTITION_ADDRESS Description IP address or SNA reference assigned to the Tivoli Enterprise Monitoring Server from a location on the other side of the firewall. The partition address that you supply is added to the partition table identified by the “KDS_PA” on page 175 parameter. The partition table contains labels and associated socket addresses provided by the firewall administrator. If the value of the “KDS_TEMS_COMM_ADDRESS_XLAT” on page 196 parameter is Y, this parameter must have a value assigned to it, or the Tivoli Enterprise Monitoring Server and its communications will fail. Related parameters v “KDS_TEMS_COMM_ADDRESS_XLAT” on page 196 176 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference v “KDS_PA” on page 175 v “KDS_PA_PARTITION_NAME” KDS_PA_PARTITION_NAME This parameter contains the partition name (label) that identifies the location of the Tivoli Enterprise Monitoring Server relative to the firewall or firewalls used for address translation. Required or optional Required for broker partitioning Location where the parameter value is stored KDCPART member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Configuration Tool (ICAT) information Panel name Specify IP.PIPE Communication Protocol Panel ID KDS62PPD Field Partition name Default value None Permissible values Character string, maximum length 32 Batch parameter name KDS_PA_NAME PARMGEN name KDS_PA_PARTITION_NAME Description Partition name (label) that identifies the location of the Tivoli Enterprise Monitoring Server relative to the firewall or firewalls used for address translation. The partition name that you supply is added to the partition table identified by the “KDS_PA” on page 175 parameter. The partition table contains labels and associated socket addresses provided by the firewall administrator. The label is used outside the firewall to establish monitoring server connections. The well-known port for the hub monitoring server must be authorized by the firewall administrator. For the IP*.*PIPE protocols, no additional ports be authorized. If the value of the “KDS_TEMS_COMM_ADDRESS_XLAT” on page 196 parameter is Y, this parameter must have a value assigned to it, or the Tivoli Enterprise Monitoring Server and its communications will fail. Related parameters v “KDS_TEMS_COMM_ADDRESS_XLAT” on page 196 v “KDS_PA” on page 175 v “KDS_PA_PARTITION_ADDRESS” on page 176 KDS_PA_ROW This parameter indicates the beginning or end of a row in the partition reference table for address translation. Required or optional Required for broker partitioning Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 177 Location where the parameter value is stored KDCPART member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Batch parameter name KDS_PA_ROW PARMGEN name KDS_PA_ROW Description Indicates the beginning or end of a row in the partition reference table for address translation. This parameter is for IBM internal use only. Related parameters v “KDS_TEMS_COMM_ADDRESS_XLAT” on page 196 v “KDS_PA” on page 175 KDS_PD This parameter indicates the beginning or end of the persistent data store specifications table. Required or optional Optional Location where the parameter value is stored KPDPG member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Batch parameter name KDS_PD PARMGEN name KDS_PD Description Indicates the beginning or end of the persistent data store specifications table. The persistent data store is the repository for short-term historical data. This parameter is for IBM internal use only. Related parameters v “KDS_PD_GRP” on page 179 v “KDS_PD_ROW” on page 180 KDS_PD_CYL This parameter contains the 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 when the libraries are full. Required or optional Optional Location where the parameter value is stored KPDAL member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Configuration Tool (ICAT) information Panel name Modify and Review Datastore Specifications 178 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Panel ID KPD62PP3 Field Est Cyl Space Default value None Permissible values 1 - 9999 Batch parameter name KDS_PD_CYL PARMGEN name KDS_PD_CYL Description 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 when the libraries are full. By default, the Tivoli Enterprise Portal Server retrieves historical data for reports once every 24 hours. Unless the Tivoli Enterprise Portal Server KFW_REPORT_TERM_BREAK_POINT parameter is set to a value other than the default, allocate enough space (n data sets) for the persistent data store to permit n-1 data sets to hold 24 hours of data. For more information about maintaining the persistent data store, see IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. For information about historical data collection and reporting, see IBM Tivoli Monitoring: Administrator's Guide. Related parameters None KDS_PD_GRP This parameter contains the name of a single persistent data store group. Required or optional Optional Location where the parameter value is stored KPDPG member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Parameter name GROUP Default value None Permissible values Character string, maximum length 8 Configuration Tool (ICAT) information Panel name Modify and Review Datastore Specifications Panel ID KPD62PP3 Field Group Name Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 179 Default value None Permissible values Character string, maximum length 8 Batch parameter name KDS_PD_GRP PARMGEN name KDS_PD_GRP Description Name of a single persistent data store group. Related parameters v “KDS_PD_ROW” v “KDS_PD” on page 178 KDS_PD_ROW This parameter indicates the beginning or end of a single persistent datastore group for the monitoring server. Required or optional Optional Location where the parameter value is stored KPDPG member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Batch parameter name KDS_PD_ROW PARMGEN name KDS_PD_ROW Description Indicates the beginning or end of a single persistent datastore group for the monitoring server. This parameter is for IBM internal use only. Related parameters v “KDS_PD_GRP” on page 179 v “KDS_PD” on page 178 KDS_PH This parameter indicates the beginning or end of the table that lists the hub monitoring servers that are eligible for SOAP server access. Required or optional Required for a hub Tivoli Enterprise Monitoring Server Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Batch parameter name KDS_PH PARMGEN name KDS_PH 180 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Description Indicates the beginning or end of the table that lists the hub monitoring servers that are eligible for SOAP server access. This parameter is for IBM internal use only. Related parameters v “KDS_TEMS_SOAP_SERVER_FLAG” on page 215 v “KDS_PH_ROW” KDS_PH_ROW This parameter indicates the beginning or end of a single hub monitoring server entry in the SOAP server list. Required or optional Required for a hub Tivoli Enterprise Monitoring Server Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Batch parameter name KDS_PH_ROW PARMGEN name KDS_PH_ROW Description Indicates the beginning or end of a single hub monitoring server entry in the SOAP server list. This parameter is for IBM internal use only. Related parameters “KDS_TEMS_SOAP_SERVER_FLAG” on page 215 “KDS_PH” on page 180 KDS_PH_TEMS_ALIAS_NAME This parameter contains the TEMS name (node ID) that identifies a non-local hub monitoring server to the SOAP server. For best results, accept the default name. Required or optional Required for a non-local hub Tivoli Enterprise Monitoring Server Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the local monitoring server Example: Aliasrte_name:CMS/Alias Configuration Tool (ICAT) information Panel name Specify TEMS KSHXHUBS Values Panel ID KDS62PPG Field Alias name Default value Value set for “RTE_TEMS_NAME_NODEID” on page 142 in the runtime environment of the hub Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 181 Permissible values Character string, maximum length 32 Batch parameter name KDS_PH_CMS_ALIAS_NAME PARMGEN name KDS_PH_TEMS_ALIAS_NAME Description TEMS name (node ID) that identifies a non-local hub monitoring server to the SOAP server. For best results, accept the default name. Related parameters v “RTE_TEMS_NAME_NODEID” on page 142 v “KDS_TEMS_SOAP_SERVER_FLAG” on page 215 KDS_PH_TEMS_COMM_PROTOCOL1 This parameter contains the communication protocol to be used by the SOAP server. Required or optional Required for a hub Tivoli Enterprise Monitoring Server Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Example: CMS_NameIP.PIPE:SYS1[1918]/CMS_Name Configuration Tool (ICAT) information Panel name Specify TEMS KSHXHUBS Values Panel ID KDS62PPG Field Protocol 1 Default value Value set for the KDS_TEMS_COMM_PROTOCOL1 parameter for the hub Permissible values IPPIPE, IP, IP6PIPE, IP6, IPSPIPE, IP6SPIPE, or SNA Batch parameter name KDS_PH_CMS_COMM_PRO1 PARMGEN name KDS_PH_TEMS_COMM_PROTOCOL1 Description Communication protocol to be used by the SOAP server. The value of this parameter is included in the entry for this hub in the KSHXHUBS member of the rhilev.rte.RKANPARU library. Related parameters v “KDS_TEMS_COMM_PROTOCOLn” on page 197 KDS_PH_TEMS_KSH_SECURE This parameter defines the security status of the SOAP server. 182 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Required or optional Required for a hub Tivoli Enterprise Monitoring Server Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Configuration Tool (ICAT) information Panel name SOAP Server KSHXHUBS List Panel ID KDS62PPF Field TEMS secured Default value N Permissible values Y or N Batch parameter name KDS_PH_CMS_KSH_SECURE PARMGEN name KDS_PH_TEMS_KSH_SECURE Description Security status of the SOAP server.If no user access list is defined, the value of this parameter is set to N and the SOAP server honors requests from any user ID that passes logon validation. If user IDs with query or update access are listed, the parameter value is set to Y. If user IDs are listed and given global security access, the parameter value is reset to N. For more information about SOAP server security, see the "Planning for the SOAP server on z/OS" section of IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. For SOAP server configuration instructions, see IBM Tivoli Management Services on z/OS: Configuring the Tivoli Enterprise Monitoring Server on z/OS. Related parameters v “KDS_PU_TEMS_USER_QUERY” on page 194 v “KDS_PU_TEMS_USER_UPDATE” on page 195 KDS_PH_TEMS_NAME_NODEID This parameter defines the TEMS name (node ID) of the hub monitoring server. Required or optional Required for a hub Tivoli Enterprise Monitoring Server Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Example: Service_Namerte_name:CMS/Service_Name Configuration Tool (ICAT) information Panel name Specify TEMS KSHXHUBS Values Panel ID KDS62PPG Field TEMS name Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 183 Default value Value of the “RTE_TEMS_NAME_NODEID” on page 142 parameter Permissible values Character string, maximum length 32 Batch parameter name KDS_PH_CMS_NAME PARMGEN name KDS_PH_TEMS_NAME_NODEID Description TEMS name (node ID) of the hub monitoring server. For best results, accept the default name. Related parameters v “RTE_TEMS_NAME_NODEID” on page 142 KDS_PH_TEMS_RTE This parameter contains the name of the runtime environment where the hub is configured. Required or optional Required for the hub Tivoli Enterprise Monitoring Server SOAP server Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Example: Service_Namerte_name:CMS/Service_Name Configuration Tool (ICAT) information Panel name Specify TEMS KSHXHUBS Values Panel ID KDS62PPG Field Hub TEMS SOAP Server values for rtename Default value Value of the “RTE_NAME” on page 117 parameter Permissible values Character string, maximum length 8 Batch parameter name KDS_PH_CMS_RTE PARMGEN name KDS_PH_TEMS_RTE Description Name of the runtime environment where the hub is configured. Accept the default value. Related parameters v “RTE_NAME” on page 117 KDS_PH_TEMS_SYSV_FLAG This parameter determines whether system variables are to be enabled for the SOAP server. Required or optional Required 184 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Batch parameter name KDS_PH_CMS_SYSV PARMGEN name KDS_PH_TEMS_SYSV_FLAG Description Determines whether system variables are to be enabled for the SOAP server. The value of this parameter is always set to match the value of the “RTE_SYSV_SYSVAR_FLAG” on page 136 parameter. If system variables are enabled for the runtime environment, the server list that is maintained in the KSHXHUBS member of the rhilev.rte.RKANPARU library is restricted to hub monitoring servers that support z/OS system symbols. Related parameters v “RTE_SYSV_SYSVAR_FLAG” on page 136 KDS_PH_TEMS_TCP_HOST This parameter contains the host name of the SOAP server. Required or optional Required for a hub Tivoli Enterprise Monitoring Server if Protocol 1 (the highest-priority protocol) for the SOAP server is one of the TCP/IP protocols Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Example: CMS_NameIP.PIPE:SYS1[1918]/CMS_Name Configuration Tool (ICAT) information Panel name Specify TEMS KSHXHUBS Values Panel ID KDS62PPG Field TCP hostname Default value Value of the “KDS_TEMS_TCP_HOST” on page 222 parameter Permissible values Character string, maximum length 32 Batch parameter name KDS_PH_CMS_TCP_HOST PARMGEN name KDS_PH_TEMS_TCP_HOST Description Host name of the SOAP server. For best results, accept the default value. Related parameters v “KDS_PH_TEMS_COMM_PROTOCOL1” on page 182 v “KDS_TEMS_TCP_HOST” on page 222 Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 185 KDS_PH_TEMS_TCP_HOST_LEN This parameter defines the number of characters (up to 255) to be used internally in preparing for TCP host name expansion. Required or optional Required for a hub Tivoli Enterprise Monitoring Server if Protocol 1 (the highest-priority protocol) for the SOAP server is one of the TCP/IP protocols Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Batch parameter name KDS_PH_CMS_TCP_HOST_LEN PARMGEN name KDS_PH_TEMS_TCP_HOST_LEN Description Number of characters (up to 255) to be used internally in preparing for TCP host name expansion. Related parameters v “KDS_PH_TEMS_TCP_HOST” on page 185 KDS_PH_TEMS_TCP_PORT_NUM This parameter defines the TCP port number of the SOAP server. Required or optional Required for a hub Tivoli Enterprise Monitoring Server if Protocol 1 (the highest-priority protocol) for the SOAP server is one of the TCP/IP protocols Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Example: CMS_NameIP.PIPE:SYS1[1918]/CMS_Name Configuration Tool (ICAT) information Panel name Specify TEMS KSHXHUBS Values Panel ID KDS62PPG Field TCP port number Default value Value set for the highest-priority TCP/IP protocol for the hub Tivoli Enterprise Monitoring Server Permissible values 1 - 65535 Batch parameter name KDS_PH_CMS_TCP_PORT PARMGEN name KDS_PH_TEMS_TCP_PORT_NUM Description TCP port number of the SOAP server. For best results, accept the default value. 186 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Related parameters v “KDS_PH_TEMS_COMM_PROTOCOL1” on page 182 v “KDS_TEMS_COMM_PROTOCOLn” on page 197 KDS_PH_TEMS_USER_QUERY This parameter defines the user ID with query access to the SOAP server. Required or optional Optional Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Configuration Tool (ICAT) information Panel name Specify TEMS KSHXHUBS Values Panel ID KDS62PPG Field Query access Default value None Permissible values Character string, maximum length 8 Batch parameter name KDS_PH_CMS_USER_QUERY PARMGEN name KDS_PH_TEMS_USER_QUERY Description User ID with query access to the SOAP server. To add more users, use the KDS_PU_TEMS_USER_* parameters. Related parameters v “KDS_PU_TEMS_USER_QUERY” on page 194 v “KDS_PU_TEMS_USER_ID” on page 194 KDS_PH_TEMS_USER_UPDATE This parameter defines the user ID with update access to the SOAP server. Required or optional Optional Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Configuration Tool (ICAT) information Panel name Specify TEMS KSHXHUBS Values Panel ID KDS62PPG Field Update access Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 187 Default value None Permissible values Character string, maximum length 8 Batch parameter name KDS_PH_CMS_USER_UPDATE PARMGEN name KDS_PH_TEMS_USER_UPDATE Description User ID with update access to the SOAP server. To add more users, use the KDS_PU_TEMS_USER_* parameters. Related parameters v “KDS_PU_TEMS_USER_UPDATE” on page 195 v “KDS_PU_TEMS_USER_ID” on page 194 KDS_PH_TEMS_VTAM_APPL_GLB_BROKER This parameter defines the VTAM applid for the global location broker of the SOAP server. Required or optional Required for a hub Tivoli Enterprise Monitoring Server if Protocol 1 (the highest-priority protocol) for the SOAP server is SNA Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Configuration Tool (ICAT) information Panel name Specify TEMS KSHXHUBS Values Panel ID KDS62PPG Field SNA global location broker applid Default value Value set for “KDS_TEMS_VTAM_APPL_GLB_BROKER” on page 234 Permissible values Character string, maximum length 26 Batch parameter name KDS_PH_CMS_VTM_APPL_GLB PARMGEN name KDS_PH_TEMS_VTAM_APPL_GLB_BROKER Description VTAM applid for the global location broker of the SOAP server. Related parameters v “KDS_PH_TEMS_COMM_PROTOCOL1” on page 182 v “KDS_TEMS_VTAM_APPL_GLB_BROKER” on page 234 KDS_PH_TEMS_VTAM_LU62_DLOGMOD This parameter defines the LU6.2 logmode entry required by the SOAP server for SNA communications. 188 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Required or optional Required for a hub Tivoli Enterprise Monitoring Server if Protocol 1 (the highest-priority protocol) for the SOAP server is SNA Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Configuration Tool (ICAT) information Panel name Specify TEMS KSHXHUBS Values Panel ID KDS62PPG Field SNA LU6.2 logmode Default value Value set for the “KDS_TEMS_VTAM_LU62_DLOGMOD” on page 238 parameter Permissible values Character string, maximum length 8 Batch parameter name KDS_PH_CMS_VTM_LU62_LOG PARMGEN name KDS_PH_TEMS_VTAM_LU62_DLOGMOD Description LU6.2 logmode entry required by the SOAP server for SNA communications. Related parameters v “KDS_PH_TEMS_COMM_PROTOCOL1” on page 182 v “KDS_TEMS_VTAM_LU62_DLOGMOD” on page 238 KDS_PH_TEMS_VTAM_NETID This parameter defines the VTAM network identifier for the SOAP server. Required or optional Required for a hub Tivoli Enterprise Monitoring Server if Protocol 1 (the highest-priority protocol) for the SOAP server is SNA Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Configuration Tool (ICAT) information Panel name Specify TEMS KSHXHUBS Values Panel ID KDS62PPG Field SNA network ID Default value Value set for “KDS_TEMS_VTAM_NETID” on page 239 Permissible values Character string, maximum length 8 Batch parameter name KDS_PH_CMS_VTM_NETID Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 189 PARMGEN name KDS_PH_TEMS_VTAM_NETID Description VTAM network identifier for the SOAP server. Related parameters v “KDS_PH_TEMS_COMM_PROTOCOL1” on page 182 v “KDS_TEMS_VTAM_NETID” on page 239 KDS_PPI_RECEIVER This parameter specifies the name of the NetView PPI receiver that is to receive Take Action commands. Required or optional Optional Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Parameter name KGLHC_PPI_RECEIVER Default value CNMPCMDR Permissible values Character string, maximum length 8 Configuration Tool (ICAT) information Panel name Specify Configuration Values Panel ID KDS62PP1 Field NetView PPI receiver Default value CNMPCMDR Permissible values Character string, maximum length 8 Batch parameter name KDS_PPI_RECEIVER PARMGEN name KDS_PPI_RECEIVER Description Name of the NetView PPI receiver that is to receive Take Action commands. This name must match the receiver name specified on the NetView APSERV command. The value must be a 1- through 8-character unique identifier for the receiver program. It can contain alphabetic characters A-Z and 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 190 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference If a value is specified for this parameter and either the specified name is incorrect or the receiver is not active on NetView for z/OS, the command fails. If no value is specified, default (MGCR) command routing is performed. For complete instructions, see the "Configuring NetView authorization of z/OS commands" section of IBM Tivoli Management Services on z/OS: Configuring the Tivoli Enterprise Monitoring Server on z/OS. Related parameters v “GBL_DSN_NETVIEW_CNMLINK” on page 92 v “KDS_PPI_SENDER” KDS_PPI_SENDER This parameter specifies the name of the NetView PPI sender. Required or optional Optional Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Parameter name KGLHC_PPI_SENDER Default value None Permissible values Character string, maximum length 8 Configuration Tool (ICAT) information Panel name Specify Configuration Values Panel ID KDS62PP1 Field TEMS PPI sender Default value None Permissible values Character string, maximum length 8 Batch parameter name KDS_PPI_SENDER PARMGEN name KDS_PPI_SENDER Description Name of the NetView PPI sender. This name is used in logging the command and command response in the NetView log and therefore must not conflict with any NetView for z/OS domain name. This parameter has no default value in the KDSENV member, but the internal default is the value of the “KDS_PPI_RECEIVER” on page 190 parameter. Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 191 For complete instructions, see the "Configuring NetView authorization of z/OS commands" section of IBM Tivoli Management Services on z/OS: Configuring the Tivoli Enterprise Monitoring Server on z/OS. Related parameters v “GBL_DSN_NETVIEW_CNMLINK” on page 92 v “KDS_PPI_RECEIVER” on page 190 KDS_PU This parameter indicates the beginning or end of the SOAP server user access table. Required or optional Optional Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Batch parameter name KDS_PU PARMGEN name KDS_PU Description Indicates the beginning or end of the SOAP server user access table. This parameter is for IBM internal use only. Related parameters v “KDS_PH_TEMS_KSH_SECURE” on page 182 KDS_PU_ROW This parameter indicates the beginning or end of a single user access record in the SOAP server user access table. Required or optional Optional Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Batch parameter name KDS_PU_ROW PARMGEN name KDS_PU_ROW Description Indicates the beginning or end of a single user access record in the SOAP server user access table. This parameter is for IBM internal use only. Related parameters v “KDS_PH_TEMS_KSH_SECURE” on page 182 v “KDS_PU” KDS_PU_TEMS_NAME_NODEID This parameter contains the TEMS name (node ID) of the hub monitoring server. 192 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Required or optional Optional Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Configuration Tool (ICAT) information Panel name Specify TEMS KSHXHUBS User Access List Panel ID KDS62PPI Field Monitored Hub TEMS Default value Value of the “KDS_PH_TEMS_NAME_NODEID” on page 183 parameter Permissible values Character string, maximum length 32 Batch parameter name KDS_PU_CMS_NAME PARMGEN name KDS_PU_TEMS_NAME_NODEID Description TEMS name (node ID) of the hub monitoring server. For best results, accept the default name. Related parameters v “KDS_PH_TEMS_NAME_NODEID” on page 183 KDS_PU_TEMS_RTE This parameter contains the name of the runtime environment where the hub is configured. Required or optional Optional Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Configuration Tool (ICAT) information Panel name Specify TEMS KSHXHUBS User Access List Panel ID KDS62PPI Field Monitored RTE Default value Value of the “KDS_PH_TEMS_RTE” on page 184 parameter Permissible values Character string, maximum length 8 Batch parameter name KDS_PU_CMS_RTE PARMGEN name KDS_PU_TEMS_RTE Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 193 Description Name of the runtime environment where the hub is configured. Accept the default value. Related parameters v “KDS_PH_TEMS_RTE” on page 184 KDS_PU_TEMS_USER_ID This parameter contains the user ID defined to have access to the SOAP server. Required or optional Optional Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Configuration Tool (ICAT) information Panel name Specify TEMS KSHXHUBS User Access List Panel ID KDS62PPI Field User ID Default value None Permissible values Character string, maximum length 8 Batch parameter name KDS_PU_CMS_USER_ID PARMGEN name KDS_PU_TEMS_USER_ID Description User ID defined to have access to the SOAP server. A user ID can have both query and update access. Related parameters v “KDS_PU_TEMS_USER_QUERY” v “KDS_PU_TEMS_USER_UPDATE” on page 195 KDS_PU_TEMS_USER_QUERY This parameter determines query access of a user ID to the SOAP server. Required or optional Optional Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Configuration Tool (ICAT) information Panel name Specify TEMS KSHXHUBS User Access List Panel ID KDS62PPI Field 194 Grant query access? IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Default value Y Permissible values Y or N Batch parameter name KDS_PU_CMS_USER_QUERY PARMGEN name KDS_PU_TEMS_USER_QUERY Description Determines query access of a user ID to the SOAP server. A user ID can have both query and update access. Related parameters v “KDS_PH_TEMS_KSH_SECURE” on page 182 v “KDS_PU_TEMS_USER_UPDATE” v “KDS_PU_TEMS_USER_ID” on page 194 KDS_PU_TEMS_USER_UPDATE This parameter determines update access of a user ID to the SOAP server. Required or optional Optional Location where the parameter value is stored KSHXHUBS member of the rhilev.rte.RKANPARU library for the runtime environment of the hub Configuration Tool (ICAT) information Panel name Specify TEMS KSHXHUBS User Access List Panel ID KDS62PPI Field Grant update access? Default value N Permissible values Y or N Batch parameter name KDS_PU_CMS_USER_UPDATE PARMGEN name KDS_PU_TEMS_USER_UPDATE Description Determines update access of a user ID to the SOAP server. A user ID can have both update and query access. Related parameters v “KDS_PH_TEMS_KSH_SECURE” on page 182 v “KDS_PU_TEMS_USER_QUERY” on page 194 v “KDS_PU_TEMS_USER_ID” on page 194 Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 195 KDS_TEMA_SDA This parameter indicates whether the agent uses the self-description feature. Required or optional Required Location where the parameter value is stored The TEMA_SDA parameter in the RKANPARU data set, member KDSENV. In the Configuration Tool (ICAT) Panel name Specify TEMS Self-Describing Agent Values Panel ID KDS62PP4 Field Agent Self-Description processing in TEMS (TEMA_SDA) Default value Y Permissible values Y, N Batch parameter name KDS_TEMA_SDA PARMGEN name KDS_TEMA_SDA Description This field indicates whether one or more agents will use the self-description feature in the TEMS address space. Related parameters v “GBL_HFS_JAVA_DIRn” on page 103 v “GBL_DSN_SYS1_SBPXEXEC” on page 97 v “RTE_USS_RTEDIR” on page 146 v “KDS_KMS_SDA” on page 167 v “KPP_AGT_TEMA_SDA” on page 33 KDS_TEMS_COMM_ADDRESS_XLAT This parameter points to the file that enables broker partitioning. Required or optional Required Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Parameter name KDC_PARTITIONFILE Default value None Permissible values KDCPART or none Configuration Tool (ICAT) information 196 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Panel name Specify IP.PIPE Communication Protocol Panel ID KDS62PPD Field Address translation Default value N Permissible values Y or N Batch parameter name KDS_CMS_COMM_XLAT PARMGEN name KDS_TEMS_COMM_ADDRESS_XLAT Description Points to the file that enables broker partitioning. For more information about broker partitioning, see "Implementation of firewall support" in IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Related parameters v “KDS_PA” on page 175 v “KDS_TEMS_PARTITION_NAME” on page 213 KDS_TEMS_COMM_PROTOCOLn This parameter specifies the Communication protocol to be supported by the Tivoli Enterprise Monitoring Server, with n corresponding to a number between 1 and 7 to indicate the priority sequence for the communication protocols. Required or optional Required Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Parameter name KDE_TRANSPORT Example: KDE_TRANSPORT=\ HTTP:1920\ IP6.PIPE PORT:1918 USE:N\ IP6.UDP PORT:1918 USE:N\ IP.SPIPE PORT:3660 USE:N\ IP6.SPIPE PORT:3660 USE:N\ IP.PIPE PORT:1918\ IP.UDP PORT:1918\ SNA.PIPE PORT:135 Default value None Permissible values IP.PIPE, IP.UDP, IP6.PIPE, IP6.UDP, IP.SPIPE, IP6.SPIPE, and SNA.PIPE Configuration Tool (ICAT) information Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 197 Panel name Specify Communication Protocols Panel ID KDS62PP3 Field v v v v v v v IP.PIPE IP.UDP IP6.PIPE IP6.UDP IP.SPIPE IP6.SPIPE SNA.PIPE Default value None Permissible values 1-7 Batch parameter name KDS_CMS_COMM_PROn Default value None Permissible values IPPIPE, IP, IP6PIPE, IP6, IPSPIPE, IP6SPIPE, and SNA PARMGEN name KDS_TEMS_COMM_PROTOCOLn Description Communication protocol to be supported by the Tivoli Enterprise Monitoring Server, with n corresponding to a number between 1 and 7 to indicate the priority sequence for the communication protocols. In the Configuration Tool, the seven fields corresponding to the communication protocols that can be supported are shown. You set the priority sequence for the communication protocols by assigning each field a value from 1 to 7, with 1 as the highest priority and 7 as the lowest. Leave blank any fields that represent unsupported communication protocols. The protocols, both supported and unsupported, are listed along with assigned port numbers in the KDSENV member, as shown in the Example section. Unsupported protocols are indicated by USE:N. Supported protocols are listed in priority order. Related parameters None KDS_TEMS_DRA_FLAG The KDS_TEMS_DRA_FLAG parameter controls the generation of the KOBAGENT startup command in xKANCMDU(KDSSTRT1). KOBAGENT is the OMEGAMON enhanced 3270 user interface’s data-retrieval agent (DRA) (if installed in this SMP/E environment). If not installed in this CSI, then KOBAGENT startup is simply ignored at TEMS startup. Required or optional Required if you configure the OMEGAMON enhanced 3270 user interface component. Location where the parameter value is stored If the flag is set to Y, the AT ADD ID=KOB DELAY=00:00:10 CMD=’IRAMAN KOBAGENT START’ startup parameter is added to the KDSSTRT1 member of the rhilev.rtename.RKANCMDU library. 198 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Parameter name and syntax AT ADD ID=KOB DELAY=00:00:10 CMD=’IRAMAN KOBAGENT START’ Default value Y Permissible values Y, N In the Configuration Tool (ICAT) Panel name SPECIFY ADVANCED CONFIGURATION VALUES Panel ID KDS62PP3 Field Enable Data Retrieval Agent Default value Y Permissible values Y, N Batch parameter name KDS_TEMS_DRA_FLAG PARMGEN name KDS_TEMS_DRA_FLAG Description The KDS_TEMS_DRA_FLAG parameter controls the generation of the KOBAGENT startup command in xKANCMDU(KDSSTRT1). KOBAGENT is the OMEGAMON enhanced 3270 user interface’s data retrieval agent (DRA) (if installed in the SMP/E environment). If not installed in this CSI, then KOBAGENT startup is ignored when the TEMS starts up. Related parameters v “RTE_SECURITY_CLASS” on page 125 v “KOB_TOM_STC” on page 259 v “KOB_TOM_VTAM_APPL_LOGON” on page 260 v “KOB_TOM_VTAM_NODE” on page 261 KDS_TEMS_EIF_BUFFER_EVENT_MAXSZE This parameter specifies the maximum size, in KB, of the adapter cache file. Required or optional Required for the hub Tivoli Enterprise Monitoring Server if event forwarding is enabled; does not apply to remote monitoring servers Location where the parameter value is stored KMSOMTEC member of the rhilev.rte.RKANPARU library for the runtime environment of the hub monitoring server Parameter name BufEvtMaxSize Default value 4096 Permissible values 1 - 9999999 Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 199 Configuration Tool (ICAT) information Panel name Specify Values for Event Destination Panel ID KDSPEIF Field Buffer events maximum size Default value 4096 Permissible values 1 - 9999999 Batch parameter name KDS_CMS_EIF_BFR_EVT_MAX PARMGEN name KDS_TEMS_EIF_BUFFER_EVENT_MAXSZE Description Maximum size, in KB, of the adapter cache file. The cache file stores events on disk when they cannot be sent to the event server. Related parameters v “KDS_TEMS_EIF_EVENT_LISTENER” on page 201 v “KDS_TEMS_EIF_FLAG” on page 202 KDS_TEMS_EIF_DISABLE_TEC_EMITTER This parameter specifies whether to deactivate the EIF emitter activities in your policies to prevent workflow policies containing emitter activities that send events to the Tivoli Enterprise Console® from generating duplicate events. Required or optional Optional for the hub Tivoli Enterprise Monitoring Server if event forwarding is enabled and if the IBM Tivoli Enterprise Console is defined as the event server; does not apply to remote monitoring servers Location where the parameter value is stored KMSOMTEC member of the rhilev.rte.RKANPARU library for the runtime environment of the hub monitoring server Parameter name KMS_DISABLE_TEC_EMITTER Default value None Permissible values Y or none Configuration Tool (ICAT) information Panel name Specify Values for Event Destination Panel ID KDSPEIF Field 200 Disable Workflow Policy/Emitter Agent event forwarding IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Default value N Permissible values Y or N Batch parameter name KDS_CMS_EIF_DISABLE_EMT PARMGEN name KDS_TEMS_EIF_DISABLE_TEC_EMITTER Description If you already have workflow policies containing emitter activities that send events to the Tivoli Enterprise Console, turning on EIF event-forwarding causes duplicate events. You can specify Y in this field to deactivate the emitter activities in your policies. Policies give you more control over which events are sent, and you might want to keep some policies active. Moreover, policies that contain the Tivoli Enterprise Console emitter activities generally do little else. If you deactivate these activities, there is no point in running the policies. Therefore, you might want to delete the policies that are no longer required, instead of disabling them. Related parameters v “KDS_TEMS_EIF_EVENT_LISTENER” v “KDS_TEMS_EIF_FLAG” on page 202 KDS_TEMS_EIF_EVENT_LISTENER This parameter specifies the type of event server. Required or optional Required for the hub Tivoli Enterprise Monitoring Server if event forwarding is enabled; does not apply to remote monitoring servers Location where the parameter value is stored KMSOMTEC member of the rhilev.rte.RKANPARU library for the runtime environment of the hub monitoring server Parameter name EventListenerType Default value T Permissible values T or M Configuration Tool (ICAT) information Panel name Specify Values for Event Destination Panel ID KDSPEIF Field Event server type Default value T Permissible values T or M Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 201 Batch parameter name KDS_CMS_EIF_EVT_LISTENER PARMGEN name KDS_TEMS_EIF_EVENT_LISTENER Description Type of event server: T (the default) for Tivoli Enterprise Console, or M for OMNIbus. Related parameters v “KDS_TEMS_EIF_FLAG” v “KDS_TEMS_EIF_DISABLE_TEC_EMITTER” on page 200 KDS_TEMS_EIF_FLAG This parameter determines whether to enable event forwarding from the hub. Required or optional Optional for the hub Tivoli Enterprise Monitoring Server; does not apply to remote monitoring servers Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the hub monitoring server Parameter name KMS_OMTEC_INTEGRATION Default value None Permissible values YES or none Configuration Tool (ICAT) information Panel name Specify Advanced Configuration Values Panel ID KDS62PP3 Field Enable Tivoli Event Integration Facility (EIF) Default value N Permissible values Y or N Batch parameter name KDS_CMS_EIF PARMGEN name KDS_TEMS_EIF_FLAG Description Determines whether to enable event forwarding from the hub. If the value of this parameter is Y, the KMS_OMTEC_INTEGRATION parameter is created in the KDSENV member. For further instructions, see IBM Tivoli Management Services on z/OS: Configuring the Tivoli Enterprise Monitoring Server on z/OS. Related parameters None 202 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference KDS_TEMS_EIF_HOST This parameter contains the fully qualified host name or dotted decimal IPV4 address of the primary event server and of up to seven backup event servers. Required or optional Required for the hub Tivoli Enterprise Monitoring Server if event forwarding is enabled; does not apply to remote monitoring servers Location where the parameter value is stored KMSOMTEC member of the rhilev.rte.RKANPARU library for the runtime environment of the hub monitoring server Parameter name ServerLocation Default value None Permissible values Character string, maximum length 44 Configuration Tool (ICAT) information Panel name Specify Values for Event Destination Panel ID KDSPEIF Field Event server location Default value None Permissible values Character string, maximum length 44 Example: Event server location ==> primary_server,backup_server1,backup_server2 Batch parameter name KDS_CMS_EIF_HOST PARMGEN name KDS_TEMS_EIF_HOST Description Fully qualified host name or dotted decimal IPV4 address of the primary event server and of up to seven backup event servers. If you specify more than one event server, use commas to separate the host names or IP addresses. If an event cannot be sent to the first server on the list, the next one is tried, and so on. Related parameters v “KDS_TEMS_EIF_PORT_NUM” v “KDS_TEMS_EIF_FLAG” on page 202 KDS_TEMS_EIF_PORT_NUM This parameter contains the port number on which the Tivoli Enterprise Console event server or OMNIbus EIF probe listens for events. Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 203 Required or optional Required for the hub Tivoli Enterprise Monitoring Server if event forwarding is enabled; does not apply to remote monitoring servers Location where the parameter value is stored KMSOMTEC member of the rhilev.rte.RKANPARU library for the runtime environment of the hub monitoring server Parameter name ServerPort Default value 5529 Permissible values Character string, maximum length 44 Configuration Tool (ICAT) information Panel name Specify Values for Event Destination Panel ID KDSPEIF Field Event server port Default value 5529 Permissible values Character string, maximum length 44 Example: Event server port ==> primary_port,backup_port1,backup_port2 Batch parameter name KDS_CMS_EIF_PORT PARMGEN name KDS_TEMS_EIF_PORT_NUM Description Port number on which the Tivoli Enterprise Console event server or OMNIbus EIF probe listens for events. If you specify more than one event server, use commas to separate the port numbers. List the port numbers in an order corresponding to the list of event server locations specified in the “KDS_TEMS_EIF_HOST” on page 203 parameter. Related parameters v “KDS_TEMS_EIF_HOST” on page 203 v “KDS_TEMS_EIF_FLAG” on page 202 KDS_TEMS_FLUSH_LSR_BUFR_INT_HR This parameter specifies in hours how often you want to force all deferred VSAM writes to DASD. Required or optional Optional Location where the parameter value is stored Part of the third EVERY command in the KDSSTART member of the rhilev.rte.RKANCMDU data set Example: 204 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference EVERY 00:30:00 FLUSH Default value 00 Permissible values 00 - 24 Configuration Tool (ICAT) information Panel name Specify Advanced Configuration Values Panel ID KDS62PP3 Field Flush VSAM buffers: Hours Default value 0 Permissible values 0 - 24 Batch parameter name KDS_CMS_FLUSH_INT_HR PARMGEN name KDS_TEMS_FLUSH_LSR_BUFR_INT_HR Description Specifies in hours how often you want to force all deferred VSAM writes to DASD. Related parameters v “KDS_TEMS_STORAGE_DETAIL_LOG_FLAG” on page 218 v “KDS_TEMS_FLUSH_LSR_BUFR_INT_MIN” KDS_TEMS_FLUSH_LSR_BUFR_INT_MIN This parameter specifies in minutes how often you want to force all deferred VSAM writes to DASD. Required or optional Optional Location where the parameter value is stored Part of the third EVERY command in the KDSSTART member of the rhilev.rte.RKANCMDU data set Example: EVERY 00:30:00 FLUSH Default value 30 Permissible values 00 - 60 Configuration Tool (ICAT) information Panel name Specify Advanced Configuration Values Panel ID KDS62PP3 Field Flush VSAM buffers: Minutes Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 205 Default value 30 Permissible values 0 - 60 Batch parameter name KDS_CMS_FLUSH_INT_MIN PARMGEN name KDS_TEMS_FLUSH_LSR_BUFR_INT_MIN Description Specifies in minutes how often you want to force all deferred VSAM writes to DASD. Related parameters v “KDS_TEMS_STORAGE_DETAIL_LOG_FLAG” on page 218 v “KDS_TEMS_FLUSH_LSR_BUFR_INT_HR” on page 204 KDS_TEMS_HA_EXCL_LIST This parameter specifies an eligible product or products to be excluded from reporting to the high-availability hub. Required or optional Optional Location where the parameter value is stored The parameter value is not stored, but is used for internal processing. Configuration Tool (ICAT) information Panel name Exclusion Verification for HA Hub TEMS Panel ID KDSPHUBV Batch parameter name KDS_CMS_HA_EXCL_LIST PARMGEN name KDS_TEMS_HA_EXCL_LIST Description Specifies an eligible product or products to be excluded from reporting to the high-availability hub. You can exclude products by specifying the 2-character product code of each product that you want to exclude. Use a single blank space to separate product codes. The list can have a maximum length of 50 characters. To exclude more products than can be accommodated by the KDS_CMS_HA_EXCL_LIST or KDS_TEMS_HA_EXCL_LIST parameter, specify more than one KDS_CMS_HA_EXCL_LISTn or KDS_TEMS_HA_EXCL_LISTn parameter, where n is a number from 1 to 5. Related parameters v “KDS_TEMS_HA_TYPE” KDS_TEMS_HA_TYPE This parameter determines whether to configure the Tivoli Enterprise Monitoring Server as a high-availability hub. Required or optional Required 206 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Location where the parameter value is stored The parameter value is not stored, but is used for internal processing. Configuration Tool (ICAT) information Panel name Specify Configuration Values Panel ID KDS62PP1 Field Hub TEMS type Default value None Permissible values HA or none Batch parameter name KDS_CMS_HA_TYP PARMGEN name KDS_TEMS_HA_TYPE Description Determines whether to configure the Tivoli Enterprise Monitoring Server as a high-availability hub. This configuration requires a sysplex environment with dynamic virtual IP addressing (DVIPA) and shared DASD. A high-availability hub is configured in its own runtime environment, without monitoring agents, and can be configured on the same LPAR with a remote monitoring server. This configuration allows the hub to be relocated to any suitable LPAR in the sysplex with no changes, and with minimal disruption to the components connecting to the hub. Related parameters v “KDS_HUB_TEMS_HA_TYPE” on page 165 v “KDS_TEMS_HA_EXCL_LIST” on page 206 v “KDS_TEMS_VIRTUAL_IP_ADDRESS” on page 233 v “KDS_TEMS_TCP_HOST” on page 222 KDS_TEMS_HTTP_PORT_NUM This parameter contains the HTTP port number for communications with the SOAP server. Required or optional Required for a hub Tivoli Enterprise Monitoring Server Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the hub monitoring server Parameter name KDE_TRANSPORT (HTTP option) Example: KDE_TRANSPORT=\ HTTP:1920\ IP.PIPE PORT:1918\ Default value 1920 Permissible values 1 - 65535 Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 207 Configuration Tool (ICAT) information Panel name Specify IP.PIPE Communication Protocol Panel ID KDS62PPD Field HTTP server port number Default value 1920 Permissible values 1 - 65535 Batch parameter name KDS_CMS_HTTP_PORT PARMGEN name KDS_TEMS_HTTP_PORT_NUM Description HTTP port number for communications with the SOAP server. If the specified port is in use when the hub monitoring server is started, another port is assigned. For detailed information about assigning port numbers, see "Port number assignments" in IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Related parameters v “KDS_TEMS_SOAP_SERVER_FLAG” on page 215 KDS_TEMS_ICU_LANGUAGE_LOCALE This parameter contains the language and region for the z/OS system. Required or optional Required Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Parameter name LANG Default value en_US.ibm-037 Permissible values lang.ibm-nnn Configuration Tool (ICAT) information Panel name Specify Advanced Configuration Values Panel ID KDSnnPP3 Field Language locale Default value 1 (English - United States) Permissible values Any language locale or codepage listed in Table 3 on page 209. 208 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Table 3. Language locales and corresponding codepages Language locale Codepage National language and region 1a or 1A en_US.ibm-1047 English - United States (USS) 1 en_US.ibm-037 English - United States 2 en_UK.ibm-285 English - United Kingdom 3 de_DE.ibm-273 German - Germany 4 de_CH.ibm-500 German - Switzerland 5 fr_BE.ibm-500 French - Belgium 6 fr_FR.ibm-297 French - France 7 fr_CH.ibm-500 French - Switzerland 8 es_ES.ibm-284 Spanish - Spain 9 it_IT.ibm-280 Italian - Italy 10 pt_PT.ibm-037 Portuguese - Portugal 11 pt_BR.ibm-037 Portuguese - Brazil 12 no_NO.ibm-277 Norwegian - Norway) 13 sv_SE.ibm-278 Swedish - Sweden 14 da_DK.ibm-277 Danish - Denmark 15 fi_FI.ibm-278 Finnish - Finland 16 ja_JP.ibm-290 Japanese - Japan 17 fr_CA.ibm-500 French - Canada 18 zh_TW.ibm-937 Traditional Chinese - Taiwan 19 zh_CN.ibm-935 Simplified Chinese - China 20 sq_AL.ibm-500 Albanian - Albania 21 bg_BG.ibm-500 Bulgarian - Bulgaria 22 cs_CZ.ibm-870 Czech - Slovenia 23 nl_BE.ibm-500 Dutch - Belgium 24 nl_NL.ibm-037 Dutch - Netherlands 25 el_GR.ibm-87 Greek - Greece 26 iw_IL.ibm-424 Hebrew - Israel 27 ko_KR.ibm-933 Korean - Korea 28 lt_LT.ibm-1112 Lithuanian - Lithuania 29 mk_MK.ibm-1025 Macedonian - Macedonia 30 ro_RO.ibm-870 Romanian - Romania 31 ru_RU.ibm-1025 Russian - Russia 32 sr_SP.ibm-1025 Serbian - Serbia 33 sr_SP.ibm-870 Slovak - Slovakia 34 sk_SK.ibm-870 Slovenian - Slovenia 35 th_TH.ibm-838 Thai - Thailand 36 tr_TR.ibm-1026 Turkish - Turkey Batch parameter name KDS_CMS_ICU_LANG Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 209 PARMGEN name KDS_TEMS_ICU_LANGUAGE_LOCALE Description Language and region for the z/OS system. From the Configuration Tool panel, press F1 (Help) and select Language locale for a list of the possible values. If you accept the default value of 1 (English - United States), the Configuration Tool generates this environment variable in KDSENV: LANG=en_US.ibm-037 If the z/OS UNIX System Services (USS) codepage (en_US.ibm-1047) is required, you can specify either en_US.ibm-1047 or 1A in the Language locale field on the Configuration Tool panel. In batch mode, you can specify either of these values: KDS_CMS_ICU_LANG KDS_CMS_ICU_LANG en_US.ibm-1047 1A For PARMGEN configuration, you can specify either of these values for the USS codepage: KDS_TEMS_ICU_LANGUAGE_LOCALE KDS_TEMS_ICU_LANGUAGE_LOCALE en_US.ibm-1047 1A The USS codepage (en_US.ibm-1047) is required for agent autonomy and for private situation XML files. Related parameters None KDS_TEMS_KDC_DEBUG This parameter determines the trace option. Required or optional Optional Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Parameter name KDC_DEBUG Default value N Permissible values N, Y, D, M, or A Configuration Tool (ICAT) information Panel name Specify Advanced Configuration Values Panel ID KDS62PP3 Field Enable communications trace Default value N Permissible values N, Y, D, M, or A 210 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Batch parameter name KDS_CMS_KDC_DEBUG PARMGEN name KDS_TEMS_KDC_DEBUG Description Determines the trace option. The default setting of N instructs the data communications layer to summarize communications problems, and is intended for stable applications in production. The default setting generates standard RAS1 trace data in the RKLVLOG, in addition to the summary information diagnosing possible timeout conditions. The following settings report on data communications problems: N Minimal tracing (the default) Y Full-packet tracing Note: The Y setting causes a great many records to be written to the log files. Use this setting only for testing or problem diagnosis. D Y, plus state and flow tracing M D, plus input and output help tracing A M, plus all-format tracing Note: Do not use the A setting unless directed by IBM Software Support personnel. Related parameters None KDS_TEMS_KGL_WTO This parameter determines whether a SYSLOG message is written to the console to indicate that the monitoring server has completed initialization. Required or optional Required Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Parameter name KGL_WTO Default value YES Permissible values YES or none Configuration Tool (ICAT) information Panel name Specify Advanced Configuration Values Panel ID KDS62PP3 Field Enable startup console messages Default value Y Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 211 Permissible values Y or N Batch parameter name KDS_CMS_KGL_WTO PARMGEN name KDS_TEMS_KGL_WTO Description Determines whether a SYSLOG message is written to the console to indicate that the monitoring server has completed initialization. You can use this message as an UP status message in your automation package (for example, IBM Tivoli System Automation for z/OS). See the documentation for your automation package for instructions on capturing the monitoring server automation message IDs (KO4SRV032 and KDSMA001). Related parameters None KDS_TEMS_KLX_TCP_TOLERATERECYCLE This parameter determines whether the monitoring server address space reconnects to its TCP/IP stack without being recycled after the stack is recycled. Required or optional Required Location where the parameter value is stored KLXINTCP member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Parameter name TCP/IP_USERID (TOLERATERECYCLE option) Example: TCP/IP_USERID=’*’ TOLERATERECYCLE Default value None Permissible values TOLERATERECYCLE or None Configuration Tool (ICAT) information Panel name Specify Advanced Configuration Values Panel ID KDS62PP3 Field Reconnect after TCP/IP recycle Default value N Permissible values Y or N Batch parameter name KDS_CMS_KLX_TCP_RECYCLE PARMGEN name KDS_TEMS_KLX_TCP_TOLERATERECYCLE 212 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Description Determines whether the monitoring server address space reconnects to its TCP/IP stack without being recycled after the stack is recycled. If this parameter is set to N (the default), then if the TCP/IP stack used by the monitoring server is recycled, the monitoring server address space must also be recycled to re-establish TCP/IP connectivity. If this parameter is set to Y, the TOLERATERECYCLE option is added to the TCP/IP_USERID parameter in KLXINTCP. Related parameters None KDS_TEMS_PARTITION_NAME This parameter contains the partition name (label) that identifies the location of the monitoring server relative to the firewall or firewalls used for address translation. Required or optional Required if you specified Y for the “KDS_TEMS_COMM_ADDRESS_XLAT” on page 196 parameter Location where the parameter value is stored KDCPART member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Configuration Tool (ICAT) information Panel name v Specify IP.PIPE Communication Protocol v Specify IP.PIPE Partition References Panel ID v KDS62PPD (for Communication Protocol panel) v KDS62PPE (for Partition References panel) Field Partition name Default value None Permissible values Character string, maximum length 32 Batch parameter name KDS_CMS_PART_NAME PARMGEN name KDS_TEMS_PARTITION_NAME Description Partition name (label) that identifies the location of the monitoring server relative to the firewall or firewalls used for address translation. The partition name that you supply is added to the partition table, which contains labels and associated socket addresses provided by the firewall administrator. The label is used outside the firewall to establish monitoring server connections. The well-known port for the hub monitoring server must be authorized by the firewall administrator. For the IP*.*PIPE protocols, no additional ports require authorization. Related parameters v “KDS_TEMS_COMM_ADDRESS_XLAT” on page 196 v “KDS_PA” on page 175 v “KDS_PA_PARTITION_NAME” on page 177 Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 213 KDS_TEMS_SECURITY_KAES256_ENCKEY This parameter contains unique 32-byte password encryption key. Required or optional Required if ICSF is installed and configured on the z/OS system Location where the parameter value is stored KAES256 member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server. The stored value is encrypted. Default value IBMTivoliMonitoringEncryptionKey Permissible values Character string, maximum length 32, no ampersand () character Configuration Tool (ICAT) information Panel name Specify Configuration Values Panel ID KDS62PP1 Field TMS encryption key Default value IBMTivoliMonitoringEncryptionKey Permissible values Character string, maximum length 32 Batch parameter name KDS_CMS_SEC_ENC_KEY PARMGEN name KDS_TEMS_SECURITY_KAES256_ENCKEY Description Unique 32-byte password encryption key. The value is case-sensitive. You must use the same key during the installation of any components that communicate with the monitoring server. For further information, see the "Configuring security on a monitoring server on z/OS" chapter of IBM Tivoli Management Services on z/OS: Configuring the Tivoli Enterprise Monitoring Server on z/OS. Related parameters v “GBL_DSN_CSF_SCSFMOD0” on page 87 KDS_TEMS_SECURITY_KDS_VALIDATE This parameter determines whether the hub monitoring server validates the user IDs and passwords of users signing on to the Tivoli Enterprise Portal. Required or optional Required for a hub Tivoli Enterprise Monitoring Server. Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the hub monitoring server Parameter name KDS_VALIDATE Default value NO 214 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Permissible values YES or NO Configuration Tool (ICAT) information Panel name Specify Configuration Values Panel ID KDS62PP1 Field Validate security Default value N Permissible values Y or N Batch parameter name KDS_CMS_SEC_VALIDATE PARMGEN name KDS_TEMS_SECURITY_KDS_VALIDATE Description Determines whether the hub monitoring server validates the user IDs and passwords of users signing on to the Tivoli Enterprise Portal. If this parameter is set to Y, validation of users is handled by the security system specified for the runtime environment. Related parameters v “RTE_SECURITY_USER_LOGON” on page 127 KDS_TEMS_SOAP_SERVER_FLAG This parameter determines whether to enable the Web Services Simple Object Access Protocol (SOAP) server. Required or optional Required for a hub Tivoli Enterprise Monitoring Server Location where the parameter value is stored The parameter value is not stored, but is used for internal processing. Configuration Tool (ICAT) information Panel name Specify Advanced Configuration Values Panel ID KDS62PP3 Field Enable Web Services SOAP Server Default value Y Permissible values Y or N Batch parameter name KDS_CMS_CTSOAP PARMGEN name KDS_TEMS_SOAP_SERVER_FLAG Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 215 Description Determines whether to enable the Web Services Simple Object Access Protocol (SOAP) server. The SOAP server is an application server plug-in that receives and sends XML data, and provides XML SOAP interfaces into the Tivoli Management Services components and the monitoring agents. This feature requires a TCP communication protocol. For more information about the SOAP server, see the "Planning for the SOAP server on z/OS" section of IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. For SOAP server configuration instructions, see IBM Tivoli Management Services on z/OS: Configuring the Tivoli Enterprise Monitoring Server on z/OS. Related parameters None KDS_TEMS_STC This parameter contains the unique name of the started task JCL procedure for the monitoring server. Required or optional Required Location where the parameter value is stored Value becomes the name of the Tivoli Enterprise Monitoring Server started task procedure member in the rhilev.rte.RKANSAMU library Configuration Tool (ICAT) information Panel name Specify Configuration Values Panel ID KDS62PP1 Field STC prefix Default value CANSDSST Permissible values Character string, maximum length 8 Batch parameter name KDS_CMS_STC PARMGEN name KDS_TEMS_STC Description Unique name of the started task JCL procedure for the monitoring server. Make a note of the name, because you will to copy this started task procedure to your system procedure library. The default started task name for a monitoring server is ccccDSST, where cccc is the 4-character STC prefix specified when you defined the runtime environment. Related parameters v “RTE_STC_PREFIX” on page 134 KDS_TEMS_STORAGE_DETAIL_INT_HR This parameter specifies in hours how often you want storage allocation detail to be logged. Required or optional Required if the value of the “KDS_TEMS_STORAGE_DETAIL_LOG_FLAG” on page 218 parameter is Y 216 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Location where the parameter value is stored Part of the second EVERY command in the KDSSTART member of the rhilev.rte.RKANCMDU library Example: EVERY 00:60:00 STORAGE D Default value 00 Permissible values 00 - 24 Configuration Tool (ICAT) information Panel name Specify Advanced Configuration Values Panel ID KDS62PP3 Field Storage detail logging: Hours Default value 0 Permissible values 0 - 24 Batch parameter name KDS_CMS_STOR_DTL_INT_HR PARMGEN name KDS_TEMS_STORAGE_DETAIL_INT_HR Description Specifies in hours how often you want storage allocation detail to be logged. Related parameters v “KDS_TEMS_STORAGE_DETAIL_INT_MIN” v “KDS_TEMS_STORAGE_DETAIL_LOG_FLAG” on page 218 KDS_TEMS_STORAGE_DETAIL_INT_MIN This parameter specifies in minutes how often you want storage allocation detail to be logged. Required or optional Required if the value of the “KDS_TEMS_STORAGE_DETAIL_LOG_FLAG” on page 218 parameter is Y Location where the parameter value is stored Part of the second EVERY command in the KDSSTART member of the rhilev.rte.RKANCMDU library Example: EVERY 00:60:00 STORAGE D Default value 60 Permissible values 00 - 60 Configuration Tool (ICAT) information Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 217 Panel name Specify Advanced Configuration Values Panel ID KDS62PP3 Field Storage detail logging: Minutes Default value 60 Permissible values 0 - 60 Batch parameter name KDS_CMS_STOR_DTL_INT_MIN PARMGEN name KDS_TEMS_STORAGE_DETAIL_INT_MIN Description Specifies in minutes how often you want storage allocation detail to be logged. Related parameters v “KDS_TEMS_STORAGE_DETAIL_INT_HR” on page 216 v “KDS_TEMS_STORAGE_DETAIL_LOG_FLAG” KDS_TEMS_STORAGE_DETAIL_LOG_FLAG This parameter determines whether to enable storage allocation detail logging. Required or optional Optional Location where the parameter value is stored Generates the second EVERY command in the KDSSTART member of the rhilev.rte.RKANCMDU library Configuration Tool (ICAT) information Panel name Specify Advanced Configuration Values Panel ID KDS62PP3 Field Enable storage detail logging Default value Y Permissible values Y or N Batch parameter name KDS_CMS_STOR_DTL_LOG PARMGEN name KDS_TEMS_STORAGE_DETAIL_LOG_FLAG Description Determines whether to enable storage allocation detail logging. You can use the storage detail command output to analyze storage allocated by the monitoring server address space. 218 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference To disable storage detail logging, set this parameter to N. The second EVERY command is then written as a comment in rhilev.rte.RKANCMDU(KDSSTART). If you disable storage logging and then want to activate it after the monitoring server is configured and running, you can issue the following modify command to the monitoring server started task: /F started_task,EVERY hh:mm:ss STORAGE D Issuing this modify command activates storage detail logging without a requirement to recycle the monitoring server. Related parameters v “KDS_TEMS_STORAGE_DETAIL_INT_HR” on page 216 v “KDS_TEMS_STORAGE_DETAIL_INT_MIN” on page 217 KDS_TEMS_STORAGE_LIMIT_EXTEND This parameter contains the maximum extended (above-the-line) storage request size, as a power of 2. Required or optional Required Location where the parameter value is stored KDSSYSIN member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name and syntax LIMIT(n,X) Default value v Default for the Configuration Tool and PARMGEN: LIMIT(23,X) v Default in TMS:Engine: LIMIT(16,X) Permissible values No higher than 25 (see Description) In the Configuration Tool (ICAT) Panel name Specify Advanced Configuration Values Panel ID KDS62PP3 Field Maximum storage request size (extended) Default value 23 Permissible values No higher than 25 (see Description) Batch parameter name KDS_CMS_EXT_LIM PARMGEN name KDS_TEMS_STORAGE_LIMIT_EXTEND Description Maximum extended (above-the-line) storage request size, as a power of 2. The value can be no higher than 25 (32768 KB). Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 219 This value is used in building storage access tables to speed memory allocation. If a process in TMS:Engine attempts to allocate a block of storage larger than the value set, program interruption U0100 or U0200 results. Too small a value causes components to fail. Too large a value wastes storage and increases processing overhead. You might to specify a large value if any monitoring agent reporting to the monitoring server builds large VTAM request/response units (RUs) and data streams. Related parameters v “KDS_TEMS_STORAGE_LIMIT_PRIMARY” v “KDS_TEMS_STORAGE_MINIMUM_EXTEND” on page 221 KDS_TEMS_STORAGE_LIMIT_PRIMARY This parameter contains the maximum primary (below-the-line) storage request size, as a power of 2. Required or optional Required Location where the parameter value is stored KDSSYSIN member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name and syntax LIMIT(n,P) Default value LIMIT(16,P) Permissible values No higher than 25 (see Description) In the Configuration Tool (ICAT) Panel name Specify Advanced Configuration Values Panel ID KDS62PP3 Field Maximum storage request size (primary) Default value 16 Permissible values No higher than 25 (see Description) Batch parameter name KDS_CMS_PRI_LIM PARMGEN name KDS_TEMS_STORAGE_LIMIT_PRIMARY Description Maximum primary (below-the-line) storage request size, as a power of 2. The value can be no higher than 25 (32768 KB). The default maximum for primary storage is 16 (64 KB). However, some monitoring agents configured to run in the monitoring server address space require a maximum primary storage request size of 20 (1 MB). This value is used in building storage access tables to speed memory allocation. If a process in TMS:Engine attempts to allocate a block of storage larger than the value set, program interruption U0100 or U0200 results. Too small a value causes components to fail. Too large a value wastes 220 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference storage and increases processing overhead. You might to specify a large value if any monitoring agent reporting to the monitoring server builds large VTAM request/response units (RUs) and data streams. Related parameters v “KDS_TEMS_STORAGE_LIMIT_EXTEND” on page 219 v “KDS_TEMS_STORAGE_MINIMUM_EXTEND” KDS_TEMS_STORAGE_MINIMUM_EXTEND This parameter specifies the minimum number of kilobytes of extended (above-the-line) storage to be made available to the monitoring agents and other components that are communicating with the monitoring server. Required or optional Required Location where the parameter value is stored KDSSYSIN member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name and syntax MINIMUM(n,X) Default value MINIMUM(768000,X) Permissible values 1 - 9999999 In the Configuration Tool (ICAT) Panel name Specify Advanced Configuration Values Panel ID KDS62PP3 Field Minimum extended storage Default value 768000 Permissible values A non-zero value Batch parameter name KDS_CMS_STOR_MIN_EXT PARMGEN name KDS_TEMS_STORAGE_MINIMUM_EXTEND Description Minimum number of kilobytes of extended (above-the-line) storage to be made available to the monitoring agents and other components that are communicating with the monitoring server. The default value is 768000 KB. If you do not have many IBM components reporting to the monitoring server and you want to conserve storage, you can lower the value. Related parameters v “KDS_TEMS_STORAGE_LIMIT_EXTEND” on page 219 v “KDS_TEMS_STORAGE_LIMIT_PRIMARY” on page 220 Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 221 KDS_TEMS_TCP_HOST This parameter specifies the TCP/IP host name or dotted decimal IPV4 address of the z/OS system where the monitoring server is installed. Required or optional Required Location where the parameter value is stored KDCSSITE and KDSENV members of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Default value Value set for the “RTE_TCP_HOST” on page 139 parameter for the runtime environment Permissible values Character string, maximum length 32 Configuration Tool (ICAT) information Panel name Specify IP.PIPE Communication Protocol Panel ID KDS62PPD Field TCP hostname Default value Value set for the “RTE_TCP_HOST” on page 139 parameter for the runtime environment Permissible values Character string, maximum length 32 Batch parameter name KDS_CMS_TCP_HOST PARMGEN name KDS_TEMS_TCP_HOST Description TCP/IP host name or dotted decimal IPV4 address of the z/OS system where the monitoring server is installed. To obtain the host name or IP address, enter TSO HOMETEST at the command line. If the z/OS domain name resolver configuration specifies a search path that includes the target domain suffix, specify only the first qualifier of the host name. (Example: sys is the first qualifier of the fully qualified host name sys.ibm.com.) Otherwise, specify the fully qualified host name. For a high-availability hub, the host name is the application-instance-specific (private) dynamic virtual IP address you have defined to the Domain Name Server (DNS). Related parameters v “RTE_TCP_HOST” on page 139 v “KDS_PH_TEMS_TCP_HOST” on page 185 v “KDS_HUB_TCP_HOST” on page 159 v “KDS_TEMS_TCP_KDEB_INTERFACELIST” KDS_TEMS_TCP_KDEB_INTERFACELIST This parameter specifies one or more network interfaces for the monitoring server to use. 222 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Required or optional Optional Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Parameter name KDEB_INTERFACELIST Default value None Permissible values Character string, maximum length 44 Configuration Tool (ICAT) information Panel name v Specify IP.PIPE Communication Protocol v Specify IP.UDP Communication Protocol Panel ID v KDS62PPD (for IP.PIPE) v KDS62PPC (for IP.UDP) Field Network interface list Default value None Permissible values Character string, maximum length 44 Batch parameter name KDS_CMS_TCP_KDEBLST PARMGEN name KDS_TEMS_TCP_KDEB_INTERFACELIST Description One or more network interfaces for the monitoring server to use. If the z/OS image has more than one TCP/IP interface or network adapter, you can use this parameter to direct the monitoring server to connect to a specific TCP/IP local interface. To set a network interface list, supply one of the following values: v The host name or IP address of the preferred interface. v A list of host names or IP addresses, in descending order of preference. Use a blank space to separate the entries. v An asterisk (*) to prefer the interface associated with the default host name for the z/OS image. To display this value, enter TSO HOMETEST at the command line. v An exclamation point followed by an asterisk (!*) to use only the interface associated with the default host name for the z/OS image. v An exclamation point followed by a host name or IP address (!hostname) to use only the interface associated with hostname. Note: – If you set the value of this parameter to !* or !hostname, you must specify the same value for every component and product configured in all runtime environments on the same z/OS image. Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 223 – In the default character set (LANG=en_US.ibm-037), the code for an exclamation point is x’5A’. If you are using a character set other than the default, a different character might map to that code. To require a specific network interface, use the character that maps to x’5A’ in your character set. For a high-availability hub, specify the value of this parameter as !dvipa_hostname, where dvipa_hostname is the private DVIPA name set for the “KDS_TEMS_TCP_HOST” on page 222 parameter. Related parameters v “KDS_TEMS_TCP_HOST” on page 222 KDS_TEMS_TCP_PIPE_PORT_NUM This parameter specifies the well-known port for the monitoring server for the IP.PIPE communication protocol (the TCP/IP protocol that supports IPV4). Tivoli Management Services reserves a default well-known port for the first process started on a system (normally, the monitoring server). Required or optional Required if you specified IP.PIPE as a communication protocol for the Tivoli Enterprise Monitoring Server Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name KDE_TRANSPORT (IP.PIPE PORT option) Example: KDE_TRANSPORT=\ HTTP:1920\ IP.PIPE PORT:1918 Default value 1918 or the value set for the “RTE_TCP_PORT_NUM” on page 140 parameter Permissible values 1 - 65535 Configuration Tool (ICAT) information Panel name Specify IP.PIPE Communication Protocol Panel ID KDS62PPD Field Port number (IP.PIPE) Default value 1918 or the value set for the “RTE_TCP_PORT_NUM” on page 140 parameter Permissible values 1 - 65535 Batch parameter name KDS_CMS_TCP_PIPE_PORT PARMGEN name KDS_TEMS_TCP_PIPE_PORT_NUM Description Well-known port for the monitoring server for the IP.PIPE communication protocol (the TCP/IP 224 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference protocol that supports IPV4). Tivoli Management Services reserves a default well-known port for the first process started on a system (normally, the monitoring server). For monitoring agents and other components, an algorithm based on the port number assigned to the monitoring server calculates the listening port to reserve. A port number cannot be assigned to a component if it is already reserved for another component or application. The default listening port number for the monitoring server for IP.PIPE is 1918 or the value set for the “RTE_TCP_PORT_NUM” on page 140 parameter. You might find it necessary to change the setting under some conditions; for example, when the port assigned to a component by the algorithm is already reserved by another application or component. For a remote Tivoli Enterprise Monitoring Server, the port number must be the same as that of the hub. For detailed information about assigning port numbers, see "Port number assignments" in IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Related parameters v “RTE_TCP_PORT_NUM” on page 140 KDS_TEMS_TCP_PIPE6_PORT_NUM This parameter specifies the well-known port for the monitoring server for the IP6.PIPE communication protocol (the TCP/IP protocol that supports IPV6). Required or optional Required if you specified IP6.PIPE as a communication protocol for the Tivoli Enterprise Monitoring Server Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Parameter name KDE_TRANSPORT (IP6.PIPE PORT option) Example: KDE_TRANSPORT=\ HTTP:1920\ IP6.PIPE PORT:1918 Default value 1918 or the value set for the “RTE_TCP_PORT_NUM” on page 140 parameter Permissible values 1 - 65535 Configuration Tool (ICAT) information Panel name Specify IP.PIPE Communication Protocol Panel ID KDS62PPD Field Port number (IP.PIPE for IPV6) Default value 1918 or the value set for the “RTE_TCP_PORT_NUM” on page 140 parameter Permissible values 1 - 65535 Batch parameter name KDS_CMS_TCP_PIPE6_PORT Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 225 PARMGEN name KDS_TEMS_TCP_PIPE6_PORT_NUM Description Well-known port for the monitoring server for the IP6.PIPE communication protocol (the TCP/IP protocol that supports IPV6). This protocol is available for a monitoring server on a z/OS system at release level V1R7 or higher, with IPV6 installed and operational. Tivoli Management Services reserves a default well-known port for the first process started on a system (normally, the monitoring server). For monitoring agents and other components, an algorithm based on the port number assigned to the monitoring server calculates the listening port to reserve. A port number cannot be assigned to a component if it is already reserved for another component or application. The default listening port number for the monitoring server for IP6.PIPE is 1918 or the value set for the “RTE_TCP_PORT_NUM” on page 140 parameter. You might find it necessary to change the setting under some conditions; for example, when the port assigned to a component by the algorithm is already reserved by another application or component. For a remote Tivoli Enterprise Monitoring Server, the port number must be the same as that of the hub. For detailed information about assigning port numbers, see "Port number assignments" in IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Related parameters v “RTE_TCP_PORT_NUM” on page 140 KDS_TEMS_TCP_PIPE6S_PORT_NUM This parameter specifies the well-known port for the monitoring server for the IP6S.PIPE communication protocol (the TCP/IP protocol that supports Secure Sockets Layer communications over IPV6). Required or optional Required if you specified IP6.SPIPE as a communication protocol for the Tivoli Enterprise Monitoring Server Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name KDE_TRANSPORT (IP6.SPIPE PORT option) Example: KDE_TRANSPORT=\ HTTP:1920\ IP6.SPIPE PORT:3660 Default value 3660 or the value set for the “RTE_TCP_PORT_NUM” on page 140 parameter Permissible values 1 - 65535 Configuration Tool (ICAT) information Panel name Specify IP.PIPE Communication Protocol Panel ID KDS62PPD Field 226 Port number (Secure IP.PIPE for IPV6) IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Default value 3660 or the value set for the “RTE_TCP_PORT_NUM” on page 140 parameter Permissible values 1 - 65535 Batch parameter name KDS_CMS_TCP_PIPE6S_PORT PARMGEN name KDS_TEMS_TCP_PIPE6S_PORT_NUM Description Well-known port for the monitoring server for the IP6S.PIPE communication protocol (the TCP/IP protocol that supports Secure Sockets Layer communications over IPV6). This protocol is available for a monitoring server on a z/OS system at release level V1R7 or higher, with IPV6 installed and operational. Tivoli Management Services reserves a default well-known port for the first process started on a system (normally, the monitoring server). For monitoring agents and other components, an algorithm based on the port number assigned to the monitoring server calculates the listening port to reserve. A port number cannot be assigned to a component if it is already reserved for another component or application. The default listening port number for the monitoring server for IP6.SPIPE is 3660 or the value set for the “RTE_TCP_PORT_NUM” on page 140 parameter. You might find it necessary to change the setting under some conditions; for example, when the port assigned to a component by the algorithm is already reserved by another application or component. For a remote Tivoli Enterprise Monitoring Server, the port number must be the same as that of the hub. For detailed information about assigning port numbers, see "Port number assignments" in IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Related parameters v “RTE_TCP_PORT_NUM” on page 140 KDS_TEMS_TCP_PIPES_PORT_NUM This parameter specifies the well-known port for the monitoring server for the IP.SPIPE communication protocol (the TCP/IP protocol that supports Secure Sockets Layer communications over IPV4). Required or optional Required if you specified IP.SPIPE as a communication protocol for the Tivoli Enterprise Monitoring Server Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name KDE_TRANSPORT (IP.SPIPE PORT option) Example: KDE_TRANSPORT=\ HTTP:1920\ IP.SPIPE PORT:3660\ Default value 3660 or the value set for the “RTE_TCP_PORT_NUM” on page 140 parameter Permissible values 1 - 65535 Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 227 Configuration Tool (ICAT) information Panel name Specify IP.PIPE Communication Protocol Panel ID KDS62PPD Field Port number (Secure IP.PIPE) Default value 3660 or the value set for the “RTE_TCP_PORT_NUM” on page 140 parameter Permissible values 1 - 65535 Batch parameter name KDS_CMS_TCP_PIPES_PORT PARMGEN name KDS_TEMS_TCP_PIPES_PORT_NUM Description Well-known port for the monitoring server for the IP.SPIPE communication protocol (the TCP/IP protocol that supports Secure Sockets Layer communications over IPV4). This protocol is available for a monitoring server on a z/OS system at release level V1R7 or higher. Tivoli Management Services reserves a default well-known port for the first process started on a system (normally, the monitoring server). For monitoring agents and other components, an algorithm based on the port number assigned to the monitoring server calculates the listening port to reserve. A port number cannot be assigned to a component if it is already reserved for another component or application. The default listening port number for the monitoring server for IP.SPIPE is 3660 or the value set for the “RTE_TCP_PORT_NUM” on page 140 parameter. You might find it necessary to change the setting under some conditions; for example, when the port assigned to a component by the algorithm is already reserved by another application or component. For a remote Tivoli Enterprise Monitoring Server, the port number must be the same as that of the hub. For detailed information about assigning port numbers, see "Port number assignments" in IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Related parameters v “RTE_TCP_PORT_NUM” on page 140 KDS_TEMS_TCP_STC This parameter identifies the TCP/IP stack to be used. If the LPAR contains a single TCP/IP stack, accept the default value of an asterisk (*), which uses the first TCP/IP stack that was started. Required or optional Required Location where the parameter value is stored KLXINTCP member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Parameter name TCP/IP_USERID Default value * 228 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Permissible values Character string, maximum length 8 Configuration Tool (ICAT) information Panel name v Specify IP.PIPE Communication Protocol v Specify IP.UDP Communication Protocol Panel ID v KDS62PPD (for IP.PIPE) v KDS62PPC (for IP.UDP) Field Started task Default value * Permissible values Character string, maximum length 8 Batch parameter name KDS_CMS_TCP_STC PARMGEN name KDS_TEMS_TCP_STC Description Identifies the TCP/IP stack to be used. If the LPAR contains a single TCP/IP stack, accept the default value of an asterisk (*), which uses the first TCP/IP stack that was started. If the LPAR contains more than one TCP/IP stack, specify the started task name of the TCP/IP stack you want to use. Alternatively, you can specify the number sign (#), which is translated to a blank and allows the TCP/IP environment to choose the stack to use, either through TCP/IP definitions or through the use of the SYSTCPD DD statement. Whichever method is used to select a TCP/IP stack in a multi-stack environment, the Tivoli Management Services components continue to use that stack, even if a different stack becomes the primary stack. Therefore, in a multi-stack environment, it is best to specify the started task name of the TCP/IP stack to be used, rather than specifying a wildcard or a blank. Related parameters v “RTE_TCP_STC” on page 140 KDS_TEMS_TCP_UDP_PORT_NUM This parameter specifies the well-known port for the monitoring server for the IP.UDP communication protocol (the TCP/IP protocol that uses the packet-based, connectionless User Datagram Protocol under IPV4). Required or optional Required if you specified IP.UDP as a communication protocol for the Tivoli Enterprise Monitoring Server Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Parameter name KDE_TRANSPORT (IP.UDP PORT option) Example: Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 229 KDE_TRANSPORT=\ HTTP:1920\ IP.UDP PORT:1918\ Default value 1918 or the value set for the “RTE_TCP_PORT_NUM” on page 140 parameter Permissible values 1 - 65535 Configuration Tool (ICAT) information Panel name Specify IP.UDP Communication Protocol Panel ID KDS62PPC Field Port number (IP.UDP) Default value 1918 or the value set for the “RTE_TCP_PORT_NUM” on page 140 parameter Permissible values 1 - 65535 Batch parameter name KDS_CMS_TCP_UDP_PORT PARMGEN name KDS_TEMS_TCP_UDP_PORT_NUM Description Well-known port for the monitoring server for the IP.UDP communication protocol (the TCP/IP protocol that uses the packet-based, connectionless User Datagram Protocol under IPV4). Tivoli Management Services reserves a default well-known port for the first process started on a system (normally, the monitoring server). For monitoring agents and other components, an algorithm based on the port number assigned to the monitoring server calculates the listening port to reserve. A port number cannot be assigned to a component if it is already reserved for another component or application. The default listening port number for the monitoring server for IP.UDP is 1918 or the value set for the “RTE_TCP_PORT_NUM” on page 140 parameter. You might find it necessary to change the setting under some conditions; for example, when the port assigned to a component by the algorithm is already reserved by another application or component. For a remote Tivoli Enterprise Monitoring Server, the port number must be the same as that of the hub. For detailed information about assigning port numbers, see "Port number assignments" in IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Related parameters v “RTE_TCP_PORT_NUM” on page 140 KDS_TEMS_TCP_UDP6_PORT_NUM This parameter specifies the well-known port for the monitoring server for the IP6.UDP communication protocol (the packet-based, connectionless User Datagram Protocol that supports IPV6). Required or optional Required if you specified IP6.UDP as a communication protocol for the Tivoli Enterprise Monitoring Server 230 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name KDE_TRANSPORT (IP6.UDP PORT option) Example: KDE_TRANSPORT=\ HTTP:1920\ IP6.UDP PORT:1918\ Default value 1918 or the value set for the “RTE_TCP_PORT_NUM” on page 140 parameter Permissible values 1 - 65535 Configuration Tool (ICAT) information Panel name Specify IP.PIPE Communication Protocol Panel ID KDS62PPC Field Port number (IP6.UDP) Default value 1918 or the value set for the “RTE_TCP_PORT_NUM” on page 140 parameter Permissible values 1 - 65535 Batch parameter name KDS_CMS_TCP_UDP6_PORT PARMGEN name KDS_TEMS_TCP_UDP6_PORT_NUM Description Well-known port for the monitoring server for the IP6.UDP communication protocol (the packet-based, connectionless User Datagram Protocol that supports IPV6). This protocol is available for a monitoring server on a z/OS system at release level V1R7 or higher, with IPV6 installed and operational. Tivoli Management Services reserves a default well-known port for the first process started on a system (normally, the monitoring server). For monitoring agents and other components, an algorithm based on the port number assigned to the monitoring server calculates the listening port to reserve. A port number cannot be assigned to a component if it is already reserved for another component or application. The default listening port number for the monitoring server for IP6.UDP is 1918 or the value set for the “RTE_TCP_PORT_NUM” on page 140 parameter. You might find it necessary to change the setting under some conditions; for example, when the port assigned to a component by the algorithm is already reserved by another application or component. For a remote Tivoli Enterprise Monitoring Server, the port number must be the same as that of the hub. For detailed information about assigning port numbers, see "Port number assignments" in IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS: Common Planning and Configuration Guide. Related parameters v “RTE_TCP_PORT_NUM” on page 140 Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 231 KDS_TEMS_TYPE This parameter specifies whether to configure a hub monitoring server or a remote monitoring server. Required or optional Optional Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Parameter name KDS_HUB Default value *LOCAL Permissible values *LOCAL or *REMOTE Configuration Tool (ICAT) information Panel name Specify Configuration Values Panel ID KDS62PP1 Field Type (Hub or Remote) Default value HUB Permissible values HUB or REMOTE Batch parameter name KDS_CMS_TYP PARMGEN name KDS_TEMS_TYPE Description Specifies whether to configure a hub monitoring server or a remote monitoring server. The hub monitoring server is the focal point for the entire monitoring environment. This server is under a significant load. Work on the hub includes communicating with remote monitoring servers, with the Tivoli Enterprise Portal Server, and with local monitoring agents; authenticating users; consolidating and distributing data; storing and tracking situations and policies; and initiating and tracking all generated Take Action commands. Remote monitoring servers communicate only with the monitoring agents that report to them and with the hub monitoring server to which they report. Note that a remote monitoring server is remote with respect to the hub monitoring server, not necessarily with respect to the monitoring agents. If monitoring agents are installed on the same system as a remote monitoring server, that monitoring server is local to the monitoring agents but remote to the hub. The load on remote monitoring servers is typically low. Load is driven higher if historical data collection is performed on the monitoring servers instead of on the monitoring agents. Related parameters None 232 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference KDS_TEMS_VIRTUAL_IP_ADDRESS This parameter contains the type of virtual IP addressing (VIPA) defined for the z/OS system. Required or optional Optional Location where the parameter value is stored The parameter value is not stored, but is used for internal processing. Configuration Tool (ICAT) information Panel name Specify Advanced Configuration Values Panel ID KDS62PP3 Field Virtual IP Address (VIPA) type Default value N Permissible values S, D, or N Batch parameter name KDS_CMS_VIPA PARMGEN name KDS_TEMS_VIRTUAL_IP_ADDRESS Description Type of virtual IP addressing (VIPA) defined for the z/OS system. The default is N (None). If VIPA is in use, specify either S (Static) or D (Dynamic). The VIPA name of the monitoring server must be resolvable through the Domain Name Server (DNS). Dynamic VIPA (DVIPA, which is required for a high-availability hub) requires one of the following communication protocols: IP.PIPE, IP.SPIPE, IP6.PIPE, or IP6.SPIPE. Related parameters v “KDS_TEMS_HA_TYPE” on page 206 v “KDS_TEMS_TCP_HOST” on page 222 KDS_TEMS_VTAM_APPL_CUA_OPER This parameter contains the Common User Access (CUA) operator applid for the Tivoli Enterprise Monitoring Server. Required or optional Required for SNA communications Location where the parameter value is stored KDSSTART member of the rhilev.rte.RKANCMDU library for the runtime environment of the Tivoli Enterprise Monitoring Server Configuration Tool (ICAT) information Panel name Specify VTAM APPLID Values Panel ID KDS62PP6 Field TMS:Engine VTAM program operator Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 233 Default value CTDDSVP Permissible values Character string, maximum length 8 Batch parameter name KDS_CMS_VTM_APPL_CUA PARMGEN name KDS_TEMS_VTAM_APPL_CUA_OPER Description Common User Access (CUA) operator applid for the Tivoli Enterprise Monitoring Server. Related parameters None KDS_TEMS_VTAM_APPL_GLB_BROKER This parameter contains the VTAM applid for the global location broker. Required or optional Required for the hub if SNA is one of the selected communication protocols Location where the parameter value is stored CTDDSN member of the rhilev.rte.RKANSAMU library for the runtime environment of the hub Configuration Tool (ICAT) information Panel name Specify VTAM APPLID Values Panel ID KDS62PP6 Field Global location broker Default value CTDDSLB Permissible values Character string, maximum length 8 Batch parameter name KDS_CMS_VTM_APPL_GLB PARMGEN name KDS_TEMS_VTAM_APPL_GLB_BROKER Description VTAM applid for the global location broker. The value is recorded in the VTAM major node created for the hub. Related parameters v “KDS_HUB_VTAM_APPL_GLB_BROKER” on page 166 v “KDS_PH_TEMS_VTAM_APPL_GLB_BROKER” on page 188 KDS_TEMS_VTAM_APPL_KDS_VTAMID This parameter contains the primary VTAM applid for the Tivoli Enterprise Monitoring Server. Required or optional Required for SNA communications 234 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Parameter name KDS_VTAMID Default value CTDDSDS Permissible values Character string, maximum length 8 Configuration Tool (ICAT) information Panel name Specify VTAM APPLID Values Panel ID KDS62PP6 Field TEMS application ID Default value CTDDSDS Permissible values Character string, maximum length 8 Batch parameter name KDS_CMS_VTM_APPL_DS PARMGEN name KDS_TEMS_VTAM_APPL_KDS_VTAMID Description Primary VTAM applid for the Tivoli Enterprise Monitoring Server. Related parameters None KDS_TEMS_VTAM_APPL_KDSINVPO This parameter contains the VTAM Primary Operator (VPO) applid for the Tivoli Enterprise Monitoring Server. Required or optional Required for SNA communications Location where the parameter value is stored KDSINVPO member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Configuration Tool (ICAT) information Panel name Specify VTAM APPLID Values Panel ID KDS62PP6 Field TMS:Engine VTAM program operator Default value CTDDSVP Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 235 Permissible values Character string, maximum length 8 Batch parameter name KDS_CMS_VTM_APPL_VPO PARMGEN name KDS_TEMS_VTAM_APPL_KDSINVPO Description VTAM Primary Operator (VPO) applid for the Tivoli Enterprise Monitoring Server. Related parameters None KDS_TEMS_VTAM_APPL_LLB_BROKER This parameter contains the VTAM applid for the local location broker. Required or optional Required for SNA communications Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Parameter name KDCFC_ALIAS Default value CTDDSLB Permissible values Character string, maximum length 8 Configuration Tool (ICAT) information Panel name Specify VTAM APPLID Values Panel ID KDS62PP6 Field Local location broker Default value CTDDSLB Permissible values Character string, maximum length 8 Batch parameter name KDS_CMS_VTM_APPL_LLB PARMGEN name KDS_TEMS_VTAM_APPL_LLB_BROKER Description VTAM applid for the local location broker. Related parameters v “KDS_TEMS_VTAM_APPL_PREFIX” on page 237 236 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference KDS_TEMS_VTAM_APPL_OPERATOR This parameter contains theNon-CUA operator applid for the Tivoli Enterprise Monitoring Server. Required or optional Required for SNA communications Location where the parameter value is stored KDSSTART member of the rhilev.rte.RKANCMDU library for the runtime environment of the Tivoli Enterprise Monitoring Server Configuration Tool (ICAT) information Panel name Specify VTAM APPLID Values Panel ID KDS62PP6 Field TMS:Engine operator (non-CUA) Default value CTDDSOR Permissible values Character string, maximum length 8 Batch parameter name KDS_CMS_VTM_APPL_OPR PARMGEN name KDS_TEMS_VTAM_APPL_OPERATOR Description Non-CUA operator applid for the Tivoli Enterprise Monitoring Server. Related parameters None KDS_TEMS_VTAM_APPL_PREFIX This parameter defines a prefix for VTAM application names that are used for communication with the monitoring server. Required or optional Required for SNA communications Location where the parameter value is stored The parameter value is not stored, but is used for internal processing. Configuration Tool (ICAT) information Panel name Specify SNA Communication Protocol Panel ID KDS62PPB Field Applid prefix Default value Value set for the “RTE_VTAM_APPLID_PREFIX” on page 148 parameter Permissible values Character string, maximum length 6 Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 237 Batch parameter name KDS_CMS_VTM_APPL_PREF PARMGEN name KDS_TEMS_VTAM_APPL_PREFIX Description This value defines a prefix for VTAM application names that are used for communication with the monitoring server. These application names begin with the prefix, and end with a specific value that makes each applid unique. The names (applids) are contained in the VTAM major node. Related parameters v “RTE_VTAM_APPLID_PREFIX” on page 148 KDS_TEMS_VTAM_LU62_DLOGMOD This parameter defines LU6.2 logmode for the Tivoli Enterprise Monitoring Server. Required or optional Required for SNA communications Location where the parameter value is stored CTDDSN member of the rhilev.rte.RKANSAMU library for the runtime environment of the Tivoli Enterprise Monitoring Server Configuration Tool (ICAT) information Panel name Create LU6.2 Logmode Panel ID KDS62PLU Field LU6.2 logmode Default value CANCTDCS or the value set for the “RTE_VTAM_LU62_DLOGMOD” on page 150 parameter Permissible values Character string, maximum length 8 Batch parameter name KDS_CMS_VTM_LU62_LOG PARMGEN name KDS_TEMS_VTAM_LU62_DLOGMOD Description LU6.2 logmode for the Tivoli Enterprise Monitoring Server. Related parameters v “RTE_VTAM_LU62_DLOGMOD” on page 150 v “KDS_PH_TEMS_VTAM_LU62_DLOGMOD” on page 188 KDS_TEMS_VTAM_LU62_MODETAB This parameter contains the name of the logmode table containing the LU6.2 logmode entry for the Tivoli Enterprise Monitoring Server. Required or optional Required for SNA communications 238 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Location where the parameter value is stored CTDDSN member of the rhilev.rte.RKANSAMU library for the runtime environment of the Tivoli Enterprise Monitoring Server Configuration Tool (ICAT) information Panel name Create LU6.2 Logmode Panel ID KDS62PLU Field Logmode table name Default value KDSMTAB1 or the value set for the “RTE_VTAM_LU62_MODETAB” on page 150 parameter Permissible values Character string, maximum length 8 Batch parameter name KDS_CMS_VTM_LU62_LOGTAB PARMGEN name KDS_TEMS_VTAM_LU62_MODETAB Description Name of the logmode table containing the LU6.2 logmode entry for the Tivoli Enterprise Monitoring Server. Related parameters v “RTE_VTAM_LU62_MODETAB” on page 150 KDS_TEMS_VTAM_NETID This parameter contains the VTAM network identifier, as defined in the NETID parameter of the VTAMLST startup member (ATCSTRnn). Required or optional Required for SNA communications Location where the parameter value is stored CTDDSN member of the rhilev.rte.RKANSAMU library for the runtime environment of the Tivoli Enterprise Monitoring Server Configuration Tool (ICAT) information Panel name Specify SNA Communication Protocol Panel ID KDS62PPB Field Network ID Default value Value set for the “RTE_VTAM_NETID” on page 151 or “RTE_SYSV_VTAM_NETID” on page 139 parameter Permissible values Character string, maximum length 8 Batch parameter name KDS_CMS_VTM_NETID Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 239 PARMGEN name KDS_TEMS_VTAM_NETID Description VTAM network identifier, as defined in the NETID parameter of the VTAMLST startup member (ATCSTRnn). Related parameters v “RTE_VTAM_NETID” on page 151 v “RTE_SYSV_VTAM_NETID” on page 139 v “KDS_PH_TEMS_VTAM_NETID” on page 189 KDS_TEMS_VTAM_NODE This parameter contains the name of the VTAM major node for the Tivoli Enterprise Monitoring Server. Required or optional Required for SNA communications Location where the parameter value is stored CTDDSN member of the rhilev.rte.RKANSAMU library for the runtime environment of the Tivoli Enterprise Monitoring Server Batch parameter name KDS_CMS_VTM_NODE PARMGEN name KDS_TEMS_VTAM_NODE Description Name of the VTAM major node for the Tivoli Enterprise Monitoring Server. Related parameters v “RTE_VTAM_GBL_MAJOR_NODE” on page 149 KDS_X_HUB_BKUP1_TCP_HOST This parameter defines the TCP/IP hostname identifier for the backup Hub TEMS that the Remote TEMS should try to connect to if the primary Hub TEMS is unavailable Required or optional Required only if you plan to have the Remote TEMS communicate with the backup Hub TEMS using TCP/IP Location where the parameter value is stored The KDCSSITE member of the RKANPARU library Parameter name and syntax IP.PIPE:&XDSBTCPH or IP.UDP:&XDSBTCPH Default value No default Permissible values A string of up to 32 characters defining a fully qualified TCP/IP hostname identifier PARMGEN name KDS_X_HUB_BKUP1_TCP_HOST Description TEMS backup Server TCP/IP hostname 240 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference This parameter defines the TCP/IP hostname identifier for the backup Hub TEMS that the Remote TEMS should try to connect to if the primary Hub TEMS is unavailable. This is a required field if you plan to have Remote TEMS communicate with the backup Hub TEMS using TCP/IP. Related parameters None KDS_X_HUB_BKUP1_TEMS_VTAM_NETID This parameter specifies the identifier of your VTAM network. Required or optional Required only if you plan to have the Remote TEMS communicate with the backup Hub TEMS using VTAM Location where the parameter value is stored In the VTAMLST startup member, ATCSTRnn for the backup Hub monitoring server Parameter name and syntax SNA.PIPE:&XDSBNETD Default value No default Permissible values A string of up to 8 characters PARMGEN name KDS_X_HUB_BKUP1_TEMS_VTAM_NETID Description TEMS backup Sever Network ID This parameter specifies the identifier of your VTAM network. You can locate this value on the NETID parameter within the VTAMLST startup member, ATCSTRnn. This is a required field if you plan to have the Remote TEMS communicate with the backup Hub TEMS using VTAM. Related parameters None KDS_X_HUB_BKUP1_VTAM_APPL_GLBBKR This parameter identifies the global location broker that is to be used for VTAM communication to the backup monitoring server. Required or optional Required if the remote TEMS needs to communicate with the backup Hub TEMS using the VTAM protocol Location where the parameter value is stored The KDCSSITE member of the RKANPARU library. Parameter name and syntax SNA.PIPE: Default value No default Permissible values A character string of up to 8 characters PARMGEN name KDS_X_HUB_BKUP1_VTAM_APPL_GLBBKR Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 241 Description TEMS backup VTAM applid for the global location broker. This parameter identifies the global location broker that is to be used for VTAM communication to the backup monitoring server. This is a required field if the remote TEMS needs to communicate with the backup Hub TEMS using the VTAM protocol. Related parameters None KDS_X_KDCFC_RXLIMIT This parameter defines the size (in KB) of the buffer used for return queries. Required or optional Required Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the runtime environment of the hub monitoring server. Parameter name and syntax KDCFC_RXLIMIT=8192 Default value 8192 Permissible values 1024–65536 PARMGEN name KDS_X_KDCFC_RXLIMIT Description RPC request size This parameter defines the size (in KB) of the buffer used for return queries. Related parameters None KDS_X_KDE_TRANSPORT_HTTP_OPTIONS This parameter allows for any HTTP-related overrides in the KDE_TRANSPORT environment variable keyword if it is determined that your site requires these special settings. Required or optional Optional Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the portal server Parameter name and syntax KDE_TRANSPORT Default value None Permissible values The following special settings are supported: HTTPS:0 Eliminates error messages when the HTTPS daemon server is active and failing to obtain or bind to family ip.ssl (ip.ssl.https:3661). 242 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference HTTP:0, HTTPS:0 These settings disable port allocation and port bind errors for the HTTP (1920) and HTTPS (3661) default ports. HTTP_SERVER:n This KDE_TRANSPORT environment variable keyword disables HTTP and HTTPS daemon services. Do not specify this for a hub monitoring server or for the portal server. HTTP_CONSOLE:n This KDE_TRANSPORT environment variable keyword disables the TMS/Service Console facility of the HTTP daemon service. HTTP_CONSOLE:N This KDE_TRANSPORT environment variable keyword removes the process from the published Tivoli service index; this makes the process inaccessible from the TMS/Service Console. PARMGEN name KDS_X_KDE_TRANSPORT_HTTP_OPTIONS Description Allows for any HTTP-related overrides in the KDE_TRANSPORT environment variable keyword if it is determined that your site requires these special settings. The KDE_TRANSPORT environment variable keyword redefines the ports to be use by the HTTP and HTTPS daemons. A portal server on Windows, Linux, or UNIX uses port 1920 for HTTP connections and 3661 for HTTPS connections from portal browser clients. Default port settings should not be changed, especially on multifunction UNIX and Linux systems, since many components might be located on the same system and some of these components might depend on the default values being used for HTTP and HTTPS ports. Related parameters None KDS_X_KDE_TRANSPORT_OPTIONS This parameter allows for any KDE_TRANSPORT-related overrides in addition to HTTP-related and POOL-related options. Required or optional Optional Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the portal server Parameter name and syntax KDE_TRANSPORT Default value None Permissible values A string of up to 30 characters PARMGEN name KDS_X_KDE_TRANSPORT_OPTIONS Description Additional KDE_TRANSPORT overrides Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 243 This parameter allows for any KDE_TRANSPORT-related overrides, in addition to HTTP-related and POOL-related options. See “KDS_X_KDE_TRANSPORT_HTTP_OPTIONS” on page 242 for HTTP*-related overrides and “KDS_X_KDE_TRANSPORT_POOL_OPTIONS”KDS_X_KDE_TRANSPORT_POOL_OPTIONS for POOL-related override parameters in KDE_TRANSPORT parameter.); Related parameters v “KDS_X_KDE_TRANSPORT_HTTP_OPTIONS” on page 242 v “KDS_X_KDE_TRANSPORT_POOL_OPTIONS” KDS_X_KDE_TRANSPORT_POOL_OPTIONS This parameter allows for any POOL-related overrides in the KDE_TRANSPORT environment variable keyword if it is determined that your site requires these special settings. Required or optional Optional Location where the parameter value is stored KDSENV member of the rhilev.rte.RKANPARU library for the portal server Parameter name and syntax KDE_TRANSPORT POOL:nnnn-nnnn Default value None Permissible values A range of ports no smaller than 2 and no larger than 1024, expressed as nnnn-nnnn PARMGEN name KDS_X_KDE_TRANSPORT_POOL_OPTIONS Description Range of port numbers parameters This parameter allows for any POOL-related overrides in the KDE_TRANSPORT environment variable keyword if it is determined that your site requires these special settings. After the port allocation algorithm assigns a well-known port to each process, all subsequent ports allocated for connections between components are opaque ports; that is, any available port can be allocated for a connection. You can limit opaque port allocations to a specific range of ports by coding the POOL option with any protocol specified on the KDE_TRANSPORT environment variable. The POOL option must specify a range of ports no smaller than 2 and no larger than 1024 in the format nnnn-nnnn. POOL:1000-2023 is valid; POOL:1000-2024 is not. If more than 1024 ports are needed in a pool for a specific protocol, you can code more than one POOL option, as in POOL:1000-2023 POOL:3000-4023. Related parameters None KDS_X_SECURITY_RESOURCE_CLASS This parameter specifies a member in RKANPARU that contains protected class lists information used by external security packages to construct the correct resource validation request. Required or optional Required 244 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Location where the parameter value is stored KDSINNAM member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name and syntax CLASSES=&XDSSCLA Default value &XDSSCLA Permissible values A string up to 8 characters in length PARMGEN name KDS_X_SECURITY_RESOURCE_CLASS Description External security classes This parameter specifies a member in RKANPARU that contains protected class lists information. This is used by external security packages to construct the correct resource validation request. The default for Tivoli Enterprise Monitoring Server CLASSES is &XDSSCLA. Related parameters None KDS_X_SECURITY_USER_EXIT This parameter specifies the load module name of an exit routine that will be invoked to provide validation. Required or optional Optional Location where the parameter value is stored KDSINNAM member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name and syntax EXIT=&XDSSUEX Default value &XDSSUEX Permissible values A string of up to 8 characters. PARMGEN name KDS_X_SECURITY_USER_EXIT Description External security exit. This parameter specifies the load module name of an exit routine that will be invoked to provide validation. The default for Tivoli Enterprise Monitoring Server EXIT is &XDSSUEX. Related parameters None KDS_X_STC_SYSTCPD_INCLUDE_FLAG This parameter is used to identify which dataset to use to obtain the parameters defined by TCPIP.DATA when no GLOBALTCPIPDATA statement is configured. Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 245 Required or optional Required Location where the parameter value is stored N/A Parameter name and syntax N/A Default value N. Permissible values Y or N PARMGEN name KDS_X_STC_SYSTCPD_INCLUDE_FLAG Description Specifies whether to include the SYSTCPD DD statement in the TEMS started task. This flag is for the SYSTCPD DD: TCPDATA override. Override this DD card to explicitly identify which dataset to use to obtain the parameters defined by TCPIP.DATA when no GLOBALTCPIPDATA statement is configured. Refer to the IBM z/OS Communications Server: IP Configuration Guide for information on the TCPIP.DATA search order. TCPIP.SEZAINST(TCPDATA) is the default sample file. TCPIP.TCPPARMS(TCPDATA) is another sample and is created as part of the Installation Verification Program (IVP) for TCP/IP. To customize this value in PARMGEN mode, override this parameter in the CONFIG profile member in WCONFIG ($CFG$USR or the user-specified) prior to running the $PARSE job and specify the GBL_DSN_TCP_SYSTCPD_TCPDATA library accordingly. Related parameters v “GBL_DSN_TCP_SYSTCPD_TCPDATA” on page 101 KDS_X_TEMS_CONFIRM_SHUTDOWN This parameter specifies the maximum number of seconds between two successive SHUTDOWN commands or MVS STOP (P) commands to terminate the monitoring server address space. Required or optional Required Location where the parameter value is stored KDSSYSIN member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name and syntax CONFIRM(n) Default value v Default for the Configuration Tool and PARMGEN: CONFIRM(0) v Default in TMS:Engine: CONFIRM(15) Permissible values 0 - 2000000000 PARMGEN name KDS_X_TEMS_CONFIRM_SHUTDOWN Description Maximum number of seconds between two successive SHUTDOWN commands or MVS STOP (P) commands to terminate the monitoring server address space. CONFIRM(0) allows shutdown to begin immediately, without an additional, confirming SHUTDOWN command. CONFIRM(n), 246 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference where n is a number greater than zero, prevents accidental shutdowns by requiring confirmation of the command by entering it a second time within the specified number of seconds. For example, the value 15 requires that the SHUTDOWN command be entered twice within 15 seconds to terminate the monitoring server address space. Related parameters None KDS_X_TEMS_DEBUG_TRACE This parameter determines whether to activate TMS:Engine debugging services. Required or optional Optional Location where the parameter value is stored KDSSYSIN member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name and syntax DEBUG(N|Y) Default value DEBUG(N) Permissible values DEBUG(N) or DEBUG(Y) PARMGEN name KDS_X_TEMS_DEBUG_TRACE Description Determines whether to activate TMS:Engine debugging services. A setting of Y automatically turns on the internal trace with the default number of entries (1024), resulting in an increase in CPU use, storage use, and number of messages issued. The amount of increase depends on the activity in the Tivoli Enterprise Monitoring Server address space. The setting for this parameter and the setting for the “KDS_X_TEMS_STORAGE_STGDEBUG” on page 256 parameter interact. v If the “KDS_X_TEMS_STORAGE_STGDEBUG” on page 256 parameter is included (not commented out and not deleted), the “KDS_X_TEMS_DEBUG_TRACE” parameter must precede it. Otherwise, “KDS_X_TEMS_DEBUG_TRACE” overrides “KDS_X_TEMS_STORAGE_STGDEBUG” on page 256. v If the “KDS_X_TEMS_STORAGE_STGDEBUG” on page 256 parameter is commented out or omitted, and the setting for “KDS_X_TEMS_DEBUG_TRACE” is Y, basic storage debugging is turned on, causing an increase in storage use. v If the setting for the “KDS_X_TEMS_STORAGE_STGDEBUG” on page 256 parameter is N, and the setting for “KDS_X_TEMS_DEBUG_TRACE” is Y, no storage debugging is performed. v If the setting for the “KDS_X_TEMS_STORAGE_STGDEBUG” on page 256 parameter is Y or X, and the setting for “KDS_X_TEMS_DEBUG_TRACE” is N, storage debugging is performed, but no other debugging is performed. Related parameters v “KDS_X_TEMS_STORAGE_STGDEBUG” on page 256 KDS_X_TEMS_EIF_BFR_EVT This parameter determines whether event buffering is enabled. Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 247 Required or optional Optional Location where the parameter value is stored KMSOMTEC member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Parameter name BufferEvents Default value Y Permissible values Y or N Batch parameter name KDS_CMS_EIF_BFR_EVT PARMGEN name KDS_X_TEMS_EIF_BFR_EVT Description Determines whether event buffering is enabled. A value of Y stores events in the library specified by the “KDS_X_TEMS_EIF_BFR_EVT_PATH” parameter. A value of N does not store or buffer events. For further information, see "Whether and how to enable event forwarding" in IBM Tivoli Management Services on z/OS: Configuring the Tivoli Enterprise Monitoring Server on z/OS. Related parameters v “KDS_X_TEMS_EIF_BFR_EVT_PATH” KDS_X_TEMS_EIF_BFR_EVT_PATH This parameter contains the full path name of the adapter cache file. Required or optional Required if the “KDS_X_TEMS_EIF_BFR_EVT” on page 247 parameter is set to Y. Location where the parameter value is stored KMSOMTEC member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Parameter name BufEvtPath Default value ./TECLIB/OM_TEC.CACHE Permissible values Character string, maximum length 44 Batch parameter name KDS_CMS_EIF_BFR_EVT_PATH PARMGEN name KDS_X_TEMS_EIF_BFR_EVT_PATH Description Full path name of the adapter cache file. The format is like that of a data set name that is limited to 5 levels with no more than 8 characters per level, separated by periods (for example, LEVEL001.LEVEL002.LEVEL003.LEVEL004.LEVEL005). 248 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference For further information, see "Whether and how to enable event forwarding" in IBM Tivoli Management Services on z/OS: Configuring the Tivoli Enterprise Monitoring Server on z/OS. Related parameters v “KDS_X_TEMS_EIF_BFR_EVT” on page 247 KDS_X_TEMS_EIF_FLT_ATTR1 This parameter contains the name of a filter attribute. Required or optional Optional Location where the parameter value is stored KMSOMTEC member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Batch parameter name KDS_CMS_EIF_FLT_ATTR1 PARMGEN name KDS_X_TEMS_EIF_FLT_ATTR1 Description Name of a filter attribute. An event matches a Filter statement when each attribute=value pair in the Filter statement is identical to the corresponding attribute=value pair in the event. A Filter statement must contain the event class, and optionally can include any other attribute=value pair that is defined for the event class. The format of a filtering statement is: Filter:Class=class_name;attribute=value;..;attribute=value Each statement must be on a single line. The attribute=value pair is case-sensitive. For further information, see "Whether and how to enable event forwarding" in IBM Tivoli Management Services on z/OS: Configuring the Tivoli Enterprise Monitoring Server on z/OS. Related parameters v “KDS_X_TEMS_EIF_FLT_CLASS1” KDS_X_TEMS_EIF_FLT_CLASS1 This parameter contains the name of the event class for a filter. Required or optional Optional Location where the parameter value is stored KMSOMTEC member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Batch parameter name KDS_CMS_EIF_FLT_CLASS1 PARMGEN name KDS_X_TEMS_EIF_FLT_CLASS1 Description Name of the event class for a filter. A Filter statement must contain the event class. The format of a filtering statement is: Filter:Class=class_name;attribute=value;..;attribute=value Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 249 Each statement must be on a single line. For further information, see "Whether and how to enable event forwarding" in IBM Tivoli Management Services on z/OS: Configuring the Tivoli Enterprise Monitoring Server on z/OS. Related parameters v “KDS_X_TEMS_EIF_FLT_ATTR1” on page 249 KDS_X_TEMS_EIF_FLT_MODE This parameter determines whether events that match a Filter or FilterCache statement are sent to the event server (FilterMode=IN) or discarded (FilterMode=OUT). Required or optional Optional Location where the parameter value is stored KMSOMTEC member of the rhilev.rte.RKANPARU library for the runtime environment of the Tivoli Enterprise Monitoring Server Parameter name FilterMode Default value OUT Permissible values IN or OUT Batch parameter name KDS_CMS_EIF_FLT_MODE PARMGEN name KDS_X_TEMS_EIF_FLT_MODE Description Determines whether events that match a Filter or FilterCache statement are sent to the event server (FilterMode=IN) or discarded (FilterMode=OUT). If you set FilterMode=IN, you must have one or more Filter and FilterCache statements defined. For further information, see "Whether and how to enable event forwarding" in IBM Tivoli Management Services on z/OS: Configuring the Tivoli Enterprise Monitoring Server on z/OS. Related parameters None KDS_X_TEMS_FRAME_STACK_SIZE This parameter defines the size (in bytes) of the initial save area stack that TMS:Engine allocates for each of its tasks. Required or optional Required Location where the parameter value is stored KDSSYSIN member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name and syntax FRAME(n) Default value v Default for the Configuration Tool and PARMGEN: FRAME(1025) 250 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference v Default in TMS:Engine: FRAME(512) Permissible values Do not change the value from the default except under the guidance of IBM Software Support. PARMGEN name KDS_X_TEMS_FRAME_STACK_SIZE Description Size (in bytes) of the initial save area stack that TMS:Engine allocates for each of its tasks. Related parameters None KDS_X_TEMS_LGSA_VERIFY This parameter determines whether TMS:Engine checks that the $GSA address is available. Required or optional Required Location where the parameter value is stored KDSSYSIN member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name and syntax LGSA(Y|N) Default value LGSA(Y) Permissible values Do not change the value from the default except under the guidance of IBM Software Support. PARMGEN name KDS_X_TEMS_LGSA_VERIFY Description Determines whether TMS:Engine checks that the $GSA address is available. Related parameters None KDS_X_TEMS_LOGBLOCK_RKLVLOG_SIZE This parameter defines the block size, in bytes, of the RKLVLOG file. Required or optional Required Location where the parameter value is stored KDSSYSIN member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name and syntax LOGBLOCK(n) Default value v Default for the Configuration Tool and PARMGEN: LOGBLOCK(12480) v Default in TMS:Engine: LOGBLOCK(3120) Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 251 Permissible values Do not change the value from the default except under the guidance of IBM Software Support. PARMGEN name KDS_X_TEMS_LOGBLOCK_RKLVLOG_SIZE Description Block size, in bytes, of the RKLVLOG file. Related parameters v “KDS_X_TEMS_LOGBUFS_RKLVLOG_BUFSZ” KDS_X_TEMS_LOGBUFS_RKLVLOG_BUFSZ This parameter defines the number of buffers to allocate for the RKLVLOG file. Required or optional Required Location where the parameter value is stored KDSSYSIN member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name and syntax LOGBUFS(n) Default value v Default for the Configuration Tool and PARMGEN: LOGBUFS(5) v Default in TMS:Engine: LOGBUFS(2) Permissible values Do not change the value from the default except under the guidance of IBM Software Support. PARMGEN name KDS_X_TEMS_LOGBUFS_RKLVLOG_BUFSZ Description Number of buffers to allocate for the RKLVLOG file. If the value of LOGBUFS is too small and extensive logging is performed (for example, during debugging), excessive physical I/O can increase response time. If the value of LOGBUFS is too large, storage shortages can occur. Related parameters v “KDS_X_TEMS_LOGBLOCK_RKLVLOG_SIZE” on page 251 KDS_X_TEMS_LSRPOOL_BUFFER_NUMn This parameter specifies the number of virtual storage buffers, of the size specified in the KDS_X_TEMS_LSRPOOL_BUFSIZEn parameter, to be allocated for buffer pool n in the VSAM resource pool. Required or optional Required Location where the parameter value is stored KDSSYSIN member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name and syntax LSRPOOL(size,number) 252 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Default value v Default for the Configuration Tool and PARMGEN: See the example in the Description section. v Default in TMS:Engine: No default value, but starting TMS:Engine requires at least one LSRPOOL parameter. Permissible values 3 - 65535 (to the maximum amount of available virtual storage in the monitoring server address space) PARMGEN name KDS_X_TEMS_LSRPOOL_BUFFER_NUMn Description Number of virtual storage buffers, of the size specified in the KDS_X_TEMS_LSRPOOL_BUFSIZEn parameter, to be allocated for buffer pool n in the VSAM resource pool. You must specify a number for each buffer pool individually; you cannot string the definitions together. Example: KDS_X_TEMS_LSRPOOL_BUFSIZE1 KDS_X_TEMS_LSRPOOL_BUFFER_NUM1 KDS_X_TEMS_LSRPOOL_BUFSIZE2 KDS_X_TEMS_LSRPOOL_BUFFER_NUM2 KDS_X_TEMS_LSRPOOL_BUFSIZE3 KDS_X_TEMS_LSRPOOL_BUFFER_NUM3 KDS_X_TEMS_LSRPOOL_BUFSIZE4 KDS_X_TEMS_LSRPOOL_BUFFER_NUM4 32768 12 8192 21 4096 400 1024 6 If you receive KLVVS026 messages identifying buffer contention, increase the number of buffers allocated to the data set identified in the associated KLVVS021 messages. Related parameters v “KDS_X_TEMS_LSRPOOL_BUFSIZEn” KDS_X_TEMS_LSRPOOL_BUFSIZEn This parameter specifies the size (in bytes) of each virtual storage buffer in buffer pool n in the VSAM resource pool. Required or optional Required Location where the parameter value is stored KDSSYSIN member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name and syntax LSRPOOL(size,number) Default value v Default for the Configuration Tool and PARMGEN: See the example in the Description section. v Default in TMS:Engine: No default value, but starting TMS:Engine requires at least one LSRPOOL parameter. Permissible values 512, 1024, 2048, 4096, 8192, 12288, 16384, 20480, 24576, 28672, or 32768 PARMGEN name KDS_X_TEMS_LSRPOOL_BUFSIZEn Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 253 Description Size (in bytes) of each virtual storage buffer in buffer pool n in the VSAM resource pool. You must specify a size for each buffer pool individually; you cannot string the definitions together. Example: KDS_X_TEMS_LSRPOOL_BUFSIZE1 KDS_X_TEMS_LSRPOOL_BUFFER_NUM1 KDS_X_TEMS_LSRPOOL_BUFSIZE2 KDS_X_TEMS_LSRPOOL_BUFFER_NUM2 KDS_X_TEMS_LSRPOOL_BUFSIZE3 KDS_X_TEMS_LSRPOOL_BUFFER_NUM3 KDS_X_TEMS_LSRPOOL_BUFSIZE4 KDS_X_TEMS_LSRPOOL_BUFFER_NUM4 32768 12 8192 21 4096 400 1024 6 Related parameters v “KDS_X_TEMS_LSRPOOL_BUFFER_NUMn” on page 252 KDS_X_TEMS_LSRSTRNO_CONCURRENT This parameter specifies the maximum number of concurrent VSAM requests that TMS:Engine can process against all the VSAM data sets allocated to it. Required or optional Required Location where the parameter value is stored KDSSYSIN member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name and syntax LSRSTRNO(n) Default value v Default for the Configuration Tool and PARMGEN: LSTSTRNO(255) v Default in TMS:Engine: LSTSTRNO(32) Permissible values 3 - 255 PARMGEN name KDS_X_TEMS_LSRSTRNO_CONCURRENT Description Maximum number of concurrent VSAM requests that TMS:Engine can process against all the VSAM data sets allocated to it. If you receive KLVVS026 messages identifying string contention and if the LSRSTRNO value is lower than 255, increase the value. Related parameters None KDS_X_TEMS_SDUMP_SVC_SYS1_DUMP This parameter determines whether SVC dumps are generated. Required or optional Required Location where the parameter value is stored KDSSYSIN member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server 254 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Parameter name and syntax SDUMP(Y|N) Default value SDUMP(Y) if the TMS:Engine job step is APF-authorized; SDUMP(N) otherwise. Permissible values Y, N, S, or M (see Description) PARMGEN name KDS_X_TEMS_SDUMP_SVC_SYS1_DUMP Description Determines whether SVC dumps are generated. v Y directs SVC dumps to a system dump data set (SYS1.DUMPxx). Before you specify Y as the value of this parameter, ensure that the TMS:Engine job step is APF-authorized and that the SYS1.DUMPxx data sets are large enough to hold the contents of the TMS/Engine address space. v N directs formatted dumps to the RKLVSNAP data set. Avoid formatted dumps if possible, because they disable the TMS:Engine address space for a longer time than either SVC dumps or SYSMDUMPs, and are more difficult to analyze. v S directs summary dumps to the RKLVSNAP data set. A summary dump consists of an ABEND summary and a dispatcher summary, and does not provide enough information for reliable problem analysis. Use this setting for specific testing purposes only. v M directs ABEND dumps to a data set with the SYSMDUMP DD name. This type of dump is not formatted by the operating system and must be analyzed with IPCS. Only the first dump taken is captured in the SYSMDUMP data set unless the JCL specifies DISP=MOD. TMS:Engine automatically initializes the SYSMDUMP data set with an end-of-file mark. Related parameters None KDS_X_TEMS_STORAGE_RESERVE_PRI This parameter specifies the number of kilobytes of primary (below-the-line) storage to set aside for other routines (for example, RACF) that might perform their own GETMAINs in the monitoring server address space. Required or optional Required Location where the parameter value is stored KDSSYSIN member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name RESERVE(n,P) Default value v Default for the Configuration Tool and PARMGEN: – High-availability hub: RESERVE(4096,P) – Other monitoring servers: RESERVE(2048,P) v Default in TMS:Engine: RESERVE(512,P) Permissible values See Description. PARMGEN name KDS_X_TEMS_STORAGE_RESERVE_PRI Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 255 Description The number of kilobytes of primary (below-the-line) storage to set aside for other routines (for example, RACF) that might perform their own GETMAINs in the monitoring server address space. If your RESERVE value is too small, you might encounter IST566I messages from VTAM or S80A, S878, S066, S40D, or S0F9 abends. Related parameters None KDS_X_TEMS_STORAGE_STGDEBUG This parameter determines whether to disable (N) TMS:Engine storage debugging services, or to activate basic (Y) or extended (X) storage debugging services. Required or optional Optional Location where the parameter value is stored KDSSYSIN member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name and syntax STGDEBUG(N|Y|X) Default value STGDEBUG(N) Permissible values STGDEBUG(N), STGDEBUG(Y), or STGDEBUG(X) PARMGEN name KDS_X_TEMS_STORAGE_STGDEBUG Description Determines whether to disable (N) TMS:Engine storage debugging services, or to activate basic (Y) or extended (X) storage debugging services. A setting of Y or X increases storage use; X causes a larger increase than Y. The setting for this parameter and the setting for the “KDS_X_TEMS_DEBUG_TRACE” on page 247 parameter interact. v If the “KDS_X_TEMS_STORAGE_STGDEBUG” parameter is included (not commented out and not deleted), the “KDS_X_TEMS_DEBUG_TRACE” on page 247 parameter must precede it. Otherwise, “KDS_X_TEMS_DEBUG_TRACE” on page 247 overrides “KDS_X_TEMS_STORAGE_STGDEBUG.” v The default setting for the “KDS_X_TEMS_STORAGE_STGDEBUG” parameter is N if the “KDS_X_TEMS_DEBUG_TRACE” on page 247parameter is commented out or omitted, or if the value of the “KDS_X_TEMS_DEBUG_TRACE” on page 247 parameter is N; and Y if the value of “KDS_X_TEMS_DEBUG_TRACE” on page 247 is Y. v If the “KDS_X_TEMS_STORAGE_STGDEBUG” parameter is commented out or omitted, and the setting for “KDS_X_TEMS_DEBUG_TRACE” on page 247 is Y, basic storage debugging is turned on, causing an increase in storage use. v If the setting for the “KDS_X_TEMS_STORAGE_STGDEBUG” parameter is N, and the setting for “KDS_X_TEMS_DEBUG_TRACE” on page 247 is Y, no storage debugging is performed. v If the setting for the “KDS_X_TEMS_STORAGE_STGDEBUG” parameter is Y or X, and the setting for “KDS_X_TEMS_DEBUG_TRACE” on page 247 is N, storage debugging is performed, but no other debugging is performed. Related parameters v “KDS_X_TEMS_DEBUG_TRACE” on page 247 256 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference KDS_X_TEMS_TASKS_ATTACHED_NUM This parameter specifies the number of general-purpose subtasks to be attached in the monitoring server address space. Required or optional Required Location where the parameter value is stored KDSSYSIN member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name and syntax TASKS(n) Default value The number of available processors. Permissible values Do not change the value from the default except under the guidance of IBM Software Support. PARMGEN name KDS_X_TEMS_TASKS_ATTACHED_NUM Description Number of general-purpose subtasks to be attached in the monitoring server address space. If the monitoring server is running on a multiprocessor, the TASKS default increases both throughput and CPU usage. Related parameters None KDS_X_TEMS_WTO This parameter determines whether the monitoring server address space issues Write To Operator (WTO) messages. Required or optional Required Location where the parameter value is stored KDSSYSIN member of the rhilev.rte.RKANPARU library for the runtime environment of the monitoring server Parameter name and syntax WTO(Y|N) Default value WTO(N) Permissible values Y or N PARMGEN name KDS_X_TEMS_WTO Description Determines whether the monitoring server address space issues Write To Operator (WTO) messages. WTOs write information and exception condition messages to the operator consoles. Alert messages are always written to the consoles. Related parameters None Chapter 5. Tivoli Enterprise Monitoring Server (KDS) parameters 257 Parameters for the high-availability hub monitoring server The parameters for the high-availability hub monitoring server updates are explained in this section. KDS_TEMS_HA_TYPE This parameter determines whether to configure the Tivoli Enterprise Monitoring Server as a high-availability hub. Required or optional Required Location where the parameter value is stored The parameter value is not stored, but is used for internal processing. Configuration Tool (ICAT) information Panel name Specify Configuration Values Panel ID KDS62PP1 Field Hub TEMS type Default value None Permissible values HA or none Batch parameter name KDS_CMS_HA_TYP PARMGEN name KDS_TEMS_HA_TYPE Description Determines whether to configure the Tivoli Enterprise Monitoring Server as a high-availability hub. This configuration requires a sysplex environment with dynamic virtual IP addressing (DVIPA) and shared DASD. A high-availability hub is configured in its own runtime environment, without monitoring agents, and can be configured on the same LPAR with a remote monitoring server. This configuration allows the hub to be relocated to any suitable LPAR in the sysplex with no changes, and with minimal disruption to the components connecting to the hub. Related parameters v “KDS_HUB_TEMS_HA_TYPE” on page 165 v “KDS_TEMS_HA_EXCL_LIST” on page 206 v “KDS_TEMS_VIRTUAL_IP_ADDRESS” on page 233 v “KDS_TEMS_TCP_HOST” on page 222 258 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Chapter 6. Enhanced 3270 user interface (KOB) parameters The parameters that control the OMEGAMON enhanced 3270 user interface are explained in this section. The OMEGAMON enhanced 3270 user interface has its own set of common configuration parameters, each of which begins with "KOB". The KOB parameters are related to the following parameters, described elsewhere in this reference: v “KDS_TEMS_DRA_FLAG” on page 198 v “RTE_SECURITY_CLASS” on page 125 KOB_TOM_STC This parameter is the name of the started task for the OMEGAMON enhanced 3270 user interface's Tivoli OMEGAMON Manager (TOM). Required or optional Required if you configure the OMEGAMON enhanced 3270 user interface component. Location where the parameter value is stored Value becomes the name of the TOM started task procedure member in the rhilev.rtename.RKANSAMU library. Parameter name and syntax N/A Default value CANSTOM Permissible values Character string, maximum length 8. In the Configuration Tool (ICAT) Panel name SPECIFY CONFIGURATION VALUES Panel ID KOB70P1 Field OMEGAMON Enhanced 3270 UI Default value CANSTOM Permissible values Character string, maximum length 8. Batch parameter name KOB_TOM_STC PARMGEN name KOB_TOM_STC Description This parameter is the name of the started task that starts the OMEGAMON enhanced 3270 user interface's Tivoli OMEGAMON Manager (TOM). Related parameters v “KDS_TEMS_DRA_FLAG” on page 198 v “RTE_SECURITY_CLASS” on page 125 © Copyright IBM Corp. 2010, 2012 259 v “KOB_TOM_VTAM_APPL_LOGON” v “KOB_TOM_VTAM_NODE” on page 261 KOB_TOM_VTAM_APPL_LOGON This parameter specifies the name that will be used to build the VTAM logon APPLID for the OMEGAMON enhanced 3270 user interface's Tivoli OMEGAMON Manager (CTDOBN). Required or optional Required if you configure the OMEGAMON enhanced 3270 user interface component. Location where the parameter value is stored Value is included in the TOM VTAM major node member in the rhilev.rtename.RKANSAMU library or in the RTE_VTAM_GBL_MAJOR_NODE member in RKANSAMU. Parameter name and syntax N/A Default value CTDOBAP Permissible values Character string, maximum length 8. In the Configuration Tool (ICAT) Panel name SPECIFY CONFIGURATION VALUES Panel ID KOB70P1 Field VTAM information: Appl ID Default value CTDOBAP Permissible values Character string, maximum length 8. Batch parameter name KOB_TOM_VTAM_APPL_LOGON PARMGEN name KOB_TOM_VTAM_APPL_LOGON Description This parameter specifies the VTAM logon APPLID for the OMEGAMON enhanced 3270 user interface's Tivoli OMEGAMON Manager (CTDOBN). Note: If you use the global VTAM major node member specified on the RTE_VTAM_GBL_MAJOR_NODE parameter, the VTAM APPLID associated with CTDOBN is automatically included in the RTE_VTAM_GBL_MAJOR_NODE member in RKANSAMU. Related parameters v “KDS_TEMS_DRA_FLAG” on page 198 v “RTE_SECURITY_CLASS” on page 125 v “RTE_VTAM_GBL_MAJOR_NODE” on page 149 v “KOB_TOM_STC” on page 259 v “KOB_TOM_VTAM_NODE” on page 261 260 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference KOB_TOM_VTAM_NODE This parameter specifies the name used to build the VTAM node entry for the OMEGAMON enhanced 3270 user interface's Tivoli OMEGAMON Manager (CTDOBN). Required or optional Required if you configure the OMEGAMON enhanced 3270 user interface component. Location where the parameter value is stored Value specified becomes the name of the TOM VTAM major node member in the rhilev.rtename.RKANSAMU library. Parameter name and syntax N/A Default value CTDOBN Permissible values Character string, maximum length 8. In the Configuration Tool (ICAT) Panel name SPECIFY CONFIGURATION VALUES Panel ID KOB70P1 Field VTAM information: Node name Default value CTDOBN Permissible values Character string, maximum length 8. Batch parameter name KOB_TOM_VTAM_NODE PARMGEN name KOB_TOM_VTAM_NODE Description This parameter specifies the name used to build the VTAM node entry for the OMEGAMON enhanced 3270 user interface's Tivoli OMEGAMON Manager (CTDOBN). Note: If you use the global VTAM major node member specified on the RTE_VTAM_GBL_MAJOR_NODE parameter, the VTAM APPLID associated with CTDOBN is automatically included in the RTE_VTAM_GBL_MAJOR_NODE member in RKANSAMU. Related parameters v “KDS_TEMS_DRA_FLAG” on page 198 v “RTE_SECURITY_CLASS” on page 125 v “RTE_VTAM_GBL_MAJOR_NODE” on page 149 v “KOB_TOM_STC” on page 259 v “KOB_TOM_VTAM_APPL_LOGON” on page 260 Chapter 6. Enhanced 3270 user interface (KOB) parameters 261 262 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Documentation library This appendix contains information about the publications related to the OMEGAMON XE products and to IBM Tivoli Monitoring and the commonly shared components of Tivoli Monitoring Server. These publications are listed in the following categories: v “IBM Tivoli Monitoring library” v “Documentation for the base agents” on page 264 v “Related publications” on page 265 v “Other sources of documentation” on page 265 See IBM Tivoli Monitoring and OMEGAMON XE Products: Documentation Guide, SC23-8816, for information about accessing and using the publications. You can find the Documentation Guide in the IBM Tivoli Monitoring and OMEGAMON XE Information Center at http://publib.boulder.ibm.com/infocenter/ tivihelp/v15r1/index.jsp. To open the Documentation Guide in the information center, select Using the publication in the Contents pane. To find a list of new and changed publications, click What's new on the Welcome page of the IBM Tivoli Monitoring and OMEGAMON XE Information Center. To find publications from the previous version of a product, click Previous information centers on the Welcome page for the product. IBM Tivoli Monitoring library The following publications provide information about IBM Tivoli Monitoring and about the commonly shared components of Tivoli Management Services: v Quick Start Guide, GI11-8058 Introduces the components of IBM Tivoli Monitoring. v Installation and Setup Guide, GC32-9407 Provides instructions for installing and configuring IBM Tivoli Monitoring components on Windows, Linux, and UNIX systems. v Program Directory for IBM Tivoli Management Services on z/OS, GI11-4105 Gives instructions for the SMP/E installation of the Tivoli Management Services components on z/OS. v Configuring the Tivoli Enterprise Monitoring Server on z/OS, SC32-9463Gives detailed instructions for using the Configuration Tool to configure Tivoli Enterprise Monitoring Server on z/OS systems. Includes scenarios for using batch mode to replicate monitoring environments across the z/OS enterprise. Also provides instructions for setting up security and for adding application support to a Tivoli Enterprise Monitoring Server on z/OS. v Administrator's Guide, SC32-9408 Describes the support tasks and functions required for the Tivoli Enterprise Portal Server and clients, including Tivoli Enterprise Portal user administration. v High-Availability Guide for Distributed Systems, SC23-9768 Gives instructions for several methods of ensuring the availability of the IBM Tivoli Monitoring components. v Tivoli Enterprise Portal online help Provides context-sensitive reference information about all features and customization options of the Tivoli Enterprise Portal. Also gives instructions for using and administering the Tivoli Enterprise Portal. v Tivoli Enterprise Portal User's Guide, SC32-9409 © Copyright IBM Corp. 2010, 2012 263 v v v v v v Complements the Tivoli Enterprise Portal online help. The guide provides hands-on lessons and detailed instructions for all Tivoli Enterprise Portal features. Command Reference, SC32-6045 Provides detailed syntax and parameter information, as well as examples, for the commands you can use in IBM Tivoli Monitoring. Troubleshooting Guide, GC32-9458 Provides information to help you troubleshoot problems with the software. Messages, SC23-7969 Lists and explains messages generated by all IBM Tivoli Monitoring components and by z/OS-based Tivoli Management Services components (such as Tivoli Enterprise Monitoring Server on z/OS and TMS:Engine). IBM Tivoli Universal Agent User's Guide, SC32-9459 Introduces you to the IBM Tivoli Universal Agent, an agent of IBM Tivoli Monitoring. The IBM Tivoli Universal Agent enables you to use the monitoring and automation capabilities of IBM Tivoli Monitoring to monitor any type of data you collect. IBM Tivoli Universal Agent API and Command Programming Reference Guide. SC32-9461 Explains the procedures for implementing the IBM Tivoli Universal Agent APIs and provides descriptions, syntax, and return status codes for the API calls and command-line interface commands. Agent Builder User's Guide, SC32-1921 Explains how to use the Agent Builder for creating monitoring agents and their installation packages, and for adding functions to existing agents. Documentation for the base agents If you purchased IBM Tivoli Monitoring as a product, you received a set of base monitoring agents as part of the product. If you purchased a monitoring agent product (for example, an OMEGAMON XE product) that includes the commonly shared components of Tivoli Management Services, you did not receive the base agents. The following publications provide information about using the base agents. v Operating system agents: – Windows OS Agent User's Guide, SC32-9445 – UNIX OS Agent User's Guide, SC32-9446 – Linux OS Agent User's Guide, SC32-9447 – i5/OS Agent User's Guide, SC32-9448 – UNIX Log Agent User's Guide, SC32-9471 v Agentless operating system monitors: – Agentless Monitoring for Windows Operating Systems User's Guide, SC23-9765 – Agentless Monitoring for AIX Operating Systems User's Guide, SC23-9761 – Agentless Monitoring for HP-UX Operating Systems User's Guide, SC23-9763 – Agentless Monitoring for Solaris Operating Systems User's Guide, SC23-9764 – Agentless Monitoring for Linux Operating Systems User's Guide, SC23-9762 v Warehouse agents: – Warehouse Summarization and Pruning Agent User's Guide, SC23-9767 – Warehouse Proxy Agent User's Guide, SC23-9766 v System P agents: – AIX Premium Agent User's Guide, SA23-2237 – CEC Base Agent User's Guide, SC23-5239 264 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference – HMC Base Agent User's Guide, SA23-2239 – VIOS Premium Agent User's Guide, SA23-2238 v Other base agents: – Monitoring Agent for IBM Tivoli Monitoring 5.x Endpoint User's Guide, SC32-9490 Related publications You can find useful information about related products in the IBM Tivoli Monitoring and OMEGAMON XE Information Center at http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/index.jsp. Other sources of documentation You can also obtain technical documentation about IBM Tivoli Monitoring and related products from the following sources: v IBM Tivoli Open Process Automation Library (OPAL) http://www.ibm.com/software/tivoli/opal OPAL is an online catalog that contains integration documentation and other downloadable product extensions. v Redbooks http://www.redbooks.ibm.com/ IBM Redbooks® and Redpapers include information about products from platform and solution perspectives. v Technotes Technotes provide the latest information about known product limitations and workarounds. You can find Technotes through the IBM Software Support website at http://www.ibm.com/software/support/ probsub.html, or more directly through your product website, which contains a link to Technotes (under Solve a problem). v Tivoli wikis on the IBM developerWorks® website Tivoli Wiki Central at http://www.ibm.com/developerworks/wikis/display/tivoli/Home is the home for interactive wikis that offer best practices and scenarios for using Tivoli products. The wikis contain white papers contributed by IBM employees, and content created by customers and business partners. Two of these wikis are of particular relevance to IBM Tivoli Monitoring: – Tivoli Distributed Monitoring and Application Management Wiki at http://www.ibm.com/ developerworks/wikis/display/tivolimonitoring/Home provides information about IBM Tivoli Monitoring and related distributed products, including IBM Tivoli Composite Application Management products. – Tivoli System z® Monitoring and Application Management Wiki at http://www.ibm.com/ developerworks/wikis/display/tivoliomegamon/Home provides information about the OMEGAMON XE products, NetView for z/OS, Tivoli Monitoring Agent for z/TPF, and other System z monitoring and application management products. Documentation library 265 266 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Support information If you have a problem with your IBM software, you want to resolve it quickly. IBM provides the following ways for you to obtain support: Online Go to the IBM Software Support site at http://www.ibm.com/software/support/probsub.html and follow the instructions. IBM Support Assistant The IBM Support Assistant (ISA) is a free local software serviceability workbench that helps you resolve questions and problems with IBM software products. The ISA provides quick access to support-related information and serviceability tools for problem determination. To install the ISA software, go to http://www.ibm.com/software/support/isa. Troubleshooting Guide For more information about resolving problems, see the product's Troubleshooting Guide. © Copyright IBM Corp. 2010, 2012 267 268 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Notices This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan, Ltd. 1623-14, Shimotsuruma, Yamato-shi Kanagawa 242-8502 Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement might not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM websites are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. © Copyright IBM Corp. 2010, 2012 269 Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. Trademarks IBM, the IBM logo, and ibm.com® are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at “Copyright and trademark information” at www.ibm.com/legal/copytrade.shtml. Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Other company, product, and service names may be trademarks or service marks of others. 270 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Glossary A activity. One phase within a sequence of predefined steps called a policy that automate system responses to a situation that has fired (that is, become true). administration mode. See workspace administration mode. Advanced Encryption Standard. An encryption algorithm for securing sensitive but unclassified material designed by the National Institute of Standards and Technology (NIST) of the U.S. Department of Commerce. AES is intended to be a more robust replacement for the Data Encryption Standard. The specification calls for a symmetric algorithm (in which the same key is used for both encryption and decryption), using block encryption of 128 bits and supporting key sizes of 128, 192 and 256 bits as a minimum. The algorithm must offer security of a sufficient level to protect data for the next 20 to 30 years. It had to be easily implemented in hardware and software and had to offer good defenses against various attack techniques. AES has since been published as Federal Information Processing Standard (FIPS) 197, which specifies the encryption algorithm that all sensitive, unclassified documents must use. AES. See Advanced Encryption Standard. affinity. A label that classifies objects by managed system. agent. Software installed on systems you want to monitor that collects data about an operating system, subsystem, or application running on each such system. Because an executable gathers information about a single managed system, there is always a one-to-one correspondence between them. agentless monitor. An agentless monitor uses a standard API (such as SNMP or CIM) to identify and notify you of common problems with the operating system of the computer running the API. Thus, as their name implies, the agentless monitors can retrieve monitoring and performance data without requiring OS agents on the computers being monitored: An agentless monitor enables you to monitor a remote, distributed node without first installing any Tivoli Management Services code on it. The agentless monitors provide monitoring, data gathering, and event management for Windows, Linux, AIX®, HP-UX, and Solaris systems. agentless monitoring server. A computer with an OS agent installed that has one or more agentless monitors running on it. Each agentless monitoring server can support up to 10 active instances of the various types of agentless monitors, in any combination. Each instance can communicate with up to 100 remote nodes, which means a single agentless monitoring server can support as many as 1000 monitored systems. alert. A warning message that appears at a console to indicate that something has occurred that may require intervention. alert monitor. A special type of monitoring agent that collects and relays alert information to the monitoring server. Sources of alerts include message logs, system console logs, and network and system management products. algorithm. A set of well-defined rules for the solution of a problem in a finite number of steps. For example, a full statement of an arithmetic procedure for evaluating sin(x) to a stated precision. API. See Application Programming Interface. application. A software component or collection of software components that performs specific user-oriented work on a computer. Application Programming Interface. A set of multiple subprograms and data structures and the rules for using them that together enable application development using a particular language and, often, a particular operating environment. An API is a functional interface supplied by the operating system or by a separately licensed program that allows an application program written in a high-level language to use specific data or functions of the operating system or the licensed program. arithmetic expression. A statement containing any combination of values joined together by one or more arithmetic operators in such a way that the statement can be processed as a single numeric value. © Copyright IBM Corp. 2010, 2012 271 arithmetic operator. A symbol representing a mathematical operation (addition, subtraction, multiplication, division, or exponentiation), such as +, -, *, /, or ^. associate. The process of linking a situation with a Navigator item that enables a light to go on and a sound to play for an open event. Predefined situations are associated automatically, as are situations created or edited through the Navigator item pop-up menu. When you open the Situation editor from the toolbar, any situations you create cannot be associated with a Navigator item during this editing session. You must close the Situation editor, then open it again from the pop-up menu of the Navigator item with which the situation should be associated. attribute. (1) A system or application element being monitored by the monitoring agent, such as Disk Name and Disk Read/Writes Per Second. (2) A characteristic of a managed object; that is, a field in the data structure of a managed object or in the workspace associated with that managed object. (3) A field in an ODBC-compliant database. attribute group. A set of related attributes that can be combined in a data view or a situation. When you open the view or start the situation, data samples of the selected attributes are retrieved. Each type of monitoring agent has its own set of attribute groups. autonomous-mode monitoring agents. These monitoring agents run without communicating directly with a Tivoli Enterprise Monitoring Server. An autonomous agent can emit Simple Network Management Protocol (SNMP) traps and Event Integration Facility (EIF) events directly to an OMNIbus ObjectServer for private situations (but not for enterprise situations) that have turned true. B baroc files. Basic Recorder of Objects in C files define event classes for a particular Tivoli Enterprise Console event server. Baroc files also validate event formats based on these event-class definitions. browser client. The software installed with the Tivoli Enterprise Portal Server that is downloaded to your computer when you start the Tivoli Enterprise Portal in browser mode. The browser client runs under the control of the Tivoli Enterprise Portal Server's integral web server within a Web browser. C capacity planning. The process of determining the hardware and software configuration required to accommodate the anticipated workload on a system. chart. A graphical view of data returned from a monitoring agent. A data point is plotted for each attribute chosen and, for bar and pie charts, a data series for each row. Types of charts include pie, bar, plot, and gauge. CIM. See Common Information Model. class file. A file containing Java™ object code for a single Java object class. class loader. A Java component that loads Java class files. client. An application that receives requested data from a server. client/server architecture. An architecture in which the client (usually a personal computer or workstation) is the machine requesting data or services and the server is the machine supplying them. Servers can be microcomputers, minicomputers, or mainframes. The client provides the user interface and may perform application processing. In IBM Tivoli Monitoring, the Tivoli Enterprise Portal is the client to the Tivoli Enterprise Portal Server, whereas the Tivoli Enterprise Portal Server is the client to the Tivoli Enterprise Monitoring Server. On the other hand, in IBM Tivoli Business Service Manager (TBSM), the Tivoli Enterprise Portal Server is the client to the Tivoli Enterprise Monitoring Server (as before) and the server to the Tivoli Integrated Portal. A database server maintains the databases and processes requests from the client to extract data from or to update the database. An application server provides additional business-support processing for its clients. Common Information Model. An XML-based standard for defining device and application characteristics so that system administrators and management programs can monitor and control them using the same set of tools, regardless of their differing architectures. CIM provides a more comprehensive toolkit for such management functions than the Simple Network Management Protocol. 272 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Common Object Request Broker Architecture. An industry specification for the design and standardization of different types of object request brokers (ORBs). ORBs allow different computers to exchange object data; CORBA enables ORBs from different software vendors (often running under dissimilar computer systems and operating systems) to exchange object data. CORBA is an architecture and specification that facilitates communication among program components in a network using objects. The Tivoli Enterprise Portal Server is a CORBA implementation. condition. An expression that evaluates to either true or false. It can be expressed in natural language text, in mathematically formal notation, or in a machine-readable language. Configuration Tool, z/OS (ICAT). A REXX-based tool for configuring OMEGAMON XE products running on zSeries® systems, once they have been installed using the System Modification Program/Extended (SMP/E) tool. Configure History permission. Your user ID must have Configure History permission to open the History Collection Configuration window for setting up history files and data rolloff. If you do not have this permission, you will not see the menu item or tool for historical configuration. CORBA. See Common Object Request Broker Architecture. critical state. The indication that a situation associated with a Navigator item is in an unacceptable state and that you must take corrective action. The critical state is represented by the color red. Custom Navigator Views permission. Your Tivoli Enterprise Portal user ID has a Modify checkbox for the Custom Navigator Views feature. This permission must be enabled for you to open the Navigator view editor to maintain and update Navigator views. D Data Encryption Standard. A widely used method of private-key data encryption that originated at IBM in 1977 and was adopted by the U.S. Department of Defense. DES supports 72 quadrillion or more possible encryption keys; for each message, the key is chosen at random from among this enormous number of possible keys. Like all other private-key cryptographic methods, both the sender and the receiver must know and use the same private key. DES applies a 56-bit key to each 64-bit block of data. Although this is considered strong encryption, many companies use triple DES, which applies three keys in succession. data warehouse. A central repository for the data that an organization's business systems collect. A data warehouse usually comprises multiple databases. The data warehouse used by IBM Tivoli Monitoring is called the Tivoli Data Warehouse. database. A collection of both interrelated and independent data items that is stored together on a computer disk to serve multiple applications. datasource name (DSN). The name that is stored in the database server and that enables you to retrieve information from the database through ODBC. The DSN includes such information as the database name, database driver, user ID, and password. datasources. Data pertaining to J2EE data sources, which are logical connections to database subsystems. DB2® for the workstation. IBM's DB2 Database for Linux, UNIX, and Windows systems is a relational database management system that runs on desktop computers. You install a DB2 database on the same system as the Tivoli Enterprise Portal Server; it stores the portal server's queries, customized workspaces, user IDs, and custom Navigator views. DB2 Database for Linux, UNIX, and Windows can also serve as the data repository for the Tivoli Data Warehouse, which provides long-term storage of historical monitoring information. default. An attribute, value, or option whose setting is assumed when none is explicitly specified. Demilitarized Zone. The area of a Worldwide Web application that enables a company to host Internet services without allowing unauthorized access. Derby. An open-source, public-domain, relational database management system implemented in Java and designed to conform to accepted database standards (such as SQL and JDBC) and yet still feature a small machine footprint. Derby came about when IBM contributed its Cloudscape database manager to the Apache project. IBM Tivoli Glossary 273 Monitoring implements Derby as an embedded database within its Tivoli Enterprise Portal Server; in other words, the database is installed with the portal server, and it runs within the portal server's Java virtual machine. DES. See Data Encryption Standard. desktop client. Software supplied with IBM Tivoli Monitoring that you install on a workstation that you plan to use for interacting with the Tivoli Enterprise Portal Server and the Tivoli Enterprise Monitoring Server. The desktop Tivoli Enterprise Portal client provides the graphical user interface into the IBM Tivoli Monitoring network. detailed attribute name. The name used in formulas, expert advice, Take Action commands, and headers and footers when referencing a monitoring agent attribute. In the Properties and Situation editors, first click Show Formula, then check Show detailed formula to see the detailed attribute name. display item. An attribute designated to further qualify a situation. With a display item set for a multiple-row attribute group, the situation continues to look at the other rows in the sample and opens more events if other rows qualify. The value displays in the event workspace and in the message log and situation event console views. You can select a display item when building a situation with a multiple-row attribute group. distribution. The managed systems on which the situation is running. DLL. See Dynamic Link Library. DMZ. See Demilitarized Zone. drill down. To access information by starting with a general category and moving through the hierarchy of information, for example, in a database, to move from file to record to field. DSN. See datasource name. DVIPA. See Dynamic Virtual IP Addressing. Dynamic Link Library. A composite of one or more executable objects that is bound together by a linking procedure and loaded at run time (rather than when the application is linked). The code and data in a dynamic link library can be shared by several applications simultaneously. DLLs apply only to Windows operating environments. Dynamic Virtual IP Addressing. This feature of IP allows System Z to reassign IP addresses in event of a failure in an application, TCP/IP stack, or LPAR. E EIB. See Enterprise Information Base. EIF. See Event Integration Facility. endcode. You assign endcodes in a policy as you connect one activity to another. The endcode indicates the result of this activity that will trigger the next activity. enhanced 3270 user interface. The OMEGAMON enhanced 3270 user interface is the latest generation of user interfaces for the OMEGAMON Monitoring Agents. Used in conjunction with the Tivoli Enterprise Monitoring Server, this new 3270-based user interface enables you to monitor the performance of your site’s z/OS systems, applications, and devices and helps you identify and troubleshoot problems with those monitored resources. The OMEGAMON Monitoring Agents that support the enhanced 3270 user interface provide predefined workspaces that enable you to quickly and easily diagnose problems with monitored resources and then invoke the appropriate Take Action commands to correct them. You can customize the workspaces to suit your requirements, and even design and create your own workspaces and navigation. Because the enhanced 3270 user interface exploits data collected by OMEGAMON Monitoring Agents, viewing data in the interface requires at least one Tivoli Enterprise Monitoring Server running in your environment, as well as monitoring agents that support the interface. When you navigate to a particular agent’s workspace, one or more data queries are sent to the monitoring server; the monitoring server collects the data from the target agent or agents and sends the data to the interface for display via the workspace. 274 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Enterprise Information Base. A database used by the Tivoli Enterprise Monitoring Server that serves as a repository of shared objects for all systems across your enterprise. The EIB stores all persistent data, including situations, policies, user definitions, and managed-object definitions. enterprise situation. A situation that is created for a Tivoli Enterprise Monitoring Agent that reports events to the Tivoli Enterprise Monitoring Server it connects to. Enterprise situations are centrally defined at the monitoring server and distributed at agent startup. See also private situation. event. An action or some occurrence, such as running out of memory or completing a transaction, that can be detected by a situation. Events cause a change in the state of a managed object associated with a situation, thereby making the situation true and causing an alert to be issued. event indicator. The colored icon that displays over a Navigator item when an event opens for a situation. Event Integration Facility. An application programming interface that external applications can invoke to create, send, or receive Tivoli Enterprise Console events. These events are referred to as either EIF events or TEC/EIF events. event item. A Navigator item that shows when you open the event workspace for a true situation (by selecting it from the event flyover list or from the situation event console pop-up menu). event sound. The sound file that plays when an event opens. This sound file is set in the Situation editor when the situation is associated with a Navigator item and can differ for different Navigator items. expert advice. A description within the Situation editor of each situation provided with a monitoring agent to help you quickly understand and interpret events that arise when situations becomes true. Extensible Markup Language. A data-description language derived from Standard Generalized Markup Language (SGML). A tool for encoding messages so they describe their own fields, XML allows you to format a document as a data structure. As program objects, such documents can have their contents and data hidden within the object; this allows you to control who can manipulate the document and how. In addition, documents can carry with them the object-oriented procedures called methods. The XML standard aids in exchanging data between local and remote applications and users. F filter criteria. These limit the amount of information returned to the data view in response to a query. You can apply a prefilter to the query to collect only certain data, or apply a postfilter to the view properties to show only a selected subset of the information collected. fix pack. A tested collection of all cumulative maintenance for a product, up to the release of the fix pack. It can also contain fixes that have not been shipped previously, but it should contain no new function. G georeferenced map. A special type of graphic that has built-in knowledge of latitude and longitude and can be zoomed into and out of quickly. The Tivoli Enterprise Portal uses proprietary .IVL files generated with the map-rendering component. These files cannot be opened or saved in a graphic editor. GSKit. The Global Security Toolkit provides SSL (Secure Sockets Layer) processing within protocols such as SPIPE and HTTPS. On z/OS systems, GSKit is known as the Integrated Cryptographic Service Facility, or ICSF. H hierarchical. Describes data that is organized on computer systems using a hierarchy of containers, often called folders (that is, directories) and files. In this scheme, folders can contain other folders and files. The successive creation of folders within folders defines the levels of organization, which is the hierarchy. Glossary 275 historical collection. A definition for collecting and storing data samples for historical reporting. The historical collection identifies the attribute group, any row filtering you have assigned, the managed system distribution, frequency of data collection, where to store it for the short term, and whether to save data long term (usually to the Tivoli Data Warehouse). historical data management. The procedures applied to short-term binary history files that roll off historical data to either the Tivoli Data Warehouse or to delimited text files (the krarloff utility on UNIX or Windows; ddname KBDXTRA for the z/OS Persistent Datastore), and then delete entries in the short-term history files over 24 hours old, thereby making room for new entries. hot standby. A redundant Tivoli Enterprise Monitoring Server running on a distributed system that, if the primary or hub monitoring server should fail, assumes the responsibilities of the failed monitoring server. HTTP. The Hypertext Transfer Protocol is a suite of Internet protocols that transfer and display hypertext documents within web browsers. HTTP sessions. Data related to invocations of specific Worldwide Web sites. HTTPS. The Secure Hypertext Transport Protocol is an implementation of the Hypertext Transport Protocol (HTTP) that relies on either the Secure Sockets Layer (SSL) API or the Transport Layer Security (TLS) API to provide your users with secure access to your site's web server. These APIs encrypt and then decrypt user page requests as well as the pages returned by the web server. hub monitoring server. (1) A central host system that collects the status of situations running on your systems. (2) The Tivoli Enterprise Monitoring Server that your site has selected to act as the focal point to which all portal servers and remote monitoring servers in this monitored network connect. A remote monitoring server passes its collected data to the hub to be made available to clients, creating an enterprise-wide view. I IBM Tivoli Monitoring. A client/server implementation for monitoring enterprise-wide computer networks that comprises a Tivoli Enterprise Monitoring Server, an application server known as the Tivoli Enterprise Portal Server, one or more Tivoli Enterprise Portal clients, and multiple monitoring agents that collect and distribute data to the monitoring server. IBM Tivoli Monitoring also provides a data warehouse, the Tivoli Data Warehouse, where historical monitoring data can be accumulated for later trend analysis and long-term problem identification. IIOP. See Internet Inter-ORB Protocol. input data. Data provided to the computer for further processing. See also output data. integral web server. A proprietary web server developed for IBM Tivoli Monitoring that is installed and configured automatically with the Tivoli Enterprise Portal Server. You enter the URL of the integral web server to start the Tivoli Enterprise Portal client in browser mode. Internet Inter-ORB Protocol (IIOP). An Internet communications protocol that runs on distributed platforms. Using this protocol, software programs written in different programming languages and running on distributed platforms can communicate over the Internet. IIOP, a part of the CORBA standard, is based on the client/server computing model, in which a client program makes requests of a server program that waits to respond to client requests. With IIOP, you can write client programs that communicate with your site's existing server programs wherever they are located without having to understand anything about the server other than the service it performs and its address (called the Interoperable Object Reference, IOR, which comprises the server's port number and IP address). Interoperable Object Reference (IOR). Connects clients to the Tivoli Enterprise Portal Server. The IOR identifies a remote object, including such information as name, capabilities, and how to contact it. The URL may include an IOR because it goes through the web server; the portal server uses it to tell the client which IOR to fetch. Once it does that, the portal server extracts the host and port information and tells the client where to route the request. interval. The number of seconds that have elapsed between one sample and the next. A sample is the data that the Tivoli Enterprise Monitoring Agent collects for the monitoring server. IOR. See Interoperable Object Reference. 276 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference J Java Database Connectivity (JDBC). A standard API that enables application developers to access and update relational databases (RDBMSes) from within Java programs. The JDBC standard is based on the X/Open SQL Call Level Interface (CLI) and complies with the SQL-92 Entry Level standard; it provides a DBMS-independent interface that enables SQL-compliant database access for Java programmers. Java Management Extensions (JMX) API . A set of Java classes for application and network management in J2EE environments. JMX provides Java programmers a set of native Java tools called MBeans (managed beans) that facilitate network, device, and application management. JMX provides a Java-based alternative to the Simple Network Management Protocol. JDBC. See Java Database Connectivity. JMX. See Java Management Extensions API. L LDAP. See Lightweight Directory Access Protocol. Lightweight Directory Access Protocol. A protocol that conforms to the International Standards Organization's X.500 directory standard and uses TCP/IP to access directory databases where applications can store and retrieve common naming and location data. For example, applications can use LDAP to access such directory information as email addresses, service configuration parameters, and public keys. location broker. The component of the Tivoli Enterprise Monitoring Server that manages connections for the hub monitoring server, enabling it to find all other IBM Tivoli Monitoring components, including remote monitoring servers, the Tivoli Enterprise Portal Server, and monitoring agents. M managed object. An icon created in the Tivoli Enterprise Portal from a managed object template that represents resources you monitor using situations. Managed objects are converted to items in the Navigator's Logical view. managed system. A particular operating system, subsystem, or application in your enterprise where a monitoring agent is installed and running. This is any system that IBM Tivoli Monitoring is monitoring. managed system group. A named, heterogeneous group of both similar and dissimilar managed systems organized for the distribution of historical collections, situations, and policies, and for assignment to queries and items in custom Navigator views. For example, you might create a managed system group named IT_London for a geographic region and another named Credit_Approval for a functional area of your organization. Managed system groups are created, modified, or deleted either by the Tivoli Enterprise Portal's Object Group editor or via the tacmd CLI command with the createsystemlist, editsystemlist, or deletesystemlist keywords; they are maintained by the Tivoli Enterprise Monitoring Server. If a managed system group is updated (usually when a constituent managed system is added or deleted), then all the historical collections, situations, and policies that use that group are redistributed to all managed systems in the group. MBeans. Managed beans are Java objects that represent managed resources such as devices, services, and applications. The management functions are provided by the MBean server. MDM. See Multidomain Management. method. In object-oriented programming, the software that implements an object's behavior as specified by an operation. Microsoft Management Console. This feature of Microsoft's various Windows Server environments provides a centralized, consistent, and extensible interface to Windows' various monitoring and management utilities. In particular, MMC manages directory services, job scheduling, event logging, performance monitoring, and user environments. Glossary 277 middleware. Software that enables the exchange of information between components in a distributed computing environment. The middleware is the data-exchange and communications channel that allows programs to cooperate with each other without having to know details about how they are implemented or where they are deployed. Middleware typically provides a range of related facilities such as persistence, auditing, and the ability to build a transactional unit of work. IBM's CICS and WebSphere® MQ are examples of middleware. migrating. Preserving your customized configuration data so that you can use it again after installing a newer version of the product. MMC. See Microsoft Management Console. monitor. An entity that performs measurements to collect data pertaining to the performance, availability, reliability, or other attributes of applications or the systems on which those applications rely. These measurements can be compared to predefined thresholds. If a threshold is exceeded, administrators can be notified, or predefined automated responses can be performed. monitor interval. A specified time, scalable to seconds, minutes, hours, or days, for how often the Tivoli Enterprise Monitoring Server checks to see if a situation has become true. The minimum monitor interval is 30 seconds; the default is 15 minutes. monitoring. Running a hardware or software tool to monitor the performance characteristics of a system. Multi-domain Management (MDM). This feature gives you the ability to administer multiple IBM Tivoli Monitoring domains from a single, central location. This type of management consolidates Tivoli Monitoring configuration artifacts into a central database where they can be managed independently of the monitoring server. Your hub monitoring server operations will be generalized across multiple IBM Tivoli Monitoring domains. MDM has the following capabilities: v Promotion of existing configuration artifacts from an editor domain into a standard store. v Export of configuration artifacts from multiple IBM Tivoli Monitoring domains into a single relational database under a single namespace for management and reporting purposes. v Import of configuration artifacts into multiple IBM Tivoli Monitoring domains. v Ease of monitoring agent migration operations, configuration changes, and compliance with configuration standards. v Server-side audit of all operations. N namespace. A namespace uniquely identifies a set of names so that there is no ambiguity when objects having different origins but the same names are mingled. For example, within the Extensible Markup Language (XML), an XML namespace is a collection of element type and attribute names. These element types and attribute names are uniquely identified by the name of the unique XML namespace that contains them. In an XML document, any element type or attribute name can thus require a two-part name consisting of the name of its namespace and then its local (functional) name, separated by a colon (:). It is possible (and often desirable) to create multiple namespaces; this may be essential in environments where different sets of information are maintained in a common repository like LDAP. NAT. See Network Address Translation. Navigator. The upper-left pane of the Tivoli Enterprise Portal window from which individual workspaces can be selected and displayed (that is, double-clicked). The Navigator Physical view shows your network enterprise as a physical hierarchy of systems grouped by platform. You can also create other views to create logical hierarchies grouped as you specify, such as by department or function. Network Address Translation. A scheme used by local-area networks (LANs) to establish an internal and external set of IP addresses. Internal IP addresses are kept private and must be translated to and from the external addresses for outbound and inbound communications. NAT is often used in firewall configurations. Network File System. A client/server file system developed by Sun Microsystems that, once mounted (that is, made accessible), allows a user on an NFS client to view, store, and update files on a remote computer (the NFS server) as though they were on the user's own computer. The portion of the mounted file system that each user can access and in what ways is determined by the user's own file-access privileges and restrictions. 278 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference NFS. See Network File System. node. (1) In networking, a point capable of sending and receiving data. A node can be a device (such as a printer or workstation), a system, a storage location on a disk, or a single computer. (2) Any managed system, such as an AIX-based pSeries® server, that IBM Tivoli Monitoring is monitoring. A node can also be a managed system of subnodes, all of which are being managed as components of the primary node. non-agent bundles. These custom bundles let you remotely deploy components that need not connect to a Tivoli Enterprise Monitoring Server, such as those that support other Tivoli products like Netcool/OMNIbus. O object. An instance of a class, which comprises an implementation and an interface. An object reflects its original, holding data and methods and responds to requests for services. CORBA defines an object as a combination of state and a set of methods characterized by the behavior of relevant requests. ODBC. See Open Database Connectivity. OMEGAMON Dashboard Edition (DE). The OMEGAMON implementation that includes all the features of the Tivoli Enterprise Portal provided with OMEGAMON Extended Edition, plus application-integration components that facilitate an enterprise-wide view of your Series z computing environment. OMEGAMON DE's workspaces integrate the data from multiple OMEGAMON Monitoring Agents into one network-wide view. OMEGAMON Extended Edition (XE). The IBM Tivoli Monitoring implementation of a single OMEGAMON Monitoring Agent. OMEGAMON Extended Edition displays the monitoring data from each OMEGAMON Monitoring Agent independently, without integrating it into the enterprise-wide workspaces provided by OMEGAMON Dashboard Edition. OMEGAMON Monitoring Agent. The software process that probes a managed z/OS system or subsystem (such as CICS) for data. The monitoring agent sends that monitoring information back to the Tivoli Enterprise Monitoring Server and then on to the Tivoli Enterprise Portal Server to be formatted into table and chart views for display on a Tivoli Enterprise Portal client. OMEGAMON Tivoli Event Adapter (OTEA). The OMEGAMON Tivoli Event Adapter invokes the Event Integration Facility API to synchronize IBM Tivoli Monitoring events with the IBM Tivoli Enterprise Console product. OTEA is a component of the Tivoli Enterprise Monitoring Server; it forwards IBM Tivoli Monitoring events to Tivoli Enterprise Console and maps them to their corresponding Tivoli Enterprise Console event classes based on the situation name's suffix, either _Warning or _Critical. Integrating these products requires two parts: a Tivoli Enterprise Monitoring Server piece (included with IBM Tivoli Monitoring version 6.1 and subsequent releases) called the OMEGAMON Tivoli Event Adapter, and a Tivoli Enterprise Console piece called the Situation Update Forwarder (SUF) that is installed on the Tivoli Enterprise Console server. Open Database Connectivity (ODBC). A standard for accessing different database systems using procedural, non-object-based languages such as C. The Query editor enables you to write custom SQL queries for creating views that retrieve data from ODBC-compliant databases. operator. (1) The action to be performed on one or more attributes when evaluating an expression. The types of operators the Tivoli Enterprise Portal supports are arithmetic, comparison, Boolean, and logical. (2) The symbol (such as +, -, or *) that represents that operation (in these examples, addition, subtraction, multiplication). OTEA. See OMEGAMON Tivoli Event Adapter. output data. Data resulting from computer processing. See also input data. Glossary 279 P parameter. A value or reference passed to a function, command, or program that serves as input or to control actions. The value is supplied by a user or by another program or process. PDS. See Persistent Datastore. PerfMon. See Performance Monitor. performance. A major factor in measuring system productivity. Performance is determined by a combination of throughput, response time, and availability. performance analysis. The use of one or more performance tools to investigate the reasons for performance improvement or deterioration. Performance Monitor (PerfMon). The Windows Performance Monitor is an SNMP-based performance-monitoring tool for Windows environments. PerfMon monitors network elements such as computers, routers, and switches. Persistent Datastore (PDS). A set of z/OS data sets where the Tivoli Enterprise Monitoring Server running on z/OS stores historical monitoring data. platform. The operating system upon which the managed system is running, such as z/OS or Linux. The Tivoli Enterprise Portal Navigator's Physical mapping places the platform level under the Enterprise level. policy. A set of automated system processes that can perform actions, schedule work for users, or automate manual tasks, frequently in response to events. Policies are the IBM Tivoli Monitoring automation tool; they comprise a series of automated steps, called activities, whose order of execution you control. In most cases, a policy links a Take Action command to a situation that has turned true. Once begun, the policy's workflow progresses until all activities have been completed or until the Tivoli Enterprise Portal user manually stops the policy. You can create both policies that fully automate workflow strategies and those that require user intervention. As with situations, policies are distributed to the managed systems you want to monitor and to which you are sending commands. presentation files. Two files installed with the Tivoli Enterprise Portal Server, presentation.dat and presentation.idx, that store workspace definitions, link definitions, and terminal emulator scripts. private situation. A situation that is defined in an XML privateconfiguration file for the local Tivoli Enterprise Monitoring Agent or Tivoli System Monitor Agent and does not interact with a Tivoli Enterprise Monitoring Server. Events are viewed through the Agent Service Interface or can be sent as EIF events or SNMP alerts to a receiver. See also enterprise situation. product code. The three-letter code used by Tivoli Management Services to identify the product component. For example, the product code for IBM Tivoli Composite Application Manager for WebSphere Application Server is KWE. Properties editor. A multi-tabbed window for specifying the properties of the individual views that make up a workspace, as well as the general workspace properties. pure event. A pure event is one that occurs automatically, such as when a paper-out condition occurs on the printer or when a new log entry is written. Situations written to notify you of pure events remain true until they are manually closed or automatically closed by an UNTIL clause. See also sampled event. Q query. A particular view of specified attributes of selected instances of a set of managed-object classes, arranged to satisfy an end-user request. Queries are written using SQL. query permissions. The set of Tivoli Enterprise Portal Server authorities that allow your user ID to create or update queries. v If you do not see the Queries tool, your user ID does not have View or Modify Query permissions. v If you can see the tool but it is disabled, your user ID does not have Workspace Author Mode permission. v If you can open the Query editor but the tools are disabled, your user ID does not have Modify Query permission. 280 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference R remotemonitoring server. A remote Tivoli Enterprise Monitoring Server collects monitoring data from a subset of your site's monitoring agents and passes its collected data to the hub monitoring server to be made available to one or more Tivoli Enterprise Portal clients via the Tivoli Enterprise Portal Server, thereby creating an enterprise-wide view. remote deployment. IBM Tivoli Monitoring processes can deploy agents and other non-agent, Tivoli Management Services-based components to remote nodes without your having to sign onto those nodes and perform the installation and configuration steps yourself. Remote deployment requires two pieces on the destination node: (1) a bundle containing the component code and the instructions for installing/configuring it, and (2) an operating-system agent to read the bundle and perform the installation and configuration steps. Remote Procedure Call (RPC). A protocol based on the Open Software Foundation's Distributed Computing Environment (DCE) that allows one program to request services from a program running on another computer in a network. RPC uses the client/server model: the requesting program is the client, and the responding program is the server. As with a local procedure call (also known as a function call or a subroutine call), an RPC is a synchronous operation: the requesting program is suspended until the remote procedure returns its results. rolloff. The transfer of monitoring data to the Tivoli Data Warehouse. RPC. See Remote Procedure Call. RTE. See runtime environments. runtime environment (RTE). A group of execution libraries that provide an operational environment on a z/OS system. RTEs execute OMEGAMON products on a z/OS image. runtime libraries. A group of z/OS libraries in the runtime environment that the product uses when it is started and running. Runtime libraries provide an operational environment on a z/OS system. S sample. One block of monitoring data that a Tivoli Enterprise Monitoring Agent collects for a Tivoli Enterprise Monitoring Server. The interval is the time between data samplings. sampled event. Sampled events happen when a situation becomes true. Situations sample data at regular intervals. When the situation becomes true, it opens an event, which gets closed automatically when the situation goes back to false (or when you close it manually). See also pure event. Secure Sockets Layer. A security protocol for communication privacy that provides secure client/server conversations. security-enhanced Linux (SELinux). The National Security Agency's security-enhanced Linux is a set of patches to the Linux kernel plus utilities that together incorporate a strong, flexible mandatory access control (MAC) architecture into the kernel's major subsystems. SELinux enforces the separation of information based on confidentiality and integrity requirements, which allows attempts to tamper with or bypass application security mechanisms to be recorded and confines the damage caused by malicious or flawed applications. seed data. The product-provided situations, templates, policies, and other sample data included with a Tivoli Enterprise Monitoring Agent to initialize the Tivoli Enterprise Monitoring Server's Enterprise Information Base. Before you can use a particular monitoring agent, the monitoring server to which it reports must be seeded, that is, initialized with application data. self-describing agent. When you invoke a self-describing Tivoli Enterprise Monitoring Agent, the seed data necessary for the Tivoli Enterprise Monitoring Server to recognize and process data from that agent need no longer be "seeded" at installation into the agent's local monitoring server and then replicated out to the hub monitoring server and all other Tivoli Management Services components that require it (such as the Tivoli Enterprise Portal Server and the Tivoli Data Warehouse). Instead, this application support data can now be automatically replicated from the agent to its local monitoring server whenever the agent starts up. This means it is also no longer necessary Glossary 281 that you follow each seeding step by restarting all affected Tivoli Management Services components so they can recognize and process data generated by these newly installed or upgraded agents. After you activate the self-describing agents capability, application support is automatically refreshed whenever a newer version of a self-describing agent is detected. Also, components need not be recycled every time an update is applied (similarly, its situations, policies, and activities are automatically redistributed and restarted), nor is it necessary each time a newly updated agent connects to its monitoring server—each update is seeded once and only once. This means you need not interrupt your enterprise monitoring whenever you add a new self-describing agent or update an existing agent. This enhancement also means that no self-describing OMEGAMON Monitoring Agents' application data need be stored on distributed systems. A self-describing agent can be either a distributed agent running on Windows, UNIX, or Linux, or an OMEGAMON Monitoring Agent running on z/OS. server. An application that satisfies data and service requests from clients. Simple Network Management Protocol (SNMP). A TCP/IP transport-layer protocol for exchanging network management data and controlling the monitoring of network nodes in a TCP/IP environment. The SNMP software protocol facilitates communications between different types of networks. IBM Tivoli Monitoring uses SNMP messaging to discover the devices on your network and their availability. Simple Object Access Protocol (SOAP). The Simple Object Access Protocol is an XML-based interface that vendors use to bridge remote procedure calls between competing systems. SOAP makes it unnecessary for sites to choose between CORBA/Java/EJB and Microsoft's COM+. Because XML and SOAP are platform- and language-neutral, users can mix operating systems, programming languages, and object architectures yet maintain business-component interoperability across platforms: using SOAP, applications can converse with each other and exchange data over the Internet, regardless of the platforms on which they run. single sign-on. This feature lets your IBM Tivoli Monitoring users start other Tivoli web-enabled applications from any Tivoli Enterprise Portal client (desktop, browser, or Java Web start), or to start the portal client from those applications, without having to re-enter their user credentials (userid and password). For SSO to function, User Authentication must be configured through the Tivoli Enterprise Portal Server for an external LDAP registry (such as Microsoft Active Directory) that is shared by all participating Tivoli applications. All the participating applications must be configured for SSO and must belong to the same security domain and realm. situation. One or more monitored conditions running on a managed system. The set of conditions that, when met, creates an event. A situation comprises an attribute, function (such as Value of expression or Percent change in value), a relational operator such as greater than or equal to, and a value to be compared. It can be read as “If – system condition – compared to – value – is true”. An example of a situation is: If – value of CPU usage > 90% – TRUE. The expression “CPU usage > 90 is the situation condition. See also enterprise situation and private situation. Situation Event Forwarder. This component of Tivoli Management Services maps situation events to Event Integration Facility (EIF) events and uses the EIF interface to send the events to a Tivoli Enterprise Console Event Server or to an OMNIbus EIF probe(the EIF receivers). The event receivers receive the forwarded events, and expand and format them for the event servers. On the Tivoli Enterprise Console or OMNIbus console, users can view, acknowledge, or reset situation events. The updated situation status is returned to the originating hub monitoring server and reflected in the Tivoli Enterprise Console or OMNIbus console. Situation Update Forwarder (SUF). The Situation Update Forwarder is a Java- and CORBA-based background process for communication between IBM Tivoli Enterprise Console and a particular Tivoli Enterprise Monitoring Server running under IBM Tivoli Monitoring version 6.1 and subsequent releases. Your site must install this component on the Tivoli Enterprise Console server; for instructions, see the IBM Tivoli Enterprise Console Installation Guide on the IBM Tivoli Enterprise Console information center. SNMP. See Simple Network Management Protocol. SOAP. See Simple Object Access Protocol. sockets. Refers to the sockets method of passing data back and forth between a networked client and server or between program layers on the same computer. 282 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference sound. The WAV file that plays whenever a situation becomes true for the current Navigator item. Sound is assigned to the Navigator item for a situation in the same way a state is assigned. SPIPE. A secure pipe is an implementation of the Internet Protocol's pipe specification that uses the Secure Sockets Layer API. Using SPIPE, your corporate web server can securely access internal servers that are not based on the HTTPS protocol, while retaining their ability to process HTTP requests. SQL. See Structured Query Language. SSL. See Secure Sockets Layer. SSM. See System Service Monitors. SSO. See single sign-on. state. The severity of the situation event: critical, warning, or informational. Indicated by a colored event indicator, state is set in the Situation editor and can be different for different Navigator items. status. The true or false condition of a situation. Structured Query Language. A programming language for extracting information from and updating information within a relational database. The Query editor enables you to write SQL queries to ODBC-compliant datasources for retrieval and display in table and chart views. subnetwork. A configuration wherein a single IP network address is split up so it can be used on several interconnected local networks. Subnetworking is a local configuration; outside it appears as a single IP network. SUF. See Situation Update Forwarder. summarization and pruning agent. One of the IBM Tivoli Monitoring base agents, the summarization and pruning agent keeps the data warehouse from growing too large by summarizing and pruning your stored historical data at intervals that you set. For every attribute group that has data collection configured, you specify how often to aggregate (summarize) data in the Tivoli Data Warehouse and the length of time to pass before deleting (pruning) data from the warehouse. symbol. A variable that can be added to header or footer text for data views, expert-advice text, or query specifications. The detailed attribute name is enclosed in dollar signs, such as $ORIGINNODE$, and resolves to the attribute's value. For queries, == $NODE$ specifies the managed systems from which to retrieve data. For queries to be used in link target workspaces, you can create symbols for attributes using the $symbolname$ format. System Monitor Agent. These agents were introduced with IBM Tivoli Monitoring version 6.2.2 for nodes that run the desktop operating systems (Windows, Linux, UNIX). System Monitor Agents operate only autonomously (that is, they run without a connection to a Tivoli Enterprise Monitoring Server) and pass SNMP trap data about operating system performance to an SNMP Event Collector such as IBM Tivoli Netcool/OMNIbus. No other agents or other components should be installed on the same node as a System Monitor Agent. The only exception to this rule is agents created with the Agent Builder tool (V6.2.2 or later). System Service Monitors. The IBM Tivoli Netcool/OMNIbus product provides System Service Monitors that support basic system-level monitoring of network components such as operating systems. In addition, OMNIbus provides ISMs (Internet Service Monitors) and ASMs (Application Service Monitors). IBM System Z. Umbrella family name used when referring to multiple product lines or the IBM mainframe class of products in general. T Take Action. A Tivoli Enterprise Portal dialog from which you can enter a command to perform or choose from a list of predefined commands. It also lists systems on which to effect the command, which is usually a response to an event. Take Action command. A Take Action command allows you to send commands to your managed systems, either automatically, in response to a situation that has fired (that is, turned true), or manually, as the Tivoli Enterprise Portal operator requires. With Take Action commands, you can enter a command to execute or select one of the Glossary 283 commands predefined by your product and run it on any system in your managed network. Thus you can issue Take Action commands either against the managed system where the situation fired or a different managed system in your network. target libraries. SMP/E-controlled libraries that contain the data installed from the product-distribution media. task. A unit of work representing one of the steps in a process. TCP/IP. See Transmission Control Protocol/Internet Protocol. TDW. See Tivoli Data Warehouse. telnet. A terminal-emulation program used on TCP/IP networks. You can start a telnet session with another system and enter commands that execute on that system. A valid user ID and password for that remote system are required. TEPS/e. See Tivoli Enterprise Portal Server extended services. threshold. (1) A level set in the system at which a message is sent or an error-handling program is called. For example, in a user auxiliary storage pool, the user can set the threshold level in the system values, and the system notifies the system operator when that level is reached or exceeded. (2) A customizable value for defining the acceptable tolerance limits (maximum, minimum, or reference limit) for an application resource or system resource. When the measured value of the resource is greater than the maximum value, less than the minimum value, or equal to the reference value, an exception is raised. time-scheduling services. The Tivoli Common Reporting module uses the time-scheduling services to query and manage report schedules and tasks. timestamp. A data type that contains a seven-part value consisting of a date and a time expressed in years, months, days, hours, minutes, seconds, and microseconds. Tivoli Common Reporting. This reporting module allows a single point of access to reports generated by multiple products. It interacts with either the Business Intelligence and Reporting Tools (BIRT) Designer or with the Cognos® product for customizing reports and running defined reports. The time-scheduling service allows you to schedule report extraction and creation. Tivoli Data Warehouse (TDW). This member of the IBM Tivoli Monitoring product family stores Tivoli Monitoring agents' monitoring data in separate relational database tables so you can analyze historical trends using that enterprise-wide data. Reports generated from Tivoli Data Warehouse data provide information about the availability and performance of your monitoring environment over different periods of time. Tivoli Enterprise Monitoring Server. The host data-management component for IBM Tivoli Monitoring. It receives and stores monitoring data from either the agents or other monitoring servers and delivers it to the Tivoli Enterprise Portal Server, raises alerts when conditions specified in situations are met, receives Take Action commands from the Tivoli Enterprise Portal and passes them to the appropriate monitoring agents for execution, and (optionally) provides a repository for short-term historical data. The Tivoli Enterprise Monitoring Server can be installed on z/OS, Windows, Linux, and UNIX operating systems. Tivoli Enterprise Portal. The client component of a Tivoli Enterprise Portal Server. The Tivoli Enterprise Portal provides the graphical user interface into monitoring data collected by the Tivoli Enterprise Monitoring Server and prepared for user display by the portal server. The Tivoli Enterprise Portal comes in two versions: the desktop client and the browser client. Tivoli Enterprise Portal Server. The server you log onto that connects you to IBM Tivoli Monitoring via the Tivoli Enterprise Portal client. The Tivoli Enterprise Portal Server connects to the hub Tivoli Enterprise Monitoring Server and enables retrieval, manipulation, and analysis of data from your enterprise's monitoring servers. Tivoli Enterprise Portal Server extended services. An embedded, colocated extension of the Tivoli Enterprise Portal Server that provides J2EE-based Application Server integration facilities. TEPS/e supports a federated user repository built on the Lightweight Directory Access Protocol (LDAP). Tivoli Enterprise Services user interface extensions. A component provided as part of Tivoli Management Services running on distributed systems that provides access to the command line interface for other Tivoli Management Services components. This component includes the tacmd command, which is used for, among other things, administering the self-describing agents feature. The GUI installer on distributed operating systems automatically 284 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference installs this component when you install the Tivoli Enterprise Portal desktop client, the Tivoli Enterprise Portal Server, or the Tivoli Enterprise Monitoring Server. Additionally, it is an optional installable component of the Tivoli Enterprise Monitoring Agent component. The component code is KUE. The Tivoli Enterprise Services user interface extensions are not available on z/OS. Tivoli Enterprise Web Services. An open standards-based interface to the Tivoli Enterprise Monitoring Server that uses SOAP requests. Using SOAP, any monitoring agent can be dynamically queried, which means that its performance and availability data can be processed by external applications not a part of IBM Tivoli Monitoring. Tivoli Integrated Portal. The Tivoli Integrated Portal provides a single, task-based navigation panel for Web-based Tivoli products; it offers a common user interface with which you can launch applications, launch from one application to another, and share information between applications. It provides a rich, Web-based user interface with which you can access results generated by such applications as Tivoli Application Dependency Discovery Manager (TADDM), Tivoli Business Service Manager (TBSM), and Netcool/OMNIbus. The Tivoli Integrated Portal enables the secure passing of data between Tivoli products via this common portal. With it, you can manage different aspects of your enterprise from a single dashboard view. Tivoli Management Services. An integrated, layered architecture consisting of data-access, communication, and presentation components that enable cross-platform operation and integration of enterprise-wide data for systems-management applications. The software foundation that supports the development and operations of the Tivoli Enterprise Monitoring Server, the Tivoli Enterprise Portal Server and Tivoli Enterprise Portal, and their monitoring agents. Tivoli OMEGAMON Manager (TOM). The enhanced 3270 user interface’s address space. In any IBM Tivoli Monitoring environment where one or more OMEGAMON Monitoring Agents will exploit the enhanced 3270 user interface, a TOM must be configured in such a way that it shares a sysplex with at minimum one monitoring server or agent address space that is connected to that Tivoli Monitoring network’s hub monitoring server. From this one Tivoli Monitoring environment, a single TOM address space can manage multiple Tivoli Monitoring environments that contain other instances of the OMEGAMON Monitoring Agents. Each z/OS-based Tivoli Enterprise Monitoring Server or Tivoli Enterprise Monitoring Agent address space has a process running in it called KOBAGENT, which is the enhanced 3270 user interface’s data-retrieval agent (DRA). KOBAGENT uses Tivoli Management Services on z/OS to send your data requests to its hub monitoring server. When the address space running the TOM starts, it discovers each KOBAGENT process in the same sysplex; thus the TOM has access to multiple hub environments, since there may be multiple KOBAGENTs running in the sysplex that connect to different hub monitoring servers (and therefore different Tivoli Monitoring environments). The TOM requires only one KOBAGENT per hub, but if there are more, the TOM can determine over time which KOBAGENT has the best data throughput; it can also try alternate KOBAGENT instances if a request fails using the first KOBAGENT it selects. When users log on to a session in the TOM, they pick the Tivoli Monitoring environment they wish to work with and then start exploiting the various OMEGAMON agents running in that environment. Which agent data users can look at is determined by the hub Tivoli Enterprise Monitoring Server running in that environment. TOM. See Tivoli OMEGAMON Manager. Transmission Control Protocol/Internet Protocol (TCP/IP). An open, portable communications protocol that is the software basis for the Internet. TSO. Time Sharing Option, the interactive interface into the z/OS operating system. U UDP. See User Datagram Protocol. User Datagram Protocol. A TCP/IP communications protocol that exchanges messages ("datagrams") between networked computers linked by the Internet Protocol (IP). UDP is an alternative to the Transmission Control Protocol (TCP), which, like UDP, uses IP to move a message from one computer to another. Unlike TCP, however, UDP does not divide the message into packets and reassemble them at the other end. The Network File System uses UDP to move file contents and file updates between the NFS server and the NFS client. Glossary 285 V value of expression. A function in a situation condition, query specification, or data view filter or threshold that uses the raw value of an attribute. A value can be a number, text string, attribute, or modified attribute. Use this function with any operator. view. A window pane, or frame, in a Tivoli Enterprise Portal workspace. It displays agent data in a chart or table, or it may contain a terminal session or browser, for example. A view can be split into two separate, autonomous views. W warehouse proxy agent. One of the IBM Tivoli Monitoring base agents, the warehouse proxy agent passes data from either a monitoring agent or the Tivoli Enterprise Monitoring Server to the Tivoli Data Warehouse. This multi-threaded server process can handle concurrent requests from multiple monitoring agents to roll off data from their short-term history files to the data warehouse. WAV file. Waveform audio format for storing sound in files, developed jointly by Microsoft and IBM. wildcard. An * (asterisk) used to represent any characters that may follow or precede those entered, such as Sys* to locate System and SysTray. Used in formulas with the VALUE function or MISSING function (in the Missing Task List). Used also with the SCAN function, but at the beginning of the text as in *Z to find markZ and typeZ. Windows Management Instrumentation (WMI) API. Microsoft's Windows Management Instrumentation API provides a toolkit for managing devices and applications in a network of Windows-based computers. WMI provides both the data about the status of local or remote computer systems and the tools for controlling the data. WMI is included with the Windows XP and Windows Server 2003 operating systems. WMI. See Windows Management Instrumentation. workload. A percentage that shows how much of a computer's resources a managed system is using. Workload is calculated using a weighted combination of resource-use statistics. workspace. The viewing area of the Tivoli Enterprise Portal window, excluding the Navigator. Each workspace comprises one or more views. Every Navigator item has associated with it its own default workspace and perhaps multiple workspaces. workspace administration mode. A global parameter set in the Administer Users editor but which is available only for user IDs with administrator authority. When enabled for a user ID, customization of workspaces, links, and terminal-session scripts automatically becomes available to all users connected to the same Tivoli Enterprise Portal Server. X XML. See Extensible Markup Language. Z z/OS. IBM's operating system for its line of mainframe, Series z computers that can manage large amounts of memory, direct-access storage, and data. 286 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Index A about this information vii ACF2 macro library field 81 Address translation field 196 administration mode See workspace administration mode advanced agent configuration values monitoring agent KPP_AGT_ICU_LANGUAGE_LOCALE 14 KPP_AGT_WTO_MSG 41 Advanced Encryption Standard 271 AES See Advanced Encryption Standard Agent PPI sender field 25 Agent started task field 26 Agent to TEMS connection field 38 alert monitor 271 Alias name field 181 Allocation MGMTCLAS field 122 Allocation STORCLAS field 123 Allocation unit field 124 Allocation volume field 124 API See Application Programming Interface Application Programming Interface 271 application server 272 Application Service Monitors, Netcool/OMNIbus 283 Applid prefix field 39, 138, 148, 237 B Backup field 118 Backup TEMS name field 49 baroc files 272 Basic Recorder of Objects in C files 272 batch mode 2 batch parameters KPP_AGT_AUDIT_ITM_DOMAIN 7 KPP_AGT_AUDIT_MAX_HIST 8 KPP_AGT_AUDIT_TRACE 9 KPP_AGT_COMM_PROn 11 KPP_AGT_CONFIG 10 KPP_AGT_FLUSH_INT_HR 13 KPP_AGT_FLUSH_INT_MIN 14 KPP_AGT_ICU_LANG 14 KPP_AGT_KGL_WTO 16 KPP_AGT_KLX_TCP_RECYCLE 17 KPP_AGT_NONSTDn_DSN 19 KPP_AGT_NONSTDn_PARM 21 KPP_AGT_NSOLDn_VALUE 22 KPP_AGT_PIPE_NAME 23 KPP_AGT_PPI_RECEIVER 24 KPP_AGT_PPI_SENDER 25 KPP_AGT_STC 26 KPP_AGT_STOR_DTL_INT_HR 27 KPP_AGT_STOR_DTL_INT_MIN 28 KPP_AGT_STOR_MIN_EXT 29 KPP_AGT_TCP_HOST 30 KPP_AGT_TCP_STC 32 KPP_AGT_TEMA_SDA 33 © Copyright IBM Corp. 2010, 2012 batch parameters (continued) KPP_AGT_TEMS_NAME_NODEID 34 KPP_AGT_VIPA 35 KPP_AGT_VTM_APPL_AA 36 KPP_AGT_VTM_APPL_NCS 38 KPP_AGT_VTM_APPL_OPR 39 KPP_AGT_VTM_APPL_PREF 39 KPP_AGT_VTM_APPL_VPO 37 KPP_AGT_VTM_NODE 40 KPP_AGT_WTO_MSG 41 KPP_CMS_HUB_TCP_HOST 54 KPP_CMS_LOCAL_CONNECT 54 KPP_CMS_NAME 56 KPP_CMS_TCP_HOST 57 KPP_CMS_TCP_PIPE_PORT 58 KPP_CMS_TCP_PIPE6_PORT 60 KPP_CMS_TCP_PIPE6S_PORT 61 KPP_CMS_TCP_PIPES_PORT 59 KPP_CMS_TCP_UDP_PORT 62 KPP_CMS_TCP_UDP6_PORT 63 KPP_CMS_VTM_APPL_LLB 63 KPP_CMS_VTM_LU62_LOG 64 KPP_CMS_VTM_LU62_LOGTAB 65 KPP_CMS_VTM_NETID 66 KPP_CMSB_NAME 49 KPP_CMSB_TCP_HOST 50 KPP_CMSB_VTM_APPL_LLB 51 KPP_CMSB_VTM_LU62_LOG 52 KPP_CMSB_VTM_NETID 53 KPP_ICS_DATASET 95 Kpp_MQS_AUTHLIB 102 Kpp_MQS_LANGLIB 102 KPP_NONSTDnn_MBR 20 KPP_NSNEWn_VALUE 18 KPP_PD 42 KPP_PD_CYL 43 KPP_PD_GRP 44 KPP_PD_ROW 47 Kpp_TCP_DATA 101 Kpp_USS_EXEC 97 KD2_OMPE_DB2EXIT 87 KD2_OMPE_DB2LOADLIB_Vn 88 KD2_OMPE_DB2RUNLIB_Vn 89 KDF_HSM_LOG_DSN 94 KDO_DB2_LOADLIB 89 KDS_AUDIT_ITM_DOMAIN 157 KDS_AUDIT_MAX_HIST 157 KDS_AUDIT_TRACE 158 KDS_CMS_COMM_PROn 197 KDS_CMS_COMM_XLAT 196 KDS_CMS_CTSOAP 215 KDS_CMS_EIF 202 KDS_CMS_EIF_BFR_EVT 248 KDS_CMS_EIF_BFR_EVT_MAX 199 KDS_CMS_EIF_BFR_EVT_PATH 248 KDS_CMS_EIF_DISABLE_EMT 200 KDS_CMS_EIF_EVT_LISTENER 201 KDS_CMS_EIF_FLT_ATTR1 249 KDS_CMS_EIF_FLT_CLASS1 249 KDS_CMS_EIF_FLT_MODE 250 KDS_CMS_EIF_HOST 203 287 batch parameters (continued) KDS_CMS_EIF_PORT 204 KDS_CMS_EXT_LIM 219 KDS_CMS_FLUSH_INT_HR 204 KDS_CMS_FLUSH_INT_MIN 205 KDS_CMS_HA_EXCL_LIST 206 KDS_CMS_HA_TYP 206, 258 KDS_CMS_HTTP_PORT 207 KDS_CMS_ICU_LANG 208 KDS_CMS_KDC_DEBUG 210 KDS_CMS_KGL_WTO 211 KDS_CMS_KLX_TCP_RECYCLE 212 KDS_CMS_PART_NAME 213 KDS_CMS_SEC_ENC_KEY 214 KDS_CMS_SEC_VALIDATE 214 KDS_CMS_STC 216 KDS_CMS_STOR_DTL_INT_HR 216 KDS_CMS_STOR_DTL_INT_MIN 217 KDS_CMS_STOR_DTL_LOG 218 KDS_CMS_STOR_MIN_EXT 221 KDS_CMS_TCP_HOST 222 KDS_CMS_TCP_KDEBLST 223 KDS_CMS_TCP_PIPE_PORT 224 KDS_CMS_TCP_PIPE6_PORT 225 KDS_CMS_TCP_PIPE6S_PORT 226 KDS_CMS_TCP_PIPES_PORT 227 KDS_CMS_TCP_STC 228 KDS_CMS_TCP_UDP_PORT 229 KDS_CMS_TCP_UDP6_PORT 230 KDS_CMS_TYP 232 KDS_CMS_VIPA 233 KDS_CMS_VTM_APPL_CUA 233 KDS_CMS_VTM_APPL_DS 234 KDS_CMS_VTM_APPL_GLB 234 KDS_CMS_VTM_APPL_LLB 236 KDS_CMS_VTM_APPL_OPR 237 KDS_CMS_VTM_APPL_PREF 237 KDS_CMS_VTM_APPL_VPO 235 KDS_CMS_VTM_LOADLIB 98 KDS_CMS_VTM_LU62_LOG 238 KDS_CMS_VTM_LU62_LOGTAB 238 KDS_CMS_VTM_MACLIB 98 KDS_CMS_VTM_NETID 239 KDS_CMS_VTM_NODE 240 KDS_HFS_JAVA_DIRn 103 KDS_HUB_GLB_APPL 166 KDS_HUB_HA_TYP 165 KDS_HUB_TCP_HOST 159 KDS_HUB_TCP_PIPE_PORT 159 KDS_HUB_TCP_PIPE6_PORT 160 KDS_HUB_TCP_PIPE6S_PORT 161 KDS_HUB_TCP_PIPES_PORT 162 KDS_HUB_TCP_UDP_PORT 163 KDS_HUB_TCP_UDP6_PORT 164 KDS_HUB_VTM_NETID 166 KDS_KMS_SDA 167 KDS_MIG_TAPE_HILEV 168 KDS_MIG_TAPE_UNIT 168 KDS_MIG_TAPE_VOL 169 KDS_MIG_VER 170 KDS_MIG_VSAM_HILEV 170 KDS_NONSTDnn_DSN 171 KDS_NONSTDnn_MBR 172 KDS_NONSTDnn_PARM 173 KDS_NSNEWnn_VALUE 174 KDS_NSOLDnn_VALUE 175 KDS_PA 175 288 batch parameters (continued) KDS_PA_ADDR 176 KDS_PA_NAME 177 KDS_PA_ROW 177 KDS_PD 178 KDS_PD_CYL 178 KDS_PD_GRP 179 KDS_PD_ROW 180 KDS_PH 180 KDS_PH_CMS_ALIAS_NAME 181 KDS_PH_CMS_COMM_PRO1 182 KDS_PH_CMS_KSH_SECURE 183 KDS_PH_CMS_NAME 183 KDS_PH_CMS_RTE 184 KDS_PH_CMS_SYSV 184 KDS_PH_CMS_TCP_HOST 185 KDS_PH_CMS_TCP_HOST_LEN 186 KDS_PH_CMS_TCP_PORT 186 KDS_PH_CMS_USER_QUERY 187 KDS_PH_CMS_USER_UPDATE 187 KDS_PH_CMS_VTM_APPL_GLB 188 KDS_PH_CMS_VTM_LU62_LOG 189 KDS_PH_CMS_VTM_NETID 189 KDS_PH_ROW 181 KDS_PPI_RECEIVER 190 KDS_PPI_SENDER 191 KDS_PU 192 KDS_PU_CMS_NAME 193 KDS_PU_CMS_RTE 193 KDS_PU_CMS_USER_ID 194 KDS_PU_CMS_USER_QUERY 194 KDS_PU_CMS_USER_UPDATE 195 KDS_PU_ROW 192 KDS_TEMA_SDA 196 KDS_TEMS_DRA_FLAG 198 KDS_USS_EXEC 97 KGW_CTG_DLL_DSN 86 KI2_CLA_BMP_RESLIB 90 KI2_I1_CLA_IMS_RESLIB 90 KI5_ICT_SCEXLINK 91 KI5_ICT_SFUNLINK 92 KI5_IMS_RESLIB 90 KI5_X_ICT_IMS_CONNECT_FLAG 91, 92 KMC_CFG_MCDB2_LIB 89 KNA_NETV_LNKLIB 93 KOB_TOM_STC 259 KOB_TOM_VTAM_APPL_LOGON 260 KOB_TOM_VTAM_NODE 261 KPP_AGT_TCP_KDEBLST 31 KQI_CEE_LE370_LKED 83 KQI_CEE_LE370_RUN 85 KQI_CIC_LOADLIB 87 KQI_MQS_LOADLIB 103 PARMGEN parameter names KDS_HUB_TCP_PIPES_PORT_NUM 162 KDS_TEMS_STORAGE_MINIMUM_EXTEND RTE_SYSV_SYSVAR_FLAG 136 RTE_ACF2_MACLIB 81 RTE_BASE_MIDLEV 107 RTE_CAN_SS_IEFSSN_FMT 112 RTE_CAN_SS_STC 107 RTE_CAN_SS_WTO 113 RTE_CAN_SSID 113 RTE_CMS 141 RTE_CMS_NAME 142 RTE_CUA_SECURITY 127 RTE_DEBUG_SYSOUT 109 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference 221 batch parameters (continued) RTE_DESC 109 RTE_ETE_STC 108 RTE_FOLD_PWD 125, 126 RTE_HCK_INTERVAL 110 RTE_HCK_LOADLIB 90 RTE_HILEV 110 RTE_JCL_SUFF 111 RTE_KCNSTR00_XCFGROUP 114 RTE_LOAD_OPTIMIZE 115 RTE_LOAD_SHARED_LIBS 116 RTE_LOG_SYSOUT 116 RTE_NAME 117 RTE_PDS_BU 118 RTE_PDS_CNT 121 RTE_PDS_EXP 119 RTE_PDS_EXT 120 RTE_PDS_HILEV 121 RTE_PDS_PROC_PREF 122 RTE_PDS_SMS_MGMT_CLAS 122 RTE_PDS_SMS_STOR_CLAS 123 RTE_PDS_UNIT 124 RTE_PDS_VOL 124 RTE_PDSE 129 RTE_REMOTE 125 RTE_SHARE 128 RTE_SMS_MGMT_CLAS 129 RTE_SMS_STOR_CLAS 130 RTE_SMS_VSAM_MGMT_CLAS 132 RTE_SMS_VSAM_STOR_CLAS 133 RTE_STC_PREF 134 RTE_SYS_PROCLIB 96 RTE_SYS_VTAMLST 99 RTE_SYSV 136 RTE_SYSV_BASE_ALIAS 135 RTE_SYSV_CMS_NAME 137 RTE_SYSV_NAME 135 RTE_SYSV_VTM_APPL_MODEL 137 RTE_SYSV_VTM_APPL_PREF 138 RTE_SYSV_VTM_NETID 139 RTE_TCP_HOST 139 RTE_TCP_PORT 140 RTE_TCP_STC 141 RTE_TN3270_LUGROUP 144 RTE_TN3270_TCP_HOST 143 RTE_TN3270_TCP_PORT 144 RTE_TYP 145 RTE_UNIT 131 RTE_USERMODS 146 RTE_USS_RTEDIR 146 RTE_VOL 131 RTE_VSAM_HILEV 148 RTE_VSAM_VOL 133 RTE_VTM_APPL_PREF 148 RTE_VTM_CANDLE_NODE 149 RTE_VTM_LU62_LOG 150 RTE_VTM_LU62_LOGTAB 150 RTE_VTM_NETID 151 SYS1_MACLIB 94 TCP_DATA 101 browser client 272 BufEvtMaxSize parameter 199 BufEvtPath parameter 248 Buffer events maximum size field 199 BufferEvents parameter 248 C CIM See Common Information Model client/server architecture 272 CMS_NODEID parameter 142 CNMLINK load library 93 codepages, language locale 208 common agent parameters 7 Common Information Model 272 Common Object Request Broker Architecture 273 configuration flags 4 Configuration Tool defined 2 modes 2 Configuration Tool, z/OS 273 configured parameters storage 1 CONFIRM parameter 246 Connect to TEMS in this RTE field 54 CORBA See Common Object Request Broker Architecture Count field 121 D Data Encryption Standard 273 database server 272 Datastore group name field 44 Datastore high-level prefix field 121 ddname KBDXTRA 276 DEBUG parameter 247, 256 default values 2 DES See Data Encryption Standard Description field 109 desktop client 274 Diagnostic SYSOUT class field 109 Disable Workflow Policy/Emitter Agent event forwarding field 200 DLL See Dynamic Link Library DMZ See Demilitarized Zone DS_TEMS_VTAM_APPL_LLB_BROKER parameter 236 DSN See datasource name DSNAME field 90 DVIPA See Dynamic Virtual IP Addressing Dynamic Link Library 274 Dynamic Virtual IP Addressing 274 E EIB See Enterprise Information Base EIF See Event Integration Facility Enable communications trace field 210 Enable startup console messages field 16, 211 Enable storage detail logging field 218 Enable Tivoli Event Integration Facility (EIF) field Enable Web Services SOAP Server field 215 Enable WTO messages field 41 Enable/Disable z/OS audit collection field 158 encryption, password 87 202 Index 289 enhanced 3270 user interface 259 SAF security class name for 125 started task name for 259 Tivoli OMEGAMON Manager 259, 260, 261 VTAM logon APPLID for 260 VTAM node entry for 261 Enterprise Information Base 275 environment variables, defined 1 Est Cyl Space field 43, 178 event 275 Event Integration Facility 275 Event server location field 203 Event server port field 204 Event server type field 201 EventListenerType parameter 201 Export field 119 Extensible Markup Language 275 Extract field 120 F Federal Information Processing Standard 197 FilterMode parameter 250 FIPS 197 271 Flush VSAM buffers: Hours field 13, 204 Flush VSAM buffers: Minutes field 14, 205 Fold password to upper case field 126 FRAME parameter 244, 250 271 G GBL_DSN_ACF2_MACLIB parameter 81 GBL_DSN_CBC_SCCNOBJ parameter 81 GBL_DSN_CBC_SCLBSID parameter 82 GBL_DSN_CEE_SCEEBIND parameter 82 GBL_DSN_CEE_SCEEBND2 parameter 82 GBL_DSN_CEE_SCEECPP parameter 83 GBL_DSN_CEE_SCEELIB parameter 83 GBL_DSN_CEE_SCEELKED parameter 83 GBL_DSN_CEE_SCEELKEX parameter 84 GBL_DSN_CEE_SCEEMSGP parameter 84 GBL_DSN_CEE_SCEERUN parameter 85 GBL_DSN_CEE_SCEESPC parameter 85 GBL_DSN_CICS_CTG_DLL parameter 86 GBL_DSN_CICS_SCTGSID parameter 86 GBL_DSN_CICS_SDFHC370 parameter 86 GBL_DSN_CICS_SDFHLOAD parameter 87 GBL_DSN_CSF_SCSFMOD0 parameter 87 GBL_DSN_DB2_DSNEXIT parameter 87 GBL_DSN_DB2_LOADLIB_Vn parameter 88 GBL_DSN_DB2_RUNLIB_Vn parameter 89 GBL_DSN_DB2_SDSNLOAD parameter 89 GBL_DSN_HZSPROC_LOADLIB parameter 90 GBL_DSN_IMS_RESLIB parameter 90 GBL_DSN_IMS_SCEXLINK parameter 91 GBL_DSN_IMS_SFUNLINK parameter 92 GBL_DSN_ISP_SISPLOAD parameter 92 GBL_DSN_NETVIEW_CNMLINK parameter 93 GBL_DSN_SYS1_BRODCAST parameter 93 GBL_DSN_SYS1_CSSLIB parameter 93 GBL_DSN_SYS1_HSMLOGY parameter 94 GBL_DSN_SYS1_LINKLIB parameter 94 GBL_DSN_SYS1_MACLIB parameter 94 GBL_DSN_SYS1_MODGEN parameter 95 GBL_DSN_SYS1_PARMLIB parameter 95 GBL_DSN_SYS1_PROCLIB parameter 96 290 GBL_DSN_SYS1_SAXREXEC parameter 96 GBL_DSN_SYS1_SBLSCLI0 parameter 96 GBL_DSN_SYS1_SBPXEXEC parameter 97 GBL_DSN_SYS1_SISTMAC1 parameter 98 GBL_DSN_SYS1_VTAMLIB parameter 98 GBL_DSN_SYS1_VTAMLST parameter 99 GBL_DSN_TCP_ETC_SERVICES parameter 99 GBL_DSN_TCP_SEZACMTX parameter 100 GBL_DSN_TCP_SEZARNT1 parameter 100 GBL_DSN_TCP_SEZATCP parameter 100 GBL_DSN_TCP_SYSTCPD_TCPDATA parameter 101 GBL_DSN_TCP_SYSTCPD_TCPDATA_MFN parameter GBL_DSN_WMQ_SCSQANLE parameter 102 GBL_DSN_WMQ_SCSQAUTH parameter 102 GBL_DSN_WMQ_SCSQLOAD parameter 103 GBL_HFS_JAVA_DIRn parameter 103 GBL_INST_HILEV parameter 104 GBL_TARGET_HILEV parameter 104 GBL_USER_JCL parameter 105 georeferenced map 275 Global location broker applid of Hub field 166 Global location broker field 234 global parameters 81 GBL_DSN_ACF2_MACLIB 81 GBL_DSN_CSF_SCSFMOD0 87 GBL_DSN_HZSPROC_LOADLIB 90 GBL_DSN_ISP_SISPLOAD 92 GBL_DSN_NETVIEW_CNMLINK 93 GBL_DSN_SYS1_MACLIB 94 GBL_DSN_SYS1_PARMLIB 95 GBL_DSN_SYS1_PROCLIB 96 GBL_DSN_SYS1_SAXREXEC 96 GBL_DSN_SYS1_SBLSCLI0 96 GBL_DSN_SYS1_SISTMAC1 98 GBL_DSN_SYS1_VTAMLIB 98 GBL_DSN_SYS1_VTAMLST 99 GBL_DSN_TCP_SYSTCPD_TCPDATA 101 GBL_INST_HILEV 104 GBL_TARGET_HILEV 104 GBL_USER_JCL 105 Global Security Toolkit 275 Grant query access? field 194 Grant update access? field 195 Group Name field 179 GSKit 275 101 H Health Checker load library 90 system library 96 Hierarchical File System/zSeries File System (HFS/zFS) 146 high availability hub monitoring server parameters 258 High-level Qualifier field 110, 148 high-level qualifiers installation libraries 104 target libraries 104 Hostname field 139, 143 hot-standby monitoring server 276 how parameter values are set 1 HTTP See Hypertext Transport Protocol HTTP server port number field 207 HTTPS 275 See Secure Hypertext Transport Protocol Hub TEMS type field 165, 206, 258 Hypertext Transport Protocol 276 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference HZSPROC started task 90 I IBM Support Assistant 267 ICAT See Configuration Tool, z/OS ICSF See Integrated Cryptographic Service Facility ICSF load library 87 IIOP See Internet Inter-ORB Protocol individual agent parameters KPP_SECURITY_ACTION_CLASS 48 integral web server 276 Integrated Cryptographic Service Facility 275 interactive mode 2 Internet Inter-ORB Protocol 276 Internet Service Monitors, Netcool/OMNIbus 283 Interoperable Object Reference 276 Interval field 110 IOR See Interoperable Object Reference IP domain name resolution 101 IP.PIPE field 11, 197 IP.PIPE port number field 159 IP.SPIPE field 11, 197 IP.SPIPE port number field 162 IP.UDP field 11, 197 IP.UDP port number field 163 IP6.PIPE field 11, 197 IP6.PIPE port number field 160 IP6.SPIPE field 11, 197 IP6.SPIPE port number field 161 IP6.UDP field 11, 197 IP6.UDP port number field 164 IPCS system library 96 ISA 267 J Java Database Connectivity 277 Java Management Extensions API 277 JCL library 105 JCL suffix field 111 JDBC See Java Database Connectivity JMX See Java Management Extensions API K KPP parameters 7 KPP_AGT_AUDIT_ITM_DOMAIN batch parameter 7 KPP_AGT_AUDIT_ITM_DOMAIN parameter 7 KPP_AGT_AUDIT_MAX_HIST batch parameter 8 KPP_AGT_AUDIT_MAX_HIST parameter 8 KPP_AGT_AUDIT_TRACE batch parameter 9 KPP_AGT_AUDIT_TRACE parameter 9 KPP_AGT_COMM_PROn batch parameter 11 KPP_AGT_COMM_PROTOCOLn parameter 11 KPP_AGT_CONFIG batch parameter 10 KPP_AGT_CONFIGURATION_MODE parameter 10, 80 KPP_AGT_FLUSH_INT_MIN batch parameter 14 KPP_AGT_FLUSH_LSR_BUFR_INT_HR parameter 13 KPP_AGT_FLUSH_LSR_BUFR_INT_MIN parameter 14 KPP_AGT_ICU_LANG batch parameter 14 KPP_AGT_ICU_LANGUAGE_LOCALE parameter 14 KPP_AGT_KGL_WTO batch parameter 16 KPP_AGT_KGL_WTO parameter 16 KPP_AGT_KLX_TCP_RECYCLE batch parameter 17 KPP_AGT_KLX_TCP_TOLERATERECYCLE parameter 17 KPP_AGT_NONSTDn_DSN batch parameter 19 KPP_AGT_NONSTDn_DSN parameter 19 KPP_AGT_NONSTDn_MBR parameter 20 KPP_AGT_NONSTDn_PARM batch parameter 21 KPP_AGT_NONSTDn_PARM parameter 21 KPP_AGT_NSNEWn_VALUE parameter 18 KPP_AGT_NSOLDn_VALUE parameter 22 KPP_AGT_NSOLDn_VALUE batch parameter 22 KPP_AGT_PARTITION_NAME parameter 23 KPP_AGT_PIPE_NAME batch parameter 23 KPP_AGT_PPI_RECEIVER batch parameter 24 KPP_AGT_PPI_RECEIVER parameter 24 KPP_AGT_PPI_SENDER batch parameter 25 KPP_AGT_PPI_SENDER parameter 25 KPP_AGT_STC batch parameter 26 KPP_AGT_STC parameter monitoring agent 26 KPP_AGT_STOR_DTL_INT_HR batch parameter 27 KPP_AGT_STOR_DTL_INT_MIN batch parameter 28 KPP_AGT_STOR_MIN_EXT batch parameter 29 KPP_AGT_STORAGE_DETAIL_INT_HR parameter 27 KPP_AGT_STORAGE_DETAIL_INT_MIN parameter 28 KPP_AGT_STORAGE_MINIMUM_EXTEND parameter 29 KPP_AGT_TCP_HOST batch parameter 30 KPP_AGT_TCP_HOST parameter 30 KPP_AGT_TCP_KDEB_INTERFACELIST parameter 31 KPP_AGT_TCP_KDEBLST batch parameter 31 KPP_AGT_TCP_STC batch parameter 32 KPP_AGT_TCP_STC parameter 32 KPP_AGT_TEMA_SDA batch parameter 33 KPP_AGT_TEMA_SDA parameter 33 KPP_AGT_TEMS_NAME_NODEID batch parameter 34 KPP_AGT_TEMS_NAME_NODEID parameter 34 KPP_AGT_VIPA batch parameter 35 KPP_AGT_VIRTUAL_IP_ADDRESS parameter 35 KPP_AGT_VTAM_APPL_AA parameter 36 KPP_AGT_VTAM_APPL_KPPINVPO parameter 37 KPP_AGT_VTAM_APPL_NCS parameter 38 KPP_AGT_VTAM_APPL_OPERATOR parameter 39 KPP_AGT_VTAM_APPL_PREFIX parameter 39 KPP_AGT_VTAM_NODE parameter 40 KPP_AGT_VTM_APPL_AA batch parameter 36 KPP_AGT_VTM_APPL_NCS batch parameter 38 KPP_AGT_VTM_APPL_OPR batch parameter 39 KPP_AGT_VTM_APPL_PREF batch parameter 39 KPP_AGT_VTM_APPL_VPO batch parameter 37 KPP_AGT_VTM_NODE batch parameter 40 KPP_AGT_WTO_MSG parameter monitoring agent 41 KPP_AGT_WTO_MSGL batch parameter 41 KPP_CMS_FLUSH_INT_HR batch parameter 13 KPP_CMS_HUB_TCP_HOST batch parameter 54 KPP_CMS_LOCAL_CONNECT batch parameter 54 KPP_CMS_NAME batch parameter 56 KPP_CMS_TCP_HOST batch parameter 57 KPP_CMS_TCP_PIPE_PORT batch parameter 58 KPP_CMS_TCP_PIPE6_PORT batch parameter 60 KPP_CMS_TCP_PIPE6S_PORT batch parameter 61 KPP_CMS_TCP_PIPES_PORT batch parameter 59 KPP_CMS_TCP_UDP_PORT batch parameter 62 KPP_CMS_TCP_UDP6_PORT batch parameter 63 Index 291 KPP_CMS_VTM_APPL_LLB batch parameter 63 KPP_CMS_VTM_LU62_LOG batch parameter 64 KPP_CMS_VTM_LU62_LOGTAB batch parameter 65 KPP_CMS_VTM_NETID batch parameter 66 KPP_CMSB_NAME batch parameter 49 KPP_CMSB_TCP_HOST batch parameter 50 KPP_CMSB_VTM_APPL_LLB batch parameter 51 KPP_CMSB_VTM_LU62_LOG batch parameter 52 KPP_CMSB_VTM_NETID batch parameter 53 KPP_ICS_DATASET batch parameter 95 Kpp_MQS_AUTHLIB batch parameter 102 Kpp_MQS_LANGLIB batch parameter 102 KPP_NONSTDnn_MBR batch parameter 20 KPP_NSNEWn_VALUE batch parameter 18 KPP_PD batch parameter 42 KPP_PD parameter 42 KPP_PD_CYL batch parameter 43 KPP_PD_CYL parameter 43 KPP_PD_GRP batch parameter 44 KPP_PD_GRP parameter 44 KPP_PD_HISTCOLL_DATA_IN_AGT_STC parameter 45 KPP_PD_HISTCOLL_DATA_IN_TEMS_STC parameter 46 KPP_PD_ROW batch parameter 47 KPP_PD_ROW parameter 47 KPP_SECURITY_ACTION_CLASS parameter 48 Kpp_TCP_DATA batch parameter 101 KPP_TEMS_BKUP1_NAME_NODEID parameter 49 KPP_TEMS_BKUP1_TCP_HOST parameter 50 KPP_TEMS_BKUP1_VTAM_APPL_LLB_BKR parameter 51 KPP_TEMS_BKUP1_VTAM_LU62_DLOGMOD parameter 52 KPP_TEMS_BKUP1_VTAM_NETID parameter 53 KPP_TEMS_HUB_TCP_HOST parameter 54 KPP_TEMS_LOCAL_CONNECT_FLAG parameter 54 KPP_TEMS_NAME_NODEID parameter 56 KPP_TEMS_TCP_HOST parameter 57 KPP_TEMS_TCP_PIPE_PORT_NUM parameter 58 KPP_TEMS_TCP_PIPE6_PORT_NUM parameter 60, 63 KPP_TEMS_TCP_PIPE6S_PORT_NUM parameter 61 KPP_TEMS_TCP_PIPES_PORT_NUM parameter 59 KPP_TEMS_TCP_UDP_PORT_NUM parameter 62 KPP_TEMS_VTAM_APPL_LLB_BROKER parameter 63 KPP_TEMS_VTAM_LU62_DLOGMOD parameter 64 KPP_TEMS_VTAM_LU62_MODETAB parameter 65 KPP_TEMS_VTAM_NETID parameter 66 Kpp_USS_EXEC batch parameter 97 KPP_X_AGT_CONFIRM_SHUTDOWN parameter 67 KPP_X_AGT_DEBUG_TRACEE parameter 68 KPP_X_AGT_KDC_DEBUG parameter 68 KPP_X_AGT_LGSA_VERIFY parameter 69 KPP_X_AGT_LSRPOOL_BUFFER_NUM parameter 70 KPP_X_AGT_LSRPOOL_BUFSIZEE parameter 71 KPP_X_AGT_SDUMP_SVC_SYS1_DUMP parameter 71 KPP_X_AGT_STORAGE_LIMIT_EXTEND parameter 72 KPP_X_AGT_STORAGE_LIMIT_PRIMARY parameter 73 KPP_X_AGT_STORAGE_RESERVE_EXT parameter 73 KPP_X_AGT_STORAGE_RESERVE_PRI parameter 74 KPP_X_AGT_STORAGE_STGDEBUG parameter 75 KPP_X_AGT_TASKS_ATTACHED_NUM parameter 75 KPP_X_HUB_BKUP1_TCP_HOST parameter 76 KPP_X_HUB_BKUP1_TEMS_VTAM_NETID parameter 76 KPP_X_HUB_BKUP1_VTAM_APPL_GLBBKR parameter 77 KPP_X_HUB_TCP_HOST parameter 77 KPP_X_HUB_TEMS_VTAM_NETID parameter 78 KPP_X_HUB_VTAM_APPL_GLBBKR parameter 78 KPP_X_PD_HISTCOLL_DATA_AGT_STC parameter 79 KD2_OMPE_DB2EXIT batch parameter 87 KD2_OMPE_DB2LOADLIB_Vn batch parameter 88 292 KD2_OMPE_DB2RUNLIB_Vn batch parameter 89 KDC_DEBUG parameter 210 KDC_PARTITIONFILE parameter 196 KDCFC_ALIAS parameter 236 KDE_TRANSPORT parameter 159, 160, 161, 162, 163, 164, 207, 224, 225, 226, 227, 229, 230 KDEB_INTERFACELIST parameter 223 KDO_DB2_LOADLIB batch parameter 89 KDS_AUDIT_ITM_DOMAIN batch parameter 157 KDS_AUDIT_ITM_DOMAIN parameter 157 KDS_AUDIT_MAX_HIST batch parameter 157 KDS_AUDIT_MAX_HIST parameter 157 KDS_AUDIT_TRACE batch parameter 158 KDS_AUDIT_TRACE parameter 158 KDS_CMS_COMM_PROn batch parameter 197 KDS_CMS_COMM_XLAT batch parameter 196 KDS_CMS_CTSOAP batch parameter 215 KDS_CMS_EIF batch parameter 202 KDS_CMS_EIF_BFR_EVT batch parameter 248 KDS_CMS_EIF_BFR_EVT_MAX batch parameter 199 KDS_CMS_EIF_BFR_EVT_PATH batch parameter 248 KDS_CMS_EIF_DISABLE_EMT batch parameter 200 KDS_CMS_EIF_EVT_LISTENER batch parameter 201 KDS_CMS_EIF_FLT_ATTR1 batch parameter 249 KDS_CMS_EIF_FLT_CLASS1 batch parameter 249 KDS_CMS_EIF_FLT_MODE batch parameter 250 KDS_CMS_EIF_HOST batch parameter 203 KDS_CMS_EIF_PORT batch parameter 204 KDS_CMS_EXT_LIM batch parameter 219 KDS_CMS_FLUSH_INT_HR batch parameter 204 KDS_CMS_FLUSH_INT_MIN batch parameter 205 KDS_CMS_HA_EXCL_LIST batch parameter 206 KDS_CMS_HA_TYP batch parameter 206, 258 KDS_CMS_HTTP_PORT batch parameter 207 KDS_CMS_ICU_LANG batch parameter 208 KDS_CMS_KDC_DEBUG batch parameter 210 KDS_CMS_KGL_WTO batch parameter 211 KDS_CMS_KLX_TCP_RECYCLE batch parameter 212 KDS_CMS_PART_NAME batch parameter 213 KDS_CMS_SEC_ENC_KEY batch parameter 214 KDS_CMS_SEC_VALIDATE batch parameter 214 KDS_CMS_STC batch parameter 216 KDS_CMS_STOR_DTL_INT_HR batch parameter 216 KDS_CMS_STOR_DTL_INT_MIN batch parameter 217 KDS_CMS_STOR_DTL_LOG batch parameter 218 KDS_CMS_STOR_MIN_EXT batch parameter 221 KDS_CMS_TCP_HOST batch parameter 222 KDS_CMS_TCP_KDEBLST batch parameter 223 KDS_CMS_TCP_PIPE_PORT batch parameter 224 KDS_CMS_TCP_PIPE6_PORT batch parameter 225 KDS_CMS_TCP_PIPE6S_PORT batch parameter 226 KDS_CMS_TCP_PIPES_PORT batch parameter 227 KDS_CMS_TCP_STC batch parameter 228 KDS_CMS_TCP_UDP_PORT batch parameter 229 KDS_CMS_TCP_UDP6_PORT batch parameter 230 KDS_CMS_TYP batch parameter 232 KDS_CMS_VIPA batch parameter 233 KDS_CMS_VTM_APPL_CUA batch parameter 233 KDS_CMS_VTM_APPL_DS batch parameter 234 KDS_CMS_VTM_APPL_GLB batch parameter 234 KDS_CMS_VTM_APPL_LLB batch parameter 236 KDS_CMS_VTM_APPL_OPR batch parameter 237 KDS_CMS_VTM_APPL_PREF batch parameter 237 KDS_CMS_VTM_APPL_VPO batch parameter 235 KDS_CMS_VTM_LOADLIB batch parameter 98 KDS_CMS_VTM_LU62_LOG batch parameter 238 KDS_CMS_VTM_LU62_LOGTAB batch parameter 238 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference KDS_CMS_VTM_MACLIB batch parameter 98 KDS_CMS_VTM_NETID batch parameter 239 KDS_CMS_VTM_NODE batch parameter 240 KDS_HFS_JAVA_DIRn batch parameter 103 KDS_HUB parameter 232 KDS_HUB_GLB_APPL batch parameter 166 KDS_HUB_HA_TYP batch parameter 165 KDS_HUB_TCP_HOST batch parameter 159 KDS_HUB_TCP_HOST parameter 159 KDS_HUB_TCP_PIPE_PORT batch parameter 159 KDS_HUB_TCP_PIPE_PORT_NUM parameter 159 KDS_HUB_TCP_PIPE6_PORT batch parameter 160 KDS_HUB_TCP_PIPE6_PORT_NUM parameter 160 KDS_HUB_TCP_PIPE6S_PORT batch parameter 161 KDS_HUB_TCP_PIPE6S_PORT_NUM parameter 161 KDS_HUB_TCP_PIPES_PORT batch parameter 162 KDS_HUB_TCP_PIPES_PORT_NUM parameter 162 KDS_HUB_TCP_UDP_PORT batch parameter 163 KDS_HUB_TCP_UDP_PORT_NUM parameter 163 KDS_HUB_TCP_UDP6_PORT batch parameter 164 KDS_HUB_TCP_UDP6_PORT_NUM parameter 164 KDS_HUB_TEMS_HA_TYPE parameter 165 KDS_HUB_VTAM_APPL_GLB_BROKER parameter 166 KDS_HUB_VTAM_NETID parameter 166 KDS_HUB_VTM_NETID batch parameter 166 KDS_KMS_SDA batch parameter 167 KDS_KMS_SDA parameter 167 KDS_MIG_TAPE_HILEV batch parameter 168 KDS_MIG_TAPE_HILEV parameter 168 KDS_MIG_TAPE_UNIT batch parameter 168 KDS_MIG_TAPE_UNIT parameter 168 KDS_MIG_TAPE_VOL batch parameter 169 KDS_MIG_TAPE_VOL parameter 169 KDS_MIG_VER batch parameter 170 KDS_MIG_VER parameter 170 KDS_MIG_VSAM_HILEV batch parameter 170 KDS_MIG_VSAM_HILEV parameter 170 KDS_NONSTDnn_DSN batch parameter 171 KDS_NONSTDnn_DSN parameter 171 KDS_NONSTDnn_MBR batch parameter 172 KDS_NONSTDnn_MBR parameter 172 KDS_NONSTDnn_PARM batch parameter 173 KDS_NONSTDnn_PARM parameter 173 KDS_NSNEWnn_VALUE batch parameter 174 KDS_NSNEWnn_VALUE parameter 174 KDS_NSOLDnn_VALUE batch parameter 175 KDS_NSOLDnn_VALUE parameter 175 KDS_PA batch parameter 175 KDS_PA parameter 175 KDS_PA_ADDR batch parameter 176 KDS_PA_NAME batch parameter 177 KDS_PA_PARTITION_ADDRESS parameter 176 KDS_PA_PARTITION_NAME parameter 177 KDS_PA_ROW batch parameter 177 KDS_PA_ROW parameter 177 KDS_PD batch parameter 178 KDS_PD parameter 178 KDS_PD_CYL batch parameter 178 KDS_PD_CYL parameter 178 KDS_PD_GRP batch parameter 179 KDS_PD_GRP parameter 179 KDS_PD_ROW batch parameter 180 KDS_PD_ROW parameter 180 KDS_PH batch parameter 180 KDS_PH parameter 180 KDS_PH_CMS_ALIAS_NAME batch parameter 181 KDS_PH_CMS_COMM_PRO1 batch parameter 182 KDS_PH_CMS_KSH_SECURE batch parameter 183 KDS_PH_CMS_NAME batch parameter 183 KDS_PH_CMS_RTE batch parameter 184 KDS_PH_CMS_SYSV batch parameter 184 KDS_PH_CMS_TCP_HOST batch parameter 185 KDS_PH_CMS_TCP_HOST_LEN batch parameter 186 KDS_PH_CMS_TCP_PORT batch parameter 186 KDS_PH_CMS_USER_QUERY batch parameter 187 KDS_PH_CMS_USER_UPDATE batch parameter 187 KDS_PH_CMS_VTM_APPL_GLB batch parameter 188 KDS_PH_CMS_VTM_LU62_LOG batch parameter 189 KDS_PH_CMS_VTM_NETID batch parameter 189 KDS_PH_ROW batch parameter 181 KDS_PH_ROW parameter 181 KDS_PH_TEMS_ALIAS_NAME parameter 181 KDS_PH_TEMS_COMM_PROTOCOL1 parameter 182 KDS_PH_TEMS_KSH_SECURE parameter 183 KDS_PH_TEMS_NAME_NODEID parameter 183 KDS_PH_TEMS_RTE parameter 184 KDS_PH_TEMS_SYSV_FLAG parameter 184 KDS_PH_TEMS_TCP_HOST parameter 185 KDS_PH_TEMS_TCP_HOST_LEN parameter 186 KDS_PH_TEMS_TCP_PORT_NUM parameter 186 KDS_PH_TEMS_USER_QUERY parameter 187 KDS_PH_TEMS_USER_UPDATE parameter 187 KDS_PH_TEMS_VTAM_APPL_GLB_BROKER parameter 188 KDS_PH_TEMS_VTAM_LU62_DLOGMOD parameter 189 KDS_PH_TEMS_VTAM_NETID parameter 189 KDS_PPI_RECEIVER batch parameter 190 KDS_PPI_RECEIVER parameter 190 KDS_PPI_SENDER batch parameter 191 KDS_PPI_SENDER parameter 191 KDS_PU batch parameter 192 KDS_PU parameter 192 KDS_PU_CMS_NAME batch parameter 193 KDS_PU_CMS_RTE batch parameter 193 KDS_PU_CMS_USER_ID batch parameter 194 KDS_PU_CMS_USER_QUERY batch parameter 194 KDS_PU_CMS_USER_UPDATE batch parameter 195 KDS_PU_ROW batch parameter 192 KDS_PU_ROW parameter 192 KDS_PU_TEMS_NAME_NODEID parameter 193 KDS_PU_TEMS_RTE parameter 193 KDS_PU_TEMS_USER_ID parameter 194 KDS_PU_TEMS_USER_QUERY parameter 194 KDS_PU_TEMS_USER_UPDATE parameter 195 KDS_TEMA_SDA batch parameter 196 KDS_TEMA_SDA parameter 196 KDS_TEMS_COMM_ADDRESS_XLAT parameter 196 KDS_TEMS_COMM_PROTOCOLn parameter 197 KDS_TEMS_DRA_FLAG batch parameter 198 KDS_TEMS_DRA_FLAG parameter 198 KDS_TEMS_EIF_BUFFER_EVENT_MAXSZE parameter 199 KDS_TEMS_EIF_DISABLE_TEC_EMITTER parameter 200 KDS_TEMS_EIF_EVENT_LISTENER parameter 201 KDS_TEMS_EIF_FLAG parameter 202 KDS_TEMS_EIF_HOST parameter 203 KDS_TEMS_EIF_PORT_NUM parameter 204 KDS_TEMS_FLUSH_LSR_BUFR_INT_HR parameter 204 KDS_TEMS_FLUSH_LSR_BUFR_INT_MIN parameter 205 KDS_TEMS_HA_EXCL_LIST parameter 206 KDS_TEMS_HA_TYPE parameter 206, 258 KDS_TEMS_HTTP_PORT_NUM parameter 207 KDS_TEMS_ICU_LANGUAGE_LOCALE parameter 208 KDS_TEMS_KDC_DEBUG parameter 210 KDS_TEMS_KGL_WTO parameter 211 KDS_TEMS_KLX_TCP_TOLERATERECYCLE parameter 212 Index 293 KDS_TEMS_PARTITION_NAME parameter 213 KDS_TEMS_SECURITY_KAES256_ENCKEY parameter 214 KDS_TEMS_SECURITY_KDS_VALIDATE parameter 214 KDS_TEMS_SOAP_SERVER_FLAG parameter 215 KDS_TEMS_STC parameter 216 KDS_TEMS_STORAGE_DETAIL_INT_HR parameter 216 KDS_TEMS_STORAGE_DETAIL_INT_MIN parameter 217 KDS_TEMS_STORAGE_DETAIL_LOG_FLAG parameter 218 KDS_TEMS_STORAGE_LIMIT_EXTEND parameter 219 KDS_TEMS_STORAGE_LIMIT_PRIMARY parameter 220 KDS_TEMS_STORAGE_MINIMUM_EXTEND parameter 221 KDS_TEMS_TCP_HOST parameter 222 KDS_TEMS_TCP_KDEB_INTERFACELIST parameter 223 KDS_TEMS_TCP_PIPE_PORT_NUM parameter 224 KDS_TEMS_TCP_PIPE6_PORT_NUM parameter 225 KDS_TEMS_TCP_PIPE6S_PORT_NUM parameter 226 KDS_TEMS_TCP_PIPES_PORT_NUM parameter 227 KDS_TEMS_TCP_STC parameter 228 KDS_TEMS_TCP_UDP_PORT_NUM parameter 229 KDS_TEMS_TCP_UDP6_PORT_NUM parameter 230 KDS_TEMS_TYPE parameter 232 KDS_TEMS_VIRTUAL_IP_ADDRESS parameter 233 KDS_TEMS_VTAM_APPL_CUA_OPER parameter 233 KDS_TEMS_VTAM_APPL_GLB_BROKER parameter 234 KDS_TEMS_VTAM_APPL_KDS_VTAMID parameter 234 KDS_TEMS_VTAM_APPL_KDSINVPO parameter 235 KDS_TEMS_VTAM_APPL_OPERATOR parameter 237 KDS_TEMS_VTAM_APPL_PREFIX parameter 237 KDS_TEMS_VTAM_LU62_DLOGMOD parameter 238 KDS_TEMS_VTAM_LU62_MODETAB parameter 238 KDS_TEMS_VTAM_NETID parameter 239 KDS_TEMS_VTAM_NODE parameter 240 KDS_USS_EXEC batch parameter 97 KDS_VALIDATE parameter 214 KDS_VTAMID parameter 234 KDS_X_HUB_BKUP1_TCP_HOST parameter 240 KDS_X_HUB_BKUP1_TEMS_VTAM_NETID parameter 241 KDS_X_HUB_BKUP1_VTAM_APPL_GLBBKR parameter 241 KDS_X_KDCFC_RXLIMIT parameter 242 KDS_X_KDE_TRANSPORT_HTTP_OPTIONS parameter 242 KDS_X_KDE_TRANSPORT_OPTIONS parameter 243 KDS_X_KDE_TRANSPORT_POOL_OPTIONS parameter 244 KDS_X_SECURITY_RESOURCE_CLASS parameter 244 KDS_X_SECURITY_USER_EXIT parameter 245 KDS_X_STC_SYSTCPD_INCLUDE_FLAG parameter 246 KDS_X_TEMS_CONFIRM_SHUTDOWN parameter 246 KDS_X_TEMS_DEBUG_TRACE parameter 247 KDS_X_TEMS_EIF_BFR_EVT parameter 248 KDS_X_TEMS_EIF_BFR_EVT_PATH parameter 248 KDS_X_TEMS_EIF_FLT_ATTR1 parameter 249 KDS_X_TEMS_EIF_FLT_CLASS1 parameter 249 KDS_X_TEMS_EIF_FLT_MODE parameter 250 KDS_X_TEMS_FRAME_STACK_SIZE parameter 250 KDS_X_TEMS_LGSA_VERIFY parameter 251 KDS_X_TEMS_LOGBLOCK_RKLVLOG_SIZE parameter 251 KDS_X_TEMS_LOGBUFS_RKLVLOG_BUFSZ parameter 252 KDS_X_TEMS_LSRPOOL_BUFFER_NUM parameter 252 KDS_X_TEMS_LSRPOOL_BUFSIZE parameter 253 KDS_X_TEMS_LSRSTRNO_CONCURRENT parameter 254 KDS_X_TEMS_SDUMP_SVC_SYS1_DUMP parameter 254 KDS_X_TEMS_STORAGE_RESERVE_PRI parameter 255 KDS_X_TEMS_STORAGE_STGDEBUG parameter 256 KDS_X_TEMS_TASKS_ATTACHED_NUM parameter 257 KDS_X_TEMS_WTO parameter 257 KGL_WTO parameter 211 KGLHC_PPI_RECEIVER parameter 190 KGLHC_PPI_SENDER parameter 191 294 KGW_CTG_DLL_DSN batch parameter 86 KI2_CLA_BMP_RESLIB batch parameter 90 KI2_I1_CLA_IMS_RESLIB batch parameter 90 KI5_ICT_SCEXLINK batch parameter 91 KI5_ICT_SFUNLINK batch parameter 92 KI5_IMS_RESLIB batch parameter 90 KI5_X_ICT_IMS_CONNECT_FLAG batch parameter 91, 92 KMC_CFG_MCDB2_LIB batch parameter 89 KMS_DISABLE_TEC_EMITTER parameter 200 KMS_OMTEC_INTEGRATION parameter 202 KNA_NETV_LNKLIB batch parameter 93 KOB_TOM_STC batch parameter 259 KOB_TOM_STC parameter 259 KOB_TOM_VTAM_APPL_LOGON batch parameter 260 KOB_TOM_VTAM_APPL_LOGON parameter 260 KOB_TOM_VTAM_NODE batch parameter 261 KOB_TOM_VTAM_NODE parameter 261 KQI_CEE_LE370_LKED batch parameter 83 KQI_CEE_LE370_RUN batch parameter 85 KQI_CIC_LOADLIB batch parameter 87 KQI_MQS_LOADLIB batch parameter 103 krarloff utility 276 L LANG parameter 208 Language locale field 14, 208 language locales 208 LDAP See Lightweight Directory Access Protocol LGSA parameter 251 Lightweight Directory Access Protocol 277 LIMIT parameter 219, 220 load libraries CNMLINK 93 Health Checker 90 ICSF 87 NetView 93 Load optimization field 115 Local location broker applid field 51 Local Location Broker applid field 63 Local location broker field 236 LOGBLOCK parameter 251 LOGBUFS parameter 252 Logmode table field 150 Logmode table name field 238 LOGMODE table name field 65 logmode tables system library 98 Low-level dataset qualifier field 19, 171 LSRPOOL parameter 252, 253 LSRSTRNO parameter 254 LU6.2 logmode field 52, 64, 150, 238 LUGROUP field 144 M macro library 94 Maintenance procedure prefix field 122 Major Node field 40 managed Java beans 277 Maximum storage request size (extended) field 219 Maximum storage request size (primary) field 220 MBeans 277 MDM See Multidomain Management Member field 20, 172 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Mgmtclas field 129, 132 Microsoft Management Console 277 Mid-level qualifier field 107 Minimum extended storage field 29, 221 MINIMUM parameter 221 MMC See Microsoft Management Console Monitored Hub TEMS field 193 Monitored RTE field 193 monitoring agent advanced agent configuration values KPP_AGT_ICU_LANGUAGE_LOCALE KPP_AGT_WTO_MSG 41 Multidomain Management 278 14 N Name field 117 names, parameter 3 NAT See Network Address Translation NetView CNMLINK load library 93 NetView PPI receiver field 24, 190 Network address (Hostname of Hub) field 157, 159 Network address (Hostname of Secondary TEMS) field 50 Network Address (Hostname of the primary TEMS) field 54 Network address (Hostname) field 30 Network Address field 57 Network Address Translation 278 Network File System 278 Network ID field 53, 66, 139, 151, 239 Network ID of hub field 166 Network interface list field 31, 223 New Value field 174 NFS See Network File System O ODBC See Open Database Connectivity Old Value field 22, 175 OMEGAMON Tivoli Event Adapter 279 OMEGAMON XE Advanced Agent configuration values KPP_AGT_FLUSH_LSR_BUFR_INT_HR 13 KPP_AGT_FLUSH_LSR_BUFR_INT_MIN 14 KPP_AGT_KGL_WTO 16 KPP_AGT_KLX_TCP_TOLERATERECYCLE 17 KPP_AGT_STORAGE_DETAIL_INT_HR 27 KPP_AGT_STORAGE_DETAIL_INT_MIN 28 KPP_AGT_STORAGE_MINIMUM_EXTEND 29 KPP_AGT_VIRTUAL_IP_ADDRESS 35 OMEGAMON XE Agent's Applids KPP_AGT_VTAM_APPL_AA 36 KPP_AGT_VTAM_APPL_KPPINVPO 37 KPP_AGT_VTAM_APPL_NCS 38 KPP_AGT_VTAM_APPL_OPERATOR 39 OMEGAMON XE Agent's local TCP/IP information KPP_AGT_TCP_HOST 30 OMEGAMON XE Agent's local VTAM and logon information KPP_AGT_VTAM_APPL_PREFIX 39 KPP_AGT_VTAM_NODE 40 OMEGAMON XE Agent's Primary TEMS VTAM information KPP_TEMS_VTAM_APPL_LLB_BROKER 63 KPP_TEMS_VTAM_LU62_DLOGMODE 64 KPP_TEMS_VTAM_LU62_MODETAB 65 OMEGAMON XE Agent's Primary TEMS VTAM information (continued) KPP_TEMS_VTAM_NETID 66 OMEGAMON XE historical collection is being performed by the monitoring agent address space KPP_PD_HISTCOLL_DATA_IN_AGT_STC 45 OMEGAMON XE Historical data collection by the Tivoli Enterprise Monitoring Server address space 46 OMEGAMON XE If the Agent requires address translation support KPP_AGT_PARTITION_NAME 23 OMEGAMON XE If the Agent requires network interface list support KPP_AGT_TCP_KDEB_INTERFACELIST 31 OMEGAMON XE monitoring agent Advanced Agent configuration values KPP_AGT_FLUSH_LSR_BUFR_INT_HR 13 KPP_AGT_FLUSH_LSR_BUFR_INT_MIN 14 KPP_AGT_KGL_WTO 16 KPP_AGT_KLX_TCP_TOLERATERECYCLE 17 KPP_AGT_STORAGE_DETAIL_INT_HR 27 KPP_AGT_STORAGE_DETAIL_INT_MIN 28 KPP_AGT_STORAGE_MINIMUM_EXTEND 29 KPP_AGT_VIRTUAL_IP_ADDRESS 35 Agent's Applids KPP_AGT_VTAM_APPL_AA 36 KPP_AGT_VTAM_APPL_KPPINVPO 37 KPP_AGT_VTAM_APPL_NCS 38 KPP_AGT_VTAM_APPL_OPERATOR 39 Agent's local TCP/IP information KPP_AGT_TCP_HOST 30 Agent's local VTAM and logon information KPP_AGT_VTAM_APPL_PREFIX 39 KPP_AGT_VTAM_NODE 40 Agent's Primary TEMS VTAM information KPP_TEMS_VTAM_APPL_LLB_BROKER 63 KPP_TEMS_VTAM_LU62_DLOGMOD 64 KPP_TEMS_VTAM_LU62_MODETAB 65 KPP_TEMS_VTAM_NETID 66 historical collection is being performed by the monitoring agent address space KPP_PD_HISTCOLL_DATA_IN_AGT_STC 45 Historical data collection by the Tivoli Enterprise Monitoring Server address space KPP_PD_HISTCOLL_DATA_IN_TEMS_STC 46 If the Agent requires address translation support KPP_AGT_PARTITION_NAME 23 If the Agent requires network interface list support KPP_AGT_TCP_KDEB_INTERFACELIST 31 Nonstandard parameters KPP_AGT_NONSTDn_DSN 19 KPP_AGT_NONSTDn_MBR 20 KPP_AGT_NONSTDn_PARM 21 KPP_AGT_NSNEWn_VALUE 18 KPP_AGT_NSOLDn_VALUE 22 Persistent datastore table space allocation overrides KPP_PD 42 KPP_PD_CYL 43 KPP_PD_GRP 44 KPP_PD_ROW 47 KPP_X_PD_HISTCOLL_DATA_AGT_STC 79 Protocol port numbers for Agent connection to TEMS KPP_TEMS_TCP_PIPE_PORT_NUM 58 KPP_TEMS_TCP_PIPE6_PORT_NUM 60, 63 KPP_TEMS_TCP_PIPE6S_PORT_NUM 61 KPP_TEMS_TCP_PIPES_PORT_NUM 59 KPP_TEMS_TCP_UDP_PORT_NUM 62 Index 295 OMEGAMON XE monitoring agent (continued) Secondary TEMS TCP/IP information KPP_TEMS_BKUP1_TCP_HOST 50 Secondary TEMS VTAM information KPP_TEMS_BKUP1_NAME_NODEID 49 KPP_TEMS_BKUP1_VTAM_APPL_LLB_BKR 51 KPP_TEMS_BKUP1_VTAM_LU62_DLOGMOD 52 KPP_TEMS_BKUP1_VTAM_NETID 53 Specify communication protocols preference for TEMS connection KPP_AGT_COMM_PROTOCOLn 11 Take Action commands security settings KPP_AGT_PPI_RECEIVER 24 KPP_AGT_PPI_SENDER 25 Values that describe the address space KPP_AGT_CONFIGURATION_MODE 10 KPP_AGT_STC 26 KPP_AGT_TCP_STC 32 KPP_TEMS_TCP_HOST 57 Values that describe the address space for the agent and the TEMS KPP_AGT_TEMS_NAME_NODEIDD 34 Values that describe the Primary TEMS the Agent will connect to KPP_TEMS_HUB_TCP_HOST 54 KPP_TEMS_LOCAL_CONNECT_FLAG 54 KPP_TEMS_NAME_NODEID 56 OMEGAMON XE Nonstandard parameters KPP_AGT_NONSTDn_MBR 20 KPP_AGT_NONSTDn_PARM 21 KPP_AGT_NSOLDn_VALUE 22 KPP_TN3270_DXL_APPLID 18 OMEGAMON XE Persistent datastore table space allocation overrides KPP_PD 42 KPP_PD_CYL 43 KPP_PD_GRP 44 KPP_PD_ROW 47 KPP_X_PD_HISTCOLL_DATA_AGT_STC 79 OMEGAMON XE Protocol port numbers for Agent connection to TEMS KPP_TEMS_TCP_PIPE_PORT_NUM 58 KPP_TEMS_TCP_PIPE6_PORT_NUM 60, 63 KPP_TEMS_TCP_PIPE6S_PORT_NUM 61 KPP_TEMS_TCP_PIPES_PORT_NUM 59 KPP_TEMS_TCP_UDP_PORT_NUM 62 OMEGAMON XE Secondary TEMS TCP/IP information KPP_TEMS_BKUP1_TCP_HOST 50 OMEGAMON XE Secondary TEMS VTAM information KPP_TEMS_BKUP1_NAME_NODEID 49 KPP_TEMS_BKUP1_VTAM_APPL_LLB_BKRG 51 KPP_TEMS_BKUP1_VTAM_LU62_DLOGMOD 52 KPP_TEMS_BKUP1_VTAM_NETID 53 OMEGAMON XE Specify communication protocols preference for TEMS connection KPP_AGT_COMM_PROTOCOLn 11 OMEGAMON XE Take Action commands security settings KPP_AGT_PPI_RECEIVER 24 KPP_AGT_PPI_SENDER 25 OMEGAMON XE Values that describe the address space KPP_AGT_CONFIGURATION_MODE 10 KPP_AGT_STC 26 KPP_AGT_TCP_STC 32 KPP_TEMS_TCP_HOST 57 OMEGAMON XE Values that describe the address space for the agent and the TEMS KPP_AGT_TEMS_NAME_NODEID 34 296 OMEGAMON XE Values that describe the Primary TEMS the Agent will connect to KPP_TEMS_HUB_TCP_HOST 54 KPP_TEMS_LOCAL_CONNECT_FLAG 54 KPP_TEMS_NAME_NODEID 56 OMNIbus 283 Open Database Connectivity 279 OTEA See OMEGAMON Tivoli Event Adapter overview, parameters 1 P parameter 79 Parameter field 21, 173 parameter library 95 parameter names 3 RTE_SYSV_VTAM_APPLID_PREFIX 138 parameter values how to set 1 parameters covered in this guide 5 parameters, overview 1 PARM_BATCH batch parameter 94 PARMGEN configuration method 2 PARMGEN parameter names DS_TEMS_VTAM_APPL_LLB_BROKER 236 GBL_DSN_ACF2_MACLIB 81 GBL_DSN_CBC_SCCNOBJ 81 GBL_DSN_CBC_SCLBSID 82 GBL_DSN_CEE_SCEEBIND 82 GBL_DSN_CEE_SCEEBND2 82 GBL_DSN_CEE_SCEECPP 83 GBL_DSN_CEE_SCEELIB 83 GBL_DSN_CEE_SCEELKED 83 GBL_DSN_CEE_SCEELKEX 84 GBL_DSN_CEE_SCEEMSGP 84 GBL_DSN_CEE_SCEERUN 85 GBL_DSN_CEE_SCEESPC 85 GBL_DSN_CICS_CTG_DLL 86 GBL_DSN_CICS_SCTGSID 86 GBL_DSN_CICS_SDFHC370 86 GBL_DSN_CICS_SDFHLOAD 87 GBL_DSN_CSF_SCSFMOD0 87 GBL_DSN_DB2_DSNEXIT 87 GBL_DSN_DB2_LOADLIB_Vn 88 GBL_DSN_DB2_RUNLIB_Vn 89 GBL_DSN_DB2_SDSNLOAD 89 GBL_DSN_HZSPROC_LOADLIB 90 GBL_DSN_IMS_RESLIB 90 GBL_DSN_IMS_SCEXLINK 91 GBL_DSN_IMS_SFUNLINK 92 GBL_DSN_ISP_SISPLOAD 92 GBL_DSN_NETVIEW_CNMLINK 93 GBL_DSN_SYS1_BRODCAST 93 GBL_DSN_SYS1_CSSLIB 93 GBL_DSN_SYS1_HSMLOGY 94 GBL_DSN_SYS1_LINKLIB 94 GBL_DSN_SYS1_MACLIB 94 GBL_DSN_SYS1_MODGEN 95 GBL_DSN_SYS1_PARMLIB 95 GBL_DSN_SYS1_PROCLIB 96 GBL_DSN_SYS1_SAXREXEC 96 GBL_DSN_SYS1_SBLSCLI0 96 GBL_DSN_SYS1_SBPXEXEC 97 GBL_DSN_SYS1_SISTMAC1 98 GBL_DSN_SYS1_VTAMLIB 98 GBL_DSN_SYS1_VTAMLST 99 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference PARMGEN parameter names (continued) GBL_DSN_TCP_ETC_SERVICES 99 GBL_DSN_TCP_SEZACMTX 100 GBL_DSN_TCP_SEZARNT1 100 GBL_DSN_TCP_SEZATCP 100 GBL_DSN_TCP_SYSTCPD_TCPDATA 101 GBL_DSN_TCP_SYSTCPD_TCPDATA_MFN 101 GBL_DSN_WMQ_SCSQANLE 102 GBL_DSN_WMQ_SCSQAUTH 102 GBL_DSN_WMQ_SCSQLOAD 103 GBL_HFS_JAVA_DIRn 103 GBL_INST_HILEV 104 GBL_TARGET_HILEV 104 GBL_USER_JCL 105 KPP_AGT_AUDIT_ITM_DOMAIN 7 KPP_AGT_AUDIT_MAX_HIST 8 KPP_AGT_AUDIT_TRACE 9 KPP_AGT_COMM_PROTOCOLn 11 KPP_AGT_CONFIGURATION_MODE 10, 80 KPP_AGT_FLUSH_LSR_BUFR_INT_HR 13 KPP_AGT_FLUSH_LSR_BUFR_INT_MIN 14 KPP_AGT_ICU_LANGUAGE_LOCALE 14 KPP_AGT_KGL_WTO 16 KPP_AGT_KLX_TCP_TOLERATERECYCLE 17 KPP_AGT_NONSTDn_DSN 19 KPP_AGT_NONSTDn_PARM 21 KPP_AGT_NSOLDn_VALUE 22 KPP_AGT_PARTITION_NAME 23 KPP_AGT_PPI_RECEIVER 24 KPP_AGT_PPI_SENDER 25 KPP_AGT_STC 26 KPP_AGT_STORAGE_DETAIL_INT_HR 27 KPP_AGT_STORAGE_DETAIL_INT_MIN 28 KPP_AGT_STORAGE_MINIMUM_EXTEND 29 KPP_AGT_TCP_HOST 30 KPP_AGT_TCP_KDEB_INTERFACELIST 31 KPP_AGT_TCP_STC 32 KPP_AGT_TEMA_SDA 33 KPP_AGT_TEMS_NAME_NODEID 34 KPP_AGT_VIRTUAL_IP_ADDRESS 35 KPP_AGT_VTAM_APPL_AA 36 KPP_AGT_VTAM_APPL_KPPINVPO 37 KPP_AGT_VTAM_APPL_NCS 38 KPP_AGT_VTAM_APPL_OPERATOR 39 KPP_AGT_VTAM_APPL_PREFIX 39 KPP_AGT_VTAM_NODE 40 KPP_AGT_WTO_MSG 41 KPP_NONSTDnn_MBR 20 KPP_NSNEWn_VALUE 18 KPP_PD 42 KPP_PD_CYL 43 KPP_PD_GRP 44 KPP_PD_ROW 47 KPP_TEMS_BKUP1_NAME_NODEID 49 KPP_TEMS_BKUP1_TCP_HOST 50 KPP_TEMS_BKUP1_VTAM_APPL_LLB_BKR 51 KPP_TEMS_BKUP1_VTAM_LU62_DLOGMOD 52 KPP_TEMS_BKUP1_VTAM_NETID 53 KPP_TEMS_HUB_TCP_HOST 54 KPP_TEMS_LOCAL_CONNECT_FLAG 54 KPP_TEMS_NAME_NODEID 56 KPP_TEMS_TCP_HOST 57 KPP_TEMS_TCP_PIPE_PORT_NUM 58 KPP_TEMS_TCP_PIPE6_PORT_NUM 60 KPP_TEMS_TCP_PIPE6S_PORT_NUM 61 KPP_TEMS_TCP_PIPES_PORT_NUM 59 KPP_TEMS_TCP_UDP_PORT_NUM 62 PARMGEN parameter names (continued) KPP_TEMS_TCP_UDP6_PORT_NUM 63 KPP_TEMS_VTAM_APPL_LLB_BROKER 63 KPP_TEMS_VTAM_LU62_DLOGMOD 64 KPP_TEMS_VTAM_LU62_MODETAB 65 KPP_TEMS_VTAM_NETID 66 KPP_X_AGT_CONFIRM_SHUTDOWN 67 KPP_X_AGT_DEBUG_TRACE 68 KPP_X_AGT_LGSA_VERIFY 69 KPP_X_AGT_LSRPOOL_BUFFER_NUM 70 KPP_X_AGT_LSRPOOL_BUFSIZEE 71 KPP_X_AGT_SDUMP_SVC_SYS1_DUMP 71 KPP_X_AGT_STORAGE_LIMIT_EXTEND 72 KPP_X_AGT_STORAGE_LIMIT_PRIMARY 73 KPP_X_AGT_STORAGE_RESERVE_EXT 73 KPP_X_AGT_STORAGE_RESERVE_PRI 74 KPP_X_AGT_STORAGE_STGDEBUG 75 KPP_X_AGT_TASKS_ATTACHED_NUM 75 KPP_X_HUB_BKUP1_TCP_HOST 76 KPP_X_HUB_BKUP1_TEMS_VTAM_NETID 76 KPP_X_HUB_BKUP1_VTAM_APPL_GLBBKR 77 KPP_X_HUB_TCP_HOST 77 KPP_X_HUB_TEMS_VTAM_NETID 78 KPP_X_HUB_VTAM_APPL_GLBBKR 78 KPP_X_PD_HISTCOLL_DATA_AGT_STC 79 KDS_AUDIT_ITM_DOMAIN 157 KDS_AUDIT_MAX_HIST 157 KDS_AUDIT_TRACE 158 KDS_HUB_TCP_HOST 159 KDS_HUB_TCP_PIPE_PORT_NUM 159 KDS_HUB_TCP_PIPE6_PORT_NUM 160 KDS_HUB_TCP_PIPE6S_PORT_NUM 161 KDS_HUB_TCP_UDP_PORT_NUM 163 KDS_HUB_TCP_UDP6_PORT_NUM 164 KDS_HUB_TEMS_HA_TYPE 165 KDS_HUB_VTAM_APPL_GLB_BROKER 166 KDS_HUB_VTAM_NETID 166 KDS_KMS_SDA 167 KDS_MIG_TAPE_HILEV 168 KDS_MIG_TAPE_UNIT 168 KDS_MIG_TAPE_VOL 169 KDS_MIG_VER 170 KDS_MIG_VSAM_HILEV 170 KDS_NONSTDnn_DSN 171 KDS_NONSTDnn_MBR 172 KDS_NONSTDnn_PARM 173 KDS_NSNEWnn_VALUE 174 KDS_NSOLDnn_VALUE 175 KDS_PA 175 KDS_PA_PARTITION_ADDRESS 176 KDS_PA_PARTITION_NAME 177 KDS_PA_ROW 177 KDS_PD 178 KDS_PD_CYL 178 KDS_PD_GRP 179 KDS_PD_ROW 180 KDS_PH 180 KDS_PH_ROW 181 KDS_PH_TEMS_ALIAS_NAME 181 KDS_PH_TEMS_COMM_PROTOCOL1 182 KDS_PH_TEMS_KSH_SECURE 183 KDS_PH_TEMS_NAME_NODEID 183 KDS_PH_TEMS_RTE 184 KDS_PH_TEMS_SYSV_FLAG 184 KDS_PH_TEMS_TCP_HOST 185 KDS_PH_TEMS_TCP_HOST_LEN 186 KDS_PH_TEMS_TCP_PORT_NUM 186 Index 297 PARMGEN parameter names (continued) KDS_PH_TEMS_USER_QUERY 187 KDS_PH_TEMS_USER_UPDATE 187 KDS_PH_TEMS_VTAM_APPL_GLB_BROKER 188 KDS_PH_TEMS_VTAM_LU62_DLOGMOD 189 KDS_PH_TEMS_VTAM_NETID 189 KDS_PPI_RECEIVER 190 KDS_PPI_SENDER 191 KDS_PU 192 KDS_PU_ROW 192 KDS_PU_TEMS_NAME_NODEID 193 KDS_PU_TEMS_RTE 193 KDS_PU_TEMS_USER_ID 194 KDS_PU_TEMS_USER_QUERY 194 KDS_PU_TEMS_USER_UPDATE 195 KDS_TEMA_SDA 196 KDS_TEMS_COMM_ADDRESS_XLAT 196 KDS_TEMS_COMM_PROTOCOLn 197 KDS_TEMS_DRA_FLAG 198 KDS_TEMS_EIF_BUFFER_EVENT_MAXSZE 199 KDS_TEMS_EIF_DISABLE_TEC_EMITTER 200 KDS_TEMS_EIF_EVENT_LISTENER 201 KDS_TEMS_EIF_FLAG 202 KDS_TEMS_EIF_HOST 203 KDS_TEMS_EIF_PORT_NUM 204 KDS_TEMS_FLUSH_LSR_BUFR_INT_HR 204 KDS_TEMS_FLUSH_LSR_BUFR_INT_MIN 205 KDS_TEMS_HA_EXCL_LIST 206 KDS_TEMS_HA_TYPE 206, 258 KDS_TEMS_HTTP_PORT_NUM 207 KDS_TEMS_ICU_LANGUAGE_LOCALE 208 KDS_TEMS_KDC_DEBUG 210 KDS_TEMS_KGL_WTO 211 KDS_TEMS_KLX_TCP_TOLERATERECYCLE 212 KDS_TEMS_PARTITION_NAME 213 KDS_TEMS_SECURITY_KAES256_ENCKEY 214 KDS_TEMS_SECURITY_KDS_VALIDATE 214 KDS_TEMS_SOAP_SERVER_FLAG 215 KDS_TEMS_STC 216 KDS_TEMS_STORAGE_DETAIL_INT_HR 216 KDS_TEMS_STORAGE_DETAIL_INT_MIN 217 KDS_TEMS_STORAGE_DETAIL_LOG_FLAG 218 KDS_TEMS_STORAGE_LIMIT_EXTEND 219 KDS_TEMS_STORAGE_LIMIT_PRIMARY 220 KDS_TEMS_TCP_HOST 222 KDS_TEMS_TCP_KDEB_INTERFACELIST 223 KDS_TEMS_TCP_PIPE_PORT_NUM 224 KDS_TEMS_TCP_PIPE6_PORT_NUM 225 KDS_TEMS_TCP_PIPE6S_PORT_NUM 226 KDS_TEMS_TCP_PIPES_PORT_NUM 227 KDS_TEMS_TCP_STC 228 KDS_TEMS_TCP_UDP_PORT_NUM 229 KDS_TEMS_TCP_UDP6_PORT_NUM 230 KDS_TEMS_TYPE 232 KDS_TEMS_VIRTUAL_IP_ADDRESS 233 KDS_TEMS_VTAM_APPL_CUA_OPER 233 KDS_TEMS_VTAM_APPL_GLB_BROKER 234 KDS_TEMS_VTAM_APPL_KDS_VTAMID 234 KDS_TEMS_VTAM_APPL_KDSINVPO 235 KDS_TEMS_VTAM_APPL_OPERATOR 237 KDS_TEMS_VTAM_APPL_PREFIX 237 KDS_TEMS_VTAM_LU62_DLOGMOD 238 KDS_TEMS_VTAM_LU62_MODETAB 238 KDS_TEMS_VTAM_NETID 239 KDS_TEMS_VTAM_NODE 240 KDS_X_HUB_BKUP1_TCP_HOST 240 KDS_X_HUB_BKUP1_TEMS_VTAM_NETID 241 298 PARMGEN parameter names (continued) KDS_X_HUB_BKUP1_VTAM_APPL_GLBBKR 241 KDS_X_KDCFC_RXLIMIT 242 KDS_X_KDE_TRANSPORT_HTTP_OPTIONS 242 KDS_X_KDE_TRANSPORT_OPTIONS 243 KDS_X_KDE_TRANSPORT_POOL_OPTIONS 244 KDS_X_SECURITY_RESOURCE_CLASS 244 KDS_X_SECURITY_USER_EXIT 245 KDS_X_STC_SYSTCPD_INCLUDE_FLAG 246 KDS_X_TEMS_CONFIRM_SHUTDOWN 246 KDS_X_TEMS_DEBUG_TRACE 247 KDS_X_TEMS_EIF_BFR_EVT 248 KDS_X_TEMS_EIF_BFR_EVT_PATH 248 KDS_X_TEMS_EIF_FLT_ATTR1 249 KDS_X_TEMS_EIF_FLT_CLASS1 249 KDS_X_TEMS_EIF_FLT_MODE 250 KDS_X_TEMS_FRAME_STACK_SIZE 250 KDS_X_TEMS_LGSA_VERIFY 251 KDS_X_TEMS_LOGBLOCK_RKLVLOG_SIZE 251 KDS_X_TEMS_LOGBUFS_RKLVLOG_BUFSZ 252 KDS_X_TEMS_LSRPOOL_BUFFER_NUMn 252 KDS_X_TEMS_LSRPOOL_BUFSIZEn 253 KDS_X_TEMS_LSRSTRNO_CONCURRENT 254 KDS_X_TEMS_SDUMP_SVC_SYS1_DUMP 254 KDS_X_TEMS_STORAGE_RESERVE_PRI 255 KDS_X_TEMS_STORAGE_STGDEBUG 256 KDS_X_TEMS_TASKS_ATTACHED_NUM 257 KDS_X_TEMS_WTO 257 KOB_TOM_STC 259 KOB_TOM_VTAM_APPL_LOGON 260 KOB_TOM_VTAM_NODE 261 PKPP_X_AGT_KDC_DEBUG 68 RTE_BASE_NAME 107 RTE_CANSCN_STC 107 RTE_CANSETE_STC 108 RTE_DEBUG_SYSOUT 109 RTE_DESCRIPTION 109 RTE_HCK_STC_INTERVAL 110 RTE_HILEV 110 RTE_JCL_SUFFIX 111 RTE_KCNDLSSI_IEFSSN00_FORMAT 112 RTE_KCNSTR00_SSID 113 RTE_KCNSTR00_WTO 113 RTE_KCNSTR00_XCFGROUP 114 RTE_LOAD_OPTIMIZE 115 RTE_LOAD_SHARED_LIBS 116 RTE_LOG_SYSOUT 116 RTE_NAME 117 RTE_PDS_BACKUP_FLAG 118 RTE_PDS_BATCHINIT_FLAG 117 RTE_PDS_EXPORT_FLAG 119 RTE_PDS_EXTRACT_FLAG 120 RTE_PDS_FILE_COUNT 121 RTE_PDS_HILEV 121 RTE_PDS_KPDPROC_PREFIX 122 RTE_PDS_SMS_MGMTCLAS 122 RTE_PDS_SMS_STORCLAS 123 RTE_PDS_SMS_UNIT 124 RTE_PDS_SMS_VOLUME 124 RTE_REMOTE_LPAR_FLAG 125 RTE_SECURITY_CLASS 125 RTE_SECURITY_FOLD_PASSWORD_FLAG 126 RTE_SECURITY_USER_LOGON 127 RTE_SHARE 128 RTE_SMS_MGMTCLAS 129 RTE_SMS_PDSE_FLAG 129 RTE_SMS_STORCLAS 130 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference PARMGEN parameter names (continued) RTE_SMS_UNIT 131 RTE_SMS_VOLUME 131 RTE_SMS_VSAM_MGMTCLAS 132 RTE_SMS_VSAM_STORCLAS 133 RTE_SMS_VSAM_VOLUME 133 RTE_STC_PREFIX 134 RTE_SYSV_BASE_ALIAS 135 RTE_SYSV_NAME 135 RTE_SYSV_TEMS_NAME_NODEID 137 RTE_SYSV_VTAM_APPLID_MODEL 137 RTE_SYSV_VTAM_NETID 139 RTE_TCP_HOST 139 RTE_TCP_PORT_NUM 140 RTE_TCP_STC 141 RTE_TEMS_CONFIGURED_FLAG 141 RTE_TEMS_NAME_NODEID 142 RTE_TN3270_DXL_HOSTADDRESS 143 RTE_TN3270_DXL_LUGROUP 144 RTE_TN3270_DXL_TN3270PORT 144 RTE_TYPE 145 RTE_USERMODS_FLAG 146 RTE_USS_RTEDIR 146 RTE_VSAM_HILEV 148 RTE_VTAM_APPLID_PREFIX 148 RTE_VTAM_GBL_MAJOR_NODE 149 RTE_VTAM_LU62_DLOGMOD 150 RTE_VTAM_LU62_MODETAB 150 RTE_VTAM_NETID 151 RTE_X_KCNDLSSI_INITPARM_FLAG 152 RTE_X_KCNSTR00_PLEXCOLLECT 152 RTE_X_KCNSTR00_REFRESH 153 RTE_X_SECURITY_DATA_ABOVE 154 RTE_X_SECURITY_EXIT_LIB 154 Partition address field 176 Partition name field 23, 177, 213 password encryption 87 PDS See Persistent Datastore PDSE field 129 PerfMon See Performance Monitor Performance Monitor, Windows 280 Persistent Datastore 280 Port number (IP.PIPE for IPV6) field 60, 225 Port number (IP.PIPE) field 58, 224 Port number (IP.UDP) field 62, 229 Port number (IP6.UDP) field 63, 230 Port number (Secure IP.PIPE for IPV6) field 61, 226 Port number (Secure IP.PIPE) field 59, 227 Port number field 140, 144 procedures library 96 Protocol 1 field 182 Q Query access field 187 R Reconnect after TCP/IP recycle field Remote Procedure Call 281 Remote RTE for transport field 125 RESERVE parameter 255 RKANPARU library 1 17, 212 RPC See Remote Procedure Call RTE base alias specification field 135 RTE directory field 146 RTE name specification field 135 RTE parameters 107 RTE_ACF2_MACLIB batch parameter 81 RTE_BASE_MIDLEV batch parameter 107 RTE_BASE_NAME parameter 107 RTE_CAN_SS_IEFSSN_FMT batch parameter 112 RTE_CAN_SS_STC batch parameter 107 RTE_CAN_SS_WTO batch parameter 113 RTE_CAN_SSID batch parameter 113 RTE_CANSCN_STC parameter 107 RTE_CANSETE_STC parameter 108 RTE_CMS batch parameter 141 RTE_CMS_NAME batch parameter 142 RTE_CUA_SECURITY batch parameter 127 RTE_DEBUG_SYSOUT batch parameter 109 RTE_DEBUG_SYSOUT parameter 109 RTE_DESC batch parameter 109 RTE_DESCRIPTION parameter 109 RTE_ETE_STC batch parameter 108 RTE_FOLD_PWD batch parameter 125, 126 RTE_HCK_INTERVAL batch parameter 110 RTE_HCK_LOADLIB batch parameter 90 RTE_HCK_STC_INTERVAL parameter 110 RTE_HILEV batch parameter 110 RTE_HILEV parameter 110 RTE_JCL_SUFF batch parameter 111 RTE_JCL_SUFFIX parameter 111 RTE_KCNDLSSI_IEFSSN00_FORMAT parameter 112 RTE_KCNSTR00_SSID parameter 113 RTE_KCNSTR00_WTO parameter 113 RTE_KCNSTR00_XCFGROUP batch parameter 114 RTE_KCNSTR00_XCFGROUP parameter 114 RTE_LOAD_OPTIMIZE batch parameter 115 RTE_LOAD_OPTIMIZE parameter 115 RTE_LOAD_SHARED_LIBS batch parameter 116 RTE_LOAD_SHARED_LIBS parameter 116 RTE_LOG_SYSOUT batch parameter 116 RTE_LOG_SYSOUT parameter 116 RTE_NAME batch parameter 117 RTE_NAME parameter 117 RTE_PDS_BACKUP_FLAG parameter 118 RTE_PDS_BATCHINIT_FLAG parameter 117 RTE_PDS_BU batch parameter 118 RTE_PDS_CNT batch parameter 121 RTE_PDS_EXP batch parameter 119 RTE_PDS_EXPORT_FLAG parameter 119 RTE_PDS_EXT batch parameter 120 RTE_PDS_EXTRACT_FLAG parameter 120 RTE_PDS_FILE_COUNT parameter 121 RTE_PDS_HILEV batch parameter 121 RTE_PDS_HILEV parameter 121 RTE_PDS_KPDPROC_PREFIX parameter 122 RTE_PDS_PROC_PREF batch parameter 122 RTE_PDS_SMS_MGMT_CLAS batch parameter 122 RTE_PDS_SMS_MGMTCLAS parameter 122 RTE_PDS_SMS_STOR_CLAS batch parameter 123 RTE_PDS_SMS_STORCLAS parameter 123 RTE_PDS_SMS_UNIT parameter 124 RTE_PDS_SMS_VOLUME parameter 124 RTE_PDS_UNIT batch parameter 124 RTE_PDS_VOL batch parameter 124 RTE_PDSE batch parameter 129 RTE_REMOTE batch parameter 125 Index 299 RTE_REMOTE_LPAR_FLAG parameter 125 RTE_SECURITY_CLASS parameter 125 RTE_SECURITY_FOLD_PASSWORD_FLAG parameter 126 RTE_SECURITY_USER_LOGON parameter 127 RTE_SHARE batch parameter 128 RTE_SHARE parameter 128 RTE_SMS_MGMT_CLAS batch parameter 129 RTE_SMS_MGMTCLAS parameter 129 RTE_SMS_PDSE_FLAG parameter 129 RTE_SMS_STOR_CLAS batch parameter 130 RTE_SMS_STORCLAS parameter 130 RTE_SMS_UNIT parameter 131 RTE_SMS_VOLUME parameter 131 RTE_SMS_VSAM_MGMT_CLAS batch parameter 132 RTE_SMS_VSAM_MGMTCLAS parameter 132 RTE_SMS_VSAM_STOR_CLAS batch parameter 133 RTE_SMS_VSAM_STORCLAS parameter 133 RTE_SMS_VSAM_VOLUME parameter 133 RTE_STC_PREF batch parameter 134 RTE_STC_PREFIX parameter 134 RTE_SYS_PROCLIB batch parameter 96 RTE_SYS_VTAMLST batch parameter 99 RTE_SYSV batch parameter 136 RTE_SYSV_BASE_ALIAS batch parameter 135 RTE_SYSV_BASE_ALIAS parameter 135 RTE_SYSV_CMS_NAME batch parameter 137 RTE_SYSV_NAME batch parameter 135 RTE_SYSV_NAME parameter 135 RTE_SYSV_SYSVAR_FLAG parameter 136 RTE_SYSV_TEMS_NAME_NODEID parameter 137 RTE_SYSV_VTAM_APPLID_MODEL parameter 137 RTE_SYSV_VTAM_APPLID_PREFIX parameter 138 RTE_SYSV_VTAM_NETID parameter 139 RTE_SYSV_VTM_APPL_MODEL batch parameter 137 RTE_SYSV_VTM_APPL_PREF batch parameter 138 RTE_SYSV_VTM_NETID batch parameter 139 RTE_TCP_HOST batch parameter 139 RTE_TCP_HOST parameter 139 RTE_TCP_PORT batch parameter 140 RTE_TCP_PORT_NUM parameter 140 RTE_TCP_STC batch parameter 141 RTE_TCP_STC parameter 141 RTE_TEMS_CONFIGURED_FLAG parameter 141 RTE_TEMS_NAME_NODEID parameter 142 RTE_TN3270_DXL_HOSTADDRESS parameter 143 RTE_TN3270_DXL_LUGROUP parameter 144 RTE_TN3270_DXL_TN3270PORT parameter 144 RTE_TN3270_LUGROUP batch parameter 144 RTE_TN3270_TCP_HOST batch parameter 143 RTE_TN3270_TCP_PORT batch parameter 144 RTE_TYP batch parameter 145 RTE_TYPE parameter 145 RTE_UNIT batch parameter 131 RTE_USERMODS batch parameter 146 RTE_USERMODS_FLAG parameter 146 RTE_USS_RTEDIR batch parameter 146 RTE_USS_RTEDIR parameter 146 RTE_VOL batch parameter 131 RTE_VSAM_HILEV batch parameter 148 RTE_VSAM_HILEV parameter 148 RTE_VSAM_VOL batch parameter 133 RTE_VTAM_APPLID_PREFIX parameter 148 RTE_VTAM_GBL_MAJOR_NODE parameter 149 RTE_VTAM_LU62_DLOGMOD parameter 150 RTE_VTAM_LU62_MODETAB parameter 150 RTE_VTAM_NETID parameter 151 RTE_VTM_APPL_PREF batch parameter 148 300 RTE_VTM_CANDLE_NODE batch parameter 149 RTE_VTM_LU62_LOG batch parameter 150 RTE_VTM_LU62_LOGTAB batch parameter 150 RTE_VTM_NETID batch parameter 151 RTE_X_KCNDLSSI_INITPARM_FLAG parameter 152 RTE_X_KCNSTR00_PLEXCOLLECT parameter 152 RTE_X_KCNSTR00_REFRESH parameter 153 RTE_X_SECURITY_DATA_ABOVE parameter 154 RTE_X_SECURITY_EXIT_LIB parameter 154 runtime environment parameters 107 RTE_BASE_NAME 107 RTE_DEBUG_SYSOUT 109 RTE_DESCRIPTION 109 RTE_HCK_STC_INTERVAL 110 RTE_HILEV 110 RTE_JCL_SUFFIX 111 RTE_LOAD_OPTIMIZE 115 RTE_LOAD_SHARED_LIBS 116 RTE_LOG_SYSOUT 116 RTE_NAME 117 RTE_PDS_BACKUP_FLAG 118 RTE_PDS_EXPORT_FLAG 119 RTE_PDS_EXTRACT_FLAG 120 RTE_PDS_FILE_COUNT 121 RTE_PDS_HILEV 121 RTE_PDS_KPDPROC_PREFIX 122 RTE_PDS_SMS_MGMTCLAS 122 RTE_PDS_SMS_STORCLAS 123 RTE_PDS_SMS_UNIT 124 RTE_PDS_SMS_VOLUME 124 RTE_REMOTE_LPAR_FLAG 125 RTE_SECURITY_CLASS 125 RTE_SECURITY_FOLD_PASSWORD_FLAG 126 RTE_SECURITY_USER_LOGON 127 RTE_SHARE 128 RTE_SMS_MGMTCLAS 129 RTE_SMS_PDSE_FLAG 129 RTE_SMS_STORCLAS 130 RTE_SMS_UNIT 131 RTE_SMS_VOLUME 131 RTE_SMS_VSAM_MGMTCLAS 132 RTE_SMS_VSAM_STORCLAS 133 RTE_SMS_VSAM_VOLUME 133 RTE_STC_PREFIX 134 RTE_SYSV_BASE_ALIAS 135 RTE_SYSV_NAME 135 RTE_SYSV_SYSVAR_FLAG 136 RTE_SYSV_TEMS_NAME_NODEID 137 RTE_SYSV_VTAM_APPLID_MODEL 137 RTE_SYSV_VTAM_APPLID_PREFIX 138 RTE_SYSV_VTAM_NETID 139 RTE_TCP_HOST 139 RTE_TCP_PORT_NUM 140 RTE_TCP_STC 141 RTE_TEMS_CONFIGURED_FLAG 141 RTE_TEMS_NAME_NODEID 142 RTE_TN3270_DXL_HOSTADDRESS 143 RTE_TN3270_DXL_LUGROUP 144 RTE_TN3270_DXL_TN3270PORT 144 RTE_TYPE 145 RTE_USERMODS_FLAG 146 RTE_USS_RTEDIR 146 RTE_VSAM_HILEV 148 RTE_VTAM_APPLID_PREFIX 148 RTE_VTAM_GBL_MAJOR_NODE 149 RTE_VTAM_LU62_DLOGMOD 150 RTE_VTAM_LU62_MODETAB 150 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference runtime environment parameters (continued) RTE_VTAM_NETID 151 Runtime members analysis field 146 S SDUMP parameter 254 Secure Hypertext Transport Protocol 276 secure pipe 283 Secure Sockets Layer API 275, 276, 281 Security system field 127 self-describing agent 281 SELinux 281 ServerLocation parameter 203 ServerPort parameter 204 Sharing field 128 Simple Network Management Protocol 282 Simple Object Access Protocol 282 single sign-on 282 Situation Event Forwarder 282 Situation Update Forwarder 282 SMP/E 104 See System Modification Program/Extended SNA global location broker applid field 188 SNA LU6.2 logmode logmode field 189 SNA network ID field 189 SNA.PIPE field 11, 197 SNMP See Simple Network Management Protocol SOAP See Simple Object Access Protocol Software Support 267 Specify SAF security class 125 Specify the communication protocols in priority sequence field 11 SPIPE 275, 283 SQL See Structured Query Language SSL See Secure Sockets Layer SSM See System Service Monitors SSO See single sign-on Started task field 32, 141, 228 startup parameters, defined 1 STC prefix field 134, 216 Storage detail logging: Hours field 27, 216 Storage detail logging: Minutes field 28, 217 Storclas field 130, 133 Structured Query Language 283 SUF See Situation Update Forwarder support assistant 267 SYS1_MACLIB batch parameter 94 SYS1.ACF2.MACLIB library 81 SYS1.MACLIB macro library 94 SYS1.PARMLIB parameter library 95 SYS1.PROCLIB procedures library 96 SYS1.SAXREXEC library 96 SYS1.SBLSCLI0 library 96 SYS1.SISTMAC1 library 98 SYS1.VTAMLIB library 98 SYS1.VTAMLST library 99 SYSIN parameters 1 SYSOUT class field 116 SYSTCPD library 101 System Authorization Facility (SAF) security class name, specifying 125 system libraries Health Checker 96 SYS1.ACF2.MACLIB 81 SYS1.MACLIB 94 SYS1.PARMLIB 95 SYS1.PROCLIB 96 SYS1.SBLSCLI0 96 SYS1.SISTMAC1 98 SYS1.VTAMLIB 98 SYS1.VTAMLST 99 SYSTCPD 101 System Modification Program/Extended 273, 284 System Monitor Agent 283 System procedure field 96 System Service Monitors, Netcool/OMNIbus 283 System VTAMLST field 99 T Tape high-level qualifier field 168 Tape unit type field 168 Tape volser field 169 target libraries high-level qualifiers 104 TASKS parameter 257 TCP hostname field 185, 222 TCP port number field 186 TCP_DATA batch parameter 101 TCP/IP See Transmission Control Protocol/Internet Protocol TCP/IP system library 101 TCP/IP_USERID parameter 212, 228 TDW See Tivoli Data Warehouse telnet 284 TEMS application ID field 234 TEMS name field 137, 142, 183 TEMS Name field 34, 56 TEMS PPI sender field 191 TEMS secured field 183 TEMS version field 170 TEPS/e See Tivoli Enterprise Portal Server extended services Tivoli Data Warehouse 284 Tivoli Enterprise Monitoring Server parameters 157 GBL_DSN_CBC_SCCNOBJ 81 GBL_DSN_CBC_SCLBSID 82 GBL_DSN_CEE_SCEEBIND 82 GBL_DSN_CEE_SCEEBND2 82 GBL_DSN_CEE_SCEECPP 83 GBL_DSN_CEE_SCEELIB 83 GBL_DSN_CEE_SCEELKED 83 GBL_DSN_CEE_SCEELKEX 84 GBL_DSN_CEE_SCEEMSGP 84 GBL_DSN_CEE_SCEERUN 85 GBL_DSN_CEE_SCEESPC 85 GBL_DSN_CICS_CTG_DLL 86 GBL_DSN_CICS_SCTGSID 86 GBL_DSN_CICS_SDFHC370 86 GBL_DSN_CICS_SDFHLOAD 87 GBL_DSN_DB2_DSNEXIT 87 GBL_DSN_DB2_LOADLIB_Vn 88 GBL_DSN_DB2_RUNLIB_Vn 89 GBL_DSN_DB2_SDSNLOAD 89 GBL_DSN_IMS_RESLIB 90 GBL_DSN_IMS_SCEXLINK 91 Index 301 Tivoli Enterprise Monitoring Server parameters (continued) GBL_DSN_IMS_SFUNLINK 92 GBL_DSN_SYS1_BRODCAST 93 GBL_DSN_SYS1_CSSLIB 93 GBL_DSN_SYS1_HSMLOGY 94 GBL_DSN_SYS1_LINKLIB 94 GBL_DSN_SYS1_MODGEN 95 GBL_DSN_SYS1_SBPXEXEC 97 GBL_DSN_TCP_ETC_SERVICES 99 GBL_DSN_TCP_SEZACMTX 100 GBL_DSN_TCP_SEZARNT1 100 GBL_DSN_TCP_SEZATCP 100 GBL_DSN_TCP_SYSTCPD_TCPDATA_MFN 101 GBL_DSN_WMQ_SCSQANLE 102 GBL_DSN_WMQ_SCSQAUTH 102 GBL_DSN_WMQ_SCSQLOAD 103 GBL_HFS_JAVA_DIRn 103 KPP_AGT_AUDIT_ITM_DOMAIN 7 KPP_AGT_AUDIT_MAX_HIST 8 KPP_AGT_AUDIT_TRACE 9 KPP_AGT_CONFIGURATION_MODE 80 KPP_AGT_TEMA_SDA 33 KPP_X_AGT_CONFIRM_SHUTDOWN 67 KPP_X_AGT_DEBUG_TRACE 68 KPP_X_AGT_KDC_DEBUG 68 KPP_X_AGT_LGSA_VERIFY 69 KPP_X_AGT_LSRPOOL_BUFFER_NUM 70 KPP_X_AGT_LSRPOOL_BUFSIZEE 71 KPP_X_AGT_SDUMP_SVC_SYS1_DUMP 71 KPP_X_AGT_STORAGE_LIMIT_EXTEND 72 KPP_X_AGT_STORAGE_LIMIT_PRIMARY 73 KPP_X_AGT_STORAGE_RESERVE_EXT 73 KPP_X_AGT_STORAGE_RESERVE_PRI 74 KPP_X_AGT_STORAGE_STGDEBUG 75 KPP_X_AGT_TASKS_ATTACHED_NUM 75 KPP_X_HUB_BKUP1_TCP_HOST 76 KPP_X_HUB_BKUP1_TEMS_VTAM_NETID 76 KPP_X_HUB_BKUP1_VTAM_APPL_GLBBKR 77 KPP_X_HUB_TCP_HOST 77 KPP_X_HUB_TEMS_VTAM_NETID 78 KPP_X_HUB_VTAM_APPL_GLBBKR 78 KPP_X_PD_HISTCOLL_DATA_AGT_STC 79 KDE_TRANSPORT 159, 160, 161 KDS_AUDIT_ITM_DOMAIN 157 KDS_AUDIT_MAX_HIST 157 KDS_AUDIT_TRACE 158 KDS_HUB_TCP_HOST 159 KDS_HUB_TCP_PIPE_PORT_NUM 159 KDS_HUB_TCP_PIPE6_PORT_NUM 160 KDS_HUB_TCP_PIPE6S_PORT_NUM 161 KDS_HUB_TCP_PIPES_PORT_NUM 162 KDS_HUB_TCP_UDP_PORT_NUM 163 KDS_HUB_TCP_UDP6_PORT_NUM 164 KDS_HUB_TEMS_HA_TYPE 165 KDS_HUB_VTAM_APPL_GLB_BROKER 166 KDS_HUB_VTAM_NETID 166 KDS_KMS_SDA 167 KDS_MIG_TAPE_HILEV 168 KDS_MIG_TAPE_UNIT 168 KDS_MIG_TAPE_VOL 169 KDS_MIG_VER 170 KDS_MIG_VSAM_HILEV 170 KDS_NONSTDnn_DSN 171 KDS_NONSTDnn_MBR 172 KDS_NONSTDnn_PARM 173 KDS_NSNEWnn_VALUE 174 KDS_NSOLDnn_VALUE 175 302 Tivoli Enterprise Monitoring Server parameters (continued) KDS_PA 175 KDS_PA_PARTITION_ADDRESS 176 KDS_PA_PARTITION_NAME 177 KDS_PA_ROW 177 KDS_PD 178 KDS_PD_CYL 178 KDS_PD_GRP 179 KDS_PD_ROW 180 KDS_PH 180 KDS_PH_ROW 181 KDS_PH_TEMS_ALIAS_NAME 181 KDS_PH_TEMS_COMM_PROTOCOL1 182 KDS_PH_TEMS_KSH_SECURE 183 KDS_PH_TEMS_NAME_NODEID 183 KDS_PH_TEMS_RTE 184 KDS_PH_TEMS_SYSV_FLAG 184 KDS_PH_TEMS_TCP_HOST 185 KDS_PH_TEMS_TCP_HOST_LEN 186 KDS_PH_TEMS_TCP_PORT_NUM 186 KDS_PH_TEMS_USER_QUERY 187 KDS_PH_TEMS_USER_UPDATE 187 KDS_PH_TEMS_VTAM_APPL_GLB_BROKER 188 KDS_PH_TEMS_VTAM_LU62_DLOGMOD 189 KDS_PH_TEMS_VTAM_NETID 189 KDS_PPI_RECEIVER 190 KDS_PPI_SENDER 191 KDS_PU 192 KDS_PU_ROW 192 KDS_PU_TEMS_NAME_NODEID 193 KDS_PU_TEMS_RTE 193 KDS_PU_TEMS_USER_ID 194 KDS_PU_TEMS_USER_QUERY 194 KDS_PU_TEMS_USER_UPDATE 195 KDS_TEMA_SDA 196 KDS_TEMS_COMM_ADDRESS_XLAT 196 KDS_TEMS_COMM_PROTOCOLn 197 KDS_TEMS_DRA_FLAG 198 KDS_TEMS_EIF_BUFFER_EVENT_MAXSZE 199 KDS_TEMS_EIF_DISABLE_TEC_EMITTER 200 KDS_TEMS_EIF_EVENT_LISTENER 201 KDS_TEMS_EIF_FLAG 202 KDS_TEMS_EIF_HOST 203 KDS_TEMS_EIF_PORT_NUM 204 KDS_TEMS_FLUSH_LSR_BUFR_INT_HR 204 KDS_TEMS_FLUSH_LSR_BUFR_INT_MIN 205 KDS_TEMS_HA_EXCL_LIST 206 KDS_TEMS_HA_TYPE 206, 258 KDS_TEMS_HTTP_PORT_NUM 207 KDS_TEMS_ICU_LANGUAGE_LOCALE 208 KDS_TEMS_KDC_DEBUG 210 KDS_TEMS_KGL_WTO 211 KDS_TEMS_KLX_TCP_TOLERATERECYCLE 212 KDS_TEMS_PARTITION_NAME 213 KDS_TEMS_SECURITY_KAES256_ENCKEY 214 KDS_TEMS_SECURITY_KDS_VALIDATE 214 KDS_TEMS_SOAP_SERVER_FLAG 215 KDS_TEMS_STC 216 KDS_TEMS_STORAGE_DETAIL_INT_HR 216 KDS_TEMS_STORAGE_DETAIL_INT_MIN 217 KDS_TEMS_STORAGE_DETAIL_LOG_FLAG 218 KDS_TEMS_STORAGE_LIMIT_EXTEND 219 KDS_TEMS_STORAGE_LIMIT_PRIMARY 220 KDS_TEMS_STORAGE_MINIMUM_EXTEND 221 KDS_TEMS_TCP_HOST 222 KDS_TEMS_TCP_KDEB_INTERFACELIST 223 KDS_TEMS_TCP_PIPE_PORT_NUM 224 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Tivoli Enterprise Monitoring Server parameters (continued) KDS_TEMS_TCP_PIPE6_PORT_NUM 225 KDS_TEMS_TCP_PIPE6S_PORT_NUM 226 KDS_TEMS_TCP_PIPES_PORT_NUM 227 KDS_TEMS_TCP_STC 228 KDS_TEMS_TCP_UDP_PORT_NUM 229 KDS_TEMS_TCP_UDP6_PORT_NUM 230 KDS_TEMS_TYPE 232 KDS_TEMS_VIRTUAL_IP_ADDRESS 233 KDS_TEMS_VTAM_APPL_CUA_OPER 233 KDS_TEMS_VTAM_APPL_GLB_BROKER 234 KDS_TEMS_VTAM_APPL_KDS_VTAMID 234 KDS_TEMS_VTAM_APPL_KDSINVPO 235 KDS_TEMS_VTAM_APPL_LLB_BROKER 236 KDS_TEMS_VTAM_APPL_OPERATOR 237 KDS_TEMS_VTAM_APPL_PREFIX 237 KDS_TEMS_VTAM_LU62_DLOGMOD 238 KDS_TEMS_VTAM_LU62_MODETAB 238 KDS_TEMS_VTAM_NETID 239 KDS_TEMS_VTAM_NODE 240 KDS_X_HUB_BKUP1_TCP_HOST 240 KDS_X_HUB_BKUP1_TEMS_VTAM_NETID 241 KDS_X_HUB_BKUP1_VTAM_APPL_GLBBKR 241 KDS_X_KDCFC_RXLIMIT 242 KDS_X_KDE_TRANSPORT_HTTP_OPTIONS 242 KDS_X_KDE_TRANSPORT_OPTIONS 243 KDS_X_KDE_TRANSPORT_POOL_OPTIONS 244 KDS_X_SECURITY_RESOURCE_CLASS 244 KDS_X_SECURITY_USER_EXIT 245 KDS_X_STC_SYSTCPD_INCLUDE_FLAG 246 KDS_X_TEMS_CONFIRM_SHUTDOWN 246 KDS_X_TEMS_DEBUG_TRACE 247 KDS_X_TEMS_EIF_BFR_EVT 248 KDS_X_TEMS_EIF_BFR_EVT_PATH 248 KDS_X_TEMS_EIF_FLT_ATTR1 249 KDS_X_TEMS_EIF_FLT_CLASS1 249 KDS_X_TEMS_EIF_FLT_MODE 250 KDS_X_TEMS_FRAME_STACK_SIZE 250 KDS_X_TEMS_LGSA_VERIFY 251 KDS_X_TEMS_LOGBLOCK_RKLVLOG_SIZE 251 KDS_X_TEMS_LOGBUFS_RKLVLOG_BUFSZ 252 KDS_X_TEMS_LSRPOOL_BUFFER_NUM 252 KDS_X_TEMS_LSRPOOL_BUFSIZE 253 KDS_X_TEMS_LSRSTRNO_CONCURRENT 254 KDS_X_TEMS_SDUMP_SVC_SYS1_DUMP 254 KDS_X_TEMS_STORAGE_RESERVE_PRI 255 KDS_X_TEMS_STORAGE_STGDEBUG 256 KDS_X_TEMS_TASKS_ATTACHED_NUM 257 KDS_X_TEMS_WTO 257 KOB_TOM_STC 259 KOB_TOM_VTAM_APPL_LOGON 260 KOB_TOM_VTAM_NODE 261 LIMIT 220 RTE_CANSCN_STC 107 RTE_CANSETE_STC 108 RTE_KCNDLSSI_IEFSSN00_FORMAT 112 RTE_KCNSTR00_SSID 113 RTE_KCNSTR00_WTO 113 RTE_KCNSTR00_XCFGROUP 114 RTE_PDS_BATCHINIT_FLAG 117 RTE_X_KCNDLSSI_INITPARM_FLAG 152 RTE_X_KCNSTR00_PLEXCOLLECT 152 RTE_X_KCNSTR00_REFRESH 153 RTE_X_SECURITY_DATA_ABOVE 154 RTE_X_SECURITY_EXIT_LIB 154 Tivoli Enterprise Portal Server extended services 284 Tivoli Integrated Portal 285 Tivoli OMEGAMON Manager 274, 285 TLS 276 TMS encryption key field 214 TMS:Engine (non-CUA) field 39 TMS:Engine default values 2 TMS:Engine operator (non-CUA) field 237 TMS:Engine VTAM program operator field 37, 233, 235 TOM See Tivoli OMEGAMON Manager Transmission Control Protocol/Internet Protocol 285 Transport Layer Security API 276 Type (Hub or Remote) field 232 Type field 145 U UDP See User Datagram Protocol Unit field 131 UNIX System Services (USS) 146 Update access field 187 Use z/OS system variables? field 136 User Datagram Protocol 285 User ID field 194 V Validate security field 214 Virtual IP Address (VIPA) type field 35, 233 Volser field 131, 133 VSAM high-level qualifier field 170 VTAM logmode tables 98 macro library 98 VTAMLST library 99 VTAM applid for Alert Adapter field 36 VTAM load library field 98 VTAM macro library field 98 VTAM major node name field 149 W WAV file 286 where configured parameters are stored 1 wildcard 286 Windows Dynamic Link Library 274 Windows Management Instrumentation API 286 Windows Performance Monitor 280 WMI See Windows Management Instrumentation WTO parameter 257 X XML Extensible Markup Language. 286 Z z/OS 286 Index 303 304 IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Readers’ Comments — We'd Like to Hear from You IBM Tivoli OMEGAMON XE and IBM Tivoli Management Services on z/OS Common Parameter Reference Version 6.2.3 Fix Pack 1 Publication No. SC14-7280-01 We appreciate your comments about this publication. Please comment on specific errors or omissions, accuracy, organization, subject matter, or completeness of this book. The comments you send should pertain to only the information in this manual or product and the way in which the information is presented. For technical questions and information about products and prices, please contact your IBM branch office, your IBM business partner, or your authorized remarketer. When you send comments to IBM, you grant IBM a nonexclusive right to use or distribute your comments in any way it believes appropriate without incurring any obligation to you. IBM or any other organizations will only use the personal information that you supply to contact you about the issues that you state on this form. Comments: Thank you for your support. Send your comments to the address on the reverse side of this form. If you would like a response from IBM, please fill in the following information: Name Address Company or Organization Phone No. Email address SC14-7280-01 ___________________________________________________________________________________________________ Readers’ Comments — We'd Like to Hear from You Cut or Fold Along Line _ _ _ _ _ _ _Fold _ _ _and _ _ _Tape _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _Please _ _ _ _ _do _ _not _ _ staple _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _Fold _ _ _and _ _ Tape ______ NO POSTAGE NECESSARY IF MAILED IN THE UNITED STATES BUSINESS REPLY MAIL FIRST-CLASS MAIL PERMIT NO. 40 ARMONK, NEW YORK POSTAGE WILL BE PAID BY ADDRESSEE _________________________________________________________________________________________ Fold and Tape Please do not staple Fold and Tape SC14-7280-01 Cut or Fold Along Line Printed in USA SC14-7280-01