Using UltraEdit with the Debugger - Revision history

Ekern at 17:47, 25 April 2023

2023-04-25T17:47:40Z

← Older revision		Revision as of 17:47, 25 April 2023
Line 44:		Line 44:
	:: a. <span class="f_ListNum2">Click the </span><span class="term">Accounts</span><span class="f_ListNum2"> button, and in the </span><span class="term">FTP/SFTP Account Manager</span><span class="f_ListNum2"> dialog box, click the </span><span class="term">Add Account</span><span class="f_ListNum2"> button: </span>		:: a. <span class="f_ListNum2">Click the </span><span class="term">Accounts</span><span class="f_ListNum2"> button, and in the </span><span class="term">FTP/SFTP Account Manager</span><span class="f_ListNum2"> dialog box, click the </span><span class="term">Add Account</span><span class="f_ListNum2"> button: </span>

	[[File:ueftpacct1a_zoom60.gif\|429x395px\|UEftpAcct1a]]<span class="f_ListContinue3"> </span>		:: [[File:ueftpacct1a_zoom60.gif\|429x395px\|UEftpAcct1a]]<span class="f_ListContinue3"> </span>

	:: b. <span class="f_ListNum2">Provide values for the fields that are displayed in the </span><span class="term">General</span><span class="f_ListNum2"> tab: </span>		:: b. <span class="f_ListNum2">Provide values for the fields that are displayed in the </span><span class="term">General</span><span class="f_ListNum2"> tab: </span>
Line 77:		Line 77:
	</div>		</div>
	:: c. <span class="f_ListNum2">Click the </span><var>Apply</var><span class="f_ListNum2"> button, then click the </span><span class="term">OK</span><span class="f_ListNum2"> button.</span>		:: c. <span class="f_ListNum2">Click the </span><var>Apply</var><span class="f_ListNum2"> button, then click the </span><span class="term">OK</span><span class="f_ListNum2"> button.</span>
			:: On the <var>FTP Open</var><span class="f_ListContinue2"> page, your Account name displays in the </span><var>Account</var><span class="f_ListContinue2"> drop down list, and your Initial Directory value displays below that list. </span>

	<span class="f_ListContinue2">On the </span><var>FTP Open</var><span class="f_ListContinue2"> page, your Account name displays in the </span><var>Account</var><span class="f_ListContinue2"> drop down list, and your Initial Directory value displays below that list. </span>		:: [[File:ueftpacct2a_zoom60.gif\|383x113px\|UEftpAcct2a]]<span class="f_ListContinue2"> </span>

	[[File:ueftpacct2a_zoom60.gif\|383x113px\|UEftpAcct2a]]<span class="f_ListContinue2"> </span>

	:: d. <span class="f_ListNum2">Test your FTP connection: select the </span><var>Show Log</var><span class="f_ListNum2"> checkbox, then click the </span><var>Browse Site</var><span class="f_ListNum2"> button. </span>		:: d. <span class="f_ListNum2">Test your FTP connection: select the </span><var>Show Log</var><span class="f_ListNum2"> checkbox, then click the </span><var>Browse Site</var><span class="f_ListNum2"> button. </span>

Ekern at 16:28, 10 January 2023

2023-01-10T16:28:37Z

← Older revision		Revision as of 16:28, 10 January 2023
Line 4:		Line 4:
	'''Note:'''<span class="f_Notes"> You can use any version of </span><var>UltraEdit</var><span class="f_Notes"> that supports FTP Open. The details provided below are for version 12.10b and later. </span>		'''Note:'''<span class="f_Notes"> You can use any version of </span><var>UltraEdit</var><span class="f_Notes"> that supports FTP Open. The details provided below are for version 12.10b and later. </span>

	<span class="f_Para">The configuration steps below are described in this section. They assume the Debugger installation has been completed and tested, as described in [[~~:Debugger Home#~~Installation and Configuration\|Product Installation]]. </span>		<span class="f_Para">The configuration steps below are described in this section. They assume the Debugger installation has been completed and tested, as described in [[Installation and Configuration\|Product Installation]]. </span>

	# <span class="f_ListNum1">[[Using UltraEdit with the Debugger#Set up a Janus FTP server in the Model 204 Online\|Set up a Janus FTP server in the Model 204 Online]] </span>		# <span class="f_ListNum1">[[Using UltraEdit with the Debugger#Set up a Janus FTP server in the Model 204 Online\|Set up a Janus FTP server in the Model 204 Online]] </span>

Ekern at 16:27, 10 January 2023

2023-01-10T16:27:08Z

← Older revision		Revision as of 16:27, 10 January 2023
Line 73:		Line 73:
	\|-		\|-
	\| <span class="f_DefListTermTable">'''Initial Directory''' </span>		\| <span class="f_DefListTermTable">'''Initial Directory''' </span>
	\| <span class="f_DefListDDTable">Your initial location upon connecting to the FTP Server. This must correspond to a folder you specified including the forward slash ( / ) that precedes it in a JANUS FTP </span><span class="term">pname</span><span class="f_DefListDDTable"> ASSIGN command in the [[~~using_ultraedit.html~~#Set up a Janus FTP server in the Model 204 Online\|setup]] of your Janus FTP Server. Case does not matter.</span>		\| <span class="f_DefListDDTable">Your initial location upon connecting to the FTP Server. This must correspond to a folder you specified including the forward slash ( / ) that precedes it in a JANUS FTP </span><span class="term">pname</span><span class="f_DefListDDTable"> ASSIGN command in the [[Using UltraEdit with the Debugger#Set up a Janus FTP server in the Model 204 Online\|setup]] of your Janus FTP Server. Case does not matter.</span>
	\|}		\|}
	</div>		</div>

Ekern at 16:23, 10 January 2023

2023-01-10T16:23:27Z

← Older revision		Revision as of 16:23, 10 January 2023
Line 4:		Line 4:
	'''Note:'''<span class="f_Notes"> You can use any version of </span><var>UltraEdit</var><span class="f_Notes"> that supports FTP Open. The details provided below are for version 12.10b and later. </span>		'''Note:'''<span class="f_Notes"> You can use any version of </span><var>UltraEdit</var><span class="f_Notes"> that supports FTP Open. The details provided below are for version 12.10b and later. </span>

	<span class="f_Para">The configuration steps below are described in this section. They assume the Debugger installation has been completed and tested, as described in [[~~Category~~:Debugger Home#Installation and Configuration\|Product Installation]]. </span>		<span class="f_Para">The configuration steps below are described in this section. They assume the Debugger installation has been completed and tested, as described in [[:Debugger Home#Installation and Configuration\|Product Installation]]. </span>

	# <span class="f_ListNum1">[[Using UltraEdit with the Debugger#Set up a Janus FTP server in the Model 204 Online\|Set up a Janus FTP server in the Model 204 Online]] </span>		# <span class="f_ListNum1">[[Using UltraEdit with the Debugger#Set up a Janus FTP server in the Model 204 Online\|Set up a Janus FTP server in the Model 204 Online]] </span>
Line 51:		Line 51:

	{\|		{\|
	\| <span class="f_DefListTermTable">Account</span>		\| <span class="f_DefListTermTable">'''Account'''</span>
	\| <span class="f_DefListDDTable">Identifies this set of FTP connection values to </span><span class="f_ProductTable">UltraEdit</span><span class="f_DefListDDTable">, and you must also specify this value in the Debugger Client configuration file. </span>		\| <span class="f_DefListDDTable">Identifies this set of FTP connection values to </span><span class="f_ProductTable">UltraEdit</span><span class="f_DefListDDTable">, and you must also specify this value in the Debugger Client configuration file. </span>
	\|-		\|-
	\| <span class="f_DefListTermTable">Protocol</span>		\| <span class="f_DefListTermTable">'''Protocol'''</span>
	\| <span class="f_DefListDDTable">Leave the default value, </span><span class="f_MonoSpTable">FTP</span><span class="f_DefListDDTable">.</span>		\| <span class="f_DefListDDTable">Leave the default value, </span><span class="f_MonoSpTable">FTP</span><span class="f_DefListDDTable">.</span>
	\|-		\|-
	\| <span class="f_DefListTermTable">Server</span>		\| <span class="f_DefListTermTable">'''Server'''</span>
	\| <span class="f_DefListDDTable">The DNS name of the </span><var>Model 204</var><span class="f_DefListDDTable"> Online's host machine, or the IP address on your </span><var>Model 204</var><span class="f_DefListDDTable"> host to which the Janus FTP port is bound (BINDADDR in the Janus FTP Server port [[~~using_ultraedit.html~~#~~setup_ftp_in_m204~~\|definition]]). </span>		\| <span class="f_DefListDDTable">The DNS name of the </span><var>Model 204</var><span class="f_DefListDDTable"> Online's host machine, or the IP address on your </span><var>Model 204</var><span class="f_DefListDDTable"> host to which the Janus FTP port is bound (BINDADDR in the Janus FTP Server port [[Using UltraEdit with the Debugger#Set up a Janus FTP server in the Model 204 Online\|definition]]). </span>
	\|-		\|-
	\| <span class="f_DefListTermTable">'''Port'''</span>		\| <span class="f_DefListTermTable">'''Port'''</span>
	\| <span class="f_DefListDDTable">Replace the default value (21) with the port number you specified in the Janus FTP Server port [[~~using_ultraedit.html~~#~~setup_ftp_in_m204~~\|definition]]. </span>		\| <span class="f_DefListDDTable">Replace the default value (21) with the port number you specified in the Janus FTP Server port [[Using UltraEdit with the Debugger#Set up a Janus FTP server in the Model 204 Online\|definition]]. </span>
	\|-		\|-
	\| <span class="f_DefListTermTable">'''Username''' </span>		\| <span class="f_DefListTermTable">'''Username''' </span>
Line 73:		Line 73:
	\|-		\|-
	\| <span class="f_DefListTermTable">'''Initial Directory''' </span>		\| <span class="f_DefListTermTable">'''Initial Directory''' </span>
	\| <span class="f_DefListDDTable">Your initial location upon connecting to the FTP Server. This must correspond to a folder you specified including the forward slash ( / ) that precedes it in a JANUS FTP </span><span class="term">pname</span><span class="f_DefListDDTable"> ASSIGN command in the [[using_ultraedit.html#~~setup_ftp_in_m204~~\|setup]] of your Janus FTP Server. Case does not matter.</span>		\| <span class="f_DefListDDTable">Your initial location upon connecting to the FTP Server. This must correspond to a folder you specified including the forward slash ( / ) that precedes it in a JANUS FTP </span><span class="term">pname</span><span class="f_DefListDDTable"> ASSIGN command in the [[using_ultraedit.html#Set up a Janus FTP server in the Model 204 Online\|setup]] of your Janus FTP Server. Case does not matter.</span>
	\|}		\|}
	</div>		</div>

Ekern at 21:05, 9 January 2023

2023-01-09T21:05:09Z

← Older revision		Revision as of 21:05, 9 January 2023
Line 4:		Line 4:
	'''Note:'''<span class="f_Notes"> You can use any version of </span><var>UltraEdit</var><span class="f_Notes"> that supports FTP Open. The details provided below are for version 12.10b and later. </span>		'''Note:'''<span class="f_Notes"> You can use any version of </span><var>UltraEdit</var><span class="f_Notes"> that supports FTP Open. The details provided below are for version 12.10b and later. </span>

	<span class="f_Para">The configuration steps below are described in this section. They assume the Debugger installation has been completed and tested, as described in [[Debugger Home#Installation and Configuration\|Product Installation]]. </span>		<span class="f_Para">The configuration steps below are described in this section. They assume the Debugger installation has been completed and tested, as described in [[Category:Debugger Home#Installation and Configuration\|Product Installation]]. </span>

	# <span class="f_ListNum1">[[Using UltraEdit with the Debugger#Set up a Janus FTP server in the Model 204 Online\|Set up a Janus FTP server in the Model 204 Online]] </span>		# <span class="f_ListNum1">[[Using UltraEdit with the Debugger#Set up a Janus FTP server in the Model 204 Online\|Set up a Janus FTP server in the Model 204 Online]] </span>

Ekern at 21:04, 9 January 2023

2023-01-09T21:04:05Z

Show changes

Ekern at 03:31, 7 January 2023

2023-01-07T03:31:47Z

← Older revision		Revision as of 03:31, 7 January 2023
Line 1:		Line 1:
	__TOC__		__TOC__
	<span class="f_Para">To use </span><var>UltraEdit</~~vavr~~><span class="f_Para"> while debugging, you must configure a Janus FTP server in the Online as well as configure </span><var>UltraEdit</var><span class="f_Para"> and the Debugger Client on your workstation. Once this is complete, you can use </span><span class="f_Product">UltraEdit</span><span class="f_Para"> with the Debugger, as described above in [[~~using_local_editor.html~~\|Using a local editor]]. </span>		<span class="f_Para">To use </span><var>UltraEdit</var><span class="f_Para"> while debugging, you must configure a Janus FTP server in the Online as well as configure </span><var>UltraEdit</var><span class="f_Para"> and the Debugger Client on your workstation. Once this is complete, you can use </span><span class="f_Product">UltraEdit</span><span class="f_Para"> with the Debugger, as described above in [[Using a local editor\|Using a local editor]]. </span>

	<span class="f_EmphRed">Note:</span><span class="f_Notes"> You can use any version of </span><span class="f_Product">UltraEdit</span><span class="f_Notes"> that supports FTP Open. The details provided below are for version 12.10b and later. </span>		<span class="f_EmphRed">Note:</span><span class="f_Notes"> You can use any version of </span><span class="f_Product">UltraEdit</span><span class="f_Notes"> that supports FTP Open. The details provided below are for version 12.10b and later. </span>

Ekern: Created page with "TOC To use `UltraEdit while debugging, you must configure a Janus FTP server in the Online as well as configure..."`

2023-01-07T03:31:02Z

Created page with "__TOC__ To use <var>UltraEdit</vavr> while debugging, you must configure a Janus FTP server in the Online as well as configure..."

New page

__TOC__
To use <var>UltraEdit</vavr> while debugging, you must configure a Janus FTP server in the Online as well as configure <var>UltraEdit</var> and the Debugger Client on your workstation. Once this is complete, you can use UltraEdit with the Debugger, as described above in [[using_local_editor.html|Using a local editor]]. 

Note: You can use any version of UltraEdit that supports FTP Open. The details provided below are for version 12.10b and later. 

The configuration steps below are described in this section. They assume the Debugger installation has been completed and tested, as described in [[product_installation.html|Product Installation]]. 

# [[using_ultraedit.html#setup_ftp_in_m204|Set up a Janus FTP server in the Model 204 Online]] 
# [[using_ultraedit.html#set_up_ue|Set up UltraEdit]] 
# [[using_ultraedit.html#update_jdeb_cfgfile_ue|Update the Debugger Client configuration file]] 
# [[using_ultraedit.html#test_configuration_ue|Test the configuration]] 

=== Set up a Janus FTP server in the Model 204 Online ===

You must have the <var>Janus Sockets</var> product enabled, and you should refer to the "Janus FTP Server" chapter in the Janus Sockets Reference Manual. 

The following steps provide a simple example of JANUS commands you can use to set up a Janus FTP Server configured to access the procedures in the MYPROCFILE file: 

: 1. Create an FTP Server port with the JANUS DEFINE command: 

JANUS DEFINE FTPULTRA portnum FTPSERVER 8 - 
 AUDTERM - 
 BINDADDR xxx.xxx.xxx.xx 

:: where portnum will be the TCP port number for accessing your FTP Server, and xxx.xxx.xxx.xx is the IP address on your <var>Model 204</var> host to which the port is bound. 

: 2. Create a mapping that provides FTP Write access to the procedure file. 

The following example gives Write access to the file to all users, for the port defined in the previous step. The JANUS FTP command is described in the Janus Sockets Reference Manual. 

In this example, MYPROCFILE is made the home folder, although it need not be (for example, if you already have a home folder set to something else). 

JANUS FTP FTPULTRA ASSIGN /MYPROCFILE TO FILE MYPROCFILE 
JANUS FTP FTPULTRA HOME /MYPROCFILE TO ALL 
JANUS FTP FTPULTRA ALLOW /MYPROCFILE WRITE TO ALL 

: 3. Start the FTP Server port: 

JANUS START FTPULTRA

: 4. Issue the following command, and verify that your port is defined and started: 

JANUS STATUS

=== Set up UltraEdit ===

# Download and install a copy of <var>UltraEdit o</var>n the workstation that hosts the Debugger Client. 
# Start <var>UltraEdit</var>, and in the <var>File</var> menu, select <var>FTP</var>, then <var>Open from FTP</var>. 
# From the FTP Open dialog, create an account that contains the information UltraEdit needs to access your procedure file via the Janus FTP Server you configured: 

a.Click the Accounts button, and in the FTP/SFTP Account Manager dialog box, click the Add Account button: 

[[File:ueftpacct1a_zoom60.gif|429x395px|UEftpAcct1a]] 

b.Provide values for the fields that are displayed in the General tab: 

<div style="text-align: left; text-indent: 0; padding: 0 0 0 0; margin: 12px 0 12px 55px;">

{|
| Account
| Identifies this set of FTP connection values to UltraEdit, and you must also specify this value in the Debugger Client configuration file. 
|-
| Protocol
| Leave the default value, FTP.
|-
| Server
| The DNS name of the Model 204 Online's host machine, or the IP address on your Model 204 host to which the Janus FTP port is bound (BINDADDR in the Janus FTP Server port [[using_ultraedit.html#setup_ftp_in_m204|definition]]). 
|-
| Port
| Replace the default value (21) with the port number you specified in the Janus FTP Server port [[using_ultraedit.html#setup_ftp_in_m204|definition]]. 
|-
| Username 
| UltraEdit accesses Model 204 with this user ID and the Password value, below. Case does not matter. 
|-
| Password 
| The password for Username, above. Case does not matter.
|-
| User Account 
| Any value specified here, or no value, is ignored by the Janus FTP Server.
|-
| Initial Directory 
| Your initial location upon connecting to the FTP Server. This must correspond to a folder you specified including the forward slash ( / ) that precedes it in a JANUS FTP pname ASSIGN command in the [[using_ultraedit.html#setup_ftp_in_m204|setup]] of your Janus FTP Server. Case does not matter.
|}

</div>
c.Click the <var>Apply</var> button, then click the OK button.

On the <var>FTP Open</var> page, your Account name displays in the <var>Account</var> drop down list, and your Initial Directory value displays below that list. 

[[File:ueftpacct2a_zoom60.gif|383x113px|UEftpAcct2a]] 

d.Test your FTP connection: select the <var>Show Log</var> checkbox, then click the <var>Browse Site</var> button. 

The files in your procedure file should display in the central list box. 

The FTP functions represented by the various buttons on the right side of the <var>FTP Open</var> dialog box are all operational (except for <var>Create Dir </var>and <var>Permissions</var>, which Janus FTP does not support), so be cautious if you experiment further in this dialog box. For more information about what these buttons do, see the <var>UltraEdit</var> online Help. 

e.Select a default <var>Transfer Type</var> option: it will be associated with this account; then click the <var>Cancel</var> button to exit. 

4. Close <var>UltraEdit</var>. 

=== Update the Debugger Client configuration file ===

Once <var>UltraEdit</var> is installed and configured for debugging, you enable the Debugger(s) to invoke it by adding an entry to the Debugger Client configuration file (debuggerConfig.xml). This file is installed in the same directory as the Debugger Client executable file, and it is [[Customize debuggerConfig file|initially configured]] as part of the Debugger Client installation.

To update the file: 

# Open the debuggerConfig.xml file in a text editor. 
# Add an <editor> element (bounded by an <editor> start tag and an <\editor> end tag) at the same level (as a sibling of) the existing <serverList> element. 
: Include these <editor> subelements, and specify values for them as described in the Comment section below: 

<div style="text-align: left; text-indent: 0; padding: 0 0 0 0; margin: 24px 0 24px 30px;">

{|
|width="50%"| Subelement 
|width="50%"| Comment 
|-
| <program></program> 
|
The identifier of the <var>UltraEdit</var> program executable file (case does not matter). For example: <program>uedit32</program>.

'''Note:''' If the Windows system variable Path does not include the folder path that points to the UltraEdit executable (for example, C:\Program Files\Ultra-Edit-32), either add it to the Windows variable now, or specify the folder path before the executable file name in the <program> value. 

To locate the Path variable specification on a Windows 7 workstation, find the Control Panel (say, Start menu > Settings > Control Panel), then select System > Advanced system settings > Advanced tab > Environment Variables button > System variables > Path, then click Edit to see the full specification of the Path variable. 
|-
| <account></account> 
|
The name of the UltraEdit account you created to connect to the Janus FTP Server folder that contains the procedures you will be debugging. For example: <account>JALTEST</account>.

'''Note:''' This value is case sensitive; it must exactly match the value specified in UltraEdit.
|}

</div>
When complete, your configuration file should have a structure like the following: 

<debuggerConfig version="1.0">
 <serverList>
 .
 .
 .
 </serverList>
 <proxy>
 .
 .
 .
 </proxy>
 <editor>
 <program>uedit32</program>
 <account>JALTEST</account>
 </editor>
 .
 .
 .
</debuggerConfig> 

: 3. Save and close the file. 

=== Test the configuration ===

: 1. Restart the Debugger Client. 
: 2. Load a procedure in the Source Code tab of the Debugger Client: 

* <var>Janus Debugger</var>: From your web browser, invoke a URL that includes a procedure. 
* <var>TN3270 Debugger</var>: Issue the [[using_sirius_debug_cmd.html|TN3270 DEBUG ON]] command; then include a procedure from the <var>Model 204</var> command line. 

: 3. Right click a line of code, select <var>Line Information </var>from the context menu, then click the <var>Edit</var> button on the pop up that opens.

<var>UltraEdit</var> should open, displaying in its working area the procedure that contains the code line that you right clicked. If it fails to do so, and you verified earlier that, by itself, <var>UltraEdit</var> successfully transfers files from the FTP Server, begin your troubleshooting in the Debugger Client debuggerConfig.xml file settings for the <editor> element. 

'''Note:''' <var>UltraEdit</var> 12.10a versions open the procedure to line 1 in your procedure code. 12.10b and later versions, as well as 12.0x versions, open the procedure to the same line number as that from which you invoke the edit in the Debugger Client. 

[[Category:Debugger Home]]