Agilent Technologies E4370A cfStateList, cfStateRecall, cfStateSave, cfTrigger, Syntax, Example

6 - Language Dictionary

cfStateList

Syntax

int cfStateList(CF_HANDLE server, char *buffer);

Description

Returns a comma-separated and null terminated list of instrument state names that are stored on the server. The buffer must be large enough to hold a list of the names of the maximum number of states that can be saved in a Cell Forming Server. The constant CF_MAX_STATE_LIST_LEN can be used to allocate space for the buffer.

Example

char list_buffer[CF_MAX_STATE_LIST_LEN];

/* Read and print the list of instrument state names. */ cfStateList(server, list_buffer);

printf("%s\n", list_buffer);

cfStateRecall

Syntax

int cfStateRecall(CF_HANDLE server, char *state);

Description

Loads a named instrument state previously created with cfStateSave. The server argument can be either a handle to a group obtained by cfOpenGroup, or a handle to all cells in the instrument if no groups are defined. All programmable functions of the instrument are set to the values stored in the state. This command also aborts any forming sequence that is in progress, setting the forming state to CF_IDLE.

cfStateSave

Syntax

int cfStateSave(CF_HANDLE server, char *state);

Description

Saves the current instrument settings in a non-volatile state with the name given by the state parameter. The server argument can be either a handle to a group obtained by cfOpenGroup, or a handle to all cells in the instrument if no groups are defined. If a state already exists with the given name, the old state is over-written. State names are limited to CF_MAX_STATE_NAME_LEN characters in length.

cfTrigger

Syntax

int cfTrigger(CF_HANDLE server);

Description

Sends a trigger from the CF_LAN trigger source. The server argument can be either a handle to a group obtained by cfOpenGroup, or a handle to all cells in the instrument if no groups are defined.

102