Debugger Client Beta documentation - Revision history

JAL: /* New RetryHTTPPac command */ avoid proxy mode for this command

2015-06-12T22:30:11Z

New RetryHTTPPac command: avoid proxy mode for this command

← Older revision		Revision as of 22:30, 12 June 2015
Line 174:		Line 174:
	httpPac upload filename: 'PAC.10.111.2.82.JS' <== New line</b></p>		httpPac upload filename: 'PAC.10.111.2.82.JS' <== New line</b></p>

	====New ~~RetryHTTPPac~~ command====		====New retryHttpPac command====
	If you have an error on the validation of the HTTP PAC server when you bring up the Client, and then you fix the HTTP server, you can issue the <var>~~RetryHTTPPAC~~</var> command from the Client as an alternative to restarting the Client.		If you have an error on the validation of the HTTP PAC server when you bring up the Client, and then you fix the HTTP server, you can issue the <var>retryHttpPac</var> command from the Client as an alternative to restarting the Client.
			<p class="note"><b>Note:</b> The Client must not be in proxy mode when you issue the command. </p>

	====New &&currentPacFile function====		====New &&currentPacFile function====

JAL: not two arguments

2015-06-12T19:59:35Z

not two arguments

← Older revision		Revision as of 19:59, 12 June 2015
Line 189:		Line 189:
	<li><code>httpPutString <i>string url</i></code> — Do an <code>HTTP PUT</code> file upload for the string and URL specified. </li>		<li><code>httpPutString <i>string url</i></code> — Do an <code>HTTP PUT</code> file upload for the string and URL specified. </li>

	<li><code>httpGet <i>~~file~~ url</i></code> — Do an <code>HTTP GET</code> for the URL specified; display in Client console. </li>		<li><code>httpGet <i>url</i></code> — Do an <code>HTTP GET</code> for the URL specified; display in Client console. </li>
	</ul>		</ul>

JAL: typo

2015-06-09T22:23:45Z

typo

JAL: testing code wrapping

2015-06-05T18:42:58Z

testing code wrapping

← Older revision		Revision as of 18:42, 5 June 2015
Line 31:		Line 31:

	The following SOUL program takes one command line argument, a TCP/IP port number, and it creates a Janus Web server for uploading and serving PAC files:		The following SOUL program takes one command line argument, a TCP/IP port number, and it creates a Janus Web server for uploading and serving PAC files:
	<p ~~style~~="~~white-space: pre-wrap~~">begin		<p class="code">begin
	variables are undefined		variables are undefined
	local subroutine closeFile(%iFile is string len 8 input)		local subroutine closeFile(%iFile is string len 8 input)

JAL: testing code wrapping

2015-06-05T14:54:51Z

testing code wrapping

← Older revision		Revision as of 14:54, 5 June 2015
Line 31:		Line 31:

	The following SOUL program takes one command line argument, a TCP/IP port number, and it creates a Janus Web server for uploading and serving PAC files:		The following SOUL program takes one command line argument, a TCP/IP port number, and it creates a Janus Web server for uploading and serving PAC files:
	<p ~~class="code"~~ style="white-space: pre-wrap;">begin		<p style="white-space: pre-wrap">begin
	variables are undefined		variables are undefined
	local subroutine closeFile(%iFile is string len 8 input)		local subroutine closeFile(%iFile is string len 8 input)

JAL: testing code wrapping

2015-06-05T14:52:49Z

testing code wrapping

← Older revision		Revision as of 14:52, 5 June 2015
Line 31:		Line 31:

	The following SOUL program takes one command line argument, a TCP/IP port number, and it creates a Janus Web server for uploading and serving PAC files:		The following SOUL program takes one command line argument, a TCP/IP port number, and it creates a Janus Web server for uploading and serving PAC files:
	<p class="code">begin		<p class="code" style="white-space: pre-wrap;">begin
	variables are undefined		variables are undefined
	local subroutine closeFile(%iFile is string len 8 input)		local subroutine closeFile(%iFile is string len 8 input)

JAL: typo

2015-06-04T20:51:03Z

typo

← Older revision		Revision as of 20:51, 4 June 2015
Line 34:		Line 34:
	variables are undefined		variables are undefined
	local subroutine closeFile(%iFile is string len 8 input)		local subroutine closeFile(%iFile is string len 8 input)
	* Close the file whose name is passed. Messages ~~surpressed~~.		* Close the file whose name is passed. Messages supressed.
	%rc is float		%rc is float
	$resetn('MSGCTL', 6, %rc)		$resetn('MSGCTL', 6, %rc)
Line 42:		Line 42:
	local function openFile(%iFile is string len 8 input) is float		local function openFile(%iFile is string len 8 input) is float
	* Open the file whose name is passed and return 0 for success or		* Open the file whose name is passed and return 0 for success or
	* non-zero for failure. Messages ~~surpressed~~.		* non-zero for failure. Messages supressed.
	%rc is float		%rc is float
	$resetn('MSGCTL', 6, %rc)		$resetn('MSGCTL', 6, %rc)
Line 88:		Line 88:

	* Set up a simple Janus web server with web rules for loading		* Set up a simple Janus web server with web rules for loading
	* serving and listing PAC files generated ~~bythe~~ debugger client.		* serving and listing PAC files generated by the debugger client.
	%portName is string len 8 initial('JDPACSRV')		%portName is string len 8 initial('JDPACSRV')

JAL: port must not conflict

2015-06-04T20:38:57Z

port must not conflict

← Older revision		Revision as of 20:38, 4 June 2015
Line 124:		Line 124:
	<li><var class="term">pacServerHost</var> is the host name or IP number of the PAC Janus Web Server described above. </li>		<li><var class="term">pacServerHost</var> is the host name or IP number of the PAC Janus Web Server described above. </li>

	<li><var class="term"> pacServerPort</var> is the port number passed the to SOUL program shown above. </li>		<li><var class="term"> pacServerPort</var> is the port number passed the to SOUL program shown above. It must not be the same as any port being used for debugging. </li>

	<li><code>pacman</code> is a qualifier in the PAC file URL. See the <var>JANUS WEB</var> commands in the Janus Web Server definition in the example above in [[#Setting up an HTTP server for PAC files\|Setting up an HTTP server for PAC files]]. <code>pacman</code> is part of the <var>httpPacURL</var> tag specification only because <code>PACMAN</code> is specified in the <var>JANUS WEB</var> commands.</li>		<li><code>pacman</code> is a qualifier in the PAC file URL. See the <var>JANUS WEB</var> commands in the Janus Web Server definition in the example above in [[#Setting up an HTTP server for PAC files\|Setting up an HTTP server for PAC files]]. <code>pacman</code> is part of the <var>httpPacURL</var> tag specification only because <code>PACMAN</code> is specified in the <var>JANUS WEB</var> commands.</li>

JAL: add pacman info

2015-06-03T21:57:12Z

add pacman info

← Older revision		Revision as of 21:57, 3 June 2015
Line 113:		Line 113:
	%worker:run(%workForDaemon):print		%worker:run(%workForDaemon):print
	end</p>		end</p>
	Since the PAC files are temporary, they are stored in a memory file (not persistent between runs)~~. This also means that this procedure~~ does not need any disk files, DD cards, etc. The PAC files are stored as Model 204 procedures. The PAC file ~~procedures~~ created by the Client (see the following sections)~~, have names~~ based on the IP number of the Client workstation to avoid conflicts.		Since the PAC files are temporary, they are stored in an [[In-memory files\|in-memory file]] (not persistent between runs) which does not need any disk files, DD cards, etc. The PAC files are stored as Model 204 procedures. The name of a PAC file procedure created by the Client (see the following sections) is based on the IP number of the Client workstation to avoid conflicts.

	====DebuggerConfig.xml changes====		====DebuggerConfig.xml changes====
Line 125:		Line 125:

	<li><var class="term"> pacServerPort</var> is the port number passed the to SOUL program shown above. </li>		<li><var class="term"> pacServerPort</var> is the port number passed the to SOUL program shown above. </li>

			<li><code>pacman</code> is a qualifier in the PAC file URL. See the <var>JANUS WEB</var> commands in the Janus Web Server definition in the example above in [[#Setting up an HTTP server for PAC files\|Setting up an HTTP server for PAC files]]. <code>pacman</code> is part of the <var>httpPacURL</var> tag specification only because <code>PACMAN</code> is specified in the <var>JANUS WEB</var> commands.</li>
	</ul>		</ul>

	When the Debugger Client is started, and <code>httpPacURL</code> is specified in the configuration, the URL is validated with an HTTP PUT and GET of a test file. If there is a problem with <var>httpPacURL</var>, an error is displayed in the Client's Audit tab.		When the Debugger Client is started, and <code>httpPacURL</code> is specified in the configuration, the URL is validated with an HTTP PUT and GET of a test file. If there is a problem with <var>httpPacURL</var>, an error is displayed in the Client's Audit tab. For example:
			<p class="figure">[[File:PACerror.png\|600px]] </p>

	====Preferences UI changes====		====Preferences UI changes====

JAL: typo

2015-06-02T21:32:22Z

typo

← Older revision		Revision as of 21:32, 2 June 2015
Line 150:		Line 150:

	====SetIEMode command changes====		====SetIEMode command changes====
	If you use a <var>setIEMode</var> command ~~specifies~~ a PAC mode (<code>newPac</code> or <code>mergedPac</code>), specifying <code>file</code> or <code>http</code> controls the type of the PAC URL. <code>file</code> is the default:		If you use a <var>setIEMode</var> command to invoke a PAC mode (<code>newPac</code> or <code>mergedPac</code>), specifying <code>file</code> or <code>http</code> controls the type of the PAC URL. <code>file</code> is the default:
	<p class="syntax">setIEMode <span class="squareb">{</span>none<span class="squareb">\|</span>proxy<span class="squareb">\|</span>newPac<span class="squareb">\|</span>mergedPac<span class="squareb">}</span> <span class="squareb">[</span><u>file</u><span class="squareb">\|</span>http<span class="squareb">]</span></p>		<p class="syntax">setIEMode <span class="squareb">{</span>none<span class="squareb">\|</span>proxy<span class="squareb">\|</span>newPac<span class="squareb">\|</span>mergedPac<span class="squareb">}</span> <span class="squareb">[</span><u>file</u><span class="squareb">\|</span>http<span class="squareb">]</span></p>

← Older revision		Revision as of 22:23, 9 June 2015
Line 12:		Line 12:
	The Janus Debugger Client supports Proxy Auto Config (PAC) files,		The Janus Debugger Client supports Proxy Auto Config (PAC) files,
	providing a method to control which web requests are routed through the Janus		providing a method to control which web requests are routed through the Janus
	Debugger Client when you use the Internet Explorer (IE) browser.		Debugger Client when you use the Internet Explorer (IE) or Chrome browser.

	IE ~~uses~~ a URL to reference PAC files. Prior to Build 63 of the Debugger Client, the Client supported only file-mode URLs (<code>file://</code>), so the PAC files it generated had to be stored on the local file system of the workstation running the Client. As of its version 11, IE is deprecating the use of file URLs for PAC files in favor of HTTP (<code>http://</code>) URLs. Eventually file URLs will not be supported at all.		IE and Chrome use a URL to reference PAC files. Prior to Build 63 of the Debugger Client, the Client supported only file-mode URLs (<code>file://</code>), so the PAC files it generated had to be stored on the local file system of the workstation running the Client. As of its version 11, IE is deprecating the use of file URLs for PAC files in favor of HTTP (<code>http://</code>) URLs. Eventually file URLs will not be supported at all.

	To provide an HTTP URL, the Client will:		To provide an HTTP URL, the Client will:
Line 20:		Line 20:
	<li>Upload to an HTTP server the PAC files it generates in the existing "New Pac" or "Merged Pac" modes. </li>		<li>Upload to an HTTP server the PAC files it generates in the existing "New Pac" or "Merged Pac" modes. </li>

	<li>Set the PAC URL in IE to an HTTP-style URL that points to the PAC that was generated and uploaded. </li>		<li>Set the PAC URL in IE or Chrome to an HTTP-style URL that points to the PAC that was generated and uploaded. </li>
	</ul>		</ul>

Line 124:		Line 124:
	<li><var class="term">pacServerHost</var> is the host name or IP number of the PAC Janus Web Server described above. </li>		<li><var class="term">pacServerHost</var> is the host name or IP number of the PAC Janus Web Server described above. </li>

	<li><var class="term"> pacServerPort</var> is the port number passed the to SOUL program shown above. It must not be the same as any port being used for debugging. </li>		<li><var class="term"> pacServerPort</var> is the port number passed to the SOUL program shown above. It must not be the same as any port being used for debugging. </li>

	<li><code>pacman</code> is a qualifier in the PAC file URL. See the <var>JANUS WEB</var> commands in the Janus Web Server definition in the example above in [[#Setting up an HTTP server for PAC files\|Setting up an HTTP server for PAC files]]. <code>pacman</code> is part of the <var>httpPacURL</var> tag specification only because <code>PACMAN</code> is specified in the <var>JANUS WEB</var> commands.</li>		<li><code>pacman</code> is a qualifier in the PAC file URL. See the <var>JANUS WEB</var> commands in the Janus Web Server definition in the example above in [[#Setting up an HTTP server for PAC files\|Setting up an HTTP server for PAC files]]. <code>pacman</code> is part of the <var>httpPacURL</var> tag specification only because <code>PACMAN</code> is specified in the <var>JANUS WEB</var> commands.</li>
	</ul>		</ul>

	When the Debugger Client is started, and <code>httpPacURL</code> is specified in the configuration, the URL is validated with an HTTP PUT and GET of a test file. If there is a problem with <var>httpPacURL</var>, an error is displayed in the Client's Audit tab. For example:		When the Debugger Client is started, and <code>httpPacURL</code> is specified in the configuration, the URL is validated with an HTTP PUT and GET of a test file. If there is a problem with <var>httpPacURL</var>, an error is displayed in the Client's Audit Trail tab. For example:
	<p class="figure">[[File:PACerror.png\|600px]] </p>		<p class="figure">[[File:PACerror.png\|600px]] </p>

	====Preferences UI changes====		====Preferences UI changes====
	Once the server is set up and the Client configuration includes <code>httpPacURL</code>, you enable the HTTP PAC feature through user preferences:		Once the server is set up and the Client configuration includes <code>httpPacURL</code>, you enable the HTTP PAC feature through Client user preferences or through the [[#setIEMode command changes\|setIEmode command]]:
	<ol>		<ol>
	<li>Start the client. </li>		<li>Start the client. </li>
Line 152:		Line 152:
	As an alternative to the Client GUI, you can use the <var>setIEMode</var> command, which is enhanced to support this feature.		As an alternative to the Client GUI, you can use the <var>setIEMode</var> command, which is enhanced to support this feature.

	====~~SetIEMode~~ command changes====		====setIEMode command changes====
	If you use a <var>setIEMode</var> command to invoke a PAC mode (<code>newPac</code> or <code>mergedPac</code>), specifying <code>file</code> or <code>http</code> controls the type of the PAC URL. <code>file</code> is the default:		If you use a <var>setIEMode</var> command to invoke a PAC mode (<code>newPac</code> or <code>mergedPac</code>), specifying <code>file</code> or <code>http</code> controls the type of the PAC URL. <code>file</code> is the default:
	<p class="syntax">setIEMode <span class="squareb">{</span>none<span class="squareb">\|</span>proxy<span class="squareb">\|</span>newPac<span class="squareb">\|</span>mergedPac<span class="squareb">}</span> <span class="squareb">[</span><u>file</u><span class="squareb">\|</span>http<span class="squareb">]</span></p>		<p class="syntax">setIEMode <span class="squareb">{</span>none<span class="squareb">\|</span>proxy<span class="squareb">\|</span>newPac<span class="squareb">\|</span>mergedPac<span class="squareb">}</span> <span class="squareb">[</span><u>file</u><span class="squareb">\|</span>http<span class="squareb">]</span></p>