GetMSBuffer

Returns the Machine Status data stored in one of 8 indexed buffers (zero-based) within the Machine Status stack. If Index is 0, the current Machine Status is returned.

Note: The In-Sight 2000 series vision sensor does not support this extended native mode command, and returns -2 when issued.

GetMSBuffer Inputs

Syntax: EV GetMSBuffer(Index)

Parameter Description

Index

Identifies which buffer to return (0 to 7).

GetMSBuffer Outputs

Returns a status code, followed by the number of characters (in bytes) for the results, then the results in XML format. The status codes are:

Status Codes Description
1 The command was executed successfully.
0 Unrecognized command.
-2 The command could not be executed.
-6 User does not have Full Access to execute the command. For more information, see User Access Settings Dialog.

GetMSBuffer Example

To retrieve the Machine Status data stored in buffer 0 within the Machine Status stack, issue the following command: EV GetMSBuffer(0)

The In-Sight sensor responds with a status code (1), followed by the number of characters, in bytes (713). Finally, the Machine Status data is returned.

Note:
  • The date and time specified for <BootTime> will only be current after the power has been cycled on an In-Sight device if the Use SNTP Services checkbox is selected and a Simple Network Time Protocol (SNTP) server is located.
  • The GetMSBuffer command can be used without the EV prefix by accessing the Machine Status Port. For more information, see Machine Status Port.