27.12.2012 Views

z/VM: CP Commands and Utilities Reference - z/VM - IBM

z/VM: CP Commands and Utilities Reference - z/VM - IBM

z/VM: CP Commands and Utilities Reference - z/VM - IBM

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

|<br />

|<br />

|<br />

|<br />

|<br />

|<br />

|<br />

|<br />

|<br />

|<br />

|<br />

|<br />

|<br />

|<br />

QUERY F<strong>CP</strong><br />

Usage Notes<br />

Responses<br />

1. There is a Linux Access Control Table that is used to control F<strong>CP</strong> LUN access.<br />

<strong>VM</strong> userids are entered in this table with corresponding LUNs. For details, refer<br />

to Linux documentation.<br />

If the system is using an F<strong>CP</strong> device that is in an intervention-required state <strong>and</strong><br />

you enter QUERY F<strong>CP</strong>, you see a response like this:<br />

A F<strong>CP</strong> 0300 intervention required.<br />

0300 is the real device number of the F<strong>CP</strong> device that needs the operator’s<br />

intervention.<br />

Note: This response will be preceded by one of the following.<br />

Response 1:<br />

If you enter QUERY F<strong>CP</strong>, QUERY F<strong>CP</strong> ACTIVE, or QUERY F<strong>CP</strong> ATTACHED <strong>and</strong><br />

there is an F<strong>CP</strong> device attached to the system, you see something like this:<br />

q fcp active<br />

F<strong>CP</strong> 0480 ATTACHED TO LINUX1 0480 CHPID 80<br />

F<strong>CP</strong> 0481 ATTACHED TO LINUX2 0481 CHPID 80 USERACCESSID = userid<br />

F<strong>CP</strong> 0482 ATTACHED TO LINUX2 0482 CHPID 80<br />

F<strong>CP</strong> 0700 ATTACHED TO TEST1 0500 CHPID F1<br />

F<strong>CP</strong> 0701 ATTACHED TO TEST2 0500 CHPID F1<br />

Ready;<br />

The first number is the real device number of the F<strong>CP</strong> device. The ATTACHED<br />

oper<strong>and</strong> might also read BOX/ATTC, which means that although the device is<br />

attached <strong>and</strong> dedicated to a user, it is unavailable. LINUX1, LINUX2, TEST1, <strong>and</strong><br />

TEST2 are user IDs to which the F<strong>CP</strong> devices are dedicated. The number following<br />

the user IDs is the virtual device number which each virtual machine uses to refer<br />

to an F<strong>CP</strong> device. The number following the CHPID is the real CHPID (channel<br />

path ID) associated with the device.<br />

If the F<strong>CP</strong> subchannel being displayed was attached using the Attach<br />

USERACCESSID option, the USERACCESSID will be displayed as part of the<br />

response.<br />

Response 2:<br />

If you enter a QUERY F<strong>CP</strong> FREE comm<strong>and</strong> <strong>and</strong> there is a free F<strong>CP</strong> device<br />

attached to the system, you see something like this:<br />

q fcp free<br />

F<strong>CP</strong> 0487 FREE , F<strong>CP</strong> 04A1 FREE , F<strong>CP</strong> 04A2 FREE , F<strong>CP</strong> 04A3 FREE<br />

F<strong>CP</strong> 04A4 FREE , F<strong>CP</strong> 04A5 FREE , F<strong>CP</strong> 04A9 FREE , F<strong>CP</strong> 04AA FREE<br />

F<strong>CP</strong> 04AB FREE , F<strong>CP</strong> 04BC FREE , F<strong>CP</strong> 04BD FREE , F<strong>CP</strong> 04BE FREE<br />

F<strong>CP</strong> 04BF FREE<br />

Ready;<br />

This response shows the real device number for each free F<strong>CP</strong> device.<br />

The response for a QUERY F<strong>CP</strong> OFFLINE or QUERY F<strong>CP</strong> BOXED comm<strong>and</strong> is in<br />

the same format as the response for a QUERY F<strong>CP</strong> FREE comm<strong>and</strong>.<br />

Response 3:<br />

796 z/<strong>VM</strong>: <strong>CP</strong> <strong>Comm<strong>and</strong>s</strong> <strong>and</strong> <strong>Utilities</strong> <strong>Reference</strong>

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!