IBM i Job Log Detective

A VS Code extension for analyzing IBM i job logs. Quickly find errors and issues in large job log files.

Features

• Custom Tree View: Dedicated "Job Log Detective" panel with filtering and navigation (1)
• Smart Analysis: Highlights high-severity messages and analyses the log for errors (1)
• Outline View Integration: View messages grouped by type and message ID in the VS Code Outline (2)
• Quick Navigation: Click on any message to jump to its location in the file (3)
• Rich Tooltips: Hover over messages to see full details including cause and recovery (4)
• Automatic Detection: Automatically detects IBM i job log files by content or filename pattern (5)
• Multi-Language Support: Parses job logs in English, German, French, and Spanish

Supported Languages

The extension automatically detects and parses job logs in:

Message Types

The extension recognizes all IBM i message types:

• Escape - Program termination messages (highest priority)
• Diagnostic - Error messages
• Information - General informational messages
• Completion - Task completion status
• Command - Command execution (hidden by default)
• Request - Command requests
• Inquiry - Messages requiring a reply
• Reply - Responses to inquiries
• Notify - Notification messages
• Sender Copy - Copies of sent messages

Usage

1. Open a job log file (files named QPJOBLOG or containing IBM i job log format)
2. The extension will automatically detect and analyze the file
3. Use the Outline view or Job Log Detective panel to navigate
4. Click on messages to jump to their location
5. Use the filter buttons to focus on specific message types or severity levels

Manual Activation

If automatic detection doesn't work:

1. Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
2. Run "Job Log Detective: Set as IBM i Job Log"

Configuration

Commands

• Job Log Detective: Analyze Job Log - Manually trigger analysis
• Job Log Detective: Set as IBM i Job Log - Force the current file to be treated as a job log
• Job Log Detective: Refresh Analysis - Re-parse and refresh the analysis
• Job Log Detective: Filter by Message Type - Filter to specific message types
• Job Log Detective: Show High Severity Only - Toggle to show only high severity messages

File Detection

The extension detects job logs by:

1. File named QPJOBLOG (any extension)
2. Files with .joblog extension
3. Content containing:
   • IBM i product ID (5770SS1 or similar)
   • Version pattern (V7R6M0 format)
   • "Job Log" header text

Development

# Install dependencies
npm install

# Compile
npm run compile

# Test
npx vitest run

# Watch for changes
npm run watch

# Run extension in development
Press F5 in VS Code

Adding New Parsing Languages

To add support for a new language, edit src/localization.ts:

1. Create a new LanguageDefinition object following the pattern of existing languages
2. Add the language to the ALL_LANGUAGES array
3. The extension will automatically detect and parse job logs in the new language

Example language definition structure:

const NEW_LANGUAGE: LanguageDefinition = {
    name: 'Language Name',
    jobLogTitle: 'Localized Job Log Title',
    messageTypes: {
        'Local Command': 'Command',
        'Local Completion': 'Completion',
        // ... map local names to English
    },
    detailFields: {
        fromModule: 'From module|Localized from module',
        // ... other field patterns
    }
};

National Language Support

Translations can be added to the i18n directory.

License

MIT