name_add_link()

NAME_$ADD_LINK                    Domain/OS                     NAME_$ADD_LINK


NAME
     name_$add_link - create a link

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/name.h>

     void name_$add_link(
          char *link_name,
          unsigned short &name_length,
          char *link_text,
          unsigned short &text_length,
          status_$t *status)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/name.ins.pas';

     procedure name_$add_link(
          in link_name: univ name_$long_pname_t;
          in name_length: integer;
          in link_text: univ name_$long_pname_t;
          in text_length: integer;
          out status: status_$t);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/name.ins.ftn'

           integer*4 status
           integer*2 name_length, text_length
           character link_name*1023, link_text*1023

           call name_$add_link(link_name, name_length, link_text,
          &                    text_length, status)

DESCRIPTION
     This call creates a link from the pathname in link_name to the pathname
     in link_text.

     link_name
          The pathname of the link.  Link_name cannot be the pathname of an
          existing object.

     name_length
          The number of bytes in link_name.

     link_text
          The pathname that link_name should resolve to.  Link_text can be an
          absolute or relative pathname and does not have to be the pathname
          of an existing object.

     text_length
          The number of bytes in link_text.

     status
          The completion status.
Museum
