CPYFRMMSD

La commande Copier depuis un vidage de la mémoire principale (CPYFRMMSD) copie un vidage de la mémoire principale (MSD) de la bibliothèque MSD du code interne sous licence (LIC) vers un fichier STREAM. The Copy From Main Storage Dump (CPYFRMMSD) command copies a main storage dump (MSD) from the Licensed Internal Code (LIC) MSD library to a stream file.

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 CPYFRMMSD 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 CPYFRMMSD 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 d'écriture (*W) sur le fichier STREAM si le fichier STREAM existe déjà. Write (*W) authority to the stream file if the stream file already exists.
  • Droits d'écriture et d'exécution (*WX) sur le répertoire parent du fichier STREAM si le fichier STREAM n'existe pas encore. Write and execute (*WX) authority to the stream file's parent directory if the stream file does not already exist.

Paramètres

Identificateur de cliché (DUMPID)

Indique l'identificateur du vidage de la mémoire principale à copier. Specifies the identifier of the main storage dump to be copied.

*SELECT

A list of all main storage dumps available in the LIC MSD library is shown. You can select the main storage dump to copy.

Remarque : cette valeur n'est valide que lorsque la commande CPYFRMMSD est appelée de manière interactive. Note: This value is valid only when the CPYFRMMSD command is called interactively.

0-9999

Indiquez l'identificateur du vidage de la mémoire principale à copier. Specify the identifier of the main storage dump to be copied.

Fichier STREAM de destination (TOSTMF)

Indique le chemin d'accès du fichier STREAM dans lequel le vidage de la mémoire principale est copié. Tous les répertoires du chemin d'accès doivent exister. Les nouveaux répertoires ne sont pas créés. Si le fichier STREAM n'existe pas, il est créé. Specifies the path name of the stream file to which the main storage dump is copied. All directories in the path name must exist. New directories are not created. If the stream file does not exist, it is created.

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

Remplacer fichier (REPLACE)

Indique si l'opération de copie du vidage de la mémoire principale remplace un fichier STREAM s'il existe déjà un fichier STREAM portant le nom indiqué. Si le fichier STREAM n'existe pas, il est créé. Specifies whether the copy main storage dump operation replaces a stream file if a stream file with the specified name already exists. If the stream file does not exist, it is created.

*NO

Aucune donnée de vidage de la mémoire principale n'est copiée et un message d'erreur est signalé si le fichier existe déjà. No main storage dump data is copied and an error message is signalled if the file already exists.

*YES

Les données du vidage de la mémoire principale remplacent les éventuelles données du fichier STREAM existant. The main storage dump data replaces any existing stream file data.

Exemples

CPYFRMMSD DUMPID(1) TOSTMF('/My_MSDs/MSDFile') REPLACE(*YES)

Cette commande copie les données contenues dans le vidage de la mémoire principale d'identificateur 1 vers un fichier STREAM nommé /My_MSDs/MSDFile. Si ce fichier STREAM existe déjà, il est remplacé. This command copies the data contained in the main storage dump with identifier 1 to a stream file named /My_MSDs/MSDFile. If this stream file already exists, it will be replaced.

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.

CPF7210

Aucun vidage de la mémoire principale n'est disponible. No main storage dump is available.

CPF7212

L'identificateur de vidage de la mémoire principale &1 est introuvable. Main storage dump identifier &1 is not found.

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.

CPF7218

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

CPF7220

L'option *SELECT n'est valide que si la commande est exécutée de manière interactive. Option *SELECT is only valid if the command is being run interactively.

CPFA0D4

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