IBM z/OS SMP/E MCS Tools

Language Server Extension for IBM SMP/E MCS (Modification Control Statements).

What's New in 1.3.10

• Check Missing Input Members understands {{ path }} placeholders - Statements pointing at their input member with a {{ ./path }} line are now resolved against the repository root instead of being skipped. A new Source column distinguishes placeholder from convention.
• New diagnostic: comment beginning in column 1 - A /* in column 1 ends the input data set and truncates the member. Reported as an error with quick fixes to indent the line or the whole comment block. Toggle via smpe.diagnostics.commentInColumn1.
• Comments survive formatting unchanged - Box drawings, tables and aligned metadata blocks are no longer reflowed or re-indented, and comments after dotted operand values are no longer dropped.
• Fewer false positives in Check Missing Input Members - No member is demanded for FROMDS, RELFILE or DELETE, and statements without an explicit mapping derive their extension from the statement name.

See the CHANGELOG for full details.

What's New in 1.3.9

• LEPARM and sub-operand containers fixed end-to-end - Parsing, completion (nested context, already-used filtering, pipe-value suggestions like AMODE/UPCASE/FETCHOPT), Outline view, and formatting (separator preservation, list wrapping) all work correctly now for LEPARM, FROMDS, and similar sub-operand operands.

What's New in 1.3.8

• Internal fixes only — see CHANGELOG for details.

What's New in 1.3.7

• New Quick Fix: "Update REWORK to current date" - Refreshes a stale, already-filled REWORK() value from the cursor, no diagnostic needed. The existing empty-value fix is unchanged.

What's New in 1.3.6

• smpe_lint --data flag - Set the smpe.json location explicitly (--data <path>) for Docker containers and CI runners without a usable home directory; default lookup now also works on Windows.

What's New in 1.3.5

• Free Form Query entry types complete - The entry type picklist now covers all SMP/E CSI entry types (46 → 86): added HFS, SHELLSCR, the ELEMENT pseudo-entry and all data element types, each with its valid subentries.
• National language variants - Entry types like HFSESP or MSGENU automatically resolve to the subentries of their base type.

What's New in 1.3.4

• Free Form Query subentry picker fix - Already selected subentries show a checkmark again when reopening the picker, and new picks are merged alphabetically instead of appended to the end.

What's New in 1.3.3

• Signature Help - When the cursor is inside an operand's parentheses (DISTLIB(│)), a floating box shows the expected parameter, a short description and the type. It triggers automatically while typing ( and after accepting an operand from the completion list; boolean flag operands show no box. Toggle with smpe.signatureHelp.enabled (default true).
• Fix language discrepancies - Free Form Query now has only english button labels.

What's New in 1.3.2

• Code Actions (Quick Fixes) - The editor lightbulb (Cmd+. / Ctrl+.) offers one-click fixes for diagnostics: Add statement terminator (inserts the missing .), Insert operand X / Insert all required operands (inserts skeletons for missing required operands), and Set REWORK to current date (fills an empty REWORK() with today's Julian date yyyyddd).

What's New in 1.3.1

• MCS completion menu stays open while typing ++STATEMENT prefix - Typing ++S, ++SR, ++SRC, … no longer dismisses the completion list. The completion menu remains open and continues to filter MCS statements as more characters are typed.
• Snippet items respect VSCode/blink prefix filter - Boilerplate snippet completion items now carry an explicit filterText so VSCode (and blink-cmp in Neovim) match them against the typed prefix. Snippets are no longer hidden when typing ++P, ++PT, etc.

What's New in 1.3.0

• Saved Queries in Free Form Query - Save and reuse complete CSI queries. Queries are stored in .smpe-saved-queries.yaml in the workspace root. The Free Form Query panel shows a collapsible saved queries section below the input form.
• Auto-Detect Language Mode Toggle - New setting smpe.editor.autoDetectLanguage (default: true) and command SMP/E: Toggle Auto-Detect Language Mode. When disabled, manual language mode changes (e.g. switching a .smpe buffer to REXX) are preserved and no longer overridden by the extension.

See the CHANGELOG for full details.

Features

• Syntax Highlighting - Color highlighting for SMP/E statements
• Code Completion - Context-sensitive completion for MCS statements and operands
• Diagnostics - Real-time validation with error and warning messages
• Code Actions (Quick Fixes) - Lightbulb fixes for missing terminators, missing required operands, and empty REWORK()
• Signature Help - Floating parameter hint for operands with description and type (toggle via smpe.signatureHelp.enabled)
• Hover Information - Documentation when hovering over statements and operands
• Go to Definition - Navigate to SYSMOD/FMID definitions (F12 or Cmd+Click)
• Find References - Find all references to a SYSMOD or FMID (Shift+F12)
• Document Symbols - Outline view and quick navigation (Cmd+Shift+O)
• Workspace Symbols - Search for SYSMOD definitions across all .smpe files (Cmd+T)
• Folding Ranges - Collapse/expand MCS statements and multi-line comments
• Check Missing Input Members - Scan workspace for missing MCS input files with filterable Webview results
• CodeLens - Inline z/OSMF CSI queries for SYSMODs and DDDEFs
• z/OSMF Integration - Query CSI, browse USS directories and MVS datasets
• Column Rulers - Visual guides at columns 72 and 80 (mainframe card boundaries)
• Document Formatting - Auto-format SMP/E statements

Supported Statements

The extension supports all common SMP/E MCS statements, including:

• ++APAR, ++PTF, ++USERMOD, ++FUNCTION
• ++MAC, ++MACUPD, ++MOD, ++SRC, ++SRCUPD
• ++JCLIN, ++JAR, ++JARUPD
• ++VER, ++ZAP, ++DELETE
• and many more...

Configuration

General

Formatting

Diagnostics

All diagnostics are enabled by default. Set to false to disable specific checks.

z/OSMF Integration

The z/OSMF integration requires a .smpe-zosmf.yaml configuration file. The extension resolves the file in the following order:

1. Workspace folders — all open workspace folders are searched, first match wins
2. Global fallback — ~/.config/smpe_ls/.smpe-zosmf.yaml

To create a configuration file in the workspace root, run:

Ctrl+Shift+P → SMP/E: Create z/OSMF Config

This creates .smpe-zosmf.yaml in the root of the first workspace folder and opens it for editing. If you want a shared configuration across all projects, place the file at ~/.config/smpe_ls/.smpe-zosmf.yaml instead.

Check Missing Input Members

Editor

Commands

All commands are available via the Command Palette (Cmd+Shift+P / Ctrl+Shift+P).

File Extensions

The extension activates automatically for files with the following extensions:

• .smpe
• .mcs
• .smp

Screenshots

Coming soon

License

AGPL-3.0 - See LICENSE for details.

Author

Made with ❤️ by Sir Tobi aka Cybersorcerer

Note: SMP/E is a registered trademark of IBM Corporation.