createJunction

Request

<createJunction>
   <junctionPath/>
   <junctionName/>
   <junctionDefinition/>
   <nameSpace/>
</createJunction>

Reply

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

Elements

junctionPath

Specifies the full path to the directory where the new junction is created.

junctionName

Specifies the name of the junction to create.

junctionDefinition

Specifies the definition to write to the newly created junction. The format of this data is defined in the DFS documentation.

nameSpace

Specifies the name space ID in which the junction name is created.

result

Specifies an error value or 0 (for no error).

description

Specifies a text description of the result.

Example

The following example creates a junction named "myJunction" in the SYS:/temp directory. The junction name is to be created using the LONG (4) name space. The junction references volume NSS1 on MYSERVER in MY_TREE.

<nssRequest>
   <junction>
      <createJunction>
         <junctionPath>SYS:/tmp</junctionPath>
         <junctionName>myJunction</junctionName>
         <junctionDefinition>
            /../junction/.MYSERVER_NSS1.novell.MY_TREE./
            0xCC507D5C2732D6018002FBDA22AE6917
         </junctionDefinition>
         <nameSpace>4</nameSpace>
      </createJunction>
   </junction>
</nssRequest>

A nssReply packet to the create junction command follows:

<nssReply>
   <junction>
      <createJunction>
         <result value="0">
            <description/>success</description>
         </result>
      </createJunction>
   </junction>

   <result value="0">
      <description/>zOK</description>
   </result>
</nssReply>