Troubleshooting
Problem
There are numerous data areas available in BRMS that can help users change the functionality of BRMS.
Resolving The Problem
There is numerous data areas available in BRMS that can help users change the functionality of BRMS. Following is a list and a brief description of the available data areas:
Data Area: QTEMP/Q1APOINT
Used for IBM Lotus Domino Point in Time Recovery on Green Screen.
Recovering only the online, full backup (no incremental):
Recovering to a point-in-time (full plus incremental):
Where yyyy is the year, mm is the month, dd is the day, hh is the hour, mm is the minutes, and ss is the seconds.
For example: VALUE('20010525161212') represents a point-in-time of May 25, 2001 at 16:12:12
Data Area: QUSRBRM/NOLTSCFG
Will turn off Lotus Configuration during STRMNTBRM, INZBRM *DATA, or Slip Install or Upgrade.
Data Area: QUSRBRM/Q1ANOSYSCK
Will stop checking for same system on picking media even if it cannot ensure using the network that it can use this media.
Note: This data area is ignored if using tape media libraries. This works only if using stand-alone drives.
Data Area: QUSRBRM/Q1AREFREE
This data area improves performance with RUNCLNUP(*YES) dealing with re-freeing of auto-retrieved objects. If data exists, this re-freeing is not done.
Note: This data area is required for R520 and below only. There is an option in R530 and above in STRMNTBRM command, REFREE. Integrated File System objects cannot be auto re-freed in current releases.
Data Area: QUSRBRM/Q1ANOPING
In releases V5R1M0 and above, this data area can be used to allow BRMS to DDM without first checking that a network connection is available by running a PING command
Note: Use this data area only if you cannot allow PINGs between systems.
Data Area: QUSRBRM/Q1AAPYJRNX
This data area is used with SAP
Note: To enable BRMS-integrated forward recovery of your journal receivers using the APYJRNCHGX command.
Refer to Chapter 23. Backup and Recovery at the following website:
http://www.redbooks.ibm.com/redbooks/pdfs/sg247166.pdf
Data Area: QTEMP/Q1ALNKFIL
This data area is used to limit the WRKLNKBRM command searches to specific links. The data area must contain the path to a stream file that contains a list of the links to search for. When the WRKLNKBRM command encounters this data area, it displays only directories and saved items containing the specified links. The WRKLNKBRM OUTPUT(*PRINT) also limits the search and display to the specified links, and the spooled file contains only the links specified. If some directories and links are omitted from the display or the spooled file, BRM1975 is issued. This function is available at V5R3 and newer releases.
Data Area: QTEMP/Q1ALNKIGN
This data area is used in conjunction with the data area QTEMP/Q1ALNKFIL. If Q1ALNKIGN exists, WRKLNKBRM will ignore case sensitivity when searching for the specified links.
Data Area: QTEMP/Q1ASAVOUTF
This data area can be used to retain the outfile created by BRMS when IFS objects are saved via *LINK, a link list or SAVBRM.
The outfile will be stored in tmp/brms/q1asavxxxxxxSave where xxxxxx is the job number of the job that ran the save.
Note: This function is available only in V5R2M0 and above and the file will have to be sent to support for analysis.
Data Area: QUSRBRM/Q1AIGNRDUP
USEDUPMED was introduced in V5R4M0 to indicate that you wanted to include either the original save media or the duplicate save media, but not both. Create this data area if you want to include both the original save media and the duplicate save media in your recovery report Recovery Volume Summary Report (QP1A2RCY) when USEDUPMED(*YES) is specified.
Data Area: QUSRBRM/Q1AUTEST
This data area is used in V5R3M0 and above to collect additional information for service support.
Notes:
1. It is recommend data area QUSRBRM/Q1AMAXFR is also created to increase the size of the BRMS flight recorders
2. When this data area exists, performance of BRMS applications will be affected
Data Area: QUSRBRM/Q1ACRTDOLD
Normally the creation date of a volume will only be updated when data is written to the first sequence on the volume.
OPTION 1: This data area can be used to update the creation date of a volume when data is written to the first sequence on the volume or when QUSRBRM is saved to the volume.
Notes:
1. To use this data area with OPTION 1, PTF SI30649 (V6R1M0) or SI30647 (V5R4M0) or SI30646 (V5R3M0) is required.
2. This only works when SAVMEDIBRM or the BRMS recovery information in a control group is saved.
OPTION 2: This same data area can also be used to update the creation date of a volume every time data is written to the volume, if it contains the value ALL.
Note: To use this data area with OPTION 2, PTF SI37276 (V6R1M0) or SI37269 (V5R4M0) is required.
Data Area: QUSRBRM/Q1AONLYBRM
BRMS can block initializing and writing to media not enrolled in the BRMS inventory. The purpose of this function is to prevent users from inadvertently overwriting media created by a partition not participating in a BRMS network group.
Note:
Data Area: QUSRBRM/Q1AALWMFDP
BRMS can be configured to allow multiple parallel volumes to be appended to the same volume when running a DUPMEDBRM TOSEQNBR(*END). The first volume will start on a scratch volume and all other volumes in the parallel set will be appended to that volume until it is full.
Where xxxxxxxxxx is replaced by the I-ASP's Name.
This will ensure that BRMS restores the correct saved item.
Note: To use this data area, PTF SI33974 (V5R4M0) or SI33975 (V6R1M0) is required.
Data Area: QUSRBRM/Q1ADLTVERS
This data area is used in V5R2M0 and above. When using versioning in your media policies, if you delete a library, the tape containing that library will not expire. A new data area, QUSRBRM/Q1ADLTVERS, is provided that will allow you to specify that the tapes containing these deleted libraries should be automatically expired. This data area specifies the number of days that BRMS should retain the saved item information for those libraries after it has detected (using STRMNTBRM) that they have been deleted. Once this time period has been exceeded, the saved item information for those libraries will automatically be expired
In order to specify that you want to expire any saved items whose associated library was deleted in the last xx days, issue the following command:
Data Area: QUSRBRM/Q1AIPLSUB
A control group may try to put the system into restricted state. If an attempt is made to restart the controlling subsystem and the system does has not reached restricted state, a CPF1099 may be sent because the control subsystem is still trying to end. The only way to get out of this state is to IPL the system.
In releases V5R4M0 and later, if BRMS receives a CPF1099 when it tries to start the controlling subsystem and data area QUSRBRM/Q1AIPLSUB exists, the system will be IPL-ed. IPL options from the control group are used. These options may be referencing the BRMS Backup Policy or even the BRMS System Policy. The control group does not need to be set to IPL *YES in order for this IPL to occur.
Note: In release V5R4M0 or later, the following PTFs or their superseding PTFs are required:
Data Area: QUSRBRM/Q1ACHGOWNX
In releases V5R4M0 and later, it's possible for BRMS volumes to be owned by a system that is not in the BRMS network. Support has been added to the STRMNTBRM command to change the owner of expired BRMS volumes that are not owned by a system in the BRMS network. The owner will be changed to the system on which the STRMNTBRM is being run. To enable this new function, run the following command:
To disable this new function, run the following command:
Notes:
Data Area: QUSRBRM/Q1ANOVFYM
In V5R4M0 and above, volume selection will protect volumes that are in verify move status. After the move media command (MOVMEDBRM) has been ran, volumes that need to have movement verified will not be selected as append candidates.
To enable the old behavior which allows media in verify move status to be selected as an append candidate, run the following command:
Note:
Data Area: QTEMP/Q1ACLRSQL
Activation group Q1ABRMS uses SQL CLI with open data sources. The open data sources may cause conflicts with other users of the SQL CLI that change environment variables in the same job. To prohibit these SQL CLI conflicts within a job, run the following commands:
1) CRTDTAARA DTAARA(QTEMP/Q1ACLRSQL) TYPE(*CHAR)
2) QSYS/CALL PGM(QBRM/Q1AOLD) PARM('CLSSQLENV ')
Note: In releases IBM i 7.1 and earlier, the following PTFs or their superseding PTFs are required:
Data Area: QTEMP/Q1ANSTRPSN
An enhancement to enable fast media positioning during restores was added for releases IBM i 7.1 and above. The new function is enabled within BRMS by default. It may be necessary to disable fast positioning if a restore fails with a CPF5183 message. To disable the function, run the following command:
Data Area: QUSRBRM/Q1ACLSNONE
This data area allows BRMS to pick any media class in a tape media library or any media class that is loaded in a tape drive.
Note:
Data Area: QUSRBRM/Q1ARMTEJT
Eject media from an MLB that is not configured on the local system
Data Area: QTEMP/Q1APOINT
Used for IBM Lotus Domino Point in Time Recovery on Green Screen.
Recovering only the online, full backup (no incremental):
CRTDTAARA DTAARA(QTEMP/Q1APOINT) TYPE(*CHAR) LEN(14) VALUE('*FULL ')
Recovering to a point-in-time (full plus incremental):
CRTDTAARA DTAARA(QTEMP/Q1APOINT) TYPE(*CHAR) LEN(14) VALUE(yyyymmddhhmmss)
Where yyyy is the year, mm is the month, dd is the day, hh is the hour, mm is the minutes, and ss is the seconds.
For example: VALUE('20010525161212') represents a point-in-time of May 25, 2001 at 16:12:12
Data Area: QUSRBRM/NOLTSCFG
Will turn off Lotus Configuration during STRMNTBRM, INZBRM *DATA, or Slip Install or Upgrade.
CRTDTAARA DTAARA(QUSRBRM/NOLTSCFG) TYPE(*CHAR) LEN(1)
| Caution: Creating this data area prevents the creation of the QLTS* control groups and the updating of these control groups when INZBRM *DATA or STRMNTBRM is run. |
Data Area: QUSRBRM/Q1ANOSYSCK
Will stop checking for same system on picking media even if it cannot ensure using the network that it can use this media.
Note: This data area is ignored if using tape media libraries. This works only if using stand-alone drives.
| Caution: Data could be lost. Thoroughly read Information APAR II13467 before running this command. To link to Information APAR II13467 immediately, click here. |
CRTDTAARA DTAARA(QUSRBRM/Q1ANOSYSCK) TYPE(*CHAR) LEN(1)
Data Area: QUSRBRM/Q1AREFREE
This data area improves performance with RUNCLNUP(*YES) dealing with re-freeing of auto-retrieved objects. If data exists, this re-freeing is not done.
CRTDTAARA DTAARA(QUSRBRM/Q1AREFREE) TYPE(*CHAR) LEN(1)
Note: This data area is required for R520 and below only. There is an option in R530 and above in STRMNTBRM command, REFREE. Integrated File System objects cannot be auto re-freed in current releases.
Data Area: QUSRBRM/Q1ANOPING
In releases V5R1M0 and above, this data area can be used to allow BRMS to DDM without first checking that a network connection is available by running a PING command
CRTDTAARA DTAARA(QUSRBRM/Q1ANOPING) TYPE(*CHAR) LEN(1)
Note: Use this data area only if you cannot allow PINGs between systems.
Data Area: QUSRBRM/Q1AAPYJRNX
This data area is used with SAP
CRTDTAARA (DTAARA(QUSRBRM/Q1AAPYJRNX) TYPE(*CHAR) LEN(1)
Note: To enable BRMS-integrated forward recovery of your journal receivers using the APYJRNCHGX command.
Refer to Chapter 23. Backup and Recovery at the following website:
http://www.redbooks.ibm.com/redbooks/pdfs/sg247166.pdf
Data Area: QTEMP/Q1ALNKFIL
This data area is used to limit the WRKLNKBRM command searches to specific links. The data area must contain the path to a stream file that contains a list of the links to search for. When the WRKLNKBRM command encounters this data area, it displays only directories and saved items containing the specified links. The WRKLNKBRM OUTPUT(*PRINT) also limits the search and display to the specified links, and the spooled file contains only the links specified. If some directories and links are omitted from the display or the spooled file, BRM1975 is issued. This function is available at V5R3 and newer releases.
CRTDTAARA QTEMP/Q1ALNKFIL TYPE(*CHAR) LEN(1) value(' ')The specified stream file must contain data in the CCSID of the job performing the WRKLNKBRM.
Data Area: QTEMP/Q1ALNKIGN
This data area is used in conjunction with the data area QTEMP/Q1ALNKFIL. If Q1ALNKIGN exists, WRKLNKBRM will ignore case sensitivity when searching for the specified links.
CRTDTAARA DTAARA(QTEMP/Q1ALNKIGN) TYPE(*CHAR) LEN(1)
Data Area: QTEMP/Q1ASAVOUTF
This data area can be used to retain the outfile created by BRMS when IFS objects are saved via *LINK, a link list or SAVBRM.
CRTDTAARA QTEMP/Q1ASAVOUTF TYPE(*CHAR) LEN(1)
The outfile will be stored in tmp/brms/q1asavxxxxxxSave where xxxxxx is the job number of the job that ran the save.
Note: This function is available only in V5R2M0 and above and the file will have to be sent to support for analysis.
Data Area: QUSRBRM/Q1AIGNRDUP
USEDUPMED was introduced in V5R4M0 to indicate that you wanted to include either the original save media or the duplicate save media, but not both. Create this data area if you want to include both the original save media and the duplicate save media in your recovery report Recovery Volume Summary Report (QP1A2RCY) when USEDUPMED(*YES) is specified.
CRTDTAARA DTAARA(QUSRBRM/Q1AIGNRDUP) TYPE(*CHAR)
Data Area: QUSRBRM/Q1AUTEST
This data area is used in V5R3M0 and above to collect additional information for service support.
CRTDTAARA DTAARA(QUSRBRM/Q1AUTEST) TYPE(*CHAR)
Notes:
1. It is recommend data area QUSRBRM/Q1AMAXFR is also created to increase the size of the BRMS flight recorders
2. When this data area exists, performance of BRMS applications will be affected
Data Area: QUSRBRM/Q1ACRTDOLD
Normally the creation date of a volume will only be updated when data is written to the first sequence on the volume.
OPTION 1: This data area can be used to update the creation date of a volume when data is written to the first sequence on the volume or when QUSRBRM is saved to the volume.
CRTDTAARA QUSRBRM/Q1ACRTDOLD TYPE(*CHAR) LEN(1)
Notes:
1. To use this data area with OPTION 1, PTF SI30649 (V6R1M0) or SI30647 (V5R4M0) or SI30646 (V5R3M0) is required.
2. This only works when SAVMEDIBRM or the BRMS recovery information in a control group is saved.
OPTION 2: This same data area can also be used to update the creation date of a volume every time data is written to the volume, if it contains the value ALL.
CRTDTAARA QUSRBRM/Q1ACRTDOLD TYPE(*CHAR) LEN(10) VALUE('ALL')
Note: To use this data area with OPTION 2, PTF SI37276 (V6R1M0) or SI37269 (V5R4M0) is required.
Data Area: QUSRBRM/Q1AONLYBRM
BRMS can block initializing and writing to media not enrolled in the BRMS inventory. The purpose of this function is to prevent users from inadvertently overwriting media created by a partition not participating in a BRMS network group.
To enable this feature, create the data area QUSRBRM/Q1AONLYBRM. In the system policy, set the parameter "Auto enroll media" to *NO. Attempts to write or initialize tapes not enrolled in the BRMS inventory result in message BRM3D1D with reason code 0010.
CRTDTAARA QUSRBRM/Q1AONLYBRM TYPE(*CHAR) LEN(1)
Note:
1.To use this data area, PTF SI30649 (V6R1M0), PTF SI30647 (V5R4M0), or PTF SI30646 (V5R3M0) is required.
2.In order to prevent unauthorized users from enrolling media into BRMS, secure the commands
2.In order to prevent unauthorized users from enrolling media into BRMS, secure the commands
WRKMLMBRM, ADDMEDBRM and WRKMEDBRM, and the data area QUSRBRM/Q1AONLYBRM.Data Area: QUSRBRM/Q1AALWMFDP
BRMS can be configured to allow multiple parallel volumes to be appended to the same volume when running a DUPMEDBRM TOSEQNBR(*END). The first volume will start on a scratch volume and all other volumes in the parallel set will be appended to that volume until it is full.
CRTDTAARA QUSRBRM/Q1AALWMFDP TYPE(*CHAR) LEN(1)
Notes:
1. When doing restores from the duplicated single volume, Parallel resources needs to be set to a minimum and maximum of 1 - PRLRSC(1 1).
2. Ensure that only expired media is available in the media class specified in the MEDPCY parameter on the DUPMEDBRM command. If there are any active volumes in that media class, they will be appended to.
3. Restores from the duplicate media may take longer.
4. When using the auto duplication function with this data area created, jobs need to be submitted to a single threaded job queue.
5. At V7R1 only the dupmedbrm command has to be changed or a copy made and put in a library ahead of qsys. CHGCMDDFT CMD(DUPMEDBRM) NEWDFT('TOSEQNBR(*END)')
1. When doing restores from the duplicated single volume, Parallel resources needs to be set to a minimum and maximum of 1 - PRLRSC(1 1).
2. Ensure that only expired media is available in the media class specified in the MEDPCY parameter on the DUPMEDBRM command. If there are any active volumes in that media class, they will be appended to.
3. Restores from the duplicate media may take longer.
4. When using the auto duplication function with this data area created, jobs need to be submitted to a single threaded job queue.
5. At V7R1 only the dupmedbrm command has to be changed or a copy made and put in a library ahead of qsys. CHGCMDDFT CMD(DUPMEDBRM) NEWDFT('TOSEQNBR(*END)')
6.Duplication from a multi-volume parallel set to a single larger volume will be single stream process. Each parallel volume is duplicated completely to the target volume before the next volume is duplicated.
7.It is possible restores may hang due to issues with logical and physical files if the following PTF or their superseding PTFs are not applied
MF64506 (7.3)
MF64505 (7.2)
8.To change back to not duplicate to a single volume, delete the data area
Data Area: QUSRBRM/Q1ASAVASP
In V5R4 and above, when restoring an object or library to a specified I-ASP using a RSTOBJBRM or RSTLIBBRM command , and you want to restore the data to a specified iASP, there is no parameter on the commands to specify this.
To specify a iASP, create the following data area in the same job stream and the RSTxxxBRM command
DLTDTAARA QUSRBRM/Q1AALWMFDP
Data Area: QUSRBRM/Q1ASAVASP
In V5R4 and above, when restoring an object or library to a specified I-ASP using a RSTOBJBRM or RSTLIBBRM command , and you want to restore the data to a specified iASP, there is no parameter on the commands to specify this.
To specify a iASP, create the following data area in the same job stream and the RSTxxxBRM command
CRTDTAARA DTAARA(QTEMP/Q1ASAVASP) TYPE(*CHAR) LEN(10) VALUE('xxxxxxxxxx')
Where xxxxxxxxxx is replaced by the I-ASP's Name.
This will ensure that BRMS restores the correct saved item.
Note: To use this data area, PTF SI33974 (V5R4M0) or SI33975 (V6R1M0) is required.
Data Area: QUSRBRM/Q1ADLTVERS
This data area is used in V5R2M0 and above. When using versioning in your media policies, if you delete a library, the tape containing that library will not expire. A new data area, QUSRBRM/Q1ADLTVERS, is provided that will allow you to specify that the tapes containing these deleted libraries should be automatically expired. This data area specifies the number of days that BRMS should retain the saved item information for those libraries after it has detected (using STRMNTBRM) that they have been deleted. Once this time period has been exceeded, the saved item information for those libraries will automatically be expired
In order to specify that you want to expire any saved items whose associated library was deleted in the last xx days, issue the following command:
CRTDTAARA DTAARA(QUSRBRM/Q1ADLTVERS) TYPE(*DEC) LEN(5) VALUE(xx)
NOTE: This data area is no longer used and has been replaced by "Deleted library retention" in the media policy.
Data Area: QUSRBRM/Q1ANLSTOMT
Domino expects to be able to access the *.ini and *.id files and the gtrhome and /tmp directories. Saving these files or directories while the Domino server is active may make these files or directories unavailable to Domino and potentially cause some unpredictable results within Domino. We would recommend creating the data area:
This would omit saving these objects:
*.ini
*.id
gtrhome
/tmp
Data Area: QUSRBRM/Q1APRLNONE
When specifying multiple drives for the Parallel device resources parameter in a control group or SAVxxxBRM command , BRMS will attempt to do a parallel save of the data. BRMS has 2 types of parallel saves, Parallel-Parallel and Multiple-Library Parallel Concurrent Saves. BRMS will attempt to save the data in the most efficient method and when saving *IBM, *ALLUSR, generic libraries or a list of libraries, some data may be saved in the parallel-parallel method while other is saved in the parallel-serial method.
However, some users may prefer not to have data saved in the Parallel-Parallel method.
At V6R1M0, users can force the type of parallel save in the control group entries.
At V5R4M0, users can user the following data area to force parallel-serial saves of *IBM, *ALLUSR, generic libraries or a list of libraries
Note: This data area is no longer used at V6R1M0 and above
Data Area: QUSRBRM/Q1ASYNTIM
In V5R4M0 and above, with the listed BRMS PTFS or their superseding PTF, BRMS will no longer support the Option 8 "Set time" on the network panel (WRKPCYBRM *SYS Option 4). If users still want to use the function, for those that depend on it, a data area can be created. However, we strongly advise being careful with this function, and make sure you are only syncing the times between systems within the same network and time zone. To enable the "Set Time" function, create a data area:
This option will be disabled when the following PTF or their supersedes are applied and the data area does not exist:
o SI38733 for V5R4M0
o SI38739 for V6R1M0
o SI38740 for V7R1M0
Data Area: QTEMP/Q1ASPLTMZN
This data area is used to restore spool file data that was saved in a different time zone than time zone of the system doing the restore.
Notes:
1. To use this data area, the following PTFs or their superseding PTFs are required:
Data Area: QUSRBRM/Q1ANLSTOMT
Domino expects to be able to access the *.ini and *.id files and the gtrhome and /tmp directories. Saving these files or directories while the Domino server is active may make these files or directories unavailable to Domino and potentially cause some unpredictable results within Domino. We would recommend creating the data area:
CRTDTAARA DTAARA(QUSRBRM/Q1ANLSTOMT) TYPE(*CHAR) LEN(1)
This would omit saving these objects:
*.ini
*.id
gtrhome
/tmp
NOTES:
1.For the *.ini and *.id files, we would recommend periodically making a copy of those objects and saving the copies.
2.This will only work when using special values *LNKOMTONL or *LTSOMTONL in a control group.
More information can be found at the following URL: Omit additional Lotus Server objects during backups - Q1ANLSTOMT
2.This will only work when using special values *LNKOMTONL or *LTSOMTONL in a control group.
More information can be found at the following URL: Omit additional Lotus Server objects during backups - Q1ANLSTOMT
Data Area: QUSRBRM/Q1APRLNONE
When specifying multiple drives for the Parallel device resources parameter in a control group or SAVxxxBRM command , BRMS will attempt to do a parallel save of the data. BRMS has 2 types of parallel saves, Parallel-Parallel and Multiple-Library Parallel Concurrent Saves. BRMS will attempt to save the data in the most efficient method and when saving *IBM, *ALLUSR, generic libraries or a list of libraries, some data may be saved in the parallel-parallel method while other is saved in the parallel-serial method.
However, some users may prefer not to have data saved in the Parallel-Parallel method.
At V6R1M0, users can force the type of parallel save in the control group entries.
At V5R4M0, users can user the following data area to force parallel-serial saves of *IBM, *ALLUSR, generic libraries or a list of libraries
CRTDTAARA DTAARA(QUSRBRM/Q1APRLNONE) TYPE(*CHAR) LEN(1)
Note: This data area is no longer used at V6R1M0 and above
Data Area: QUSRBRM/Q1ASYNTIM
In V5R4M0 and above, with the listed BRMS PTFS or their superseding PTF, BRMS will no longer support the Option 8 "Set time" on the network panel (WRKPCYBRM *SYS Option 4). If users still want to use the function, for those that depend on it, a data area can be created. However, we strongly advise being careful with this function, and make sure you are only syncing the times between systems within the same network and time zone. To enable the "Set Time" function, create a data area:
CRTDTAARA DTAARA(QUSRBRM/Q1ASYNTIM) TYPE(*CHAR) LEN(1)
This option will be disabled when the following PTF or their supersedes are applied and the data area does not exist:
o SI38733 for V5R4M0
o SI38739 for V6R1M0
o SI38740 for V7R1M0
Data Area: QTEMP/Q1ASPLTMZN
This data area is used to restore spool file data that was saved in a different time zone than time zone of the system doing the restore.
CRTDTAARA QTEMP/Q1ASPLTMZN TYPE(*CHAR) LEN(10) VALUE('xxxxxxxxxx')
where 'xxxxxxxxxx' is the time zone value of the system where the original save was done. For example:
CRTDTAARA QTEMP/Q1ASPLTMZN TYPE(*CHAR) LEN(10) VALUE('Q0000UTC ')
Notes:
1. To use this data area, the following PTFs or their superseding PTFs are required:
- V7R1M0 SI40005
- V6R1M0 SI40006
- V5R4M0 SI40001
2. This data area will not be supported for spool files saved in releases after IBM i 7.1. In releases after IBM i 7.1, the time zone at the time of the save will be stored so that it can be used for any restores, no data area value will be required.
3. Without this data area, users may receive a message CPF3770 when restoring spooled files from a system that has a different time zone specified or the time zone on the system has been changed since the spooled files were saved.
4.In releases IBM i 7.2 and later, the time zone at the time of the save will be stored with BRMS save history so that it can be used as a reference during restores.
Data Area: QUSRBRM/Q1ACTGPMPT
In V6R1 and above, option 6 on the Work with Media Library Media screen for the WRKMLMBRM command can be used to change the category of a media volume. If the volume that you select is a BRMS volume, option 6 will reset the category to be consistent with the media class of the volume without prompting for user input.
To force prompting on each of the volumes when option 6 is specified, create data area QUSRBRM/Q1ACTGPMPT with the following command. This will change the prompting behavior for option 6 in all jobs on the system.
To remove prompting when option 6 is specified, delete data area QUSRBRM/Q1ACTGPMPT with the following command.
Note: The described behavior applies to systems that have the following BRMS PTFs or their superseding PTFs are applied:
3. Without this data area, users may receive a message CPF3770 when restoring spooled files from a system that has a different time zone specified or the time zone on the system has been changed since the spooled files were saved.
4.In releases IBM i 7.2 and later, the time zone at the time of the save will be stored with BRMS save history so that it can be used as a reference during restores.
Data Area: QUSRBRM/Q1ACTGPMPT
In V6R1 and above, option 6 on the Work with Media Library Media screen for the WRKMLMBRM command can be used to change the category of a media volume. If the volume that you select is a BRMS volume, option 6 will reset the category to be consistent with the media class of the volume without prompting for user input.
To force prompting on each of the volumes when option 6 is specified, create data area QUSRBRM/Q1ACTGPMPT with the following command. This will change the prompting behavior for option 6 in all jobs on the system.
CRTDTAARA DTAARA(QUSRBRM/Q1ACTGPMPT) TYPE(*DEC) LEN(1)
To remove prompting when option 6 is specified, delete data area QUSRBRM/Q1ACTGPMPT with the following command.
DLTDTAARA DTAARA(QUSRBRM/Q1ACTGPMPT)
Note: The described behavior applies to systems that have the following BRMS PTFs or their superseding PTFs are applied:
- V7R1M0 SI40005
- V6R1M0 SI40006
Data Area: QUSRBRM/Q1AIPLSUB
A control group may try to put the system into restricted state. If an attempt is made to restart the controlling subsystem and the system does has not reached restricted state, a CPF1099 may be sent because the control subsystem is still trying to end. The only way to get out of this state is to IPL the system.
In releases V5R4M0 and later, if BRMS receives a CPF1099 when it tries to start the controlling subsystem and data area QUSRBRM/Q1AIPLSUB exists, the system will be IPL-ed. IPL options from the control group are used. These options may be referencing the BRMS Backup Policy or even the BRMS System Policy. The control group does not need to be set to IPL *YES in order for this IPL to occur.
CRTDTAARA DTAARA(QUSRBRM/Q1AIPLSUB) TYPE(*CHAR) LEN(1)
Note: In release V5R4M0 or later, the following PTFs or their superseding PTFs are required:
- V7R1M0 SI41206
- V6R1M0 SI41205
- V5R4M0 SI41204
Data Area: QUSRBRM/Q1ACHGOWNX
In releases V5R4M0 and later, it's possible for BRMS volumes to be owned by a system that is not in the BRMS network. Support has been added to the STRMNTBRM command to change the owner of expired BRMS volumes that are not owned by a system in the BRMS network. The owner will be changed to the system on which the STRMNTBRM is being run. To enable this new function, run the following command:
CRTDTAARA DTAARA(QUSRBRM/Q1ACHGOWNX) TYPE(*CHAR)
To disable this new function, run the following command:
DLTDTAARA DTAARA(QUSRBRM/Q1ACHGOWNX)
Notes:
1.It is recommended to only create the data area on one system in a BRMS network. This will help with contention if multiple systems run
STRMNTBRM at the same time.2.If
STRMNTBRM is run in restricted state, this data area will be ignored and no volume ownership changes will occur.3.In release IBM i 7.1 or earlier, the following PTFs or their superseding PTFs are required:
- V7R1M0 SI42066
- V6R1M0 SI42065
- V5R4M0 SI42064
Data Area: QUSRBRM/Q1ANOVFYM
In V5R4M0 and above, volume selection will protect volumes that are in verify move status. After the move media command (MOVMEDBRM) has been ran, volumes that need to have movement verified will not be selected as append candidates.
To enable the old behavior which allows media in verify move status to be selected as an append candidate, run the following command:
CRTDTAARA DTAARA(QUSRBRM/Q1ANOVFYM) TYPE(*CHAR)
Note:
1.The use of data area
QUSRBRM/Q1ANOVFYM can be affected by how a media library ejects volumes during the move process.2.Volumes that are expired are not checked for movement verification pending status.
3.For releases after IBM i 7.1, no PTF is required. For release IBM i 7.1 and earlier, the following PTFs or their superseding PTFs are required:
- V7R1M0 SI42925
- V6R1M0 SI42924
- V5R4M0 SI42923
Data Area: QTEMP/Q1ACLRSQL
Activation group Q1ABRMS uses SQL CLI with open data sources. The open data sources may cause conflicts with other users of the SQL CLI that change environment variables in the same job. To prohibit these SQL CLI conflicts within a job, run the following commands:
1) CRTDTAARA DTAARA(QTEMP/Q1ACLRSQL) TYPE(*CHAR)
2) QSYS/CALL PGM(QBRM/Q1AOLD) PARM('CLSSQLENV ')
Note: In releases IBM i 7.1 and earlier, the following PTFs or their superseding PTFs are required:
- V7R1M0 SI43868
- V6R1M0 SI43869
- V5R4M0 SI43862
Data Area: QTEMP/Q1ANSTRPSN
An enhancement to enable fast media positioning during restores was added for releases IBM i 7.1 and above. The new function is enabled within BRMS by default. It may be necessary to disable fast positioning if a restore fails with a CPF5183 message. To disable the function, run the following command:
CRTDTAARA DTAARA(QTEMP/Q1ANSTRPSN) TYPE(*CHAR)
Data Area: QUSRBRM/Q1ACLSNONE
This data area allows BRMS to pick any media class in a tape media library or any media class that is loaded in a tape drive.
CRTDTAARA DTAARA(QUSRBRM/Q1ACLSONE) TYPE(*CHAR) LEN(1)
Note:
1. Specify *NONE for the media class in the media policy.
2. Once a density is selected, all additional media being selected in the current job will have to have the same density (cartridge type - LTO).
3. No mixed densities (cartridge types - LTO) within a media set
4. If doing parallel saves, all the cartridges will have to have the same density or cartridge type (LTO)
5. The following PTFs or their superseding PTFs are required:
o V7R2M0 SI52668
o V7R1M0 SI51667
o V6R1M0 SI51666
2. Once a density is selected, all additional media being selected in the current job will have to have the same density (cartridge type - LTO).
3. No mixed densities (cartridge types - LTO) within a media set
4. If doing parallel saves, all the cartridges will have to have the same density or cartridge type (LTO)
5. The following PTFs or their superseding PTFs are required:
o V7R2M0 SI52668
o V7R1M0 SI51667
o V6R1M0 SI51666
Data Area: QUSRBRM/Q1ARMTEJT
Eject media from an MLB that is not configured on the local system
In releases IBM i 6.1 and later, if media that is being moved is owned by another system and the media is in an MLB that is not configured on the system doing movement, BRMS can be set up to attempt to eject the volume from the MLB on the system that owns the volume. Systems need to be in the same BRMS network
To enable this function, run the following command to create the data area:
CRTDTAARA DTAARA(QUSRBRM/Q1ARMTEJT) TYPE(*CHAR)
[{"Type":"MASTER","Line of Business":{"code":"LOB68","label":"Power HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG60","label":"IBM i"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1.0"}]
Historical Number
322855291
Was this topic helpful?
Document Information
Modified date:
20 February 2025
UID
nas8N1019257