Initialize BRMS (INZBRM)

The Initialize BRMS (INZBRM) command performs several types of initialization. These are:

Allows you to estimate the time to update the BRMS product to a future version and release.
Allows you to start BRMS product initialization after installation or update.
Allows you to estimate the time remaining to complete BRMS product initialization.
Initializes all major files as well as establishing default policies and control groups
Starts the subsystem for networking in a multi-system environment
Allows you to reset BRMS and re-initialize all major files as well as establishing default policies and control groups
Creates auxiliary storage pool (ASP) descriptions
Allows you to re-register all BRMS functional authority elements with the i5/OS registration facility. This option is used during a full system recovery prior to restoring user profiles
Allows you to change the system name for BRMS media information to a new system name when restoring this information to a different system or logical partition
Allows you to merge the BRMS database files contained on one library with the BRMS database files in another library

The INZBRM command is used to add a system to a BRMS network group. The INZBRM command must be processed from the system that you are adding to the network group.

Note: All references to system name assume that the system name and the system location name are the same and are used interchangeably in the help information. If they are not the same, use the system location name instead of the system name. You can review the setting for the system name and location name by using the Display Network Attributes (DSPNETA) command from any command line.

Systems that are members of the network group share BRMS media inventory. Additions, changes and removals from shared media inventory on any system in the network result in the same changes being made to all systems that are members of the network group.

When a system is added to a network group, the media information common to the network group is copied to the system that you are adding. The system's media information is replaced by the network group's media information.

When a system is first added, it is added in an inactive status on an active network group member.

Note: This is accomplished by adding the system to a network group list using the Change Network Group display which is found in the System Policy menu. When the system name is added to the list, it is shown in inactive status.

The INZBRM OPTION(*NETSYS) option changes the status from inactive to active and synchronizes media information.

The following shared BRMS information files are replaced on this system with the information from the incoming system:

Media inventory
Media classes
Media policies
Container inventory
Container classes
Move policies
Network systems
Storage locations

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

Restrictions:

This command should not be used by control group *EXIT item processing as results will be unpredictable.
All BRMS operations must be ended before running this command.
All object authority is required to run the *RUNPRDINZ option.
These additional restrictions apply when *MERGE is specified for the Option (OPTION) parameter:
- All BRMS operations must be ended if library QUSRBRM is specified for the To library (TOLIB) parameter.
- Ownership of the from library and its objects and the to library and its objects will be changed to QBRMS prior to the merge. The public authority will be changed to *USE.
- Exclusive locks will be placed on the physical files in the from library objects and to library objects prior to the merge.
- Logical files will be deleted from the from library and to libraries prior to the merge.

Parameters

Keyword	Description	Choices	Notes
OPTION	Option	DATA, CHGSYSNAM, DEVICE, ESTPRDINZ, ESTPRDUPD, MERGE, NETSYS, RESET, RUNPRDINZ, SETAUT	Optional, Positional 1
FROMSYS	From system	Character value	Optional
PRVSYSNAM	Previous system name	Character value, *LCL	Optional
NEWSYSNAM	New system name	Character value, *LCL	Optional
FROMLIB	From library	Name	Optional
MERGE	Merge	Single values: ALL Other values (up to 5 repetitions): ARC, BKU, DEV, HST, MED, *MGR	Optional
TOLIB	To library	Name	Optional
TGTRLS	Target release	Character value	Optional

Top

Option (OPTION)

Specifies which of the types of initialization you want to perform.

*DATA

You are initializing BRMS. Default control groups, policies and tables are built based on the characteristics of the system that is being initialized. Additionally, new devices are added and ASPs are configured. Default ASP descriptions for ASPs defined to the system, but not already defined to BRMS are added.

When ASPs are configured, the following default information is added:

ASP name value is *NONE, with the exception of ASP 1, which is given the ASP name of *SYSTEM.
Low and high threshold values are set to *NONE.
Text is "Entry created by BRM configuration".

If the parameter contains the special value *DATA, you must process the INZBRM command on the system on which you want to initialize for BRMS.

This option does not affected the saved history.

No parameters are used with this option.

*CHGSYSNAM

Allows you to change the system name stored in the BRMS media information. The system name is used to distinguish the media information of this system from the media information of other systems in a BRMS network. The system name is applied to the media information even if you do not use the BRMS networking feature. BRMS uses the system's local network ID (LCLNETID) and default local location name (LCLLOCNAME) for the system name. You can use the DSPNETA command to view these system network attributes.

You must change the system name of the media information to the current system name when recovering the BRMS media information to a different system or different logical partition having a system name different from the saved system name. You must specify a previous system name using the Previous system name (PRVSYSNAM) parameter and a new system name using the New system name (NEWSYSNAM) parameter.

The From library (FROMLIB) , To library (TOLIB) and Merge (MERGE) parameters are not used with this option.

*DEVICE

You are clearing device and media library information and re-initializing the files with the devices currently described on the system. In addition to clearing and re-initializing the device file, *DEVICE also performs the same functions as *DATA. Using the *DEVICE special value causes CSI objects and APPC device information to be removed from the BRMS inventory if no APPC device entries by the same name are found. Using the *DEVICE special value does not cause NET device information to be removed.

This option does not affected the saved history.

No parameters are used with this option.

*ESTPRDINZ

Use this option to determine the approximate time required to complete initialization of the BRMS program product after installation or update. An estimate of the initialization time is returned in message BRM402B. For more precise estimates, always run this option in the same system environment as the initialization job. If this option is run concurrently with product initialization, the approximate time remaining is returned.

Product initialization is only required once following a product update. Use option *RUNPRDINZ of this command to run product initialization after the update.

No parameters are used with this option.

*ESTPRDUPD

Use this option to determine the approximate time required to complete a BRMS program product update to a future version and release. The time estimate is returned in message BRM402C.

Note: The actual time could vary from the estimated time if the update occurs on a different system or uses a different job environment.

You must specify a value for Target release (TGTRLS) when using this option.

*MERGE

Allows you to merge the BRMS database files contained in one library specified on the From library (FROMLIB) parameter with the BRMS database files in another library specified on the To library (TOLIB) parameter using options specified on the Merge (MERGE) parameter. This function may be useful when consolidating multiple systems onto a single system, or copying BRMS objects from library QUSRBRM to another library for subsequent archive. Refer to Appendix A in the Backup Recovery and Media Services book for additional guidance on using this option.

Note: Because of the extensive file processing involved in the merge operation, this could be a long running process depending on the merge options you select and the size of the merged files.

Note: If you intend to merge more than one library to the current system it is recommended that you merge these libraries to an intermediate library then perform a final merge of the intermediate library into the QUSRBRM library.

The From system (FROMSYS), Previous system name (PRVSYSNAM) and New system name (NEWSYSNAM) parameters are not used with this option.

*NETSYS

BRMS files will be copied from the system specified in the From system (FROMSYS) parameter which should be in the network system group. Prior to using this option, use the Copy Media Information (CPYMEDIBRM) command to copy the current BRMS information from this system to a temporary file. After the INZBRM *NETSYS is complete, to merge the old information, use the CPYMEDIBRM again to copy the information back from the temporary file. This option will replace data in some current BRMS files.

Note: The BRMS Network feature (Option 1) is required to use this value.

Only the From system (FROMSYS) parameters is used with this option.

*RESET

You are resetting BRMS. When you use this option BRMS information is removed from your system and all major files are re-initialized. Using OPTION(*RESET) clears all major BRMS files and processes the INZBRM command OPTION(*DATA). This option erases all hierarchial storage management (HSM) information and resets all configurations to be consistent with those created when the product is first installed. Since APPC information is not automatically configured by BRMS, *RESET removes all APPC device information from BRMS including any CSI objects that may have been created.

No parameters are used with this option.

*RUNPRDINZ

Use this option to complete initialization of the BRMS program product after installation. The BRMS program product cannot be used until initialization is complete. Product initialization is only required once following a product update. Use this option if you receive message BRM40A2 - BRMS product initialization required when attempting to perform a BRMS operation after a product update.

BRMS product initialization can be a long running process. Performance can be optimized by running this option when there is little or no other activity on the server.

Use option *ESTPRDINZ of this command to retrieve an approximation of the time required to perform the initialization in the current environment.

Note: All object authority is required to use this option.

No parameters are used with this option.

*SETAUT

Allows you to re-register all BRMS functional authority elements with the i5/OS registration facility. This option is used during a full system recovery prior to restoring user profiles.

No parameters are used with this option.

From system (FROMSYS)

Specifies the name of any system which is already in the network group that you want the new system to join. The network media information on the system that you specify here is copied to your system. For example, if system A is a system that you want to add to the network and system B is an active member of a network group, you would specify system B in the From system (FROMSYS) parameter. The network media inventory from system B replace the media inventory on system A and system A has now become an active member of the network group.

The following media inventory files are copied from the active system in a network group to replace the media inventory files on the inactive system. You are notified before each file is replaced:

Media inventory
Media classes
Media policies
Container inventory
Container classes
Move policies
Network systems
Storage locations

Note: The BRMS Network feature (Option 1) is required to use this parameter.

location-name: Specify the name of the remote location associated with the from-system. The local system's network identifier, as seen by using the DSPNETA command, is used as the from-system's network identifier.
network-id.location-name: Specify the network identifier and the name of the remote location associated with the from-system. Specify these values using the format nnnnnnnn.cccccccc where nnnnnnnn is the network identifier and cccccccc is the remote location name.

Previous system name (PRVSYSNAM)

Specifies the previous name of the system when changing the system name in the media information for recovery to a different system or different logical partition.

*LCL: Specifies that the local system name is to be used for the previous system name. BRMS will use this system's local network ID (LCLNETID) and default local location name (LCLLOCNAME) for the previous system name.
previous-system-name: Specifies the name that is to be used as the previous system name . If you specify this value, BRMS will use the local network ID (LCLNETID) and the specified name to create the previous system name.
network-id.location-name: Specify the local network identifier and default local location name that is to be used for the previous system name. Specify these values using the format nnnnnnnn.cccccccc where nnnnnnnn is the network identifier and cccccccc is the remote location name of the previous system.

New system name (NEWSYSNAM)

Specifies the new name of the system when changing the system name in the media information for recovery to a different system or different logical partition.

*LCL: Specifies that the local system name is to be used for the new system name. BRMS will use this system's local network ID (LCLNETID) and default local location name (LCLLOCNAME) for the new system name.
new-system-name: Specifies the name that is to be used as the new system name . If you specify this value, BRMS will use the local network ID (LCLNETID) and the specified name to create the new system name.
network-id.location-name: Specify the local network identifier and default local location name that is to be used for the new system name. Specify these values using the format nnnnnnnn.cccccccc where nnnnnnnn is the network identifier and cccccccc is the remote location name of the new system.

From library (FROMLIB)

Specifies the name of the source library containing the BRMS files with the records to be merged. This should be a version of the QUSRBRM library saved from another system and restored to the current system using a different library name.

Note: Prior to the start of the merge operation, the ownership of the library and all objects in the library will be changes to QBRMS and the public authority will be changed to *USE. Also, all logical files will be deleted from this library and all physical files will be converted to the current release.

from-library-name: Name of the library containing the BRMS database files which are to be merged. Library QUSRBRM cannot be specified as the from library.

Merge (MERGE)

Specifies the options for the merge process. These options define the types of BRMS data to be merged.

Single values

*ALL: Specifies all BRMS media, device, history and policy files are to be merged.

Other values (up to 5 repetitions)

*ARC: Specifies all BRMS archive control group and archive list files are to be merged.
*BKU: Specifies all BRMS backup control group and backup list files are to be merged.
*DEV: Specifies all BRMS user devices such as Tivoli Storage Manager (TSM) of type *NET and user media library devices of type *USRMLB are to be merged.
*HST: Specifies all BRMS media information files containing backup, archive and migration history are to be merged.
*MED: Specifies all BRMS volume information and media related files are to be merged.
*MGR: Specifies all BRMS migration control group files are to be merged.

To library (TOLIB)

Specifies the name of the target library containing the BRMS files which will receive the merge records.

Note: Always save library QUSRBRM before performing a merge operation when QUSRBRM is specified for the to library.

Note: You must end all BRMS operations before performing a merge operation when QUSRBRM is specified for the to library. The merge operation will fail if exclusive locks cannot be obtain ed for the files in the to library.

to-library-name: Name of the library containing the BRMS database files which will receive the merge records.

Target release (TGTRLS)

Specifies the target release for estimating the BRMS product update time. This is a required parameter when *ESTPRDUPD is specified for the Option (OPTION) parameter.

*DEFAULT: Specifies the default action is to be used when estimating the BRMS product update time. The default action assumes the target release is not available and a worst case update time is returned. Use this value if a future version and release of the product is not available, or the current version and release is no longer serviced and an available target release is not listed.
target-release: Specify the target release for the update in the format VxRxMx, where Vx is the version, Rx is the release, and Mx is the modification level. For example, V5R4M0 is version 5, release 4, modification level 0.

Examples

Example 1: Initializing the BRMS Product

INZBRM OPTION(*RESET)

This command initializes BRMS resetting all values to the default value.

Example 2: Activating a System on the Network

INZBRM OPTION(*NETSYS) FROMSYS(MYNETID.MYSYSID)

This command activates system MYSYSID on network MYNETID into the BRMS network. The command is run on system MYSYSID.

Example 3: Register All Functional Authorities

INZBRM OPTION(*SETAUT)

This command registers all policies and functions currently defined in BRMS to the i5/OS Registration facility.

Example 4: Rename Media Information

INZBRM OPTION(*CHGSYSNAM) PRVSYSNAM(MYNETID.MYSYSID) NEWSYSNAM(*LCL)

This command renames all BRMS media information currently owned by system MYSYSID on network MYNETID to the local network identified and default local location name as defined in the network attributes.

Example 5: Merge BRMS Database Files

INZBRM OPTION(*MERGE) FROMLIB(QUSRBRMSAV) TOLIB(QUSRBRM) MERGE(*ALL)

This command merges the records found in the database files found in library QUSRBRMSAV with the records found in library QUSRBRM.

Example 6: Estimate BRMS initialization

INZBRM OPTION(*ESTPRDINZ)

This command estimates the time required to initialize BRMS following installation of the product primary language. The estimate is returned in message BRM402B.

Example 7: Run BRMS initialization

INZBRM OPTION(*RUNPRDINZ)

The user has received exception BRM40A2 trying to run BRMS operations. This command completes the BRMS product initialization and allows for normal BRMS operations to continue.

Example 8: Estimate BRMS update time

INZBRM OPTION(*ESTPRDUPT) TGTRLS(VxRxMx)

Estimates the time to update the current version and release of BRMS to the version and release specified by the VxRxMx value for the TGTRLS parameter.

Error messages

*ESCAPE Messages

BRM13FF: Merge operation not successful. Reason &5
BRM1521: Connection to system &1 could not be established.
BRM1917: Feature not installed.
BRM1921: Feature not licensed.
BRM4040: Access denied for user &1.
BRM4041: Access denied for user &1.
BRM40A5: BRMS product initialization ended abnormally.
BRM40A6: BRMS product initialization already started.
BRM412B: Values not valid for parameters.
BRM6708: Command ended due to error.
CPF9800: All CPF98xx messages could be signaled. xx is from 01 to FF.