Create a device description

The device description specifies a default location for key storage. You can create a device description with or without naming any key store files.

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://server-name:2001, can create a device description for you, or you can create a device description yourself by using the Create Device Crypto CL command.

To create a device description using the Basic configuration wizard, follow these steps:

  1. Point your web browser to the System Tasks page: http://server-name:2001
  2. Click on Cryptographic Coprocessor configuration.
  3. Click on the button labeled Start secure session.
  4. Click Basic configuration wizard.
  5. Click continue on the Welcome page.
  6. Click on the list entry with the device name set to *CREATE for the resource you want to use.
  7. Continue as instructed by the Basic configuration wizard.

Create a device desription using CL

To create a device description using the CL command, follow these steps:

  1. Type CRTDEVCRP at the CL command line
  2. 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.
  3. Specify the name of a default PKA key store file or let the parameter default to *NONE.
  4. Specify the name of a default DES key store file or let the parameter default to *NONE.
  5. Optional: Specify a description as prompted.
  6. Use either the Vary Configuration (VRYCFG) or the Work with Configuration Status (WRKCFGSTS) CL commands to vary on the device once you have created the device description. This typically takes one minute, but it may take ten minutes to complete.
Note: The APPTYPE defaults to *CCA, so you do not need to specify it on the Create command. However, if you have changed it to another value, you need to change it back to *CCA before the device can vary on.

You have now completed creation of the device description.