Migrate Media (MGRMEDRDAR)
| 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 |
Parameters
| 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 |
Source (SRC)
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.
- name
- Specify the volume name or report definition name.
| Top |
Source type (SRCTYPE)
Specifies the type of source specified for the Source (SRC) parameter.
This is a required parameter.
- *OPTICAL
- Source is an optical volume.
- *TAPE
- Source is a tape volume.
- *REPORT
- Source is a report definition name.
| Top |
Target (TGT)
Specifies the target destination for the migrated Spool File Archive data.
This is a required parameter.
- *DISK
- Target is disk. When the Source type (SRCTYPE) parameter is either *OPTICAL or *TAPE the Spool File Archive data on the volume specified in the Source (SRC) parameter is migrated from the volume to disk. When the Source type (SRCTYPE) parameter is *REPORT any indexes for the report definition specified in the Source (SRC) parameter that have been archived will be permanently recalled.
- *ASM
- Target is an OnDemand archived storage management (ASM) policy.
- optical-volume
- Specify an optical volume.
| Top |
Policy (POLICY)
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.
- name
- Specifies the migration policy to migrate objects to.
| Top |
Instance (INSTANCE)
Specifies the name of the OnDemand instance to use.
- *DFT
- The default OnDemand instance is used. 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.
- instance-name
- Specify the name of the instance that is to be used. By definition, the instance must be on the system where the command is run.
| Top |
Examples
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 |
Error messages
Unknown| Top |