Note on usage
Function: Update public keys
User group: FT administrator
Alias name: FTUPDKEY
Functional description
Using the UPDATE-FT-PUBLIC-KEYS command, you can newly create the public key files of the key pair sets present in your openFT instance. This may become necessary if the existing public key files are unintentionally deleted. In addition, the command imports updated comments from SYSPKF.COMMENT to the public key files (see below).
The key pair consists of a private key, which is administered internally by openFT, and a public key.
Public keys are stored on the configuration user ID of the openFT instance (default: $SYSFJAM) under the name:
SYSPKF.R<key reference>.L<key length>:
The key reference is a numeric designator for the version of the key pair. Following installation, the key length is 2048 bits by default. The public key files are text files that are created in the character code of the respective operating system, i.e. EBCDIC.DF04-1 for BS2000, IBM1047 for z/OS, ISO8859-1 for Unix systems and CP1252 for Windows systems.
In a file SYSPKF.COMMENT on the configuration user ID of the openFT instance, you can store comments that are written in the first lines of this file when an existing public key file is updated. Such comments might contain, for example, the communications partner and the telephone number of the FT administrator on duty. The lines in the SYSPKF.COMMENT file may be a maximum of 78 characters in length.
Public key files with invalid key reference are automatically deleted (for example, public keys, for which openFT no longer has an internal private key).
Format
UPDATE-FT-PUBLIC-KEYS / FTUPDKEY |
Without operands
Command return codes
(SC2) | SC1 | Maincode | Meaning |
83 | 32 | CMD0221 | Internal error. |
33 | 64 | FTR1033 | The public key files could not be updated. |
35 | 64 | FTR1035 | The user is not authorized to use this command. |
SC1/2 = Subcode 1/2 in decimal notation For additional information, see section “Command return codes”. | |||