[PATCH] s390: dasd extended error reporting module
[linux-2.6/verdex.git] / drivers / s390 / block / dasd_3990_erp.c
blobc811380b90796752e5d2fea8d98f04c6953e6a24
1 /*
2 * File...........: linux/drivers/s390/block/dasd_3990_erp.c
3 * Author(s)......: Horst Hummel <Horst.Hummel@de.ibm.com>
4 * Holger Smolinski <Holger.Smolinski@de.ibm.com>
5 * Bugreports.to..: <Linux390@de.ibm.com>
6 * (C) IBM Corporation, IBM Deutschland Entwicklung GmbH, 2000, 2001
8 */
10 #include <linux/timer.h>
11 #include <linux/slab.h>
12 #include <asm/idals.h>
13 #include <asm/todclk.h>
15 #define PRINTK_HEADER "dasd_erp(3990): "
17 #include "dasd_int.h"
18 #include "dasd_eckd.h"
21 struct DCTL_data {
22 unsigned char subcommand; /* e.g Inhibit Write, Enable Write,... */
23 unsigned char modifier; /* Subcommand modifier */
24 unsigned short res; /* reserved */
25 } __attribute__ ((packed));
28 *****************************************************************************
29 * SECTION ERP EXAMINATION
30 *****************************************************************************
34 * DASD_3990_ERP_EXAMINE_24
36 * DESCRIPTION
37 * Checks only for fatal (unrecoverable) error.
38 * A detailed examination of the sense data is done later outside
39 * the interrupt handler.
41 * Each bit configuration leading to an action code 2 (Exit with
42 * programming error or unusual condition indication)
43 * are handled as fatal errorĀ“s.
45 * All other configurations are handled as recoverable errors.
47 * RETURN VALUES
48 * dasd_era_fatal for all fatal (unrecoverable errors)
49 * dasd_era_recover for all others.
51 static dasd_era_t
52 dasd_3990_erp_examine_24(struct dasd_ccw_req * cqr, char *sense)
55 struct dasd_device *device = cqr->device;
57 /* check for 'Command Reject' */
58 if ((sense[0] & SNS0_CMD_REJECT) &&
59 (!(sense[2] & SNS2_ENV_DATA_PRESENT))) {
61 DEV_MESSAGE(KERN_ERR, device, "%s",
62 "EXAMINE 24: Command Reject detected - "
63 "fatal error");
65 return dasd_era_fatal;
68 /* check for 'Invalid Track Format' */
69 if ((sense[1] & SNS1_INV_TRACK_FORMAT) &&
70 (!(sense[2] & SNS2_ENV_DATA_PRESENT))) {
72 DEV_MESSAGE(KERN_ERR, device, "%s",
73 "EXAMINE 24: Invalid Track Format detected "
74 "- fatal error");
76 return dasd_era_fatal;
79 /* check for 'No Record Found' */
80 if (sense[1] & SNS1_NO_REC_FOUND) {
82 /* FIXME: fatal error ?!? */
83 DEV_MESSAGE(KERN_ERR, device,
84 "EXAMINE 24: No Record Found detected %s",
85 device->state <= DASD_STATE_BASIC ?
86 " " : "- fatal error");
88 return dasd_era_fatal;
91 /* return recoverable for all others */
92 return dasd_era_recover;
93 } /* END dasd_3990_erp_examine_24 */
96 * DASD_3990_ERP_EXAMINE_32
98 * DESCRIPTION
99 * Checks only for fatal/no/recoverable error.
100 * A detailed examination of the sense data is done later outside
101 * the interrupt handler.
103 * RETURN VALUES
104 * dasd_era_none no error
105 * dasd_era_fatal for all fatal (unrecoverable errors)
106 * dasd_era_recover for recoverable others.
108 static dasd_era_t
109 dasd_3990_erp_examine_32(struct dasd_ccw_req * cqr, char *sense)
112 struct dasd_device *device = cqr->device;
114 switch (sense[25]) {
115 case 0x00:
116 return dasd_era_none;
118 case 0x01:
119 DEV_MESSAGE(KERN_ERR, device, "%s", "EXAMINE 32: fatal error");
121 return dasd_era_fatal;
123 default:
125 return dasd_era_recover;
128 } /* end dasd_3990_erp_examine_32 */
131 * DASD_3990_ERP_EXAMINE
133 * DESCRIPTION
134 * Checks only for fatal/no/recover error.
135 * A detailed examination of the sense data is done later outside
136 * the interrupt handler.
138 * The logic is based on the 'IBM 3990 Storage Control Reference' manual
139 * 'Chapter 7. Error Recovery Procedures'.
141 * RETURN VALUES
142 * dasd_era_none no error
143 * dasd_era_fatal for all fatal (unrecoverable errors)
144 * dasd_era_recover for all others.
146 dasd_era_t
147 dasd_3990_erp_examine(struct dasd_ccw_req * cqr, struct irb * irb)
150 char *sense = irb->ecw;
151 dasd_era_t era = dasd_era_recover;
152 struct dasd_device *device = cqr->device;
154 /* check for successful execution first */
155 if (irb->scsw.cstat == 0x00 &&
156 irb->scsw.dstat == (DEV_STAT_CHN_END | DEV_STAT_DEV_END))
157 return dasd_era_none;
159 /* distinguish between 24 and 32 byte sense data */
160 if (sense[27] & DASD_SENSE_BIT_0) {
162 era = dasd_3990_erp_examine_24(cqr, sense);
164 } else {
166 era = dasd_3990_erp_examine_32(cqr, sense);
170 /* log the erp chain if fatal error occurred */
171 if ((era == dasd_era_fatal) && (device->state >= DASD_STATE_READY)) {
172 dasd_log_sense(cqr, irb);
173 dasd_log_ccw(cqr, 0, irb->scsw.cpa);
176 return era;
178 } /* END dasd_3990_erp_examine */
181 *****************************************************************************
182 * SECTION ERP HANDLING
183 *****************************************************************************
186 *****************************************************************************
187 * 24 and 32 byte sense ERP functions
188 *****************************************************************************
192 * DASD_3990_ERP_CLEANUP
194 * DESCRIPTION
195 * Removes the already build but not necessary ERP request and sets
196 * the status of the original cqr / erp to the given (final) status
198 * PARAMETER
199 * erp request to be blocked
200 * final_status either DASD_CQR_DONE or DASD_CQR_FAILED
202 * RETURN VALUES
203 * cqr original cqr
205 static struct dasd_ccw_req *
206 dasd_3990_erp_cleanup(struct dasd_ccw_req * erp, char final_status)
208 struct dasd_ccw_req *cqr = erp->refers;
210 dasd_free_erp_request(erp, erp->device);
211 cqr->status = final_status;
212 return cqr;
214 } /* end dasd_3990_erp_cleanup */
217 * DASD_3990_ERP_BLOCK_QUEUE
219 * DESCRIPTION
220 * Block the given device request queue to prevent from further
221 * processing until the started timer has expired or an related
222 * interrupt was received.
224 static void
225 dasd_3990_erp_block_queue(struct dasd_ccw_req * erp, int expires)
228 struct dasd_device *device = erp->device;
230 DEV_MESSAGE(KERN_INFO, device,
231 "blocking request queue for %is", expires/HZ);
233 device->stopped |= DASD_STOPPED_PENDING;
234 erp->status = DASD_CQR_QUEUED;
236 dasd_set_timer(device, expires);
240 * DASD_3990_ERP_INT_REQ
242 * DESCRIPTION
243 * Handles 'Intervention Required' error.
244 * This means either device offline or not installed.
246 * PARAMETER
247 * erp current erp
248 * RETURN VALUES
249 * erp modified erp
251 static struct dasd_ccw_req *
252 dasd_3990_erp_int_req(struct dasd_ccw_req * erp)
255 struct dasd_device *device = erp->device;
257 /* first time set initial retry counter and erp_function */
258 /* and retry once without blocking queue */
259 /* (this enables easier enqueing of the cqr) */
260 if (erp->function != dasd_3990_erp_int_req) {
262 erp->retries = 256;
263 erp->function = dasd_3990_erp_int_req;
265 } else {
267 /* issue a message and wait for 'device ready' interrupt */
268 DEV_MESSAGE(KERN_ERR, device, "%s",
269 "is offline or not installed - "
270 "INTERVENTION REQUIRED!!");
272 dasd_3990_erp_block_queue(erp, 60*HZ);
275 return erp;
277 } /* end dasd_3990_erp_int_req */
280 * DASD_3990_ERP_ALTERNATE_PATH
282 * DESCRIPTION
283 * Repeat the operation on a different channel path.
284 * If all alternate paths have been tried, the request is posted with a
285 * permanent error.
287 * PARAMETER
288 * erp pointer to the current ERP
290 * RETURN VALUES
291 * erp modified pointer to the ERP
293 static void
294 dasd_3990_erp_alternate_path(struct dasd_ccw_req * erp)
296 struct dasd_device *device = erp->device;
297 __u8 opm;
299 /* try alternate valid path */
300 opm = ccw_device_get_path_mask(device->cdev);
301 //FIXME: start with get_opm ?
302 if (erp->lpm == 0)
303 erp->lpm = LPM_ANYPATH & ~(erp->irb.esw.esw0.sublog.lpum);
304 else
305 erp->lpm &= ~(erp->irb.esw.esw0.sublog.lpum);
307 if ((erp->lpm & opm) != 0x00) {
309 DEV_MESSAGE(KERN_DEBUG, device,
310 "try alternate lpm=%x (lpum=%x / opm=%x)",
311 erp->lpm, erp->irb.esw.esw0.sublog.lpum, opm);
313 /* reset status to queued to handle the request again... */
314 if (erp->status > DASD_CQR_QUEUED)
315 erp->status = DASD_CQR_QUEUED;
316 erp->retries = 1;
317 } else {
318 DEV_MESSAGE(KERN_ERR, device,
319 "No alternate channel path left (lpum=%x / "
320 "opm=%x) -> permanent error",
321 erp->irb.esw.esw0.sublog.lpum, opm);
323 /* post request with permanent error */
324 if (erp->status > DASD_CQR_QUEUED)
325 erp->status = DASD_CQR_FAILED;
327 } /* end dasd_3990_erp_alternate_path */
330 * DASD_3990_ERP_DCTL
332 * DESCRIPTION
333 * Setup cqr to do the Diagnostic Control (DCTL) command with an
334 * Inhibit Write subcommand (0x20) and the given modifier.
336 * PARAMETER
337 * erp pointer to the current (failed) ERP
338 * modifier subcommand modifier
340 * RETURN VALUES
341 * dctl_cqr pointer to NEW dctl_cqr
344 static struct dasd_ccw_req *
345 dasd_3990_erp_DCTL(struct dasd_ccw_req * erp, char modifier)
348 struct dasd_device *device = erp->device;
349 struct DCTL_data *DCTL_data;
350 struct ccw1 *ccw;
351 struct dasd_ccw_req *dctl_cqr;
353 dctl_cqr = dasd_alloc_erp_request((char *) &erp->magic, 1,
354 sizeof (struct DCTL_data),
355 erp->device);
356 if (IS_ERR(dctl_cqr)) {
357 DEV_MESSAGE(KERN_ERR, device, "%s",
358 "Unable to allocate DCTL-CQR");
359 erp->status = DASD_CQR_FAILED;
360 return erp;
363 DCTL_data = dctl_cqr->data;
365 DCTL_data->subcommand = 0x02; /* Inhibit Write */
366 DCTL_data->modifier = modifier;
368 ccw = dctl_cqr->cpaddr;
369 memset(ccw, 0, sizeof (struct ccw1));
370 ccw->cmd_code = CCW_CMD_DCTL;
371 ccw->count = 4;
372 ccw->cda = (__u32)(addr_t) DCTL_data;
373 dctl_cqr->function = dasd_3990_erp_DCTL;
374 dctl_cqr->refers = erp;
375 dctl_cqr->device = erp->device;
376 dctl_cqr->magic = erp->magic;
377 dctl_cqr->expires = 5 * 60 * HZ;
378 dctl_cqr->retries = 2;
380 dctl_cqr->buildclk = get_clock();
382 dctl_cqr->status = DASD_CQR_FILLED;
384 return dctl_cqr;
386 } /* end dasd_3990_erp_DCTL */
389 * DASD_3990_ERP_ACTION_1
391 * DESCRIPTION
392 * Setup ERP to do the ERP action 1 (see Reference manual).
393 * Repeat the operation on a different channel path.
394 * If all alternate paths have been tried, the request is posted with a
395 * permanent error.
396 * Note: duplex handling is not implemented (yet).
398 * PARAMETER
399 * erp pointer to the current ERP
401 * RETURN VALUES
402 * erp pointer to the ERP
405 static struct dasd_ccw_req *
406 dasd_3990_erp_action_1(struct dasd_ccw_req * erp)
409 erp->function = dasd_3990_erp_action_1;
411 dasd_3990_erp_alternate_path(erp);
413 return erp;
415 } /* end dasd_3990_erp_action_1 */
418 * DASD_3990_ERP_ACTION_4
420 * DESCRIPTION
421 * Setup ERP to do the ERP action 4 (see Reference manual).
422 * Set the current request to PENDING to block the CQR queue for that device
423 * until the state change interrupt appears.
424 * Use a timer (20 seconds) to retry the cqr if the interrupt is still
425 * missing.
427 * PARAMETER
428 * sense sense data of the actual error
429 * erp pointer to the current ERP
431 * RETURN VALUES
432 * erp pointer to the ERP
435 static struct dasd_ccw_req *
436 dasd_3990_erp_action_4(struct dasd_ccw_req * erp, char *sense)
439 struct dasd_device *device = erp->device;
441 /* first time set initial retry counter and erp_function */
442 /* and retry once without waiting for state change pending */
443 /* interrupt (this enables easier enqueing of the cqr) */
444 if (erp->function != dasd_3990_erp_action_4) {
446 DEV_MESSAGE(KERN_INFO, device, "%s",
447 "dasd_3990_erp_action_4: first time retry");
449 erp->retries = 256;
450 erp->function = dasd_3990_erp_action_4;
452 } else {
454 if (sense[25] == 0x1D) { /* state change pending */
456 DEV_MESSAGE(KERN_INFO, device,
457 "waiting for state change pending "
458 "interrupt, %d retries left",
459 erp->retries);
461 dasd_3990_erp_block_queue(erp, 30*HZ);
463 } else if (sense[25] == 0x1E) { /* busy */
464 DEV_MESSAGE(KERN_INFO, device,
465 "busy - redriving request later, "
466 "%d retries left",
467 erp->retries);
468 dasd_3990_erp_block_queue(erp, HZ);
469 } else {
471 /* no state change pending - retry */
472 DEV_MESSAGE (KERN_INFO, device,
473 "redriving request immediately, "
474 "%d retries left",
475 erp->retries);
476 erp->status = DASD_CQR_QUEUED;
480 return erp;
482 } /* end dasd_3990_erp_action_4 */
485 *****************************************************************************
486 * 24 byte sense ERP functions (only)
487 *****************************************************************************
491 * DASD_3990_ERP_ACTION_5
493 * DESCRIPTION
494 * Setup ERP to do the ERP action 5 (see Reference manual).
495 * NOTE: Further handling is done in xxx_further_erp after the retries.
497 * PARAMETER
498 * erp pointer to the current ERP
500 * RETURN VALUES
501 * erp pointer to the ERP
504 static struct dasd_ccw_req *
505 dasd_3990_erp_action_5(struct dasd_ccw_req * erp)
508 /* first of all retry */
509 erp->retries = 10;
510 erp->function = dasd_3990_erp_action_5;
512 return erp;
514 } /* end dasd_3990_erp_action_5 */
517 * DASD_3990_HANDLE_ENV_DATA
519 * DESCRIPTION
520 * Handles 24 byte 'Environmental data present'.
521 * Does a analysis of the sense data (message Format)
522 * and prints the error messages.
524 * PARAMETER
525 * sense current sense data
527 * RETURN VALUES
528 * void
530 static void
531 dasd_3990_handle_env_data(struct dasd_ccw_req * erp, char *sense)
534 struct dasd_device *device = erp->device;
535 char msg_format = (sense[7] & 0xF0);
536 char msg_no = (sense[7] & 0x0F);
538 switch (msg_format) {
539 case 0x00: /* Format 0 - Program or System Checks */
541 if (sense[1] & 0x10) { /* check message to operator bit */
543 switch (msg_no) {
544 case 0x00: /* No Message */
545 break;
546 case 0x01:
547 DEV_MESSAGE(KERN_WARNING, device, "%s",
548 "FORMAT 0 - Invalid Command");
549 break;
550 case 0x02:
551 DEV_MESSAGE(KERN_WARNING, device, "%s",
552 "FORMAT 0 - Invalid Command "
553 "Sequence");
554 break;
555 case 0x03:
556 DEV_MESSAGE(KERN_WARNING, device, "%s",
557 "FORMAT 0 - CCW Count less than "
558 "required");
559 break;
560 case 0x04:
561 DEV_MESSAGE(KERN_WARNING, device, "%s",
562 "FORMAT 0 - Invalid Parameter");
563 break;
564 case 0x05:
565 DEV_MESSAGE(KERN_WARNING, device, "%s",
566 "FORMAT 0 - Diagnostic of Sepecial"
567 " Command Violates File Mask");
568 break;
569 case 0x07:
570 DEV_MESSAGE(KERN_WARNING, device, "%s",
571 "FORMAT 0 - Channel Returned with "
572 "Incorrect retry CCW");
573 break;
574 case 0x08:
575 DEV_MESSAGE(KERN_WARNING, device, "%s",
576 "FORMAT 0 - Reset Notification");
577 break;
578 case 0x09:
579 DEV_MESSAGE(KERN_WARNING, device, "%s",
580 "FORMAT 0 - Storage Path Restart");
581 break;
582 case 0x0A:
583 DEV_MESSAGE(KERN_WARNING, device,
584 "FORMAT 0 - Channel requested "
585 "... %02x", sense[8]);
586 break;
587 case 0x0B:
588 DEV_MESSAGE(KERN_WARNING, device, "%s",
589 "FORMAT 0 - Invalid Defective/"
590 "Alternate Track Pointer");
591 break;
592 case 0x0C:
593 DEV_MESSAGE(KERN_WARNING, device, "%s",
594 "FORMAT 0 - DPS Installation "
595 "Check");
596 break;
597 case 0x0E:
598 DEV_MESSAGE(KERN_WARNING, device, "%s",
599 "FORMAT 0 - Command Invalid on "
600 "Secondary Address");
601 break;
602 case 0x0F:
603 DEV_MESSAGE(KERN_WARNING, device,
604 "FORMAT 0 - Status Not As "
605 "Required: reason %02x", sense[8]);
606 break;
607 default:
608 DEV_MESSAGE(KERN_WARNING, device, "%s",
609 "FORMAT 0 - Reseved");
611 } else {
612 switch (msg_no) {
613 case 0x00: /* No Message */
614 break;
615 case 0x01:
616 DEV_MESSAGE(KERN_WARNING, device, "%s",
617 "FORMAT 0 - Device Error Source");
618 break;
619 case 0x02:
620 DEV_MESSAGE(KERN_WARNING, device, "%s",
621 "FORMAT 0 - Reserved");
622 break;
623 case 0x03:
624 DEV_MESSAGE(KERN_WARNING, device,
625 "FORMAT 0 - Device Fenced - "
626 "device = %02x", sense[4]);
627 break;
628 case 0x04:
629 DEV_MESSAGE(KERN_WARNING, device, "%s",
630 "FORMAT 0 - Data Pinned for "
631 "Device");
632 break;
633 default:
634 DEV_MESSAGE(KERN_WARNING, device, "%s",
635 "FORMAT 0 - Reserved");
638 break;
640 case 0x10: /* Format 1 - Device Equipment Checks */
641 switch (msg_no) {
642 case 0x00: /* No Message */
643 break;
644 case 0x01:
645 DEV_MESSAGE(KERN_WARNING, device, "%s",
646 "FORMAT 1 - Device Status 1 not as "
647 "expected");
648 break;
649 case 0x03:
650 DEV_MESSAGE(KERN_WARNING, device, "%s",
651 "FORMAT 1 - Index missing");
652 break;
653 case 0x04:
654 DEV_MESSAGE(KERN_WARNING, device, "%s",
655 "FORMAT 1 - Interruption cannot be reset");
656 break;
657 case 0x05:
658 DEV_MESSAGE(KERN_WARNING, device, "%s",
659 "FORMAT 1 - Device did not respond to "
660 "selection");
661 break;
662 case 0x06:
663 DEV_MESSAGE(KERN_WARNING, device, "%s",
664 "FORMAT 1 - Device check-2 error or Set "
665 "Sector is not complete");
666 break;
667 case 0x07:
668 DEV_MESSAGE(KERN_WARNING, device, "%s",
669 "FORMAT 1 - Head address does not "
670 "compare");
671 break;
672 case 0x08:
673 DEV_MESSAGE(KERN_WARNING, device, "%s",
674 "FORMAT 1 - Device status 1 not valid");
675 break;
676 case 0x09:
677 DEV_MESSAGE(KERN_WARNING, device, "%s",
678 "FORMAT 1 - Device not ready");
679 break;
680 case 0x0A:
681 DEV_MESSAGE(KERN_WARNING, device, "%s",
682 "FORMAT 1 - Track physical address did "
683 "not compare");
684 break;
685 case 0x0B:
686 DEV_MESSAGE(KERN_WARNING, device, "%s",
687 "FORMAT 1 - Missing device address bit");
688 break;
689 case 0x0C:
690 DEV_MESSAGE(KERN_WARNING, device, "%s",
691 "FORMAT 1 - Drive motor switch is off");
692 break;
693 case 0x0D:
694 DEV_MESSAGE(KERN_WARNING, device, "%s",
695 "FORMAT 1 - Seek incomplete");
696 break;
697 case 0x0E:
698 DEV_MESSAGE(KERN_WARNING, device, "%s",
699 "FORMAT 1 - Cylinder address did not "
700 "compare");
701 break;
702 case 0x0F:
703 DEV_MESSAGE(KERN_WARNING, device, "%s",
704 "FORMAT 1 - Offset active cannot be "
705 "reset");
706 break;
707 default:
708 DEV_MESSAGE(KERN_WARNING, device, "%s",
709 "FORMAT 1 - Reserved");
711 break;
713 case 0x20: /* Format 2 - 3990 Equipment Checks */
714 switch (msg_no) {
715 case 0x08:
716 DEV_MESSAGE(KERN_WARNING, device, "%s",
717 "FORMAT 2 - 3990 check-2 error");
718 break;
719 case 0x0E:
720 DEV_MESSAGE(KERN_WARNING, device, "%s",
721 "FORMAT 2 - Support facility errors");
722 break;
723 case 0x0F:
724 DEV_MESSAGE(KERN_WARNING, device,
725 "FORMAT 2 - Microcode detected error %02x",
726 sense[8]);
727 break;
728 default:
729 DEV_MESSAGE(KERN_WARNING, device, "%s",
730 "FORMAT 2 - Reserved");
732 break;
734 case 0x30: /* Format 3 - 3990 Control Checks */
735 switch (msg_no) {
736 case 0x0F:
737 DEV_MESSAGE(KERN_WARNING, device, "%s",
738 "FORMAT 3 - Allegiance terminated");
739 break;
740 default:
741 DEV_MESSAGE(KERN_WARNING, device, "%s",
742 "FORMAT 3 - Reserved");
744 break;
746 case 0x40: /* Format 4 - Data Checks */
747 switch (msg_no) {
748 case 0x00:
749 DEV_MESSAGE(KERN_WARNING, device, "%s",
750 "FORMAT 4 - Home address area error");
751 break;
752 case 0x01:
753 DEV_MESSAGE(KERN_WARNING, device, "%s",
754 "FORMAT 4 - Count area error");
755 break;
756 case 0x02:
757 DEV_MESSAGE(KERN_WARNING, device, "%s",
758 "FORMAT 4 - Key area error");
759 break;
760 case 0x03:
761 DEV_MESSAGE(KERN_WARNING, device, "%s",
762 "FORMAT 4 - Data area error");
763 break;
764 case 0x04:
765 DEV_MESSAGE(KERN_WARNING, device, "%s",
766 "FORMAT 4 - No sync byte in home address "
767 "area");
768 break;
769 case 0x05:
770 DEV_MESSAGE(KERN_WARNING, device, "%s",
771 "FORMAT 4 - No sync byte in count address "
772 "area");
773 break;
774 case 0x06:
775 DEV_MESSAGE(KERN_WARNING, device, "%s",
776 "FORMAT 4 - No sync byte in key area");
777 break;
778 case 0x07:
779 DEV_MESSAGE(KERN_WARNING, device, "%s",
780 "FORMAT 4 - No sync byte in data area");
781 break;
782 case 0x08:
783 DEV_MESSAGE(KERN_WARNING, device, "%s",
784 "FORMAT 4 - Home address area error; "
785 "offset active");
786 break;
787 case 0x09:
788 DEV_MESSAGE(KERN_WARNING, device, "%s",
789 "FORMAT 4 - Count area error; offset "
790 "active");
791 break;
792 case 0x0A:
793 DEV_MESSAGE(KERN_WARNING, device, "%s",
794 "FORMAT 4 - Key area error; offset "
795 "active");
796 break;
797 case 0x0B:
798 DEV_MESSAGE(KERN_WARNING, device, "%s",
799 "FORMAT 4 - Data area error; "
800 "offset active");
801 break;
802 case 0x0C:
803 DEV_MESSAGE(KERN_WARNING, device, "%s",
804 "FORMAT 4 - No sync byte in home "
805 "address area; offset active");
806 break;
807 case 0x0D:
808 DEV_MESSAGE(KERN_WARNING, device, "%s",
809 "FORMAT 4 - No syn byte in count "
810 "address area; offset active");
811 break;
812 case 0x0E:
813 DEV_MESSAGE(KERN_WARNING, device, "%s",
814 "FORMAT 4 - No sync byte in key area; "
815 "offset active");
816 break;
817 case 0x0F:
818 DEV_MESSAGE(KERN_WARNING, device, "%s",
819 "FORMAT 4 - No syn byte in data area; "
820 "offset active");
821 break;
822 default:
823 DEV_MESSAGE(KERN_WARNING, device, "%s",
824 "FORMAT 4 - Reserved");
826 break;
828 case 0x50: /* Format 5 - Data Check with displacement information */
829 switch (msg_no) {
830 case 0x00:
831 DEV_MESSAGE(KERN_WARNING, device, "%s",
832 "FORMAT 5 - Data Check in the "
833 "home address area");
834 break;
835 case 0x01:
836 DEV_MESSAGE(KERN_WARNING, device, "%s",
837 "FORMAT 5 - Data Check in the count area");
838 break;
839 case 0x02:
840 DEV_MESSAGE(KERN_WARNING, device, "%s",
841 "FORMAT 5 - Data Check in the key area");
842 break;
843 case 0x03:
844 DEV_MESSAGE(KERN_WARNING, device, "%s",
845 "FORMAT 5 - Data Check in the data area");
846 break;
847 case 0x08:
848 DEV_MESSAGE(KERN_WARNING, device, "%s",
849 "FORMAT 5 - Data Check in the "
850 "home address area; offset active");
851 break;
852 case 0x09:
853 DEV_MESSAGE(KERN_WARNING, device, "%s",
854 "FORMAT 5 - Data Check in the count area; "
855 "offset active");
856 break;
857 case 0x0A:
858 DEV_MESSAGE(KERN_WARNING, device, "%s",
859 "FORMAT 5 - Data Check in the key area; "
860 "offset active");
861 break;
862 case 0x0B:
863 DEV_MESSAGE(KERN_WARNING, device, "%s",
864 "FORMAT 5 - Data Check in the data area; "
865 "offset active");
866 break;
867 default:
868 DEV_MESSAGE(KERN_WARNING, device, "%s",
869 "FORMAT 5 - Reserved");
871 break;
873 case 0x60: /* Format 6 - Usage Statistics/Overrun Errors */
874 switch (msg_no) {
875 case 0x00:
876 DEV_MESSAGE(KERN_WARNING, device, "%s",
877 "FORMAT 6 - Overrun on channel A");
878 break;
879 case 0x01:
880 DEV_MESSAGE(KERN_WARNING, device, "%s",
881 "FORMAT 6 - Overrun on channel B");
882 break;
883 case 0x02:
884 DEV_MESSAGE(KERN_WARNING, device, "%s",
885 "FORMAT 6 - Overrun on channel C");
886 break;
887 case 0x03:
888 DEV_MESSAGE(KERN_WARNING, device, "%s",
889 "FORMAT 6 - Overrun on channel D");
890 break;
891 case 0x04:
892 DEV_MESSAGE(KERN_WARNING, device, "%s",
893 "FORMAT 6 - Overrun on channel E");
894 break;
895 case 0x05:
896 DEV_MESSAGE(KERN_WARNING, device, "%s",
897 "FORMAT 6 - Overrun on channel F");
898 break;
899 case 0x06:
900 DEV_MESSAGE(KERN_WARNING, device, "%s",
901 "FORMAT 6 - Overrun on channel G");
902 break;
903 case 0x07:
904 DEV_MESSAGE(KERN_WARNING, device, "%s",
905 "FORMAT 6 - Overrun on channel H");
906 break;
907 default:
908 DEV_MESSAGE(KERN_WARNING, device, "%s",
909 "FORMAT 6 - Reserved");
911 break;
913 case 0x70: /* Format 7 - Device Connection Control Checks */
914 switch (msg_no) {
915 case 0x00:
916 DEV_MESSAGE(KERN_WARNING, device, "%s",
917 "FORMAT 7 - RCC initiated by a connection "
918 "check alert");
919 break;
920 case 0x01:
921 DEV_MESSAGE(KERN_WARNING, device, "%s",
922 "FORMAT 7 - RCC 1 sequence not "
923 "successful");
924 break;
925 case 0x02:
926 DEV_MESSAGE(KERN_WARNING, device, "%s",
927 "FORMAT 7 - RCC 1 and RCC 2 sequences not "
928 "successful");
929 break;
930 case 0x03:
931 DEV_MESSAGE(KERN_WARNING, device, "%s",
932 "FORMAT 7 - Invalid tag-in during "
933 "selection sequence");
934 break;
935 case 0x04:
936 DEV_MESSAGE(KERN_WARNING, device, "%s",
937 "FORMAT 7 - extra RCC required");
938 break;
939 case 0x05:
940 DEV_MESSAGE(KERN_WARNING, device, "%s",
941 "FORMAT 7 - Invalid DCC selection "
942 "response or timeout");
943 break;
944 case 0x06:
945 DEV_MESSAGE(KERN_WARNING, device, "%s",
946 "FORMAT 7 - Missing end operation; device "
947 "transfer complete");
948 break;
949 case 0x07:
950 DEV_MESSAGE(KERN_WARNING, device, "%s",
951 "FORMAT 7 - Missing end operation; device "
952 "transfer incomplete");
953 break;
954 case 0x08:
955 DEV_MESSAGE(KERN_WARNING, device, "%s",
956 "FORMAT 7 - Invalid tag-in for an "
957 "immediate command sequence");
958 break;
959 case 0x09:
960 DEV_MESSAGE(KERN_WARNING, device, "%s",
961 "FORMAT 7 - Invalid tag-in for an "
962 "extended command sequence");
963 break;
964 case 0x0A:
965 DEV_MESSAGE(KERN_WARNING, device, "%s",
966 "FORMAT 7 - 3990 microcode time out when "
967 "stopping selection");
968 break;
969 case 0x0B:
970 DEV_MESSAGE(KERN_WARNING, device, "%s",
971 "FORMAT 7 - No response to selection "
972 "after a poll interruption");
973 break;
974 case 0x0C:
975 DEV_MESSAGE(KERN_WARNING, device, "%s",
976 "FORMAT 7 - Permanent path error (DASD "
977 "controller not available)");
978 break;
979 case 0x0D:
980 DEV_MESSAGE(KERN_WARNING, device, "%s",
981 "FORMAT 7 - DASD controller not available"
982 " on disconnected command chain");
983 break;
984 default:
985 DEV_MESSAGE(KERN_WARNING, device, "%s",
986 "FORMAT 7 - Reserved");
988 break;
990 case 0x80: /* Format 8 - Additional Device Equipment Checks */
991 switch (msg_no) {
992 case 0x00: /* No Message */
993 case 0x01:
994 DEV_MESSAGE(KERN_WARNING, device, "%s",
995 "FORMAT 8 - Error correction code "
996 "hardware fault");
997 break;
998 case 0x03:
999 DEV_MESSAGE(KERN_WARNING, device, "%s",
1000 "FORMAT 8 - Unexpected end operation "
1001 "response code");
1002 break;
1003 case 0x04:
1004 DEV_MESSAGE(KERN_WARNING, device, "%s",
1005 "FORMAT 8 - End operation with transfer "
1006 "count not zero");
1007 break;
1008 case 0x05:
1009 DEV_MESSAGE(KERN_WARNING, device, "%s",
1010 "FORMAT 8 - End operation with transfer "
1011 "count zero");
1012 break;
1013 case 0x06:
1014 DEV_MESSAGE(KERN_WARNING, device, "%s",
1015 "FORMAT 8 - DPS checks after a system "
1016 "reset or selective reset");
1017 break;
1018 case 0x07:
1019 DEV_MESSAGE(KERN_WARNING, device, "%s",
1020 "FORMAT 8 - DPS cannot be filled");
1021 break;
1022 case 0x08:
1023 DEV_MESSAGE(KERN_WARNING, device, "%s",
1024 "FORMAT 8 - Short busy time-out during "
1025 "device selection");
1026 break;
1027 case 0x09:
1028 DEV_MESSAGE(KERN_WARNING, device, "%s",
1029 "FORMAT 8 - DASD controller failed to "
1030 "set or reset the long busy latch");
1031 break;
1032 case 0x0A:
1033 DEV_MESSAGE(KERN_WARNING, device, "%s",
1034 "FORMAT 8 - No interruption from device "
1035 "during a command chain");
1036 break;
1037 default:
1038 DEV_MESSAGE(KERN_WARNING, device, "%s",
1039 "FORMAT 8 - Reserved");
1041 break;
1043 case 0x90: /* Format 9 - Device Read, Write, and Seek Checks */
1044 switch (msg_no) {
1045 case 0x00:
1046 break; /* No Message */
1047 case 0x06:
1048 DEV_MESSAGE(KERN_WARNING, device, "%s",
1049 "FORMAT 9 - Device check-2 error");
1050 break;
1051 case 0x07:
1052 DEV_MESSAGE(KERN_WARNING, device, "%s",
1053 "FORMAT 9 - Head address did not compare");
1054 break;
1055 case 0x0A:
1056 DEV_MESSAGE(KERN_WARNING, device, "%s",
1057 "FORMAT 9 - Track physical address did "
1058 "not compare while oriented");
1059 break;
1060 case 0x0E:
1061 DEV_MESSAGE(KERN_WARNING, device, "%s",
1062 "FORMAT 9 - Cylinder address did not "
1063 "compare");
1064 break;
1065 default:
1066 DEV_MESSAGE(KERN_WARNING, device, "%s",
1067 "FORMAT 9 - Reserved");
1069 break;
1071 case 0xF0: /* Format F - Cache Storage Checks */
1072 switch (msg_no) {
1073 case 0x00:
1074 DEV_MESSAGE(KERN_WARNING, device, "%s",
1075 "FORMAT F - Operation Terminated");
1076 break;
1077 case 0x01:
1078 DEV_MESSAGE(KERN_WARNING, device, "%s",
1079 "FORMAT F - Subsystem Processing Error");
1080 break;
1081 case 0x02:
1082 DEV_MESSAGE(KERN_WARNING, device, "%s",
1083 "FORMAT F - Cache or nonvolatile storage "
1084 "equipment failure");
1085 break;
1086 case 0x04:
1087 DEV_MESSAGE(KERN_WARNING, device, "%s",
1088 "FORMAT F - Caching terminated");
1089 break;
1090 case 0x06:
1091 DEV_MESSAGE(KERN_WARNING, device, "%s",
1092 "FORMAT F - Cache fast write access not "
1093 "authorized");
1094 break;
1095 case 0x07:
1096 DEV_MESSAGE(KERN_WARNING, device, "%s",
1097 "FORMAT F - Track format incorrect");
1098 break;
1099 case 0x09:
1100 DEV_MESSAGE(KERN_WARNING, device, "%s",
1101 "FORMAT F - Caching reinitiated");
1102 break;
1103 case 0x0A:
1104 DEV_MESSAGE(KERN_WARNING, device, "%s",
1105 "FORMAT F - Nonvolatile storage "
1106 "terminated");
1107 break;
1108 case 0x0B:
1109 DEV_MESSAGE(KERN_WARNING, device, "%s",
1110 "FORMAT F - Volume is suspended duplex");
1111 /* call extended error reporting (EER) */
1112 dasd_write_eer_trigger(DASD_EER_PPRCSUSPEND, device,
1113 erp->refers);
1114 break;
1115 case 0x0C:
1116 DEV_MESSAGE(KERN_WARNING, device, "%s",
1117 "FORMAT F - Subsystem status connot be "
1118 "determined");
1119 break;
1120 case 0x0D:
1121 DEV_MESSAGE(KERN_WARNING, device, "%s",
1122 "FORMAT F - Caching status reset to "
1123 "default");
1124 break;
1125 case 0x0E:
1126 DEV_MESSAGE(KERN_WARNING, device, "%s",
1127 "FORMAT F - DASD Fast Write inhibited");
1128 break;
1129 default:
1130 DEV_MESSAGE(KERN_WARNING, device, "%s",
1131 "FORMAT D - Reserved");
1133 break;
1135 default: /* unknown message format - should not happen */
1136 DEV_MESSAGE (KERN_WARNING, device,
1137 "unknown message format %02x",
1138 msg_format);
1139 break;
1140 } /* end switch message format */
1142 } /* end dasd_3990_handle_env_data */
1145 * DASD_3990_ERP_COM_REJ
1147 * DESCRIPTION
1148 * Handles 24 byte 'Command Reject' error.
1150 * PARAMETER
1151 * erp current erp_head
1152 * sense current sense data
1154 * RETURN VALUES
1155 * erp 'new' erp_head - pointer to new ERP
1157 static struct dasd_ccw_req *
1158 dasd_3990_erp_com_rej(struct dasd_ccw_req * erp, char *sense)
1161 struct dasd_device *device = erp->device;
1163 erp->function = dasd_3990_erp_com_rej;
1165 /* env data present (ACTION 10 - retry should work) */
1166 if (sense[2] & SNS2_ENV_DATA_PRESENT) {
1168 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1169 "Command Reject - environmental data present");
1171 dasd_3990_handle_env_data(erp, sense);
1173 erp->retries = 5;
1175 } else {
1176 /* fatal error - set status to FAILED */
1177 DEV_MESSAGE(KERN_ERR, device, "%s",
1178 "Command Reject - Fatal error");
1180 erp = dasd_3990_erp_cleanup(erp, DASD_CQR_FAILED);
1183 return erp;
1185 } /* end dasd_3990_erp_com_rej */
1188 * DASD_3990_ERP_BUS_OUT
1190 * DESCRIPTION
1191 * Handles 24 byte 'Bus Out Parity Check' error.
1193 * PARAMETER
1194 * erp current erp_head
1195 * RETURN VALUES
1196 * erp new erp_head - pointer to new ERP
1198 static struct dasd_ccw_req *
1199 dasd_3990_erp_bus_out(struct dasd_ccw_req * erp)
1202 struct dasd_device *device = erp->device;
1204 /* first time set initial retry counter and erp_function */
1205 /* and retry once without blocking queue */
1206 /* (this enables easier enqueing of the cqr) */
1207 if (erp->function != dasd_3990_erp_bus_out) {
1208 erp->retries = 256;
1209 erp->function = dasd_3990_erp_bus_out;
1211 } else {
1213 /* issue a message and wait for 'device ready' interrupt */
1214 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1215 "bus out parity error or BOPC requested by "
1216 "channel");
1218 dasd_3990_erp_block_queue(erp, 60*HZ);
1222 return erp;
1224 } /* end dasd_3990_erp_bus_out */
1227 * DASD_3990_ERP_EQUIP_CHECK
1229 * DESCRIPTION
1230 * Handles 24 byte 'Equipment Check' error.
1232 * PARAMETER
1233 * erp current erp_head
1234 * RETURN VALUES
1235 * erp new erp_head - pointer to new ERP
1237 static struct dasd_ccw_req *
1238 dasd_3990_erp_equip_check(struct dasd_ccw_req * erp, char *sense)
1241 struct dasd_device *device = erp->device;
1243 erp->function = dasd_3990_erp_equip_check;
1245 if (sense[1] & SNS1_WRITE_INHIBITED) {
1247 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1248 "Write inhibited path encountered");
1250 /* vary path offline */
1251 DEV_MESSAGE(KERN_ERR, device, "%s",
1252 "Path should be varied off-line. "
1253 "This is not implemented yet \n - please report "
1254 "to linux390@de.ibm.com");
1256 erp = dasd_3990_erp_action_1(erp);
1258 } else if (sense[2] & SNS2_ENV_DATA_PRESENT) {
1260 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1261 "Equipment Check - " "environmental data present");
1263 dasd_3990_handle_env_data(erp, sense);
1265 erp = dasd_3990_erp_action_4(erp, sense);
1267 } else if (sense[1] & SNS1_PERM_ERR) {
1269 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1270 "Equipment Check - retry exhausted or "
1271 "undesirable");
1273 erp = dasd_3990_erp_action_1(erp);
1275 } else {
1276 /* all other equipment checks - Action 5 */
1277 /* rest is done when retries == 0 */
1278 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1279 "Equipment check or processing error");
1281 erp = dasd_3990_erp_action_5(erp);
1284 return erp;
1286 } /* end dasd_3990_erp_equip_check */
1289 * DASD_3990_ERP_DATA_CHECK
1291 * DESCRIPTION
1292 * Handles 24 byte 'Data Check' error.
1294 * PARAMETER
1295 * erp current erp_head
1296 * RETURN VALUES
1297 * erp new erp_head - pointer to new ERP
1299 static struct dasd_ccw_req *
1300 dasd_3990_erp_data_check(struct dasd_ccw_req * erp, char *sense)
1303 struct dasd_device *device = erp->device;
1305 erp->function = dasd_3990_erp_data_check;
1307 if (sense[2] & SNS2_CORRECTABLE) { /* correctable data check */
1309 /* issue message that the data has been corrected */
1310 DEV_MESSAGE(KERN_EMERG, device, "%s",
1311 "Data recovered during retry with PCI "
1312 "fetch mode active");
1314 /* not possible to handle this situation in Linux */
1315 panic("No way to inform application about the possibly "
1316 "incorrect data");
1318 } else if (sense[2] & SNS2_ENV_DATA_PRESENT) {
1320 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1321 "Uncorrectable data check recovered secondary "
1322 "addr of duplex pair");
1324 erp = dasd_3990_erp_action_4(erp, sense);
1326 } else if (sense[1] & SNS1_PERM_ERR) {
1328 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1329 "Uncorrectable data check with internal "
1330 "retry exhausted");
1332 erp = dasd_3990_erp_action_1(erp);
1334 } else {
1335 /* all other data checks */
1336 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1337 "Uncorrectable data check with retry count "
1338 "exhausted...");
1340 erp = dasd_3990_erp_action_5(erp);
1343 return erp;
1345 } /* end dasd_3990_erp_data_check */
1348 * DASD_3990_ERP_OVERRUN
1350 * DESCRIPTION
1351 * Handles 24 byte 'Overrun' error.
1353 * PARAMETER
1354 * erp current erp_head
1355 * RETURN VALUES
1356 * erp new erp_head - pointer to new ERP
1358 static struct dasd_ccw_req *
1359 dasd_3990_erp_overrun(struct dasd_ccw_req * erp, char *sense)
1362 struct dasd_device *device = erp->device;
1364 erp->function = dasd_3990_erp_overrun;
1366 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1367 "Overrun - service overrun or overrun"
1368 " error requested by channel");
1370 erp = dasd_3990_erp_action_5(erp);
1372 return erp;
1374 } /* end dasd_3990_erp_overrun */
1377 * DASD_3990_ERP_INV_FORMAT
1379 * DESCRIPTION
1380 * Handles 24 byte 'Invalid Track Format' error.
1382 * PARAMETER
1383 * erp current erp_head
1384 * RETURN VALUES
1385 * erp new erp_head - pointer to new ERP
1387 static struct dasd_ccw_req *
1388 dasd_3990_erp_inv_format(struct dasd_ccw_req * erp, char *sense)
1391 struct dasd_device *device = erp->device;
1393 erp->function = dasd_3990_erp_inv_format;
1395 if (sense[2] & SNS2_ENV_DATA_PRESENT) {
1397 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1398 "Track format error when destaging or "
1399 "staging data");
1401 dasd_3990_handle_env_data(erp, sense);
1403 erp = dasd_3990_erp_action_4(erp, sense);
1405 } else {
1406 DEV_MESSAGE(KERN_ERR, device, "%s",
1407 "Invalid Track Format - Fatal error should have "
1408 "been handled within the interrupt handler");
1410 erp = dasd_3990_erp_cleanup(erp, DASD_CQR_FAILED);
1413 return erp;
1415 } /* end dasd_3990_erp_inv_format */
1418 * DASD_3990_ERP_EOC
1420 * DESCRIPTION
1421 * Handles 24 byte 'End-of-Cylinder' error.
1423 * PARAMETER
1424 * erp already added default erp
1425 * RETURN VALUES
1426 * erp pointer to original (failed) cqr.
1428 static struct dasd_ccw_req *
1429 dasd_3990_erp_EOC(struct dasd_ccw_req * default_erp, char *sense)
1432 struct dasd_device *device = default_erp->device;
1434 DEV_MESSAGE(KERN_ERR, device, "%s",
1435 "End-of-Cylinder - must never happen");
1437 /* implement action 7 - BUG */
1438 return dasd_3990_erp_cleanup(default_erp, DASD_CQR_FAILED);
1440 } /* end dasd_3990_erp_EOC */
1443 * DASD_3990_ERP_ENV_DATA
1445 * DESCRIPTION
1446 * Handles 24 byte 'Environmental-Data Present' error.
1448 * PARAMETER
1449 * erp current erp_head
1450 * RETURN VALUES
1451 * erp new erp_head - pointer to new ERP
1453 static struct dasd_ccw_req *
1454 dasd_3990_erp_env_data(struct dasd_ccw_req * erp, char *sense)
1457 struct dasd_device *device = erp->device;
1459 erp->function = dasd_3990_erp_env_data;
1461 DEV_MESSAGE(KERN_DEBUG, device, "%s", "Environmental data present");
1463 dasd_3990_handle_env_data(erp, sense);
1465 /* don't retry on disabled interface */
1466 if (sense[7] != 0x0F) {
1468 erp = dasd_3990_erp_action_4(erp, sense);
1469 } else {
1471 erp = dasd_3990_erp_cleanup(erp, DASD_CQR_IN_IO);
1474 return erp;
1476 } /* end dasd_3990_erp_env_data */
1479 * DASD_3990_ERP_NO_REC
1481 * DESCRIPTION
1482 * Handles 24 byte 'No Record Found' error.
1484 * PARAMETER
1485 * erp already added default ERP
1487 * RETURN VALUES
1488 * erp new erp_head - pointer to new ERP
1490 static struct dasd_ccw_req *
1491 dasd_3990_erp_no_rec(struct dasd_ccw_req * default_erp, char *sense)
1494 struct dasd_device *device = default_erp->device;
1496 DEV_MESSAGE(KERN_ERR, device, "%s",
1497 "No Record Found - Fatal error should "
1498 "have been handled within the interrupt handler");
1500 return dasd_3990_erp_cleanup(default_erp, DASD_CQR_FAILED);
1502 } /* end dasd_3990_erp_no_rec */
1505 * DASD_3990_ERP_FILE_PROT
1507 * DESCRIPTION
1508 * Handles 24 byte 'File Protected' error.
1509 * Note: Seek related recovery is not implemented because
1510 * wee don't use the seek command yet.
1512 * PARAMETER
1513 * erp current erp_head
1514 * RETURN VALUES
1515 * erp new erp_head - pointer to new ERP
1517 static struct dasd_ccw_req *
1518 dasd_3990_erp_file_prot(struct dasd_ccw_req * erp)
1521 struct dasd_device *device = erp->device;
1523 DEV_MESSAGE(KERN_ERR, device, "%s", "File Protected");
1525 return dasd_3990_erp_cleanup(erp, DASD_CQR_FAILED);
1527 } /* end dasd_3990_erp_file_prot */
1530 * DASD_3990_ERP_INSPECT_24
1532 * DESCRIPTION
1533 * Does a detailed inspection of the 24 byte sense data
1534 * and sets up a related error recovery action.
1536 * PARAMETER
1537 * sense sense data of the actual error
1538 * erp pointer to the currently created default ERP
1540 * RETURN VALUES
1541 * erp pointer to the (addtitional) ERP
1543 static struct dasd_ccw_req *
1544 dasd_3990_erp_inspect_24(struct dasd_ccw_req * erp, char *sense)
1547 struct dasd_ccw_req *erp_filled = NULL;
1549 /* Check sense for .... */
1550 /* 'Command Reject' */
1551 if ((erp_filled == NULL) && (sense[0] & SNS0_CMD_REJECT)) {
1552 erp_filled = dasd_3990_erp_com_rej(erp, sense);
1554 /* 'Intervention Required' */
1555 if ((erp_filled == NULL) && (sense[0] & SNS0_INTERVENTION_REQ)) {
1556 erp_filled = dasd_3990_erp_int_req(erp);
1558 /* 'Bus Out Parity Check' */
1559 if ((erp_filled == NULL) && (sense[0] & SNS0_BUS_OUT_CHECK)) {
1560 erp_filled = dasd_3990_erp_bus_out(erp);
1562 /* 'Equipment Check' */
1563 if ((erp_filled == NULL) && (sense[0] & SNS0_EQUIPMENT_CHECK)) {
1564 erp_filled = dasd_3990_erp_equip_check(erp, sense);
1566 /* 'Data Check' */
1567 if ((erp_filled == NULL) && (sense[0] & SNS0_DATA_CHECK)) {
1568 erp_filled = dasd_3990_erp_data_check(erp, sense);
1570 /* 'Overrun' */
1571 if ((erp_filled == NULL) && (sense[0] & SNS0_OVERRUN)) {
1572 erp_filled = dasd_3990_erp_overrun(erp, sense);
1574 /* 'Invalid Track Format' */
1575 if ((erp_filled == NULL) && (sense[1] & SNS1_INV_TRACK_FORMAT)) {
1576 erp_filled = dasd_3990_erp_inv_format(erp, sense);
1578 /* 'End-of-Cylinder' */
1579 if ((erp_filled == NULL) && (sense[1] & SNS1_EOC)) {
1580 erp_filled = dasd_3990_erp_EOC(erp, sense);
1582 /* 'Environmental Data' */
1583 if ((erp_filled == NULL) && (sense[2] & SNS2_ENV_DATA_PRESENT)) {
1584 erp_filled = dasd_3990_erp_env_data(erp, sense);
1586 /* 'No Record Found' */
1587 if ((erp_filled == NULL) && (sense[1] & SNS1_NO_REC_FOUND)) {
1588 erp_filled = dasd_3990_erp_no_rec(erp, sense);
1590 /* 'File Protected' */
1591 if ((erp_filled == NULL) && (sense[1] & SNS1_FILE_PROTECTED)) {
1592 erp_filled = dasd_3990_erp_file_prot(erp);
1594 /* other (unknown) error - do default ERP */
1595 if (erp_filled == NULL) {
1597 erp_filled = erp;
1600 return erp_filled;
1602 } /* END dasd_3990_erp_inspect_24 */
1605 *****************************************************************************
1606 * 32 byte sense ERP functions (only)
1607 *****************************************************************************
1611 * DASD_3990_ERPACTION_10_32
1613 * DESCRIPTION
1614 * Handles 32 byte 'Action 10' of Single Program Action Codes.
1615 * Just retry and if retry doesn't work, return with error.
1617 * PARAMETER
1618 * erp current erp_head
1619 * sense current sense data
1620 * RETURN VALUES
1621 * erp modified erp_head
1623 static struct dasd_ccw_req *
1624 dasd_3990_erp_action_10_32(struct dasd_ccw_req * erp, char *sense)
1627 struct dasd_device *device = erp->device;
1629 erp->retries = 256;
1630 erp->function = dasd_3990_erp_action_10_32;
1632 DEV_MESSAGE(KERN_DEBUG, device, "%s", "Perform logging requested");
1634 return erp;
1636 } /* end dasd_3990_erp_action_10_32 */
1639 * DASD_3990_ERP_ACTION_1B_32
1641 * DESCRIPTION
1642 * Handles 32 byte 'Action 1B' of Single Program Action Codes.
1643 * A write operation could not be finished because of an unexpected
1644 * condition.
1645 * The already created 'default erp' is used to get the link to
1646 * the erp chain, but it can not be used for this recovery
1647 * action because it contains no DE/LO data space.
1649 * PARAMETER
1650 * default_erp already added default erp.
1651 * sense current sense data
1653 * RETURN VALUES
1654 * erp new erp or
1655 * default_erp in case of imprecise ending or error
1657 static struct dasd_ccw_req *
1658 dasd_3990_erp_action_1B_32(struct dasd_ccw_req * default_erp, char *sense)
1661 struct dasd_device *device = default_erp->device;
1662 __u32 cpa = 0;
1663 struct dasd_ccw_req *cqr;
1664 struct dasd_ccw_req *erp;
1665 struct DE_eckd_data *DE_data;
1666 char *LO_data; /* LO_eckd_data_t */
1667 struct ccw1 *ccw;
1669 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1670 "Write not finished because of unexpected condition");
1672 default_erp->function = dasd_3990_erp_action_1B_32;
1674 /* determine the original cqr */
1675 cqr = default_erp;
1677 while (cqr->refers != NULL) {
1678 cqr = cqr->refers;
1681 /* for imprecise ending just do default erp */
1682 if (sense[1] & 0x01) {
1684 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1685 "Imprecise ending is set - just retry");
1687 return default_erp;
1690 /* determine the address of the CCW to be restarted */
1691 /* Imprecise ending is not set -> addr from IRB-SCSW */
1692 cpa = default_erp->refers->irb.scsw.cpa;
1694 if (cpa == 0) {
1696 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1697 "Unable to determine address of the CCW "
1698 "to be restarted");
1700 return dasd_3990_erp_cleanup(default_erp, DASD_CQR_FAILED);
1703 /* Build new ERP request including DE/LO */
1704 erp = dasd_alloc_erp_request((char *) &cqr->magic,
1705 2 + 1,/* DE/LO + TIC */
1706 sizeof (struct DE_eckd_data) +
1707 sizeof (struct LO_eckd_data), device);
1709 if (IS_ERR(erp)) {
1710 DEV_MESSAGE(KERN_ERR, device, "%s", "Unable to allocate ERP");
1711 return dasd_3990_erp_cleanup(default_erp, DASD_CQR_FAILED);
1714 /* use original DE */
1715 DE_data = erp->data;
1716 memcpy(DE_data, cqr->data, sizeof (struct DE_eckd_data));
1718 /* create LO */
1719 LO_data = erp->data + sizeof (struct DE_eckd_data);
1721 if ((sense[3] == 0x01) && (LO_data[1] & 0x01)) {
1723 DEV_MESSAGE(KERN_ERR, device, "%s",
1724 "BUG - this should not happen");
1726 return dasd_3990_erp_cleanup(default_erp, DASD_CQR_FAILED);
1729 if ((sense[7] & 0x3F) == 0x01) {
1730 /* operation code is WRITE DATA -> data area orientation */
1731 LO_data[0] = 0x81;
1733 } else if ((sense[7] & 0x3F) == 0x03) {
1734 /* operation code is FORMAT WRITE -> index orientation */
1735 LO_data[0] = 0xC3;
1737 } else {
1738 LO_data[0] = sense[7]; /* operation */
1741 LO_data[1] = sense[8]; /* auxiliary */
1742 LO_data[2] = sense[9];
1743 LO_data[3] = sense[3]; /* count */
1744 LO_data[4] = sense[29]; /* seek_addr.cyl */
1745 LO_data[5] = sense[30]; /* seek_addr.cyl 2nd byte */
1746 LO_data[7] = sense[31]; /* seek_addr.head 2nd byte */
1748 memcpy(&(LO_data[8]), &(sense[11]), 8);
1750 /* create DE ccw */
1751 ccw = erp->cpaddr;
1752 memset(ccw, 0, sizeof (struct ccw1));
1753 ccw->cmd_code = DASD_ECKD_CCW_DEFINE_EXTENT;
1754 ccw->flags = CCW_FLAG_CC;
1755 ccw->count = 16;
1756 ccw->cda = (__u32)(addr_t) DE_data;
1758 /* create LO ccw */
1759 ccw++;
1760 memset(ccw, 0, sizeof (struct ccw1));
1761 ccw->cmd_code = DASD_ECKD_CCW_LOCATE_RECORD;
1762 ccw->flags = CCW_FLAG_CC;
1763 ccw->count = 16;
1764 ccw->cda = (__u32)(addr_t) LO_data;
1766 /* TIC to the failed ccw */
1767 ccw++;
1768 ccw->cmd_code = CCW_CMD_TIC;
1769 ccw->cda = cpa;
1771 /* fill erp related fields */
1772 erp->function = dasd_3990_erp_action_1B_32;
1773 erp->refers = default_erp->refers;
1774 erp->device = device;
1775 erp->magic = default_erp->magic;
1776 erp->expires = 0;
1777 erp->retries = 256;
1778 erp->buildclk = get_clock();
1779 erp->status = DASD_CQR_FILLED;
1781 /* remove the default erp */
1782 dasd_free_erp_request(default_erp, device);
1784 return erp;
1786 } /* end dasd_3990_erp_action_1B_32 */
1789 * DASD_3990_UPDATE_1B
1791 * DESCRIPTION
1792 * Handles the update to the 32 byte 'Action 1B' of Single Program
1793 * Action Codes in case the first action was not successful.
1794 * The already created 'previous_erp' is the currently not successful
1795 * ERP.
1797 * PARAMETER
1798 * previous_erp already created previous erp.
1799 * sense current sense data
1800 * RETURN VALUES
1801 * erp modified erp
1803 static struct dasd_ccw_req *
1804 dasd_3990_update_1B(struct dasd_ccw_req * previous_erp, char *sense)
1807 struct dasd_device *device = previous_erp->device;
1808 __u32 cpa = 0;
1809 struct dasd_ccw_req *cqr;
1810 struct dasd_ccw_req *erp;
1811 char *LO_data; /* struct LO_eckd_data */
1812 struct ccw1 *ccw;
1814 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1815 "Write not finished because of unexpected condition"
1816 " - follow on");
1818 /* determine the original cqr */
1819 cqr = previous_erp;
1821 while (cqr->refers != NULL) {
1822 cqr = cqr->refers;
1825 /* for imprecise ending just do default erp */
1826 if (sense[1] & 0x01) {
1828 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1829 "Imprecise ending is set - just retry");
1831 previous_erp->status = DASD_CQR_QUEUED;
1833 return previous_erp;
1836 /* determine the address of the CCW to be restarted */
1837 /* Imprecise ending is not set -> addr from IRB-SCSW */
1838 cpa = previous_erp->irb.scsw.cpa;
1840 if (cpa == 0) {
1842 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1843 "Unable to determine address of the CCW "
1844 "to be restarted");
1846 previous_erp->status = DASD_CQR_FAILED;
1848 return previous_erp;
1851 erp = previous_erp;
1853 /* update the LO with the new returned sense data */
1854 LO_data = erp->data + sizeof (struct DE_eckd_data);
1856 if ((sense[3] == 0x01) && (LO_data[1] & 0x01)) {
1858 DEV_MESSAGE(KERN_ERR, device, "%s",
1859 "BUG - this should not happen");
1861 previous_erp->status = DASD_CQR_FAILED;
1863 return previous_erp;
1866 if ((sense[7] & 0x3F) == 0x01) {
1867 /* operation code is WRITE DATA -> data area orientation */
1868 LO_data[0] = 0x81;
1870 } else if ((sense[7] & 0x3F) == 0x03) {
1871 /* operation code is FORMAT WRITE -> index orientation */
1872 LO_data[0] = 0xC3;
1874 } else {
1875 LO_data[0] = sense[7]; /* operation */
1878 LO_data[1] = sense[8]; /* auxiliary */
1879 LO_data[2] = sense[9];
1880 LO_data[3] = sense[3]; /* count */
1881 LO_data[4] = sense[29]; /* seek_addr.cyl */
1882 LO_data[5] = sense[30]; /* seek_addr.cyl 2nd byte */
1883 LO_data[7] = sense[31]; /* seek_addr.head 2nd byte */
1885 memcpy(&(LO_data[8]), &(sense[11]), 8);
1887 /* TIC to the failed ccw */
1888 ccw = erp->cpaddr; /* addr of DE ccw */
1889 ccw++; /* addr of LE ccw */
1890 ccw++; /* addr of TIC ccw */
1891 ccw->cda = cpa;
1893 erp->status = DASD_CQR_QUEUED;
1895 return erp;
1897 } /* end dasd_3990_update_1B */
1900 * DASD_3990_ERP_COMPOUND_RETRY
1902 * DESCRIPTION
1903 * Handles the compound ERP action retry code.
1904 * NOTE: At least one retry is done even if zero is specified
1905 * by the sense data. This makes enqueueing of the request
1906 * easier.
1908 * PARAMETER
1909 * sense sense data of the actual error
1910 * erp pointer to the currently created ERP
1912 * RETURN VALUES
1913 * erp modified ERP pointer
1916 static void
1917 dasd_3990_erp_compound_retry(struct dasd_ccw_req * erp, char *sense)
1920 switch (sense[25] & 0x03) {
1921 case 0x00: /* no not retry */
1922 erp->retries = 1;
1923 break;
1925 case 0x01: /* retry 2 times */
1926 erp->retries = 2;
1927 break;
1929 case 0x02: /* retry 10 times */
1930 erp->retries = 10;
1931 break;
1933 case 0x03: /* retry 256 times */
1934 erp->retries = 256;
1935 break;
1937 default:
1938 BUG();
1941 erp->function = dasd_3990_erp_compound_retry;
1943 } /* end dasd_3990_erp_compound_retry */
1946 * DASD_3990_ERP_COMPOUND_PATH
1948 * DESCRIPTION
1949 * Handles the compound ERP action for retry on alternate
1950 * channel path.
1952 * PARAMETER
1953 * sense sense data of the actual error
1954 * erp pointer to the currently created ERP
1956 * RETURN VALUES
1957 * erp modified ERP pointer
1960 static void
1961 dasd_3990_erp_compound_path(struct dasd_ccw_req * erp, char *sense)
1964 if (sense[25] & DASD_SENSE_BIT_3) {
1965 dasd_3990_erp_alternate_path(erp);
1967 if (erp->status == DASD_CQR_FAILED) {
1968 /* reset the lpm and the status to be able to
1969 * try further actions. */
1971 erp->lpm = 0;
1973 erp->status = DASD_CQR_ERROR;
1978 erp->function = dasd_3990_erp_compound_path;
1980 } /* end dasd_3990_erp_compound_path */
1983 * DASD_3990_ERP_COMPOUND_CODE
1985 * DESCRIPTION
1986 * Handles the compound ERP action for retry code.
1988 * PARAMETER
1989 * sense sense data of the actual error
1990 * erp pointer to the currently created ERP
1992 * RETURN VALUES
1993 * erp NEW ERP pointer
1996 static struct dasd_ccw_req *
1997 dasd_3990_erp_compound_code(struct dasd_ccw_req * erp, char *sense)
2000 if (sense[25] & DASD_SENSE_BIT_2) {
2002 switch (sense[28]) {
2003 case 0x17:
2004 /* issue a Diagnostic Control command with an
2005 * Inhibit Write subcommand and controler modifier */
2006 erp = dasd_3990_erp_DCTL(erp, 0x20);
2007 break;
2009 case 0x25:
2010 /* wait for 5 seconds and retry again */
2011 erp->retries = 1;
2013 dasd_3990_erp_block_queue (erp, 5*HZ);
2014 break;
2016 default:
2017 /* should not happen - continue */
2018 break;
2022 erp->function = dasd_3990_erp_compound_code;
2024 return erp;
2026 } /* end dasd_3990_erp_compound_code */
2029 * DASD_3990_ERP_COMPOUND_CONFIG
2031 * DESCRIPTION
2032 * Handles the compound ERP action for configruation
2033 * dependent error.
2034 * Note: duplex handling is not implemented (yet).
2036 * PARAMETER
2037 * sense sense data of the actual error
2038 * erp pointer to the currently created ERP
2040 * RETURN VALUES
2041 * erp modified ERP pointer
2044 static void
2045 dasd_3990_erp_compound_config(struct dasd_ccw_req * erp, char *sense)
2048 if ((sense[25] & DASD_SENSE_BIT_1) && (sense[26] & DASD_SENSE_BIT_2)) {
2050 /* set to suspended duplex state then restart */
2051 struct dasd_device *device = erp->device;
2053 DEV_MESSAGE(KERN_ERR, device, "%s",
2054 "Set device to suspended duplex state should be "
2055 "done!\n"
2056 "This is not implemented yet (for compound ERP)"
2057 " - please report to linux390@de.ibm.com");
2061 erp->function = dasd_3990_erp_compound_config;
2063 } /* end dasd_3990_erp_compound_config */
2066 * DASD_3990_ERP_COMPOUND
2068 * DESCRIPTION
2069 * Does the further compound program action if
2070 * compound retry was not successful.
2072 * PARAMETER
2073 * sense sense data of the actual error
2074 * erp pointer to the current (failed) ERP
2076 * RETURN VALUES
2077 * erp (additional) ERP pointer
2080 static struct dasd_ccw_req *
2081 dasd_3990_erp_compound(struct dasd_ccw_req * erp, char *sense)
2084 if ((erp->function == dasd_3990_erp_compound_retry) &&
2085 (erp->status == DASD_CQR_ERROR)) {
2087 dasd_3990_erp_compound_path(erp, sense);
2090 if ((erp->function == dasd_3990_erp_compound_path) &&
2091 (erp->status == DASD_CQR_ERROR)) {
2093 erp = dasd_3990_erp_compound_code(erp, sense);
2096 if ((erp->function == dasd_3990_erp_compound_code) &&
2097 (erp->status == DASD_CQR_ERROR)) {
2099 dasd_3990_erp_compound_config(erp, sense);
2102 /* if no compound action ERP specified, the request failed */
2103 if (erp->status == DASD_CQR_ERROR) {
2105 erp->status = DASD_CQR_FAILED;
2108 return erp;
2110 } /* end dasd_3990_erp_compound */
2113 * DASD_3990_ERP_INSPECT_32
2115 * DESCRIPTION
2116 * Does a detailed inspection of the 32 byte sense data
2117 * and sets up a related error recovery action.
2119 * PARAMETER
2120 * sense sense data of the actual error
2121 * erp pointer to the currently created default ERP
2123 * RETURN VALUES
2124 * erp_filled pointer to the ERP
2127 static struct dasd_ccw_req *
2128 dasd_3990_erp_inspect_32(struct dasd_ccw_req * erp, char *sense)
2131 struct dasd_device *device = erp->device;
2133 erp->function = dasd_3990_erp_inspect_32;
2135 if (sense[25] & DASD_SENSE_BIT_0) {
2137 /* compound program action codes (byte25 bit 0 == '1') */
2138 dasd_3990_erp_compound_retry(erp, sense);
2140 } else {
2142 /* single program action codes (byte25 bit 0 == '0') */
2143 switch (sense[25]) {
2145 case 0x00: /* success - use default ERP for retries */
2146 DEV_MESSAGE(KERN_DEBUG, device, "%s",
2147 "ERP called for successful request"
2148 " - just retry");
2149 break;
2151 case 0x01: /* fatal error */
2152 DEV_MESSAGE(KERN_ERR, device, "%s",
2153 "Fatal error should have been "
2154 "handled within the interrupt handler");
2156 erp = dasd_3990_erp_cleanup(erp, DASD_CQR_FAILED);
2157 break;
2159 case 0x02: /* intervention required */
2160 case 0x03: /* intervention required during dual copy */
2161 erp = dasd_3990_erp_int_req(erp);
2162 break;
2164 case 0x0F: /* length mismatch during update write command */
2165 DEV_MESSAGE(KERN_ERR, device, "%s",
2166 "update write command error - should not "
2167 "happen;\n"
2168 "Please send this message together with "
2169 "the above sense data to linux390@de."
2170 "ibm.com");
2172 erp = dasd_3990_erp_cleanup(erp, DASD_CQR_FAILED);
2173 break;
2175 case 0x10: /* logging required for other channel program */
2176 erp = dasd_3990_erp_action_10_32(erp, sense);
2177 break;
2179 case 0x15: /* next track outside defined extend */
2180 DEV_MESSAGE(KERN_ERR, device, "%s",
2181 "next track outside defined extend - "
2182 "should not happen;\n"
2183 "Please send this message together with "
2184 "the above sense data to linux390@de."
2185 "ibm.com");
2187 erp = dasd_3990_erp_cleanup(erp, DASD_CQR_FAILED);
2188 break;
2190 case 0x1B: /* unexpected condition during write */
2192 erp = dasd_3990_erp_action_1B_32(erp, sense);
2193 break;
2195 case 0x1C: /* invalid data */
2196 DEV_MESSAGE(KERN_EMERG, device, "%s",
2197 "Data recovered during retry with PCI "
2198 "fetch mode active");
2200 /* not possible to handle this situation in Linux */
2201 panic
2202 ("Invalid data - No way to inform application "
2203 "about the possibly incorrect data");
2204 break;
2206 case 0x1D: /* state-change pending */
2207 DEV_MESSAGE(KERN_DEBUG, device, "%s",
2208 "A State change pending condition exists "
2209 "for the subsystem or device");
2211 erp = dasd_3990_erp_action_4(erp, sense);
2212 break;
2214 case 0x1E: /* busy */
2215 DEV_MESSAGE(KERN_DEBUG, device, "%s",
2216 "Busy condition exists "
2217 "for the subsystem or device");
2218 erp = dasd_3990_erp_action_4(erp, sense);
2219 break;
2221 default: /* all others errors - default erp */
2222 break;
2226 return erp;
2228 } /* end dasd_3990_erp_inspect_32 */
2231 *****************************************************************************
2232 * main ERP control fuctions (24 and 32 byte sense)
2233 *****************************************************************************
2237 * DASD_3990_ERP_INSPECT
2239 * DESCRIPTION
2240 * Does a detailed inspection for sense data by calling either
2241 * the 24-byte or the 32-byte inspection routine.
2243 * PARAMETER
2244 * erp pointer to the currently created default ERP
2245 * RETURN VALUES
2246 * erp_new contens was possibly modified
2248 static struct dasd_ccw_req *
2249 dasd_3990_erp_inspect(struct dasd_ccw_req * erp)
2252 struct dasd_ccw_req *erp_new = NULL;
2253 /* sense data are located in the refers record of the */
2254 /* already set up new ERP ! */
2255 char *sense = erp->refers->irb.ecw;
2257 /* distinguish between 24 and 32 byte sense data */
2258 if (sense[27] & DASD_SENSE_BIT_0) {
2260 /* inspect the 24 byte sense data */
2261 erp_new = dasd_3990_erp_inspect_24(erp, sense);
2263 } else {
2265 /* inspect the 32 byte sense data */
2266 erp_new = dasd_3990_erp_inspect_32(erp, sense);
2268 } /* end distinguish between 24 and 32 byte sense data */
2270 return erp_new;
2274 * DASD_3990_ERP_ADD_ERP
2276 * DESCRIPTION
2277 * This funtion adds an additional request block (ERP) to the head of
2278 * the given cqr (or erp).
2279 * This erp is initialized as an default erp (retry TIC)
2281 * PARAMETER
2282 * cqr head of the current ERP-chain (or single cqr if
2283 * first error)
2284 * RETURN VALUES
2285 * erp pointer to new ERP-chain head
2287 static struct dasd_ccw_req *
2288 dasd_3990_erp_add_erp(struct dasd_ccw_req * cqr)
2291 struct dasd_device *device = cqr->device;
2292 struct ccw1 *ccw;
2294 /* allocate additional request block */
2295 struct dasd_ccw_req *erp;
2297 erp = dasd_alloc_erp_request((char *) &cqr->magic, 2, 0, cqr->device);
2298 if (IS_ERR(erp)) {
2299 if (cqr->retries <= 0) {
2300 DEV_MESSAGE(KERN_ERR, device, "%s",
2301 "Unable to allocate ERP request");
2302 cqr->status = DASD_CQR_FAILED;
2303 cqr->stopclk = get_clock ();
2304 } else {
2305 DEV_MESSAGE (KERN_ERR, device,
2306 "Unable to allocate ERP request "
2307 "(%i retries left)",
2308 cqr->retries);
2309 dasd_set_timer(device, (HZ << 3));
2311 return cqr;
2314 /* initialize request with default TIC to current ERP/CQR */
2315 ccw = erp->cpaddr;
2316 ccw->cmd_code = CCW_CMD_NOOP;
2317 ccw->flags = CCW_FLAG_CC;
2318 ccw++;
2319 ccw->cmd_code = CCW_CMD_TIC;
2320 ccw->cda = (long)(cqr->cpaddr);
2321 erp->function = dasd_3990_erp_add_erp;
2322 erp->refers = cqr;
2323 erp->device = cqr->device;
2324 erp->magic = cqr->magic;
2325 erp->expires = 0;
2326 erp->retries = 256;
2327 erp->buildclk = get_clock();
2329 erp->status = DASD_CQR_FILLED;
2331 return erp;
2335 * DASD_3990_ERP_ADDITIONAL_ERP
2337 * DESCRIPTION
2338 * An additional ERP is needed to handle the current error.
2339 * Add ERP to the head of the ERP-chain containing the ERP processing
2340 * determined based on the sense data.
2342 * PARAMETER
2343 * cqr head of the current ERP-chain (or single cqr if
2344 * first error)
2346 * RETURN VALUES
2347 * erp pointer to new ERP-chain head
2349 static struct dasd_ccw_req *
2350 dasd_3990_erp_additional_erp(struct dasd_ccw_req * cqr)
2353 struct dasd_ccw_req *erp = NULL;
2355 /* add erp and initialize with default TIC */
2356 erp = dasd_3990_erp_add_erp(cqr);
2358 /* inspect sense, determine specific ERP if possible */
2359 if (erp != cqr) {
2361 erp = dasd_3990_erp_inspect(erp);
2364 return erp;
2366 } /* end dasd_3990_erp_additional_erp */
2369 * DASD_3990_ERP_ERROR_MATCH
2371 * DESCRIPTION
2372 * Check if the device status of the given cqr is the same.
2373 * This means that the failed CCW and the relevant sense data
2374 * must match.
2375 * I don't distinguish between 24 and 32 byte sense because in case of
2376 * 24 byte sense byte 25 and 27 is set as well.
2378 * PARAMETER
2379 * cqr1 first cqr, which will be compared with the
2380 * cqr2 second cqr.
2382 * RETURN VALUES
2383 * match 'boolean' for match found
2384 * returns 1 if match found, otherwise 0.
2386 static int
2387 dasd_3990_erp_error_match(struct dasd_ccw_req *cqr1, struct dasd_ccw_req *cqr2)
2390 /* check failed CCW */
2391 if (cqr1->irb.scsw.cpa != cqr2->irb.scsw.cpa) {
2392 // return 0; /* CCW doesn't match */
2395 /* check sense data; byte 0-2,25,27 */
2396 if (!((memcmp (cqr1->irb.ecw, cqr2->irb.ecw, 3) == 0) &&
2397 (cqr1->irb.ecw[27] == cqr2->irb.ecw[27]) &&
2398 (cqr1->irb.ecw[25] == cqr2->irb.ecw[25]))) {
2400 return 0; /* sense doesn't match */
2403 return 1; /* match */
2405 } /* end dasd_3990_erp_error_match */
2408 * DASD_3990_ERP_IN_ERP
2410 * DESCRIPTION
2411 * check if the current error already happened before.
2412 * quick exit if current cqr is not an ERP (cqr->refers=NULL)
2414 * PARAMETER
2415 * cqr failed cqr (either original cqr or already an erp)
2417 * RETURN VALUES
2418 * erp erp-pointer to the already defined error
2419 * recovery procedure OR
2420 * NULL if a 'new' error occurred.
2422 static struct dasd_ccw_req *
2423 dasd_3990_erp_in_erp(struct dasd_ccw_req *cqr)
2426 struct dasd_ccw_req *erp_head = cqr, /* save erp chain head */
2427 *erp_match = NULL; /* save erp chain head */
2428 int match = 0; /* 'boolean' for matching error found */
2430 if (cqr->refers == NULL) { /* return if not in erp */
2431 return NULL;
2434 /* check the erp/cqr chain for current error */
2435 do {
2436 match = dasd_3990_erp_error_match(erp_head, cqr->refers);
2437 erp_match = cqr; /* save possible matching erp */
2438 cqr = cqr->refers; /* check next erp/cqr in queue */
2440 } while ((cqr->refers != NULL) && (!match));
2442 if (!match) {
2443 return NULL; /* no match was found */
2446 return erp_match; /* return address of matching erp */
2448 } /* END dasd_3990_erp_in_erp */
2451 * DASD_3990_ERP_FURTHER_ERP (24 & 32 byte sense)
2453 * DESCRIPTION
2454 * No retry is left for the current ERP. Check what has to be done
2455 * with the ERP.
2456 * - do further defined ERP action or
2457 * - wait for interrupt or
2458 * - exit with permanent error
2460 * PARAMETER
2461 * erp ERP which is in progress with no retry left
2463 * RETURN VALUES
2464 * erp modified/additional ERP
2466 static struct dasd_ccw_req *
2467 dasd_3990_erp_further_erp(struct dasd_ccw_req *erp)
2470 struct dasd_device *device = erp->device;
2471 char *sense = erp->irb.ecw;
2473 /* check for 24 byte sense ERP */
2474 if ((erp->function == dasd_3990_erp_bus_out) ||
2475 (erp->function == dasd_3990_erp_action_1) ||
2476 (erp->function == dasd_3990_erp_action_4)) {
2478 erp = dasd_3990_erp_action_1(erp);
2480 } else if (erp->function == dasd_3990_erp_action_5) {
2482 /* retries have not been successful */
2483 /* prepare erp for retry on different channel path */
2484 erp = dasd_3990_erp_action_1(erp);
2486 if (!(sense[2] & DASD_SENSE_BIT_0)) {
2488 /* issue a Diagnostic Control command with an
2489 * Inhibit Write subcommand */
2491 switch (sense[25]) {
2492 case 0x17:
2493 case 0x57:{ /* controller */
2494 erp = dasd_3990_erp_DCTL(erp, 0x20);
2495 break;
2497 case 0x18:
2498 case 0x58:{ /* channel path */
2499 erp = dasd_3990_erp_DCTL(erp, 0x40);
2500 break;
2502 case 0x19:
2503 case 0x59:{ /* storage director */
2504 erp = dasd_3990_erp_DCTL(erp, 0x80);
2505 break;
2507 default:
2508 DEV_MESSAGE(KERN_DEBUG, device,
2509 "invalid subcommand modifier 0x%x "
2510 "for Diagnostic Control Command",
2511 sense[25]);
2515 /* check for 32 byte sense ERP */
2516 } else if ((erp->function == dasd_3990_erp_compound_retry) ||
2517 (erp->function == dasd_3990_erp_compound_path) ||
2518 (erp->function == dasd_3990_erp_compound_code) ||
2519 (erp->function == dasd_3990_erp_compound_config)) {
2521 erp = dasd_3990_erp_compound(erp, sense);
2523 } else {
2524 /* No retry left and no additional special handling */
2525 /*necessary */
2526 DEV_MESSAGE(KERN_ERR, device,
2527 "no retries left for erp %p - "
2528 "set status to FAILED", erp);
2530 erp->status = DASD_CQR_FAILED;
2533 return erp;
2535 } /* end dasd_3990_erp_further_erp */
2538 * DASD_3990_ERP_HANDLE_MATCH_ERP
2540 * DESCRIPTION
2541 * An error occurred again and an ERP has been detected which is already
2542 * used to handle this error (e.g. retries).
2543 * All prior ERP's are asumed to be successful and therefore removed
2544 * from queue.
2545 * If retry counter of matching erp is already 0, it is checked if further
2546 * action is needed (besides retry) or if the ERP has failed.
2548 * PARAMETER
2549 * erp_head first ERP in ERP-chain
2550 * erp ERP that handles the actual error.
2551 * (matching erp)
2553 * RETURN VALUES
2554 * erp modified/additional ERP
2556 static struct dasd_ccw_req *
2557 dasd_3990_erp_handle_match_erp(struct dasd_ccw_req *erp_head,
2558 struct dasd_ccw_req *erp)
2561 struct dasd_device *device = erp_head->device;
2562 struct dasd_ccw_req *erp_done = erp_head; /* finished req */
2563 struct dasd_ccw_req *erp_free = NULL; /* req to be freed */
2565 /* loop over successful ERPs and remove them from chanq */
2566 while (erp_done != erp) {
2568 if (erp_done == NULL) /* end of chain reached */
2569 panic(PRINTK_HEADER "Programming error in ERP! The "
2570 "original request was lost\n");
2572 /* remove the request from the device queue */
2573 list_del(&erp_done->list);
2575 erp_free = erp_done;
2576 erp_done = erp_done->refers;
2578 /* free the finished erp request */
2579 dasd_free_erp_request(erp_free, erp_free->device);
2581 } /* end while */
2583 if (erp->retries > 0) {
2585 char *sense = erp->refers->irb.ecw;
2587 /* check for special retries */
2588 if (erp->function == dasd_3990_erp_action_4) {
2590 erp = dasd_3990_erp_action_4(erp, sense);
2592 } else if (erp->function == dasd_3990_erp_action_1B_32) {
2594 erp = dasd_3990_update_1B(erp, sense);
2596 } else if (erp->function == dasd_3990_erp_int_req) {
2598 erp = dasd_3990_erp_int_req(erp);
2600 } else {
2601 /* simple retry */
2602 DEV_MESSAGE(KERN_DEBUG, device,
2603 "%i retries left for erp %p",
2604 erp->retries, erp);
2606 /* handle the request again... */
2607 erp->status = DASD_CQR_QUEUED;
2610 } else {
2611 /* no retry left - check for further necessary action */
2612 /* if no further actions, handle rest as permanent error */
2613 erp = dasd_3990_erp_further_erp(erp);
2616 return erp;
2618 } /* end dasd_3990_erp_handle_match_erp */
2621 * DASD_3990_ERP_ACTION
2623 * DESCRIPTION
2624 * controll routine for 3990 erp actions.
2625 * Has to be called with the queue lock (namely the s390_irq_lock) acquired.
2627 * PARAMETER
2628 * cqr failed cqr (either original cqr or already an erp)
2630 * RETURN VALUES
2631 * erp erp-pointer to the head of the ERP action chain.
2632 * This means:
2633 * - either a ptr to an additional ERP cqr or
2634 * - the original given cqr (which's status might
2635 * be modified)
2637 struct dasd_ccw_req *
2638 dasd_3990_erp_action(struct dasd_ccw_req * cqr)
2641 struct dasd_ccw_req *erp = NULL;
2642 struct dasd_device *device = cqr->device;
2643 __u32 cpa = cqr->irb.scsw.cpa;
2645 #ifdef ERP_DEBUG
2646 /* print current erp_chain */
2647 DEV_MESSAGE(KERN_ERR, device, "%s",
2648 "ERP chain at BEGINNING of ERP-ACTION");
2650 struct dasd_ccw_req *temp_erp = NULL;
2652 for (temp_erp = cqr;
2653 temp_erp != NULL; temp_erp = temp_erp->refers) {
2655 DEV_MESSAGE(KERN_ERR, device,
2656 " erp %p (%02x) refers to %p",
2657 temp_erp, temp_erp->status,
2658 temp_erp->refers);
2661 #endif /* ERP_DEBUG */
2663 /* double-check if current erp/cqr was successfull */
2664 if ((cqr->irb.scsw.cstat == 0x00) &&
2665 (cqr->irb.scsw.dstat == (DEV_STAT_CHN_END|DEV_STAT_DEV_END))) {
2667 DEV_MESSAGE(KERN_DEBUG, device,
2668 "ERP called for successful request %p"
2669 " - NO ERP necessary", cqr);
2671 cqr->status = DASD_CQR_DONE;
2673 return cqr;
2675 /* check if sense data are available */
2676 if (!cqr->irb.ecw) {
2677 DEV_MESSAGE(KERN_DEBUG, device,
2678 "ERP called witout sense data avail ..."
2679 "request %p - NO ERP possible", cqr);
2681 cqr->status = DASD_CQR_FAILED;
2683 return cqr;
2687 /* check if error happened before */
2688 erp = dasd_3990_erp_in_erp(cqr);
2690 if (erp == NULL) {
2691 /* no matching erp found - set up erp */
2692 erp = dasd_3990_erp_additional_erp(cqr);
2693 } else {
2694 /* matching erp found - set all leading erp's to DONE */
2695 erp = dasd_3990_erp_handle_match_erp(cqr, erp);
2698 #ifdef ERP_DEBUG
2699 /* print current erp_chain */
2700 DEV_MESSAGE(KERN_ERR, device, "%s", "ERP chain at END of ERP-ACTION");
2702 struct dasd_ccw_req *temp_erp = NULL;
2703 for (temp_erp = erp;
2704 temp_erp != NULL; temp_erp = temp_erp->refers) {
2706 DEV_MESSAGE(KERN_ERR, device,
2707 " erp %p (%02x) refers to %p",
2708 temp_erp, temp_erp->status,
2709 temp_erp->refers);
2712 #endif /* ERP_DEBUG */
2714 if (erp->status == DASD_CQR_FAILED)
2715 dasd_log_ccw(erp, 1, cpa);
2717 /* enqueue added ERP request */
2718 if (erp->status == DASD_CQR_FILLED) {
2719 erp->status = DASD_CQR_QUEUED;
2720 list_add(&erp->list, &device->ccw_queue);
2723 return erp;
2725 } /* end dasd_3990_erp_action */
2728 * Overrides for Emacs so that we follow Linus's tabbing style.
2729 * Emacs will notice this stuff at the end of the file and automatically
2730 * adjust the settings for this buffer only. This must remain at the end
2731 * of the file.
2732 * ---------------------------------------------------------------------------
2733 * Local variables:
2734 * c-indent-level: 4
2735 * c-brace-imaginary-offset: 0
2736 * c-brace-offset: -4
2737 * c-argdecl-indent: 4
2738 * c-label-offset: -4
2739 * c-continued-statement-offset: 4
2740 * c-continued-brace-offset: 0
2741 * indent-tabs-mode: 1
2742 * tab-width: 8
2743 * End: