Set_Situation(4)

NAME
Set_Situation request - 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.