1
0
Fork 0
mirror of https://github.com/eclipse-cdt/cdt synced 2025-07-18 22:45:23 +02:00

142739 RSE documentation contribution

This commit is contained in:
David Dykstal 2006-05-30 15:34:22 +00:00
parent 5be2686f54
commit ff7bc44ce1
53 changed files with 2672 additions and 0 deletions

View file

@ -0,0 +1,22 @@
<?xml version="1.0" encoding="UTF-8"?>
<projectDescription>
<name>org.eclipse.rse.doc.user</name>
<comment></comment>
<projects>
</projects>
<buildSpec>
<buildCommand>
<name>org.eclipse.pde.ManifestBuilder</name>
<arguments>
</arguments>
</buildCommand>
<buildCommand>
<name>org.eclipse.pde.SchemaBuilder</name>
<arguments>
</arguments>
</buildCommand>
</buildSpec>
<natures>
<nature>org.eclipse.pde.PluginNature</nature>
</natures>
</projectDescription>

View file

@ -0,0 +1,8 @@
Manifest-Version: 1.0
Bundle-ManifestVersion: 2
Bundle-Name: %plugin.name
Bundle-SymbolicName: org.eclipse.rse.doc.user; singleton:=true
Bundle-Version: 1.0.0.qualifier
Bundle-Vendor: %provider.name
Bundle-Localization: plugin
Eclipse-LazyStart: false

View file

@ -0,0 +1,27 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
<html>
<head>
<title>About</title>
<meta http-equiv=Content-Type content="text/html; charset=ISO-8859-1">
</head>
<body lang="EN-US">
<h2>About This Content</h2>
<p>May 2, 2006</p>
<h3>License</h3>
<p>The Eclipse Foundation makes available all content in this plug-in (&quot;Content&quot;). Unless otherwise
indicated below, the Content is provided to you under the terms and conditions of the
Eclipse Public License Version 1.0 (&quot;EPL&quot;). A copy of the EPL is available
at <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>.
For purposes of the EPL, &quot;Program&quot; will mean the Content.</p>
<p>If you did not receive this Content directly from the Eclipse Foundation, the Content is
being redistributed by another party (&quot;Redistributor&quot;) and different terms and conditions may
apply to your use of any object code in the Content. Check the Redistributor's license that was
provided with the Content. If no such license exists, contact the Redistributor. Unless otherwise
indicated below, the terms and conditions of the EPL still apply to any source code in the Content
and such source code may be obtained at <a href="/">http://www.eclipse.org</a>.</p>
</body>
</html>

View file

@ -0,0 +1 @@
@import "../PRODUCT_PLUGIN/book.css";

View file

@ -0,0 +1,11 @@
bin.includes = META-INF/,\
plugin.xml,\
about.html,\
concepts/,\
images/,\
plugin.properties,\
ref/,\
tasks/,\
book.css,\
notices.html,\
toc.xml

View file

@ -0,0 +1,66 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Remote System Explorer Connections</title>
</head>
<body id="cbegin">
<a name="cbegin"><!-- --></a>
<h1 class="topictitle1">Remote System Explorer Connections</h1>
<div>
<p>When you first open the Remote System Explorer, you are not
connected to
any system except your local workstation. To connect to a remote
server,
you need to define a connection. A connection is a TCP/IP network
connection
to your server, that enables you to access, edit, run, compile, and
debug items on the server. When you define a connection, you select the
type of connection you want, specify the
name or IP address of the remote system and you also give the
connection itself
a unique name that acts as a label in your workspace so that you can
easily
connect and disconnect. These actions are performed in the Remote
System Explorer. </p>
<p>When you open the workbench for the first time, you
need to define a profile,
define a connection, and then connect to a server. When you connect,
the workbench prompts you for your user ID and password on that server
so
that you can access the folders and files on that server.</p>
<p>Note: Make sure you have started the server programs on your
remote system. These programs depend on the kind of system you
are connecting to. See the appropriate tasks below for the recommended
ways to configure and start your server.</p>
<p>When you have a connection, you can organize your data using <a
href="cfilters.html">filters,
filter pools, and filter pool references</a>, which list a set of
folders and files from your server in the Remote Systems view. </p>
<p>You can use the Remote System Explorer to access files on many
kinds
of servers, such as Linux, UNIX, Windows, or your local workstation. If
you have the appropriate IBM products installed you can also connect to
iSeries and zSeries servers.&nbsp; See the
links below for information on how to connect to these other kinds of
servers.</p>
</div>
<div>
<p><b class="relconceptshd">Related concepts</b><br/>
<a href="cfilters.html" title="">Remote System Explorer filters, filter
pools, and filter pool references</a><br/>
<a href="cprofile.html" title="">Remote System Explorer Profiles</a><br/>
<a href="cuniversal.html">Universal Systems</a><br/>
</p>
<p><b class="reltaskshd">Related tasks</b><br/>
<a href="../tasks/tbeginlinux.html" title="">Connecting to a remote
Linux or UNIX server</a><br/>
<a href="../tasks/tbeginwindows.html" title="">Connecting to a remote
Windows server</a><br/>
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,116 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Remote System Explorer filters, filter pools, and filter pool references</title>
</head>
<body id="cfilters">
<a name="cfilters"><!-- --></a>
<h1 class="topictitle1">Remote System Explorer filters, filter pools,
and filter pool references</h1>
<div>
<p>The Remote System Explorer is a set of local client tools you use to
organize
how you want to work with the resources such as folders and files on
your
remote server. The following graphic serves as an introduction to
some of the main components of the Remote System Explorer:<br/>
<img src="../images/ModelRSE.gif" alt=""/><br/>
</p>
<div class="p">In the Remote System Explorer perspective, you query
your server
to list and perform actions upon remote resources such as folders and
files. You perform
these tasks on these remote resources by using <i>filters</i> that
show these resources at your workstation.<br/>
</div>
<p>The Remote System Explorer perspective is designed to allow you to
manipulate the resources directly on the remote system.&nbsp; The
actions that are available depend on the type of system you are
connecting to and the way the resource is recognized.&nbsp; For
example, your selections can define
a filter string to find all files that match *.c in a partcular
directory. </p>
<div class="p">When you access the list by expanding the filter, you
can see all the files that match that filter and you can perform
actions (such as editing, compiling, running, and debugging) against
these files.
<div class="note"><span class="notetitle">Note: </span>You can drag
and drop filters from one subsystem or filter
pool to another. However, if you drag a filter into another filter, the
filter strings from the source filter are added to the ones already in
the target
filter.</div>
</div>
<p id="cfilters__poolsdesc"><a name="cfilters__poolsdesc"><!-- --></a>If
you have been using the Remote System Explorer for some
time, your workspace might contain too many filters to navigate easily.
Or,
you might just want to keep groups of filters separate if, for example,
you
need to represent two distinct environments in the Remote System
Explorer,
regardless of how many filters you have. In either case, you can group
filters
into <i>filter pools</i>. </p>
<p>For example, one filter pool could contain filters for an accounts
receivable
program while another contains filters for a payroll program. Or, if
you
have two different environments on your server: a production
environment and a test environment, you can define a distinct
environment and set of filters for each. </p>
<p id="cfilters__poolsdesc2"><a name="cfilters__poolsdesc2"><!-- --></a>Without
filter pools, all of your filters appear together
in all connections. When you create filter pools, however, any filter
you
create within that filter pool is distinct to that connection, and will
not
appear in any other connections. (See the related links for more
information
about filter pools.)</p>
<p id="cfilters__filterstrings"><a name="cfilters__filterstrings"><!-- --></a>You
can share filter pools among many connections through
the use of a <i>filter pool reference</i>. A filter pool reference is
a mechanism
that displays a filter pool from one connection in any other
connection, so
that when you make a change to the original filter pool, your change is
reflected
your filter pool reference.</p>
<p>All connections, filters, filter pools, and so on, belong to a
Remote System Explorer <i>profile</i>, that you define during your
first connection
to a server. You might wonder what happens to your filters or filter
pools if you delete a connection, especially if you have filters shared
among
two or more connections. Rest assured that the filters are not deleted,
since
filters actually belong to profiles, and not connections.<br/>
</p>
<p>Keep in mind that if you need to have an entirely new configuration
of filter pools, filters and connection in the Remote System Explorer,
you can always create a new profile. See
the related links for more information.</p>
</div>
<div>
<p><b class="relconceptshd">Related concepts</b><br/>
<a href="cuseractions.html" title="">User actions (user options)</a><br/>
<a href="cremcompile.html" title="">Compiling</a><br/>
</p>
<p><b>Related Tasks</b><br/>
<a href="../tasks/tmanagepools.html" title="">Configuring filter pools</a><br/>
<a href="../tasks/tmanageedit.html"
title="You can change the properties for any filter by opening the filter's properties sheet. You can also add new filter strings to a filter from this sheet. For example, if you have a filter that lists all *.rpgle source members, you can add an additional filter string that will display all *.cblle source members as well.">Changing
filters</a><br/>
<a href="../tasks/tmanagedel.html" title="">Deleting filters</a><br/>
<a href="../tasks/tbeginsecprofile.html" title="">Creating a second
profile</a><br/>
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,104 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Remote System Explorer Profiles</title>
</head>
<body id="cprofile">
<a name="cprofile"><!-- --></a>
<h1 class="topictitle1">Remote System Explorer Profiles</h1>
<div>
<p>When you define your first connection to your remote server, you
will also define
your first profile. All Remote System Explorer resources such as
connections,
filters, and filter pools are owned by a profile. Profiles help you
manage these resources when you have a lot of connections. The Remote
System Explorer creates
a unique profile per team member (that person's <span
style="font-style: italic;">private profile</span>), plus a common
profile called <i>Team</i>.
You can also create your own profiles. </p>
<div class="p">Profiles contain:
<ul>
<li>Connections -- including subsystem properties. User IDs and
passwords are not shared.</li>
<li>Filters, filter pools, and filters pool references</li>
<li>User-defined actions</li>
<li>Compile commands</li>
</ul>
</div>
<p>Profiles can be active, or inactive. By default, only your private
profile
and the Team profile are active. The Remote System Explorer displays
all connections
from all active profiles and, within a connection, allows filter pools
to
be referenced from any active profile. Further, the user actions and
compile
commands shown in the right-click menu for a remote resource are from
all
active profiles.</p>
<p>Your first profile will be for your local workstation. When you
complete
the steps for your first connection, you can decide whether to use your
personal
profile or the Team profile so that you can share resources and
information
with other people.</p>
<div class="p">Placing all connection and filter data in a profile
shared by the team
assists in team support, since all connections, filter pools, and team
profiles
can be shared among team members. You can use the Team view to control
which
profiles display in your workspace by making the profiles active.
<div class="note"><span class="notetitle">Note: </span>Making
a profile active or inactive does not affect your teammates. For
example,
you can choose not to display one of your own profiles in your
workspace,
but a teammate can make that profile active in his or her workspace.
You will
see the profiles you or your teammates have made inactive in the Team
view when you perform a synchronization with the repository in which
the profiles are stored.&nbsp; See topics in the help contents and
links
below about team support for more information on profiles and shared
data.</div>
</div>
<p>To reduce collisions when you synchronize the user IDs and the
ordering of
resources in a profile are stored locally on your workstation. To
participate
in team support, you need to synchronize with, and upload your profiles
to a central repository. Use the <a href="../tasks/tteamsup.html">Team
view</a> to
share source and profile information with other team members, and to
synchronize
that information with the repository. Everything except your user ID
will
then be stored on the server, and any developer can obtain profile
resources
from the central server. </p>
</div>
<div>
<p><b class="relconceptshd">Related concepts</b><br/>
<a href="cfilters.html" title="">Remote System Explorer filters, filter
pools, and filter pool references</a><br/>
<a href="cbegin.html" title="">Remote System Explorer Connections</a><br/>
<a href="cteam.html" title="">Team support</a><br/>
</p>
<p><b class="reltaskshd">Related tasks</b><br/>
<a href="../tasks/tteamsup.html" title="">Using team support</a><br/>
<a href="../tasks/tteamsup1.html" title="">Working with profiles and
team support</a><br/>
<a href="../tasks/tbeginsecprofile.html" title="">Creating a second
profile</a><br/>
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,60 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Compiling</title>
</head>
<body id="cremcompile">
<a name="cremcompile"><!-- --></a>
<h1 class="topictitle1">Compiling Programs</h1>
<div>
<p>You can run a compile command on a server from the Remote System
Explorer perspective.&nbsp; When you compile, the workbench determines
the source type of the file, and then runs
the last used compile command for that type. However, you can always
change
this behavior through Remote Systems preferences (see the related
links).</p>
<p>You can also compile multiple resources listed in a filter by
holding down the CTRL key and clicking on all the members
you want to compile, right-click to access the compile menu, and then
select the compile command you wish to run. The workbench determines
what order to compile these resources according to the preferences you
specify for that workspace.</p>
<div class="p">Note that multiple file compilation is disabled if:
<ul>
<li>One or more of the selected source types are not compatible.</li>
<li>The selected resources are not from the same connection.</li>
</ul>
</div>
<p>A compile command is always associated with a particular source
type. It consists of an identifier and a command string that will be
run on the
server.&nbsp; Each profile in the Remote System Explorer has a set of
source member types,
and each source type has a set of compile commands associated with
them. You
can add source types to a profile and add compile commands to a source
type.</p>
<p>IBM supplies a number
of default compile commands for common file types and you can also add
your own.&nbsp; Since compile commands are owned by a profile they can
be shared using team support.</p>
<p>See the related topics below for more information.</p>
</div>
<div>
<p><b class="reltaskshd">Related concepts</b><br/>
<a href="cprofile.html"><span style="text-decoration: underline;">Profiles</span></a><br/>
<a href="crunremcmds.html">Commands and Shells</a><br/>
</p>
<p><b class="relrefhd">Related reference</b><br/>
<a href="../ref/rrsepref.html" title="">Preferences</a><br/>
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,43 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Shells and commands in the Remote Systems view</title>
</head>
<body id="crunremcmds">
<a name="crunremcmds"><!-- --></a>
<h1 class="topictitle1">Shells and commands in the Remote Systems view</h1>
<div>
<p>You can use the Remote Commands view to run and interact with commands
and command shells on universal systems. A universal system includes Windows,
Linux, and UNIX system types.<br/>
</p>
<p>Specifically, use the view to: </p>
<ul>
<li>Run commands in a command shell</li>
<li>Display and interpret the output of a program</li>
<li>Enter input to a program</li>
<li>Display and manage different commands and shells from the same
view. Multiple commands can be run in a single shell (one command at a time per
shell), multiple shells may be run on a single system, and multiple systems may be
running shells.</li>
</ul>
<p>Whenever a command shell is launched or a command is run from within
Remote System Explorer, the Remote Commands view is used to display the output
and provide a way to work with that output. </p>
</div>
<div>
<p><b class="reltaskshd">Related tasks</b><br/>
<a href="../tasks/truncmdsview.html" title="">Running and viewing
commands and shells using the Remote Commands view</a><br/>
<a href="../tasks/twrkcmdshl.html" title="In the Remote Systems view, you can launch a shell to perform commands in the iSeries Integrated File System (IFS).">Working
with command shells</a><br/>
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,71 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Team support</title>
</head>
<body id="cteam">
<a name="cteam"><!-- --></a>
<h1 class="topictitle1">Team support</h1>
<div>
<p>The team support model works with shared repositories that store
version-managed resources on servers that are accessible to the entire team. Usually
you would share the folders and files of an Eclipse project.&nbsp; Each
team member sends their changes to the repository, and receives changes
that
were made by a team member from the repository. While the Remote System
Explorer
is not project-based, (it is designed for direct access to remote
resources),
there is a single project created for all the non-remote resources that
the
Remote System Explorer manages. Profiles are stored in that project and
so everything that belongs to a profile can be
shared with your teammates.</p>
<div class="p" id="cteam__profilelist"><a name="cteam__profilelist"><!-- --></a>Profiles
contain:
<ul>
<li>Connections -- including various subsystem properties. User IDs
and passwords are not shared.</li>
<li>Filters, filter pools, and filters pool references</li>
<li>User-defined actions</li>
<li>Compile commands</li>
</ul>
</div>
<p> Use the Team view of the Remote System Explorer perspective to
associate
and synchronize the project named RemoteSystemsConnection that contains
these profiles with a repository. After
synchronizing with the repository, you will receive all the shared
Remote System
Explorer resources from your team, including their profiles. You then
use the <b>Reload Remote System Explorer</b> action, located on the
pop-up menu, to make the Remote Systems Explorer know about these
changes.&nbsp; You can also, of course, quit and restart the
workbench.&nbsp; See the related tasks for more information.</p>
<p>Any resources received that are in a profile that you have already
active, such
as Team, will immediately be available and accessible to you. However,
resources
in other profiles will not be available unless you choose to make those
profiles
active. If you use multiple workstations, team support can also be used
to
make your own private configurations of filters, filter pools, and
connections available on all the workstations by making
your profile active on each workstation.</p>
</div>
<div>
<p><b class="relconceptshd">Related concepts</b><br/>
<a href="cprofile.html" title="">Remote System Explorer Profiles</a><br/>
</p>
<p><b class="reltaskshd">Related tasks</b><br/>
<a href="../tasks/tteamsup.html" title="">Using team support</a><br/>
<a href="../tasks/tteamsup1.html" title="">Working with profiles and team support</a><br/>
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,54 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2003, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Linux, UNIX, and Windows host access</title>
</head>
<body>
<a name="cuniversal"><!-- --></a>
<h1 class="topictitle1">Universal Systems</h1>
<div>
<p>At a minimum the Remote System Explorer provides access to&nbsp;
Linux,
UNIX, and Windows systems.&nbsp; These are called "universal" systems
since their file and command systems are quite similar.&nbsp; You can
export,
import, explore remote files, and run remote
commands on all of these system types.
You can also drag/drop and copy/paste between
two systems of the same or different type.
For example, you can drag and drop a file
from your Windows host to your Linux host,
from one Linux host to another, or from one
file in your Linux host to another file in
the same host.</p>
<p>The Remote System Explorer can also provide access to other types of
systems if the support is installed in the workbench.&nbsp; Examples of
such systems might be IBM iSeries or zSeries server systems.<br/>
</p>
<p>Expand the topics in the help contents or click the following links
for
information on Universal host access:<br/>
</p>
</div>
<div>
<p><b>Related concepts</b><br clear="all"/>
<a href="crunremcmds.html">Shells and commands in the Remote Systems view</a><br clear="all"/>
</p>
<p><b>Related tasks</b><br clear="all"/>
<a href="../tasks/tbeginlinux.html">Connecting to a remote Linux or UNIX host</a><br clear="all"/>
<a href="../tasks/tbeginwindows.html">Connecting to a remote Windows host</a><br clear="all"/>
<a href="../tasks/tbeginsecond.html">Creating a second connection to aremote host</a><br clear="all"/>
<a href="../tasks/tbegindelete.html">Deleting a connection</a><br clear="all"/>
<a href="../tasks/tbegindiscon.html">Disconnecting from a remote host</a><br clear="all"/>
<a href="../tasks/ttablecopy.html">Copying and pasting in the Remote System Explorer</a><br clear="all"/>
<a href="../tasks/ttabledrag.html">Dragging and dropping items in the Remote System Explorer</a><br clear="all"/>
<a href="../tasks/tbeginenv.html">Configuring environment variablesupport for connections</a>
</div>
</body>
</html>

View file

@ -0,0 +1,48 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>User actions (user options)</title>
</head>
<body id="cuseractions">
<a name="cuseractions"><!-- --></a>
<h1 class="topictitle1">User actions (user options)</h1>
<div>
<p>User actions are server commands that you define on the <b>Work
With
User Actions</b> window, and will run against resources such as files
and folders on your server.</p>
<div class="p">Each user action has:
<ul>
<li>A unique name. </li>
<li>A command (that might have substitution variables). The user
action may also
specify how the command is to be run on the server.</li>
<li>Substitution variables that are replaced with information from
the resource (such as its name) when
the command is run.</li>
<li>An optional comment used to describe the action in more detail.</li>
<li>Various options to affect what happens when the command is run;
for example,
whether to prompt first.</li>
<li>One or more file types that limit the action to specific types of
remote resources. For example, a command to start&nbsp; a program that
searches text files could be limited to just text files. The action is
only shown
for remote objects which is one of the specified types.</li>
</ul>
</div>
</div>
<div>
<p><b class="reltaskshd">Related tasks</b><br/>
<a href="../tasks/tworkuseract.html" title="">Managing user actions
(user options)</a><br/>
</p>
</div>
</body>
</html>

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 942 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 226 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 10 KiB

View file

@ -0,0 +1,22 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<LINK REL="STYLESHEET" HREF="book.css" CHARSET="ISO-8859-1" TYPE="text/css">
<title>Legal Notices</title>
</head>
<body>
<h3>
<a NAME="Notices"></a>Notices</h3>
<p>
The material in this guide is Copyright (c) IBM Corporation and others 2000, 2006.
</p>
<p>
<a href="about.html">Terms and conditions regarding the use of this guide.</a>
</p>
</body>
</html>

View file

@ -0,0 +1,18 @@
################################################################################
# Copyright (c) 2006 IBM Corporation and others. All rights reserved.
# This program and the accompanying materials are made available under the terms
# of the Eclipse Public License v1.0 which accompanies this distribution, and is
# available at http://www.eclipse.org/legal/epl-v10.html
#
# Initial Contributors:
# The following IBM employees contributed to the Remote System Explorer
# component that contains this file: David McKnight, Kushal Munir,
# Michael Berger, David Dykstal, Phil Coulthard, Don Yantzi, Eric Simpson,
# Emily Bruner, Mazen Faraj, Adrian Storisteanu, Li Ding, and Kent Hawley.
#
# Contributors:
# {Name} (company) - description of contribution.
################################################################################
plugin.name = RSE User Guide
provider.name = Eclipse.org

View file

@ -0,0 +1,22 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2006 IBM Corporation and others. All rights reserved.
This program and the accompanying materials are made available under the terms
of the Eclipse Public License v1.0 which accompanies this distribution, and is
available at http://www.eclipse.org/legal/epl-v10.html
Initial Contributors:
The following IBM employees contributed to the Remote System Explorer
component that contains this file: David McKnight, Kushal Munir,
Michael Berger, David Dykstal, Phil Coulthard, Don Yantzi, Eric Simpson,
Emily Bruner, Mazen Faraj, Adrian Storisteanu, Li Ding, and Kent Hawley.
Contributors:
{Name} (company) - description of contribution.
-->
<plugin>
<extension point="org.eclipse.help.toc">
<toc file="toc.xml" primary="true" />
</extension>
</plugin>

View file

@ -0,0 +1,79 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Accessing Remote System Explorer preferences</title>
</head>
<body id="rrsepref">
<a name="rrsepref"><!-- --></a>
<h1 class="topictitle1">Accessing Remote System Explorer preferences</h1>
<div>
<div class="p">
<p class="sectiontitle">Purpose</p>
The Remote System Explorer has settings that
you can customize in a preference page. The name of the category is
Remote Systems and it appears
in the tree view of the Preferences window. </div>
<div class="p">
<div class="skipspace">
<table cellpadding="4" cellspacing="0" summary="" frame="border"
border="1" rules="all">
<tbody>
<tr>
<td valign="top"><b>Option</b></td>
<td valign="top"><b>Description</b></td>
<td valign="top"><b>Default</b></td>
</tr>
<tr>
<td valign="top">Default System Type</td>
<td valign="top">Defines the default system type that will be used when creating a new connection.</td>
<td valign="top">none<br/></td>
</tr>
<tr>
<td valign="top">Default user ID for each system type</td>
<td valign="top">Specifies a default user ID for a non-local system type.
If you do not set the default user ID at the connection level, then the User
ID that you specify here will be used. Note: Changing the user ID on the
Preferences dialog affects all connections and subsystems that inherit it.</td>
<td valign="top">Off</td>
</tr>
<tr>
<td valign="top">Show connection names prefixed by profile name</td>
<td valign="top">Select this to display connection names in the
Remote System Explorer tree view as profile.connection.</td>
<td valign="top">Off</td>
</tr>
<tr>
<td valign="top">Show filter pools in Remote Systems view</td>
<td valign="top">Select this to show filter pools when expanding a subsystem.
When this is not selected, expanding a subsystem will display the filters.</td>
<td valign="top">Off</td>
</tr>
<tr>
<td valign="top">Show "New Connection" prompt in Remote Systems view</td>
<td valign="top">The <img src="../images/newconnection_wiz.gif" alt=""/> New
Connection option is displayed in the Remote Systems view so that you can
create a new connection.</td>
<td valign="top">On</td>
</tr>
<tr>
<td valign="top">Re-open Remote Systems view to previous state</td>
<td valign="top">Select this to automatically open previously expanded
connections on start-up.</td>
<td valign="top">On</td>
</tr>
<tr>
<td valign="top">Cascade user actions by profile</td>
<td valign="top">The <span><b>Work With</b> &gt; <b>User Actions</b></span> menu will cascade according to active profile.</td>
<td valign="top">Off</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
</body>
</html>

View file

@ -0,0 +1,86 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css" />
<title>Using search parameters with special characters</title>
</head>
<body id="rtablesub"><a name="rtablesub"><!-- --></a>
<h1 class="topictitle1">Using search parameters with special characters</h1>
<div>
<div class="p">You can use special characters such as ?, *, and \, when searching
for files and strings, based on the following rules.
</div>
<div class="p">
<div class="skipspace">
<table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all">
<tbody>
<tr>
<td valign="top"><b>Option</b></td>
<td valign="top"><b>Description</b></td>
</tr>
<tr>
<td valign="top">*</td>
<td valign="top">Searches all items. </td>
</tr>
<tr>
<td valign="top">abc*</td>
<td valign="top">Searches for items that begin with the characters abc,
for example, abcd or abctest.</td>
</tr>
<tr>
<td valign="top">*abc</td>
<td valign="top">Searches for items ending with the characters abc, for example, dabc or testabc.</td>
</tr>
<tr>
<td valign="top">*b*</td>
<td valign="top">Searches for items that have the character b anywhere in the name.</td>
</tr>
<tr>
<td valign="top">a*c</td>
<td valign="top">Searches for items that begin with the character a and end with the character c.</td>
</tr>
<tr>
<td valign="top">"a*"</td>
<td valign="top">Searches for items within quotation marks that start
with the character a, for example, "a," "ab," or "ad." Note that when you
use quotation marks, the specification becomes case sensitive.</td>
</tr>
<tr>
<td valign="top">abc?</td>
<td valign="top">Searches for four-character items that begin with the
characters abc and have a single fourth character, for example, abcd.</td>
</tr>
<tr>
<td valign="top">?abc</td><td valign="top">Searches for four-character items that begin with a
single character and end in abc, for example, dabc.</td>
</tr>
<tr>
<td valign="top">?b?</td>
<td valign="top">Searches for three-character items that have a b in the middle, for example, abc.</td>
</tr>
<tr>
<td valign="top">a?c</td>
<td valign="top">Searches for three-character items that have the character a and c with a single character in between.</td>
</tr>
<tr>
<td valign="top">ab?</td>
<td valign="top">Searches for three-character items that start with ab and end in a third single character, for example, abc.</td>
</tr>
<tr>
<td valign="top">a\* or a\?</td>
<td valign="top">Searches for characters where the * and ? are interpreted
literally, for example, a* or a?. The slash represents an escape character.
To use a slash literally, enter \\.</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
</body>
</html>

View file

@ -0,0 +1,182 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css" />
<title>Managing archived files</title>
</head>
<body id="tarchive"><a name="tarchive"><!-- --></a>
<h1 class="topictitle1">Managing archived files</h1>
<div class="p">
<p>You can work with archived files and folders in the Remote System Explorer.</p>
<p>Use the Remote Systems view perform the following actions with archived files:
<ul>
<li><a href="#tarchive__browse">Browse files in an archive</a></li>
<li><a href="#tarchive__copy">Copy, paste, and move archives</a></li>
<li><a href="#tarchive__drag">Drag and drop files between archives</a></li>
<li><a href="#tarchive__create">Create files and folders within an archive</a></li>
<li><a href="#tarchive__delete">Delete archives</a></li>
<li><a href="#tarchive__extract">Extract files from an archive</a></li>
<li><a href="#tarchive__add">Add files to an archive</a></li>
<li><a href="#tarchive__search">Search for content within an archive</a></li>
<li><a href="#tarchive__convert">Convert archives of a different types into one type</a></li>
</ul>
</p>
</div>
<div class="p">
<p>Pick from the following:
<table border="1" frame="hsides" rules="rows" cellpadding="4" cellspacing="0" summary="" class="skipspace">
<tbody>
<tr>
<th align="left" valign="bottom" id="d0e45">Task</th>
<th align="left" valign="bottom" id="d0e47">Description</th>
</tr>
<tr id="tarchive__browse">
<td align="left" valign="top" id="d0e50" headers="d0e45"><b>Browsing:</b></td>
<td align="left" valign="top" headers="d0e47 d0e50">To browse and open
files in an archive, click the plus sign beside the archive to display the
contents. Continue to expand folders within the archive or double-click any
file to open it in the default editor. Save files as you normally would and
they are saved in the archive. In the properties view, note the addition of
"#archive#" to the path of the file, to indicate how the file exists inside
the archive.</td>
</tr>
<tr id="tarchive__copy">
<td align="left" valign="top" id="d0e55" headers="d0e45"><b>Copying and pasting:</b></td>
<td align="left" valign="top" headers="d0e47 d0e55">To copy
and paste files, or move them from one location to another, right-click a
file or folder inside an archive and select <b>Copy</b> or <b>Move</b>. (When
you select <b>Move</b> instead of <b>Copy</b>, you delete the file in the
original location, to move it to a new one.) Using the window that opens,
you can paste the item to any archived, or unarchived location by expanding
the tree-view to any specific location, and clicking <b>OK</b>. Note that
you can perform this action across different connections as well.</td>
</tr>
<tr id="tarchive__drag">
<td align="left" valign="top" id="d0e75" headers="d0e45"><b>Dragging and dropping:</b></td>
<td align="left" valign="top" headers="d0e47 d0e75">You can
drag and drop files between archives, from an archive to an unarchived location,
or from an unarchived location into an archive. Expand both the original and
destination locations in the Remote Systems view, click the item you want
to move, and drag it with your cursor to the new location. Note that you can
perform this action across different connections as well.</td>
</tr>
<tr id="tarchive__create">
<td align="left" valign="top" id="d0e80" headers="d0e45"><b>Creating:</b></td>
<td align="left" valign="top" headers="d0e47 d0e80">To create files and
folders inside an archive, or to create a new archive, right-click any folder
in the archive, or the root level archive itself, and select:
<ul>
<li><b>New &gt; File</b> to create a normal file within the archive. You can
also select the file type to be an archive, whereby you can create an archive
inside of an archive.</li>
<li><b>New &gt; Folder</b> to create a normal folder within the archive. Then
right-click your virtual folder to create more folders or files.</li>
</ul>
</td>
</tr>
<tr id="tarchive__delete">
<td align="left" valign="top" id="d0e94" headers="d0e45"><b>Deleting:</b></td>
<td align="left" valign="top" headers="d0e47 d0e94">To delete a file
or folder from inside an archive, simply right-click the item and select <b>Delete</b>,
or hit the Delete key. </td>
</tr>
<tr id="tarchive__extract">
<td align="left" valign="top" id="d0e102" headers="d0e45"><b>Extracting:</b></td>
<td align="left" valign="top" headers="d0e47 d0e102">You have two options
when extracting files. You can either extract to a new folder within your
current directory (by selecting <a href="#tarchive__extract1"><b>Extract
to <i>xyz</i></b></a> where <i>xyz</i> is your current directory) or browse
to a specific extraction directory (by selecting <a href="#tarchive__extract2"><b>Extract
To . . .</b></a>). You can also select multiple archives and perform the
same actions.
<ul>
<li id="tarchive__extract1"><a name="tarchive__extract1"><!-- --></a>
To extract the contents of an archive to a new folder within
your current directory, right-click your archive and select <b>Extract to <i>xyz</i></b> where <i>xyz</i> is
the name of your current directory. If your archive was named "MyArchive.zip"
then the extraction will create a new folder within your current directory
called "MyArchive" and all of the files will be placed in the new folder in
their proper structure. Click <b>OK</b>. If you want, use the right-click
menu to rename the new folder.</li>
<li id="tarchive__extract2"><a name="tarchive__extract2"><!-- --></a>
To extract the contents of an archive to a location other
than the current directory, right-click your archive and select <b>Extract
To</b>.
<ol>
<li>A dialog box displays, presenting a tree view of all drives, files, and
folders defined in the Remote Systems view. Expand any location in the tree
view to define the directory location where you want to extract the contents
of your archive. </li>
<li>(Optional) You can select a directory, and press the <b>Details</b> button
to see a list of properties for that location. </li>
<li>(Optional) You can expand <b>New Connection</b> to define a new connection
to a location where you want to extract the files.</li>
<li>(Optional) When you extract the contents of an archive to a destination
directory, the files and directories in the archive are copied directly to
that destination. You are prompted to overwrite or rename duplicate files
in the target directory.</li>
<li>Click <b>OK</b>.</li>
</ol>
</li>
</ul>
</td></tr><tr id="tarchive__add"><td align="left" valign="top" id="d0e159" headers="d0e45">
<b>Adding files to an archive:</b></td>
<td align="left" valign="top" headers="d0e47 d0e159">To
add files and folder to an archive, select one or more files/folders, right-click,
and select <b>Add to Archive</b>.
<ol>
<li>A dialog box displays, presenting a tree view of all drives, files, and
folders defined in the Remote Systems view.</li>
<li>To create a new archive for the selected files and folders
<ol type="a">
<li>Expand any location in the tree view to define the location for the new
archive.</li>
<li>Specify a name for the archive in the <b>File name</b> field.</li>
<li>Specify an <b>Archive type</b> from the drop-down list.</li>
</ol>
To add files and folders to an <i>existing</i> archive:
<ol type="a">
<li>Select the existing archive's parent folder in the tree view.</li>
<li>Specify a name for the archive in the <b>File name</b> field.</li>
<li>Specify an <b>Archive type</b> from the drop-down list.</li>
</ol>
</li>
<li>Click <b>OK</b>.</li>
</ol>
The selected files/folders are copied to the root directory in the new
archive location</td>
</tr>
<tr id="tarchive__search">
<td align="left" valign="top" id="d0e208" headers="d0e45">
<b>Searching for content inside an archive:</b></td>
<td align="left" valign="top" headers="d0e47 d0e208">
To search for files within an archive, right-click the archive, select <b>Search</b>,
and complete the dialog box to specify what kinds of files and folder you
want to find. Note that if you begin your search on a normal, unarchived directory
that contains an archive, the default behaviour is <i>not</i> to search the
archive. You need to explicitly start from the archive itself to search for
contents within that archive.</td>
</tr>
<tr id="tarchive__convert">
<td align="left" valign="top" id="d0e219" headers="d0e45">
<b>Converting archives:</b></td>
<td align="left" valign="top" headers="d0e47 d0e219">To convert
archives from one type (.zip, .jar, or .tar) to another, select one or more
archives, right-click, and select <b>Convert</b>. A Convert Archive dialog
box opens for each archive you selected. In the dialog box, select a new archive
type from the <b>Archive Type</b> drop-down list to convert the selected archive.
You can also, optionally, specify a new location and new name for your archive,
by selecting a location in the tree view and entering a new name in the <b>File
name</b> field. Click <b>OK</b>.</td>
</tr>
</tbody>
</table>
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,33 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Deleting a connection</title>
</head>
<body id="tbegindelete">
<a name="tbegindelete"><!-- --></a>
<h1 class="topictitle1">Deleting a connection</h1>
<div>
<div class="p">Deleting a connection to a remote server does not delete
any elements
on the server. The action deletes your specific configuration for that
connection,
including your filters, filter pools, user actions, compile actions,
saved
commands, and named types.
<p>To delete a connection, in the Remote Systems
view, right-click your connection and select <b>Delete</b>.</p>
</div>
</div>
<div>
<p><b class="reltaskshd">Related tasks</b><br/>
<a href="tbegindiscon.html" title="">Disconnecting from a remote server</a><br/>
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,33 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Deleting a profile</title>
</head>
<body id="tbegindelete">
<a name="tbegindelete"></a>
<h1 class="topictitle1">Deleting a profile</h1>
<div>
<div class="p">Deleting a profile does not delete any elements on the
server. The
action only deletes your specific configuration (connections, filters,
and
user actions) for that profile. To delete a profile:</div>
<ol>
<li><span>Click the Menu button <img src="../images/gsarrow.gif" alt=""/> on the toolbar for the Remote Systems view.</span></li>
<li><span>Select <b>Delete Profile &gt; <i>name of profile</i></b>.</span></li>
<li><span>Click <b>Yes</b>.</span></li>
</ol>
</div>
<div>
<p><b class="reltaskshd">Related tasks</b><br/>
<a href="tbeginsecprofile.html" title="">Creating a second profile</a><br/>
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,60 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Disconnecting from a remote server</title>
</head>
<body id="tbegindiscon">
<a name="tbegindiscon"></a>
<h1 class="topictitle1">Disconnecting from a remote server</h1>
<div>
<div class="p">To disconnect from a remote server in the Remote Systems
view, right-click one of the subsystems displayed under your connection
name
and select <b>Disconnect</b>, or close the workbench.
</div>
<div class="p">
<p>If you choose to close the workbench in order to disconnect, it
notifies you of any outstanding communications requests. However, any
tools
launched from the workbench that run externally from the Remote System
Explorer
communications server, such as an external remote editor, are not
affected because they
have their own communication connection.</p>
<p>You can monitor and change
the properties of your connection in the Properties view of the Remote
System
Explorer perspective. Some values are read-only, and you can change
others,
such as the description or the server name. Although each Remote System
Explorer
subsystem maintains its own list of properties, three properties
(connected
or disconnected, port, and user ID) are shared among all subsystems. If
you
change any of these properties in one subsystem, the other subsystems
reflect
the change.</p>
<p>Select a subsystem and check the Properties view to see
the shared properties for all of your subsystems. For example, the
Connected
value is Yes or No for all of your subsystems under one connection. If
you
have difficulties connecting and disconnecting from the server, see the
related link for troubleshooting information.</p>
</div>
</div>
<div>
<p><b class="reltaskshd">Related tasks</b><br/>
<a href="tbegindelete.html" title="">Deleting a connection</a><br/>
<br/>
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,67 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Configuring environment variable support for connections</title>
</head>
<body id="tbeginenv">
<a name="tbeginenv"></a>
<h1 class="topictitle1">Configuring environment variable support for connections</h1>
<div>
<p>Environment variables are set for the remote job process
when you first connect to a remote system. This means that the results
of setting the variables are shown in the Commands view.
If the system type you are using is case sensitive (UNIX for example),
then the environment variables will also be case sensitive. Spaces and
equals signs (=) are only allowed in the value for the environment
variable, not in
its name.</p>
<p>You can define environment variables for all Remote System Explorer
connection types that support them (Windows, Linux, UNIX, and other
system types that are installed).</p>
<p>If you change an environment variable while the Remote System
Explorer is connected to a
remote server, the change does not take affect until you disconnect and
reconnect.</p>
<p>Although environment variables are set in subsystem properties
pages, the Remote System Explorer stores
them globally by connection.</p>
<p>If you need to specify different environment variables or user IDs
for a particular remote system, you can do so by defining multiple
connections to that
remote system and then defining the environment variables on the file
subsystem for each
connection.</p>
<p>To configure environment variables:
</p>
<ol>
<li><span>Create a connection to a server if necessary.</span></li>
<li><span>Expand your connection name in the Remote Systems view.</span></li>
<li><span>Right-click on a file subsystem and select <b>Properties</b>.</span></li>
<li><span>Click <b>Environment Variables</b> and configure the variables as needed.</span>
<ul>
<li>To add an environment variable, click <b>Add</b>. Enter a
name and value for this variable, and click<b>OK</b>.</li>
<li>To change an environment variable, select the variable in the
table and modify the name or value directly. To use a dialog box,
select the variable and click <b>Change</b>. The name and value of the
current variable
are pre-filled in the dialog box. Overwrite whichever field you want to
change and click <b>OK</b>.</li>
<li>To remove a variable, click the variable to select it and
click <b>Remove</b>.</li>
<li>To move a variable up in the list, click the variable to
select it and click <b>Move up</b>.</li>
<li>To move a variable down in the list, click the variable to
select it and click <b>Move down</b>.</li>
</ul>
</li>
</ol>
</div>
</body>
</html>

View file

@ -0,0 +1,165 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Connecting to a remote Linux or UNIX server</title>
</head>
<body id="tbeginlinux">
<a name="tbeginlinux"><!-- --></a>
<h1 class="topictitle1">Connecting to a remote Linux or UNIX server</h1>
<p>The following documentation explains how to install the Linux or UNIX server
code, start the server daemon, and make a connection to a remote Linux
or UNIX server.</p>
<div>
<div class="p">
<p><b>Prerequisites</b></p>
<p>To use the Remote System Explorer communications server daemon you need
to install Perl. Using the daemon helps eliminate some of the manual steps
when you connect to the server.Also note that Java Development Kit (JDK)
version 1.4 or higher is required.</p>
<p><b>Installing the server code</b></p>
<div class="p">
<ol>
<li>Ensure that Perl is installed.</li>
<li>Ensure that JDK version 1.4 or higher is installed.</li>
<li>Create a directory where you want to install the server code. The remainder
of these instructions will assume the directory /opt/rseserver (suitable for
team sharing), but you are free to use any directory.</li>
<li>Find the <i>x:\product directory</i>\eclipse\plugins\com.ibm.etools.systems.universal_<i>version_number</i>\serverruntime\rseserver.jar
file on your local workstation, where <i>x:\product directory</i> is the directory
where you installed the product, for example, c:\WSWB.</li>
<li>FTP the file rseserver.jar to the /opt/rseserver directory.</li>
<li>Switch to the /opt/rseserver directory by typing:
<pre>cd /opt/rseserver</pre>
</li>
<li>Run the following command in the /opt/rseserver directory to extract the
server code:<pre>jar -xf rseserver.jar</pre>
<b><span class="attentiontitle">Attention</span></b><span class="attentiontitle">: </span>The
jar command is shipped with the JDK and might not be in your path. If you
receive a "command not found" error when running the jar command then try
to qualify the jar command with the installation directory for the JDK. For
example: <samp class="codeph">/opt/IBMJava2-131/bin/jar -xf rseserver.jar</samp>
<br>
</br>
</li>
<li>Still in the /opt/rseserver directory, run the following configuration
commands:<pre>dos2unix daemon.linux
dos2unix server.linux
chmod 755 server.linux
chmod 755 daemon.linux
chmod 755 auth.pl</pre>
</li>
</ol>
</div>
<p><b>Starting the server</b></p>
<div class="p">You can start the RSE communications
server with the server daemon, or manually. Before starting the server, make
sure the Java command is in your path, you can do this by running the following
command:<pre>java -version</pre>
</div>
<div class="p">You should see something
similar to the following:<pre>java version "1.4.1"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.1)
Classic VM (build 1.4.1, J2RE 1.4.1 IBM build cxppc321411-20040301 (JIT enabled: jitc))</pre>
</div>
<div class="p">If
you receive a "command not found" error, then try creating a symbolic link
to the java command in /usr/bin by running the following command:<pre>ln -s /opt/IBMJava2-131/jre/bin/java /usr/bin/java</pre>
</div>
<div class="p"><b>To start the server with the server daemon</b>
<ol>
<li>Ensure that you are running using the root user ID. (If the daemon is
not run under root, it will be unable to authenticate connecting users.) Run
the following commands:<pre>su -l root
cd /opt/rseserver
perl ./daemon.linux</pre>
</li>
</ol>
Note that the server daemon runs on port 4035. You can also start the
daemon.unix in the same way.<br></br>
<p><b>To start the Linux server manually</b></p>
<div class="p">Run
the following commands:<pre>cd /opt/rseserver
perl ./server.linux [port]</pre>
These commands run the server.linux
script located in the /opt/rseserver directory. If this does not work, try
changing the permission attributes on server.linux (for example, enter <samp class="codeph">chmod
755 server.linux</samp>. The port parameter to the server.linux script is
optional. If you do not specify a port, then the server will pick the first
one available and print the port number to standard out. By default, it is
usually 4033. If you would like to use a different port, you will then have
to enter this port number in port property for the Files subsystem for your
connection in the Remote System Explorer (see <span class="uicontrol">Connecting to the
Remote Server</span>, below). Otherwise, you do not need to change this
property.</div>
<p><b>To start the UNIX server manually</b></p>
<div class="p">To run the unix.server
script, enter the following commands:<pre>cd /opt/rseserver
perl ./server.unix [port]</pre>
These commands run the server.linux
script located in the /opt/rseserver directory. If this does not work, try
changing the permission attributes on server.unix (for example, enter <samp class="codeph">chmod
755 server.unix</samp>. The port parameter to the server.unix script is
optional. If you do not specify a port, then the server will pick the first
one available and print the port number to standard out. By default, it is
usually 4033. If you would like to use a different port, you will then have
to enter this port number in port property for the Files subsystem for your
connection in the Remote System Explorer (see <span class="uicontrol">Connecting to the
Remote Server</span>, below). Otherwise, you do not need to change this
property.</div>
<p><b>Running the daemon at startup</b></p>
<div class="p">You might instead want
to configure the daemon to run at start up for Linux. To do so, you need to
append a call to the daemon to your startup script. Add the following lines
to the bottom of the /etc/rc.d/rc.local file:<pre>cd /opt/rseserver
perl ./daemon.linux &amp;</pre>
You can also add <samp class="codeph">perl ./daemon.unix</samp> if
you want to run the UNIX daemon at startup.</div>
</div>
</div><br></br>
<p><b>Connecting to the Remote Server</b></p>
<div class="p">To make a connection
to your remote server:</div>
<ol>
<li><span>Switch to the Remote System Explorer perspective. From the workbench
menu, click <span class="menucascade"><span class="uicontrol">Window </span> &gt; <span class="uicontrol">Open Perspective </span> &gt; <span class="uicontrol">Remote System Explorer</span></span>.</span></li>
<li><span>In the Remote Systems view, <b>New Connection</b> is automatically
expanded to show the various remote systems you can connect to through the
Remote System Explorer. Expand <b>Linux</b> or <b>Unix</b> to
invoke the new connection dialog box and configure a connection.</span></li>
<li><span>Enter a name for your first profile and click <b>Next</b>. (This
step only occurs if you have never defined a connection before.)</span></li>
<li><span>Enter a connection name. This name displays in your tree view and
must be unique to the profile.</span></li>
<li><span>Enter the name or TCP/IP address of your Linux server in the <b>Host
name</b> field, for example, LINUX_A.</span></li>
<li><span>(Optional) Enter a <b>Description</b>. The description appears
in the Properties view after the connection is created.</span></li>
<li><span>Click <b>Finish</b> to define your system. </span></li>
</ol>
<div class="skipspace">
<div class="attention"><span class="attentiontitle">Attention: </span>To check your port number, right-click your
connection or subsystem from the Remote Systems view and select <b>Properties</b>.
Click <b>Subsystem</b> to view the relevant information. If your port is "0,"
then your Remote System Explorer communications server will pick any free
port on the server. If you specified a port number when starting the server,
you need to enter it here, for example, to work with a firewall.</div>
</div>
<div class="p">
<div class="note"></div>
</div>
</div>
<div>
<p><b class="reltaskshd">Related tasks</b>
<a href="tbeginwindows.html" title="">Connecting to a remote Windows
server</a>
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,52 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Saving passwords on your local PC</title>
</head>
<body>
<h1>Saving passwords for remote systems</h1>
<p>When you use the Remote System Explorer,
you can save passwords for remote systems
on your local PC. The stored passwords are
then retrieved whenever a password is required
to connect. When you save your password for
a particular remote system, you will not
be prompted to sign on when you try to connect
to that system. </p>
<p>When you first try to connect to a remote
system, you will be prompted with the following
dialog:</p>
<img src="../images/pw.jpg"></img>
<p>To save this password on your local PC:</p>
<ol>
<li>Enter your user ID</li>
<li>Enter your password</li>
<li>Select <b>Save user ID</b></li>
<li>Select <b>Save password</b></li>
</ol>
<p>The next time that you connect to the remote
system, you will not be prompted to sign
on again.</p>
<p><b>Note</b>: If you still want to be prompted for your
user ID and password, right-click on the
subsystem and select <b>Connect</b>. </p>
<h2>Adding, changing, and removing stored passwords</h2>
<p>You can use the password information page
to add, change, and remove stored passwords
for remote systems:</p>
<ol>
<li>Select <b>Window</b> -&gt; <b>Preferences</b></li>
<li>Expand <b>Remote Systems</b></li>
<li>Select <b>Passwords</b></li>
</ol>
<p>Use the Add, Change, and Remove buttons to
manage your password information for remote
systems. </p>
</body>
</html>

View file

@ -0,0 +1,36 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css" />
<title>Creating a second connection to a remote server</title>
</head>
<body id="tbeginsecond"><a name="tbeginsecond"></a>
<h1 class="topictitle1">Creating a second connection to a remote server</h1>
<div class="p">
<p>In the Remote System Explorer, you can create a second connection
to the same, or a different type of server, such as Linux, UNIX, or Windows.
You can also create a second connection to the same server with a separate job
environment, for example, to specify different environment variables or different user IDs.</p>
To create a second connection:
</div>
<div>
<ol>
<li><span>In the Remote Systems view, expand <b>New Connection</b>.</span></li>
<li><span>Click the plus sign beside the type of server you to which you want to make a second connection. For example, Linux, UNIX, or Windows.</span></li>
<li><span>Complete the dialog as you normally would, making sure that you give your new connection a unique name.</span></li>
</ol>
</div>
<div>
<p><b class="reltaskshd">Related tasks</b><br />
<a href="tbeginenv.html" title="">Configuring environment variable support for connections</a><br/>
<a href="tbeginwindows.html" title="">Connecting to a remote Windows server</a><br/>
<a href="tbeginlinux.html" title="">Connecting to a remote Linux or UNIX server</a><br/>
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,27 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Creating a second profile</title>
</head>
<body id="tbeginsecprofile">
<a name="tbeginsecprofile"></a>
<h1 class="topictitle1">Creating a second profile</h1>
<p>You might want to create a second profile for connections and data that belong to a particular version of a software release, and are
shared by all team members.</p>
<p>To create a second profile:
<ol>
<li>Click the Menu button <img src="../images/gsarrow.gif" alt=""/> on the toolbar for the Remote Systems view and select <b>New profile</b>.</li>
<li>Specify a name for the new profile and click <b>Finish</b>.</li>
</ol>
</p>
<p><b class="reltaskshd">Related tasks</b><br/>
<a href="tbegindeleteprofile.html" title="">Deleting a profile</a><br/>
</p>
</body>
</html>

View file

@ -0,0 +1,110 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Connecting to a remote Windows server</title>
</head>
<body id="tbeginlinux">
<a name="tbeginlinux"></a>
<h1 class="topictitle1">Connecting to a remote Windows server</h1>
<div>
<div class="p">
<p><b>Installing the server code:</b></p>
<div class="p">
<ol>
<li>Create a directory where you want to install the server code. The
remainder of these instructions will assume the directory name and location is
C:\rseserver, but you are free to use any directory you choose. </li>
<li>Find the <span style="font-style: italic;">x</span>\eclipse\plugins\com.ibm.etools.systems.universal_<i>version_number</i>\serverruntime\rseserver.jar
file on your local workstation, where <i>x</i> is the directory where you
installed the product.</li>
<li>Copy the rseserver.jar to the C:\rseserver directory (this can be
on a different machine).</li>
<li>Open a command prompt, and run the following command in the
C:\rseserver directory to extract the server code:
<pre>jar xf rseserver.jar</pre>
<div class="note">If
you receive an error, ensure that you have an entry for the /bin JDK
directory in your Path environment variable. JDK version 1.4 is required.</div>
</li>
</ol>
</div>
<p><b>Starting the server:</b></p>
<p>You can start the RSE communications
server with the server manually, or with a daemon.</p>
<div class="p">To start the server
manually:
<ol>
<li>First, you need to configure your CLASSPATH and then start the
communications server. In a command prompt, enter:
<pre>
c:<br/>
cd:\rseserver<br/>
win.env.bat<br/>
run.win.bat [port]
</pre>
The port parameter to the run.win.bat program is optional. If
you do not specify a port, the server will pick the first port
available and print the port number to standard out. By default, it is usually 4033.
You will then have to enter this port number in the port property for the
Files subsystem for your connection in the Remote System Explorer (see
Connecting below).
</li>
</ol>
</div>
<div class="p">To start the server with a the server daemon:
<ol>
<li>First, you need to configure your CLASSPATH and then start the
server daemon. In a command prompt, enter:
<pre>
c:<br/>
cd:\rseserver<br/>
win.env.bat<br/>
daemon.win.bat
</pre>
Note that the server daemon <b>does not</b> enforce any user
authentication. If you run the server daemon, any user can connect to the machine, work
with the file system and run commands. <span style="font-weight: bold;">Use
of the server daemon on Windows systems is not recommended</span>.</li>
</ol>
</div>
</div>
<div class="p">To connect to a remote Windows server:</div>
<ol>
<li><span>Switch to the Remote System Explorer perspective.</span></li>
<li><span>In the Remote Systems view, <b>New Connection</b> is
automatically be expanded to show the various remote systems you can connect to
through the Remote System Explorer. Expand <b>Windows</b> to invoke a dialog
and configure a connection.</span></li>
<li><span>Enter a name for your first profile and click <b>Next</b>.
(This step only occurs if you have never defined a connection before.)</span></li>
<li><span>Enter a connection name. This name displays in your tree
view and must be unique to the profile.</span></li>
<li><span>Enter the name or TCP/IP address of your Windows server in
the <b>Host Name</b> field, for example, jsandler.</span></li>
<li><span>Enter a <b>Description</b>(optional); the description
appears in the Properties view after the connection is created.</span></li>
<li><span>Click <b>Finish</b> to define your system. </span></li>
</ol>
<div class="p">
<div class="note"><span class="notetitle">Note: </span>To check your
port number, right-click your connection or subsystem
from the Remote Systems view and select <b>Properties</b>. Click <b>Subsystem</b>
to see the relevant information. If your port is "0," then your Remote
System Explorer communications server will pick any free port on the Windows
server. If you specified a port number when starting the server, you need to
enter it here, for example, to work with a firewall.</div>
</div>
</div>
<div>
<p><b class="reltaskshd">Related tasks</b><br/>
<a href="tbeginlinux.html" title="">Connecting to a remote Linux or UNIX server</a><br/>
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,40 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css" />
<title>Exporting resources to a remote file system</title>
</head>
<body id="tremoexp"><a name="tremoexp"><!-- --></a>
<h1 class="topictitle1">Building programs on a remote system</h1>
<div>
<p>A configuration in the External Tools dialog lets you build programs on remote systems.</p>
<div class="p">To build programs on a remote system:</div>
<ol>
<li><span>Select <span><b>Run</b> &gt; <b>External Tools</b> &gt; <b>External Tools</b></span> from the workbench menu bar. The External Tools dialog opens.</span></li>
<li><span>Right click on <b>Remote Build</b> and select <b>New</b>. A remote build configuration is created.</span></li>
<li><span>Choose the connection for the remote system or create a new one.</span></li>
<li><span>Type the build command or browse the file system to find the build command</span></li>
<li><span>Type or select the working directory. This is the directory where the command will be run.</span></li>
<li><span>Enter the arguments to the build command.</span></li>
<li><strong>Optional: </strong><span>Select the checkbox to specify that there is an associated project with this
build command. If the command operates on a set of remote files (for example, a command such as 'make'), the Remote System
Explorer will interpret any errors or other messages and allow you to double click on them to open the source.
Specifying this option means the Remote System Explorer will open the source from a local project (that is, it will
not open the remote source). This is useful if you are developing a program from a local project.</span></li>
<li><strong>Optional: </strong><span>Select the checkbox to specify that local files should be exported before the
build command is executed. This is useful if you are developing your remote application from a local project. In such
cases, you would export the files from the workspace to the remote system using the <b>Remote file system</b> export wizard.
That wizard lets you save the settings of the export to a file. The settings file contains information about which
files were exported and various export options. You can specify this settings file here. This configuration will use
the settings file to do the export and when the export is completed it will execute the build command. This ensures
that the local source you are working on is always sent to the remote system before the build takes place.</span></li>
<li><span>Click on <b>Apply</b> to save the configuration. Click on <b>Run</b> to execute it.</span></li>
</ol>
</div>
</body>
</html>

View file

@ -0,0 +1,34 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css" />
<title>Editing an existing type</title>
</head>
<body id="tedittype"><a name="tedittype"><!-- --></a>
<h1 class="topictitle1">Editing an existing type</h1>
<div>
<div class="p">To edit an existing type: </div>
<ol>
<li><span>In the Remote Systems view, right-click on a file subsystem, and select <span><b>Work With </b> &gt; <b>Named
Types</b></span>.</span></li>
<li><span>On the Work With Named Types window, expand <b>Object </b> or <b>Member</b>.</span></li>
<li><span>Select your defined type from the list. You cannot edit any IBM-supplied types.</span></li>
<li><span>Make the required changes.</span></li>
<li><span>Click <b>Apply</b>.</span></li>
</ol>
</div>
<div>
<p><b class="relconceptshd">Related concepts</b><br />
<a href="../concepts/cuseractions.html" title="">User actions (user options)</a><br />
</p>
<p><b class="reltaskshd">Related tasks</b><br />
<a href="tremtype.html" title="">Removing an existing type</a><br />
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,29 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2003, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Deleting filters in the Remote Systems view</title>
</head>
<body>
<a name="tmanagedel"></a>
<h1 class="topictitle1">Deleting filters</h1>
<div>
<div class="p">Deleting a filter does not delete any elements that you
managed with
that filter. The action only deletes your specific configuration for
that
filter. To delete a filter:</div>
<ol>
<li><span>In the Remote Systems view, expand your connection, and
then expand <b>Files</b>. </span></li>
<li><span>Right-click your filer and select <b>Delete</b>.</span>
</li>
</ol>
</div>
</body>
</html>

View file

@ -0,0 +1,42 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2003, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Changing filters</title>
</head>
<body>
<a name="tmanageedit"></a>
<h1 class="topictitle1">Changing filters</h1>
<div>
<div class="p">You can change a filter if you want to alter
the host items that it displays in the Remote
Systems view. When you change a filter, you
can also add extra conditions to what is
filtered. For example, if you have a filter
that displays all files of type *.c, you
may also want to add an additional filter string that
will display files of type *.h also. To change
a filter:</div>
<ol>
<li><span>In the Remote Systems view, expand your connection name,
and then expand <b>Files</b> to see a list of filters.</span></li>
<li><span>Right-click the filter and select <b>Change</b>.</span></li>
<li><span>In the pop-up window, edit the conditions that are filtered
and click <b>Apply</b>.</span>
<ul>
<li>If you want to add extra conditions, as described in the
introduction to this topic, click <b>New filter string</b> and complete the dialog.
Click <b>Create</b>.</li>
</ul>
</li>
<li><span>Click <b>OK</b>.</span></li>
</ol>
<div class="p"></div>
</div>
</body>
</html>

View file

@ -0,0 +1,32 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2003, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Creating file filters</title>
</head>
<body>
<h1>Creating file filters</h1>
<p>File filters list a set of files and folders from your host in the Remote Systems view.</p>
<ol>
<li>In the Remote Systems view, expand your connection and then expand <b>Files</b>.</li>
<li>Right-click <b>Files</b>, or your filter pool, and select <b>New</b> &gt; <b>Filter</b>.</li>
<li>Browse, specify, or select from the <b>Fold</b> drop-down list the folder that contains the appropriate files and folders.</li>
<li>Enter a generic or specific file name in the <b>File name filter</b> field. The default is * (asterisk). You can, for example, enter s* to list all files that start with s.</li>
<li>(Optional) To select a specific file type, enter the type in the <b>File types</b> field, or click <b>Select</b> to select from all known file types.</li>
<li>Use the <b>Show files only</b> check box to select whether you want to list only files.</li>
<li>Click <b>Next</b>.</li>
<li>Enter a name for your filter and select the profile that you want to use. Use an individually created profile to keep your work private, or select the Team profile to share with others.</li>
<p>Note: Filters are named so that the Remote System Explorer can save them for future use.</p>
<li>Click <b>Next </b>to see more text information about the filter or click <b>Finish</b>.</li>
</ol>
Your new file filter is displayed in the Remote Systems view under Files.
<p><b>Related tasks</b><br/>
<a href="tmanageedit.html">Changing filters</a><br/>
<a href="tmanagepools.html">Configuring filter pools</a></p>
</body>
</html>

View file

@ -0,0 +1,73 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Configuring filter pools</title>
</head>
<body id="tmanagepools">
<a name="tmanagepools"></a>
<h1 class="topictitle1">Configuring filter pools</h1>
<div>
<div class="p">
<p>If you have been using the Remote System Explorer for some
time, your workspace might contain too many filters to navigate easily.
Or,
you might just want to keep groups of filters separate if, for example,
you
need to represent two distinct server environments in the Remote System
Explorer,
regardless of how many filters you have. In either case, you can group
filters
into <i>filter pools</i>. </p>
<p>All filters live in filter pools, but these remain hidden unless you choose
to manage them explicitly. If you do not manage them yourself the Remote
System Explorer manages them for you and all of your filters appear together
in all connections. When you create filter pools, however, any filter you
create within that filter pool is only present in connections that reference
that filter pool, and will not appear in any other connections. (See the
related links for more information about filter pools.)</p>
To illustrate the
use of filter pools,</div>
<ol>
<li><span>Click the menu button <img src="../images/gsarrow.gif" alt=""/> on
the toolbar for the Remote Systems view, and select <b>Show Filter
Pools</b>.</span></li>
<li><span>Expand the <span style="font-weight: bold;">Local </span>system
and the <span style="font-weight: bold;">Local Files</span> subsystem,
and you can now see your filters
listed under <b><i>Connection name</i> Filter Pool</b>.</span></li>
<li><span>Right-click <b>Local Files</b> and select <b>New &gt;
Filter Pool</b>.</span></li>
<li><span>Enter a pool name and click <b>Finish</b>. (You do not
need to
change your profile selection.) Your new filter pool displays
underneath your
connection.</span></li>
<li><span>Right-click your new filter pool and select <b>New &gt;
Filter</b><b></b>.</span></li>
<li><span>Complete the wizards as you normally would (see related
tasks).
When you are finished, you can see your new filters displayed in your
new filter pool.</span></li>
</ol>
<div class="p">If you decide not to see the filter pools anymore, click
the menu
button <img src="../images/gsarrow.gif" alt=""/> on the toolbar for the
Remote
Systems view, and select <b>Show Filter Pools</b> again to deselect
the check
mark.</div>
</div>
<div>
<p><b class="relconceptshd">Related concepts</b><br></br>
<a href="../concepts/cfilters.html" title="">Remote System Explorer
filters, filter pools, and filter pool references</a><br></br>
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,57 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css" />
<title>Configuring filter pool references</title>
</head>
<body id="tmanagepools"><a name="tmanagepools"><!-- --></a>
<h1 class="topictitle1">Configuring filter pool references</h1>
<div>
<div class="p">
<p>You can share filter pools among many connections through
the use of a <i>filter pool reference</i>. A filter pool reference is a mechanism
that displays a filter pool from one connection in any other connection, so
that when you make a change to the original filter pool, your change is reflected
your filter pool reference.</p>
<div class="p">Before
you create a filter pool reference, ensure that you have already completed
the following (see related tasks for more information):
<ul>
<li>You have defined more than one connection to the same server</li>
<li>You have defined more than one filter pool</li>
<li>You have enabled <b>Show Filter Pools</b> from the Remote Systems view toolbar</li>
</ul>
</div>
<p>To use filter pools references:</p>
<ol>
<li><span>In the Remote Systems view, expand the connection where you want
to display a filter pool that exists in another connection.</span></li>
<li><span>Right-click on a file subsystem and select <b>New &gt; Filter Pool
Reference &gt; <i>your profile</i> &gt; <i>name of pool</i></b>.</span></li>
<li><span>Look under that subsystem again and you will see the filter
pool reference.</span></li>
</ol>
<div class="p">To delete a filter pool reference, right-click it and select <b>Remove
reference</b>. You can also move your filter pools up and down with the
right-click menu.
</div>
</div>
<div>
<p>
<b class="relconceptshd">Related concepts</b><br />
<a href="../concepts/cfilters.html" title="">Remote System Explorer filters, filter pools, and filter pool references</a><br />
</p>
<p>
<b class="reltaskshd">Related tasks</b><br />
<a href="tmanagepools.html" title="">Configuring filter pools</a><br />
<a href="tbeginsecond.html" title="">Creating a second connection to a remote server</a><br />
</p>
</div>
</div>
</body>
</html>

View file

@ -0,0 +1,94 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css" />
<title>Search for text and files on remote servers</title>
</head>
<body id="tmanagesearch"><a name="tmanagesearch"><!-- --></a>
<h1 class="topictitle1">Search for text and files on remote servers</h1>
<div>
<p>You can search for text strings and files on any remote server
or file system, including Linux, UNIX, and Windows systems.</p>
<div class="p">There are three main ways you can search for files and text strings
on remote servers, depending on your goal:
<ul>
<li>Search for text strings within a file</li>
<li>Search for text strings and/or files within a folder</li>
<li>Search for text strings, files, and/or folders within a remote file system</li>
</ul>
To search for files, text strings, and folders:
<ol>
<li>In the Remote Systems view, expand your iSeries, Linux, UNIX, or Windows
connection until you reach the folder, file, or file system that you want
to search. Select the containing item by clicking on the item.</li>
<li>Right-click and select <b>Search</b>. Or, click <b>Search &gt; Remote</b> from
the workbench menu. Or, for the keyboard shortcut, enter CTRL+H. All of these
actions will invoke the Search window. </li>
<li>In the Remote Search window, click the Remote Search tab if it is not
already in focus. You can now search for text strings, files, and/or folders,
with the option to use powerful Regular Expressions, in addition normal and
variable expressions, such as a*b. See <a href="../ref/rsearch.html">Using
search parameters with special characters</a> for more information. Regular
Expressions might be most familiar to Linux and Unix users.
For more information on Regular Expressions, see
<a href="http://www.english.uga.edu/humcomp/perl/regex2a.html" target="_blank">http://www.english.uga.edu/humcomp/perl/regex2a.html.</a>
<ul>
<li>To search for strings, in the <b>Search string</b> field, enter the string
that you want to search for, whether it be from a file, a folder, or an entire
file system. Select the <b>Case sensitive</b> or <b>Regular expression</b> check
boxes if they apply. Leave this field as an asterisk (*) if you do not want
to search for strings. You can use commas to specify more than one type of
string to search for. For example, you could enter "*.c, *.java, b?a.txt,
" and so on.</li>
<li>To search for files, in the <b>File name patterns</b> field, enter the
name of the file you are looking for. Check the <b>Regular expression</b> check
box if this option applies. Leave this field as an asterisk (*) if you do
not want to search for files. You can use commas to specify more than one
type of folder to search for. You can also click <b>Browse</b> to select file
extensions to search for.</li>
</ul>
<div class="note"><span class="notetitle">Note: </span>
You cannot edit the contents of the <b>Folder</b> field; however,
you can click the <b>Browse</b> button to browse to and specify another folder.
If the <b>Folder</b> field is empty, you need to browse to a particular folder
before you can launch the search.
</div>
</li>
<li>Click <b>Search</b>.</li>
</ol>
The matching strings and/or files display in the Remote Search view.
The view updates itself as more matches are found and you can click the <b>Stop</b> button
if you want to stop the search process. The view shows the strings and/or
files that you searched for, with the matches listed beneath in a tree-view
structure. For example, if you searched the file "README.txt" for the following
string, "*bin*", then the Remote Search results view might look like this:
<p><br /><img src="../images/search.gif" alt="" /><br /></p>
<div class="p">To manipulate the set
of search results:
<ul>
<li>Right-click the parent items of the tree, in this example, "README.txt",
and you can select any of the regular Remote Systems options, for example, <b>Open
With</b>, <b>Rename</b>, <b>Properties</b>, and so on.</li>
<li>Right-click any line beneath the parent search item in the tree, in this
example, "bin/rmid and jre/bin/rmid":
<ul>
<li>Select <b>Copy</b> to copy the path as you see it to your clipboard.</li>
<li>Select <b>Go to</b> to open the file in an editor, which highlights the matching text. You can double-click on any line to perform the same action.</li>
</ul>
</li>
</ul>
</div>
</div>
</div>
<div>
<p><b class="relrefhd">Related reference</b><br />
<a href="../ref/rsearch.html" title="">Using search parameters with special characters</a><br />
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,45 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css" />
<title>Exporting resources to a remote file system</title>
</head>
<body id="tremoexp"><a name="tremoexp"><!-- --></a>
<h1 class="topictitle1">Exporting resources to a remote file system</h1>
<div>
<p>A page in the Export wizard enables you to export resources from the workspace to a remote file system.</p>
<div class="p">To export resources from the workspace:</div>
<ol>
<li><span>Select <span><b>File</b> &gt; <b>Export</b></span> from the workbench menu bar. The Export wizard opens.</span></li>
<li><span>Select <b>Remote file system</b>. Click <b>Next</b>.
The Remote file system page opens.</span></li>
<li><span>Use the left and right panes to select resources to export. Choose
individual resources from the right pane, or entire folders from the left
one.</span></li>
<li><span>In the <b>Folder</b> field, select or browse for
the destination folder.</span></li>
<li><strong>Optional: </strong><span>Select the check box to overwrite (without
prompting) files of the same name in the remote folder.</span></li>
<li><span>Select one of the radio buttons to either replicate the workspace
folder structure in the remote system or create only the actual folders you
have selected.</span></li>
<li><strong>Optional: </strong><span>Select the check box to save the settings of this
export to a file. You can later right click on the file in the Navigator or other views
and export the same set of files without having to use the export wizard.</span>
<ul><li><strong>Optional: </strong><span>Deselect the checkbox to export only the set of files
that have changed since the last export. This is selected by default. It ensures that only files
that have changed since the last export will be exported next time and provides better performance.</span></li>
</ul>
</li>
<li><span>When you have specified the destination directory, click <b>Finish</b> to
export the resources to the remote system.</span>
</li>
</ol>
</div>
</body>
</html>

View file

@ -0,0 +1,33 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css" />
<title>Importing resources from a remote file system</title>
</head>
<body id="tremoimp"><a name="tremoimp"><!-- --></a>
<h1 class="topictitle1">Importing resources from a remote file system</h1>
<div>
<p>A page in the Import wizard enables you to import resources from a remote file system to the workspace.</p>
<div class="p">To import resources to the workspace:</div>
<ol>
<li><span>Select <span><b>File</b> &gt; <b>Import</b></span> from the menu bar. The Import wizard opens.</span></li>
<li><span>Select <b>Remote file system.</b> Click <b>Next</b>.
The Remote file system page opens.</span></li>
<li><span>Select or type a source folder, or click <b>Browse</b> to
select a folder from the <b>Browse For Folder</b> window. </span> Note that you can create a connection from this window.</li><li><span>Use the left and right panes to select resources to import. Choose
individual resources from the right pane, or entire folders from the left
one. You can select files from multiple projects.</span></li>
<li><span>In the second <b>Folder</b> field, specify the
destination for the imported resources.</span></li>
<li><strong>Optional: </strong><span>Select the check box to overwrite (without prompting) files of the same name in the workspace.</span></li>
<li><span>Select one of the radio buttons to either replicate the remote folder structure in the workspace or create only the actual folders you have selected.</span></li>
<li><span>When you have specified the source and destination, click <b>Finish</b> to import the resources to the workspace.</span></li>
</ol>
</div>
</body>
</html>

View file

@ -0,0 +1,31 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css" />
<title>Removing an existing type</title>
</head>
<body id="tremtype"><a name="tremtype"><!-- --></a>
<h1 class="topictitle1">Removing an existing type</h1>
<div>
<div class="p">To remove an existing type: </div>
<ol>
<li><span>In the Remote Systems view, right-click on a subsystem, and select <span><b>Work With </b> &gt; <b>Named Types</b></span>.</span></li>
<li><span>On the Work With Named Types window, expand <b>Object</b> or <b>Member</b>.</span></li>
<li><span>Select your defined type from the list. You cannot remove any IBM-supplied types.</span></li>
<li><span>Click <b>Remove</b>.</span></li>
</ol>
</div>
<div>
<p><b class="relconceptshd">Related concepts</b><br />
<a href="../concepts/cuseractions.html" title="">User actions (user options)</a><br />
</p><p><b class="reltaskshd">Related tasks</b><br />
<a href="tedittype.html" title="">Editing an existing type</a><br />
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,55 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css" />
<title>Running and viewing commands and shells using the Remote Commands view </title>
</head>
<body id="truncmdsview"><a name="truncmdsview"><!-- --></a>
<h1 class="topictitle1">Running and viewing commands and shells using the Remote Commands view </h1>
<div>
<div class="p">You can open a shell for your local and remote systems, from the
Remote System Explorer, <p><b>Opening the Remote Commands view and launching
a command shell</b></p>
<p>In the Remote System Explorer, switch to the Remote
Commands view by clicking <b>Window &gt; Show View &gt; Remote Commands</b> from
the menu bar. To open a new shell in the Remote Commands view, click the down
arrow in the view and select <b>Launch shell</b>. To launch a new shell for
another connection requires that an existing shell for that connection is
selected in the view. Otherwise, the shell must be launched from the Remote
Systems, Remote System Details, or the Remote Commands view.</p>
<p><b>Working with shells</b></p>
<p> When the Remote Commands view is open, you can work
with shells. When you work with a shell, you are working with a shell that
preserves its environment across commands. The environment for all commands
in the shell may change in response to your input. For example, if you type
<pre>cd ..</pre>
you change the working directory for that shell.</p>
<p><b>Viewing output in an editor</b></p>
<p>You can double-click a line of output to open
it in an editor. For example, if you encounter an error while running a command,
you can double-click the error and the editor opens the source to the line
of code where the parser found a problem.</p>
<p><b>Closing shells</b></p>
<p>The <b>Cancel shell</b> toolbar item is enabled when the currently displayed shell or command
is active. Press <b>Cancel Shell</b>, to terminate that process.
If the shell is active, it cancels the shell before removing it from the view.</p>
<p><b>Content assist</b></p>
<p>The Remote Commands view supports content assist. You can press CTRL+space to complete file names
or environment variable names while you type commands.</p>
<p></p>
</div>
</div>
<div>
<p><b class="relconceptshd">Related concepts</b><br />
<a href="../concepts/crunremcmds.html" title="">Shells and commands in the Remote Systems view</a><br />
</p><p><b class="reltaskshd">Related tasks</b><br />
<a href="twrkcmdshl.html" title="">Working with command shells</a><br />
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,37 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css" />
<title>Copying and pasting in the Remote System Explorer</title>
</head>
<body>
<h1>Copying and pasting in the Remote System Explorer</h1>
<p>You can copy and paste files not only between
files and folders, but between different
host systems as well. For example, you can
copy a file from one folder on your host
to another, or from one type of system to
another. You can select multiple files as
well. However, there are guidelines for what
kinds of items you can and cannot copy and
paste. In the Remote Systems view, expand
the two connections (that represent the two
hosts) until you see the file that you want
to copy and the location on the other host
where you want to paste the file.</p>
<p>To copy and paste:</p>
<ol>
<li>Right-click the original file to select it and select <b>Copy</b>.</li>
<li>Navigate through the directories and files until you find the place where you want to paste the file.</li>
<li>Right-click on the parent file that contains the files where you want to paste your file, and select <b>Paste</b>.</li>
</ol>
<p><b>Related tasks</b><br/>
<a href="ttabledrag.html">Dragging and dropping items in the Remote System Explorer</a><br/>
</p>
</body>
</html>

View file

@ -0,0 +1,48 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2003, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Dragging and dropping items in the Remote System Explorer</title>
</head>
<body>
<a name="ttabledrag"></a>
<h1 class="topictitle1">Dragging and dropping items in the Remote System Explorer</h1>
<div>
<div class="p">
<div class="p">You can drag and drop files between different
hosts, such as Local, Linux, UNIX, or Windows.
Additionally, you can drag and drop items
within one view; for example, in the Remote
Systems view, or you can drag and drop items
between views; for example, from the Remote
Systems view to the Remote Systems Details
view. When you drag and drop items, you copy,
rather than cut, the item that you move.
If you want to remove an item completely
and put it in another location, drag and
drop the item first, and then delete the
item from the original location.</div>
<p>To drag and drop files or objects:<br/>
</p>
<ol>
<li>In the Remote Systems view, expand the two connections (that
represent the two hosts) until you see the file you want to copy and the location
on the other host where you want to paste the file. Or, open two
views that contain the item and the destination.</li>
<li>Click the item once to select it, hold down the left mouse button
while you drag the item to the desired location, and then release the button.</li>
</ol>
</div>
</div>
<div>
<p><b>Related tasks</b><br clear="all"/>
<a href="ttablecopy.html" title="">Copying and pasting in the Remote System Explorer</a><br clear="all"/>
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,137 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Using team support</title>
</head>
<body id="tteamsup">
<a name="tteamsup"><!-- --></a>
<h1 class="topictitle1">Using team support</h1>
<div>
<div class="p">You can use any Eclipse-enabled repository from any
vendor. The following
information describes project-sharing using Concurrent Versions System
(CVS) support that comes with Eclipse. Steps and user interface
elements will differ depending on the repository
support that you have installed.
<div class="note"><span class="notetitle">Note: </span>When you
synchronize your RemoteSystemsConnection project with the repository
the first time, you will see many files in conflict.
This is because it takes one synchronization to properly align
the server's encoded version information with your local files. This
happens only once and you can just receive all of the incoming changes
and your local workspace will then be synchronized with the server. You
might also find inactive profiles that belong to other teammates in the Team
view after you synchronize with the central server. You can choose whether
or not to activate these profiles in the Team view if you want to see the
profile's contents in the Remote System Explorer on your local workstation.</div>
<p>In a team programming environment, team members do work in their own workbench,
isolated from others. Eventually they will want to share their work with
their teammates.&nbsp; The Remote System Explorer allows them to share
their connections, filter pools, and filters. To share these resources:</p>
</div>
<ol>
<li class="skipspace">In the Remote System Explorer perspective, select the Team tab which by
default is located in the same pane as the Remote Systems view.&nbsp; This
will bring the Team view to the front of the Remote System Explorer.&nbsp;
You can also use the&nbsp;<img src="../images/gsarrow.gif" title="" alt="menu" style="width: 24px; height: 23px;"/>
button on the Remote Systems view and select the <span style="font-weight: bold;">Work
With Profiles</span> action.<span> </span></li>
<li class="skipspace"><span>Expand <b>RemoteSystemsConnections</b>. The profiles that you have defined, as well as the Team profile, are displayed. The Team profile is created by the Remote System Explorer to use for sharing connections, filter pools, and filters if you do not want to share them in a profile that you create and manage.</span></li>
<li class="skipspace"><span>Right-click on <b>RemoteSystemsConnections</b>
and select <span><b>Team</b> &gt; <b>Share Project</b></span> . </span></li>
<li class="skipspace"><span>Select <b>CVS</b> and click <b>Next</b>.</span></li>
<li class="skipspace"><span>Select <b>Use existing repository
location </b> if you have already defined a CVS repository. Select <b>Create a new
repository</b> location if you need to define a CVS repository (this
information should be available from the person who configured the CVS
repository on the server). To create a CVS repository definition:</span>
<ol type="a">
<li class="skipspace"><span>In the <b>Host</b> field, type the
address of the server, for example mymachine.com. </span></li>
<li class="skipspace"><span>In the <b>Repository path</b> field,
type the path to the repository on the server, for example /home/test, d:/test. </span></li>
<li class="skipspace"><span>In the <b>User</b> field, type the
user name to use to connect to the repository. </span></li>
<li class="skipspace"><span>In the <b>Password</b> field, type
the password for the user name. </span></li>
<li class="skipspace"><span>From the <b>Connection Type</b>
list, select the authentication protocol of the CVS server. There are three
connection methods that come with the Eclipse CVS client: </span>
<ul>
<li><b>pserver</b>: A CVS specific connection method. </li>
<li><b>extssh</b> : An SSH 1.0 client included with the workbench. </li>
<li><b>ext</b>: The CVS ext connection method that uses an
external tool such as SSH to connect to the repository. The tool used
by ext is configured in the<span><b>Team</b> &gt; <b>CVS</b> &gt; <b>EXT
Connection Method</b></span> preference page. </li>
</ul>
</li>
<li class="skipspace"><span>If the server uses a custom port,
enable <b>Use Port</b> and
enter the port number. </span></li>
</ol>
</li>
<li class="skipspace"><span>Click <b>Finish</b>. The repository
location is
created. The <span style="font-weight: bold;">RemoteSystemsConnections</span> project will be created remotely and the Synchronize view will open and
allow you to commit its resources to the server. If the project already
exists remotely, the Synchronize view will show conflicts on any files
that exist both locally and remotely. If the </span><span><span
style="font-weight: bold;">RemoteSystemsConnections</span> </span><span>project
already exists in the repository when you first share it, there may be
many conflicts. Generally, these are not real conflicts, but simply considered
conflicts on the first synchronize because there is no local CVS information for the
resources in your workspace.
If you have not created any resources in your Team profile, you can
safely send or receive all of the conflicting files. If you have created
resources in your Team profile, you should check each conflicting file to ensure
there really are no differences, and if there are, resolve them by merging.</span></li>
<li class="skipspace"><span>To synchronize your resources with those
in the associated repository, right-click on the <span style="font-weight: bold;">RemoteSystemsConnection
</span>project, and select <span><b>Team</b> &gt; <b>Synchronize
with Repository</b></span>.</span></li>
<li class="skipspace"><span>After sharing or synchronizing, and
receiving incoming resources from the repository, right-click on the <span
style="font-weight: bold;">RemoteSystemsConnection </span>project,
and select <b>Reload Remote System Explorer</b>. This refreshes
the Remote System Explorer and Team view to reflect the new or changed
resources.</span></li>
</ol>
</div>
<div class="nested1" id="tviewproject"><a name="tviewproject"><!-- --></a>
<h2 class="topictitle2">Viewing the project resources in the Navigator
view</h2>
<div>
<div class="p">The Navigator view provides a hierarchical view of all
the resources in the workspace. From here, you can view the contents of the projects
that are shared, including the <span style="font-weight: bold;">RemoteSystemsConnection
</span>project, and select team-related actions on particular
resources. By default, the Navigator view is included in the Resources perspective.
To add it to the current perspective,
<ol>
<li>Select <span><b>Window</b> &gt; <b>Show View</b> &gt; <b>Other</b></span>.</li>
<li>Expand <b>Basic.</b> </li>
<li>Select <b>Navigator.</b></li>
</ol>
</div>
<div class="p"><img src="../images/navigator.jpg" alt=""/></div>
</div>
<div>
<p><b class="relconceptshd">Related concepts</b><br/>
<a href="../concepts/cteam.html" title="">Team support</a><br/>
<a href="../concepts/cprofile.html" title="">Remote System Explorer
Profiles</a><br/>
</p>
<p><b class="reltaskshd">Related tasks</b><br/>
<a href="tteamsup1.html" title="">Working with profiles and team support</a><br/>
</p>
</div>
</div>
</body>
</html>

View file

@ -0,0 +1,82 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Working with profiles and team support</title>
</head>
<body id="tteamsup1">
<a name="tteamsup1"></a>
<h1 class="topictitle1">Working with profiles and team support</h1>
<div>
<div class="p">All connections, filter data, user actions, and compile
commands belong to profiles. Profiles can be shared by team members for the purpose of
team development. You can work with your profiles in the Team view to enable
greater control over team-sharable elements in the Remote System Explorer.
<div class="note"><span class="notetitle">Note: </span>Because
the Remote Systems view only displays connections, filters, user
actions, and compile commands from active profiles, you need to be in the Team
view to work with or activate your non-active profiles.
</div>
</div>
<div class="p">To manage your team profiles:
<div class="p">
<ol>
<li>In the Remote Systems perspective, select the Team tab which by
default is located in the same pane as the Remote Systems view.&nbsp;
This will bring the Team view to the front of the Remote System
Explorer.&nbsp; You can also use the&nbsp;
<img src="../images/gsarrow.gif" title="" alt="menu" style="width: 24px; height: 23px;"/>
button on the Remote Systems view and select the <span style="font-weight: bold;">Work With Profiles</span>
action.<br/>
</li>
<li>In the Team view, expand the root element, <b>RemoteSystemsConnections</b>,
to see a list of your profiles.
<ul>
<li>To create a profile, right-click on the root element in the
Team view, and select <b>New &gt; Profile</b> and complete the dialog box for the
profile.</li>
<li>To activate or deactivate a profile, right-click the profile
and select <b>Active</b> (if it is deactivated) or <b>Not active</b> (if it is active).</li>
<li>To duplicate a profile in the view, right-click the profile
and select <b>Duplicate</b>. This action copies all of the profile's connections, filters, user
actions, and compile commands.</li>
<li>To rename a profile, right-click the profile and select <b>Rename</b>.</li>
</ul>
</li>
<li>In the Team view, you can also expand your profiles to view
connections, filter pools, user actions, and compile commands that belong to each
profile. Right-click on any of your specific filters, user actions, and so on,
to open a <b>Work with</b> window. These are the same actions available in the
Remote Systems view. To work with filter pools, for example, right-click one
of your filters, and select <b>Work with filter pools</b>. Keep in mind that
the Remote Systems view is the more ideal environment to manipulate filters,
filter pools, compile commands, user actions, and so on. The Team view is designed to
manage profiles, and view the elements that belong to each profile. The Remote
Systems view is designed for you to work with all the items that belong to your
active profiles. It includes a greater number of right-click and menu options
for a development-focused approach.</li>
<li>When you have finished working with your profiles, switch back to
the Remote Systems view, by clicking the Remote Systems tab, to continue
working with active profile artifacts, or remain in the Team view to
<a href="tteamsup.html">synchronize your profiles with the repository</a>.</li>
</ol>
</div>
</div>
</div>
<div>
<p><b class="relconceptshd">Related concepts</b><br/>
<a href="../concepts/cteam.html" title="">Team support</a><br/>
<a href="../concepts/cprofile.html" title="">Remote System Explorer Profiles</a><br/>
</p>
<p><b class="reltaskshd">Related tasks</b><br/>
<a href="tteamsup.html" title="">Using team support</a><br/>
<a href="tworkuseract.html" title="">Managing user actions (user options)</a><br/>
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,75 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css"/>
<title>Managing user actions (user options)</title>
</head>
<body id="tworkuseract">
<a name="tworkuseract"></a>
<h1 class="topictitle1">Managing user actions (user options)</h1>
<div>
<div class="p">To create a new action or change an existing action:</div>
<ol>
<li><span>In the Remote Systems view, expand the connection
containing the kinds of resources you want to act on,
navigate to the subsystem that would contain those resources, and
select <b>Work with &gt; User actions</b>.
You can also right-click on a file in one of your filters, and select <b>User
Actions</b>.</span></li>
<li><span>Type the text to display in the <b>Action Name</b> field.
This is a brief label for the action.</span></li>
<li><span>Type a longer, more descriptive text for the action in the <b>Comment</b>
field.</span></li>
<li><span>Type the actual command string to run when
a user selects this action. This command can use action substitution
variables when your action is run. These variables are used when defining the
command string to run for a particular action. Substitution variables keep you
from having to explicitly code command parameter values. Click <b>Insert
variable</b> to see and select valid variables.</span></li>
</ol>
<div class="p"><b>Additional parameters</b>
<ul>
<li>Select <b>Browse</b> to search for and select command
files (for example, .exe, .bat or .cmd files). The file name you select
is reflected in the Command field when you return. </li>
<li>Select <b>Prompt</b> to prompt the command currently entered
in the Command area.</li>
<li>Select <b>Prompt first</b> to indicate that Remote System
Explorer should prompt the command when it is run.</li>
<li>Select <b>Refresh after</b> to have Remote System Explorer
refresh the selected files after the action's command is run. This is
useful if your command affects the information displayed in the file list
window for the selected files, for example, if your command changes the type
of a file.</li>
<li>Select <b>Show action</b>.</li>
<li>Select <b>Single selection only</b> if you want to show
this action only when a single object is selected.</li>
<li>Select <b>Invoke once </b> to collect the full names of
all selected resources into the file name parameter and run the command
only once for all resources that are selected..</li>
<li>Select any currently defined named types from the <b>Defined
Types</b> list
and click <b>Add</b> to include them in the <b>Selected
Types</b> list. The action will only appear if a file matching one
of these types is selected.</li>
</ul>
<p>You can choose to view user actions by active profile for remote
objects
on the <b>User Actions</b> cascade menu. You can see both
team-shared and private user actions. To enable this, select <b>Cascade
user actions by profile</b> on the <b>Remote Systems Preferences</b>
page.</p>
</div>
</div>
<div>
<p><b class="relconceptshd">Related concepts</b><br/>
<a href="../concepts/cuseractions.html" title="">User actions (user options)</a><br/>
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,57 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2004, 2006. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" type="text/css" href="../book.css" />
<title>Working with command shells</title>
</head>
<body id="twrkcmdshl"><a name="twrkcmdshl"></a>
<h1 class="topictitle1">Working with command shells</h1>
<div>
<p>In the Remote Systems view, you can launch a shell to perform commands
in a specific directory or folder of a remote file system.</p>
<div class="p">
To launch a new shell from the Remote Systems view:
<ol>
<li>Expand a connection.</li>
<li>Right-click on a file subsystem that supports shells and select <b>Launch Shell</b>.</li>
<li>Enter shell commands, such as "ls" or "pwd", in the <b>Command</b> field (just beneath the shell itself).</li>
</ol>
</div>
<div class="p">
You can also run commands from locations further down in the remote file system
tree, so that you do not need to navigate there from your home directory each time.
This option takes the default shell, sets the current directory to the folder that was selected,
and invokes a command in that directory. If you check the <b>Run in
new shell</b> check box you will get a new shell instead of running the
command in the current shell:
<ol>
<li>Expand the file subsystem until you are at the directory where you want
to run your commands.</li>
<li>Right-click on that directory and select <b>Run Commands</b>.</li>
<li>Enter the command you want to run in the <b>Command</b> field and click <b>OK</b>.</li>
</ol>
</div>
<div class="note">
<span class="notetitle">Note: </span>
Each new shell shows up in a separate tab. If more than one
shell is running on the same connection, each subsequent shell has a number
appended to the connection name.
</div>
</div>
<div>
<p>
<b class="relconceptshd">Related concepts</b><br/>
<a href="../concepts/crunremcmds.html" title="">Shells and commands in the Remote Systems view</a><br/>
</p>
<p>
<b class="reltaskshd">Related tasks</b><br/>
<a href="truncmdsview.html" title="">Running and viewing commands and shells using the Remote Commands view</a><br/>
</p>
</div>
</body>
</html>

View file

@ -0,0 +1,48 @@
<?xml version="1.0" encoding="utf-8"?>
<?NLS TYPE="org.eclipse.help.toc"?>
<toc label="Remote System Explorer User Guide (old)">
<topic label="Universal Systems" href="concepts/cuniversal.html"/>
<topic label="Remote System Explorer Connections" href="concepts/cbegin.html">
<topic label="Connecting to a remote Linux or UNIX server" href="tasks/tbeginlinux.html"/>
<topic label="Connecting to a remote Windows server" href="tasks/tbeginwindows.html"/>
<topic label="Disconnecting from a remote server" href="tasks/tbegindiscon.html"/>
<topic label="Creating a second connection to a remote server" href="tasks/tbeginsecond.html"/>
<topic label="Deleting a connection" href="tasks/tbegindelete.html"/>
<topic label="Configuring environment variable support for connections" href="tasks/tbeginenv.html"/>
</topic>
<topic label="Remote System Explorer filters, filter pools, and filter pool references" href="concepts/cfilters.html">
<topic label="Creating filters" href="tasks/tmanagemem.html"/>
<topic label="Changing filters" href="tasks/tmanageedit.html"/>
<topic label="Deleting filters" href="tasks/tmanagedel.html"/>
<topic label="Configuring filter pools" href="tasks/tmanagepools.html"/>
<topic label="Configuring filter pool references" href="tasks/tmanagepoolsref.html"/>
</topic>
<topic label="Remote System Explorer Profiles" href="concepts/cprofile.html">
<topic label="Creating a second profile" href="tasks/tbeginsecprofile.html"/>
<topic label="Deleting a profile" href="tasks/tbegindeleteprofile.html"/>
</topic>
<topic label="Team support" href="concepts/cteam.html">
<topic label="Using team support" href="tasks/tteamsup.html"/>
<topic label="Working with profiles and team support" href="tasks/tteamsup1.html"/>
</topic>
<topic label="Shells and commands in the Remote Systems view" href="concepts/crunremcmds.html">
<topic label="Running and viewing commands and shells using the Remote Commands view" href="tasks/truncmdsview.html"/>
<topic label="Working with command shells" href="tasks/twrkcmdshl.html"/>
</topic>
<topic label="User actions" href="concepts/cuseractions.html">
<topic label="Managing user actions" href="tasks/tworkuseract.html"/>
<topic label="Editing an existing type" href="tasks/tedittype.html"/>
<topic label="Removing an existing type" href="tasks/tremtype.html"/>
</topic>
<topic label="Search for text and files on remote servers" href="tasks/tmanagesearch.html">
<topic label="Using search parameters with special characters" href="ref/rsearch.html"/>
</topic>
<topic label="Compiling programs" href="concepts/cremcompile.html"/>
<topic label="Managing archived files" href="tasks/tarchive.html"/>
<topic label="Importing resources from a remote file system" href="tasks/tremoimp.html" />
<topic label="Exporting resources to a remote file system" href="tasks/tremoexp.html" />
<topic label="Building programs on a remote system" href="tasks/tbuild.html" />
<topic label="Accessing Remote System Explorer preferences" href="ref/rrsepref.html"/>
<topic label="Saving User IDs and passwords" href="tasks/tbeginpass.html"/>
<topic label="Legal" href="notices.html"/>
</toc>