Change Device Desc (Crypto) (CHGDEVCRP)

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

Parameters

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

Device description (DEVD)

Specifies the name of the device description.

This is a required parameter.

Top

Resource name (RSRCNAME)

Specifies the resource name that identifies the hardware that the description represents.

*SAME
The value does not change.
resource-name

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

Application type (APPTYPE)

Specifies the application that runs inside of the secure computing environment on the cryptographic device.

*SAME
The value does not change.
*CCA

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.

*CCAUDX

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.

*NONE

The cryptographic device does not support flash memory applications.

Note: This value is valid only for 2058 device type.

Top

Online at IPL (ONLINE)

Specifies whether this object is automatically varied on at initial program load (IPL).

*SAME
The value does not change.
*YES

This device is varied on automatically at IPL.

*NO

This device is not varied on automatically at IPL.

Top

Message queue (MSGQ)

Specifies the message queue to which operational messages for this device are sent.

Single values

*SAME

The message queue to which messages are sent remains the same.

*SYSOPR
Messages are sent to the system operator message queue (QSYS/QSYSOPR).
*SYSVAL

The messages are sent to the message queue specified by the system value QCFGMSGQ.

Other values

message-queue-name

Specify the name of the message queue to which operational messages are sent.

Qualifier 2: Library

*LIBL

All libraries in the job's library list are searched until the first match is found.

*CURLIB

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.

library-name

Specify the name of the library to be searched.

Top

PKA key store file (PKAKEYFILE)

Specifies the name of the database file containing the PKA (Public Key Algorithm) keys.

Single values

*SAME
The value does not change.
*NONE

No default PKA key database is used.

Other values

PKA-key-store-file-name

Specifies the name of the default PKA key database.

The possible library values are:

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is searched.
library-name
Specify the library where the object is located.
Top

DES key store file (DESKEYFILE)

Specifies the name of the database file containing the DES (Data Encryption Standard) keys used for this device.

Single values

*SAME
The value does not change.
*NONE

No default DES key database is used.

Other values

DES-key-store-file-name

Specifies the name of the default DES key database.

The possible library values are:

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is searched.
library-name
Specify the library where the object is located.
Top

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

*SAME
The text (if any) does not change.
*BLANK
No text is specified.
character-value
Specify no more than 50 characters of text, enclosed in apostrophes.
Top

Examples

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

Error messages

*ESCAPE Messages

CPF2618
Device description &1 not changed.
Top