The features described in this topic are obsolete
and should not be used in new IDL code.

send_idl_command

Syntax

int send_idl_command(CLIENT* client, char* command);

Description

Call this function to send an IDL command to the IDL server referred to by client. The command is executed just as if it had been entered from the IDL command line.

This function cannot be used to send multi-line commands. If the first part of a multi-line command is sent, for example:

send_idl_command(client, "FOR I=1,5 DO $");

IDL spawns an interactive session and may hang. In any case, subsequent commands are not executed.

Parameters

client

A pointer to the CLIENT structure that corresponds to the desired IDL session.

command

A null-terminated string with no more than MAX_STRING_LEN characters. MAX_STRING_LEN is defined in the file idldir/external/rpc/rpc_idl.h.

Return Value

This function returns a status value that denotes success or failure as described below.

-1 = RPC communication failure (an error message is also printed).

0 = Command is NULL.

1 = Success.

For all other errors, the error number is returned. This number could be passed as an argument to STRMESSAGE();.