PM36438: UPDATES FOR 5697-J06 IBM BACKUP AND RESTORE MANAGER FOR Z/VM 1.2.0

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Commands for BKRBKUP and BKRCATLG which involve an instance
  number no longer require the user to manually pad that value
  with leading zeroes; for example, commands involving instance
  33 of a job can now specify "33" as an argument instead of
  "00000033".
  .
  Mixed-case sensitivities have been addressed; mixed- versus
  upper-case issues affecting several commands have been
  eliminated.
  .
  The REVIEW command now inserts an instance number for $$INST$$
  Which reflects an updated instance number, rather than the
  current active instance number retained by BKRBKUP. REVIEW does
  not update the saved value for the active instance number.
  .
  The EXPIRE command now supports arguments for job name and/or
  Job instance. LISTFILE-style wild-card expressions are supported
  .
  The QUERY TAPES command now supports arguments for job name
  and/or Job instance. LISTFILE-style wild-card expressions are
  supported.
  .
  User exit BKREXI03 has been enabled for BKRBKUP. This exit
  Routine allows site-level override of the default, built-in
  logic used to select worker service virtual machines (BKRWRKnn)
  for backup or restore operations.
  .
  Sample PROFILE EXEC routines for BKRBKUP, BKRCATLG and BKRWRKnn
  service virtual machines have been updated with additional CMS
  "DEFAULTS" settings. The changes ensure that activity involving
  SENDFILE, RECEIVE and NETDATA invocations do not fill up the
  service virtual machine's A-disk with NETLOG files.
  .
  Sample backup job templates which use the CMSFILE output method
  Have been updated to illustrate use of the
  "BKR_Job_Tolerate_DiskPool_Depletion" option.
  .
  Sample backup job templates have been updated to illustrate
  use of the "Summarize" verb. Use of the "CP IND USER" command
  to display rudimentary resource usage stats at end-of-job has
  been replaced by "CP IND USER * EXP" in order to display more
  detailed information.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users                                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: Commands for BKRBKUP and BKRCATLG which *
  *                      involve an instance number no longer    *
  *                      require the user to manually pad that   *
  *                      value with leading zeroes; for example, *
  *                      commands involving instance 33 of a job *
  *                      can now specify "33" as an argument     *
  *                      instead of "00000033".                  *
  *                                                              *
  *                      Mixed-case sensitivities have been      *
  *                      addressed; mixed- versus upper-case     *
  *                      issues affecting several commands have  *
  *                      been eliminated.                        *
  *                                                              *
  *                      The REVIEW command now inserts an       *
  *                      instance number for $$INST$$ which      *
  *                      reflects an updated instance number,    *
  *                      rather than the current active instance *
  *                      number retained by BKRBKUP. REVIEW does *
  *                      not update the saved value for the      *
  *                      active instance number.                 *
  *                                                              *
  *                      The EXPIRE command now supports         *
  *                      arguments for job name and/or job       *
  *                      instance. LISTFILE-style wild-card      *
  *                      expressions are supported.              *
  *                                                              *
  *                      The QUERY TAPES command now supports    *
  *                      arguments for job name and/or job       *
  *                      instance. LISTFILE-style wild-card      *
  *                      expressions are supported.              *
  *                                                              *
  *                      User exit BKREXI03 has been enabled for *
  *                      BKRBKUP. This exit routine allows       *
  *                      site-level override of the default,     *
  *                      built-in logic used to select worker    *
  *                      service virtual machines (BKRWRKnn) for *
  *                      backup or restore operations.           *
  *                                                              *
  *                      Sample PROFILE EXEC routines for        *
  *                      BKRBKUP, BKRCATLG and BKRWRKnn service  *
  *                      virtual machines have been updated with *
  *                      additional CMS "DEFAULTS" settings. The *
  *                      changes ensure that activity involving  *
  *                      SENDFILE, RECEIVE and NETDATA           *
  *                      invocations do not fill up the service  *
  *                      virtual machine's A-disk with NETLOG    *
  *                      files.                                  *
  *                                                              *
  *                      Sample backup job templates which use   *
  *                      the CMSFILE output method have been     *
  *                      updated to illustrate use of the        *
  *                      "BKR_Job_Tolerate_DiskPool_Depletion"   *
  *                      option.                                 *
  *                                                              *
  *                      Sample backup job templates have been   *
  *                      updated to illustrate use of the        *
  *                      "Summarize" verb. Use of the "CP IND    *
  *                      USER" command to display rudimentary    *
  *                      resource usage stats at end-of-job has  *
  *                      been replaced by "CP IND USER * EXP" in *
  *                      order to display more detailed          *
  *                      information.                            *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UK66530

Modules/Macros

•    BAKSRVR  BKRBLSAM BKRESTOR BKREXI03 BKRUME
  CATPROF  CATSRVR  DDRSAMP  MAKEJOB  MASTPROF SAMPDR   SAMPFULL
  SAMPINCR SAMPLNX  SFSONLY  WRKPROF  ZVM51    5697J06B
  

Fix information

• Fixed component name

  BACKUP RESTORE

• Fixed component ID

  5697J0600

Applicable component levels

• R120 PSY UK66530

     UP11/04/25 P 1104

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.