clh_vbyop(3)                        CLIX                        clh_vbyop(3)



  NAME

    clh_vbyop - Looks up a value by object and property

  LIBRARY

    INC Library (libinc.a)

  SYNOPSIS

    char *clh_vbyop(
      unsigned char *object ,
      unsigned char *property ,
      unsigned char *value ,
      int size );

  PARAMETERS

    object    Each clearinghouse object is a text file stored in at least one
              of the clearinghouse directories.  The name of the file is the
              object name.

    property  Each object file is a list of one or more properties.

    value     Each property in the object file has a property value.

    size      The number of bytes of data from the value to be returned.

  DESCRIPTION

    The clh_vbyop() function searches the Intergraph clearinghouse directory
    looking for object.  If found, the object is searched for property.  All
    information (up to size bytes) regarding property is returned in the
    string pointed to by value.

  EXAMPLES

    clh_vbyop ("b11", "address", value, 30)
    clh_vbyop ("red_pn", "Primary_User", value, 10)


  FILES

    /usr/lib/nodes
           Clearinghouse directory.

  RETURN VALUES

    Upon successful completion, a null pointer is returned.  Otherwise, a
    pointer to an error string is returned which indicates that the specified
    object does not exist or the object does not contain the specified



  2/94 - Intergraph Corporation                                              1

  clh_vbyop(3)                        CLIX                        clh_vbyop(3)



    property.

  ERRORS

    If the error message INC_CL is returned, the system has not found a match
    for the object or alias; therefore the user should check or verify the
    name specified.  If the name or alias is correct, then the specified
    object does not exist or does not contain the property requested.

  RELATED INFORMATION

    Commands:  clh(1)

    Files:  clh(4)








































  2                                              Intergraph Corporation - 2/94