Modifying the default settings for the client side logger

z/OSMF core provides default settings for several properties used to manage the client side logger. This section explains how to modify those default settings.

The default settings are described in the following sections:

Displaying the default settings

To display a list of all the default values for the client side logger properties, use the following HTTP request:
GET https://{host}:{port}/zosmf/IzuUICommon/UILogManager?_OPER=getprops&loggername={name}
where:
  • "https://{host}:{port}" specifies the target system address and port.
  • "zosmf/IzuUICommon/UILogManager" identifies the client logger interface.
  • "OPER=getprops&loggername=name" returns all the default settings for the specified client side logger (name).

Pushing messages to the z/OSMF log

The client side logger uses the severity of JavaScript log statements to determine when queued messages are pushed to the z/OSMF log. That is, when the severity of a JavaScript log statement equals or exceeds the push level, the client side logger immediately sends the queued messages to the z/OSMF log. The default push level is INFO. To manage the push level, use the following HTTP requests:
GET https://{host}:{port}/zosmf/IzuUICommon/UILogManager?_OPER=getLevel&loggername={name}
GET https://{host}:{port}/zosmf/IzuUICommon/UILogManager?_OPER=setLevel&level={level}&
    loggername={name}
GET https://{host}:{port}/zosmf/IzuUICommon/UILogManager?_OPER=push&loggername={name}
where:
  • "https://{host}:{port}" specifies the target system address and port.
  • "zosmf/IzuUICommon/UILogManager" identifies the client logger interface.
  • "OPER=getLevel&loggername={name}" returns the current push level for the specified client side logger (name).
  • "OPER=setLevel&level={level}&loggername={name}" sets the push level (level) for the specified client side logger (name), and returns the push level. Valid levels are FINE, FINER, FINEST, INFO, WARNING, and SEVERE.
  • "OPER=push&loggername={name}" pushes the queued messages for the specified client side logger (name) to the z/OSMF log.

Logging messages to a popup window

By default, the client side logger routes the JavaScript log statements to the z/OSMF log. You can use the setpopup property to route the statements to a popup window in the z/OSMF user interface. To indicate where to display the JavaScript log statements, use the following HTTP requests:
GET https://{host}:{port}/zosmf/IzuUICommon/UILogManager?_OPER=getpopup&loggername={name}
GET https://{host}:{port}/zosmf/IzuUICommon/UILogManager?_OPER=setpopup&loggername={name}
    &popup=true|false
where:
  • "https://{host}:{port}" specifies the target system address and port.
  • "zosmf/IzuUICommon/UILogManager" identifies the client logger interface.
  • "OPER=getpopup&loggername=name" returns true if the specified client side logger (name) will append messages to a popup window. Otherwise, false is returned.
  • "OPER=setpopup&loggername=name&popup=true|false" indicates whether to append messages to a popup window for the specified client side logger (name). Set this property to true to append messages to a popup window. Otherwise, set this property to false.

If you specify true for the setfailnotify property, messages will also be displayed in a popup window.

Redirecting messages that cannot be written to the z/OSMF log

If an error occurs that prevents the client's messages from being written to the z/OSMF log, you can use the setfailnotify property to indicate whether to redirect those messages to a popup window. This failover action allows for the client data to be retained until the error is resolved. By default, this property is set to false. 
GET https://{host}:{port}/zosmf/IzuUICommon/UILogManager?_OPER=getfailnotify&
    loggername={name}
GET https://{host}:{port}/zosmf/IzuUICommon/UILogManager?_OPER=setfailnotify&
    loggername={name}&failnotify=true|false
where:
  • "https://{host}:{port}" specifies the target system address and port.
  • "zosmf/IzuUICommon/UILogManager" identifies the client logger interface.
  • "OPER=getfailnotify&loggername=name" returns true if the specified client side logger (name) will redirect messages to a popup window when an unexpected error occurs. Otherwise, false is returned.
  • "OPER=setfailnotify&loggername=name&failnotify=true|false" indicates whether to redirect messages to a popup window for the specified client side logger (name). Set this property to true to redirect messages to a popup window when an error occurs. Otherwise, set this property to false.

Setting the interval for flushing the queue

The client side logger uses the flush interval to determine how often to flush the message queue and send messages to the z/OSMF log. By default, the logger flushes the message queue every 60 seconds. You can use the setinterval property to modify this value.
GET https://{host}:{port}/zosmf/IzuUICommon/UILogManager?_OPER=getinterval&
    loggername={name}
GET https://{host}:{port}/zosmf/IzuUICommon/UILogManager?_OPER=setinterval&
    loggername={name}&interval={n}
where:
  • "https://{host}:{port}" specifies the target system address and port.
  • "zosmf/IzuUICommon/UILogManager" identifies the client logger interface.
  • "OPER=getinterval&loggername=name" returns the flush interval for the specified client side logger (name).
  • "OPER=setinterval&loggername=name&interval=n" sets the flush interval for the specified client side logger (name) to the specified number of seconds (n). You can specify a minimum of 10 seconds, and a maximum of 3600 seconds.
Parent topic: Logging client messages in the z/OSMF log