Parameters

See z/OS MVS Initialization and Tuning Reference for details on the system logger ZAI statement and parameter settings in SYS1.PARMLIB member IXGCNFxx. Also see Preparing for z/OS zAware log stream client usage in z/OS MVS Setting Up a Sysplex for details on getting Operlog log data to the IBM zAware server.

The parameters for SETLOGER ZAI are:

SERVER({NONE | host_name | IP_addr})

Specifies the host name (as defined by domain name system, DNS) or TCP/IP location where the IBM z Advanced Workload Analysis Reporter ( IBM zAware) server is running and will receive the z/OS® IBM zAware log stream client data. A value of NONE indicates no IBM zAware server is desired and does not indicate a server name.

ZAI SERVER and PORT changes are not honored if there are existing socket connections to the IBM zAware server. Disconnect the applicable log streams or quiesce any existing socket connect(s) via the SETLOGR FORCE,ZAIQUIESCE command.

D LOGGER,IXGCNF[,ZAI] and D LOGGER,STatus,ZAI commands display the details on the system logger z/OS IBM zAware log stream client information

PORT(port_num)

Identifies the port number associated with the SERVER specification for the IBM zAware server.

D LOGGER,IXGCNF[,ZAI] and D LOGGER,STatus,ZAI commands display the details on the system logger z/OS IBM zAware log stream client information.

LOGBUFMAX(value)

Identifies the maximum amount of storage buffers (in gigabytes) to be used by system logger for managing z/OS IBM zAware log stream client data being sent to the IBM zAware server. It allows clients the ability to set a threshold (for their environment) on the amount of (pageable, above the 2 gigabyte bar) storage that can be utilized on their z/OS IBM zAware system in the case of spiking or inhibited data flow.

If the maximum for these storage buffers are used, then any new log stream data needing to be sent to the IBM zAware server will be lost. If the value specified for the LOGBUFMAX parameter is less than the storage buffers currently in-use, then system logger will not buffer any new log data until the buffers available are less than the new designated value. Reducing this value below the current in-use buffers will cause system logger to put the LOGBUFFULL policy specification into effect.

D LOGGER,IXGCNF[,ZAI] and D LOGGER,STatus,ZAI commands display the details on the system logger z/OS IBM zAware log stream client buffer usage.

LOGBUFWARN(nn)

Specifies the z/OS IBM zAware log stream client manager buffer warning level percentage when system logger will start issuing message IXG375E.

When the z/OS IBM zAware log stream client manager is using this percent of overall buffer space (see LOGBUFMAZ), message IXG375E will be issued. As the buffer pool is expanded/extended by the next incremental amount, system logger will issue an updated instance of IXG375E with the new buffer storage percent in use indication.

As in-use system logger z/OS IBM zAware log stream client buffers are no longer needed, the buffers will be released and messages IXG375E will be issued for the new percent in use. Once the overall percentage of buffers in use is at least 5% below the LOGBUFWARN value, system logger will DOM message IXG375E.

D LOGGER,IXGCNF[,ZAI] and D LOGGER,STatus,ZAI commands display the details on the system logger z/OS IBM zAware log stream client buffer usage.

LOGBUFFULL({MSG|QUIESCE})

Specifies the action to be taken by system logger when the z/OS IBM zAware log stream client manager buffers become full (see LOGBUFMAX).

MSG indicates system logger should continue attempting to send log data to the IBM zAware server and keep a count of the number of log blocks that could not be buffered and were lost. When buffers become available, then message IXG383I will be issued indicating that not all the log data was sent to the IBM zAware server.

QUIESCE indicates that when system logger reaches the full amount of buffers then disconnect the socket connection to the IBM zAware server. The socket connection will remain disconnected until either a SETLOGR command (for example, SETLOGR FORCE,ZAICONNECT,ALL) or SET IXGCNF= command that has specifications to connect to the IBM zAware server. No z/OS IBM zAware log stream client data will be maintained while in the quiesced state, meaning the buffers holding the log data for this purpose will be released (freed). Logger will issue message IXG382I for each log stream that is quiesced.

D LOGGER,IXGCNF[,ZAI] and D LOGGER,STatus,ZAI commands display the details on the system logger z/OS IBM zAware log stream client buffer usage.

Example 1, SETLOGR ZAI,LOGBUFMAX(2):

Modify the system logger z/OS IBM zAware log stream client maximum to 2 gigabytes of storage on the z/OS image for buffering log data to be sent to the IBM zAware server.

    SY1  SETLOGR ZAI,LOGBUFMAX(2)                                         
    SY1  IXG651I SETLOGR ZAI COMMAND ACCEPTED                             
    FOR LOGGER SYSTEM CONFIGURATION CHANGE                                
    SY1  IXG731I LOGGER PARAMETER PROCESSING COMPLETED SUCCESSFULLY FOR   
     SETLOGR REQUEST                                                      
    SY1  IXG607I   17.19.02  LOGGER DISPLAY 670                           
    LOGGER PARAMETER OPTIONS                                              
    KEYWORD           SOURCE   VALUE                                      
    ----------------- -------- -------------------------------------------
    CTRACE            DEFAULT  CTILOG00                                   
    MONITOR OFFLOAD                                                       
     WARNALLOC        SETLOGR  00015                                      
     ACTIONALLOC      SETLOGR  00025                                      
     WARNRECALL       DEFAULT  00060                                      
     ACTIONRECALL     DEFAULT  00120                                      
    ZAI                                                                   
     SERVER IPV4      IPL (AX) 129.42.38.1                                  
     PORT             IPL (AX) 5555                                       
     LOGBUFMAX        SETLOGR  02                                         
     LOGBUFWARN       IPL (AX) 50                                         
     LOGBUFFULL       DEFAULT  MSG

Example 2, SETLOGR ZAI,SERVER(NONE):

Modify system logger to not allow any z/OS IBM zAware log stream clients on the z/OS image. First, quiesce any existing z/OS IBM zAware log stream client socket connections to the IBM zAware server, then update the IBM zAware server information.

SETLOGR FORCE,ZAIQUIESCE,ALL
SETLOGR ZAI,SERVER(NONE)

    SY1  SETLOGR FORCE,ZAIQUIESCE,ALL                                     
    SY1  IXG371E ZAI LOGSTREAM CLIENT MANAGER UNAVAILABLE.                
    REASON:  SETLOGR COMMAND REQUEST.                                     
    SY1  IXG651I SETLOGR FORCE ZAIQUIESCE COMMAND ACCEPTED                
    FOR ALL LOGSTREAMS                                                    
    SY1  IXG382I ZAI LOGSTREAM CLIENT QUIESCED                            
    FOR LOGSTREAM SYSPLEX.OPERLOG                                         
    REASON:  SETLOGR COMMAND REQUEST.                                     

    SY1  SETLOGR ZAI,SERVER(NONE)                                         
    SY1  IXG651I SETLOGR ZAI COMMAND ACCEPTED                             
    FOR LOGGER SYSTEM CONFIGURATION CHANGE                                
    SY1  IXG731I LOGGER PARAMETER PROCESSING COMPLETED SUCCESSFULLY FOR   
     SETLOGR REQUEST                                                      
    SY1  IXG607I   17.20.25  LOGGER DISPLAY 683                           
    LOGGER PARAMETER OPTIONS                                              
    KEYWORD           SOURCE   VALUE                                      
    ----------------- -------- -------------------------------------------
    CTRACE            DEFAULT  CTILOG00                                   
    MONITOR OFFLOAD                                                       
     WARNALLOC        SETLOGR  00015                                      
     ACTIONALLOC      SETLOGR  00025                                      
     WARNRECALL       DEFAULT  00060                                      
     ACTIONRECALL     DEFAULT  00120                                      
    ZAI                                                                   
     SERVER           SETLOGR  NONE                                       
     PORT             IPL (AX) 5555                                       
     LOGBUFMAX        SETLOGR  02                                         
     LOGBUFWARN       IPL (AX) 50                                         
     LOGBUFFULL       DEFAULT  MSG