ExampleGeneral Functions

Invokes a published application.

int ctrx_run_published_app( char *app_name, char *app_args, [CONTINUE_ON_ERROR,] CTRX_LAST );

app_nameThe name of the published application.
app_argsThe arguments of the published application. A published application on the server can only access the argument if it is published with a percent sign and an asterisk (%*) as part of its command-line specification.
CONTINUE_ON_ERROR A constant, entered as shown without quotes. Overrides the error behavior runtime setting for this step so that script behaves as though the runtime setting was Continue on error.
CTRX_LAST A marker that indicates the end of the argument list.

ctrx_run_published_app invokes a published application, within a connected Citrix session. You can invoke use this function to invoke multiple applications during your session. This function is not generated during recording—you need to insert it manually.

Return Values

Citrix ICA Return Values


Parameterization is not available for this function.


In the following example, ctrx_run_published_app invokes Notepad and ctrx_sync_on_window waits for the window come into focus.

Action() {
	ctrx_connect_server("server", "login", "pwd", "domain", CTRX_LAST);
	if(ctrx_run_published_app("Notepad", CTRX_LAST) == E_OK) {
		 ctrx_sync_on_window( "Untitled - Notepad", ACTIVATE, 50, 50, 300, 300, "notepad_snapshot", CTRX_LAST);
	ctrx_disconnect_server("server", CTRX_LAST);	
	return 0;