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

Click here expand instructions ...

Avoid making customizing default-ziris-producer.properties as this may be overwritten by z/RIS software updates.

Create a new producer.properties file :

  1. Copy the sample producer properties file in the $KAFKA_HOME/config directory.

  2. Edit the properties as required.

  3. Specify the new producer properties path and file name in the ziris.comm.config file using the kafkaConfig parameter

For more information about required properties for z/IRIS SMF streaming, see Apache Kafka - Configuration Guide .


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.