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

LOCATE VMDBK
LOCATE VMDBK
►►
LOCate
Authorization
Purpose
Operands
VMDBK
Usage Notes
Responses
userid
*
Privilege Classes: C, E
Use LOCATE VMDBK to display the address of a user’s virtual machine definition
block (VMDBK).
userid
specifies the user ID (or user ID pattern) whose VMDBK entries CP should
locate. If you use the VMDBK keyword, CP supports pattern matching as
described below in Usage Note 1.
* tells CP to locate the VMDBK entry for your user ID.
1. Pattern matching follows the rules used by the CMS LISTFILE command. Use
an asterisk (*) to match any number of characters; Use a percent symbol (%) to
match any single character.
2. There are several LOCATE commands (LOCATE RDEV, LOCATE SYMBOL,
LOCATE VMDBK) that treat the qualifying keyword on locate as optional. The
use of a keyword on this LOCATE command is recommended to avoid
undesired results.
Response 1:
If you enter a LOCATE VMDBK command with the VMDBK keyword, you may see
something like this:
locate vmdbk cptest*
Userid VMDBK Type
CPTEST1 05ADD000 ORIGIN
CPTEST1 06BCF000 MP
CPTEST2 07BDF000 ORIGIN
CPTEST3 03BCE000 ORIGIN
Ready;
This response shows the VMDBKs for each of the virtual processors specified. If
more than one VMDBK is displayed for the same user ID, there are multiple virtual
processors defined for that user ID’s virtual machine. One will be labeled ORIGIN;
the rest will be labeled MP, short for multiple processor.
Response 2:
562 z/VM: CP Commands and Utilities Reference
If you specify LOCATE without the VMDBK keyword, you may see this:
►◄