Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Create Device Description (Crypto) (CRTDEVCRP) command creates a device description for a cryptographic device.
Restriction: You must have input/output system configuration (*IOSYSCFG) special authority to use this command.
Top |
Keyword | Description | Choices | Notes |
---|---|---|---|
DEVD | Device description | Name | Required, Key, Positional 1 |
RSRCNAME | Resource name | Name, *NONE | Required, Key, Positional 2 |
APPTYPE | Application type | *CCA, *CCAUDX, *NONE | Optional |
ONLINE | Online at IPL | *NO, *YES | Optional |
MSGQ | Message queue | Single values: *SYSVAL, *SYSOPR Other values: Qualified object name |
Optional |
Qualifier 1: Message queue | Name | ||
Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
PKAKEYFILE | PKA key store file | Single values: *NONE Other values: Qualified object name |
Optional |
Qualifier 1: PKA key store file | Name | ||
Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
DESKEYFILE | DES key store file | Single values: *NONE Other values: Qualified object name |
Optional |
Qualifier 1: DES key store file | Name | ||
Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
TEXT | Text 'description' | Character value, *BLANK | Optional |
AUT | Authority | Name, *CHANGE, *ALL, *USE, *EXCLUDE, *LIBCRTAUT | Optional |
Top |
Top |
Specifies the resource name that identifies the hardware that the description represents.
No resource name is specified. A resource name must be provided before the device can be varied on.
Specify the name that identifies the crypto device hardware on the system.
Note: Use the Work with Hardware Resources (WRKHDWRSC) command with TYPE(*CRP) specified to determine the resource name.
Top |
Specifies the application that runs inside of the secure computing environment on the cryptographic device.
The flash memory in the cryptographic device is initialized with the Common Cryptographic Architecture (CCA) application.
Note: This value is valid only for 4758, 4764 and 4765 device types.
The flash memory in the cryptographic device is initialized only if the system does not detect the CCA application or a CCA User Defined Extension (UDX) application within the flash memory of the device.
Note: This value is valid only for 4758, 4764 and 4765 device types.
The cryptographic device does not support flash memory applications.
Note: This value is valid only for 2058 device type.
Top |
Specifies whether this object is automatically varied on at initial program load (IPL).
This device is not varied on automatically at IPL.
This device is varied on automatically at IPL.
Top |
Specifies the message queue to which operational messages for this device are sent.
The possible qualified names are:
The messages are sent to the message queue specified by the system value QCFGMSGQ.
Specify the name of the message queue to which operational messages are sent.
All libraries in the job's library list are searched until the first match is found.
The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
Specify the name of the library to be searched.
Top |
Specifies the name of the database file containing the PKA (Public Key Algorithm) keys.
Single values
No default PKA key database is used.
Other values
Specifies the name of the default PKA key database.
The possible library values are:
Top |
Specifies the name of the database file containing the DES (Data Encryption Standard) keys used for this device.
Single values
No default DES key database is used.
Other values
Specifies the name of the default DES key database.
The possible library values are:
Top |
Specifies the text that briefly describes the object.
Top |
Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
Top |
CRTDEVCRP DEVD(CRP01) RSRCNAME(CRP01)
This command creates a device description for a cryptographic device that is named CRP01. The device type is determined from the resource name.
Top |
Top |