Standard Library function that allows PV-WAVE to be called by external routines written in C.
Program
call_wave
, UNIX_LISTEN checks if the value of Program matches the value of the program parameter in call_wave
sent by the client. The client's program identifier is set by the program parameter in the call_wave
function call.User
call_wave
, and then returns the number of parameters passed to UNIX_LISTEN.Parameters are passed into PV-WAVE through the common block UT_COMMON. A maximum of thirty parameters can be passed to PV-WAVE.
The common block UT_COMMON is included in the server routine with the command
@UT_COMMON
. The first of the thirty available parameters is ut_param0
, the second is ut_paraml
, and the thirtieth parameter is ut_param29
.As well as being returned by UNIX_LISTEN, the number of parameters is also contained in the variable
ut_num_params
in the UT_COMMON common block.
For more information and an example, see the PV-WAVE GUI Application Developer's Guide.