Specifying data set naming conventions

You can use the IMS Recovery Expert Offload DSN Specification panels to construct data set names for the offloaded backups.

About this task

The data set names are resolved at run time using the conventions specified in the LP Offload DSN Specification panels. After you select a backup type on the Offload Options panel and press Enter, the Offload panel for the selected backup type appears.

Procedure

  1. Specify Y in the Update DSN Specification field on this panel.
    Figure 1. LP Offload DSN Specification panel (BSY$OFF3)
     BSY$OFF3  V2R2 ------ LP Offload DSN Specification ------ 2021/11/11  14:19:07 
 Option   ===>                                                                  
 -------------------------------------------------------------------------------
  Creator: CSTSUK     Name: DFSMSDSS BACKUP METHOD           SSID: I9A2         
  Share Option: U  (Upd,View,No)    Description: DFSMSDSS BACKUP METHOD         
 -------------------------------------------------------------------------------
 Enter codes to create a dataset name specification:                            
  Qualifier code  ==>     Free form literal  ==>             Show DSN  ==> N    
                                                                                
  Current dataset name qualifier string:                                        
                                                                                
                                                                                
 Valid dataset name specification codes are:                                    
  1. Volser              9. Day (DD)           17. Backup Type (#18.#19)        
  2. *Reserved*         10. Julian Day (DDD)   18. Local/Recovery (L/R)         
  3. Subsystem ID       11. Hours (HH)         19. Primary/Backup (P/B)         
  4. User ID            12. Minutes (MM)       20. Job Name                     
  5. Time (HHMMSS)      13. Seconds (SS)       21. Step Name                    
  6. Date (YYYYDDD)     14. Timestamp          22. Profile Creator              
  7. Year (YYYY)        15. Random Number      23. Profile Name                 
  8. Month (MM)         16. GDG (+1)..(+n)     24. Substring Qualifier          
                                               25. Use freeform literal

  2. Press Enter.
  3. On the Offload DSN Specification panel, specify information in the following fields:
    Qualifier code
    To include a qualifier, specify its number in the Qualifier code field and press Enter. The qualifier string is displayed in the Current data set name generation qualifier string field. You can also specify the data set name or string directly in the string field.
    Free form literal
    After selecting the Use Freeform literal qualifier, you can specify an eight-character literal in this field. If you want the literal to be in its own substring, ensure that the literal begins with a period.
    Show DSN
    To view the string as it would be completed, specify Y in this field and press Enter.
    Current data set name qualifier string
    This field displays the qualifier string as it was input.

What to do next

Valid qualifiers for the data set names that you can use on the Offload DSN Specification panel are listed on the bottom half of the panel:

Volser
The volume serial of the source volume being offloaded.
Subsystem ID
The IMS subsystem ID or Group name.
User ID
The TSO user ID of the job builder.
Time (HHMMSS)
The current time in the format shown.
Date (YYYYDDD)
The current date in the format shown.
Year (YYYY)
The year in the format shown.
Month (MM)
The month in the format shown.
Day (DD)
The day of the month in the format shown.
Julian Day (DDD)
The Julian day.
Hours (HH)
The current time in hours.
Minutes (MM)
The current time in minutes.
Seconds (SS)
The current time in seconds.
Timestamp
The current timestamp in Dyymmdd.Thhmmss format.
Random Number
A random number in Rnnnnnn format.
GDG (+1)..(+n)
If you are using GDG data sets, this variable appends (+n) to the GDG base. This must be the last qualifier code you specify for the data set name.
Backup Type (#18.#19)
The backup type in x.y format, where x is L for local or R for recovery, and y is P for primary or B for backup.
Local/Recovery (L/R)
The backup type; L for local and R for recovery.
Primary/Backup (P/B)
The image copy backup type; P for primary and B for backup.
Job Name
The job name.
Step Name
The job step name.
Profile Creator
The profile creator ID.
Profile Name
The first 8 characters of the profile name.
Substring Qualifier
Select this option to specify one of the qualifiers and customize the substring. When you press Enter, the Substring Parameters panel is displayed.
Use freeform literal
After selecting this qualifier, you can specify an eight-character literal in the Free Form literal field. If you want the literal to be in its own substring, ensure that the literal begins with a period. For example, if you specify 1 (Volser), 3 (Subsystem ID), and then 14 (Timestamp), the data set name appears as follows:
volser.ssid.D070104.T151509
where volser and ssid resolve to values appropriate to your site.