ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzajc_5.4.0.1/rzajcdevicedescript.htm

89 lines
5.9 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="task" />
<meta name="DC.Title" content="Create a device description" />
<meta name="abstract" content="The device description specifies a default location for key storage. You can create a device description with or without naming any key store files." />
<meta name="description" content="The device description specifies a default location for key storage. You can create a device description with or without naming any key store files." />
<meta name="DC.Relation" scheme="URI" content="rzajcsetup.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="devicedescript" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>Create a device description</title>
</head>
<body id="devicedescript"><a name="devicedescript"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Create a device description</h1>
<div><p>The device description specifies a default location for key storage.
You can create a device description with or without naming any key store files.</p>
<div class="section"> <p>You must create a device description for your Cryptographic Coprocessor
on your server. The device description is used by CCA CSP to help direct cryptographic
requests to the Coprocessor. Additionally, the device description gives your
Coprocessor a default location for key store file storage. The Basic configuration
wizard in the Cryptographic Coprocessor configuration utility, found off of
the System Tasks page at http://<var class="varname">server-name</var>:2001,
can create a device description for you, or you can create a device description
yourself by using the <span class="cmdname">Create Device Crypto CL</span> command.</p>
<p>To
create a device description using the Basic configuration wizard, follow these
steps:</p>
</div>
<ol><li><span>Point your web browser to the System Tasks page: <kbd class="userinput">http://<var class="varname">server-name</var>:2001</kbd></span></li>
<li><span>Click on Cryptographic Coprocessor configuration.</span></li>
<li><span>Click on the button labeled <span class="uicontrol">Start secure session.</span></span></li>
<li><span>Click <span class="uicontrol">Basic configuration</span> wizard.</span></li>
<li><span>Click <span class="uicontrol">continue</span> on the <span class="uicontrol">Welcome</span> page.</span></li>
<li><span>Click on the list entry with the device name set to <kbd class="userinput">*CREATE</kbd> for
the resource you want to use.</span></li>
<li><span>Continue as instructed by the Basic configuration wizard.</span></li>
</ol>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzajcsetup.htm" title="Configuring your Cryptographic Coprocessor allows you to begin to use all of its cryptographic operations.">Configure the Cryptographic Coprocessor</a></div>
</div>
</div><div class="nested1" xml:lang="en-us" id="createadevicedesriptionusingcl"><a name="createadevicedesriptionusingcl"><!-- --></a><h2 class="topictitle2">Create a device desription using CL</h2>
<div><div class="section"><p>To create a device description using the CL command, follow these
steps: </p>
</div>
<ol><li class="stepexpand"><span>Type <kbd class="userinput">CRTDEVCRP</kbd> at the CL command line</span></li>
<li class="stepexpand"><span>Specify a name for the device as prompted. If you want to set up
a default device, name the device CRP01. Otherwise, each application you create
must use the Cryptographic Resource Allocate (CSUACRA) API in order to access
your device description.</span></li>
<li class="stepexpand"><span>Specify the name of a default PKA key store file or let the parameter
default to <kbd class="userinput">*NONE</kbd>.</span></li>
<li class="stepexpand"><span>Specify the name of a default DES key store file or let the parameter
default to <samp class="codeph"><kbd class="userinput"></kbd>*NONE</samp>.</span></li>
<li class="stepexpand"><strong>Optional: </strong><span>Specify a description as prompted.</span></li>
<li class="stepexpand"><span>Use either the <span class="cmdname">Vary Configuration (VRYCFG) </span> or
the <span class="cmdname">Work with Configuration Status (WRKCFGSTS)</span> CL commands
to vary on the device once you have created the device description.</span> This typically takes one minute, but it may take ten minutes to
complete.</li>
</ol>
<div class="section"><div class="note"><span class="notetitle">Note:</span> The APPTYPE defaults to *CCA, so you do not need to specify
it on the <span class="uicontrol">Create</span> command. However, if
you have changed it to another value, you need to change it back to *CCA before
the device can vary on. </div>
<p>You have now completed creation of the device
description.</p>
</div>
</div>
</div>
</body>
</html>