fusescript(1) — Commands

Name

fusescript − Communicate with the FUSE message server

Syntax

fusescript [ option ...]

Description

The fusescript command is available through the EnCASE programming facilities, which enable you to integrate a non-FUSE tool into FUSE. The fusescript command communicates with the DEC FUSE message server to exchange messages among tools that have been integrated into FUSE through EnCASE.

Options

−clear_dest
Clears a request to send messages to a specific tool instance set by the −set_dest option.

−help
Displays help information on the fusescript command options.

−info on|off
Specifies whether to display informational messages.

−message_finish call_id
Notifies the message server that the tool has finished processing the message specified in call_id.

−recv [timeout]
Specifies a message sent by other tools in FUSE. If a value for the optional timeout argument is specified (in seconds), a message must be received within the specified time; otherwise −recv returns an error. If the message has a return value, then −recv returns call_id.

−recvall
Shows all message replies received by the fusescript message server.

−reply call_id reply_text
Sends a reply, in reply_text, to a message, specified in call_id, that has a return value.

−req_id
Echoes to standard output the instance identifier of the tool issuing this command.

−req_sender
Echoes to standard output the instance identifier of the tool sending the current message or messge reply.

−send message param ...
Sends a message, specified in message, using the parameters specified in param (and others, if necessary). A null string ("") can be provided for param if parameters are not used.

−service
Shows available messages allowed to be sent and received.

−set_dest instance_id
Directs all subsequent messages to the tool instance specified by instance_id.

−state state_name
Requests the message server to change the state in the current fusescript tool.

Return Values

The following error status values can be returned when using the fusescript command options:

0 Indicates success. Can be returned by all options.

1 Indicates failure. Can be returned by the following options: -send, -reply, -message_finish, -state, -set_dest, -clear_dest, -req_id.

2 When the -send or -recv options are used, indicates timeout.

When the -req_sender option is used, indicates no reply.

Otherwise, indicates a tool cannot be started.

3 Indicates a tool cannot communicate with the message server.

Museum