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

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

    Format

      LIB$SGET1_DD_64  quad-integer-length ,descriptor-part

1 - Returns

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

2 - Arguments

 quad-integer-length

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

    Number of bytes of dynamic virtual memory to be allocated by
    LIB$SGET1_DD_64. The quad-integer-length argument is the address
    of an unsigned quadword that contains this number. The amount of
    storage allocated can 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_64
    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_64 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 quad-integer-length, and the
    POINTER field points to the string area allocated.