Configuring client IP statistics

Client IP statistics provide client level details such as the total number of allocated connections, the client versions, and so on. This granular level of visibility into client connections give you a comprehensive insight into the functioning of each client connected to CICS® Transaction Gateway. All the activities will be logged in JSON format.

To enable client IP statistics, you should define the following parameters in the GATEWAY section of the configuration file (ctg.ini):

Table 1. Parameters for client IP statistics
Parameter Description
Clientipstats Set to 'ON' to enable client IP statistics. The default value in the absence of this parameter is 'OFF'.
clientIPstats@file.parameters Takes multiple inputs such as file name, file size, and so on.
Filename The path name of the statistics file where stats messages are written if you enable client IP statistics.
Maxfiles The maximum number of files that is generated when you enable client IP statistics.
Filesize The rolling file size after which a new statistics file will be generated. By default, the file size is expressed in KB.

Sample configuration

clientipstats=on
clientIPstats@file.parameters=filename=/var/cicscli/clientIPstats.json;maxfiles=5;filesize=100
Note:
  • Client IP statistics is dependent on statistics recording. In the configuration file, enable statsrecording, as shown in the following example:
    statsrecording=on
  • The client IP statistics interval is picked from up the statsinterval parameter. Therefore, statsrecording must be set to ON.