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

    The Output Pasteboard Using Routine routine accesses the contents
    of a pasteboard.

    Format

      SMG$PUT_PASTEBOARD  pasteboard-id ,action-routine

                          [,user-argument] [,flags]

1 - Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

2 - Arguments

 pasteboard-id

    OpenVMS usage:identifier
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference

    Pasteboard identifier. The pasteboard-id argument is the address
    of an unsigned longword containing the pasteboard identifier.

 action-routine

    OpenVMS usage:procedure
    type:         procedure value
    access:       read only
    mechanism:    by value

    Pasteboard routine to be called. The action-routine argument
    is the address of the routine's procedure value. Because SMG$
    cannot determine the resulting type of device, device-independent
    characters (plus sign [+], vertical bar [|]) are used to draw
    lines.

    The action-routine accepts two arguments:

    o  A pointer to a string descriptor describing the line in the
       pasteboard.

    o  The user argument, or 0, passed by value.

    The action routine should return a success status (low bit set)
    as a return value, otherwise SMG$PUT_PASTEBOARD will terminate,
    and the status value will be returned as the return value for
    SMG$PUT_PASTEBOARD.

 user-argument

    OpenVMS usage:user_arg
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value

    The argument you supply to the action-routine. The user-argument
    argument is an unsigned longword that contains the value to be
    passed to the action routine. If user-argument is omitted, a 0
    will be passed as the user argument.

 flags

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference

    Optional bit mask that specifies whether a form feed is passed
    to the action routine. The flags argument is the address of an
    unsigned longword that contains the flag. Valid values for flags
    are as follows:

    0                  No form-feed line is sent.
    SMG$M_FORM_FEED    The first line passed to the action routine is
                       a form feed.