Integrating OPS/MVS with PagerDuty

Products

• OPS/MVS Event Management & Automation

Issue/Introduction

Can OPS/MVS be integrated with PagerDuty for automated alerting? If so, what are the prerequisites and recommended methods for this integration?

Environment

• z/OS environment running OPS/MVS.
• PagerDuty with access to either Email Integrations or REST API

Resolution

Currently, there is no native, direct integration "out-of-the-box" between OPS/MVS and PagerDuty. However, two effective workaround methods are available using standard OPS/MVS features:

Method 1: Email-Based Integration

PagerDuty allows services to trigger incidents based on incoming emails. OPS/MVS can be configured to send automated emails when specific console messages or events are trapped.

• Prerequisites:
  • PagerDuty: A service must be configured with an "Email Integration" to provide a unique PagerDuty email address.
  • OPS/MVS: The environment must be configured to send external emails (typically using CSSMTP).
• Implementation:
  • Create an AOF rule to trap the desired message.
  • Use a REXX script (refer to CCLXSAMP(EMAILTXT) as a template) to format and send the alert to the PagerDuty email address.

Method 2: REST API Integration (WEBREQ)

You can use the PagerDuty REST API to trigger, acknowledge, or resolve incidents directly. OPS/MVS facilitates this through the ADDRESS USS WEBREQ host command environment.

• Prerequisites:
  • PagerDuty: Obtain a REST API Key or a Routing Key from your PagerDuty service settings.
  • OPS/MVS: The WEBREQ environment must be configured and active.
• Implementation:
  • Code an OPS/REXX script using ADDRESS USS WEBREQ to send a POST request to the PagerDuty Events API endpoint (e.g., https://events.pagerduty.com/v2/enqueue).
  • Include the PagerDuty Routing Key and the event details (severity, summary, source) in the JSON payload.

Additional Information

If your organization requires a native integration, please submit an "Idea" on the Broadcom Communities site for consideration by the Product Management team.