Setting BRMS to Use a BRMS Name

Configure BRMS to use user-defined system names

BRMS uses the Default local location and Local network ID to identify systems in a BRMS network. These values can be displayed using the Display Network Attributes (DSPNETA) command. 

BRMS system name

There are situations when it might be desirable to have two systems with the same system name and network ID in a BRMS network, for example, a high availability (HA) environment with role swapping between the production and backup systems.  BRMS can be configured using user defined system names so systems with the same network attributes can co-exist in the same BRMS network.

To setup a BRMS user defined system name, perform the following steps:

1. Remove the system from the BRMS network. See Removing a System from My BRMS Network for more information.
   Networking with BRMS topic in the IBM Knowledge Center for the steps required to remove a system from the BRMS network.

2. Run the following command to set the BRMS system name:     
         QSYS/CALL QBRM/Q1AOLD PARM('BRMSYSNAME' '*SET ' 'BRMSSYSA')
               After this command is run, all BRMS operations will use BRMSSYSA to refer to system #1. 
               NOTE: Changes to the network attributes on this system will not impact operations in the BRMS network.

3. Sign off the session and then sign back on.

4. DO a WRKPCYBRM *SYS Option 4, and remove the original system name with the *RENAME option

5. Run the following command to change the ownership of existing records in the BRMS database:
         INZBRM OPTION(*CHGSYSNAM) PRVSYSNAM(Current_Default_local_location) NEWSYSNAM(BRMSSYSA)

6. BRMS will use the new BRMS system name for communications in the BRMS network, therefore host table entries or a domain name system (DNS) entries must be created for the new BRMS system name on each of the systems in the BRMS network. 

7. Likewise, relational data base (RDB) entries must be created for the new BRMS system name on each of the systems in the BRMS network.

8. Add the system back into the BRMS network.  See the Networking with BRMS topic in the IBM Knowledge Center for the steps required to add a system to the BRMS network.

To display the BRMS system name, run one of the following commands:

1. QSYS/CALL QBRM/Q1AOLD PARM('BRMSYSNAME' '*DISPLAY' )

2. WRKPCYBRM TYPE(*SYS) and select option 4
   The BRMS name will be displayed in the upper right corner of the screen.

NOTES:

1. As described above, systems must be removed from any BRMS network before setting or changing the BRMS name and can then be added back into the BRMS network using the new BRMS name.

2. The BRMS Advanced Feature (57xxBR1 Option 2) is required on the systems that have a BRMS system name defined. 

3. In release V5R4M0, the following PTF or superseding PTF is required:
        V5R4M0 SI22692    

Restoring the system name and network ID in the network attributes 

To revert back to using the system name and network ID from the network attributes for a system that had previously been changed to use a BRMS user defined system name, follow these steps:

1. Remove the system from the BRMS network. See Removing a System from My BRMS Network for more information.

2. Run the following command to remove the BRMS system name:
         DLTDTAARA DTAARA(QUSRBRM/Q1ABRMSYS)

3. Sign off the session and then sign back on.

4. Run the following command to reset the system name in the BRMS database:
         INZBRM OPTION(*CHGSYSNAM) PRVSYSNAM(BRMSNAME) NEWSYSNAM(*LCL)

5. Add the system back into the BRMS network.  See the Networking with BRMS topic in the IBM Knowledge Center for the steps required to add a system to the BRMS network.

NOTE: As described above, systems must be removed from a BRMS network before resetting the BRMS name.