Backup and Restore Manager for z/VM

https://www.ibm.com/docs/en/backup-restore-zvm/1.3.0
Admin
Backup and Restore Manager for z/VM is an IBM product designed to manage backup and restore...
Tokens:177,955
Snippets:2,183
Trust Score:10
Update:10 months ago
Show doc for...
Tokens:
Raw
### Catalog Server Status Output Example

Source: https://www.ibm.com/docs/en/backup-restore-zvm/1.3.0/index_topic=server-displaying-status-catalog

This is an example of the output generated when the STATUS command is executed against the catalog server (BKRCATLG). It details the server's name, version, compilation date, owner, start time, associated backup SVM, catalog base path, and storage group utilization.

```text
smsg bkrcatlg status    
Ready; 
SVM Name    : BKRCATLG - 5697-J06 IBM Backup and Restore Manager for z/VM - Backup Catalog
SVM - Version 1.3.0 
Runtime lib : Compiler
Compiled on : 5 Jan 2015 - 11:11:53  
SVM Owner   : A. User - any.user@address.com 
SVM Started : Monday, 27 Jan 2015 10:31:28      
Backup SVM  : BKRBKUP  
Catalog base: BKRSFS:BKRCATLG.        
Userid       Storage Group     4K Block Limit    4K Blocks Committed     Threshold
BKRCATLG          2                179804             51781-28%             90% 
```

--------------------------------

### Job Syntax Examples

Source: https://www.ibm.com/docs/en/backup-restore-zvm/1.3.0/index_topic=codes-bkr9100i

Provides examples of the job syntax used for defining backup and restore operations in IBM Backup and Restore Manager for z/VM. Understanding this syntax is critical for creating and executing jobs. The examples illustrate the structure and available parameters.

```job control language
JOB BACKUP_FULL_SYSTEM
  TYPE FULL
  DESTINATION TAPE
  DATE 2023-10-27
ENDJOB

JOB RESTORE_FILES
  TYPE DIFFERENTIAL
  SOURCE TAPE
  FILES "/u/user/data/*"
ENDJOB
```

--------------------------------

### Sample Job Template Descriptions for IBM Backup and Restore Manager for z/VM

Source: https://www.ibm.com/docs/en/backup-restore-zvm/1.3.0/index_topic=codes-bkr8822e

This section provides example job templates that can be used with IBM Backup and Restore Manager for z/VM. These templates serve as starting points for users to define their backup and restore jobs. The actual templates are not shown.

```template
Sample job template descriptions
```

--------------------------------

### Get Catalog Server Status

Source: https://www.ibm.com/docs/en/backup-restore-zvm/1.3.0/index_topic=commands-status

This example shows the STATUS command output for the catalog server (BKRCATLG). It includes SVM details, catalog base information, and SFS utilization statistics like committed blocks and threshold percentages.

```z/VM console
smsg bkrcatlg status   
Ready; T=0.01/0.01 21:35:11   
 SVM Name: CATSRVR - 5697-J06 IBM Backup and Restore Manager for z/VM - Backup Catalog SVM - Version 1.3.0
 Compiled on : 17 Dec 2015 - 15:14:37 
 Runtime lib : Alternate
 SVM Owner   : BKR 1.3.0 Production - bkradmin@address.com   
 SVM Started : Tuesday, 9 Feb 2016 14:08:31   
 Backup SVM  : BKRBKUP
 Catalog base: BKRSFS:BKRCATLG. 
 Userid    Storage Group  4K Block Limit  4K Blocks Committed  Threshold
 BKRCATLG          2              500000        171604-34%       90%    
```

--------------------------------

### Example REXX Command for RESTORE Operation (REXX)

Source: https://www.ibm.com/docs/en/backup-restore-zvm/1.3.0/index_topic=routines-bkrjob

An example of how to use the generated REXX exec lines to issue a RESTORE command for all exec files. This command specifies the target reader and file type, demonstrating the flexibility of the exec format.

```REXX
BKR RESTORE %% TO RDR USER1 - * EXEC *

```

--------------------------------

### Get Worker Server Status

Source: https://www.ibm.com/docs/en/backup-restore-zvm/1.3.0/index_topic=commands-status

This example shows the STATUS command output for a worker server (BKRWRK01). It displays SVM name, compilation date, and the type of runtime library in use (Compiler).

```z/VM console
smsg bkrwrk01 status   
Ready; T=0.01/0.01 21:35:50   
 SVM Name: WRKSRVR - 5697-J06 IBM Backup and Restore Manager for z/VM - Worker Task SVM - Version 1.3.0   
 Compiled on : 27 Jan 2016 - 11:12:19 
 Runtime lib : Compiler   
```

--------------------------------

### Sample Console Output for IBM Z/VM

Source: https://www.ibm.com/docs/en/backup-restore-zvm/1.3.0/index_topic=syntax-console

This snippet shows the expected console output when running a sample job in IBM Z/VM. It is a straightforward text output indicating the start of a sample job process.

```text
CONSOLE * Sample Job
```

--------------------------------

### Example REXX Command for RESTORE Operation

Source: https://www.ibm.com/docs/en/backup-restore-zvm/1.3.0/index_topic=routines-bkrxntd

This example REXX command illustrates how to issue a RESTORE command for all 'EXEC' type granules. It dynamically constructs the command using placeholders and directs the output to the reader of 'USER1' on the issuing node, demonstrating the flexibility of the BKR EXEC format.

```REXX
BKR RESTORE %% TO RDR USER1 - * EXEC *
```

--------------------------------

### Get Primary Backup Server Status (No Active Workers)

Source: https://www.ibm.com/docs/en/backup-restore-zvm/1.3.0/index_topic=commands-status

This example shows the output of the STATUS command for a primary backup server (BKRBKUP) with no active workers. It displays general SVM information and indicates that workers are logged out.

```z/VM console
smsg bkrbkup status
Ready; T=0.01/0.01 21:35:04   
 SVM Name   : BKRBKUP - 5697-J06 IBM Backup and Restore Manager for z/VM - Primary Backup SVM - Version 1.3.0  
 Compiled on: 19 Jan 2016 - 16:18:47  
 Runtime lib: Compiler
 SVM Owner  : BKR 1.3.0 Production - bkradmin@address.com
 SVM Started: Tuesday, 9 Feb 2016 14:08:17
 Catalog SVM: BKRCATLG
 Worker info as of 21:39:48:                               
   BKRWRK01 - Logged out at 21:37:50 on Friday, 4 Mar 2016. 
   BKRWRK02 - Logged out at 02:19:21 on Friday, 4 Mar 2016.
```

--------------------------------

### Query Instance Command Example (Job Not Found)

Source: https://www.ibm.com/docs/en/backup-restore-zvm/1.3.0/index_topic=commands-query-instance

This example demonstrates the error response when the QUERY INSTANCE command is issued for a job that does not exist, such as 'NOSUCHJOB'. It shows the command and the error message returned, indicating that no matching instances were found. This helps in diagnosing issues related to non-existent jobs.

```shell
CP SMSG BKRBKUP QUERY INSTANCE NOSUCHJOB
Ready;
 BKRBAK9187E No automatically managed instances matching filter NOSUCHJOB were found.

```

--------------------------------

### Get Primary Backup Server Status (Active Workers and Progress)

Source: https://www.ibm.com/docs/en/backup-restore-zvm/1.3.0/index_topic=commands-status

This example demonstrates the STATUS command output for a primary backup server with active workers. It shows the current job and task progress for each worker, including file-level or image backup details and progress percentages.

```z/VM console
sm bkrbkup status
SVM Name   : BAKSRVR - 5697-J06 IBM Backup and Restore Manager for z/VM - Master Backup SVM - Version 1.3.0
 Compiled on: 9 Jan 2022 - 23:08:41
 Runtime lib: Compiler
 SVM Owner  : System Administrator - sysadmin@some.corp.com
 SVM Started: Friday, 25 Mar 2022 12:01:14
 Catalog SVM: BKRCATLG
 Worker info as of 01:15:37:
   BKRWRK01 - Processing job SAMPFULL/00000199, task 49 of 180; EDF file-level backup of MDISK MAINT 019D since 01:15:35 on Thursday, 14 Apr 2022.
              Progress: CMS file 6000 of 17989
   BKRWRK02 - Processing job SAMPFULL/00000199, task 48 of 181; CKD image backup of MDISK MAINT 0123 since 01:14:38 on Thursday, 14 Apr 2022.
              Progress: ECKD Track 115499 of 150254
```

```z/VM console
sm bkrbkup status
SVM Name   : BAKSRVR - 5697-J06 IBM Backup and Restore Manager for z/VM - Master Backup SVM - Version 1.3.0
 Compiled on: 9 Jan 2022 - 23:08:41
 Runtime lib: Compiler
 SVM Owner  : System Administrator - sysadmin@some.corp.com
 SVM Started: Friday, 25 Mar 2022 12:01:14
 Catalog SVM: BKRCATLG
 Worker info as of 01:16:18:
   BKRWRK01 - Processing job SAMPFULL/00000199, task 54 of 181; CKD image backup of MDISK MAINT720 0131 since 01:15:49 on Thursday, 14 Apr 2022.
              Progress: ECKD Track 52499 of 150254
   BKRWRK02 - Processing job SAMPFULL/00000199, task 105 of 186; CKD image backup of MDISK TS3163 3191 since 01:16:11 on Thursday, 14 Apr 2022.
              Progress: ECKD Track 10499 of 71144
```

```z/VM console
sm bkrbkup status
SVM Name   : BAKSRVR - 5697-J06 IBM Backup and Restore Manager for z/VM - Master Backup SVM - Version 1.3.0
 Compiled on: 9 Jan 2022 - 23:08:41
 Runtime lib: Compiler
 SVM Owner  : System Administrator - sysadmin@some.corp.com
 SVM Started: Friday, 25 Mar 2022 12:01:14
 Catalog SVM: BKRCATLG
 Worker info as of 01:20:23:
   BKRWRK01 - Processing job SAMPFULL/00000199, task 157 of 182; SFS backup of VMPSFS:MAINT720. since 01:20:02 on Thursday, 14 Apr 2022.
              Progress: 4K block 131118 of 146862
   BKRWRK02 - Logged out at 01:19:00 on Thursday, 14 Apr 2022.
```

--------------------------------

### Query Instance Command Example (SAMPFULL)

Source: https://www.ibm.com/docs/en/backup-restore-zvm/1.3.0/index_topic=commands-query-instance

This example shows how to use the QUERY INSTANCE command to retrieve the current instance number for the 'SAMPFULL' template. It displays the command issued and the successful response indicating the instance number. This is useful for verifying backup job configurations.

```shell
CP SMSG BKRBKUP QUERY INSTANCE SAMPFULL
Ready;
 BKRBAK9188I Current instance for job SAMPFULL is set to 114.

```
Tokens:
Raw