This chapter explains how to access the RSF menus, reviews the functions that can be performed from each menu, and explains how you can customize the menus with Screen Design Aid (SDA).
The main Remote Software Facility menu is called RSF. The most commonly used RSF functions are grouped on this menu.
The other menus are:
If library RSF is in your job's library list, you can access any menu by keying "GO" followed by the menu name:
GO RSF
If library RSF is not in your job's library list, you must qualify the menu name. Library RSF will be added to the product portion of the job's library list while the menu is displayed:
GO RSF/RSF
The RSF menu provides access to the most commonly used functions.
Options in the first column of this menu are Client Functions. As a client, your machine initiates contact with other AS/400s to send/retrieve objects and spooled files, pass through and call remote programs. Clients are also referred to as requesters.
Options 21 through 30 on this menu are Server Functions. As a server, your machine responds to requests from clients. A single machine can perform both client and server functions simultaneously.
Options 31 through 40 apply to both clients and servers.
The RSF menu options are each discussed below.
1. Work With Connections to Servers.
Use this menu option to work with a list of remote locations you can contact (servers). You make servers known to your machine by creating server directory entries.
The server directory on your machine functions like an on-line phone book. You store phone numbers and other connection information in the server directory so you don't have to key the information for every request.
While working with servers, you can easily add, remove, change, copy, and rename server directory entries and initiate connections to server locations. You can also work with catalogs of RSF packages that are available from each server.
See Working With Servers for more information.
2. Start Pass-Through.
Use this menu option to start a pass-through or telnet session with a given server. You will be prompted for parameters. See Starting Pass-Through for more information.
An operator on the server machine must grant you permission to pass-through by adding an entry to the requester directory on their machine. If the installation defaults were not changed, a generic entry has already been added for you. See Adding Requester Directory Entries for more information.
3. Work With Catalog.
Use this menu option to work with a list of RSF packages available from a given server. You will be prompted for the server you want to work with.
While working with an RSF catalog, you can easily display and delete catalog entries. You can also retrieve the package associated with any catalog entry.
To refresh the catalog, you can use a function key to send a special request to the server. The data returned for this request is used to build a catalog on your machine of the packages available from the server.
See Working With RSF Catalogs for more information.
4/44. Send/Retrieve Package.
Use option 4 to send a package of objects to another machine, or option 44 to retrieve a package of objects from another machine. You will be prompted for parameters. See Sending Packages and Retrieving Packages for more information.
With these menu options, you can transmit objects that have been defined as an RSF package
or previously saved to a save file.
Use the Copy File Using RSF (CPYFRSF) command (options 7 and 77 on this menu) to transmit files that are not part of a package.
Use options 5/55, 6/66, and 8/88 on this menu to transmit files or other objects that are not part of a package.
5/55. Send/Retrieve Library.
Use option 5 to send an entire library to another machine, or option 55 to retrieve a library. You will be prompted for parameters.
Source for the commands and programs used by these menu options can be found in library RSFTOOLS. See Appendix B for more information.
These menu options allow you to transmit a library that is not part of a predefined RSF package. The library is saved, transmitted and restored to the target system.
6/66. Send/Retrieve Objects.
Use option 6 to send selected objects to another machine, or option 66 to retrieve objects. You will be prompted for parameters.
Source for the commands and programs used by these menu options can be found in library RSFTOOLS. See Appendix B for more information.
These menu options allow you to transmit individual objects that are not part of a predefined RSF package. The objects are saved, transmitted and restored to the target system.
7/77. Send/Retrieve Members.
Use option 7 to copy database file members to another machine, or option 77 to copy members from another machine. You will be prompted for parameters. See Copying Remote Files for more information.
An operator on the server machine must grant you permission to copy files by adding an entry to the requester directory on their machine. If the installation defaults were not changed, a generic entry has already been added for you. See Adding Requester Directory Entries for more information.
8/88. Send/Retrieve IFS Objects.
Use option 8 to send selected Integrated File System objects to another machine, or option 88 to retrieve
IFS objects. You will be prompted for parameters. See Sending
IFS Objects for more information.
9/99. Send/Retrieve Spooled files.
Use option 9 to send one or more spooled files to another machine, or option 99 to retrieve spooled files. You will be prompted for parameters. See Sending Spooled Files for more information.
20. More Client Functions.
Select this option to display the RSFRQS menu that contains additional client functions.
21. Start Server Function.
Use this menu option to start the RSF server function on your machine. The server function must be started to enable remote machines to access your machine to transfer objects, pass-through or call remote programs. See Starting The Server Function for more information.
In order to start the server function, user profile RSFSRV must exist on your machine. If you followed the recommended installation procedure, this user profile has already been created for you. See Creating User Profile RSFSRV for more information about creating this user profile.
22. End Server Function.
Use this menu option to end the RSF server function on your machine. Ending the server function prevents clients from accessing your machine.
See the on-line help text for the End Server Function (ENDRSFSRV) command for more information.
23. Work With Client Rights.
Use this menu option to work with a list of clients or requesters. You make clients known to your machine by adding requester directory entries.
The entries in the requester directory of your machine determine the rights and restrictions that apply to other machines that contact your machine.
While working with requesters, you can easily add, change, copy, remove, and rename requester directory entries.
See Working With Requesters for more information.
24. Work With RSF Log.
Use this menu option to display or print selected RSF log entries. A log entry is generated each time a client contacts your machine. You will be prompted for parameters.
See Working With The RSF Log for more information.
30. More Server Functions.
Select this option to display the RSFSRV menu that contains additional server functions.
31. Change Defaults.
Select this option to view or change the default values that affect the Remote Software Facility product. You will be prompted for parameters. Current values are displayed as parameter defaults.
See Setting Product Defaults for more information.
32. Work With Packages.
Use this menu option to work with a list of RSF packages on your machine. You make objects available to be retrieved from your machine or sent to other machines by creating RSF packages.
While working with RSF packages, you can easily create, delete, change, copy, and rename packages on your machine. You can also display detailed information about RSF packages, display the cover letters associated with RSF packages and display the save file associated with RSF packages.
See Working With Packages for more information.
33. Tools Menu.
Select this option to display the RSFTOOLS menu. RSFTOOLS is a collection of tools and sample programs that enhance the function and ease of use of Remote Software Facility.
See Appendix B for more information about RSFTOOLS.
40. Advanced Functions.
Select this option to display the RSFADV menu that contains functions for
advanced users.
The RSFRQS menu provides access to additional functions that pertain to RSF clients. The menu options are each discussed below.
The RSFSRV menu provides access to additional functions that pertain to RSF servers. The menu options are each discussed below.
1. Manual Call-Back.
Use this menu option to manually contact requester machine that has requested a call back. Manual callback is needed if the server phone line into your AS/400 is not answered directly by the AS/400, but is answered first by a receptionist.
See Manually Calling Back a Requester Machine for more information.
2. #9; Purge RSF Log.
Use this menu option to purge selected entries from the RSF log. A log entry is generated each time a remote machine contacts your machine. You will be prompted for parameters.
See the on-line help text for the Purge RSF Log (PRGRSFLOG) command for more information.
3. Install Package.
Use this menu option to install an RSF package that was sent to you.
See the on-line help text for the Install RSF Package (INLRSFPKG) command for more information.
5.
Add PPP validation list entry
Use this option to add an entry to a validation list which can be used to validate
incoming PPP (dial-up TCP/IP) connections.
6. Remove PPP validation list entry
Use this option to remove an entry from a validation list which is being used to validate
incoming PPP (dial-up TCP/IP) connections.
The source for all RSF menus is included with the Remote Software Facility product. The menu source is contained in file QMNUSRC in library RSF. You can use the following command to update a menu with Screen Design Aid (SDA):
STRSDA OPTION(2) SRCFILE(RSF/QMNUSRC) + SRCMBR(menu_name) OBJLIB(RSF)
Refer to the SDA Manual for more information about updating a menu with SDA.