create link(1m) 														   create link(1m)

NAME

       create link - Creates a soft link and optionally specifies an expiration time and an extension time

SYNOPSIS

       cdscp create link link-name CDS_LinkTarget = target-name [CDS_LinkTimeout =  (expiration-time extension-time)]

ARGUMENTS

       The  full  name	of  the  soft link.  The full name of the entry to which the soft link points.	A date and time after which CDS checks for
       existence of the soft link's target and either extends or deletes the soft link.  The value  is	specified  as  yyyy-mm-dd-hh:mm:ss  (year-
       month-day-hour:minute:second).  You can abbreviate this value.  A period of time by which to extend the soft link's expiration time (if the
       server has validated that the target still exists).  The value is specified as ddd-hh:mm:ss (days-hour:minute:second).  You can	abbreviate
       ths value.

DESCRIPTION

       The  create  link  command  creates  a soft link.  If you specify the CDS_LinkTimeout attribute, you must specify an expiration time and an
       extension time.	If you omit the CDS_LinkTimeout attribute, the soft link is permanent and must be explicitly deleted.

   Privilege Required
       You must have insert permission to the directory in which you intend to create the soft link.

NOTE

       This command is replaced at Revision 1.1 by the dcecp command and may not be provided in future releases of DCE.

EXAMPLE

       The  following  command	creates  a  permanent  soft  link  named  /.:/sales/tokyo/price-server	that  points  to  an  object  entry  named
       /.:/sales/east/price-server.   The  expiration  value  indicates  that CDS will check that the destination name /.:/sales/east/price-server
       still exists on June 25,1995, at 12:00 p.m.  If the destination name still exists, the soft link remains in effect another 90 days.  There-
       after, CDS will check that the destination name exists every 90 days.  cdscp> create link /.:/sales/tokyo/price-server CDS_LinkTarget  > =
       /.:/sales/east/price-server CDS_LinkTimeout =(1995-06-25-12:00:00  > = 90-00:00:00)

RELATED INFORMATION

       Commands: delete link(1m), list link(1m), set link(1m), show link(1m)

																   create link(1m)