CHGDEVCRP (Change Device Description (Crypto))

CHGDEVCRP Command syntax diagram

 

Purpose

The Change Device Description (Crypto) (CHGDEVCRP) command changes the device description for a cryptographic device.

 

Required Parameters

DEVD
Specifies the name of the device description being changed.

 

Optional Parameters

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.

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

*SAME: The value does not change.

*YES: The device is automatically varied on at IPL.

*NO: This device is not automatically varied on at IPL.

Begin of change

MSGQ
Specifies the name of the message queue to which messages are sent. More information about using this parameter is in the Communications Management Link to PDF book.

*SAME: The value does not change.

*SYSVAL: Messages are sent to the message queue specified in the system value QCFGMSGQ.

*SYSOPR: Messages are sent to the QSYSOPR message queue in library QSYS.

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

The name of the message queue can be qualified by one of the following library values:

*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.

PKAKEYFILE
Specifies the PKA key store database file to use with this device.

*SAME: The value does not change.

The possible library values are:

*LIBL: The library list is used to locate the key store database file.

*CURLIB: The current library for the job is used to locate the key store database file. 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 where the key store database file is located.

PKA-key-store-file-name: Specify the name of the key store database file to use with this device.

DESKEYFILE
Specifies the DES key store database file to use with this device.

*SAME: The value does not change.

The possible library values are:

*LIBL: The library list is used to locate the key store database file.

*CURLIB: The current library for the job is used to locate the key store database file. 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 where the key store database file is located.

DES-key-store-file-name: Specify the name of the key store database file to use with this device.

TEXT
Specifies the text that briefly describes the device description. More information is in Commonly used parameters.

*SAME: The value does not change.

*BLANK: Text is not specified.

'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Example for CHGDEVCRP 

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.

Error messages for CHGDEVCRP

*ESCAPE Messages

None.