IBM Support

PM56778: THIS PTF PROVIDES BUG FIXES AND UPDATES TO SAMPLE CODE.

A fix is available

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • This PTF provides bug fixes and updates to sample code.
    .
    Bug fix: Corrects an error in tape mount processing which
    could trigger message BKRTIO8180E during EOV processing.
    .
    Bug fix: Corrects an error affecting backup jobs created
    from templates which use INCLUDE RDEVVOL statements.
    Objects selected for backup via INCLUDE RDEVVOL were
    skipped during backup with message BKRRVB9303W displayed.
    .
    Bug fix: When end-user catalog browsing tools (BKRJOB, etc)
    are invoked without a R/W minidisk or directory accessed as
    file mode "A", they will now terminate with message 9358E,
    "Filemode A must be accessed R/W to use this EXEC."
    .
    Bug fix: End-user catalog browsing tools have been updated
    to address an inconsistency; panel headers now consistently
    display "object" instead of sometimes displaying "device".
    .
    Bug fix: Sample restore processing routines have been
    updated to incorporate additional run-time variables for
    various LOAD routines.
    .
    Enhancement: Backup jobs which use the DDRTAPE output
    handler can now declare an additional setting in the header
    section of the backup job template. When
    "CONFIG BKR_Job_DDRTAPE_Verbose = Yes" is specified,
    DDRTAPE backup jobs will issue message 9359I at
    start-of-backup for each minidisk. Message 9359I displays
    the beginning tape position for the minidisk image:
    .
    BKRRVB9359I DDR-format backup of <userid> <devno> starts
    on volume <volser>, file <offset>, block ID <block ID>.
    .
    Behavior change: Service virtual machine console logs now
    display output from CP, CMS, SUBMIT, REVIEW and RESTART
    commands with a prefix of the command which generated the
    output, instead of prefacing each line with "Output line nnn:".
    For example, the service machine console response to CP QUERY
    USERID is now logged as "CP: userid AT nodename" instead of
    "Output line 1: userid AT nodename". Automated operations
    processes which inspect service machine console responses to
    these commands may need to be revised to accommodate this
    change.
    New sample code: A new sample version of customer exit
    BKREXI03 is being shipped as "ALTEXI03 SAMPEXEC". This
    version of BKREXI03 honors the settings for reserved workers
    (for backup or restore jobs) in BKRSYSTEM CONFIG. Workers
    from the beginning of the worker list are reserved for backups,
    those from the end of the list for restores. Overlaps are
    detected and reported but the reserved worker settings will not
    be overridden even if no workers are available as a result.
    .
    For each job, idle workers are selected first. If there are not
    enough idle workers, then busy workers will be selected on
    "least recently used" basis, i.e., those which have had no work
    assigned by this exit for the longest interval will be chosen
    first
    

Local fix

  • 
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users                                    *
    ****************************************************************
    * PROBLEM DESCRIPTION: This PTF provides bug fixes and         *
    *                      updates to sample code.                 *
    *                                                              *
    *                      Bug fix: Corrects an error in tape      *
    *                      mount processing which could trigger    *
    *                      message BKRTIO8180E during EOV          *
    *                      processing.                             *
    *                                                              *
    *                      Bug fix: Corrects an error affecting    *
    *                      backup jobs created from templates      *
    *                      which use INCLUDE RDEVVOL statements.   *
    *                      Objects selected for backup via         *
    *                      INCLUDE RDEVVOL were skipped during     *
    *                      backup with message BKRRVB9303W         *
    *                      displayed.                              *
    *                                                              *
    *                      Bug fix: When end-user catalog          *
    *                      browsing tools (BKRJOB, etc) are        *
    *                      invoked without a R/W minidisk or       *
    *                      directory accessed as file mode "A",    *
    *                      they will now terminate with message    *
    *                      9358E, "Filemode A must be accessed     *
    *                      R/W to use this EXEC."                  *
    *                                                              *
    *                      Bug fix: End-user catalog browsing      *
    *                      tools have been updated to address an   *
    *                      inconsistency; panel headers now        *
    *                      consistently display "object" instead   *
    *                      of sometimes displaying "device".       *
    *                                                              *
    *                      Bug fix: Sample restore processing      *
    *                      routines have been updated to           *
    *                      incorporate additional run-time         *
    *                      variables for various LOAD routines.    *
    *                                                              *
    *                      Enhancement: Backup jobs which use the  *
    *                      DDRTAPE output handler can now declare  *
    *                      an additional setting in the header     *
    *                      section of the backup job template.     *
    *                      When "CONFIG BKR_Job_DDRTAPE_Verbose =  *
    *                      Yes" is specified, DDRTAPE backup jobs  *
    *                      will issue message 9359I at             *
    *                      start-of-backup for each minidisk.      *
    *                      Message 9359I displays the beginning    *
    *                      tape position for the minidisk image:   *
    *                                                              *
    *                      BKRRVB9359I DDR-format backup of        *
    *                      <userid> <devno> starts on volume       *
    *                      <volser>, file <offset>, block ID       *
    *                      <block ID>.                             *
    *                                                              *
    *                      Behavior change: Service virtual        *
    *                      machine console logs now display        *
    *                      output from CP, CMS, SUBMIT, REVIEW     *
    *                      and RESTART commands with a prefix of   *
    *                      the command which generated the         *
    *                      output, instead of prefacing each line  *
    *                      with "Output line nnn:". For example,   *
    *                      the service machine console response    *
    *                      to CP QUERY USERID is now logged as     *
    *                      "CP: userid AT nodename" instead of     *
    *                      "Output line 1: userid AT nodename".    *
    *                      Automated operations processes which    *
    *                      inspect service machine console         *
    *                      responses to these commands may need    *
    *                      to be revised to accommodate this       *
    *                      change.                                 *
    *                                                              *
    *                      New sample code: A new sample version   *
    *                      of customer exit BKREXI03 is being      *
    *                      shipped as "ALTEXI03 SAMPEXEC". This    *
    *                      version of BKREXI03 honors the          *
    *                      settings for reserved workers (for      *
    *                      backup or restore jobs) in BKRSYSTEM    *
    *                      CONFIG. Workers from the beginning of   *
    *                      the worker list are reserved for        *
    *                      backups, those from the end of the      *
    *                      list for restores. Overlaps are         *
    *                      detected and reported but the reserved  *
    *                      worker settings will not be overridden  *
    *                      even if no workers are available as a   *
    *                      result.                                 *
    *                                                              *
    *                      For each job, idle workers are          *
    *                      selected first. If there are not        *
    *                      enough idle workers, then busy workers  *
    *                      will be selected on "least recently     *
    *                      used" basis, i.e., those which have     *
    *                      had no work assigned by this exit for   *
    *                      the longest interval will be chosen     *
    *                      first.                                  *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    

Problem conclusion

  • 
    

Temporary fix

  • 
    

Comments

  • 
    

APAR Information

  • APAR number

    PM56778

  • Reported component name

    BACKUP RESTORE

  • Reported component ID

    5697J0600

  • Reported release

    120

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2012-01-26

  • Closed date

    2012-02-07

  • Last modified date

    2012-02-29

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

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

    UK75998

Modules/Macros

  •    ALTEXI03 BAKSRVR  BKRBLSAM BKRDREOV BKRDRMNT
    BKRDRUMT BKREOV   BKRESTOR BKRFCAT  BKRJOB   BKRMOUNT BKRREST
    BKRUME   BKRUMNT  CATSRVR  CKDLOAD  DDLLOAD  DDRSAMP  EDFLOAD
    EUMBKREV EUMBKRMT EUMBKRUM EUMDRMNT FBALOAD  RELOAD   RVB$JOB
    SFSLOAD  WRKSRVR
    

Fix information

  • Fixed component name

    BACKUP RESTORE

  • Fixed component ID

    5697J0600

Applicable component levels

  • R120 PSY UK75998

       UP12/02/28 P 1202

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.

[{"Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSMR4R","label":"Backup and Restore Manager for z\/VM"},"ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.2.0"}]

Document Information

Modified date:
22 March 2021