Steps at the TSM Client

  1. Install the TSM Application Program Interface (TSM APIs)

    If you have the TSM APIs on CD-ROM, use the following command: RSTLICPGM(5733197) DEV(device name where device-name is the name of the device for the CD-ROM that contains the Tivoli® Storage Manager Client API (TSM APIs).

    If you downloaded the APIs from the Internet, use the following command: RSTLICPGM LICPGM(5733197) DEV(*SAVF) SAVF (library-name/save-file-name) where the SAVF parameter specifies the library and the save file that contain the TSM APIs.

  2. Install BRMS

    You can find information about how to install BRMS in Installing and Initializing BRMS.

  3. Add a location for your TSM server

    If you have more than one TSM server create a unique BRMS location for each TSM server. If you also use a BRMS network, this location will automatically be sent to other systems in the network.

    To get to the Work with Storage Locations display, type WRKLOCBRM at a command line and press Enter.

                              Work with Storage Locations                RCHAS400   
                                                                                
 Position to . . . . . .               Starting characters                      
                                                                                
 Type options, press Enter.                                                     
   1=Add   2=Change   3=Copy   4=Remove   5=Display   6=Work with media         
   7=Work with containers                                                       
                                                                                
 Opt   Location     Volumes    Containers  Text                                 
  1    TSMSERVER                                                                
       *HOME             97           1    Entry created by BRM configuration   
       VAULT              0           0    Entry created by BRM configuration   
                                                                                
                                                                                
                                                                                
                                                                                
                                                                         Bottom 
                                                                                
 F3=Exit    F5=Refresh    F12=Cancel
    1. At the Work with Storage Locations (WRKLOCBRM) display, type a 1 (Add) in the Opt field.
    2. Then type a name for your TSM server in the Location field and press Enter. This takes you to the Add Storage Location display. 
                                   Add Storage Location                               
                                                                                
 Type choices, press Enter.                                                     
                                                                                
 Storage location  . . . . . . . . .   TSMSERVER    Name                        
 Address line 1  . . . . . . . . . .   Computer room, parent location.          
 Address line 2  . . . . . . . . . .                                            
 Address line 3  . . . . . . . . . .                                            
 Address line 4  . . . . . . . . . .                                            
 Address line 5  . . . . . . . . . .                                            
 Contact name  . . . . . . . . . . .   Jennie Doe                               
 Contact telephone number. . . . . .                                            
 Retrieval time  . . . . . . . . . .       .0       Hours                       
 Allow volumes to expire . . . . . .   *NO          *YES, *NO                   
 Media slotting  . . . . . . . . . .   *NO          *YES, *NO                   
 Text  . . . . . . . . . . . . . . .   TSM server location                      
                                                                                
                                                                                
                                                                                
                                                                                
 F3=Exit    F12=Cancel
    3. Use the address fields on this display to document the location of the TSM server. You can use the contact information fields to identify the TSM administrator and other important contacts.
    4. Use the default values in the Allow volumes to expire and the Media slotting fields.
    5. In the Text field, type a description for this TSM location.
    6. Press Enter to save the location information.
  4. Create a media policy

    BRMS media policies used with TSM servers determine how long the objects stored on the TSM server are maintained in BRMS history. When the retention period expires, and the object will be deleted from the TSM server and BRMS history the next time maintenance is run. It is important to always explicitly specify the location when using the media policy for TSM servers.

    Take the following steps to create a media policy for your TSM server:

    1. At the Work with Media Policies display, type a 1 in the Opt column.
    2. Type a policy name in the Policy column.
    3. Press Enter to prompt the Create Media Policy display. 
                                 Create Media Policy                                 
                                                                               
                                                                               
Type choices, press Enter.                                                     
                                                                               
  Media policy . . . . . . . . . . .   TSM          Name                       
  Retention type . . . . . . . . . .   2            1=Date, 2=Days,            
                                                    3=Versions, 4=Permanent    
    Retain media . . . . . . . . . .   35           Date, Number               
    Deleted library retention. . . .   *NONE        Number, *NONE              
  Move policy  . . . . . . . . . . .   *ADSM        Name, *NONE, *ADSM, F4     
  Media class  . . . . . . . . . . .   *ADSM        Name, *SYSPCY, *ADSM, F4   
  Storage location . . . . . . . . .   TSMSERVER    Name, *ANY, F4 for list    
  Save to save file  . . . . . . . .   *NO          *YES, *NO                  
    ASP for save files . . . . . . .   *SYSTEM      Name, *SYSTEM, 1-32        
    Save file retention type . . . .   4            1=Date, 2=Days,            
                                                    3=Permanent, 4=None        
      Retain save files  . . . . . .   *NONE        Date, Number, *NONE        
    ASP storage limit  . . . . . . .   *SYS         *SYS, 1-99                 
  Secure media . . . . . . . . . . .   *ADSM        *YES, *NO, *ADSM           
                                                                               
                                                                        More...
 F3=Exit   F4=Prompt   F5=Refresh   F12=Cancel
    4. Set the Retention type and Retain media fields, to the length of time you want saved objects using this media policy to be stored on the TSM server. BRMS manages the retention of the object on the TSM server. When the object expires in BRMS history and is removed from history, BRMS deletes the object from the TSM server.
      Notes:
      1. If you are using an IBM® Data Retention 450 (DR450) or DR550 servers, the retention is also managed by the data retention server. A saved object cannot be deleted from BRMS history if that object has not expired on the data retention server. If you are using a data retention server, make sure the setting for the Retention type and Retain media fields match the retention of the TSM Management Class you specify in the TSM management class field.
      2. If an object is saved to a data retention server and has not expired at the data retention server, attempts to delete the object from BRMS history will result in exception BRM2327–Errors occurred removing item from TSM server with reason 0248–A delete of this object is not allowed.
    5. In the Move policy field, specify the *ADSM value. This name indicates that a TSM policy, rather than a BRMS policy, manages media movement.
    6. Specify *ADSM in the Media class field. This indicates that BRMS media classes will not be associated with TSM devices.
    7. Set the Storage location field to the value that you specified in Step 3.
      Note:
      BRMS does not recommend using special value *ANY for this field. Using this special value could result in saved objects being directed to the wrong TSM server if you use this media policy concurrently with *MEDCLS for the device. When *MEDCLS is used for the Device (DEV) parameter with save commands to backup control groups, the device is chosen based on location. If *ANY is also used, any device can be selected.
    8. Specify *ADSM in the Secure media field. This indicates that a TSM policy, rather than a BRMS policy, secures your data. 
                                 Create Media Policy                                  
                                                                                
                                                                                
Type choices, press Enter.                                                      
                                                                                
  Required volumes . . . . . . . . .   *NONE       *NONE, 1-9999                
  Mark volumes for duplication . . .   *NO         *NO, *YES                    
  Mark history for duplication . . .   *NO         *NO, *YES                    
  Text . . . . . . . . . . . . . . .   *NONE                                    
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                         More...
 F3=Exit   F5=Refresh   F12=Cancel
    9. Use the default value of *NONE in the Required volumes field, and *NO for the Mark Volumes for Duplication and Mark History for Duplication fields. The TSM policy, rather than the BRMS policy, manages these activities.
    10. In the Text field, type in a description for this TSM policy. Then page down to the next Create Media Policy display.
    11. Press Enter to review the additional fields: 
                                 Create Media Policy                                  
                                                                                
                                                                                
Type choices, press Enter.                                                      
                                                                                
  Encrypt Data . . . . . . . . . . .   *NO         *NO, *YES                    
  TSM management class . . . . . . .   STANDARD                                 
  TSM transfer size. . . . . . . . .   1024        1-9999999                    
  TSM transfer ASP . . . . . . . . .   *SYSTEM     Name, *SYSTEM, 1-32          
  TSM security:                                                                 
    TSM node . . . . . . . . . . . .   APPN.REESES                              
    TSM password . . . . . . . . . .   *NONE                                    
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                         Bottom 
 F3=Exit   F5=Refresh   F12=Cancel
    12. In the Encrypt Data field, specify whether you want software encryption used when using this media policy.
    13. In the TSM management class field, specify the BRMS management class name provided by your TSM administrator. Use the default value of STANDARD if you did not receive a management class name from the administrator.
    14. In the TSM transfer size field, specify the size in megabytes to be used in transferring data to the TSM server. The default is 1024 megabytes. Currently this parameter is disabled. In a future PTF, it will be enabled.
    15. In the TSM transfer ASP field, specify the ASP that BRMS will use to contain the data that will be transferred to the TSM server. Currently this parameter is disabled. In a future PTF, it will be enabled.
    16. The TSM security parameter has two elements, TSM node and TSM password. Specify the node name and password that identify this system to the TSM server. Use the *NONE value in the TSM password field only if the TSM server does not require authentication of client operations.
    17. Press Enter to create the media policy.
    Note:
    Media policies are networked to all systems in a BRMS network however, the TSM password is not networked for security reasons. If you change a TSM password for a media policy on one system in the network, you must also change the password on other systems that also use the media policy. One way to avoid managing the password is to use the TSM Password Access Generate function as described in TSM Automatic Password Management Operation.
  5. Create a TSM device

    You need to create a unique BRMS device for each TSM server you intend to use. BRMS devices are not networked so you will need to create these devices on each system which will use the TSM servers. You can create a TSM device at the Work with Devices (WRKDEVBRM) display. To get there, type WRKDEVBRM at a command line and press Enter. At the Work with Devices display, take the following steps:

    1. Type a 1 in the Opt field.
    2. Type a name in the Device field. Choose a name that is representative of your TSM server.
    3. In the Category field, type in the name of the communications category you want to use. The values for this field are:
      • *APPC: This device will connect to the TSM server by using SNA protocol.
        Notes:
        1. APPC was supported by Version 3 and 4 TSM servers, and is no longer supported by Version 5 TSM servers.
        2. BRMS presents a BRM1240 – Device TSM is not allowed. If the device description does not exist, then you need to create it. Use the WRKDEVD DEVD(*CMN) command to review the available device descriptions. If you cannot find one that describes the remote location of your TSM server, then you need to create this device by using the CRTDEVAPPC command.
      • *NET: This device connects to the TSM server by using TCP/IP protocol.
                                    Work with Devices                      RCHAS400   
                                                                                
 Position to . . . . . .               Starting characters                      
                                                                                
 Type options, press Enter.                                                     
   1=Add   2=Change   4=Remove   5=Display                                      
   8=Work with status                                                           
                                                                                
 Opt   Device      Category  Type/Model  Text                                   
                                                                                
       TAPMLBBRM   *TAPMLB   3575/018    Entry created by BRM configuration     
 1     TSMSERVER   *NET      
 
 
 
 
 
    
                                                                        More... 
                                                                                
 F3=Exit   F5=Refresh   F12=Cancel
    4. Press Enter to get to the next display. The title of the next display that you see depends on which category you chose at the Work with Devices display. For example, if you chose *NET, you will see the Add Net Device display. 
                                       Add Net Device                                 
                                                                                
 Net device  . . . . . . . . . . . :   TSMSERVER                                
                                                                                
 Type choices, press Enter.                                                     
                                                                                
 Text  . . . . . . . . . . . . . . .   TSM Server                               
                                                                                
 Location  . . . . . . . . . . . . .   TSMSERVER    Name, F4 for list           
                                                                                
 TSM file space  . . . . . . . . . .   *LCL                                     
                                                                                
 Buffer size . . . . . . . . . . . .   *DEVTYPE     *DEVTYPE, 1-512 KB          
                                                                                
 Retention protection  . . . . . . .   *NO          *NO, *YES                   
                                                                                
 Internet address  . . . . . . . . .    123.345.567.890                         
 Internet port . . . . . . . . . . .    1500        1-65534                     
                                                                                
                                                                                
                                                                                
                                                                                
 F3=Exit   F4=Prompt   F12=Cancel
    5. In the Text field, type in a description of the TSM device.
    6. In the Location field, type in the name of the location you created in Step 3.
    7. Use *LCL as the default name in the TSM file space field. Do not specify a unique file space name unless you clearly understand how TSM uses file spaces.
    8. Specify *YES for Retention protection if the TSM device is an IBM Data Retention 450 (DR450) or DR550 server, or any TSM server which uses Archive retention protection.
    9. If you specified *NET device for the device category on the WRKDEV display, you must specify an Internet address and port for the TSM server. Enter the TCP/IP address and port information that your TSM administrator provided. Then press Enter to create the device.
  6. Change existing control groups to TSM devices

    You can easily change an existing control group which uses local devices to use TSM devices provided that the data specified in the control group meets the criteria for user data allowed to be saved on TSM servers. Take the following steps to change an existing control group:

    1. Go to the Work with Backup Control Groups display.
    2. Place an 8 (Change attributes) in the Opt field in front of the control group you want to change, and press Enter.
    3. This takes you to the Change Control Group Attributes display. 
                              Change Backup Control Group Attributes                 
                                                                               
 Group  . . . . . . . . . . . . . . . . : SAMPLE                             
                                                                               
 Type information, press Enter.                                                
                                                                               
 Media policy for:                                                             
   Full backups . . . . . . . . . . . . . TSM         Name, F4 for list        
   Incremental backups  . . . . . . . . . TSM         Name, F4 for list        
 Backup devices . . . . . . . . . . . . . TSMSERVER   Name, F4 for list        
                                                                               
                                                                               
                                                                               
 Parallel device resources:                                                    
   Minimum resources  . . . . . . . . . . *NONE       1-32, *NONE, *AVAIL      
   Maximum resources  . . . . . . . . . .             1-32, *AVAIL, *MIN       
 Sign off interactive users . . . . . . . *BKUPCY     *YES, *NO, *BKUPCY       
 Sign off limit . . . . . . . . . . . . . *BKUPCY     0-999 minutes, *BKUPCY   
 Default weekly activity  . . . . . . . . *BKUPCY     SMTWTFS(F/I), *BKUPCY    
 Incremental type . . . . . . . . . . . . *BKUPCY     *CUML, *INCR, *BKUPCY    
 Force full backup days . . . . . . . . . *BKUPCY     0-365, *NOMAX, *BKUPCY   
                                                                        More...
 F3=Exit   F4=Prompt   F12=Cancel
    4. Change the full and incremental media policy fields to reflect the name of the TSM media policy you created in Step 4. You can use F4 from the media policy fields to select from a list of media policies.
    5. Change the Backup devices field to reflect the name of the TSM device you created in step 5. Press F4 from the Backup devices field to select from a list of devices. You can specify only one TSM device on this display.
      Note:
      BRMS does not recommend that you use special value *MEDCLS for Backup devices which are TSM servers. BRMS recommends that you specify the device name.
    6. Roll to the next page of this display and change the value Automatically backup media information field to *NONE. This prevents BRMS from storing the media information about the TSM server when the save of this control group completes. BRMS will need this information to print a recovery report that refers to TSM. For this reason, you need to issue a SAVMEDIBRM command after the save to the TSM server.
    7. Press Enter when you have finished with the control group updates.

You are now ready to perform saves to a TSM server while using this control group. You can use the locations, media policies, and devices you just created with other backup or archive control groups.


[ Top of Page | Previous Page | Next Page | Contents | Index ]