c_lsopen - Opens a label services file

SYNTAX

#include "las.h"
#include "vll.h"

FUNCTION c_lsopen (fd, hostname, access)

     long               *fd;
     char               *hostname;
     long               *access;

PARAMETERS

fd (output, integer)

File descriptor to be used by other label service functions. The file descriptor is set by c_lsopen() and should not be altered.

hostname (input, character, length (CMLEN))

Host filename of the label services file.

access (input, integer)

Type of read/write access the label services file is to be opened with. Valid values are:

     = 0:     Read
     = 1:     Write (existing file is overwritten)
     = 2:     Write (append to end of existing file)
     = 3:     Read/write (replace a record)

DESCRIPTION

The c_lsopen() call is used to open the label services file.

RETURN VALUE

c_lsopen() returns

     E_SUCC (0)  --> successful completion
     E_FAIL (-1) --> operation failed