27 Mar 202305:37 AM - edited 28 Mar 202302:37 AM
Consider this scenario, your z/OS monitoring is not working as expected, and you would like to do an initial investigation before opening a support ticket. But you have no idea how to read the logs.
Don't fret; I got you. 😉
I've compiled some common issues that I've experienced, and I'll guide you on how to troubleshoot them. If your problem needs to be listed here, you can leave a comment, and I'll help you as much as I can.
This is a 2-part blog, and in this section, I'll be covering the basics and discussing logs, how to extract them, and what are the important information that it contains.
How can I check the logs that are related to my problem?
The first obstacle that you might experience is the number of logs that is available for you to read. Depending on your set-up, the logs the could be huge and overwhelming. But there is a way to filter this.
Extract the support_archive folder and search for the keyword:
after that, look for this line. This specifies the location of the zlocal agent logs and its accompanying zremote logs.
YYYY-MM-DD HH:MM:SS UTC �00000000] info �native] Log info data�zLocalAgent logfile=/location/zlocal.log, zRremoteAgent logfile=location/zremote.log, zRemoteAgentName=oneagentname, zRemoteAgent TimeStamp=YYYY-MM-DD HH:MM:SS]
Why do you need to do this? You might have multiple zRemote, zDCs and zLocals. In this way, you know which logs are connected and related to each other and you won't get confused.
Checking the versions
Now that you've identified the correct logs, you need to verify the versions of your DT mainframe components.
In your zLocal logs, you can search for the keyword:
This will specify the zDC version installed in your mainframe.
For zLocal version, you can search for this line:
The most recently installed zLocal version: 184.108.40.2068
For zRemote, you can get the version in the ActiveGate page. Or in the zRemote file.
You can search for this line.
Why is this important? Most problems that I encounter are fixed by upgrading your mainframe components. The zDC, zLocal and zRemote are connected to each other so compatibility of versions between these 3 components are very important.
As a best practice, I recommend that zDC, zLocal and zRemote should be on the same version OR at least 3 versions lower. If zDC is on a higher version than the zRemote, then a problem might occur.
Exploring the logs
There are many important information that you can see in the logs.
For example in the zRemote logs, you will be able to see: