Upgrading_to_Full_Support

   Some OpenVMS applications, such as system or disk management
   utilities, may require full support for Extended File
   Specifications. Typically these are utilities that must be able
   to view and manipulate all file specifications without DID or
   FID abbreviation. To upgrade an application so that it fully
   supports all the features of Extended File Specifications, do the
   following:

   1. Convert all uses of the RMS NAM block to the new NAML block.

   2. Expand the input and output file name buffers used by RMS.
      To do this, use the NAML long_expanded and long_resultant
      buffer pointers (NAML$L_LONG_EXPAND and NAML$L_LONG_RESULT)
      rather than the short buffer pointers (NAML$L_ESA and NAML$L_
      RSA), and increase the buffer sizes from NAM$C_MAXRSS to
      NAML$C_MAXRSS.

   3. If long file names (greater than 255 bytes) are specified in
      the FAB file name buffer field (FAB$L_FNA), use the NAML long_
      filename buffer field (NAML$L_LONG_FILENAME) instead. If long
      file names are specified in the default FAB name buffer field
      (FAB$L_DNA), use the default NAML name buffer field (NAML$L_
      LONG_DEFNAME) instead.

   4. If you use the LIB$FIND_FILE, LIB$RENAME or LIB$DELETE
      routines, set LIB$M_FIL_LONG_NAMES in the flags argument
      (flags is a new argument to the LIB$DELETE routine). Note
      that you can use the NAML block in place of the NAM block to
      pass information to LIB$FILE_SCAN without additional changes.

   5. If you use the LIB$FID_TO_NAME routine, the descriptor for
      the returned file specification may need to be changed to
      take advantage of the increased maximum allowed of 4095
      (NAML$C_MAXRSS) bytes.

   6. If you use the FDL$CREATE, FDL$GENERATE, FDL$PARSE, or
      FDL$RELEASE routine, you must set FDL$M_LONG_NAMES in the
      flags argument.

   7. Examine the source code for any additional assumptions made
      internally that a file specification is no longer than 255
      8-bit bytes.