Configure z/IRIS Clients
Created: | Updated:
ziris.comm.config
Customize the $APP_HOME/lib/ziris.comm.config as required.
Required parameters and options
# ziris.comm.config required parameters
# mode defines the technology used to stream SMF records.
# syntax : mode={tcp!kafka}
mode=tcp
# host refers to the host address destination for SMF record streaming.
# If mode=tcp host is required and refers to the IronTap host address.
# If mode=kafka, host is a list of kafka bootstrap servers which overrides
# all bootstrap servers listed in kafka producer.properties
# syntax : host=[IronTap_host_address|kafka_bootstrap_servers]
host=irontap.mycompany.com:1337
# inmem is required and defines which active SMF in-memory resources z/IRIS will
# read SMF records from. The inmem statement can be specified multiple times to
# configure multiple in-memory resources.
# syntax : inmem=smf.in.memory.resource.name
inmem=IFASMF.INMEM.SMF102
# kafkaTopic defines the kafka cluster topic used to stream SMF records.
# Required if mode=kakfa
# syntax : kafkaTopic=kafka_topic_name
kafkaTopic=smf
CODE
Optional parameters and options
# ssl activates SSL for mode=tcp
# default : n (not active)
syntax : ssl=y!n
# kafkaConfig defines an alternate absolute path to a
# kafka producer.properties file. The default path is
# default : $APP_HOME/kafka/default-ziris-producer.properties
# syntax : kafkaConfig=/producer/properties/file
kafkaConfig=kafka/default-ziris-producer.properties
# timeout defines the timeout for SMF record streaming in seconds.
# timeout=ä0-2147483647ü
timeout=7
# reconnect defines the number of seconds to wait before reconnecting the
# stream after a timeout or error.
# default : 7
# syntax : reconnect=ä0-2147483647ü
reconnect=7
# monitor.thruput.interval defines an interval in seconds to display throughput
# statistics. Only takes effect if com.msc.zos.ziris=FINE in logging.pr
# default : 60 seconds
# syntax : monitor.thruput.interval=ä5-3600ü
monitor.thruput.interval=5
# alias is used to identify this client to the SMF receiver.
# if mode=kafka, alias will overwrite the client.id Kafka Producer property
# alias=ziris_client_alias_name
alias=alias_name
CODE
Additional configuration when mode=kakfa
Default Kafka producer properties
The installation package contains default properties for z/IRIS clients in the $APP_HOME/kafka/default-ziris-producer.properties file.
Customizing Kafka producer properties
Workload manager considerations
The z/IRIS client can be configured as a discretionary workload in WLM. This prevents zIIP workloads from being offloaded to general purpose processors.