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.