RCB_SETARGS

Set multiple arguments in a single call

WTSupported in traditional Synergy on Windows

 

USupported on UNIX
VSupported on OpenVMS
xcall RCB_SETARGS(rcbid, startargnum, arglist)

Arguments

rcbid

The ID of a routine call block previously created with %RCB_CREATE. (n)

startargnum

The one‑based starting position for setting arguments. (n)

arglist

The argument list. At least one argument must be set. (a or n)

Discussion

The RCB_SETARGS subroutine can only be used when data is passed by descriptor. (In other words, it cannot be used for ^REF and ^VAL arguments.)

If startargnum is less than or equal to 0 or greater than the number of arguments specified in %RCB_CREATE, an error is signaled.

You can include as many arguments in arglist as you want, as long as the total number set in the routine call block does not exceed the number specified in %RCB_CREATE.

Examples

record
    rcbid       ,i4
    arg_1       ,a3
    arg_2       ,d3
    arg_3       ,d6.3
    arg_4       ,a4
    arg_5       ,i4
proc
    rcbid = %rcb_create(5)              ;Create an RCB block with 5 args
    xcall rcb_setargs(rcbid, 1, arg_1, arg_2, arg_3, arg_4, arg_5)
    xcall rcb_setfnc(rcbid, "routine")  ;Set function to be called
    xcall rcb_call(rcbid)               ;Call function as xcall routine(arg_1,
                                        ; arg_2, arg_3, arg_4, arg_5)
    xcall rcb_delete(rcbid)             ;Delete RCB block
end

Also see %RCB_CALL Examples.