Overview of Db2 for z/OS Agent

IBM® Db2® for z/OS® Agent is an AI-powered assistant that enables you to easily obtain real-time information about your Db2 for z/OS subsystems and catalog tables through a simple prompt-based conversational interface.

For example, you can ask it what the current value of a particular subsystem parameter is, which buffer pool a particular index uses, or to return a list of all the schemas on a subsystem. In addition to providing a response, the agent also explains the method that it used to obtain the response. For a better understanding of the types of questions that you can ask the agent, review the list of sample prompts.

Db2 for z/OS Agent runs in an IBM watsonx Assistant™ for Z environment, which is powered by watsonx™ Orchestrate®. See the watsonx Assistant for Z documentation to familiarize yourself with its basic concepts.

Db2 for z/OS Agent is available to licensed Db2 13 for z/OS users free of charge. To obtain the entitlement key, open a case with IBM Support indicating that you are requesting the entitlement key for Db2 for z/OS Agent.

Db2 for z/OS Agent architecture

The following figure illustrates a Db2 for z/OS Agent environment and shows the relationship between each component that plays a role in the environment:

You deploy the agent on a Linux® 64 (x86) system by using IBM watsonx.ai development studio. IBM watsonx.ai provides the foundational large language model (LLM) framework that Db2 for z/OS Agent needs to help answer your questions.

IBM watsonx.ai
IBM watsonx.ai provides the environment for building and deploying AI. It provides APIs, foundation models, and Retrieval Augmented Generation (RAG) frameworks.
IBM watsonx Assistant for Z
IBM watsonx Assistant for Z is an extension to watsonx Orchestrate that enables agents for interaction with IBM Z®. It allows for connection to Ansible® and z/OS APIs and the ability to import automation, Ansible playbooks, JCL, or REXX as skills into watsonx Orchestrate. The automation uses existing z/OS user security settings.
Z RAG
IBM watsonx Assistant for Z provides Z-specific Retrieval Augmented Generation to augment the Large Language Model (LLM) with information that is specific to Z products, including Db2 for z/OS. This information comes from diverse but authoritative sources such as IBM product documentation, IBM subject matter experts, and IBM Redbooks®.
Authorization service
The Authorization services is a preconfigured service that is provided by ZAssistantDeploy, which is a component of IBM watsonx Assistant for Z. The Authorization service ensures secure access by validating the current login user in watsonx Orchestrate against the z/OS User Management system.
Db2 for z/OS Agent Model Context Protocol (MCP) server
MCP is an open-source framework for standardizing how AI systems, particularly LLMs, interact with external tools and data sources. The MCP server enables Db2 for z/OS Agent to access and use information from various applications and systems in a consistent way, which helps the agent to provide more accurate responses by incorporating real-time data into its response process.Db2 for z/OS Agent connects to Db2 for z/OS and runs tools by using the MCP to discover information about the Db2 subsystems.
MongoDB container
A MongoDB container is used to store the following types of metadata that the agent relies on:
  • Database connection information (note that usernames and passwords are not stored)
  • Catalog table information for each database connection that is created
  • Trace information to assist in tracing back specific responses that are generated based on user prompts
Agent-to-Db2 connectivity
Connectivity is provided through an ODBC connection. Both server-side and client-side verification is supported; however, server-side verification is recommended.