This chapter describes the simplest way to:
- Retrieve a package of objects from a remote machine.
- Send a miscellaneous object to another machine.
- Send a data base file member to another machine.
Before proceeding with the examples in this chapter, you should follow the steps outlined in the Installation chapter to properly install Remote Software Facility.
For detailed information about the CL commands and displays shown in this chapter, see chapter 6, Requester Operations.
See chapter 8, Packages, for more information about RSF packages. See Appendix B for a description of the RSFTOOLS library and more information about how you can send and retrieve objects without having to create a new RSF package each time. See Copying Remote Files for more information about sending and retrieving data base file members that are not part of a package.
See chapter 10, RSF Express, for more information about sending and retrieving objects graphically in a Windows environment.
When you retrieve a package from a remote iSeries or AS/400 with Remote Software Facility, your machine is functioning as the requester or client. The remote machine is functioning as the server.
To retrieve a package from a remote AS/400, follow these steps.
- For dial up connections, you must know the RSF phone number for the server machine. If you do not know the server's RSF phone number, contact the server for assistance.
Bug Busters' RSF phone number is 206-633-0512.
- Ensure that library RSF is in your job's library list by entering the following command at any command line:
ADDLIBLE RSF
- Prompt the following command at any command line:
ADDRSFSDE
When you press F4, the Add Server Directory Entry prompt is displayed
- Enter an ID of up to 10 characters for "Server id". The server ID must be a valid system name.
For dial-up connections, enter either *SDLCDIAL or *TCPDIAL for "Connection Method", and then enter the server's RSF phone number. Include all of the digits necessary to dial the server, including a leading "9" if necessary to reach an outside line, and a leading "1" plus area code.
For TCP/IP connections, enter the network name or the IP address for
"Remote System".
Enter text describing the server location.
Press Enter to add an entry to the server directory on your machine for this server.
- Key the following command at any command line, replacing xxx with the actual
ID for the server directory entry you just added:
WRKRSFCAT SERVER(xxx)
When you press Enter, the Work With RSF Catalog display is presented.
- Press F15 to request an updated catalog from the server machine. The request should take under five minutes to process.
When the request completes, catalog information for the server is available on your machine. If the request ends in error, follow the procedure outlined in the Problem Determination chapter.
- Find the package that you want to access in the list.
Key an "8" to the left of the entry for the package and press Enter. A request for the package will be sent to the server. If you have not changed the defaults, the package will be placed in a save file in library QGPL. The save file will have the same name as the package you are accessing.
If the package contains an automatic installation program, RSF will run the program to install the package automatically.
Any cover letter associated with the package will be placed on your job default output queue.
The simplest way to send an object to another machine is to use the Send Objects Using RSF (SNDOBJRSF)
command provided in library RSFTOOLS.
To send program ABC in library QGPL to another machine with the SNDOBJRSF command, follow these steps:
- Display the SNDOBJRSF command prompt by either:
Selecting option 6 from RSF menu
Or by keying SNDOBJRSF at any command line and pressing F4.
- When the command prompt is displayed, fill in the name and library of the objects you want to send, the library to which the objects should be sent on the remote machine, and the
server ID of the remote machine to be contacted. When you press Enter, the objects are saved, transmitted and restored to the library you specified on the remote machine.
In this example, program ABC is sent to a location referred to as CINCINNATI. A server directory for CINCINNATI was added previously, defining the phone number
and other connection information for the location.
The simplest way to send a file member to another machine is to use the Copy File Using RSF (CPYFRSF) command.
Note, however, that if the file is large, or if you will be sending the same file repeatedly to one or more remote locations, it is more efficient to use the Send RSF Package (SNDRSFPKG) command. See Sending Packages for more information.
To send all members that begin with "A" in file MYFILE in library QGPL, follow these steps:
- Display the CPYFRSF command prompt by either:
Selecting option 7 from the main RSF menu
Or by keying CPYFRSF at any command line and pressing F4.
- When the command prompt is displayed, specify *SND for "Send or receive data", and fill in the name, library and member name of the file to be sent. You must also specify the
server id of the remote machine to be contacted. When you press Enter, the file members are transmitted to the remote machine. If the target file or members do not exist on the remote machine, they are created.
In this example, file MYFILE is sent to a location referred to as NEWYORK.
A server directory for NEWYORK was added previously, defining the phone and
other connection information for the location.