Copy Media Info for BRM (CPYMEDIBRM)

This command is typically used when you are bringing a system into a network of systems that share BRMS media inventory information. The Copy Media Information using BRM (CPYMEDIBRM) command copies media inventory information to a work file, or copies the contents of the work file to the media inventory.

Using the CPYMEDIBRM command prior to adding the system name to a BRMS network allows you to save the contents of the current media inventory into the work file. After network synchronization is complete, you can use CPYMEDIBRM with OPTION (*FROMFILE) on the newly added system to copy the original media inventory information back into the media inventory. Information that is inconsistent with the system's new network level media inventory information will be reported but unresolved when OPTION(*FROMFILE) is used.

The Media Merge report is produced when the CPYMEDIBRM command is processed. The report will indicate differences that have been diagnosed. The report, if printed, is written to printer file QP1AEN.

To use this command, you must have the Backup Recovery and Media Services for iSeries, 5722-BR1, licensed program installed.

Restriction:

The BRMS Network feature (Option 1) is required to use this command.

Parameters

Keyword	Description	Choices	Notes
OPTION	Type of copy	TOFILE, FROMFILE	Optional, Positional 1
FILE	File	Qualified object name	Optional
	Qualifier 1: File	Name, QA1AMED
	Qualifier 2: Library	Name, LIBL, CURLIB
CPYMEDI	Copy media information	NO, YES	Optional

Top

Type of copy (OPTION)

This command is designed to allow you to merge existing BRMS information from the current system with an existing network group of one or more systems.

The command allows you to store temporary copies of the current systems BRMS information to a temporary file. After an Initialize BRM (INZBRM) command using the option *NETSYS is used, the stored temporary copies can be merged in with the BRMS information brought from the other system

*TOFILE: You are copying media information from the media inventory to a work file. This option should be used before an INZBRM *NETSYS.
*FROMFILE: You are copying media information from the work file to the media inventory. Information that is inconsistent with the system's new network level media inventory information will be reported but unresolved when OPTION(*FROMFILE) is used. This option should be used after an INZBRM *NETSYS.

File (FILE)

Specifies the name of the work file that BRMS uses when it copies media inventory information.

Qualifier 1: File

QA1AMED: The media inventory file is copied to or from this file depending on the value specified in the File to copy (OPTION) parameter.
file-name: Specify the name of the file that you want to use when copying the media inventory. If the file that you specify does not exist, BRMS will create it for you.

Qualifier 2: Library

*LIBL: The library list is used to locate the file.
*CURLIB: The current library for the job is used to locate the file. If no current library entry exists in the library list, QGPL is used.
library-name: Specify the library name where the file is located.

Copy media information (CPYMEDI)

Specifies whether you want to copy media information for the media inventory that you are copying.

Note: *NO should be specified if you are planning to attach your system to a network.

*NO: Media information is not copied.
*YES: Media information is copied.

Examples

Example 1: Copying BRMS Media Information To a File

CPYMEDIBRM FILE(WORKFILE)

This command copies BRMS media information to a file called WORKFILE.

Example 2: Copying BRMS Media Information From a File

CPYMEDIBRM OPTION(*FROMFILE) FILE(WORKFILE)

This command copies BRMS media information from a file called WORKFILE to the network media inventory.