# Configuration **To monitor an IBM Z Series Mainframe, copy the sample configuration file into the configuration directory:** ```bash cp agent.conf.sample /etc/pandora/conf/agent_name.conf ``` The newly created configuration file can have any name, but its extension must be .conf. Edit it and configure the following options: - **agent\_name:** Agent name. This name will be displayed in the Pandora FMS console. - **dataportal\_url:** URL used to access the RMF Data Portal. (for example http://127.0.0.1:8803) - **dataportal\_user:** Username used to access the RMF Data Portal. - **dataportal\_pass:** Password used to access the RMF Data Portal. Start the mainframe agent: ```bash /etc/init.d/mf_server start ``` To add metrics to the agent, open your Pandora FMS console, go to Operation → Z/OS, and click on the RMF Data Portal Browser tab. Fill in the following information and click Browse: - **RMF IP address:** RMF Data Portal IP address and port (127.0.0.1:8803). If no port is specified, port 8803 is used by default. - **User:** Username used to access the RMF Data Portal. - **Password:** Password used to access the RMF Data Portal. - **Depth:** Maximum depth of the resource tree. The first level will be a SYSPLEX, the second MVS images, the third the I/O subsystem, processor, and so on. [![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/scaled-1680-/image.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/image.png) Select the desired resource and click the magnifying glass icon to display a list of all available metrics. [![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/scaled-1680-/0Fuimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/0Fuimage.png) When you click on a metric, a window will open showing the code to paste into the agent configuration file. [![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/scaled-1680-/A7ximage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/A7ximage.png) Copy it, close the window, and click on the Mainframe tab. Click the remote configuration icon and paste the code into the configuration file. [![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/scaled-1680-/qDTimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/qDTimage.png) [![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/scaled-1680-/jxHimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/jxHimage.png) Click on the Metrics tab and wait for the data to appear. [![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/scaled-1680-/LZoimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-11/LZoimage.png)