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.

DEFINE CRYPTO<br />

►►<br />

DEFine<br />

Authorization<br />

Purpose<br />

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

CRYPto<br />

Usage Notes<br />

ALL<br />

▼<br />

nn<br />

nn1-nn2<br />

Privilege Class: G<br />

Use DEFINE CRYPTO to add a cryptographic facility to one or two <strong>CP</strong>Us in your<br />

virtual machine configuration.<br />

ALL<br />

specifies that the maximum of two cryptographic facilities are to be defined,<br />

each corresponding to a <strong>CP</strong>U in your virtual machine configuration. Virtual<br />

crypto facilities will be defined starting with the first <strong>CP</strong>U defined for your virtual<br />

machine configuration <strong>and</strong> continuing until a maximum of two crypto facilities<br />

are defined.<br />

nn is a single virtual <strong>CP</strong>U address. The address can be any value from 0 to 3F,<br />

providing a <strong>CP</strong>U with the same address has been defined. You can specify<br />

multiple addresses in the form of a list of single numbers. Virtual crypto facilities<br />

will be defined for the virtual <strong>CP</strong>Us in the order specified until a maximum of<br />

two crypto facilities are defined for the virtual machine configuration.<br />

nn1-nn2<br />

is a nonwrapping pair of virtual <strong>CP</strong>U addresses separated by a hyphen <strong>and</strong> not<br />

separated by any blanks. The addresses can be any values from 0 to 3F,<br />

providing <strong>CP</strong>Us with the same addresses have been defined. Virtual crypto<br />

facilities will be defined for the virtual <strong>CP</strong>Us in the order specified until a<br />

maximum of two crypto facilities are defined for the virtual machine<br />

configuration.<br />

1. A cryptographic facility must be installed on the real machine.<br />

DEFINE CRYPTO<br />

2. The directory must allow your virtual machine to use the cryptographic facility,<br />

by means of the CRYPTO directory control statement.<br />

3. A maximum of two virtual crypto facilities may be defined for a virtual machine<br />

configuration. When multiple virtual <strong>CP</strong>Us are specified, virtual crypto facilities<br />

will be defined for virtual <strong>CP</strong>Us until the maximum of two crypto facilities are<br />

defined.<br />

4. If you define a new virtual crypto facility for a virtual <strong>CP</strong>U currently dedicated to<br />

a real processor without an installed crypto facility, the virtual <strong>CP</strong>U will have to<br />

be rededicated (UNDEDICATE <strong>and</strong> then DEDICATE) to a processor with a real<br />

crypto facility.<br />

►◄<br />

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

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

Saved successfully!

Ooh no, something went wrong!