Created: | Updated:


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}                              

# 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            
# syntax : host=[IronTap_host_address|kafka_bootstrap_servers]

# 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 :                            
# kafkaTopic defines the kafka cluster topic used to stream SMF records.
#  Required if mode=kakfa                                               
# syntax : kafkaTopic=kafka_topic_name                                  

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 file. The default path is              
#  default : $APP_HOME/kafka/  
#  syntax : kafkaConfig=/producer/properties/file               
# timeout defines the timeout for SMF record streaming in seconds.
# timeout=ä0-2147483647ü                                          

# reconnect defines the number of seconds to wait before reconnecting the
#  stream after a timeout or error.                                     
# default : 7                                                           
# syntax : reconnect=ä0-2147483647ü         

# monitor.thruput.interval defines an interval in seconds to display throughput
#  statistics. Only takes effect if com.msc.zos.ziris=FINE in
# default : 60 seconds                                                  
# syntax : monitor.thruput.interval=ä5-3600ü                            

# alias is used to identify this client to the SMF receiver. 
# if mode=kafka, alias will overwrite the Kafka Producer property                       
# alias=ziris_client_alias_name                   

Additional configuration when mode=kakfa

Default Kafka producer properties 

The installation package contains default properties for z/IRIS clients in the $APP_HOME/kafka/ file.

Customizing Kafka producer properties

Click here expand instructions ...

Avoid making customizing as this may be overwritten by z/RIS software updates.

Create a new 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.