createLink

Creates a link to a junction.

Request

<createLink>
   <pathName/>
   <junction>
      <managementContext>
         <ndsObject/>
         <tgtTree/>
      </managementContext>
      <dfsGUID/>
      <ndsVolume>
         <ndsObject/>
         <tgtTree/>
      </ndsVolume>
      <volumeInfo>
         <server/>
         <tgtTree/>
         <volumeName/>
      </volumeInfo>
   </junction>
   <symlink>
      <nameSpace/>
      <pathName/>
   </symlink>
   <unc>
      <pathName/>
   </unc>
   <url>
      <pathName/>
   </url>
</createLink>

Reply

<createLink>
   <result value=" ">
      <description/>
   </result>
</createLink>

Elements

pathName: Specifies the link file to be created.
tgtTree: (Optional)
result: Specifies an error value or 0 (for no error).
description: Specifies a text description of the result.

Remarks

When you create a junction, the target volume needs to be identified by either a DFS GUID, an eDirectory Volume object, or an eDirectory NCP Server object and Host Resource Name (or the physical volume name). Supply only one of these forms. The combination of an eDirectory NCP Server object and Host Resource Name applies only to NetWare 6 or later. Other forms can be used to create a junction to a pre NetWare 6 server.

For NetWare 6.5 SP1, the managementContext element is required.

For NetWare 6.5 SP2, the managementContext element is option if ndsVolume or volumeInfo is used. If the managementContext field is not supplied, the server that is creating the junction determines the context from the ndsObject or server elements that you supplied in the request. If the managementContext element is supplied with one of these forms, the supplied value is used and the server does not need to determine the context.

Example

<nssRequest>
   <dfs>
      <createLink>
         <pathName>VOL1:\foo\junction</pathName>
         <junction>          <!-- Creating a junction -->
            <managementContext>
               <ndsObject>nss.prv.novell</ndsObject>
               <tgtTree>novell_inc</tgtTree># optional
            </managementContext>
            <dfsGUID>C2EAAA00-3211-11D6-B7-C7-00C04FA33547</dfsGUID>
            <ndsVolume>
               <ndsObject>VLDB-MASTER_VOL1.novell</ndsObject>
               <tgtTree>novell_inc</tgtTree># optional
            </ndsVolume>
            <volumeInfo>
               <server>vldb-master.novell</server>
               <tgtTree>novell_inc</tgtTree>#optional
               <volumeName>VOL1</volumeName>
            </volumeInfo>
         </junction>
         <symlink>            <!-- Creating a symbolic link -->
            <nameSpace>long</nameSpace>
            <pathName>abc/def</pathName>
         </symlink>
         <unc>                <!-- Creating a UNC link -->
            <pathName>\\ServName\VolName\foo.bar</pathName>
         </unc>
         <url>                <!-- Creating a URL link -->
            <pathName>http://nss.provo.novell.com/dfs</pathName>
         </url>
      </createLink>
   </dfs>
</nssRequest>