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
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): "
18 #include "dasd_eckd.h"
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 HANDLING
30 *****************************************************************************
33 *****************************************************************************
34 * 24 and 32 byte sense ERP functions
35 *****************************************************************************
39 * DASD_3990_ERP_CLEANUP
42 * Removes the already build but not necessary ERP request and sets
43 * the status of the original cqr / erp to the given (final) status
46 * erp request to be blocked
47 * final_status either DASD_CQR_DONE or DASD_CQR_FAILED
52 static struct dasd_ccw_req *
53 dasd_3990_erp_cleanup(struct dasd_ccw_req * erp, char final_status)
55 struct dasd_ccw_req *cqr = erp->refers;
57 dasd_free_erp_request(erp, erp->memdev);
58 cqr->status = final_status;
61 } /* end dasd_3990_erp_cleanup */
64 * DASD_3990_ERP_BLOCK_QUEUE
67 * Block the given device request queue to prevent from further
68 * processing until the started timer has expired or an related
69 * interrupt was received.
72 dasd_3990_erp_block_queue(struct dasd_ccw_req * erp, int expires)
75 struct dasd_device *device = erp->startdev;
78 DEV_MESSAGE(KERN_INFO, device,
79 "blocking request queue for %is", expires/HZ);
81 spin_lock_irqsave(get_ccwdev_lock(device->cdev), flags);
82 device->stopped |= DASD_STOPPED_PENDING;
83 spin_unlock_irqrestore(get_ccwdev_lock(device->cdev), flags);
84 erp->status = DASD_CQR_FILLED;
85 dasd_block_set_timer(device->block, expires);
89 * DASD_3990_ERP_INT_REQ
92 * Handles 'Intervention Required' error.
93 * This means either device offline or not installed.
100 static struct dasd_ccw_req *
101 dasd_3990_erp_int_req(struct dasd_ccw_req * erp)
104 struct dasd_device *device = erp->startdev;
106 /* first time set initial retry counter and erp_function */
107 /* and retry once without blocking queue */
108 /* (this enables easier enqueing of the cqr) */
109 if (erp->function != dasd_3990_erp_int_req) {
112 erp->function = dasd_3990_erp_int_req;
116 /* issue a message and wait for 'device ready' interrupt */
117 DEV_MESSAGE(KERN_ERR, device, "%s",
118 "is offline or not installed - "
119 "INTERVENTION REQUIRED!!");
121 dasd_3990_erp_block_queue(erp, 60*HZ);
126 } /* end dasd_3990_erp_int_req */
129 * DASD_3990_ERP_ALTERNATE_PATH
132 * Repeat the operation on a different channel path.
133 * If all alternate paths have been tried, the request is posted with a
137 * erp pointer to the current ERP
140 * erp modified pointer to the ERP
143 dasd_3990_erp_alternate_path(struct dasd_ccw_req * erp)
145 struct dasd_device *device = erp->startdev;
149 /* try alternate valid path */
150 spin_lock_irqsave(get_ccwdev_lock(device->cdev), flags);
151 opm = ccw_device_get_path_mask(device->cdev);
152 spin_unlock_irqrestore(get_ccwdev_lock(device->cdev), flags);
153 //FIXME: start with get_opm ?
155 erp->lpm = LPM_ANYPATH & ~(erp->irb.esw.esw0.sublog.lpum);
157 erp->lpm &= ~(erp->irb.esw.esw0.sublog.lpum);
159 if ((erp->lpm & opm) != 0x00) {
161 DEV_MESSAGE(KERN_DEBUG, device,
162 "try alternate lpm=%x (lpum=%x / opm=%x)",
163 erp->lpm, erp->irb.esw.esw0.sublog.lpum, opm);
165 /* reset status to submit the request again... */
166 erp->status = DASD_CQR_FILLED;
169 DEV_MESSAGE(KERN_ERR, device,
170 "No alternate channel path left (lpum=%x / "
171 "opm=%x) -> permanent error",
172 erp->irb.esw.esw0.sublog.lpum, opm);
174 /* post request with permanent error */
175 erp->status = DASD_CQR_FAILED;
177 } /* end dasd_3990_erp_alternate_path */
183 * Setup cqr to do the Diagnostic Control (DCTL) command with an
184 * Inhibit Write subcommand (0x20) and the given modifier.
187 * erp pointer to the current (failed) ERP
188 * modifier subcommand modifier
191 * dctl_cqr pointer to NEW dctl_cqr
194 static struct dasd_ccw_req *
195 dasd_3990_erp_DCTL(struct dasd_ccw_req * erp, char modifier)
198 struct dasd_device *device = erp->startdev;
199 struct DCTL_data *DCTL_data;
201 struct dasd_ccw_req *dctl_cqr;
203 dctl_cqr = dasd_alloc_erp_request((char *) &erp->magic, 1,
204 sizeof(struct DCTL_data),
206 if (IS_ERR(dctl_cqr)) {
207 DEV_MESSAGE(KERN_ERR, device, "%s",
208 "Unable to allocate DCTL-CQR");
209 erp->status = DASD_CQR_FAILED;
213 DCTL_data = dctl_cqr->data;
215 DCTL_data->subcommand = 0x02; /* Inhibit Write */
216 DCTL_data->modifier = modifier;
218 ccw = dctl_cqr->cpaddr;
219 memset(ccw, 0, sizeof(struct ccw1));
220 ccw->cmd_code = CCW_CMD_DCTL;
222 ccw->cda = (__u32)(addr_t) DCTL_data;
223 dctl_cqr->function = dasd_3990_erp_DCTL;
224 dctl_cqr->refers = erp;
225 dctl_cqr->startdev = device;
226 dctl_cqr->memdev = device;
227 dctl_cqr->magic = erp->magic;
228 dctl_cqr->expires = 5 * 60 * HZ;
229 dctl_cqr->retries = 2;
231 dctl_cqr->buildclk = get_clock();
233 dctl_cqr->status = DASD_CQR_FILLED;
237 } /* end dasd_3990_erp_DCTL */
240 * DASD_3990_ERP_ACTION_1
243 * Setup ERP to do the ERP action 1 (see Reference manual).
244 * Repeat the operation on a different channel path.
245 * If all alternate paths have been tried, the request is posted with a
247 * Note: duplex handling is not implemented (yet).
250 * erp pointer to the current ERP
253 * erp pointer to the ERP
256 static struct dasd_ccw_req *
257 dasd_3990_erp_action_1(struct dasd_ccw_req * erp)
260 erp->function = dasd_3990_erp_action_1;
262 dasd_3990_erp_alternate_path(erp);
266 } /* end dasd_3990_erp_action_1 */
269 * DASD_3990_ERP_ACTION_4
272 * Setup ERP to do the ERP action 4 (see Reference manual).
273 * Set the current request to PENDING to block the CQR queue for that device
274 * until the state change interrupt appears.
275 * Use a timer (20 seconds) to retry the cqr if the interrupt is still
279 * sense sense data of the actual error
280 * erp pointer to the current ERP
283 * erp pointer to the ERP
286 static struct dasd_ccw_req *
287 dasd_3990_erp_action_4(struct dasd_ccw_req * erp, char *sense)
290 struct dasd_device *device = erp->startdev;
292 /* first time set initial retry counter and erp_function */
293 /* and retry once without waiting for state change pending */
294 /* interrupt (this enables easier enqueing of the cqr) */
295 if (erp->function != dasd_3990_erp_action_4) {
297 DEV_MESSAGE(KERN_INFO, device, "%s",
298 "dasd_3990_erp_action_4: first time retry");
301 erp->function = dasd_3990_erp_action_4;
304 if (sense && (sense[25] == 0x1D)) { /* state change pending */
306 DEV_MESSAGE(KERN_INFO, device,
307 "waiting for state change pending "
308 "interrupt, %d retries left",
311 dasd_3990_erp_block_queue(erp, 30*HZ);
313 } else if (sense && (sense[25] == 0x1E)) { /* busy */
314 DEV_MESSAGE(KERN_INFO, device,
315 "busy - redriving request later, "
318 dasd_3990_erp_block_queue(erp, HZ);
321 /* no state change pending - retry */
322 DEV_MESSAGE (KERN_INFO, device,
323 "redriving request immediately, "
326 erp->status = DASD_CQR_FILLED;
332 } /* end dasd_3990_erp_action_4 */
335 *****************************************************************************
336 * 24 byte sense ERP functions (only)
337 *****************************************************************************
341 * DASD_3990_ERP_ACTION_5
344 * Setup ERP to do the ERP action 5 (see Reference manual).
345 * NOTE: Further handling is done in xxx_further_erp after the retries.
348 * erp pointer to the current ERP
351 * erp pointer to the ERP
354 static struct dasd_ccw_req *
355 dasd_3990_erp_action_5(struct dasd_ccw_req * erp)
358 /* first of all retry */
360 erp->function = dasd_3990_erp_action_5;
364 } /* end dasd_3990_erp_action_5 */
367 * DASD_3990_HANDLE_ENV_DATA
370 * Handles 24 byte 'Environmental data present'.
371 * Does a analysis of the sense data (message Format)
372 * and prints the error messages.
375 * sense current sense data
381 dasd_3990_handle_env_data(struct dasd_ccw_req * erp, char *sense)
384 struct dasd_device *device = erp->startdev;
385 char msg_format = (sense[7] & 0xF0);
386 char msg_no = (sense[7] & 0x0F);
388 switch (msg_format) {
389 case 0x00: /* Format 0 - Program or System Checks */
391 if (sense[1] & 0x10) { /* check message to operator bit */
394 case 0x00: /* No Message */
397 DEV_MESSAGE(KERN_WARNING, device, "%s",
398 "FORMAT 0 - Invalid Command");
401 DEV_MESSAGE(KERN_WARNING, device, "%s",
402 "FORMAT 0 - Invalid Command "
406 DEV_MESSAGE(KERN_WARNING, device, "%s",
407 "FORMAT 0 - CCW Count less than "
411 DEV_MESSAGE(KERN_WARNING, device, "%s",
412 "FORMAT 0 - Invalid Parameter");
415 DEV_MESSAGE(KERN_WARNING, device, "%s",
416 "FORMAT 0 - Diagnostic of Sepecial"
417 " Command Violates File Mask");
420 DEV_MESSAGE(KERN_WARNING, device, "%s",
421 "FORMAT 0 - Channel Returned with "
422 "Incorrect retry CCW");
425 DEV_MESSAGE(KERN_WARNING, device, "%s",
426 "FORMAT 0 - Reset Notification");
429 DEV_MESSAGE(KERN_WARNING, device, "%s",
430 "FORMAT 0 - Storage Path Restart");
433 DEV_MESSAGE(KERN_WARNING, device,
434 "FORMAT 0 - Channel requested "
435 "... %02x", sense[8]);
438 DEV_MESSAGE(KERN_WARNING, device, "%s",
439 "FORMAT 0 - Invalid Defective/"
440 "Alternate Track Pointer");
443 DEV_MESSAGE(KERN_WARNING, device, "%s",
444 "FORMAT 0 - DPS Installation "
448 DEV_MESSAGE(KERN_WARNING, device, "%s",
449 "FORMAT 0 - Command Invalid on "
450 "Secondary Address");
453 DEV_MESSAGE(KERN_WARNING, device,
454 "FORMAT 0 - Status Not As "
455 "Required: reason %02x", sense[8]);
458 DEV_MESSAGE(KERN_WARNING, device, "%s",
459 "FORMAT 0 - Reseved");
463 case 0x00: /* No Message */
466 DEV_MESSAGE(KERN_WARNING, device, "%s",
467 "FORMAT 0 - Device Error Source");
470 DEV_MESSAGE(KERN_WARNING, device, "%s",
471 "FORMAT 0 - Reserved");
474 DEV_MESSAGE(KERN_WARNING, device,
475 "FORMAT 0 - Device Fenced - "
476 "device = %02x", sense[4]);
479 DEV_MESSAGE(KERN_WARNING, device, "%s",
480 "FORMAT 0 - Data Pinned for "
484 DEV_MESSAGE(KERN_WARNING, device, "%s",
485 "FORMAT 0 - Reserved");
490 case 0x10: /* Format 1 - Device Equipment Checks */
492 case 0x00: /* No Message */
495 DEV_MESSAGE(KERN_WARNING, device, "%s",
496 "FORMAT 1 - Device Status 1 not as "
500 DEV_MESSAGE(KERN_WARNING, device, "%s",
501 "FORMAT 1 - Index missing");
504 DEV_MESSAGE(KERN_WARNING, device, "%s",
505 "FORMAT 1 - Interruption cannot be reset");
508 DEV_MESSAGE(KERN_WARNING, device, "%s",
509 "FORMAT 1 - Device did not respond to "
513 DEV_MESSAGE(KERN_WARNING, device, "%s",
514 "FORMAT 1 - Device check-2 error or Set "
515 "Sector is not complete");
518 DEV_MESSAGE(KERN_WARNING, device, "%s",
519 "FORMAT 1 - Head address does not "
523 DEV_MESSAGE(KERN_WARNING, device, "%s",
524 "FORMAT 1 - Device status 1 not valid");
527 DEV_MESSAGE(KERN_WARNING, device, "%s",
528 "FORMAT 1 - Device not ready");
531 DEV_MESSAGE(KERN_WARNING, device, "%s",
532 "FORMAT 1 - Track physical address did "
536 DEV_MESSAGE(KERN_WARNING, device, "%s",
537 "FORMAT 1 - Missing device address bit");
540 DEV_MESSAGE(KERN_WARNING, device, "%s",
541 "FORMAT 1 - Drive motor switch is off");
544 DEV_MESSAGE(KERN_WARNING, device, "%s",
545 "FORMAT 1 - Seek incomplete");
548 DEV_MESSAGE(KERN_WARNING, device, "%s",
549 "FORMAT 1 - Cylinder address did not "
553 DEV_MESSAGE(KERN_WARNING, device, "%s",
554 "FORMAT 1 - Offset active cannot be "
558 DEV_MESSAGE(KERN_WARNING, device, "%s",
559 "FORMAT 1 - Reserved");
563 case 0x20: /* Format 2 - 3990 Equipment Checks */
566 DEV_MESSAGE(KERN_WARNING, device, "%s",
567 "FORMAT 2 - 3990 check-2 error");
570 DEV_MESSAGE(KERN_WARNING, device, "%s",
571 "FORMAT 2 - Support facility errors");
574 DEV_MESSAGE(KERN_WARNING, device,
575 "FORMAT 2 - Microcode detected error %02x",
579 DEV_MESSAGE(KERN_WARNING, device, "%s",
580 "FORMAT 2 - Reserved");
584 case 0x30: /* Format 3 - 3990 Control Checks */
587 DEV_MESSAGE(KERN_WARNING, device, "%s",
588 "FORMAT 3 - Allegiance terminated");
591 DEV_MESSAGE(KERN_WARNING, device, "%s",
592 "FORMAT 3 - Reserved");
596 case 0x40: /* Format 4 - Data Checks */
599 DEV_MESSAGE(KERN_WARNING, device, "%s",
600 "FORMAT 4 - Home address area error");
603 DEV_MESSAGE(KERN_WARNING, device, "%s",
604 "FORMAT 4 - Count area error");
607 DEV_MESSAGE(KERN_WARNING, device, "%s",
608 "FORMAT 4 - Key area error");
611 DEV_MESSAGE(KERN_WARNING, device, "%s",
612 "FORMAT 4 - Data area error");
615 DEV_MESSAGE(KERN_WARNING, device, "%s",
616 "FORMAT 4 - No sync byte in home address "
620 DEV_MESSAGE(KERN_WARNING, device, "%s",
621 "FORMAT 4 - No sync byte in count address "
625 DEV_MESSAGE(KERN_WARNING, device, "%s",
626 "FORMAT 4 - No sync byte in key area");
629 DEV_MESSAGE(KERN_WARNING, device, "%s",
630 "FORMAT 4 - No sync byte in data area");
633 DEV_MESSAGE(KERN_WARNING, device, "%s",
634 "FORMAT 4 - Home address area error; "
638 DEV_MESSAGE(KERN_WARNING, device, "%s",
639 "FORMAT 4 - Count area error; offset "
643 DEV_MESSAGE(KERN_WARNING, device, "%s",
644 "FORMAT 4 - Key area error; offset "
648 DEV_MESSAGE(KERN_WARNING, device, "%s",
649 "FORMAT 4 - Data area error; "
653 DEV_MESSAGE(KERN_WARNING, device, "%s",
654 "FORMAT 4 - No sync byte in home "
655 "address area; offset active");
658 DEV_MESSAGE(KERN_WARNING, device, "%s",
659 "FORMAT 4 - No syn byte in count "
660 "address area; offset active");
663 DEV_MESSAGE(KERN_WARNING, device, "%s",
664 "FORMAT 4 - No sync byte in key area; "
668 DEV_MESSAGE(KERN_WARNING, device, "%s",
669 "FORMAT 4 - No syn byte in data area; "
673 DEV_MESSAGE(KERN_WARNING, device, "%s",
674 "FORMAT 4 - Reserved");
678 case 0x50: /* Format 5 - Data Check with displacement information */
681 DEV_MESSAGE(KERN_WARNING, device, "%s",
682 "FORMAT 5 - Data Check in the "
683 "home address area");
686 DEV_MESSAGE(KERN_WARNING, device, "%s",
687 "FORMAT 5 - Data Check in the count area");
690 DEV_MESSAGE(KERN_WARNING, device, "%s",
691 "FORMAT 5 - Data Check in the key area");
694 DEV_MESSAGE(KERN_WARNING, device, "%s",
695 "FORMAT 5 - Data Check in the data area");
698 DEV_MESSAGE(KERN_WARNING, device, "%s",
699 "FORMAT 5 - Data Check in the "
700 "home address area; offset active");
703 DEV_MESSAGE(KERN_WARNING, device, "%s",
704 "FORMAT 5 - Data Check in the count area; "
708 DEV_MESSAGE(KERN_WARNING, device, "%s",
709 "FORMAT 5 - Data Check in the key area; "
713 DEV_MESSAGE(KERN_WARNING, device, "%s",
714 "FORMAT 5 - Data Check in the data area; "
718 DEV_MESSAGE(KERN_WARNING, device, "%s",
719 "FORMAT 5 - Reserved");
723 case 0x60: /* Format 6 - Usage Statistics/Overrun Errors */
726 DEV_MESSAGE(KERN_WARNING, device, "%s",
727 "FORMAT 6 - Overrun on channel A");
730 DEV_MESSAGE(KERN_WARNING, device, "%s",
731 "FORMAT 6 - Overrun on channel B");
734 DEV_MESSAGE(KERN_WARNING, device, "%s",
735 "FORMAT 6 - Overrun on channel C");
738 DEV_MESSAGE(KERN_WARNING, device, "%s",
739 "FORMAT 6 - Overrun on channel D");
742 DEV_MESSAGE(KERN_WARNING, device, "%s",
743 "FORMAT 6 - Overrun on channel E");
746 DEV_MESSAGE(KERN_WARNING, device, "%s",
747 "FORMAT 6 - Overrun on channel F");
750 DEV_MESSAGE(KERN_WARNING, device, "%s",
751 "FORMAT 6 - Overrun on channel G");
754 DEV_MESSAGE(KERN_WARNING, device, "%s",
755 "FORMAT 6 - Overrun on channel H");
758 DEV_MESSAGE(KERN_WARNING, device, "%s",
759 "FORMAT 6 - Reserved");
763 case 0x70: /* Format 7 - Device Connection Control Checks */
766 DEV_MESSAGE(KERN_WARNING, device, "%s",
767 "FORMAT 7 - RCC initiated by a connection "
771 DEV_MESSAGE(KERN_WARNING, device, "%s",
772 "FORMAT 7 - RCC 1 sequence not "
776 DEV_MESSAGE(KERN_WARNING, device, "%s",
777 "FORMAT 7 - RCC 1 and RCC 2 sequences not "
781 DEV_MESSAGE(KERN_WARNING, device, "%s",
782 "FORMAT 7 - Invalid tag-in during "
783 "selection sequence");
786 DEV_MESSAGE(KERN_WARNING, device, "%s",
787 "FORMAT 7 - extra RCC required");
790 DEV_MESSAGE(KERN_WARNING, device, "%s",
791 "FORMAT 7 - Invalid DCC selection "
792 "response or timeout");
795 DEV_MESSAGE(KERN_WARNING, device, "%s",
796 "FORMAT 7 - Missing end operation; device "
797 "transfer complete");
800 DEV_MESSAGE(KERN_WARNING, device, "%s",
801 "FORMAT 7 - Missing end operation; device "
802 "transfer incomplete");
805 DEV_MESSAGE(KERN_WARNING, device, "%s",
806 "FORMAT 7 - Invalid tag-in for an "
807 "immediate command sequence");
810 DEV_MESSAGE(KERN_WARNING, device, "%s",
811 "FORMAT 7 - Invalid tag-in for an "
812 "extended command sequence");
815 DEV_MESSAGE(KERN_WARNING, device, "%s",
816 "FORMAT 7 - 3990 microcode time out when "
817 "stopping selection");
820 DEV_MESSAGE(KERN_WARNING, device, "%s",
821 "FORMAT 7 - No response to selection "
822 "after a poll interruption");
825 DEV_MESSAGE(KERN_WARNING, device, "%s",
826 "FORMAT 7 - Permanent path error (DASD "
827 "controller not available)");
830 DEV_MESSAGE(KERN_WARNING, device, "%s",
831 "FORMAT 7 - DASD controller not available"
832 " on disconnected command chain");
835 DEV_MESSAGE(KERN_WARNING, device, "%s",
836 "FORMAT 7 - Reserved");
840 case 0x80: /* Format 8 - Additional Device Equipment Checks */
842 case 0x00: /* No Message */
844 DEV_MESSAGE(KERN_WARNING, device, "%s",
845 "FORMAT 8 - Error correction code "
849 DEV_MESSAGE(KERN_WARNING, device, "%s",
850 "FORMAT 8 - Unexpected end operation "
854 DEV_MESSAGE(KERN_WARNING, device, "%s",
855 "FORMAT 8 - End operation with transfer "
859 DEV_MESSAGE(KERN_WARNING, device, "%s",
860 "FORMAT 8 - End operation with transfer "
864 DEV_MESSAGE(KERN_WARNING, device, "%s",
865 "FORMAT 8 - DPS checks after a system "
866 "reset or selective reset");
869 DEV_MESSAGE(KERN_WARNING, device, "%s",
870 "FORMAT 8 - DPS cannot be filled");
873 DEV_MESSAGE(KERN_WARNING, device, "%s",
874 "FORMAT 8 - Short busy time-out during "
878 DEV_MESSAGE(KERN_WARNING, device, "%s",
879 "FORMAT 8 - DASD controller failed to "
880 "set or reset the long busy latch");
883 DEV_MESSAGE(KERN_WARNING, device, "%s",
884 "FORMAT 8 - No interruption from device "
885 "during a command chain");
888 DEV_MESSAGE(KERN_WARNING, device, "%s",
889 "FORMAT 8 - Reserved");
893 case 0x90: /* Format 9 - Device Read, Write, and Seek Checks */
896 break; /* No Message */
898 DEV_MESSAGE(KERN_WARNING, device, "%s",
899 "FORMAT 9 - Device check-2 error");
902 DEV_MESSAGE(KERN_WARNING, device, "%s",
903 "FORMAT 9 - Head address did not compare");
906 DEV_MESSAGE(KERN_WARNING, device, "%s",
907 "FORMAT 9 - Track physical address did "
908 "not compare while oriented");
911 DEV_MESSAGE(KERN_WARNING, device, "%s",
912 "FORMAT 9 - Cylinder address did not "
916 DEV_MESSAGE(KERN_WARNING, device, "%s",
917 "FORMAT 9 - Reserved");
921 case 0xF0: /* Format F - Cache Storage Checks */
924 DEV_MESSAGE(KERN_WARNING, device, "%s",
925 "FORMAT F - Operation Terminated");
928 DEV_MESSAGE(KERN_WARNING, device, "%s",
929 "FORMAT F - Subsystem Processing Error");
932 DEV_MESSAGE(KERN_WARNING, device, "%s",
933 "FORMAT F - Cache or nonvolatile storage "
934 "equipment failure");
937 DEV_MESSAGE(KERN_WARNING, device, "%s",
938 "FORMAT F - Caching terminated");
941 DEV_MESSAGE(KERN_WARNING, device, "%s",
942 "FORMAT F - Cache fast write access not "
946 DEV_MESSAGE(KERN_WARNING, device, "%s",
947 "FORMAT F - Track format incorrect");
950 DEV_MESSAGE(KERN_WARNING, device, "%s",
951 "FORMAT F - Caching reinitiated");
954 DEV_MESSAGE(KERN_WARNING, device, "%s",
955 "FORMAT F - Nonvolatile storage "
959 DEV_MESSAGE(KERN_WARNING, device, "%s",
960 "FORMAT F - Volume is suspended duplex");
961 /* call extended error reporting (EER) */
962 dasd_eer_write(device, erp->refers,
963 DASD_EER_PPRCSUSPEND);
966 DEV_MESSAGE(KERN_WARNING, device, "%s",
967 "FORMAT F - Subsystem status connot be "
971 DEV_MESSAGE(KERN_WARNING, device, "%s",
972 "FORMAT F - Caching status reset to "
976 DEV_MESSAGE(KERN_WARNING, device, "%s",
977 "FORMAT F - DASD Fast Write inhibited");
980 DEV_MESSAGE(KERN_WARNING, device, "%s",
981 "FORMAT D - Reserved");
985 default: /* unknown message format - should not happen */
986 DEV_MESSAGE (KERN_WARNING, device,
987 "unknown message format %02x",
990 } /* end switch message format */
992 } /* end dasd_3990_handle_env_data */
995 * DASD_3990_ERP_COM_REJ
998 * Handles 24 byte 'Command Reject' error.
1001 * erp current erp_head
1002 * sense current sense data
1005 * erp 'new' erp_head - pointer to new ERP
1007 static struct dasd_ccw_req *
1008 dasd_3990_erp_com_rej(struct dasd_ccw_req * erp, char *sense)
1011 struct dasd_device *device = erp->startdev;
1013 erp->function = dasd_3990_erp_com_rej;
1015 /* env data present (ACTION 10 - retry should work) */
1016 if (sense[2] & SNS2_ENV_DATA_PRESENT) {
1018 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1019 "Command Reject - environmental data present");
1021 dasd_3990_handle_env_data(erp, sense);
1026 /* fatal error - set status to FAILED */
1027 DEV_MESSAGE(KERN_ERR, device, "%s",
1028 "Command Reject - Fatal error");
1030 erp = dasd_3990_erp_cleanup(erp, DASD_CQR_FAILED);
1035 } /* end dasd_3990_erp_com_rej */
1038 * DASD_3990_ERP_BUS_OUT
1041 * Handles 24 byte 'Bus Out Parity Check' error.
1044 * erp current erp_head
1046 * erp new erp_head - pointer to new ERP
1048 static struct dasd_ccw_req *
1049 dasd_3990_erp_bus_out(struct dasd_ccw_req * erp)
1052 struct dasd_device *device = erp->startdev;
1054 /* first time set initial retry counter and erp_function */
1055 /* and retry once without blocking queue */
1056 /* (this enables easier enqueing of the cqr) */
1057 if (erp->function != dasd_3990_erp_bus_out) {
1059 erp->function = dasd_3990_erp_bus_out;
1063 /* issue a message and wait for 'device ready' interrupt */
1064 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1065 "bus out parity error or BOPC requested by "
1068 dasd_3990_erp_block_queue(erp, 60*HZ);
1074 } /* end dasd_3990_erp_bus_out */
1077 * DASD_3990_ERP_EQUIP_CHECK
1080 * Handles 24 byte 'Equipment Check' error.
1083 * erp current erp_head
1085 * erp new erp_head - pointer to new ERP
1087 static struct dasd_ccw_req *
1088 dasd_3990_erp_equip_check(struct dasd_ccw_req * erp, char *sense)
1091 struct dasd_device *device = erp->startdev;
1093 erp->function = dasd_3990_erp_equip_check;
1095 if (sense[1] & SNS1_WRITE_INHIBITED) {
1097 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1098 "Write inhibited path encountered");
1100 /* vary path offline */
1101 DEV_MESSAGE(KERN_ERR, device, "%s",
1102 "Path should be varied off-line. "
1103 "This is not implemented yet \n - please report "
1104 "to linux390@de.ibm.com");
1106 erp = dasd_3990_erp_action_1(erp);
1108 } else if (sense[2] & SNS2_ENV_DATA_PRESENT) {
1110 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1111 "Equipment Check - " "environmental data present");
1113 dasd_3990_handle_env_data(erp, sense);
1115 erp = dasd_3990_erp_action_4(erp, sense);
1117 } else if (sense[1] & SNS1_PERM_ERR) {
1119 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1120 "Equipment Check - retry exhausted or "
1123 erp = dasd_3990_erp_action_1(erp);
1126 /* all other equipment checks - Action 5 */
1127 /* rest is done when retries == 0 */
1128 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1129 "Equipment check or processing error");
1131 erp = dasd_3990_erp_action_5(erp);
1135 } /* end dasd_3990_erp_equip_check */
1138 * DASD_3990_ERP_DATA_CHECK
1141 * Handles 24 byte 'Data Check' error.
1144 * erp current erp_head
1146 * erp new erp_head - pointer to new ERP
1148 static struct dasd_ccw_req *
1149 dasd_3990_erp_data_check(struct dasd_ccw_req * erp, char *sense)
1152 struct dasd_device *device = erp->startdev;
1154 erp->function = dasd_3990_erp_data_check;
1156 if (sense[2] & SNS2_CORRECTABLE) { /* correctable data check */
1158 /* issue message that the data has been corrected */
1159 DEV_MESSAGE(KERN_EMERG, device, "%s",
1160 "Data recovered during retry with PCI "
1161 "fetch mode active");
1163 /* not possible to handle this situation in Linux */
1164 panic("No way to inform application about the possibly "
1167 } else if (sense[2] & SNS2_ENV_DATA_PRESENT) {
1169 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1170 "Uncorrectable data check recovered secondary "
1171 "addr of duplex pair");
1173 erp = dasd_3990_erp_action_4(erp, sense);
1175 } else if (sense[1] & SNS1_PERM_ERR) {
1177 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1178 "Uncorrectable data check with internal "
1181 erp = dasd_3990_erp_action_1(erp);
1184 /* all other data checks */
1185 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1186 "Uncorrectable data check with retry count "
1189 erp = dasd_3990_erp_action_5(erp);
1194 } /* end dasd_3990_erp_data_check */
1197 * DASD_3990_ERP_OVERRUN
1200 * Handles 24 byte 'Overrun' error.
1203 * erp current erp_head
1205 * erp new erp_head - pointer to new ERP
1207 static struct dasd_ccw_req *
1208 dasd_3990_erp_overrun(struct dasd_ccw_req * erp, char *sense)
1211 struct dasd_device *device = erp->startdev;
1213 erp->function = dasd_3990_erp_overrun;
1215 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1216 "Overrun - service overrun or overrun"
1217 " error requested by channel");
1219 erp = dasd_3990_erp_action_5(erp);
1223 } /* end dasd_3990_erp_overrun */
1226 * DASD_3990_ERP_INV_FORMAT
1229 * Handles 24 byte 'Invalid Track Format' error.
1232 * erp current erp_head
1234 * erp new erp_head - pointer to new ERP
1236 static struct dasd_ccw_req *
1237 dasd_3990_erp_inv_format(struct dasd_ccw_req * erp, char *sense)
1240 struct dasd_device *device = erp->startdev;
1242 erp->function = dasd_3990_erp_inv_format;
1244 if (sense[2] & SNS2_ENV_DATA_PRESENT) {
1246 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1247 "Track format error when destaging or "
1250 dasd_3990_handle_env_data(erp, sense);
1252 erp = dasd_3990_erp_action_4(erp, sense);
1255 DEV_MESSAGE(KERN_ERR, device, "%s",
1256 "Invalid Track Format - Fatal error");
1258 erp = dasd_3990_erp_cleanup(erp, DASD_CQR_FAILED);
1263 } /* end dasd_3990_erp_inv_format */
1269 * Handles 24 byte 'End-of-Cylinder' error.
1272 * erp already added default erp
1274 * erp pointer to original (failed) cqr.
1276 static struct dasd_ccw_req *
1277 dasd_3990_erp_EOC(struct dasd_ccw_req * default_erp, char *sense)
1280 struct dasd_device *device = default_erp->startdev;
1282 DEV_MESSAGE(KERN_ERR, device, "%s",
1283 "End-of-Cylinder - must never happen");
1285 /* implement action 7 - BUG */
1286 return dasd_3990_erp_cleanup(default_erp, DASD_CQR_FAILED);
1288 } /* end dasd_3990_erp_EOC */
1291 * DASD_3990_ERP_ENV_DATA
1294 * Handles 24 byte 'Environmental-Data Present' error.
1297 * erp current erp_head
1299 * erp new erp_head - pointer to new ERP
1301 static struct dasd_ccw_req *
1302 dasd_3990_erp_env_data(struct dasd_ccw_req * erp, char *sense)
1305 struct dasd_device *device = erp->startdev;
1307 erp->function = dasd_3990_erp_env_data;
1309 DEV_MESSAGE(KERN_DEBUG, device, "%s", "Environmental data present");
1311 dasd_3990_handle_env_data(erp, sense);
1313 /* don't retry on disabled interface */
1314 if (sense[7] != 0x0F) {
1315 erp = dasd_3990_erp_action_4(erp, sense);
1317 erp->status = DASD_CQR_FILLED;
1322 } /* end dasd_3990_erp_env_data */
1325 * DASD_3990_ERP_NO_REC
1328 * Handles 24 byte 'No Record Found' error.
1331 * erp already added default ERP
1334 * erp new erp_head - pointer to new ERP
1336 static struct dasd_ccw_req *
1337 dasd_3990_erp_no_rec(struct dasd_ccw_req * default_erp, char *sense)
1340 struct dasd_device *device = default_erp->startdev;
1342 DEV_MESSAGE(KERN_ERR, device, "%s",
1343 "No Record Found - Fatal error ");
1345 return dasd_3990_erp_cleanup(default_erp, DASD_CQR_FAILED);
1347 } /* end dasd_3990_erp_no_rec */
1350 * DASD_3990_ERP_FILE_PROT
1353 * Handles 24 byte 'File Protected' error.
1354 * Note: Seek related recovery is not implemented because
1355 * wee don't use the seek command yet.
1358 * erp current erp_head
1360 * erp new erp_head - pointer to new ERP
1362 static struct dasd_ccw_req *
1363 dasd_3990_erp_file_prot(struct dasd_ccw_req * erp)
1366 struct dasd_device *device = erp->startdev;
1368 DEV_MESSAGE(KERN_ERR, device, "%s", "File Protected");
1370 return dasd_3990_erp_cleanup(erp, DASD_CQR_FAILED);
1372 } /* end dasd_3990_erp_file_prot */
1375 * DASD_3990_ERP_INSPECT_ALIAS
1378 * Checks if the original request was started on an alias device.
1379 * If yes, it modifies the original and the erp request so that
1380 * the erp request can be started on a base device.
1383 * erp pointer to the currently created default ERP
1386 * erp pointer to the modified ERP, or NULL
1389 static struct dasd_ccw_req *dasd_3990_erp_inspect_alias(
1390 struct dasd_ccw_req *erp)
1392 struct dasd_ccw_req *cqr = erp->refers;
1395 (cqr->block->base != cqr->startdev)) {
1396 if (cqr->startdev->features & DASD_FEATURE_ERPLOG) {
1397 DEV_MESSAGE(KERN_ERR, cqr->startdev,
1398 "ERP on alias device for request %p,"
1399 " recover on base device %s", cqr,
1400 cqr->block->base->cdev->dev.bus_id);
1402 dasd_eckd_reset_ccw_to_base_io(cqr);
1403 erp->startdev = cqr->block->base;
1404 erp->function = dasd_3990_erp_inspect_alias;
1412 * DASD_3990_ERP_INSPECT_24
1415 * Does a detailed inspection of the 24 byte sense data
1416 * and sets up a related error recovery action.
1419 * sense sense data of the actual error
1420 * erp pointer to the currently created default ERP
1423 * erp pointer to the (addtitional) ERP
1425 static struct dasd_ccw_req *
1426 dasd_3990_erp_inspect_24(struct dasd_ccw_req * erp, char *sense)
1429 struct dasd_ccw_req *erp_filled = NULL;
1431 /* Check sense for .... */
1432 /* 'Command Reject' */
1433 if ((erp_filled == NULL) && (sense[0] & SNS0_CMD_REJECT)) {
1434 erp_filled = dasd_3990_erp_com_rej(erp, sense);
1436 /* 'Intervention Required' */
1437 if ((erp_filled == NULL) && (sense[0] & SNS0_INTERVENTION_REQ)) {
1438 erp_filled = dasd_3990_erp_int_req(erp);
1440 /* 'Bus Out Parity Check' */
1441 if ((erp_filled == NULL) && (sense[0] & SNS0_BUS_OUT_CHECK)) {
1442 erp_filled = dasd_3990_erp_bus_out(erp);
1444 /* 'Equipment Check' */
1445 if ((erp_filled == NULL) && (sense[0] & SNS0_EQUIPMENT_CHECK)) {
1446 erp_filled = dasd_3990_erp_equip_check(erp, sense);
1449 if ((erp_filled == NULL) && (sense[0] & SNS0_DATA_CHECK)) {
1450 erp_filled = dasd_3990_erp_data_check(erp, sense);
1453 if ((erp_filled == NULL) && (sense[0] & SNS0_OVERRUN)) {
1454 erp_filled = dasd_3990_erp_overrun(erp, sense);
1456 /* 'Invalid Track Format' */
1457 if ((erp_filled == NULL) && (sense[1] & SNS1_INV_TRACK_FORMAT)) {
1458 erp_filled = dasd_3990_erp_inv_format(erp, sense);
1460 /* 'End-of-Cylinder' */
1461 if ((erp_filled == NULL) && (sense[1] & SNS1_EOC)) {
1462 erp_filled = dasd_3990_erp_EOC(erp, sense);
1464 /* 'Environmental Data' */
1465 if ((erp_filled == NULL) && (sense[2] & SNS2_ENV_DATA_PRESENT)) {
1466 erp_filled = dasd_3990_erp_env_data(erp, sense);
1468 /* 'No Record Found' */
1469 if ((erp_filled == NULL) && (sense[1] & SNS1_NO_REC_FOUND)) {
1470 erp_filled = dasd_3990_erp_no_rec(erp, sense);
1472 /* 'File Protected' */
1473 if ((erp_filled == NULL) && (sense[1] & SNS1_FILE_PROTECTED)) {
1474 erp_filled = dasd_3990_erp_file_prot(erp);
1476 /* other (unknown) error - do default ERP */
1477 if (erp_filled == NULL) {
1484 } /* END dasd_3990_erp_inspect_24 */
1487 *****************************************************************************
1488 * 32 byte sense ERP functions (only)
1489 *****************************************************************************
1493 * DASD_3990_ERPACTION_10_32
1496 * Handles 32 byte 'Action 10' of Single Program Action Codes.
1497 * Just retry and if retry doesn't work, return with error.
1500 * erp current erp_head
1501 * sense current sense data
1503 * erp modified erp_head
1505 static struct dasd_ccw_req *
1506 dasd_3990_erp_action_10_32(struct dasd_ccw_req * erp, char *sense)
1509 struct dasd_device *device = erp->startdev;
1512 erp->function = dasd_3990_erp_action_10_32;
1514 DEV_MESSAGE(KERN_DEBUG, device, "%s", "Perform logging requested");
1518 } /* end dasd_3990_erp_action_10_32 */
1521 * DASD_3990_ERP_ACTION_1B_32
1524 * Handles 32 byte 'Action 1B' of Single Program Action Codes.
1525 * A write operation could not be finished because of an unexpected
1527 * The already created 'default erp' is used to get the link to
1528 * the erp chain, but it can not be used for this recovery
1529 * action because it contains no DE/LO data space.
1532 * default_erp already added default erp.
1533 * sense current sense data
1537 * default_erp in case of imprecise ending or error
1539 static struct dasd_ccw_req *
1540 dasd_3990_erp_action_1B_32(struct dasd_ccw_req * default_erp, char *sense)
1543 struct dasd_device *device = default_erp->startdev;
1545 struct dasd_ccw_req *cqr;
1546 struct dasd_ccw_req *erp;
1547 struct DE_eckd_data *DE_data;
1548 struct PFX_eckd_data *PFX_data;
1549 char *LO_data; /* LO_eckd_data_t */
1550 struct ccw1 *ccw, *oldccw;
1552 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1553 "Write not finished because of unexpected condition");
1555 default_erp->function = dasd_3990_erp_action_1B_32;
1557 /* determine the original cqr */
1560 while (cqr->refers != NULL) {
1564 /* for imprecise ending just do default erp */
1565 if (sense[1] & 0x01) {
1567 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1568 "Imprecise ending is set - just retry");
1573 /* determine the address of the CCW to be restarted */
1574 /* Imprecise ending is not set -> addr from IRB-SCSW */
1575 cpa = default_erp->refers->irb.scsw.cpa;
1579 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1580 "Unable to determine address of the CCW "
1583 return dasd_3990_erp_cleanup(default_erp, DASD_CQR_FAILED);
1586 /* Build new ERP request including DE/LO */
1587 erp = dasd_alloc_erp_request((char *) &cqr->magic,
1588 2 + 1,/* DE/LO + TIC */
1589 sizeof(struct DE_eckd_data) +
1590 sizeof(struct LO_eckd_data), device);
1593 DEV_MESSAGE(KERN_ERR, device, "%s", "Unable to allocate ERP");
1594 return dasd_3990_erp_cleanup(default_erp, DASD_CQR_FAILED);
1597 /* use original DE */
1598 DE_data = erp->data;
1599 oldccw = cqr->cpaddr;
1600 if (oldccw->cmd_code == DASD_ECKD_CCW_PFX) {
1601 PFX_data = cqr->data;
1602 memcpy(DE_data, &PFX_data->define_extend,
1603 sizeof(struct DE_eckd_data));
1605 memcpy(DE_data, cqr->data, sizeof(struct DE_eckd_data));
1608 LO_data = erp->data + sizeof(struct DE_eckd_data);
1610 if ((sense[3] == 0x01) && (LO_data[1] & 0x01)) {
1612 DEV_MESSAGE(KERN_ERR, device, "%s",
1613 "BUG - this should not happen");
1615 return dasd_3990_erp_cleanup(default_erp, DASD_CQR_FAILED);
1618 if ((sense[7] & 0x3F) == 0x01) {
1619 /* operation code is WRITE DATA -> data area orientation */
1622 } else if ((sense[7] & 0x3F) == 0x03) {
1623 /* operation code is FORMAT WRITE -> index orientation */
1627 LO_data[0] = sense[7]; /* operation */
1630 LO_data[1] = sense[8]; /* auxiliary */
1631 LO_data[2] = sense[9];
1632 LO_data[3] = sense[3]; /* count */
1633 LO_data[4] = sense[29]; /* seek_addr.cyl */
1634 LO_data[5] = sense[30]; /* seek_addr.cyl 2nd byte */
1635 LO_data[7] = sense[31]; /* seek_addr.head 2nd byte */
1637 memcpy(&(LO_data[8]), &(sense[11]), 8);
1641 memset(ccw, 0, sizeof(struct ccw1));
1642 ccw->cmd_code = DASD_ECKD_CCW_DEFINE_EXTENT;
1643 ccw->flags = CCW_FLAG_CC;
1645 ccw->cda = (__u32)(addr_t) DE_data;
1649 memset(ccw, 0, sizeof(struct ccw1));
1650 ccw->cmd_code = DASD_ECKD_CCW_LOCATE_RECORD;
1651 ccw->flags = CCW_FLAG_CC;
1653 ccw->cda = (__u32)(addr_t) LO_data;
1655 /* TIC to the failed ccw */
1657 ccw->cmd_code = CCW_CMD_TIC;
1660 /* fill erp related fields */
1661 erp->function = dasd_3990_erp_action_1B_32;
1662 erp->refers = default_erp->refers;
1663 erp->startdev = device;
1664 erp->memdev = device;
1665 erp->magic = default_erp->magic;
1668 erp->buildclk = get_clock();
1669 erp->status = DASD_CQR_FILLED;
1671 /* remove the default erp */
1672 dasd_free_erp_request(default_erp, device);
1676 } /* end dasd_3990_erp_action_1B_32 */
1679 * DASD_3990_UPDATE_1B
1682 * Handles the update to the 32 byte 'Action 1B' of Single Program
1683 * Action Codes in case the first action was not successful.
1684 * The already created 'previous_erp' is the currently not successful
1688 * previous_erp already created previous erp.
1689 * sense current sense data
1693 static struct dasd_ccw_req *
1694 dasd_3990_update_1B(struct dasd_ccw_req * previous_erp, char *sense)
1697 struct dasd_device *device = previous_erp->startdev;
1699 struct dasd_ccw_req *cqr;
1700 struct dasd_ccw_req *erp;
1701 char *LO_data; /* struct LO_eckd_data */
1704 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1705 "Write not finished because of unexpected condition"
1708 /* determine the original cqr */
1711 while (cqr->refers != NULL) {
1715 /* for imprecise ending just do default erp */
1716 if (sense[1] & 0x01) {
1718 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1719 "Imprecise ending is set - just retry");
1721 previous_erp->status = DASD_CQR_FILLED;
1723 return previous_erp;
1726 /* determine the address of the CCW to be restarted */
1727 /* Imprecise ending is not set -> addr from IRB-SCSW */
1728 cpa = previous_erp->irb.scsw.cpa;
1732 DEV_MESSAGE(KERN_DEBUG, device, "%s",
1733 "Unable to determine address of the CCW "
1736 previous_erp->status = DASD_CQR_FAILED;
1738 return previous_erp;
1743 /* update the LO with the new returned sense data */
1744 LO_data = erp->data + sizeof(struct DE_eckd_data);
1746 if ((sense[3] == 0x01) && (LO_data[1] & 0x01)) {
1748 DEV_MESSAGE(KERN_ERR, device, "%s",
1749 "BUG - this should not happen");
1751 previous_erp->status = DASD_CQR_FAILED;
1753 return previous_erp;
1756 if ((sense[7] & 0x3F) == 0x01) {
1757 /* operation code is WRITE DATA -> data area orientation */
1760 } else if ((sense[7] & 0x3F) == 0x03) {
1761 /* operation code is FORMAT WRITE -> index orientation */
1765 LO_data[0] = sense[7]; /* operation */
1768 LO_data[1] = sense[8]; /* auxiliary */
1769 LO_data[2] = sense[9];
1770 LO_data[3] = sense[3]; /* count */
1771 LO_data[4] = sense[29]; /* seek_addr.cyl */
1772 LO_data[5] = sense[30]; /* seek_addr.cyl 2nd byte */
1773 LO_data[7] = sense[31]; /* seek_addr.head 2nd byte */
1775 memcpy(&(LO_data[8]), &(sense[11]), 8);
1777 /* TIC to the failed ccw */
1778 ccw = erp->cpaddr; /* addr of DE ccw */
1779 ccw++; /* addr of LE ccw */
1780 ccw++; /* addr of TIC ccw */
1783 erp->status = DASD_CQR_FILLED;
1787 } /* end dasd_3990_update_1B */
1790 * DASD_3990_ERP_COMPOUND_RETRY
1793 * Handles the compound ERP action retry code.
1794 * NOTE: At least one retry is done even if zero is specified
1795 * by the sense data. This makes enqueueing of the request
1799 * sense sense data of the actual error
1800 * erp pointer to the currently created ERP
1803 * erp modified ERP pointer
1807 dasd_3990_erp_compound_retry(struct dasd_ccw_req * erp, char *sense)
1810 switch (sense[25] & 0x03) {
1811 case 0x00: /* no not retry */
1815 case 0x01: /* retry 2 times */
1819 case 0x02: /* retry 10 times */
1823 case 0x03: /* retry 256 times */
1831 erp->function = dasd_3990_erp_compound_retry;
1833 } /* end dasd_3990_erp_compound_retry */
1836 * DASD_3990_ERP_COMPOUND_PATH
1839 * Handles the compound ERP action for retry on alternate
1843 * sense sense data of the actual error
1844 * erp pointer to the currently created ERP
1847 * erp modified ERP pointer
1851 dasd_3990_erp_compound_path(struct dasd_ccw_req * erp, char *sense)
1854 if (sense[25] & DASD_SENSE_BIT_3) {
1855 dasd_3990_erp_alternate_path(erp);
1857 if (erp->status == DASD_CQR_FAILED) {
1858 /* reset the lpm and the status to be able to
1859 * try further actions. */
1862 erp->status = DASD_CQR_NEED_ERP;
1866 erp->function = dasd_3990_erp_compound_path;
1868 } /* end dasd_3990_erp_compound_path */
1871 * DASD_3990_ERP_COMPOUND_CODE
1874 * Handles the compound ERP action for retry code.
1877 * sense sense data of the actual error
1878 * erp pointer to the currently created ERP
1881 * erp NEW ERP pointer
1884 static struct dasd_ccw_req *
1885 dasd_3990_erp_compound_code(struct dasd_ccw_req * erp, char *sense)
1888 if (sense[25] & DASD_SENSE_BIT_2) {
1890 switch (sense[28]) {
1892 /* issue a Diagnostic Control command with an
1893 * Inhibit Write subcommand and controller modifier */
1894 erp = dasd_3990_erp_DCTL(erp, 0x20);
1898 /* wait for 5 seconds and retry again */
1901 dasd_3990_erp_block_queue (erp, 5*HZ);
1905 /* should not happen - continue */
1910 erp->function = dasd_3990_erp_compound_code;
1914 } /* end dasd_3990_erp_compound_code */
1917 * DASD_3990_ERP_COMPOUND_CONFIG
1920 * Handles the compound ERP action for configruation
1922 * Note: duplex handling is not implemented (yet).
1925 * sense sense data of the actual error
1926 * erp pointer to the currently created ERP
1929 * erp modified ERP pointer
1933 dasd_3990_erp_compound_config(struct dasd_ccw_req * erp, char *sense)
1936 if ((sense[25] & DASD_SENSE_BIT_1) && (sense[26] & DASD_SENSE_BIT_2)) {
1938 /* set to suspended duplex state then restart */
1939 struct dasd_device *device = erp->startdev;
1941 DEV_MESSAGE(KERN_ERR, device, "%s",
1942 "Set device to suspended duplex state should be "
1944 "This is not implemented yet (for compound ERP)"
1945 " - please report to linux390@de.ibm.com");
1949 erp->function = dasd_3990_erp_compound_config;
1951 } /* end dasd_3990_erp_compound_config */
1954 * DASD_3990_ERP_COMPOUND
1957 * Does the further compound program action if
1958 * compound retry was not successful.
1961 * sense sense data of the actual error
1962 * erp pointer to the current (failed) ERP
1965 * erp (additional) ERP pointer
1968 static struct dasd_ccw_req *
1969 dasd_3990_erp_compound(struct dasd_ccw_req * erp, char *sense)
1972 if ((erp->function == dasd_3990_erp_compound_retry) &&
1973 (erp->status == DASD_CQR_NEED_ERP)) {
1975 dasd_3990_erp_compound_path(erp, sense);
1978 if ((erp->function == dasd_3990_erp_compound_path) &&
1979 (erp->status == DASD_CQR_NEED_ERP)) {
1981 erp = dasd_3990_erp_compound_code(erp, sense);
1984 if ((erp->function == dasd_3990_erp_compound_code) &&
1985 (erp->status == DASD_CQR_NEED_ERP)) {
1987 dasd_3990_erp_compound_config(erp, sense);
1990 /* if no compound action ERP specified, the request failed */
1991 if (erp->status == DASD_CQR_NEED_ERP)
1992 erp->status = DASD_CQR_FAILED;
1996 } /* end dasd_3990_erp_compound */
1999 * DASD_3990_ERP_INSPECT_32
2002 * Does a detailed inspection of the 32 byte sense data
2003 * and sets up a related error recovery action.
2006 * sense sense data of the actual error
2007 * erp pointer to the currently created default ERP
2010 * erp_filled pointer to the ERP
2013 static struct dasd_ccw_req *
2014 dasd_3990_erp_inspect_32(struct dasd_ccw_req * erp, char *sense)
2017 struct dasd_device *device = erp->startdev;
2019 erp->function = dasd_3990_erp_inspect_32;
2021 if (sense[25] & DASD_SENSE_BIT_0) {
2023 /* compound program action codes (byte25 bit 0 == '1') */
2024 dasd_3990_erp_compound_retry(erp, sense);
2028 /* single program action codes (byte25 bit 0 == '0') */
2029 switch (sense[25]) {
2031 case 0x00: /* success - use default ERP for retries */
2032 DEV_MESSAGE(KERN_DEBUG, device, "%s",
2033 "ERP called for successful request"
2037 case 0x01: /* fatal error */
2038 DEV_MESSAGE(KERN_ERR, device, "%s",
2039 "Retry not recommended - Fatal error");
2041 erp = dasd_3990_erp_cleanup(erp, DASD_CQR_FAILED);
2044 case 0x02: /* intervention required */
2045 case 0x03: /* intervention required during dual copy */
2046 erp = dasd_3990_erp_int_req(erp);
2049 case 0x0F: /* length mismatch during update write command */
2050 DEV_MESSAGE(KERN_ERR, device, "%s",
2051 "update write command error - should not "
2053 "Please send this message together with "
2054 "the above sense data to linux390@de."
2057 erp = dasd_3990_erp_cleanup(erp, DASD_CQR_FAILED);
2060 case 0x10: /* logging required for other channel program */
2061 erp = dasd_3990_erp_action_10_32(erp, sense);
2064 case 0x15: /* next track outside defined extend */
2065 DEV_MESSAGE(KERN_ERR, device, "%s",
2066 "next track outside defined extend - "
2067 "should not happen;\n"
2068 "Please send this message together with "
2069 "the above sense data to linux390@de."
2072 erp = dasd_3990_erp_cleanup(erp, DASD_CQR_FAILED);
2075 case 0x1B: /* unexpected condition during write */
2077 erp = dasd_3990_erp_action_1B_32(erp, sense);
2080 case 0x1C: /* invalid data */
2081 DEV_MESSAGE(KERN_EMERG, device, "%s",
2082 "Data recovered during retry with PCI "
2083 "fetch mode active");
2085 /* not possible to handle this situation in Linux */
2087 ("Invalid data - No way to inform application "
2088 "about the possibly incorrect data");
2091 case 0x1D: /* state-change pending */
2092 DEV_MESSAGE(KERN_DEBUG, device, "%s",
2093 "A State change pending condition exists "
2094 "for the subsystem or device");
2096 erp = dasd_3990_erp_action_4(erp, sense);
2099 case 0x1E: /* busy */
2100 DEV_MESSAGE(KERN_DEBUG, device, "%s",
2101 "Busy condition exists "
2102 "for the subsystem or device");
2103 erp = dasd_3990_erp_action_4(erp, sense);
2106 default: /* all others errors - default erp */
2113 } /* end dasd_3990_erp_inspect_32 */
2116 *****************************************************************************
2117 * main ERP control fuctions (24 and 32 byte sense)
2118 *****************************************************************************
2122 * DASD_3990_ERP_CONTROL_CHECK
2125 * Does a generic inspection if a control check occured and sets up
2126 * the related error recovery procedure
2129 * erp pointer to the currently created default ERP
2132 * erp_filled pointer to the erp
2135 static struct dasd_ccw_req *
2136 dasd_3990_erp_control_check(struct dasd_ccw_req *erp)
2138 struct dasd_device *device = erp->startdev;
2140 if (erp->refers->irb.scsw.cstat & (SCHN_STAT_INTF_CTRL_CHK
2141 | SCHN_STAT_CHN_CTRL_CHK)) {
2142 DEV_MESSAGE(KERN_DEBUG, device, "%s",
2143 "channel or interface control check");
2144 erp = dasd_3990_erp_action_4(erp, NULL);
2150 * DASD_3990_ERP_INSPECT
2153 * Does a detailed inspection for sense data by calling either
2154 * the 24-byte or the 32-byte inspection routine.
2157 * erp pointer to the currently created default ERP
2159 * erp_new contens was possibly modified
2161 static struct dasd_ccw_req *
2162 dasd_3990_erp_inspect(struct dasd_ccw_req * erp)
2165 struct dasd_ccw_req *erp_new = NULL;
2166 /* sense data are located in the refers record of the */
2167 /* already set up new ERP ! */
2168 char *sense = erp->refers->irb.ecw;
2170 /* if this problem occured on an alias retry on base */
2171 erp_new = dasd_3990_erp_inspect_alias(erp);
2175 /* check if no concurrent sens is available */
2176 if (!erp->refers->irb.esw.esw0.erw.cons)
2177 erp_new = dasd_3990_erp_control_check(erp);
2178 /* distinguish between 24 and 32 byte sense data */
2179 else if (sense[27] & DASD_SENSE_BIT_0) {
2181 /* inspect the 24 byte sense data */
2182 erp_new = dasd_3990_erp_inspect_24(erp, sense);
2186 /* inspect the 32 byte sense data */
2187 erp_new = dasd_3990_erp_inspect_32(erp, sense);
2189 } /* end distinguish between 24 and 32 byte sense data */
2195 * DASD_3990_ERP_ADD_ERP
2198 * This funtion adds an additional request block (ERP) to the head of
2199 * the given cqr (or erp).
2200 * This erp is initialized as an default erp (retry TIC)
2203 * cqr head of the current ERP-chain (or single cqr if
2206 * erp pointer to new ERP-chain head
2208 static struct dasd_ccw_req *
2209 dasd_3990_erp_add_erp(struct dasd_ccw_req * cqr)
2212 struct dasd_device *device = cqr->startdev;
2215 /* allocate additional request block */
2216 struct dasd_ccw_req *erp;
2218 erp = dasd_alloc_erp_request((char *) &cqr->magic, 2, 0, device);
2220 if (cqr->retries <= 0) {
2221 DEV_MESSAGE(KERN_ERR, device, "%s",
2222 "Unable to allocate ERP request");
2223 cqr->status = DASD_CQR_FAILED;
2224 cqr->stopclk = get_clock ();
2226 DEV_MESSAGE (KERN_ERR, device,
2227 "Unable to allocate ERP request "
2228 "(%i retries left)",
2230 dasd_block_set_timer(device->block, (HZ << 3));
2235 /* initialize request with default TIC to current ERP/CQR */
2237 ccw->cmd_code = CCW_CMD_NOOP;
2238 ccw->flags = CCW_FLAG_CC;
2240 ccw->cmd_code = CCW_CMD_TIC;
2241 ccw->cda = (long)(cqr->cpaddr);
2242 erp->function = dasd_3990_erp_add_erp;
2244 erp->startdev = device;
2245 erp->memdev = device;
2246 erp->block = cqr->block;
2247 erp->magic = cqr->magic;
2250 erp->buildclk = get_clock();
2252 erp->status = DASD_CQR_FILLED;
2258 * DASD_3990_ERP_ADDITIONAL_ERP
2261 * An additional ERP is needed to handle the current error.
2262 * Add ERP to the head of the ERP-chain containing the ERP processing
2263 * determined based on the sense data.
2266 * cqr head of the current ERP-chain (or single cqr if
2270 * erp pointer to new ERP-chain head
2272 static struct dasd_ccw_req *
2273 dasd_3990_erp_additional_erp(struct dasd_ccw_req * cqr)
2276 struct dasd_ccw_req *erp = NULL;
2278 /* add erp and initialize with default TIC */
2279 erp = dasd_3990_erp_add_erp(cqr);
2281 /* inspect sense, determine specific ERP if possible */
2284 erp = dasd_3990_erp_inspect(erp);
2289 } /* end dasd_3990_erp_additional_erp */
2292 * DASD_3990_ERP_ERROR_MATCH
2295 * Check if the device status of the given cqr is the same.
2296 * This means that the failed CCW and the relevant sense data
2298 * I don't distinguish between 24 and 32 byte sense because in case of
2299 * 24 byte sense byte 25 and 27 is set as well.
2302 * cqr1 first cqr, which will be compared with the
2306 * match 'boolean' for match found
2307 * returns 1 if match found, otherwise 0.
2310 dasd_3990_erp_error_match(struct dasd_ccw_req *cqr1, struct dasd_ccw_req *cqr2)
2313 if (cqr1->startdev != cqr2->startdev)
2316 if (cqr1->irb.esw.esw0.erw.cons != cqr2->irb.esw.esw0.erw.cons)
2319 if ((cqr1->irb.esw.esw0.erw.cons == 0) &&
2320 (cqr2->irb.esw.esw0.erw.cons == 0)) {
2321 if ((cqr1->irb.scsw.cstat & (SCHN_STAT_INTF_CTRL_CHK |
2322 SCHN_STAT_CHN_CTRL_CHK)) ==
2323 (cqr2->irb.scsw.cstat & (SCHN_STAT_INTF_CTRL_CHK |
2324 SCHN_STAT_CHN_CTRL_CHK)))
2325 return 1; /* match with ifcc*/
2327 /* check sense data; byte 0-2,25,27 */
2328 if (!((memcmp (cqr1->irb.ecw, cqr2->irb.ecw, 3) == 0) &&
2329 (cqr1->irb.ecw[27] == cqr2->irb.ecw[27]) &&
2330 (cqr1->irb.ecw[25] == cqr2->irb.ecw[25]))) {
2332 return 0; /* sense doesn't match */
2335 return 1; /* match */
2337 } /* end dasd_3990_erp_error_match */
2340 * DASD_3990_ERP_IN_ERP
2343 * check if the current error already happened before.
2344 * quick exit if current cqr is not an ERP (cqr->refers=NULL)
2347 * cqr failed cqr (either original cqr or already an erp)
2350 * erp erp-pointer to the already defined error
2351 * recovery procedure OR
2352 * NULL if a 'new' error occurred.
2354 static struct dasd_ccw_req *
2355 dasd_3990_erp_in_erp(struct dasd_ccw_req *cqr)
2358 struct dasd_ccw_req *erp_head = cqr, /* save erp chain head */
2359 *erp_match = NULL; /* save erp chain head */
2360 int match = 0; /* 'boolean' for matching error found */
2362 if (cqr->refers == NULL) { /* return if not in erp */
2366 /* check the erp/cqr chain for current error */
2368 match = dasd_3990_erp_error_match(erp_head, cqr->refers);
2369 erp_match = cqr; /* save possible matching erp */
2370 cqr = cqr->refers; /* check next erp/cqr in queue */
2372 } while ((cqr->refers != NULL) && (!match));
2375 return NULL; /* no match was found */
2378 return erp_match; /* return address of matching erp */
2380 } /* END dasd_3990_erp_in_erp */
2383 * DASD_3990_ERP_FURTHER_ERP (24 & 32 byte sense)
2386 * No retry is left for the current ERP. Check what has to be done
2388 * - do further defined ERP action or
2389 * - wait for interrupt or
2390 * - exit with permanent error
2393 * erp ERP which is in progress with no retry left
2396 * erp modified/additional ERP
2398 static struct dasd_ccw_req *
2399 dasd_3990_erp_further_erp(struct dasd_ccw_req *erp)
2402 struct dasd_device *device = erp->startdev;
2403 char *sense = erp->irb.ecw;
2405 /* check for 24 byte sense ERP */
2406 if ((erp->function == dasd_3990_erp_bus_out) ||
2407 (erp->function == dasd_3990_erp_action_1) ||
2408 (erp->function == dasd_3990_erp_action_4)) {
2410 erp = dasd_3990_erp_action_1(erp);
2412 } else if (erp->function == dasd_3990_erp_action_5) {
2414 /* retries have not been successful */
2415 /* prepare erp for retry on different channel path */
2416 erp = dasd_3990_erp_action_1(erp);
2418 if (!(sense[2] & DASD_SENSE_BIT_0)) {
2420 /* issue a Diagnostic Control command with an
2421 * Inhibit Write subcommand */
2423 switch (sense[25]) {
2425 case 0x57:{ /* controller */
2426 erp = dasd_3990_erp_DCTL(erp, 0x20);
2430 case 0x58:{ /* channel path */
2431 erp = dasd_3990_erp_DCTL(erp, 0x40);
2435 case 0x59:{ /* storage director */
2436 erp = dasd_3990_erp_DCTL(erp, 0x80);
2440 DEV_MESSAGE(KERN_DEBUG, device,
2441 "invalid subcommand modifier 0x%x "
2442 "for Diagnostic Control Command",
2447 /* check for 32 byte sense ERP */
2448 } else if ((erp->function == dasd_3990_erp_compound_retry) ||
2449 (erp->function == dasd_3990_erp_compound_path) ||
2450 (erp->function == dasd_3990_erp_compound_code) ||
2451 (erp->function == dasd_3990_erp_compound_config)) {
2453 erp = dasd_3990_erp_compound(erp, sense);
2456 /* No retry left and no additional special handling */
2458 DEV_MESSAGE(KERN_ERR, device,
2459 "no retries left for erp %p - "
2460 "set status to FAILED", erp);
2462 erp->status = DASD_CQR_FAILED;
2467 } /* end dasd_3990_erp_further_erp */
2470 * DASD_3990_ERP_HANDLE_MATCH_ERP
2473 * An error occurred again and an ERP has been detected which is already
2474 * used to handle this error (e.g. retries).
2475 * All prior ERP's are asumed to be successful and therefore removed
2477 * If retry counter of matching erp is already 0, it is checked if further
2478 * action is needed (besides retry) or if the ERP has failed.
2481 * erp_head first ERP in ERP-chain
2482 * erp ERP that handles the actual error.
2486 * erp modified/additional ERP
2488 static struct dasd_ccw_req *
2489 dasd_3990_erp_handle_match_erp(struct dasd_ccw_req *erp_head,
2490 struct dasd_ccw_req *erp)
2493 struct dasd_device *device = erp_head->startdev;
2494 struct dasd_ccw_req *erp_done = erp_head; /* finished req */
2495 struct dasd_ccw_req *erp_free = NULL; /* req to be freed */
2497 /* loop over successful ERPs and remove them from chanq */
2498 while (erp_done != erp) {
2500 if (erp_done == NULL) /* end of chain reached */
2501 panic(PRINTK_HEADER "Programming error in ERP! The "
2502 "original request was lost\n");
2504 /* remove the request from the device queue */
2505 list_del(&erp_done->blocklist);
2507 erp_free = erp_done;
2508 erp_done = erp_done->refers;
2510 /* free the finished erp request */
2511 dasd_free_erp_request(erp_free, erp_free->memdev);
2515 if (erp->retries > 0) {
2517 char *sense = erp->refers->irb.ecw;
2519 /* check for special retries */
2520 if (erp->function == dasd_3990_erp_action_4) {
2522 erp = dasd_3990_erp_action_4(erp, sense);
2524 } else if (erp->function == dasd_3990_erp_action_1B_32) {
2526 erp = dasd_3990_update_1B(erp, sense);
2528 } else if (erp->function == dasd_3990_erp_int_req) {
2530 erp = dasd_3990_erp_int_req(erp);
2534 DEV_MESSAGE(KERN_DEBUG, device,
2535 "%i retries left for erp %p",
2538 /* handle the request again... */
2539 erp->status = DASD_CQR_FILLED;
2543 /* no retry left - check for further necessary action */
2544 /* if no further actions, handle rest as permanent error */
2545 erp = dasd_3990_erp_further_erp(erp);
2550 } /* end dasd_3990_erp_handle_match_erp */
2553 * DASD_3990_ERP_ACTION
2556 * control routine for 3990 erp actions.
2557 * Has to be called with the queue lock (namely the s390_irq_lock) acquired.
2560 * cqr failed cqr (either original cqr or already an erp)
2563 * erp erp-pointer to the head of the ERP action chain.
2565 * - either a ptr to an additional ERP cqr or
2566 * - the original given cqr (which's status might
2569 struct dasd_ccw_req *
2570 dasd_3990_erp_action(struct dasd_ccw_req * cqr)
2572 struct dasd_ccw_req *erp = NULL;
2573 struct dasd_device *device = cqr->startdev;
2574 struct dasd_ccw_req *temp_erp = NULL;
2576 if (device->features & DASD_FEATURE_ERPLOG) {
2577 /* print current erp_chain */
2578 DEV_MESSAGE(KERN_ERR, device, "%s",
2579 "ERP chain at BEGINNING of ERP-ACTION");
2580 for (temp_erp = cqr;
2581 temp_erp != NULL; temp_erp = temp_erp->refers) {
2583 DEV_MESSAGE(KERN_ERR, device,
2584 " erp %p (%02x) refers to %p",
2585 temp_erp, temp_erp->status,
2590 /* double-check if current erp/cqr was successfull */
2591 if ((cqr->irb.scsw.cstat == 0x00) &&
2592 (cqr->irb.scsw.dstat == (DEV_STAT_CHN_END|DEV_STAT_DEV_END))) {
2594 DEV_MESSAGE(KERN_DEBUG, device,
2595 "ERP called for successful request %p"
2596 " - NO ERP necessary", cqr);
2598 cqr->status = DASD_CQR_DONE;
2603 /* check if error happened before */
2604 erp = dasd_3990_erp_in_erp(cqr);
2607 /* no matching erp found - set up erp */
2608 erp = dasd_3990_erp_additional_erp(cqr);
2610 /* matching erp found - set all leading erp's to DONE */
2611 erp = dasd_3990_erp_handle_match_erp(cqr, erp);
2614 if (device->features & DASD_FEATURE_ERPLOG) {
2615 /* print current erp_chain */
2616 DEV_MESSAGE(KERN_ERR, device, "%s",
2617 "ERP chain at END of ERP-ACTION");
2618 for (temp_erp = erp;
2619 temp_erp != NULL; temp_erp = temp_erp->refers) {
2621 DEV_MESSAGE(KERN_ERR, device,
2622 " erp %p (%02x) refers to %p",
2623 temp_erp, temp_erp->status,
2628 /* enqueue ERP request if it's a new one */
2629 if (list_empty(&erp->blocklist)) {
2630 cqr->status = DASD_CQR_IN_ERP;
2631 /* add erp request before the cqr */
2632 list_add_tail(&erp->blocklist, &cqr->blocklist);
2637 } /* end dasd_3990_erp_action */