To change the log level for one or more z/OSMF services, select the z/OSMF Diagnostic
Assistant icon in the z/OSMF desktop.
About this task
For diagnostic purposes, you might be asked by IBM® Support
to modify the trace state for one or more z/OSMF services. The trace settings are read when the
server is started. The trace output is written to files in the z/OSMF logs directory.
You must be a system administrator to change the level of error log for the z/OSMF services.
Procedure
-
Select the z/OSMF Diagnostic Assistant icon in the z/OSMF desktop.
-
Select the tab Set the z/OSMF logging level.
The services table shows the z/OSMF services for which the log level can be set. Initially,
the table is empty. To modify the log level for a particular z/OSMF service, you must first add the
service to this table.
-
To add a z/OSMF service to the table, select Add service.
The Add service option displays when all service checkboxes are
cleared.
A filter function is provided for string searches.
If a z/OSMF service is not displayed in the list, the service is not enabled on your system.
To enter the name of a z/OSMF service that you plan to enable later, select
Others.
-
In the Add Service window, select the z/OSMF services for which you want
to modify the log level.
-
Click OK.
The services table is updated to show the package name and current log level for the z/OSMF
services that you selected.
You can edit the package names to include multiple packages for a service. Use a colon (':')
to separate each package name. For example:
com.ibm.zoszmf.cp.a:com.ibm.zoszmf.cp.b
-
For each z/OSMF service, specify the log level that you want to enable.
- Select the z/OSMF service, then select a log level from the Log Level column. The valid log
levels are described in Table 1.
When you finish setting log levels for the services, click Set to apply your
changes for the selected services. A notification message is displayed to confirm that the log
levels are changed. Notice that a count of notification messages is displayed to the right of the
bell icon in the upper right corner of the page. To view your notification messages, click the bell
icon.
- To deselect a z/OSMF service, click Cancel.
- To remove a service from the table, select the service and click
Delete.
- To restore all of the z/OSMF service log levels to the IBM default values, click
Restore Defaults. For more information about the z/OSMF default log levels,
see the description of the LOGGING option of the IZUPRMxx parmlib member in IBM z/OS Management Facility Configuration Guide.
Table 1. Valid log levels for the z/OSMF server.
| Log level |
Content / Significance |
| INFO |
General information outlining overall task progress. |
| FINE |
Trace information - General trace. |
| FINER |
Trace information - Detailed trace, which includes general trace plus method entry, exit, and
return values. |
| FINEST |
Trace information - A more detailed trace that includes all the detail that is needed to
debug problems. |
| SEVERE |
Task cannot continue but component, application, and server can still function. This level
can also indicate an impending unrecoverable error. |
| WARNING |
Potential error or impending error. This level can also indicate a progressive failure (for
example, the potential leaking of resources). |
| ALL |
All events are logged. If you create custom levels, ALL includes those
levels, and can provide a more detailed trace than finest. |
| CONFIG |
Configuration change or status. |
| OFF |
Logging is turned off. |
-
When you are done with your selections, click Save.
z/OSMF sets all of the enabled services to INFO, then applies your selections to the selected
services.
What to do next
With the new log levels in effect, you can collect the required diagnostic data. Here, you can
re-create the problem, then use the Collect z/OSMF diagnostic data tab of the
z/OSMF Diagnostic Assistant to collect the data. To view the diagnostic data, export the data as a
compressed file and save it to your workstation.
The log levels consume varying amounts of storage and CPU. When you are done collecting
diagnostic data, it is recommended that you restore the z/OSMF service log levels to their default
values. To do so, return to the services table and click Restore
Defaults.