Tip:
Highlight text to annotate it
X
Let's take a look at the z/OSMF Incident Log plug-in.
To get started, in the left navigation tree, expand the "Problem Determination" category.
Click on "Incident Log" to open its main panel, where you will see a summary view of all the
incidents across all systems in the sysplex. Many properties are displayed for each incident.
And, you can perform a variety of actions on an incident, such as setting a tracking
ID, if you have an internal problem tracking system, and setting the PMR number if you
open up a problem with IBM or an ISV. Also, you can add general free- form notes, and
delete incidents, which will delete the dump and all related incident data. If you have
dump suppression or Dump Analysis for Elimination (DAE) active, you can invoke "Allow Next Dump"
to take the next dump for this symptom string. Now let's take a look at how you can customize
your view of these incidents. You can control what data you see by: filtering
the data, sorting up to 3 columns, and configuring the columns to be displayed and the order
they are displayed in. Remember that all customizations are saved
on a per user basis. Let's filter the data in the table.
By default you see all the incidents that have occurred in the past 3 days. You can
change this. Click "Filter" under a column header to change the filter.
Let's say we want to look at incidents from the past 45 days. Click the filter for the
"Date and Time" column. In the dialog, change the days to "45" and click OK.
Now you see incidents from the past 45 days on your sysplex.
Let's sort the data. Click the column header of the column you
want to sort on. The first click sorts the data in ascending order. The second click
sorts the data in descending order, and the third click clears the sort. Let's sort the
"Date and Time" column in descending order. This is indicated by the down arrow. Sorting
on another column, the "Incident Description" column, sets a secondary sort and is indicated
by the number 2 in the column header. The sort order numbers appear on the column headers
after the second sort is set. You can rearrange the order of the columns
as you would like to see them. Click "Actions", and then select "Configure
Columns". Let's say you don't want to see the "Sysplex"
and "System" columns. Select them, and then click "Remove".
Now let's say you want to see the "Component Name"' column next to the "Date and Time"
column. Select "Component Name" and then click "Up", until it is in the position you want
it. Click OK.
You have successfully customized your workplace! You are viewing only the columns you want,
in the order you want, for a range of data that you filtered, in the sort order that
you want. Now that you've customized your workplace,
let's dive deeper into an individual incident. Let's look at an incident of Type ABEND. You
can click "Actions" and select "View Diagnostics Details" or right click on the incident, and
from the popup context menu, select "View Diagnostics Details".
On the View Diagnostic Details panel you can see all the pieces of diagnostic data that
have been captured automatically for this incident by the system during dump capture.
You also can attach additional pieces of diagnostic data, for example a trace file.
Let's move on to the General tab. Here, you can see additional information about
the incident - for example, the CSECT, load module and symptom string, as well as the
APAR search string. You can also enter the problem number, internal
tracking ID, or any notes for the incident on this panel.
To return to the main summary panel, click OK, or at the top of the page, click "Incident
Log" in the breadcrumbs. Now let's FTP the data that was captured for
an incident to your service provider. Select an incident. Right click on the incident
or click "Actions", and then select "Send Diagnostic Data".
Here you will work with a wizard that will guide you through the steps to FTP the diagnostic
data for that incident. The first panel you see is the Welcome page.
Notice that in the left pane, the steps you will be guided through are listed. You will
see which steps have been completed and which step is your current one.
The welcome page displays the details about the incident you are working with, plus it
lists the pieces of diagnostic data that are going to be sent.
It also shows you the problem number associated with the incident. If the incident does not
have a problem number associated already, you can set one here.
The problem number is required to help identify the FTP-ed files at the destination.
Click "Next" to continue. This step in the wizard lets you select where
you want to send these files or data sets. On the "Specify Security Settings" step is
where you can enter the user ID and password needed to access the FTP destination server
you selected in the previous step. We will use the anonymous sign on.
Click "Next" to move on. Here you can specify your firewall or proxy
information if needed. In this demo, we do not have a firewall.
In the drop down menu, make sure that the option "No Firewall or Proxy" is selected.
Click "Next". On this step you can specify or edit the job
card information for the FTP job that is being built in the background.
The job card is saved for your user ID, from this point on, for future use until you modify
it again. We'll use the default entries here, so click
"Next". The wizard has guided you through collecting
all the information needed to ftp the diagnostic data to your service provider.
Now you can review all the data that you have provided. If you want to change any value,
you can click "Edit JCL". However, we do not recommend changing the JCL.
You have the option to view the JCL that was generated based on your input. Click on "View
JCL" if you'd like to take a look. When you are ready to submit the FTP jobs,
click "Finish". z/OSMF submits jobs that will ftp the selected pieces of diagnostic data
over to the selected FTP destination. Note that the data is compressed and prepared before
being sent, and no action is required on your part.
You will get a confirmation window. Click "Close" to return to where you invoked
the Send wizard from. Now you can view the job status for the FTP
jobs you submitted. Right click on the incident you had just sent.
Select the "FTP Job Status" from the context menu.
This page shows you the job status for all the FTP jobs submitted for this incident.
You can click "Refresh" to update the status of the jobs.
If a log snapshot does not have any entries, the job might fail. That is okay.
Click "Incident Log" in the breadcrumb to return to where you came from.
As you have seen, the incident log provides a consolidated list of SVC Dump related problems,
along with details and diagnostic data captured with each incident. And, it facilitates sending
the data for further diagnosis with just a few clicks.