NAME

Set_Situation - set a tool's current working directory

SYNOPSIS

Set_Situation(in string path);

DESCRIPTION

The Set_Situation request sets the current working directory.

The path argument is the pathname of the working directory that the recipient should use.

APPLICATION USAGE

The ttdt_session_join(3), function can be used to register for, and transparently process, the Set_Situation request.

EXAMPLES

The Set_Situation request can be sent as in the following example:

Tt_message msg = tttk_message_create(0, TT_REQUEST, TT_SESSION,
                          the_recipient_procid, TTDT_SET_SITUATION,
                          my_callback);
tt_message_arg_add(msg, TT_OUT, Tttk_string, 0);
tt_message_send(msg);

WARNINGS

Set_Situation can also be sent as a multicast notice, as an edict to all tools in the scope of the message. The consequences of doing so can be severe and unexpected.

SEE ALSO

tt_message_arg_add(3), tt_message_send(3), ttdt_session_join(3); Get_Situation request.