Creating a Control Group

In the example that follows, you learn how to create a SAMPLE control group that contains three libraries: LIBA, LIBB, and LIBC.

To create a control group, take the following steps:

1. Type WRKCTLGBRM at a command line and press Enter. This takes you to the Work with Backup Control Groups display.

                           Work with Backup Control Groups             RCHAS400     
                                                                                    
    Position to . . . . . .               Starting characters                       
                                                                                    
    Type options, press Enter                                                       
      1=Create    2=Edit entries    3=Copy      4=Delete   5=Display                
        6=Add to schedule   8=Change attributes   9=Subsystems to process ...       
                                                                                    
                 Full       Incr      Weekly                                        
      Control    Media      Media     Activity                                      
   Opt Group     Policy     Policy    SMTWTFS  Text                                 
    1 SAMPLE                                                                        
      *BKUGRP    *BKUPCY    *BKUPCY   *BKUPCY  Entry created by BRM configuration   
      *SYSGRP    SAVSYS     SAVSYS    *BKUPCY  Entry created by BRM configuration   
      *SYSTEM    SYSTEM     SYSTEM    *BKUPCY  Entry created by BRM configuration   
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                            Bottom  
    F3=Exit      F5=Refresh   F7=Work with BRM scheduled jobs                       
    F9=Change backup policy   F23=More options   F24=More keys                      

2. To create a control group, type a 1 (Create) in the Opt column and a name for the control group in the Control Group field. In this case, the name of the control group is SAMPLE.
3. Press Enter. This takes you to the Create Backup Control Group Entries display.

                       Create Backup Control Group Entries              RCHAS400   
                                                                                   
    Group . . . . . . . . . . : SAMPLE                                             
    Default activity  . . . . . *BKUPCY                                            
    Text  . . . . . . . . . . . Create sample backup control group                 
                                                                                   
    Type information, press Enter.                                                 
                                                                                   
                                     Weekly   Retain Save     SWA                  
         Backup     List ASP         Activity Object While    Message    Sync      
    Seq  Items      Type Device      SMTWTFS  Detail Active   Queue      ID        
                                                                                   
      10 *EXIT                       *DFTACT                                       
      20 LIBA            *SYSBAS     *DFTACT  *ERR   *NO                           
      30 LIBB            *SYSBAS     *DFTACT  *ERR   *NO                           
      40 LIBC            *SYSBAS     *DFTACT  *ERR   *NO                           
      50 *EXIT                       *DFTACT                                       
                                                                                   
                                                                                   
                                                                                   
                                                                            Bottom 
    F3=Exit    F5=Refresh    F10=Change item    F11=Display exits                  
    F12=Cancel    F14=Display client omit status    F24=More keys                   

4. At the Create Backup Control Group Entries display, type the name of the first library you want to save in the Backup Items field. Press Enter. Because BRMS numbers the save sequence for you, you need to enter the library or object name in the order in which you want them to process. However, you can change the order by specifying a sequence number in between the two entries. BRMS notifies you if the library does not exist. If you do not know the name of the library you want to save, use F19 to get to the Select Libraries display. Press Enter at the Select Libraries display to get a list of libraries.
   Note:

   You can still create a control group with a library that does not exist. Pressing Enter a second time overrides the Library does not exist warning message. Press F3 to exit and take option 1 to save at the Create Backup Control Group Entries display.
5. Following are brief summaries of the other key parameters on this display.
   • The Weekly Activities field has seven single character fields available to designate the seven days of the week. You can use the default value for this field, which is *DFTACT, or you can set your own weekly activity schedule. *DFTACT specifies a full save (FFFFFFF) on all seven days. You can also tailor a daily mix of full (F) and incremental saves (I) to better suit your business needs, for example: IIFFIIF.
   • In the Retain Object Detail field, you can specify whether you want BRMS to save historical information about the control group item at the object level. In this example, we did not specify anything in the Retain Object Detail field, which subsequently resorts to the default *ERR (for error). Other values for this field are *YES, *NO, *OBJ, and *MBR. If you want to specify *OBJ at this prompt, you should also specify *OBJ at the Automatically backup media information parameter. BRMS establishes the default value for the Automatically backup media information field on the backup policy. You can change it at either the backup policy display or at the Change Backup Control Group Attributes display.
   • The value in the Save-while-active field specifies whether users can change an object during save processing. More specifically, the save-while-active feature allows users to change an object after BRMS reaches a certain checkpoint during the save process. It performs the save on a transaction boundary. By using the save-while-active feature, you can decrease your save window. You can find more detailed information about how to use the save-while-active feature later in this chapter.
   • The Sync Id field you can specify when using the save-while-active feature with *SYNCLIB, *SYNC, or *NWSSYNC. You can specify a name of the synchronized checkpoint. This name must also be specified for each of the participating save operations. This will enable multiple jobs to sync together. You can find more detailed information about how to use this feature with save-while-active later in this chapter.
6. Additional parameters are available on a separate display. Press F11 two times for Advanced backup controls.

                       Create Backup Control Group Entries              REESES     
                                                                                   
    Group . . . . . . . . . . : SAMPLE                                             
    Default activity  . . . . . *BKUPCY                                            
    Text  . . . . . . . . . . . Create sample backup control group                 
                                                                                   
    Type information, press Enter.                                                 
                                                                                   
                                                                                   
         Backup     List Parallel    Private                                       
    Seq  Items      Type Type        Authorities   Encrypt                         
                                                                                   
      10 *EXIT                                                                     
      20 LIBA            *DEFAULT    *NO           *NO                             
      30 LIBB            *DEFAULT    *NO           *NO                             
      40 LIBC            *DEFAULT    *NO           *NO                             
      50 *EXIT                                                                     
                                                                                   
                                                                                   
                                                                                   
                                                                            Bottom 
                                                                                   
    F3=Exit   F5=Refresh   F11=Display main   F12=Cancel                           
                                                                                   

7. The following are brief summaries of these parameters on this display.
   • In the Parallel Type parameter you may specify the type of parallel backup to be performed. The valid values for this parameter are, *DEFAULT, *PARALLEL, *SERIAL, and *NONE. The default value is *DEFAULT. The proper number of parallel device resources needs to be specified in order for parallel types *PARALLEL and *SERIAL to work. If not enough resources have been specified, then the parallel type is ignored, and only one device resource will be used. You can find out more detailed information about restrictions later in this chapter.
   • In the Private Authorities parameter, you may specify whether you would like to save the backup item's private authority. This is only valid for libraries, objects and integrated file system. Beware that saving private authorities can be a long running process and can increase your save time.
   • In the Encrypt parameter, you may specify whether you would like to save the backup item with encryption. Encryption is enabled through the media policy, and this field defines whether you want encryption by specifying *MEDPCY or if you don't want encryption by specifying *NO. You can find out more detailed information about encryption later in this chapter.
8. Review and change the remaining parameters as needed.
9. When you have finished, press Enter to save your new control group.