Change Device Desc (Crypto) (CHGDEVCRP)

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 being changed.

This is a required parameter.

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 cryptographic device hardware on the system.
Note: Use the Work with Hardware Resources (WRKHDWRSC) command with TYPE(*CRP) specified to determine the resource name.

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 and 4764 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 and 4764 device types.
*NONE: The cryptographic device does not support flash memory applications.
Note: This value is valid only for 2058 device type.

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.

Message queue (MSGQ)

Specifies the qualified name of the message queue to which messages 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 (message queue QSYSOPR in library QSYS).
*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.

PKA key store file (PKAKEYFILE)

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

Single values

*SAME: The PKA key database file value does not change.
*NONE: No PKA key database file is specified.

Other values

PKA-key-store-file-name: Specify the name of the default PKA key database file.

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.

DES key store file (DESKEYFILE)

Specifies the name of the database file containing the DES (Data Encryption Standard) keys.

Single values

*SAME: The DES key database file value does not change.
*NONE: No DES key database file is specified.

Other values

DES-key-store-file-name: Specify the name of the default DES key database file.

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.

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.