VMS Help RTL Routines, LIB$, LIB$BUILD_NODESPEC  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The Build a Node-Name Specification routine builds a node-name
    specification from the primary node name. The output node-name
    specification can be used for other node-name parsing operations.

    Format

      LIB$BUILD_NODESPEC  primary-nodename, nodespec [,acs]

                          [,secondary-nodename] [,nodespec-length]

1 - Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

2 - Arguments

 primary-nodename

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor

    Primary node name. The primary-nodename argument contains the
    address of a descriptor pointing to this node-name string. The
    primary node name should not contain unnecessary quotation marks
    (that is, quotation marks (" ") that are not part of a simple
    name within the node name).

    The error LIB$_INVARG is returned if primary-nodename points to
    a null string. The error LIB$_INVSTRDES is returned if primary-
    nodename is an invalid descriptor.

 nodespec

    OpenVMS usage:char_string
    type:         character string
    access:       write only
    mechanism:    by descriptor

    Node-name specification. The nodespec argument contains the
    address of a descriptor pointing to this output node-name
    specification string. LIB$BUILD_NODESPEC writes the output node-
    name specification into the buffer pointed to by the nodespec
    descriptor.

    The error LIB$_INVSTRDES is returned if nodespec is an invalid
    descriptor.

    The length field of the nodespec descriptor is not updated unless
    nodespec is a dynamic descriptor with a length less than the
    resultant node-name specification. Refer to the OpenVMS RTL
    String Manipulation (STR$) Manual for dynamic string descriptor
    usage.

    The nodespec argument contains an unusable result when LIB$BUILD_
    NODESPEC returns in error.

 acs

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor

    Access control string. The acs argument contains the address of
    a descriptor pointing to this access control string. The access
    control string must be a quoted string.

    The error LIB$_INVSTRDES is returned if acs is an invalid
    descriptor.

 secondary-nodename

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by descriptor

    Secondary node name. The secondary-nodename argument contains
    the address of a descriptor pointing to this secondary node-name
    string.

    The error LIB$_INVSTRDES is returned if secondary-nodename is an
    invalid descriptor.

 nodespec-length

    OpenVMS usage:unsigned_word
    type:         word (unsigned)
    access:       write only
    mechanism:    by reference

    Length of the output node-name specification. The nodespec-length
    argument is the address of an unsigned word that contains this
    length in bytes.

    The nodespec-length argument contains an unusable result when
    LIB$BUILD_NODESPEC returns in error.