xPCFSScSetFilename

Specify name for file to contain signal data

Prototype

void xPCFSScSetFilename(int port, int scNum, 
const char *filename);

Note

Do not use this C API type definition. Support for this type definition relies on support for the C API, which will be removed in a future release.

Arguments

port

Enter the value returned by the function xPCOpenTcpIpPort.

scNum

Enter the scope number.

filename

Enter the name of a file for receiving the signal data.

Description

The xPCFSScSetFilename function sets the name of the file to which the scope saves the signal data. The Simulink® Real-Time™ software creates this file in the target computer file system. You can only call this function when the scope is stopped.

A fully qualified file name in the operating system on the target computer can have a maximum of 260 characters. If the file name is longer than eight-dot-three format (eight character file name, period, three character extension), the operating system represents the file name in truncated form (for example, six characters followed by '~1'). MATLAB commands can access the file using the fully qualified file name or the truncated representation of the name. Some block parameters, such as the Scope block filename parameter, require 8.3 format for the file name.

Introduced before R2006a