Copy To Main Storage Dump (CPYTOMSD)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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:
- 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.
- 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:
- Execute (*X) authority to directories in the path name prefix of the stream file.
- Read (*R) authority to the stream file.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| FROMSTMF | From stream file | Path name | Required, Positional 1 |
| DESC | Text 'description' | Character value, *STMF | Optional |
| Top |
From stream file (FROMSTMF)
Specifies the path name of the stream file from which the main storage dump data is copied.
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/.
| Top |
Text 'description' (DESC)
Specifies the description to be used for the main storage dump.
- *STMF
- 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.
- character-value
- Specify no more than 32 characters of text, enclosed in apostrophes.
| Top |
Examples
CPYTOMSD FROMSTMF('/MY_MSDs/MSD0001') DESC('System crash')
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.
| Top |
Error messages
*ESCAPE Messages
- CPF7206
- &4 ended abnormally. Completion code &2 qualifier &3.
- CPF7215
- System Service Tools already active in this process.
- CPF7218
- Not authorized to run &2 command.
- CPFA0D4
- File system error occurred. Error number &1.
| Top |