Display Keystore File Entry (DSPCKMKSFE)
| Where allowed to run: All environments (*ALL) Threadsafe: Conditional |
Parameters Examples Error messages |
The Display Keystore File Entry (DSPCKMKSFE) command returns the key attributes for a key record in a keystore file. The key attributes include the key type, the key size, the id of the master key under which the stored key value is encrypted, the key verification value (KVV) for the master key, and the date the record was added or last translated.
For more information on keystore files, refer to the Cryptographic services key management section of the Security category in the IBM Systems Information Center at http://www.ibm.com/systems/infocenter/.
Restrictions:
- You must have object operational (*OBJOPR) and read (*READ) authorities to the keystore file.
- This command is not threadsafe when run in an interactive job and OUTPUT(*) is specified or defaulted.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| KEYSTORE | Keystore file | Qualified object name | Required, Positional 1 |
| Qualifier 1: Keystore file | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| RCDLBL | Record label | Character value | Required, Positional 2 |
| OUTPUT | Output | Optional |
| Top |
Keystore file (KEYSTORE)
Specifies the keystore file to use.
This is a required parameter.
Qualifier 1: Keystore file
- name
- Specify the name of the keystore file.
Qualifier 2: Library
- *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.
- name
- Specify the name of the library to search for the file.
| Top |
Record label (RCDLBL)
Specifies the label of a key record in the specified keystore file.
This is a required parameter.
- character-value
- Specify the key record label. The label is 32 characters and may contain any alphanumeric characters.
| Top |
Output (OUTPUT)
Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
- *
- The output is displayed for interactive jobs or printed with the job's spooled output for non-interactive jobs.
- The output is printed with the job's spooled output.
| Top |
Examples
DSPCKMKSFE KEYSTORE(MYLIB/MYKEYSTORE) RCDLBL('Byllesby')
OUTPUT(*PRINT)
This command prints the attributes for the key record named Byllesby located in keystore file MYKEYSTORE in library MYLIB.
| Top |
Error messages
*ESCAPE Messages
- CPF3CF2
- Error(s) occurred during running of &1 API.
- CPF9872
- Program or service program &1 in library &2 ended. Reason code &3.
- CPF9D9F
- User not authorized to key store file.
- CPF9DA0
- Error opening key store file.
- CPF9DA1
- Key record not found.
- CPF9DA5
- Key store file not found.
- CPF9DA6
- Key store file is not available.
- CPF9DA7
- File is corrupt or not a valid key store file.
- CPF9DB3
- Qualified keystore file name is not valid.
- CPF9DB6
- Record label not valid.
- CPF9DB8
- Error occured reading record from key store.
| Top |