Update to 3.4-final.
[linux-flexiantxendom0-3.2.10.git] / Documentation / kmsg / s390 / zfcp
1 /*?
2  * Text: "%s is not a valid SCSI device\n"
3  * Severity: Error
4  * Parameter:
5  *   @1: device specification
6  * Description:
7  * The specification for an initial SCSI device provided with the 'zfcp.device'
8  * kernel parameter or with the 'device' module parameter is syntactically
9  * incorrect. The specified SCSI device could not be attached to the Linux
10  * system.
11  * User action:
12  * Correct the value for the 'zfcp.device' or 'device' parameter and reboot
13  * Linux. See "Device Drivers, Features, and Commands" for information about
14  * the syntax.
15  */
16
17 /*?
18  * Text: "Registering the misc device zfcp_cfdc failed\n"
19  * Severity: Error
20  * Description:
21  * The zfcp device driver failed to register the device that provides access to
22  * the adapter access control file (ACL tables). The device driver
23  * initialization failed. A possible cause for this problem is memory
24  * constraints.
25  * User action:
26  * Free some memory and try again to load the zfcp device driver. If the zfcp
27  * device driver has been compiled into the kernel, reboot Linux. Consider
28  * assigning more memory to your LPAR or z/VM guest virtual machine. If the
29  * problem persists, contact your support organization.
30  */
31
32 /*?
33  * Text: "The zfcp device driver could not register with the common I/O layer\n"
34  * Severity: Error
35  * Description:
36  * The device driver initialization failed. A possible cause of this problem is
37  * memory constraints.
38  * User action:
39  * Free some memory and try again to load the zfcp device driver. If the zfcp
40  * device driver has been compiled into the kernel, reboot Linux. Consider
41  * assigning more memory to your LPAR or z/VM guest virtual machine. If the
42  * problem persists, contact your support organization.
43  */
44
45 /*?
46  * Text: "%s: Setting up data structures for the FCP adapter failed\n"
47  * Severity: Error
48  * Parameter:
49  *   @1: bus ID of the zfcp device
50  * Description:
51  * The zfcp device driver could not allocate data structures for an FCP adapter.
52  * A possible reason for this problem is memory constraints.
53  * User action:
54  * Set the FCP adapter offline or detach it from the Linux system, free some
55  * memory and set the FCP adapter online again or attach it again. If this
56  * problem persists, gather Linux debug data, collect the FCP adapter
57  * hardware logs, and report the problem to your support organization.
58  */
59
60 /*?
61  * Text: "%s: The FCP device is operational again\n"
62  * Severity: Informational
63  * Parameter:
64  *   @1: bus ID of the zfcp device
65  * Description:
66  * An FCP device has been unavailable because it had been detached from the
67  * Linux system or because the corresponding CHPID was offline. The FCP device
68  * is now available again and the zfcp device driver resumes all operations to
69  * the FCP device.
70  * User action:
71  * None.
72  */
73
74 /*?
75  * Text: "%s: The CHPID for the FCP device is offline\n"
76  * Severity: Warning
77  * Parameter:
78  *   @1: bus ID of the zfcp device
79  * Description:
80  * The CHPID for an FCP device has been set offline, either logically in Linux
81  * or on the hardware.
82  * User action:
83  * Find out which CHPID corresponds to the FCP device, for example, with the
84  * lscss command. Check if the CHPID has been set logically offline in sysfs.
85  * Write 'on' to the CHPID's status attribute to set it online. If the CHPID is
86  * online in sysfs, find out if it has been varied offline through a hardware
87  * management interface, for example the service element (SE).
88  */
89
90 /*?
91  * Text: "%s: The FCP device has been detached\n"
92  * Severity: Warning
93  * Parameter:
94  *   @1: bus ID of the zfcp device
95  * Description:
96  * An FCP device is no longer available to Linux.
97  * User action:
98  * Ensure that the FCP adapter is operational and attached to the LPAR or z/VM
99  * virtual machine.
100  */
101
102 /*?
103  * Text: "%s: The FCP device did not respond within the specified time\n"
104  * Severity: Warning
105  * Parameter:
106  *   @1: bus ID of the zfcp device
107  * Description:
108  * The common I/O layer waited for a response from the FCP adapter but
109  * no response was received within the specified time limit. This might
110  * indicate a hardware problem.
111  * User action:
112  * Consult your hardware administrator. If this problem persists,
113  * gather Linux debug data, collect the FCP adapter hardware logs, and
114  * report the problem to your support organization.
115  */
116
117 /*?
118  * Text: "%s: Registering the FCP device with the SCSI stack failed\n"
119  * Severity: Error
120  * Parameter:
121  *   @1: bus ID of the zfcp device
122  * Description:
123  * The FCP adapter could not be registered with the Linux SCSI
124  * stack. A possible reason for this problem is memory constraints.
125  * User action:
126  * Set the FCP adapter offline or detach it from the Linux system, free some
127  * memory and set the FCP adapter online again or attach it again. If this
128  * problem persists, gather Linux debug data, collect the FCP adapter
129  * hardware logs, and report the problem to your support organization.
130  */
131
132 /*?
133  * Text: "%s: ERP cannot recover an error on the FCP device\n"
134  * Severity: Error
135  * Parameter:
136  *   @1: bus ID of the zfcp device
137  * Description:
138  * An error occurred on an FCP device. The error recovery procedure (ERP)
139  * could not resolve the error. The FCP device driver cannot use the FCP device.
140  * User action:
141  * Check for previous error messages for the same FCP device to find the
142  * cause of the problem.
143  */
144
145 /*?
146  * Text: "%s: Creating an ERP thread for the FCP device failed.\n"
147  * Severity: Error
148  * Parameter:
149  *   @1: bus ID of the zfcp device
150  * Description:
151  * The zfcp device driver could not set up error recovery procedure (ERP)
152  * processing for the FCP device. The FCP device is not available for use
153  * in Linux.
154  * User action:
155  * Free some memory and try again to load the zfcp device driver. If the zfcp
156  * device driver has been compiled into the kernel, reboot Linux. Consider
157  * assigning more memory to your LPAR or z/VM guest virtual machine. If the
158  * problem persists, contact your support organization.
159  */
160
161 /*?
162  * Text: "%s: ERP failed for unit 0x%016Lx on port 0x%016Lx\n"
163  * Severity: Error
164  * Parameter:
165  *   @1: bus ID of the zfcp device
166  *   @2: LUN
167  *   @3: WWPN
168  * Description:
169  * An error occurred on the SCSI device at the specified LUN. The error recovery
170  * procedure (ERP) could not resolve the error. The SCSI device is not
171  * available.
172  * User action:
173  * Verify that the LUN is correct. Check the fibre channel fabric for errors
174  * related to the specified WWPN and LUN, the storage server, and Linux.
175  */
176
177 /*?
178  * Text: "%s: ERP failed for remote port 0x%016Lx\n"
179  * Severity: Error
180  * Parameter:
181  *   @1: bus ID of the zfcp device
182  *   @2: WWPN
183  * Description:
184  * An error occurred on a remote port. The error recovery procedure (ERP)
185  * could not resolve the error. The port is not available.
186  * User action:
187  * Verify that the WWPN is correct and check the fibre channel fabric for
188  * errors related to the WWPN.
189  */
190
191 /*?
192  * Text: "%s: Attaching the name server port to the FCP device failed\n"
193  * Severity: Error
194  * Parameter:
195  *   @1: bus ID of the zfcp device
196  * Description:
197  * The zfcp device driver could not attach the name server port of the fibre
198  * channel fabric to an FCP device. A possible cause of this problem is
199  * memory constraints.
200  * User action:
201  * Set the FCP device offline, free some memory, then set the FCP device online
202  * again. If this does not resolve the problem, reboot Linux and try again to
203  * set the FCP device online.
204  */
205
206 /*?
207  * Text: "%s: Registering unit 0x%016Lx on port 0x%016Lx failed\n"
208  * Severity: Error
209  * Parameter:
210  *   @1: bus ID of the zfcp device
211  *   @2: LUN
212  *   @3: WWPN
213  * Description:
214  * The Linux kernel could not allocate enough memory to register the SCSI
215  * device at the indicated LUN with the SCSI stack. The SCSI device is not
216  * available.
217  * User action:
218  * Free some memory then detach the LUN and attach it again.
219  */
220
221 /*?
222  * Text: "%s: Registering port 0x%016Lx failed\n"
223  * Severity: Error
224  * Parameter:
225  *   @1: bus ID of the zfcp device
226  *   @2: WWPN
227  * Description:
228  * The Linux kernel could not allocate enough memory to register the
229  * remote port with the indicated WWPN with the SCSI stack. The remote
230  * port is not available.
231  * User action:
232  * Free some memory and trigger the rescan for ports.
233  */
234
235 /*?
236  * Text: "%s: A QDIO problem occurred\n"
237  * Severity: Warning
238  * Parameter:
239  *   @1: bus ID of the zfcp device
240  * Description:
241  * QDIO reported a problem to the zfcp device driver. The zfcp device driver
242  * tries to recover this problem.
243  * User action:
244  * Check for related error messages. If this problem occurs frequently, gather
245  * Linux debug data and contact your support organization.
246  */
247
248 /*?
249  * Text: "%s: A QDIO protocol error occurred, operations continue\n"
250  * Severity: Warning
251  * Parameter:
252  *   @1: bus ID of the zfcp device
253  * Description:
254  * The zfcp device driver detected a missing flag in a QDIO queue. The device
255  * driver tries to keep the FCP device operational.
256  * User action:
257  * Check for related error messages. If this problem occurs frequently, gather
258  * Linux debug data, collect the FCP adapter hardware logs, and report the
259  * problem to your support organization.
260  */
261
262 /*?
263  * Text: "%s: Setting up the QDIO connection to the FCP adapter failed\n"
264  * Severity: Error
265  * Parameter:
266  *   @1: bus ID of the zfcp device
267  * Description:
268  * The zfcp device driver failed to establish a QDIO connection with the FCP
269  * adapter.
270  * User action:
271  * Set the FCP adapter offline or detach it from the Linux system, free some
272  * memory and set the FCP adapter online again or attach it again. If this
273  * problem persists, gather Linux debug data, collect the FCP adapter
274  * hardware logs, and report the problem to your support organization.
275  */
276
277 /*?
278  * Text: "%s: The FCP adapter reported a problem that cannot be recovered\n"
279  * Severity: Error
280  * Parameter:
281  *   @1: bus ID of the zfcp device
282  * Description:
283  * The FCP adapter has a problem that cannot be recovered by the zfcp device
284  * driver. The zfcp device driver stopped using the FCP device.
285  * User action:
286  * Gather Linux debug data, collect the FCP adapter hardware logs, and report
287  * this problem to your support organization.
288  */
289
290 /*?
291  * Text: "%s: There is a wrap plug instead of a fibre channel cable\n"
292  * Severity: Warning
293  * Parameter:
294  *   @1: bus ID of the zfcp device
295  * Description:
296  * The FCP adapter is not physically connected to the fibre channel fabric.
297  * User action:
298  * Remove the wrap plug from the FCP adapter and connect the adapter with the
299  * fibre channel fabric.
300  */
301
302 /*?
303  * Text: "%s: Access denied to unit 0x%016Lx on port 0x%016Lx\n"
304  * Severity: Warning
305  * Parameter:
306  *   @1: bus ID of the zfcp device
307  *   @2: LUN
308  *   @3: WWPN
309  * Description:
310  * The Linux system is not allowed to access the SCSI device at the indicated
311  * LUN.
312  * User action:
313  * Update the access control table of the FCP device to grant the Linux
314  * system access to the LUN or remove the LUN from the Linux system.
315  */
316
317 /*?
318  * Text: "%s: FCP device not operational because of an unsupported FC class\n"
319  * Severity: Error
320  * Parameter:
321  *   @1: bus ID of the zfcp device
322  * Description:
323  * The FCP adapter hardware does not support the fibre channel service class
324  * requested by the zfcp device driver. This problem indicates a program error
325  * in the zfcp device driver.
326  * User action:
327  * Gather Linux debug data, collect the FCP adapter hardware logs, and report
328  * this problem to your support organization.
329  */
330
331 /*?
332  * Text: "%s: 0x%Lx is an ambiguous request identifier\n"
333  * Severity: Error
334  * Parameter:
335  *   @1: bus ID of the zfcp device
336  *   @2: request ID
337  * Description:
338  * The FCP adapter reported that it received the same request ID twice. This is
339  * an error. The zfcp device driver stopped using the FCP device.
340  * User action:
341  * Gather Linux debug data, collect the FCP adapter hardware logs, and report
342  * this problem to your support organization.
343  */
344
345 /*?
346  * Text: "%s: QTCB version 0x%x not supported by FCP adapter (0x%x to 0x%x)\n"
347  * Severity: Error
348  * Parameter:
349  *   @1: bus ID of the zfcp device
350  *   @2: requested version
351  *   @3: lowest supported version
352  *   @4: highest supported version
353  * Description:
354  * See message text.
355  * The queue transfer control block (QTCB) version requested by the zfcp device
356  * driver is not supported by the FCP adapter hardware.
357  * User action:
358  * If the requested version is higher than the highest version supported by the
359  * hardware, install more recent firmware on the FCP adapter. If the requested
360  * version is lower then the lowest version supported by the hardware, upgrade
361  * to a Linux level with a more recent zfcp device driver.
362  */
363
364 /*?
365  * Text: "%s: The FCP adapter could not log in to the fibre channel fabric\n"
366  * Severity: Warning
367  * Parameter:
368  *   @1: bus ID of the zfcp device
369  * Description:
370  * The fibre channel switch rejected the login request from the FCP adapter.
371  * User action:
372  * Check the fibre channel fabric or switch logs for possible errors.
373  */
374
375 /*?
376  * Text: "%s: The FCP device is suspended because of a firmware update\n"
377  * Severity: Warning
378  * Parameter:
379  *   @1: bus ID of the zfcp device
380  * Description:
381  * The FCP device is not available while a firmware update is in progress. This
382  * problem is temporary. The FCP device will resume operations when the
383  * firmware update is completed.
384  * User action:
385  * Wait 10 seconds and try the operation again.
386  */
387
388 /*?
389  * Text: "%s: All NPIV ports on the FCP adapter have been assigned\n"
390  * Severity: Warning
391  * Parameter:
392  *   @1: bus ID of the zfcp device
393  * Description:
394  * The number of N_Port ID Virtualization (NPIV) ports that can be assigned
395  * on an FCP adapter is limited. Once assigned, NPIV ports are not released
396  * automatically but have to be released explicitly through the support
397  * element (SE).
398  * User action:
399  * Identify NPIV ports that have been assigned but are no longer in use and
400  * release them from the SE.
401  */
402
403 /*?
404  * Text: "%s: The link between the FCP adapter and the FC fabric is down\n"
405  * Severity: Warning
406  * Parameter:
407  *   @1: bus ID of the zfcp device
408  * Description:
409  * The FCP adapter is not usable. Specific error information is not available.
410  * User action:
411  * Check the cabling and the fibre channel fabric configuration. If this
412  * problem persists, gather Linux debug data, collect the FCP adapter
413  * hardware logs, and report the problem to your support organization.
414  */
415
416 /*?
417  * Text: "%s: Access denied to port 0x%016Lx\n"
418  * Severity: Warning
419  * Parameter:
420  *   @1: bus ID of the zfcp device
421  *   @2: WWPN
422  * Description:
423  * The Linux system is not allowed to access the remote port with the specified
424  * WWPN.
425  * User action:
426  * Update the access control table of the FCP device to grant the Linux
427  * system access to the WWPN or remove the WWPN from the Linux system.
428  */
429
430 /*?
431  * Text: "%s: The QTCB type is not supported by the FCP adapter\n"
432  * Severity: Error
433  * Parameter:
434  *   @1: bus ID of the zfcp device
435  * Description:
436  * The queue transfer control block (QTCB) type requested by the zfcp device
437  * driver is not supported by the FCP adapter hardware.
438  * User action:
439  * Install the latest firmware on your FCP adapter hardware. If this does not
440  * resolve the problem, upgrade to a Linux level with a more recent zfcp device
441  * driver. If the problem persists, contact your support organization.
442  */
443
444 /*?
445  * Text: "%s: The error threshold for checksum statistics has been exceeded\n"
446  * Severity: Warning
447  * Parameter:
448  *   @1: bus ID of the zfcp device
449  * Description:
450  * The FCP adapter has reported a large number of bit errors. This might
451  * indicate a problem with the physical components of the fibre channel fabric.
452  * Details about the errors have been written to the HBA trace for the FCP
453  * adapter.
454  * User action:
455  * Check for problems in the fibre channel fabric and ensure that all cables
456  * are properly plugged.
457  */
458
459 /*?
460  * Text: "%s: The local link has been restored\n"
461  * Severity: Informational
462  * Parameter:
463  *   @1: bus ID of the zfcp device
464  * Description:
465  * A problem with the connection between the FCP adapter and the adjacent node
466  * on the fibre channel fabric has been resolved. The FCP adapter is now
467  * available again.
468  * User action:
469  * None.
470  */
471
472 /*?
473  * Text: "%s: Access denied according to ACT rule type %s, rule %d\n"
474  * Severity: Warning
475  * Parameter:
476  *   @1: bus ID of the zfcp device
477  *   @2: access rule type
478  *   @3: access rule
479  * Description:
480  * A rule in the access control table (ACT) for the FCP device denies access
481  * to a remote port or a LUN.
482  * User action:
483  * Examine the access control tables for the FCP device to see if the
484  * specified rule is correct.
485  */
486
487 /*?
488  * Text: "%s: The mode table on the FCP adapter has been damaged\n"
489  * Severity: Warning
490  * Parameter:
491  *   @1: bus ID of the zfcp device
492  * Description:
493  * This is an FCP adapter hardware problem.
494  * User action:
495  * Report this problem with FCP hardware logs to IBM support.
496  */
497
498 /*?
499  * Text: "%s: The adjacent fibre channel node does not support FCP\n"
500  * Severity: Warning
501  * Parameter:
502  *   @1: bus ID of the zfcp device
503  * Description:
504  * The fibre channel switch or storage system that is connected to the FCP
505  * channel does not support the fibre channel protocol (FCP). The zfcp
506  * device driver stopped using the FCP device.
507  * User action:
508  * Check the adjacent fibre channel node.
509  */
510
511 /*?
512  * Text: "%s: The FCP adapter does not recognize the command 0x%x\n"
513  * Severity: Error
514  * Parameter:
515  *   @1: bus ID of the zfcp device
516  *   @2: command
517  * Description:
518  * A command code that was sent from the zfcp device driver to the FCP adapter
519  * is not valid. The zfcp device driver stopped using the FCP device.
520  * User action:
521  * Gather Linux debug data, collect the FCP adapter hardware logs, and report
522  * this problem to your support organization.
523  */
524
525 /*?
526  * Text: "%s: There is no light signal from the local fibre channel cable\n"
527  * Severity: Warning
528  * Parameter:
529  *   @1: bus ID of the zfcp device
530  * Description:
531  * There is no signal on the fibre channel cable that connects the FCP adapter
532  * to the fibre channel fabric.
533  * User action:
534  * Ensure that the cable is in place and connected properly to the FCP adapter
535  * and to the adjacent fibre channel switch or storage system.
536  */
537
538 /*?
539  * Text: "%s: The WWPN assignment file on the FCP adapter has been damaged\n"
540  * Severity: Warning
541  * Parameter:
542  *   @1: bus ID of the zfcp device
543  * Description:
544  * This is an FCP adapter hardware problem.
545  * User action:
546  * Report this problem with FCP hardware logs to IBM support.
547  */
548
549 /*?
550  * Text: "%s: The FCP device detected a WWPN that is duplicate or not valid\n"
551  * Severity: Warning
552  * Parameter:
553  *   @1: bus ID of the zfcp device
554  * Description:
555  * This condition indicates an error in the FCP adapter hardware or in the z/VM
556  * hypervisor.
557  * User action:
558  * Gather Linux debug data, collect the FCP adapter hardware logs, and report
559  * this problem to IBM support.
560  */
561
562 /*?
563  * Text: "%s: The fibre channel fabric does not support NPIV\n"
564  * Severity: Warning
565  * Parameter:
566  *   @1: bus ID of the zfcp device
567  * Description:
568  * The FCP adapter requires N_Port ID Virtualization (NPIV) from the adjacent
569  * fibre channel node. Either the FCP adapter is connected to a fibre channel
570  * switch that does not support NPIV or the FCP adapter tries to use NPIV in a
571  * point-to-point setup. The connection is not operational.
572  * User action:
573  * Verify that NPIV is correctly used for this connection. Check the FCP adapter
574  * configuration and the fibre channel switch configuration. If necessary,
575  * update the fibre channel switch firmware.
576  */
577
578 /*?
579  * Text: "%s: The FCP adapter cannot support more NPIV ports\n"
580  * Severity: Warning
581  * Parameter:
582  *   @1: bus ID of the zfcp device
583  * Description:
584  * N_Port ID Virtualization (NPIV) ports consume physical resources on the FCP
585  * adapter. The FCP adapter resources are exhausted. The connection is not
586  * operational.
587  * User action:
588  * Analyze the number of available NPIV ports and which operating system
589  * instances use them. If necessary, reconfigure your setup to move some
590  * NPIV ports to an FCP adapter with free resources.
591  */
592
593 /*?
594  * Text: "%s: The adjacent switch cannot support more NPIV ports\n"
595  * Severity: Warning
596  * Parameter:
597  *   @1: bus ID of the zfcp device
598  * Description:
599  * N_Port ID Virtualization (NPIV) ports consume physical resources. The
600  * resources of the fibre channel switch that is connected to the FCP adapter
601  * are exhausted. The connection is not operational.
602  * User action:
603  * Analyze the number of available NPIV ports on the adjacent fibre channel
604  * switch and how they are used. If necessary, reconfigure your fibre channel
605  * fabric to accommodate the required NPIV ports.
606  */
607
608 /*?
609  * Text: "%s: 0x%x is not a valid transfer protocol status\n"
610  * Severity: Error
611  * Parameter:
612  *   @1: bus ID of the zfcp device
613  *   @2: status information
614  * Description:
615  * The transfer protocol status information reported by the FCP adapter is not
616  * a valid status for the zfcp device driver. The zfcp device driver stopped
617  * using the FCP device.
618  * User action:
619  * Gather Linux debug data, collect the FCP adapter hardware logs, and report
620  * this problem to your support organization.
621  */
622
623 /*?
624  * Text: "%s: Unknown or unsupported arbitrated loop fibre channel topology detected\n"
625  * Severity: Error
626  * Parameter:
627  *   @1: bus ID of the zfcp device
628  * Description:
629  * The FCP device is connected to a fibre channel arbitrated loop or the FCP adapter
630  * reported an unknown fibre channel topology. The zfcp device driver supports
631  * point-to-point connections and switched fibre channel fabrics but not arbitrated
632  * loop topologies. The FCP device cannot be used.
633  * User action:
634  * Check the fibre channel setup and ensure that only supported topologies are
635  * connected to the FCP adapter.
636  */
637
638 /*?
639  * Text: "%s: FCP adapter maximum QTCB size (%d bytes) is too small\n"
640  * Severity: Error
641  * Parameter:
642  *   @1: bus ID of the zfcp device
643  *   @2: maximum supported size
644  *   @3: requested QTCB size
645  * Description:
646  * The queue transfer control block (QTCB) size requested by the zfcp
647  * device driver is not supported by the FCP adapter hardware.
648  * User action:
649  * Update the firmware on your FCP adapter hardware to the latest
650  * available level and update the Linux kernel to the latest supported
651  * level. If the problem persists, contact your support organization.
652  */
653
654 /*?
655  * Text: "%s: The FCP adapter only supports newer control block versions\n"
656  * Severity: Error
657  * Parameter:
658  *   @1: bus ID of the zfcp device
659  * Description:
660  * The protocol supported by the FCP adapter is not compatible with the zfcp
661  * device driver.
662  * User action:
663  * Upgrade your Linux kernel to a level that includes a zfcp device driver
664  * with support for the control block version required by your FCP adapter.
665  */
666
667 /*?
668  * Text: "%s: The FCP adapter only supports older control block versions\n"
669  * Severity: Error
670  * Parameter:
671  *   @1: bus ID of the zfcp device
672  * Description:
673  * The protocol supported by the FCP adapter is not compatible with the zfcp
674  * device driver.
675  * User action:
676  * Install the latest firmware on your FCP adapter.
677  */
678
679 /*?
680  * Text: "%s: Not enough FCP adapter resources to open remote port 0x%016Lx\n"
681  * Severity: Warning
682  * Parameter:
683  *   @1: bus ID of the zfcp device
684  *   @2: WWPN
685  * Description:
686  * Each port that is opened consumes physical resources of the FCP adapter to
687  * which it is attached. These resources are exhausted and the specified port
688  * cannot be opened.
689  * User action:
690  * Reduce the total number of remote ports that are attached to the
691  * FCP adapter.
692  */
693
694 /*?
695  * Text: "%s: LUN 0x%Lx on port 0x%Lx is already in use by CSS%d, MIF Image ID %x\n"
696  * Severity: Warning
697  * Parameter:
698  *   @1: bus ID of the zfcp device
699  *   @2: LUN
700  *   @3: remote port WWPN
701  *   @4: channel subsystem ID
702  *   @5: MIF Image ID of the LPAR
703  * Description:
704  * The SCSI device at the indicated LUN is already in use by another system.
705  * Only one system at a time can use the SCSI device.
706  * User action:
707  * Ensure that the other system stops using the device before trying to use it.
708  */
709
710 /*?
711  * Text: "%s: No handle is available for LUN 0x%016Lx on port 0x%016Lx\n"
712  * Severity: Warning
713  * Parameter:
714  *   @1: bus ID of the zfcp device
715  *   @2: LUN
716  *   @3: WWPN
717  * Description:
718  * The FCP adapter can only open a limited number of SCSI devices. This limit
719  * has been reached and the SCSI device at the indicated LUN cannot be opened.
720  * User action:
721  * Check all SCSI devices opened through the FCP adapter and close some of them.
722  */
723
724 /*?
725  * Text: "%s: SCSI device at LUN 0x%016Lx on port 0x%016Lx opened read-only\n"
726  * Severity: Informational
727  * Parameter:
728  *   @1: bus ID of the zfcp device
729  *   @2: LUN
730  *   @3: WWPN
731  * Description:
732  * The access control tables in the FCP adapter allow read-only access for the
733  * LUN. Write access is not permitted for your Linux instance. The SCSI
734  * device has been opened successfully in read-only access mode.
735  * User action:
736  * None if read-only access is sufficient. If you require write access, change
737  * the access control tables in the FCP adapter.
738  */
739
740 /*?
741  * Text: "%s: Exclusive read-only access not supported (unit 0x%016Lx, port 0x%016Lx)\n"
742  * Severity: Error
743  * Parameter:
744  *   @1: bus ID of the zfcp device
745  *   @2: LUN
746  *   @3: WWPN
747  * Description:
748  * The access configuration specified in the access control tables of the FCP
749  * adapter is not valid. The SCSI device at the indicated LUN cannot be
750  * accessed.
751  * User action:
752  * Change the access control tables in the FCP adapter.
753  */
754
755 /*?
756  * Text: "%s: Shared read-write access not supported (unit 0x%016Lx, port 0x%016Lx)\n"
757  * Severity: Error
758  * Parameter:
759  *   @1: bus ID of the zfcp device
760  *   @2: LUN
761  *   @3: WWPN
762  * Description:
763  * The access configuration specified in the access control tables of the FCP
764  * adapter is not valid. The SCSI device at the indicated LUN cannot be
765  * accessed.
766  * User action:
767  * Change the access control tables in the FCP adapter.
768  */
769
770 /*?
771  * Text: "%s: Incorrect direction %d, unit 0x%016Lx on port 0x%016Lx closed\n"
772  * Severity: Error
773  * Parameter:
774  *   @1: bus ID of the zfcp device
775  *   @2: value in direction field
776  *   @3: LUN
777  *   @4: WWPN
778  * Description:
779  * The direction field in a SCSI request contains an incorrect value. The zfcp
780  * device driver closed down the SCSI device at the indicated LUN.
781  * User action:
782  * Gather Linux debug data and report this problem to your support organization.
783  */
784
785 /*?
786  * Text: "%s: Incorrect CDB length %d, unit 0x%016Lx on port 0x%016Lx closed\n"
787  * Severity: Error
788  * Parameter:
789  *   @1: bus ID of the zfcp device
790  *   @2: value in length field
791  *   @3: LUN
792  *   @4: WWPN
793  * Description:
794  * The control-data-block (CDB) length field in a SCSI request is not valid or
795  * too large for the FCP adapter. The zfcp device driver closed down the SCSI
796  * device at the indicated LUN.
797  * User action:
798  * Gather Linux debug data and report this problem to your support organization.
799  */
800
801 /*?
802  * Text: "%s: Oversize data package, unit 0x%016Lx on port 0x%016Lx closed\n"
803  * Severity: Error
804  * Parameter:
805  *   @1: bus ID of the zfcp device
806  *   @2: LUN
807  *   @3: WWPN
808  * Description:
809  * A SCSI request with too much data has been sent to the SCSI device at the
810  * indicated LUN. The FCP adapter cannot handle data packets of this size and
811  * the SCSI device driver closed down the SCSI device.
812  * User action:
813  * Gather Linux debug data and report this problem to your support organization.
814  */
815
816 /*?
817  * Text: "%s: Opening WKA port 0x%x failed\n"
818  * Severity: Warning
819  * Parameter:
820  *   @1: bus ID of the zfcp device
821  *   @2: destination ID of the WKA port
822  * Description:
823  * The FCP adapter rejected a request to open the specified
824  * well-known address (WKA) port. No retry is possible.
825  * User action:
826  * Verify the setup and check if the maximum number of remote ports
827  * used through this adapter is below the maximum allowed. If the
828  * problem persists, gather Linux debug data, collect the FCP adapter
829  * hardware logs, and report the problem to your support organization.
830  */
831
832 /*?
833  * Text: "%s: The name server reported %d words residual data\n"
834  * Severity: Warning
835  * Parameter:
836  *   @1: bus ID of the zfcp device
837  *   @2: number of words in residual data
838  * Description:
839  * The fibre channel name server sent too much information about remote ports.
840  * The zfcp device driver did not receive sufficient information to attach all
841  * available remote ports in the SAN.
842  * User action:
843  * Verify that you are running the latest firmware level on the FCP
844  * adapter. Check your SAN setup and consider reducing the number of ports
845  * visible to the FCP adapter by using more restrictive zoning in the SAN.
846  */
847
848 /*?
849  * Text: "%s: A port opened with WWPN 0x%016Lx returned data that identifies it as WWPN 0x%016Lx\n"
850  * Severity: Warning
851  * Parameter:
852  *   @1: bus ID of the zfcp device
853  *   @2: expected WWPN
854  *   @3: reported WWPN
855  * Description:
856  * A remote port was opened successfully, but it reported an
857  * unexpected WWPN in the returned port login (PLOGI) data. This
858  * condition might have been caused by a change applied to the SAN
859  * configuration while the port was being opened.
860  * User action:
861  * If this condition is only temporary and access to the remote port
862  * is possible, no action is required. If the condition persists,
863  * identify the storage system with the specified WWPN and contact the
864  * support organization of the storage system.
865  */