Forming file names

Refer to Determining whether the file name is in absolute form for information on absolute file names. When the compiler performs a library search, it treats filename as either a z/OS® UNIX System Services file name or a data set name. This depends on whether the library being searched is a z/OS UNIX library or MVS™ library. If the compiler treats filename as a z/OS UNIX file name, it does not perform any conversions on it. If it treats filename as a data set name (DSN), it performs the following conversion:

• For the first DSN format:

  
     .-/--------. .-.-------------.   
     V          | V               |   
  >>---+------+-+---+-----------+-+------------------------------><
       '-path-'     '-qualifier-'     
  
  

  The compiler:

  1. Uppercases qualifier and path
  2. Truncates each qualifier and path to 8 characters
  3. Converts the underscore character (which is invalid for a DSN) to the '@' character (hex 7c)
• For the second DSN format:

  
       .-.---------.                      
       V           |                      
  >>-'---qualifier-+-+--------------+-'--------------------------><
                     '-(--member--)-'     
  
  

  The compiler:

  1. Uppercases the qualifier and member
  2. Converts the underscore character (which is invalid for a DSN) to the '@' character (hex 7c)
• For the third DSN format:

  
  >>-DD:ddname--+--------------+---------------------------------><
                '-(--member--)-'   
  
  

  The compiler:

  1. Uppercases the DD:, ddname, and member
  2. Converts the underscore character (which is invalid for a DSN) to the '@' character (hex 7c)