Specifying data set naming conventions

Edit online

Use IMS Recovery Expert's Image Copy DSN Specification panels to construct data set names for the image copies.

About this task

The Image Copy DSN Specification panel allows you to build data set names using variables that are resolved at run time.

If you do not specify a data set mask using this panel, the DSN defaults to the following mask: 
&UID..&SSID..&DB..&DDN..ICOPY and &UID..&SSID..&DB..&DDN..ICOPY2

Procedure

  1. On the Image Copy Options panel, specify Y in either the Update IC1 Specification or Update IC2 Specification field. Press Enter.
    Figure 1. Image Copy DSN Specification panel (BSY$IMG3)
     BSY$IMG3  V2R2 ----- 1  Image Copy DSN Specification ---- 2021/03/22  09:49:53
 Option   ===>                                                                 
 ------------------------------------------------------------------------------
 Enter codes to create a dataset name specification:                           
  Qualifier code  ==>     Free form literal  ==>             Show DSN  ==> N   
  Current dataset name qualifier string:                                       
  PDMONA.IC1.&DB..&DDN..&TIMESTMP.                                             
                                                                               
 Valid dataset name specification codes are:                                   
  1. Database           10. Year (YYYY)        19. GDG (+1)..(+n)              
  2. DDN                11. Month (MM)         20. *Reserved*                  
  3. *Reserved*         12. Day (DD)           21. IC1/IC2                     
  4. Volser             13. Julian Day (DDD)   22. *Reserved*                  
  5. *Reserved*         14. Hours (HH)         23. Job Name                    
  6. Subsystem ID       15. Minutes (MM)       24. Step Name                   
  7. User ID            16. Seconds (SS)       25. Profile Creator             
  8. Time (HHMMSS)      17. Timestamp          26. Profile Name                
  9. Date (YYYYDDD)     18. Random Number      27. Substring Qualifier         
                                               28. Use freeform literal

  2. On the Image Copy DSN Specification panel, specify information in one or more of 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 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, make sure to begin the literal with a period.
    Show DSN
    To view the string as it would be completed, specify Y in this field and press Enter.
    Current dataset name qualifier string
    This field displays the qualifier string as it was input. 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 and are:
    Database
    The database name of the object for which an image copy is being created.
    DDN
    The DD name of the object for which an image copy is being created.
    Volser
    The volume serial of the data set.
    Subsystem ID
    The IMS subsystem ID or group.
    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 format Dyymmdd.Thhmmss.
    Random Number
    A random number in format Rnnnnnn.
    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.
    IC1/IC2
    The backup type.
    Job Name
    The job name.
    Step Name
    The job step name.
    Profile Creator
    The profile creator ID.
    Profile Name
    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 you begin the literal with a period. For example, if you specify 1 (Volser), 3 (Subsystem ID), then 14 (Timestamp), the data set name is displayed as:
    volser.ssid.D070104.T151509
    where volser and ssid resolve to values appropriate to your site.