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.

Usage Notes<br />

specific <strong>IBM</strong> class associated with the specified <strong>CP</strong> comm<strong>and</strong>. The variable c is<br />

the <strong>IBM</strong>-defined privilege class A, B, C, D, E, F, or G.<br />

<strong>IBM</strong>class 0<br />

specifies that you only want to find the comm<strong>and</strong> table entry blocks for <strong>CP</strong><br />

comm<strong>and</strong>s with no assigned <strong>IBM</strong> class. Only comm<strong>and</strong>s with privilege class<br />

“ANY” have no assigned <strong>IBM</strong> class.<br />

1. For each comm<strong>and</strong>, <strong>CP</strong> has at least 1 comm<strong>and</strong> table entry block. If the<br />

comm<strong>and</strong> has more than 1 <strong>IBM</strong> class, <strong>CP</strong> has 1 comm<strong>and</strong> table entry block<br />

for each version of the comm<strong>and</strong>. For example, the DEFINE comm<strong>and</strong> has 3<br />

<strong>IBM</strong> classes: A, E, <strong>and</strong> G. To locate the comm<strong>and</strong> table entry block for the<br />

DEFINE GRAF comm<strong>and</strong>, you want the comm<strong>and</strong> table entry block for the<br />

class G DEFINE comm<strong>and</strong>:<br />

locate cmdbk define ibmclass g<br />

The only exceptions to this are the QUERY <strong>and</strong> SET comm<strong>and</strong>s. <strong>CP</strong> has at<br />

least 1 comm<strong>and</strong> table entry block for each QUERY <strong>and</strong> SET subcomm<strong>and</strong>. To<br />

locate the comm<strong>and</strong> table entry block for the QUERY TIMEZONES<br />

subcomm<strong>and</strong>, you would issue 1 of the following comm<strong>and</strong>s:<br />

locate cmdbk query subcmd timezones<br />

locate cmdbk query subcmd timezones ibmclass g<br />

2. You can use the minimum abbreviation of the comm<strong>and</strong> or subcomm<strong>and</strong><br />

name. For example, issuing either of the following comm<strong>and</strong>s produces the<br />

same results:<br />

locate cmdbk query subcmd privclass<br />

locate cmdbk q subcmd priv<br />

3. To define a new <strong>CP</strong> comm<strong>and</strong> or a new version (by <strong>IBM</strong> class) of an existing<br />

<strong>CP</strong> comm<strong>and</strong>, use the DEFINE COMMAND or CMD comm<strong>and</strong> (page 134).<br />

4. To define a new alias for an existing <strong>CP</strong> comm<strong>and</strong>, use the DEFINE ALIAS<br />

comm<strong>and</strong> (page 119).<br />

5. To load the comm<strong>and</strong> processing code into <strong>CP</strong>’s system execution space, use<br />

the <strong>CP</strong>XLOAD comm<strong>and</strong> (page 101).<br />

6. To activate a <strong>CP</strong> comm<strong>and</strong>:<br />

v While defining it, use the ENABLE oper<strong>and</strong> of the DEFINE COMMAND or<br />

CMD comm<strong>and</strong> (page 134).<br />

v After defining it, use the ENABLE COMMAND or CMD comm<strong>and</strong> (page<br />

426).<br />

7. To change the definition of an existing <strong>CP</strong> comm<strong>and</strong>, use the MODIFY<br />

COMMAND comm<strong>and</strong> (page 599).<br />

8. To deactivate a <strong>CP</strong> comm<strong>and</strong>:<br />

LOCATE CMDBK<br />

v While defining it, use the DISABLE oper<strong>and</strong> of the DEFINE COMMAND or<br />

CMD comm<strong>and</strong> (page 134).<br />

v After defining it, use the DISABLE COMMAND or CMD comm<strong>and</strong> (page<br />

263).<br />

9. To remove the comm<strong>and</strong> processing code from <strong>CP</strong>’s system execution space,<br />

use the <strong>CP</strong>XUNLOAD comm<strong>and</strong> (page 107).<br />

10. For more information about user-defined comm<strong>and</strong>s, see the z/<strong>VM</strong>: <strong>CP</strong> Exit<br />

Customization book.<br />

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

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

Saved successfully!

Ooh no, something went wrong!