Backup Control Group Status Report

The Print Report using BRM (PRTRPTBRM) command has been enhanced to support the *CTLGRPSTAT value on the Report type (TYPE) parameter. The *CTLGRPSTAT report provides summarized information about backup control groups, specified on the Control group (CTLGRP) parameter, that have been processed by BRMS and meet the other selection criteria specified on the PRTRPTBRM command.

The following values can be specified for the CTLGRP parameter:

*ALL - All backups produced by running STRBKUBRM will be included in this report. Note The output generated by CTLGRP(*NONE) will not be included in this report.
*SYSTEM - Backups produced by running STRBKUBRM for the *SYSTEM control group will be included in the report.
*BKUGRP - Backups produced by running STRBKUBRM for the *BKUGRP control group will be included in the report.
*SYSGRP - Backups produced by running STRBKUBRM for the *SYSGRP control group will be included in the report.
*NONE - Backups produced by running SAVxxxBRM commands will be summarized in the report.
generic name - Specify the generic name of the control group to be included in the report. A generic name is a character string that contains one or more characters followed by an asterisk (*). If an * is not specified with the name, the name is assumed to be a complete control group name.
name - Specify the name of a control group. All backups produced by running STRBKUBRM for the named control group will be included in the report.

NOTE: This parameter is ignored when parameter Type (TYPE) is not *CTLGRPSTAT.

Retention Information

The output from PRTRPTBRM TYPE(*CTLGRPSTAT) will include a retention section if a value other than *NONE is specified for the CTLGRP parameter. The retention section will start on a new page with a heading of *RETENTION. Each control group will have an entry with full and incremental retention information.

To have the retention section included by PRTRPTBRM, data area QTEMP/Q1ARPTRETN must exist. Use the following command to create the data area:

CRTDTAARA DTAARA(QTEMP/Q1ARPTRETN) TYPE(*CHAR)

Detailed Completion Information

The output from PRTRPTBRM provides more detailed completion information.

The output from PRTRPTBRM TYPE(*CTLGRPSTAT) includes the following states:

*ERROR - The backup failed.
*NOERR - The backup completed with no errors.
*QUAL - The backup completed but not all objects were saved.
*ACT - The backup is currently running and has not completed.
*CANCL - The backup was cancelled.
*ENC - The backup was encrypted.

The output from PRTRPTBRM TYPE(*CTLGRPSTAT) OUTPUT(*OUTFILE) includes the following states:

Save Status	Description
*ERROR	The backup failed.
*NOERR	The backup completed with no errors.
*QUAL	The backup completed but not all objects were saved.
*ACT	The backup is currently running and has not completed.
*CANCL	The backup was cancelled.

The output from PRTRPTBRM TYPE(*BKUSTAT) includes the following states:

*ERROR - The backup failed.
*NOERR - The backup completed with no errors.

NOTES:

If using the option to synchronize BRMS saved history using System Synchronization support for *SYSBAS, BRMS will not synchronize the backup control group information. In order to get the report for the control groups for these saves, the FROMSYS() parameter will need to be used.
PRTRPTBRM report entries will change after BRMS maintenance is run.
- When using PRTRPTBRM TYPE(*BKUSTAT) the following entries change:
  - Entries releated to expired volumes will be removed from the report.
- When using PRTRPTBRM TYPE(*CTLGRPSTAT) the following entries change:
  - Entries with a Save Status of *NOERR or *QUAL are removed one year after the backup history expires, even if the media has been reused.
  - Entries with a Save Status of *ACT are changed to *ERROR if the job no longer exists.
  - Entries with a Save Status of *ERROR or *CANCL are removed after 30 days.
BRMS calculates the GB/HR from the start to stop time of the control group and the approximate amount of data saved minus the size of the access paths. For example, logical file access paths may be included in the save size even if they are not saved to the media. This time can include:
- Delay waiting for subsystems to end and TCP/IP.
- Wait time for SWA
- Wait time for locks
- Possible delays in exits in control groups
- Wait times for loading multiple cartridges
- Running CL commands in exits
- Other activity on the system at the time of the backup
When multiple volumes are used in a control group, the QP1ABS report will list all volumes used by the control group, however it will only list information about the save for the first volume. All other volumes used in the save will have 0's for all values except the additional volume IDs. Similarly, when *NONE is specified for the control group, all volumes used will be listed but only the first volume will have data, the rest will have 0's for all the other values.
The Missed Object count does not include objects not saved if the following occurs:
- A library is locked and cannot be saved
- When running incremental or cumulative saves, the only objects in a library that may be candidates to be saved are locked.
- Does not include missed spooled files. Need to refer to the CPF3771 message in the backup joblog.
The Save Size (MB) reported by BRMS uses 1000 per KB versus 1024 which could represent about a 10% difference.

Additional help text for new parameters

As not all new options for the PRTRPTBRM command in IBM i 7.2 have help text, the new help text is listed below:

Report type (TYPE)
Specifies the type of the report you want to print or generate output file.

*BKUSTAT

This report provides summarized information about all objects that have been saved by BRMS within a specified period.

*CTLGRPSTAT
This report provides summarized information about all backup control groups that have been processed by BRMS and meet the selection criteria.

Control group (CTLGRP)
Specifies which backup control group should be included in the report. This parameter is ignored when parameter Type (TYPE) is not *CTLGRPSTAT. Note: Backups produced by running STRBKUBRM commands will be included in the report for all values except *NONE.

*ALL
All backups produced by running STRBKUBRM will be included in this report. Note: The output generated by CTLGRP(*NONE) will not be included in this report.

*SYSTEM
Backups produced by the *SYSTEM control group will be included in the report.

*BKUGRP
Backups produced by the *BKUGRP control group will be included in the report.

*SYSGRP
Backups produced by the *SYSGRP control group will be included in the report.

*NONE
Backups produced by running SAVxxxBRM commands will be summarized in the report. This includes SAVxxxBRM commands that were associated with a control group.

generic name
Specify the generic name of the control group to be included in the report. A generic name is a character string that contains one or more characters followed by an asterisk (*). If an * is not specified with the name, the name is assumed to be a complete control group name.

name
Specify the name of the control group to be included in the report.

From system (FROMSYS)
Specifies the system name and network identification of the system whose backups will be used to produce the report.

Single values

*NETGRP
Report backups from all systems in the BRMS network.

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

*ENT
Report backups from all systems in the BRMS Enterprise network.

            NOTE:  The BRMS Network feature (Option 1) and BRMS Advanced feature (Option 2) are required to use this value.

*LCL

Report backups for the local system. BRMS uses the default local location name, LCLLOCNAME and not the system name SYSNAME. In most cases, the systems have the same value specified in the LCLLOCNAME and in the SYSNAME. You can use the DSPNETA command to view the system network attributes.

Other values (up to 100 repetitions)

location-name
Report backups from the specified name of the remote location associated with the system. The local system's network identifier, as seen by using the DSPNETA command, is used as the system's network identifier.

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

network-id.location-name
Specify the network identifier and the name of the remote location associated with the system. Specify these values using the format nnnnnnnn.cccccccc where nnnnnnnn is the network identifier and cccccccc is the remote location name.

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

Use save file (USESAVF)
Specifies whether you want backups to save files included in the report.

*YES
Include save file backups in the report.

*NO
Do not include save file backups in the report.

Use ADSM (USEADSM)

Specifies whether you want backups to TSM (ADSM) server included in the report.

*YES
Include TSM backups in the report.

*NO
Do not include TSM backups in the report.

New Expiration date parameter added in the following PTFs for releases 7.2 and later:
7.4 SI72867, 7.3 SI72866, 7.2 SI72865

Expiration date (EXPDATE)

Specifies which backup control group records should be included in the report. This parameter is ignored when the Type (TYPE) parameter is not *CTLGRPSTAT.

NOTE: Records from successful backup control group runs remain on the system for one year after the control group history expires.

*ALL
Include all backup control group records in the report.

*ACTIVE
Include active backup control group records in the report. Report records rom expired backup control groups are excluded.