IBM AIX 7.1 – Common Problem 117 – Diagnosis and Fix

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution – Primary Fix
7. Solution – Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

Print jobs queue up and lpstat shows queue DEV_WAIT or DOWN.

Environment & Reproduction

AIX 7.2 LPAR with CUPS or piobe-managed print queues.

Root Cause Analysis

Backend device offline or the queue daemon (qdaemon) stopped.

Quick Triage

Run lpstat -p QUEUE and enq -A to view the queue state.

Step-by-Step Diagnosis

Inspect /var/spool/lpd/qdir and /var/adm/ras/conslog for qdaemon errors.

Solution – Primary Fix

Restart qdaemon with stopsrc -s qdaemon; startsrc -s qdaemon.

Solution – Alternative Approaches

Enable the queue with enable QUEUE after fixing the backend network/host.

Verification & Acceptance Criteria

lpstat -p QUEUE shows READY and a test job prints successfully.

Rollback Plan

Disable the queue with disable QUEUE if the backend is unstable.

Prevention & Hardening

Move heavy queues to CUPS and monitor qdaemon via lssrc.

Related Errors & Cross-Refs

Often pairs with NETIO errpt entries if the device is network-attached.

Related tutorial: View the step-by-step tutorial for aix-7.1.

View all aix-7.1 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

IBM Docs: qdaemon, enq, lpstat on AIX 7.2.