SETMSTKEY

Définir clé maître

Set Master Key

En bref

La commande Définir la clé maître (SETMSTKEY) définit la clé maître indiquée à partir des parties déjà ajoutées. The Set Master Key (SETMSTKEY) command sets the specified master key from the parts already added.

SETMSTKEY se lit SET (Définir) + MSTKEY. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

SETMSTKEY MSTKEY(…)

Paramètres

MSTKEY Clé maître Master key obligatoire

Astuce : dans une session 5250, tapez SETMSTKEY puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Oui

La commande Définir la clé maître (SETMSTKEY) définit la clé maître indiquée à partir des parties déjà ajoutées. Les parties de clé maître peuvent être ajoutées avec la commande CL Ajouter une partie de clé maître (ADDMSTPART), l'API Qc3LoadMasterKeyPart ou le panneau Gestion des clés maître de System i Navigator. Une fois cette commande exécutée avec succès, toutes les clés chiffrées sous cette clé maître doivent être retraduites. Pour sauvegarder les clés maître, une commande Sauvegarder le système (SAVSYS) doit être exécutée. The Set Master Key (SETMSTKEY) command sets the specified master key from the parts already added. Master key parts can be added with the Add Master Key Part (ADDMSTPART) CL command, the Qc3LoadMasterKeyPart API, or Manage Master Keys panel in System i Navigator. Upon successful completion of this command, any keys encrypted under this master key should be retranslated. In order to save the master keys, a Save System (SAVSYS) command must be run.

Pour plus d'informations sur les clés maîtres, consultez la section Gestion des clés des services de cryptographie de la catégorie Sécurité dans l'IBM Systems Information Center, à l'adresse http://www.ibm.com/systems/infocenter/. For more information on master keys, refer to the Cryptographic services key management section of the Security category in the IBM Systems Information Center, à l'adresse http://www.ibm.com/systems/infocenter/.

Restrictions:

Vous devez posséder les droits spéciaux sur tous les objets (*ALLOBJ) et d'administrateur de la sécurité (*SECADM) pour exécuter cette commande. You must have all object (*ALLOBJ) and security administrator (*SECADM) special authorities to run this command.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
MSTKEY	Clé maîtreMaster key	1-8, ASP, SAVRST	Obligatoire, positionnel 1

Clé maître (MSTKEY)Master key (MSTKEY)

Indique la clé maître sur laquelle effectuer l'action. Specifies the master key on which to perform the action.

Ce paramètre est obligatoire. This is a required parameter.

L'action est effectuée sur : The action will be performed on:

*ASP: La clé maître utilisée pour chiffrer les données stockées sur les disques du pool de mémoire secondaire (ASP). The master key used for encrypting data stored on auxiliary storage pool (ASP) disk storage.
*SAVRST: La clé maître utilisée pour chiffrer toutes les autres clés maîtres lors d'une opération SAVSYS. The master key used for encrypting all the other master keys on a SAVSYS operation.
1-8: L'une des huit clés maîtres à usage général. One of the eight general purpose master keys.

Exemples

SETMSTKEY   MSTKEY(3)

Cette commande déplace d'abord la version en cours de la clé maître 3 vers l'ancienne version, puis déplace la nouvelle version (composée de toutes les parties ajoutées pour la clé maître 3 depuis la dernière commande Définir la clé maître) vers la version en cours. This command first moves the current version of Master Key 3 into the old version, and then moves the new version (consisting of all parts added for Master Key 3 since the last Set Master Key) into the current version.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF222E: Le droit spécial &1 est requis.
CPF3CF2: Une ou plusieurs erreurs se sont produites pendant l'exécution de l'API &1. Error(s) occurred during running of &1 API.
CPF9872: Programme ou programme de service &1 de la bibliothèque &2 arrêté. Code raison : &3.
CPF9D88: Une erreur s'est produite pendant le post-traitement du programme d'exit. An error occurred during exit program post-processing.
CPF9D89: Une erreur s'est produite pendant le pré-traitement du programme d'exit. An error occurred during exit program pre-processing.
CPF9D90: La clé maître &1 n'a pas été définie en raison de l'annulation par un programme d'exit. Master Key &1 was not set due to an exit program cancel.
CPF9D94: Une valeur en attente existe pour une clé maître. A pending value exists for a master key.
CPF9DB0: Aucune partie de clé n'a été chargée. No key parts have been loaded.
CPF9DDA: Code retour &1 inattendu du fournisseur de services de cryptographie &2. Unexpected return code &1 from cryptographic service provider &2.