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

    The Get One Dynamic String routine allocates dynamic virtual
    memory to the string descriptor you specify.

    Format

      LIB$SGET1_DD  word-integer-length ,descriptor-part

1 - Corresponding JSB Entry Point

      LIB$SGET1_DD_R6

2 - Returns

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

3 - Arguments

 word-integer-length

    OpenVMS usage:word_unsigned
    type:         word (unsigned)
    access:       read only
    mechanism:    by reference

    Number of bytes of dynamic virtual memory to be allocated by
    LIB$SGET1_DD. The word-integer-length argument is the address of
    an unsigned word that contains this number. The amount of storage
    allocated may be rounded up automatically.

 descriptor-part

    OpenVMS usage:quadword_unsigned
    type:         quadword (unsigned)
    access:       write only
    mechanism:    by reference

    Descriptor of the dynamic string to which LIB$SGET1_DD allocates
    the dynamic virtual memory. The descriptor-part argument contains
    the address of this descriptor.

    The descriptor-part argument must contain the address of a
    dynamic string descriptor; LIB$SGET1_DD returns an unpredictable
    result if any other type of descriptor is specified by this
    argument.

    The descriptor CLASS field is not checked but is set to dynamic
    (2). The LENGTH field is set to word-integer-length, and the
    POINTER field points to the string area allocated.