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

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

QUERY CFLINKS<br />

►►<br />

Query<br />

Authorization<br />

Purpose<br />

Oper<strong>and</strong>s<br />

CFLINKs<br />

Usage Notes<br />

Responses<br />

ALL<br />

NAME<br />

Privilege Class: A, B, G<br />

QUERY CFLINKS allows a guest to display information pertaining to links between<br />

coupling facilities.<br />

ALL<br />

specifies that coupling facility to coupling facility link information should be<br />

displayed for all coupling facility virtual machines to which the issuer is coupled.<br />

NAME msgprocid<br />

indicates a specific coupling facility virtual machine that is to be queried.<br />

1. If the caller is a class G user, then only coupling facility-to-coupling link<br />

information for message processors within the user’s current I/O configuration is<br />

displayed. A class A or B user may display coupling facility link information for a<br />

particular message processors by using the NAME keyword.<br />

2. QUERY CFLINK returns information about the coupling facility-to-coupling<br />

facility links that were created by the DEFINE CFLINK comm<strong>and</strong> or the<br />

SPECIAL MSGP Directory Control Statement for a coupling facility virtual<br />

machine. The QUERY MSGP comm<strong>and</strong> may be used to obtain information for<br />

coupling links between OPTION CFUSER <strong>and</strong> coupling facility virtual machines.<br />

The comm<strong>and</strong> first produces two lines of output describing the queried coupling<br />

facility virtual machine:<br />

MESSAGE PROCESSOR=nn USERID=userid PEERS=pp<br />

TYPE=SIMDEV MODEL=001 MFG=<strong>IBM</strong> PLANT=EN SEQ=ND01<br />

where:<br />

msgprocid<br />

nn is a sequence number assigned to the coupling facility virtual machine by<br />

QUERY CFLINKS.<br />

userid<br />

is the user ID of the coupling facility virtual machine being queried.<br />

QUERY CFLINKS<br />

pp is either the number of sender peers or the number of receiver peers of this<br />

coupling facility, whichever is greater.<br />

TYPE<br />

is the six-character device type in the worldwide unique ID of the message<br />

processor’s node descriptor.<br />

►◄<br />

Chapter 2. <strong>CP</strong> <strong>Comm<strong>and</strong>s</strong> 701

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

Saved successfully!

Ooh no, something went wrong!