| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Migrate Media (MGRMEDRDAR) command provides a tool to move Spool File Archive data from one media type to another in an easy, recoverable way that can be stopped and restarted as needed. When MGRMEDRDAR runs, it updates all the necessary Spool File Archive files to point to the new location. The source media for the command can be an optical volume, a tape volume, or an individual report name. The target media can be disk for all sources or optical for optical sources.
A long running MGRMEDRDAR job can be ended if necessary. However it must be ended in a controlled manner to prevent unexpected results. You can use the End Job (ENDJOB) command specifying JOB(job-number/user-name/job-name) OPTION(*CNTRLD) DELAY(500) where job-number/user-name/job-name identifies the MGRMEDRDAR job.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| SRC | Source | Character value | Required, Positional 1 |
| SRCTYPE | Source type | *OPTICAL, *TAPE, *REPORT | Required, Positional 2 |
| TGT | Target | Character value, *DISK, *ASM | Required, Positional 3 |
| POLICY | Policy | Character value | Optional |
| INSTANCE | Instance | Name, *DFT | Optional |
| Top |
Specifies the optical volume or tape volume which contains Spool File Archive data to be migrated or an individual report definition to be migrated.
This is a required parameter.
| Top |
Specifies the type of source specified for the Source (SRC) parameter.
This is a required parameter.
| Top |
Specifies the target destination for the migrated Spool File Archive data.
This is a required parameter.
| Top |
Specifies the name of the migration policy to migrate objects to. A value must be specified for this parameter if *ASM is specified for the Source type (SRCTYPE) parameter.
Note: Position the cursor in the policy parameter entry and use the prompt (F4) key to view the list of policy values that are available for the default (*DFT) instance.
The default instance is specified in the QDFTINST data area. The QDFTINST data area can exist in multiple libraries. A search for the QDFTINST data area is performed using the library list. The first data area found will be used. If the QDFTINST data area is not found using the library list, the QUSRRDARS library will be searched for the data area. If the data area exists in the QUSRRDARS library it will be used. If the QDFTINST data area is not found, instance QUSROND is used.
| Top |
Specifies the name of the OnDemand instance to use.
| Top |
Example 1: Migrating Optical to Optical
MGRMEDRDAR SRC(RDROPTVOL01) SRCTYPE(*OPTICAL) TGT(RDRBIGOPT01)
This command migrates Spool File Archive data from optical volume RDROPTVOL01 to optical volume RDRBIGOPT01. This can be used to migrate Spool File Archive data from smaller to larger optical volumes or to migrate Spool File Archive data from an older optical library to a new larger capacity optical library like moving from 3995 to a 3996.
Example 2: Migrating Optical to Optical Combining Volumes
MGRMEDRDAR SRC(RDROPTVOL01) SRCTYPE(*OPTICAL) TGT(RDRBIGOPT01) MGRMEDRDAR SRC(RDROPTVOL02) SRCTYPE(*OPTICAL) TGT(RDRBIGOPT01) MGRMEDRDAR SRC(RDROPTVOL03) SRCTYPE(*OPTICAL) TGT(RDRBIGOPT01) MGRMEDRDAR SRC(RDROPTVOL04) SRCTYPE(*OPTICAL) TGT(RDRBIGOPT01)
This set of commands migrates Spool File Archive data from optical volumes RDROPTVOL01, RDROPTVOL02, RDROPTVOL03, and RDROPTVOL04 to optical volume RDRBIGOPT01. This can be used to migrate Spool File Archive data from old smaller capacity volumes to larger optical volumes.
Example 3: Migrating Optical to Disk
MGRMEDRDAR SRC(RDROPTVOL01) SRCTYPE(*OPTICAL) TGT(*DISK)
This command migrates Spool File Archive data from optical volume RDROPTVOL01 to disk. This can be used to move data from optical to disk.
| Top |
| Top |