Difference between revisions of "RSE"

From MidrangeWiki
Jump to: navigation, search
m
 
(Moved 'searching for text' to WDSC_Find_Tips#Find_camel_case_words.)
 
(20 intermediate revisions by 3 users not shown)
Line 4: Line 4:
  
 
On the iSeries, the RSE allows you to navigate through [[Libraries]], [[Objects]], [[Files]], [[Source Members]], [[IFS]] files, [[Jobs]], and [[Commands]].  For each type, context appropriate options are available through a pop-up menu.
 
On the iSeries, the RSE allows you to navigate through [[Libraries]], [[Objects]], [[Files]], [[Source Members]], [[IFS]] files, [[Jobs]], and [[Commands]].  For each type, context appropriate options are available through a pop-up menu.
 +
 +
==Running a user action==
 +
This is conceptually like running a user option in PDM.
 +
 +
Summary:
 +
<br>
 +
Go to an iSeries command line and
 +
*prompt your command. 
 +
*Fill in the parameters with place holders instead of actual values. 
 +
*Don't press Enter, press F14 to see a summary of the command.
 +
*Copy that onto the clipboard.
 +
 +
Go to the Remote Systems view. 
 +
*Right click on an object or member and choose ''User actions'' 
 +
*From there, choose ''Work With User Actions...'' 
 +
 +
Detail:
 +
<br>
 +
For this example, let's use CVTRPGSRC
 +
 +
Go to an iSeries command line and prompt CVTRPGSRC.  Substitution variables you can use:
 +
 +
<pre>
 +
&B - List type: X=library list, L=Library, O=Object, M=Member, J=Job, I=IFS
 +
&C - Name of this user action
 +
&D - Last modified date
 +
&E - Run in batch *YES/*NO
 +
&F - File name containing member
 +
&G - JOBD library
 +
&H - JOBD name
 +
&MF- Temp file name (invoke once)
 +
&ML- Temp lib name (invoke once)
 +
&MM- Temp mbr name (invoke once)
 +
&N - Resource/member name
 +
&O - Object library
 +
&P - Compile in batch *YES/*NO
 +
&R - Replace when compiling *YES/*NO
 +
&S - Object/member type without asterisk
 +
&T - Object/member type with asterisk
 +
&U - User ID that made the connection
 +
&X - Object/member text in single quotes
 +
&Z - Connection name
 +
</pre>
 +
 +
The resulting command after pressing F14:
 +
<pre>
 +
CVTRPGSRC FROMFILE(&L/&F)     
 +
          FROMMBR(&N)         
 +
          TOFILE(&L/QRPGLESRC)
 +
          TOMBR(&N)           
 +
          LOGFILE(*NONE)     
 +
</pre>
 +
 +
Go to the Remote Systems view,
 +
*right click a member or object. 
 +
*Choose ''User actions'' 
 +
*From there, choose ''Work With User Actions...'' 
 +
*This is CVTRPGSRC, so it's a member action not an object action.
 +
**Action name: cvtrpgsrc
 +
**Comment: <blank>
 +
**Command: Normal command
 +
*paste the above command into the command window
 +
*Check the ''Refresh after'' box -
 +
**this will refresh the view after your command has run. 
 +
**This is handy if your filter includes both QRPGSRC and QRPGLESRC.
 +
*Check the ''Show action'' box -
 +
**this will display this action only for the types you select in the ''Resource types for which this action will appear'' box below. 
 +
**The idea is that you don't want to accidentally run CVTRPGSRC on CL...
 +
*Choose the RPG defined type and add it to the Selected Types list.
 +
**You might want to edit the types (click on the EDIT(H) button) so that the option will not appear for RPGLE and SQLRPGLE Types. 
 +
**Tends to make them unusable.
 +
 +
 +
*Click ''Create'' then ''Close''
 +
 +
*To use your new command,
 +
**fire up the Remote Systems view
 +
**Right click an RPG source member
 +
***User Actions
 +
***cvtrpgsrc
 +
 +
You should now have a QRPGLESRC version of your RPGIII member.
 +
 +
*User actions are stored (WDSC 6.0)
 +
**in a file called '''uda.xml''' in the path
 +
**workspace\RemoteSystemsConnections\{MY_USR_NAME}\UserActions\ibm.files400\uda.xml
 +
 +
One can export this (and other RSE settings) via the workbench's File->Export action menu.  Select the file system to export to, then select the RemoteSystemsConnections to export all the entries in your connections.  If that's too much, drill down the tree through
 +
*RemoteSystemsConnections
 +
**''user name''
 +
***UserActions
 +
****ibm.files400
 +
 +
V7.0 example of user action XML:
 +
<pre>
 +
<?xml version="1.0" encoding="UTF-8"?>
 +
<Actions release="7.1.1">
 +
<Domain Name="Member" Type="Member">
 +
<Action Collect="False" Enable="True" Name="cvtrpgsrcbuck" Prompt="False" Refresh="True" RunEnv="normal" SingleSelection="False">
 +
<FileTypes> RPG400</FileTypes>
 +
<Comment/>
 +
<Command>CVTRPGSRC FROMFILE(&amp;L/&amp;F) FROMMBR(&amp;N) TOFILE(&amp;L/QRPGLESRC) TOMBR(&amp;N) LOGFILE(*NONE)</Command>
 +
</Action>
 +
</Domain>
 +
</Actions>
 +
</pre>
 +
 +
 +
==Other actions==
 +
RSE provides ways to group items together for your convenience. 
 +
*One way is through [[Profiles, Connections, and Filters|RSE connection]]s
 +
*and another is through [[RSE_filter]]s.
 +
 +
==Table view==
 +
The {{PAGENAME}} tree doesn't show a lot of information. 
 +
*We ex-[[PDM]] users are accustomed to seeing the member type, text and change date along with the member name. 
 +
*One way to see the change date is through the Table View. 
 +
*Right click your filter and choose 'Show in Table.' 
 +
*This will open a new view, called the iSeries Table View. 
 +
*The default columns do not include the last modified date. 
 +
*To show that column, click on the downward pointing arrow on the right side of the Table View, then Show Columns, then Customized. 
 +
*Then, click the triangle again and choose Preferences to assign the columns you want to see in the Table View. 
 +
*Alternately, choose All Columns in Show Columns...
 +
 +
It's interesting to note that as of WDSC 7.0, the table view allows use of your RSE User Actions, so you can select a group of members and perform a common action on them all, very similar to [[PDM]].
  
 
==Categories==
 
==Categories==
[[Category:WDSC]]
+
 
 +
 
 +
[[Category:WDSC|RSE]]
 
[[Category:Definitions]]
 
[[Category:Definitions]]

Latest revision as of 17:48, 21 April 2010

RSE, an acronym for Remote System Explorer, which is part of WDSC.

It allows you to navigate remote systems in a native context.

On the iSeries, the RSE allows you to navigate through Libraries, Objects, Files, Source Members, IFS files, Jobs, and Commands. For each type, context appropriate options are available through a pop-up menu.

Running a user action

This is conceptually like running a user option in PDM.

Summary:
Go to an iSeries command line and

  • prompt your command.
  • Fill in the parameters with place holders instead of actual values.
  • Don't press Enter, press F14 to see a summary of the command.
  • Copy that onto the clipboard.

Go to the Remote Systems view.

  • Right click on an object or member and choose User actions
  • From there, choose Work With User Actions...

Detail:
For this example, let's use CVTRPGSRC

Go to an iSeries command line and prompt CVTRPGSRC. Substitution variables you can use:

&B - List type: X=library list, L=Library, O=Object, M=Member, J=Job, I=IFS
&C - Name of this user action
&D - Last modified date
&E - Run in batch *YES/*NO
&F - File name containing member
&G - JOBD library
&H - JOBD name
&MF- Temp file name (invoke once)
&ML- Temp lib name (invoke once)
&MM- Temp mbr name (invoke once)
&N - Resource/member name
&O - Object library
&P - Compile in batch *YES/*NO
&R - Replace when compiling *YES/*NO
&S - Object/member type without asterisk
&T - Object/member type with asterisk
&U - User ID that made the connection
&X - Object/member text in single quotes
&Z - Connection name

The resulting command after pressing F14:

CVTRPGSRC FROMFILE(&L/&F)      
          FROMMBR(&N)          
          TOFILE(&L/QRPGLESRC) 
          TOMBR(&N)            
          LOGFILE(*NONE)       

Go to the Remote Systems view,

  • right click a member or object.
  • Choose User actions
  • From there, choose Work With User Actions...
  • This is CVTRPGSRC, so it's a member action not an object action.
    • Action name: cvtrpgsrc
    • Comment: <blank>
    • Command: Normal command
  • paste the above command into the command window
  • Check the Refresh after box -
    • this will refresh the view after your command has run.
    • This is handy if your filter includes both QRPGSRC and QRPGLESRC.
  • Check the Show action box -
    • this will display this action only for the types you select in the Resource types for which this action will appear box below.
    • The idea is that you don't want to accidentally run CVTRPGSRC on CL...
  • Choose the RPG defined type and add it to the Selected Types list.
    • You might want to edit the types (click on the EDIT(H) button) so that the option will not appear for RPGLE and SQLRPGLE Types.
    • Tends to make them unusable.


  • Click Create then Close
  • To use your new command,
    • fire up the Remote Systems view
    • Right click an RPG source member
      • User Actions
      • cvtrpgsrc

You should now have a QRPGLESRC version of your RPGIII member.

  • User actions are stored (WDSC 6.0)
    • in a file called uda.xml in the path
    • workspace\RemoteSystemsConnections\{MY_USR_NAME}\UserActions\ibm.files400\uda.xml

One can export this (and other RSE settings) via the workbench's File->Export action menu. Select the file system to export to, then select the RemoteSystemsConnections to export all the entries in your connections. If that's too much, drill down the tree through

  • RemoteSystemsConnections
    • user name
      • UserActions
        • ibm.files400

V7.0 example of user action XML:

<?xml version="1.0" encoding="UTF-8"?>
<Actions release="7.1.1">
<Domain Name="Member" Type="Member">
<Action Collect="False" Enable="True" Name="cvtrpgsrcbuck" Prompt="False" Refresh="True" RunEnv="normal" SingleSelection="False">
<FileTypes> RPG400</FileTypes>
<Comment/>
<Command>CVTRPGSRC FROMFILE(&L/&F) FROMMBR(&N) TOFILE(&L/QRPGLESRC) TOMBR(&N) LOGFILE(*NONE)</Command>
</Action>
</Domain>
</Actions>


Other actions

RSE provides ways to group items together for your convenience.

Table view

The RSE tree doesn't show a lot of information.

  • We ex-PDM users are accustomed to seeing the member type, text and change date along with the member name.
  • One way to see the change date is through the Table View.
  • Right click your filter and choose 'Show in Table.'
  • This will open a new view, called the iSeries Table View.
  • The default columns do not include the last modified date.
  • To show that column, click on the downward pointing arrow on the right side of the Table View, then Show Columns, then Customized.
  • Then, click the triangle again and choose Preferences to assign the columns you want to see in the Table View.
  • Alternately, choose All Columns in Show Columns...

It's interesting to note that as of WDSC 7.0, the table view allows use of your RSE User Actions, so you can select a group of members and perform a common action on them all, very similar to PDM.

Categories