z/IRIS Client Started Task

Created: 29 Mar 2021 | Updated: 13 Jul 2021

Create a z/IRIS client PROCLIB member

Upload the ZIRISPRC started task procedure and the ZIRISJVM JZOS procedure files from zIRISzOSClient.v%.%.%.zip to a concatenated PROCLIB data set.
Change $APP_HOME in JCL to the $APP_HOME directory created for z/IRIS in ZFS.
If mode=kafka for SMF records streaming via a predefined and network accessible Kafka cluster, uncomment the following line and define the Kafka home directory to z/IRIS z/OS:
```
# export KAFKA_HOME=/usr/lpp/kafka/kafka_2.11-2.3.0
```
BASH
Change $JVAHOME to the $JAVA_HOME directory where IBM Java version 8 resides.
Save the PROCLIB member.
Allocate the surrogate userid defined by the RACFJCL job:
RACF RDEFINE syntax example
```
RDEFINE STARTED JOBNAME.** UACC(NONE) STDATA(USER(ziris) +
GROUP(SYS1) TRUSTED(YES))
```
CODE

Starting z/IRIS clients

To start the z/IRIS client, issue the following MVS Command:

Start z/IRIS started task syntax

/S ziris

CODE

where ziris is the member name of the z/IRIS PROCLIB member.

When z/IRIS reports a failed connection during start-up, check that either the z/IRIS Linux server is active or that the Apache Kafka cluster is running with the accessible topics and brokers.

Stopping z/IRIS clients

To stop the started task, issue the following MVS Command:

Stop z/IRIS started task syntax

/P ziris

CODE

Where ziris is the name of running z/IRIS STC Address Space.

Modify commands

z/OS users with SDSF and MVS Command Permissions, can interact with the z/IRIS client Started Task through MVS Modify Commands.
z/IRIS MVS Command Syntax :

Modify command syntax for z/IRIS started task

/F ziris,APPL=cmd

CODE

where:

ziris: is the name of the z/IRIS STC
cmd: is a valid z/IRIS Modify Command

HELP

lists and displays information about available commands:

z/IRIS HELP modify command

/F ziris,APPL=HELP

CODE

STATUS

displays a summary of current connections with SMF and the z/IRIS IronTap Linux Server.

z/IRIS STATUS modify command syntax

/F ziris,APPL=STATUS

CODE

Sample response:

Sample output from STATUS modify command

RESPONSE=CPAC      BPXM023I (SMFRAPI) ZIRIS will accept the STOP(P) and
RESPONSE=Modify(F) commands                                            
RESPONSE=CPAC      BPXM023I (SMFRAPI)                                  
RESPONSE=CPAC      ZIRIS STATUS Jul 18, 2018, 12:01:34 PM              
RESPONSE=CPAC      TCP Connection:  active to /172.25.999.999:9999     
RESPONSE=CPAC      Number of Listeners: 1                              
RESPONSE=CPAC      Listener 1 streaming from IFASMF.INMEM.SMFDB2

CODE