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

    The Get One Dynamic String routine allocates a specified
    number of bytes of dynamic virtual memory to a specified string
    descriptor.

    Format

      OTS$SGET1_DD  word-integer-length-value ,dynamic-descriptor

1 - Corresponding JSB Entry Point

      OTS$SGET1_DD_R6

2 - Returns

    None.

3 - Arguments

 word-integer-length-value

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

    Number of bytes to be allocated. The word-integer-length-value
    argument contains the number of bytes. The amount of storage
    allocated is automatically rounded up. If the number of bytes is
    zero, a small number of bytes is allocated.

 dynamic-descriptor

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

    Dynamic string descriptor to which the area is to be allocated.
    The dyn-str argument is the address of the dynamic string
    descriptor. The CLASS field is not checked but it is set to
    dynamic (CLASS = 2). The LENGTH field is set to word-integer-
    length-value and the POINTER field is set to the string area
    allocated (first byte beyond the header).