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.

Responses<br />

4. If you try to define a minimum abbreviation that matches the abbreviation for an<br />

existing comm<strong>and</strong>, subcomm<strong>and</strong>, or alias <strong>CP</strong> rejects your DEFINE comm<strong>and</strong>.<br />

For example, if you created a “QUEUE” alias with a minimum abbreviation of 2,<br />

<strong>CP</strong> would reject your QUEUE alias because “QU” is an abbreviation for the<br />

QUERY comm<strong>and</strong>. In this case, you would need to specify a minimum<br />

abbreviation greater than or equal to 4 because the first 3 characters of QUERY<br />

<strong>and</strong> QUEUE are identical.<br />

5. If you do not specify the ENABLE oper<strong>and</strong>, the new alias is initially in a disabled<br />

state. To activate an alias after defining it, use the ENABLE COMMAND or CMD<br />

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

Note that both the alias you define <strong>and</strong> its base comm<strong>and</strong> must be enabled for<br />

the alias to work. For example, if you define alias SHOWIT for the existing<br />

comm<strong>and</strong> DISPLAY, DISPLAY is considered the base comm<strong>and</strong>. DISPLAY must<br />

also be enabled for the alias SHOWIT to work.<br />

6. To deactivate an alias after defining it, use the DISABLE COMMAND or CMD<br />

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

If you specify the name of an alias on DISABLE COMMAND, then just the alias<br />

is disabled. If you specify the name of the base comm<strong>and</strong> on DISABLE<br />

COMMAND then you disable the entire function. That means that the base<br />

comm<strong>and</strong> is in a disabled state <strong>and</strong> every alias you have defined for that<br />

comm<strong>and</strong> is treated as if it were also disabled.<br />

7. To obtain information such as the enable/disable status <strong>and</strong> the name of the<br />

base comm<strong>and</strong> for the alias you have defined, use the QUERY <strong>CP</strong>CMDS<br />

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

8. Once defined, an alias name cannot be used again. An alias cannot be modified<br />

or eliminated; it can only be disabled. Only a SHUTDOWN or RESTART IPL will<br />

eliminate an alias.<br />

9. For more information about creating an alias, see the z/<strong>VM</strong>: <strong>CP</strong> Exit<br />

Customization book.<br />

Response 1:<br />

To define GOODNIGHT as an alias for the <strong>CP</strong> SHUTDOWN comm<strong>and</strong> <strong>and</strong> make it<br />

available immediately, enter the following:<br />

def alias goodnight for shutdown abbrevlength 5 enable<br />

Ready;<br />

Response 2:<br />

To define TELL as an alias for the <strong>IBM</strong> class version of the <strong>CP</strong> MESSAGE<br />

comm<strong>and</strong> <strong>and</strong> make it available immediately, enter the following:<br />

define alias tell for message ibmclass 0 enable<br />

Ready;<br />

Response 3:<br />

To define NUKE as an alias for all of the <strong>IBM</strong> class versions of the <strong>CP</strong> PURGE<br />

comm<strong>and</strong> <strong>and</strong> make it available immediately, enter the following:<br />

define alias nuke for purge ibmclass * enable<br />

Ready;<br />

DEFINE ALIAS<br />

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

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

Saved successfully!

Ooh no, something went wrong!