| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Device Description (Crypto) (CHGDEVCRP) command changes the 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, *SAME, *NONE | Optional |
| APPTYPE | Application type | *SAME, *CCA, *CCAUDX, *NONE | Optional |
| ONLINE | Online at IPL | *SAME, *YES, *NO | Optional |
| MSGQ | Message queue | Single values: *SAME, *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: *SAME, *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: *SAME, *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, *SAME, *BLANK | Optional |
| Top |
Specifies the name of the device description.
This is a required parameter.
| Top |
Specifies the resource name that identifies the hardware that the description represents.
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 varied on automatically at IPL.
This device is not varied on automatically at IPL.
| Top |
Specifies the message queue to which operational messages for this device are sent.
Single values
The message queue to which messages are sent remains the same.
The messages are sent to the message queue specified by the system value QCFGMSGQ.
Other values
Specify the name of the message queue to which operational messages are sent.
Qualifier 2: Library
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 |
CHGDEVCRP DEVD(CRP01) ONLINE(*YES)
This command changes the device description of a cryptographic that is named CRP01 so that the device is automatically varied on at IPL.
| Top |
| Top |