RCB_DELETE

Delete a routine call block

WSupported on Windows

USupported on Unix

VSupported on OpenVMS

xcall RCB_DELETE(rcbid)

Arguments

rcbid

The ID of the routine call block to delete. Once deleted, the block cannot be used. (n)

Discussion

Any routine call blocks that are not explicitly deleted are deleted when the runtime exits. However, we recommend that you delete the block when you are finished using it to avoid tying up system resources.

Examples

record
    rcbid       ,i4
    arg_1       ,a3
proc
    rcbid = %rcb_create(1)                      ;Create an RCB block with 1 arg
    xcall rcb_setarg(rcbid, arg_1, 1)           ;Set up arg_1 as argument #1
    xcall rcb_setfnc(rcbid, "routine")          ;Set function to be called
    xcall rcb_call(rcbid)                       ;Call function as xcall routine(arg_1)
    xcall rcb_delete(rcbid)                     ;Delete RCB block
end

Also see %RCB_CALL Examples.