[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 FN_WRFSNAME()
 WriteFileServerNameTable
------------------------------------------------------------------------------
 Syntax
 
       fn_wrFSName( <aNameTable> ) -> NIL
 
 Arguments

      <aNameTable> is an 8 element array of file server names,
      corresponding to entries in the Connection ID table.

      File server names may be up to 47 characters in length.

 Returns

      Nothing

 Description

      Use this function when making changes to the Connection ID table.  For
      example, the function fn_attchFS() writes the name of the target file
      server, as well as connection ID info, before attempting to attach to
      a new file server.

 Examples

      /* change a file server's local name to something more meaningful */

      aFSNames := fn_FSName()

      IF ( nID := ASCAN( aTable, {|e| e == "FS3" } ) != 0 )

         aTable[ nID ] := "Server Next to Sally's Desk"
         fn_wrFSName( aTable )

      ENDIF


      /* NOTE: Although the above example serves to demonstrate how to
         use fn_wrFSName(), the practice illustrated above is not recom-
         mended.  fn_wrFSName() only writes to the Shell's file server
         name table, not to the network.  In the example above, the file
         server "Server Next to Sally's Desk" would still have to be
         referenced as "FS3" by any other file server functions, such as
         attaching or logging in. */


 Source: N:\SRC\CONNWS\FSNAME.PRG

 Author: Steve Larsen

See Also: fn_FSName() fn_connID() fn_attchFS()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson