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

    The Copy a Source String Passed by Reference to a Destination
    String routine copies a source string passed by reference to a
    destination string.

    Format

      OTS$SCOPY_R_DX  word-int-source-length-val

                      ,source-string-address ,destination-string

1 - Corresponding JSB Entry Point

      OTS$SCOPY_R_DX6

2 - Returns

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

    Number of bytes not moved to the destination string if the length
    of the source string pointed to by source-string-address is
    greater than the length of destination-string. Otherwise, the
    value is 0 (zero).

3 - Arguments

 word-int-source-length-val

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

    Length of the source string. The word-int-source-length-val
    argument is an unsigned word integer containing the length of
    the source string.

 source-string-address

    OpenVMS usage:char_string
    type:         character string
    access:       read only
    mechanism:    by reference

    Source string. The source-string-address argument is the address
    of the source string.

 destination-string

    OpenVMS usage:char_string
    type:         character string
    access:       write only
    mechanism:    by descriptor

    Destination string. The destination-string argument is the
    address of a descriptor pointing to the destination string.
    OTS$SCOPY_R_DX determines the appropriate action based on the
    descriptor's CLASS field. The descriptor's LENGTH field alone or
    both the POINTER and LENGTH fields can be modified if the string
    is dynamic. For varying strings, the string's current length
    (CURLEN) is rewritten.