SetIEMode command - Revision history

Ekern at 18:38, 9 February 2023

2023-02-09T18:38:44Z

← Older revision		Revision as of 18:38, 9 February 2023
Line 2:		Line 2:

	{\|		{\|
	\|width="~~50%~~"\| '''Action:'''		\|width="125px"\| '''Action:'''
	\|width="~~50%~~"\|		\|width="775px"\|
	<span class="f_Para">Controls whether, and the host URLs for which, the Debugger will serve as the </span><span class="f_ListBul1">[[Configure web browser (Janus Debugger only)\|proxy server]]</span><span class="f_Para"> for users of the Internet Explorer or Chrome browser. The command has options to set or remove the setting of the Client as the proxy server for IE or Chrome browser requests. The command also has an option to create a [[Configure web browser (Janus Debugger only)#Using the Client as proxy exclusively for designated addresses\|PAC (Proxy Auto Config) file]], which restricts the host URLs for which the Client will act as proxy server, and an option to merge such a PAC file with a preexisting PAC file, if any. </span>		<span class="f_Para">Controls whether, and the host URLs for which, the Debugger will serve as the </span><span class="f_ListBul1">[[Configure web browser (Janus Debugger only)\|proxy server]]</span><span class="f_Para"> for users of the Internet Explorer or Chrome browser. The command has options to set or remove the setting of the Client as the proxy server for IE or Chrome browser requests. The command also has an option to create a [[Configure web browser (Janus Debugger only)#Using the Client as proxy exclusively for designated addresses\|PAC (Proxy Auto Config) file]], which restricts the host URLs for which the Client will act as proxy server, and an option to merge such a PAC file with a preexisting PAC file, if any. </span>

Ekern at 03:54, 9 December 2022

2022-12-09T03:54:34Z

Ekern at 17:59, 9 July 2022

2022-07-09T17:59:14Z

← Older revision		Revision as of 17:59, 9 July 2022
Line 26:		Line 26:

	*<span class="f_Monospace">file</span><span class="f_ListBul1"> or </span><span class="f_Monospace">http</span>		*<span class="f_Monospace">file</span><span class="f_ListBul1"> or </span><span class="f_Monospace">http</span>
			**<span class="f_ListContinue">If you are using </span><span class="f_Monospace">newPac</span><span class="f_ListContinue"> or </span><span class="f_Monospace">mergedPac</span><span class="f_ListContinue"> to produce a PAC, specifying </span><span class="f_Monospace">file</span><span class="f_ListContinue"> or </span><span class="f_Monospace">http</span><span class="f_ListContinue"> sets the type of the URL that is sent to the browser. </span><span class="f_Monospace">file</span><span class="f_ListContinue"> is the default. </span><span class="f_ListContinue">To take advantage of an </span><span class="f_Monospace">http</span><span class="f_ListContinue"> setting, you must also [[configure_test_browser.html#setup_http_server\|configure an HTTP server]] to service the PAC file. </span>
	<span class="f_ListContinue">If you are using </span><span class="f_Monospace">newPac</span><span class="f_ListContinue"> or </span><span class="f_Monospace">mergedPac</span><span class="f_ListContinue"> to produce a PAC, specifying </span><span class="f_Monospace">file</span><span class="f_ListContinue"> or </span><span class="f_Monospace">http</span><span class="f_ListContinue"> sets the type of the URL that is sent to the browser. </span><span class="f_Monospace">file</span><span class="f_ListContinue"> is the default. </span>

	<span class="f_ListContinue">To take advantage of an </span><span class="f_Monospace">http</span><span class="f_ListContinue"> setting, you must also [[configure_test_browser.html#setup_http_server\|configure an HTTP server]] to service the PAC file. </span>

	<span class="f_Para">For parameter options that modify the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_Para"> configuration, no restart of the browser is necessary, and the Debugger provides automatic maintenance (makes the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_Para"> modifications at Client startup, then removes them when the Client closes). </span>		<span class="f_Para">For parameter options that modify the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_Para"> configuration, no restart of the browser is necessary, and the Debugger provides automatic maintenance (makes the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_Para"> modifications at Client startup, then removes them when the Client closes). </span>
Line 56:		Line 53:
	\|}		\|}

	[[Category:Debugger ~~Command~~]]		[[Category:Debugger Commands]]

Ekern at 17:57, 9 July 2022

2022-07-09T17:57:21Z

← Older revision		Revision as of 17:57, 9 July 2022
Line 45:		Line 45:
	*<span class="f_ListBul1">The </span><span class="f_Monospace">[[GeneratePac command\|generatePac]]</span><span class="f_ListBul1"> command, which creates and/or merges a PAC file, but makes no modifications to </span><span class="f_Para">the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_ListBul1"> configuration settings. </span>		*<span class="f_ListBul1">The </span><span class="f_Monospace">[[GeneratePac command\|generatePac]]</span><span class="f_ListBul1"> command, which creates and/or merges a PAC file, but makes no modifications to </span><span class="f_Para">the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_ListBul1"> configuration settings. </span>

	*<span class="f_ListBul1">The </span><span class="f_Monospace">[[~~SowIE~~ command\|showIE]]</span><span class="f_ListBul1"> command, which displays the current Internet connection settings plus additional details. </span>		*<span class="f_ListBul1">The </span><span class="f_Monospace">[[ShowIE command\|showIE]]</span><span class="f_ListBul1"> command, which displays the current Internet connection settings plus additional details. </span>

	*<span class="f_ListBul1">The </span><span class="f_CodeExample">[[RetryHttpPac command\|retryHttpPac]]</span><span class="f_ListBul1"> command, which verifies whether your HTTP PAC server is working and pointed to from the Client configuration file. </span><span class="f_CodeExample"> </span>		*<span class="f_ListBul1">The </span><span class="f_CodeExample">[[RetryHttpPac command\|retryHttpPac]]</span><span class="f_ListBul1"> command, which verifies whether your HTTP PAC server is working and pointed to from the Client configuration file. </span><span class="f_CodeExample"> </span>

Ekern at 17:56, 9 July 2022

2022-07-09T17:56:44Z

← Older revision		Revision as of 17:56, 9 July 2022
Line 33:		Line 33:
	<span class="f_Para">For parameter options that modify the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_Para"> configuration, no restart of the browser is necessary, and the Debugger provides automatic maintenance (makes the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_Para"> modifications at Client startup, then removes them when the Client closes). </span>		<span class="f_Para">For parameter options that modify the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_Para"> configuration, no restart of the browser is necessary, and the Debugger provides automatic maintenance (makes the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_Para"> modifications at Client startup, then removes them when the Client closes). </span>

	~~<span class="f_Para">~~Example: ~~</span>~~		'''Example:'''

	<span class="f_Para">If you issue the following command, the Debugger Client immediately generates a merged PAC file and configures the browser to run it; then at Client shutdown, the command restores the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_Para"> initial settings: </span>		<span class="f_Para">If you issue the following command, the Debugger Client immediately generates a merged PAC file and configures the browser to run it; then at Client shutdown, the command restores the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_Para"> initial settings: </span>
Line 43:		Line 43:
	<span class="f_Para">See also: </span>		<span class="f_Para">See also: </span>

	*<span class="f_ListBul1">The </span><span class="f_Monospace">[[~~generatepac_cmd.html~~\|generatePac]]</span><span class="f_ListBul1"> command, which creates and/or merges a PAC file, but makes no modifications to </span><span class="f_Para">the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_ListBul1"> configuration settings. </span>		*<span class="f_ListBul1">The </span><span class="f_Monospace">[[GeneratePac command\|generatePac]]</span><span class="f_ListBul1"> command, which creates and/or merges a PAC file, but makes no modifications to </span><span class="f_Para">the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_ListBul1"> configuration settings. </span>

	*<span class="f_ListBul1">The </span><span class="f_Monospace">[[~~showie_cmd.html~~\|showIE]]</span><span class="f_ListBul1"> command, which displays the current Internet connection settings plus additional details. </span>		*<span class="f_ListBul1">The </span><span class="f_Monospace">[[SowIE command\|showIE]]</span><span class="f_ListBul1"> command, which displays the current Internet connection settings plus additional details. </span>

	*<span class="f_ListBul1">The </span><span class="f_CodeExample">[[~~retryhttppac_cmd.html~~\|retryHttpPac]]</span><span class="f_ListBul1"> command, which verifies whether your HTTP PAC server is working and pointed to from the Client configuration file. </span><span class="f_CodeExample"> </span>		*<span class="f_ListBul1">The </span><span class="f_CodeExample">[[RetryHttpPac command\|retryHttpPac]]</span><span class="f_ListBul1"> command, which verifies whether your HTTP PAC server is working and pointed to from the Client configuration file. </span><span class="f_CodeExample"> </span>
	\|-		\|-
	\| '''Client menu:'''		\| '''Client menu:'''

Ekern: Created page with "TOC {| |width="50%"| '''Action:''' |width="50%"| Controls whether, and the host URLs for which, the Debugger will serve as the
2022-07-09T17:54:20Z

Created page with "TOC {| |width="50%"| '''Action:''' |width="50%"| Controls whether, and the host URLs for which, the Debugger will serve as the Controls whether, and the host URLs for which, the Debugger will serve as the [[configure_test_browser.html|proxy server]] for users of the Internet Explorer or Chrome browser. The command has options to set or remove the setting of the Client as the proxy server for IE or Chrome browser requests. The command also has an option to create a [[configure_test_browser.html#pacfile|PAC (Proxy Auto Config) file]], which restricts the host URLs for which the Client will act as proxy server, and an option to merge such a PAC file with a preexisting PAC file, if any. 

'''Syntax:'''
setIEMode {none|proxy|newPac|mergedPac} [file|http]

Where: 

*none 
**Makes no changes to the [[configure_test_browser.html#navigate_internetprops|Internet Properties tool]], which contains configuration settings for Internet Explorer and Chrome browsers, and undoes any such setting changes made since the Debugger Client was started. 

: This option also undoes the effects of any other setIEMode commands issued since the Client was started. 

*proxy 
**Makes the Debugger Client the proxy server for Internet Explorer and Chrome. This is the same as setting the Preferences dialog box equivalent, the proxy option for IE Mode. 

*newPac 
**Generates a PAC file using the [[customize_debugger_cfg_file.html#hostserverlist|hosts and ports specified]] in the Debugger configuration file (debuggerConfig.xml) settings, and sets IE and Chrome to use it. Any existing PAC file (that is, specified in the [[configure_test_browser.html#navigate_internetprops|Internet Properties tool]]) is not used. 

*mergedPac 
**Merges any existing PAC file with a PAC file generated from the Debugger configuration file settings, and sets IE and Chrome to use it. 

file or http

If you are using newPac or mergedPac to produce a PAC, specifying file or http sets the type of the URL that is sent to the browser. file is the default. 

To take advantage of an http setting, you must also [[configure_test_browser.html#setup_http_server|configure an HTTP server]] to service the PAC file. 

For parameter options that modify the Internet Properties configuration, no restart of the browser is necessary, and the Debugger provides automatic maintenance (makes the Internet Properties modifications at Client startup, then removes them when the Client closes). 

Example: 

If you issue the following command, the Debugger Client immediately generates a merged PAC file and configures the browser to run it; then at Client shutdown, the command restores the Internet Properties initial settings: 

 setIEMode mergedPac 

Once the above command is issued, the browser runs the script each time a URL is requested, and the Debugger Client serves as proxy only for the hosts specified in the script. The merged PAC file specification will persist through Client closes and starts until you use setIEMode or the Preferences dialog box to change or remove it. 

See also: 

The [[generatepac_cmd.html|generatePac]] command, which creates and/or merges a PAC file, but makes no modifications to the Internet Properties configuration settings. 

The [[showie_cmd.html|showIE]] command, which displays the current Internet connection settings plus additional details. 

The [[retryhttppac_cmd.html|retryHttpPac]] command, which verifies whether your HTTP PAC server is working and pointed to from the Client configuration file. 
|-
| '''Client menu:'''
| --
|-
| '''Introduced:'''
| Build 62 
|}

[[Category:Debugger Command]]

← Older revision		Revision as of 17:57, 9 July 2022
Line 45:		Line 45:
	*<span class="f_ListBul1">The </span><span class="f_Monospace">[[GeneratePac command\|generatePac]]</span><span class="f_ListBul1"> command, which creates and/or merges a PAC file, but makes no modifications to </span><span class="f_Para">the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_ListBul1"> configuration settings. </span>		*<span class="f_ListBul1">The </span><span class="f_Monospace">[[GeneratePac command\|generatePac]]</span><span class="f_ListBul1"> command, which creates and/or merges a PAC file, but makes no modifications to </span><span class="f_Para">the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_ListBul1"> configuration settings. </span>

	*<span class="f_ListBul1">The </span><span class="f_Monospace">[[~~SowIE~~ command\|showIE]]</span><span class="f_ListBul1"> command, which displays the current Internet connection settings plus additional details. </span>		*<span class="f_ListBul1">The </span><span class="f_Monospace">[[ShowIE command\|showIE]]</span><span class="f_ListBul1"> command, which displays the current Internet connection settings plus additional details. </span>

	*<span class="f_ListBul1">The </span><span class="f_CodeExample">[[RetryHttpPac command\|retryHttpPac]]</span><span class="f_ListBul1"> command, which verifies whether your HTTP PAC server is working and pointed to from the Client configuration file. </span><span class="f_CodeExample"> </span>		*<span class="f_ListBul1">The </span><span class="f_CodeExample">[[RetryHttpPac command\|retryHttpPac]]</span><span class="f_ListBul1"> command, which verifies whether your HTTP PAC server is working and pointed to from the Client configuration file. </span><span class="f_CodeExample"> </span>

← Older revision		Revision as of 03:54, 9 December 2022
Line 4:		Line 4:
	\|width="50%"\| '''Action:'''		\|width="50%"\| '''Action:'''
	\|width="50%"\|		\|width="50%"\|
	<span class="f_Para">Controls whether, and the host URLs for which, the Debugger will serve as the </span><span class="f_ListBul1">[[~~configure_test_browser.html~~\|proxy server]]</span><span class="f_Para"> for users of the Internet Explorer or Chrome browser. The command has options to set or remove the setting of the Client as the proxy server for IE or Chrome browser requests. The command also has an option to create a [[~~configure_test_browser.html~~#~~pacfile~~\|PAC (Proxy Auto Config) file]], which restricts the host URLs for which the Client will act as proxy server, and an option to merge such a PAC file with a preexisting PAC file, if any. </span>		<span class="f_Para">Controls whether, and the host URLs for which, the Debugger will serve as the </span><span class="f_ListBul1">[[Configure web browser (Janus Debugger only)\|proxy server]]</span><span class="f_Para"> for users of the Internet Explorer or Chrome browser. The command has options to set or remove the setting of the Client as the proxy server for IE or Chrome browser requests. The command also has an option to create a [[Configure web browser (Janus Debugger only)#Using the Client as proxy exclusively for designated addresses\|PAC (Proxy Auto Config) file]], which restricts the host URLs for which the Client will act as proxy server, and an option to merge such a PAC file with a preexisting PAC file, if any. </span>

	'''Syntax:'''		'''Syntax:'''
Line 12:		Line 12:

	*<span class="f_Monospace">none</span><span class="f_ListBul1"> </span>		*<span class="f_Monospace">none</span><span class="f_ListBul1"> </span>
	**<span class="f_ListContinue">Makes no changes to the [[~~configure_test_browser.html~~#~~navigate_internetprops~~\|Internet Properties tool]], which contains configuration settings for Internet Explorer and Chrome browsers, and undoes any such setting changes made since the </span><span class="f_ListBul1">Debugger Client</span><span class="f_ListContinue"> was started. </span>		**<span class="f_ListContinue">Makes no changes to the [[Configure web browser (Janus Debugger only)#Navigating to and within the Internet Properties dialog box\|Internet Properties tool]], which contains configuration settings for Internet Explorer and Chrome browsers, and undoes any such setting changes made since the </span><span class="f_ListBul1">Debugger Client</span><span class="f_ListContinue"> was started. </span>

	: <span class="f_ListContinue">This option also undoes the effects of any other </span><span class="f_Monospace">setIEMode</span><span class="f_ListContinue"> commands issued since the Client was started. </span>		: <span class="f_ListContinue">This option also undoes the effects of any other </span><span class="f_Monospace">setIEMode</span><span class="f_ListContinue"> commands issued since the Client was started. </span>

	*<span class="f_Monospace">proxy</span><span class="f_ListBul1"> </span>		*<span class="f_Monospace">proxy</span><span class="f_ListBul1"> </span>
	**<span class="f_ListContinue">Makes the Debugger Client the proxy server for Internet Explorer and Chrome</span><span class="f_EmphItal">.</span><span class="f_ListContinue"> This is the same as setting the </span><~~span class="f_GUIlabel"~~>Preferences</~~span~~><span class="f_ListContinue"> dialog box equivalent, the</span><~~span class="f_GUIlabel"~~> proxy </~~span~~><span class="f_ListContinue">option</span><span class="f_GUIlabel"> </span><span class="f_ListContinue">for </span><~~span class="f_GUIlabel"~~>IE Mode.</~~span~~><span class="f_ListContinue"> </span>		**<span class="f_ListContinue">Makes the Debugger Client the proxy server for Internet Explorer and Chrome</span><span class="f_EmphItal">.</span><span class="f_ListContinue"> This is the same as setting the </span><var>Preferences</var><span class="f_ListContinue"> dialog box equivalent, the</span><var> proxy </var><span class="f_ListContinue">option</span><span class="f_GUIlabel"> </span><span class="f_ListContinue">for </span><var>IE Mode.</var><span class="f_ListContinue"> </span>

	*<span class="f_Monospace">newPac</span><span class="f_ListBul1"> </span>		*<span class="f_Monospace">newPac</span><span class="f_ListBul1"> </span>
	**<span class="f_ListContinue">Generates a PAC file using the [[~~customize_debugger_cfg_file.html~~#~~hostserverlist~~\|hosts and ports specified]] in the Debugger configuration file (</span><span class="f_Monospace">debuggerConfig.xml</span><span class="f_ListContinue">) settings, and sets IE and Chrome to use it. Any existing PAC file (that is, specified in the [[~~configure_test_browser.html~~#~~navigate_internetprops~~\|Internet Properties tool]]) is </span><span class="f_EmphItal">not</span><span class="f_ListContinue"> used. </span>		**<span class="f_ListContinue">Generates a PAC file using the [[Customize debuggerConfig file#Basic configuration steps \|hosts and ports specified]] in the Debugger configuration file (</span><span class="f_Monospace">debuggerConfig.xml</span><span class="f_ListContinue">) settings, and sets IE and Chrome to use it. Any existing PAC file (that is, specified in the [[Configure web browser (Janus Debugger only)#Navigating to and within the Internet Properties dialog box\|Internet Properties tool]]) is </span><span class="f_EmphItal">not</span><span class="f_ListContinue"> used. </span>

	*<span class="f_Monospace">mergedPac</span><span class="f_ListBul1"> </span>		*<span class="f_Monospace">mergedPac</span><span class="f_ListBul1"> </span>
Line 26:		Line 26:

	*<span class="f_Monospace">file</span><span class="f_ListBul1"> or </span><span class="f_Monospace">http</span>		*<span class="f_Monospace">file</span><span class="f_ListBul1"> or </span><span class="f_Monospace">http</span>
	**<span class="f_ListContinue">If you are using </span><span class="f_Monospace">newPac</span><span class="f_ListContinue"> or </span><span class="f_Monospace">mergedPac</span><span class="f_ListContinue"> to produce a PAC, specifying </span><span class="f_Monospace">file</span><span class="f_ListContinue"> or </span><span class="f_Monospace">http</span><span class="f_ListContinue"> sets the type of the URL that is sent to the browser. </span><span class="f_Monospace">file</span><span class="f_ListContinue"> is the default. </span><span class="f_ListContinue">To take advantage of an </span><span class="f_Monospace">http</span><span class="f_ListContinue"> setting, you must also [[~~configure_test_browser.html~~#~~setup_http_server~~\|configure an HTTP server]] to service the PAC file. </span>		**<span class="f_ListContinue">If you are using </span><span class="f_Monospace">newPac</span><span class="f_ListContinue"> or </span><span class="f_Monospace">mergedPac</span><span class="f_ListContinue"> to produce a PAC, specifying </span><span class="f_Monospace">file</span><span class="f_ListContinue"> or </span><span class="f_Monospace">http</span><span class="f_ListContinue"> sets the type of the URL that is sent to the browser. </span><span class="f_Monospace">file</span><span class="f_ListContinue"> is the default. </span><span class="f_ListContinue">To take advantage of an </span><span class="f_Monospace">http</span><span class="f_ListContinue"> setting, you must also [[Configure web browser (Janus Debugger only)#Setting up an HTTP server for PAC files\|configure an HTTP server]] to service the PAC file. </span>

	<span class="f_Para">For parameter options that modify the </span><~~span class="f_GUIlabel"~~>Internet Properties</~~span~~><span class="f_Para"> configuration, no restart of the browser is necessary, and the Debugger provides automatic maintenance (makes the </span><~~span class="f_GUIlabel"~~>Internet Properties</~~span~~><span class="f_Para"> modifications at Client startup, then removes them when the Client closes). </span>		<span class="f_Para">For parameter options that modify the </span><var>Internet Properties</var><span class="f_Para"> configuration, no restart of the browser is necessary, and the Debugger provides automatic maintenance (makes the </span><var>Internet Properties</var><span class="f_Para"> modifications at Client startup, then removes them when the Client closes). </span>

	'''Example:'''		'''Example:'''

	<span class="f_Para">If you issue the following command, the Debugger Client immediately generates a merged PAC file and configures the browser to run it; then at Client shutdown, the command restores the </span><~~span class="f_GUIlabel"~~>Internet Properties</~~span~~><span class="f_Para"> initial settings: </span>		<span class="f_Para">If you issue the following command, the Debugger Client immediately generates a merged PAC file and configures the browser to run it; then at Client shutdown, the command restores the </span><var>Internet Properties</var><span class="f_Para"> initial settings: </span>

	<p class="syntax"> setIEMode mergedPac </p>		<p class="syntax"> setIEMode mergedPac </p>

	<span class="f_Para">Once the above command is issued, the browser runs the script each time a URL is requested, and the Debugger Client serves as proxy only for the hosts specified in the script. The merged PAC file specification will persist through Client closes and starts until you use </span><span class="f_Monospace">setIEMode</span><span class="f_Para"> or the </span><~~span class="f_GUIlabel"~~>Preferences</~~span~~><span class="f_Para"> dialog box to change or remove it. </span>		<span class="f_Para">Once the above command is issued, the browser runs the script each time a URL is requested, and the Debugger Client serves as proxy only for the hosts specified in the script. The merged PAC file specification will persist through Client closes and starts until you use </span><span class="f_Monospace">setIEMode</span><span class="f_Para"> or the </span><var>Preferences</var><span class="f_Para"> dialog box to change or remove it. </span>

	<span class="f_Para">See also: </span>		<span class="f_Para">See also: </span>