CPYTOMSD

La commande Copier vers un vidage de la mémoire principale (CPYTOMSD) copie un vidage de la mémoire principale (MSD) vers la bibliothèque MSD du code interne sous licence (LIC), depuis un fichier STREAM. Le MSD du LIC ajoute un vidage de la mémoire principale supplémentaire et lui affecte un nouvel identificateur de vidage à chaque exécution réussie de CPYTOMSD. The Copy To Main Storage Dump (CPYTOMSD) command copies a main storage dump (MSD) to the Licensed Internal Code (LIC) MSD library from a stream file. The LIC MSD will add an additional main storage dump and assign a new main storage dump identifier each time CPYTOMSD is performed successfully.

Restrictions:

• Pour utiliser cette commande, vous devez posséder le droit spécial *SERVICE, ou être autorisé à la fonction de vidage de service du système d'exploitation via la prise en charge de l'administration des applications d'IBM System i Navigator. La commande Modifier l'utilisation d'une fonction (CHGFCNUSG) avec l'ID de fonction QIBM_SERVICE_DUMP peut également servir à modifier la liste des utilisateurs autorisés à effectuer des opérations de vidage. To use this command, you must have *SERVICE special authority, or be authorized to the Service Dump function of the operating system through IBM System i Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command with a function ID of QIBM_SERVICE_DUMP can also be used to change the list of users that are allowed to perform dump operations.
• Le profil utilisateur qui utilise la commande CPYTOMSD doit être lié à un ID utilisateur des outils de service disposant du privilège approprié pour la fonction de vidage de la mémoire principale. The user profile using the CPYTOMSD command must be linked to a Service Tools User ID with the proper privilege to the Main Storage Dump function.
• The user must have the following authorities:
  • Droit d'exécution (*X) sur les répertoires du préfixe du chemin d'accès du fichier STREAM. Execute (*X) authority to directories in the path name prefix of the stream file.
  • Droit de lecture (*R) sur le fichier STREAM. Read (*R) authority to the stream file.

Paramètres

Fichier STREAM d'origine (FROMSTMF)

Indique le chemin d'accès du fichier STREAM depuis lequel les données du vidage de la mémoire principale sont copiées. Specifies the path name of the stream file from which the main storage dump data is copied.

Pour plus d'informations sur l'indication des chemins d'accès, voir « Règles de dénomination des objets » dans l'ensemble de rubriques CL de la catégorie Programmation de l'IBM i Information Center à l'adresse http://www.ibm.com/systems/i/infocenter/. For more information on specifying path names, refer to "Object naming rules" in the CL topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.

Texte 'descriptif' (DESC)

Indique la description à utiliser pour le vidage de la mémoire principale. Specifies the description to be used for the main storage dump.

*STMF

La description associée au fichier STREAM. Il s'agit de la description fournie par le gestionnaire de vidage de la mémoire principale (LIC MSD) du code interne sous licence lors de la création du fichier STREAM. The description associated with the stream file. It is the description that was provided by the Licensed Internal Code Main Storage Dump (LIC MSD) Manager when the stream file was created.

valeur-caractère

Indiquez 32 caractères de texte au maximum, entre apostrophes. Specify no more than 32 characters of text, enclosed in apostrophes.

Exemples

CPYTOMSD FROMSTMF('/MY_MSDs/MSD0001') DESC('System crash')

Cette commande copie les données contenues dans le fichier STREAM /MY_MSDs/MSD0001 vers la bibliothèque du vidage de la mémoire principale du code interne sous licence (LIC MSD) et affecte 'System crash' comme description du vidage de la mémoire principale. This command copies the data contained in stream file /MY_MSDs/MSD0001 to the Licensed Internal Code Main Storage Dump (LIC MSD) library and assigns 'System crash' for the main storage dump description.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF7206

&4 s'est terminé anormalement. Code fin &2, qualificatif &3. &4 ended abnormally. Completion code &2 qualifier &3.

CPF7215

Les outils de service système sont déjà actifs dans ce processus. System Service Tools already active in this process.

CPF7218

Non autorisé à exécuter la commande &2. Not authorized to run &2 command.

CPFA0D4

Une erreur s'est produite dans le système de fichiers. Code erreur &1.