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

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

    Format

      STR$GET1_DX  word-integer-length ,character-string

1 - Corresponding JSB Entry Point

      STR$GET1_DX_R4

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 that STR$GET1_DX allocates. The word-integer-
    length argument is the address of an unsigned word containing
    this number.

 character-string

    OpenVMS usage:char_string
    type:         character string
    access:       modify
    mechanism:    by descriptor

    Dynamic string descriptor to which STR$GET1_DX allocates the
    area. The character-string argument is the address of the
    descriptor. The descriptor's CLASS field is checked.