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).