VMS Help
RTL Routines, OTS$, OTS$SGET1_DD
*Conan The Librarian
|
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
None.
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).