NAME

create link - Creates a soft link, optionally specifying expiration time and extension time

SYNOPSIS

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

ARGUMENTS

link-nameThe full name of the soft link. 

CDS_LinkTarget = target-name
The full name of the entry to which the soft link points.

CDS_LinkTimeout = (expiration-time  extension-time)
The expiration-time argument specifies 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 follows:

yyyy-mm-dd-hh:mm:ss

You can abbreviate this value.  The extension-time argument specifies 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 follows:

dd-hh:mm:ss

You can abbreviate this 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. 

Privileges Required

You must have i (insert) permission to the directory in which you intend to create the soft link. 

NOTES

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

EXAMPLES

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 the Cell Directory Service (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.  Thereafter, 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(8cds), list_link(8cds), set_link(8cds), show_link(8cds).