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 IBM i licensed program installed.

Restriction:

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

Parameters

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.

Error messages

*ESCAPE Messages

BRM1917

Feature not installed.

BRM1921

Feature not licensed.

BRM40A2

BRMS product initialization required.

CPF9800

All CPF98xx messages could be signaled. xx is from 01 to FF.