How to RESTORE an iSeries Save File Received from ActionWare

(Revised 23 Feb 2006)

These instructions describe how to receive a PC file named AWTEMP.SAVF from ActionWare, save it to your PC's hard drive, use FTP to send it to a Save File on the iSeries, then finally how to restore it as a library named AWTEMP on your iSeries.

File Transfer Protocol (FTP) is an internet protocol available on virtually every platform, including the iSeries.

Sending the file to the iSeries requires that the FTP server be active on the iSeries. If you do not know if the FTP server is active, or how to activate it, discuss it with your iSeries administrator. The iSeries command to start the FTP server is:
STRTCPSVR SERVER(*FTP)

On rare occasions we may send you a file with a different name than AWTEMP.SAVF. If so, ActionWare support personnel will ensure you are aware of this. In this case, whereever the character string AWTEMP.SAVF appears throughout this document, simply replace it with the other name.

We normally distribute the Save File by having you download it from a web link we will provide. Sometimes we may send it to you as an email attachment. Receive the email and its attached file with your usual email program, for example Outlook Express. In either case, Save the file AWTEMP.SAVF to your PC's hard drive, you can store it anywhere on your PC, for example in directory C:\TEMP.

The next step is to use FTP to upload the file to the iSeries.

It is assumed you are using a PC running Windows 2000 or XP which has the capability of FTP'ing a file to the iSeries. If this is not so, you will need to transport the received file by some means to a PC which does have this capability.

The instructions below assume the file is named AWTEMP.SAVF and that it is currently located in directory C:\TEMP on the C: drive.

You are now ready to start the process of uploading the file to a new Save File on the iSeries.

On an iSeries session, create a mew save file in library AW4 named AWTEMP:
CRTSAVF AW4/AWTEMP AUT(*ALL)

On the PC running Windows 2000 or XP, go to a Command Prompt (DOS) Window.

Use Microsoft FTP to upload the file from C:\TEMP\AWTEMP.SAVF to the save file just created in library AW4.

FTP xxxxxxxx (where xxxxxx is the URL or IP address of your iSeries)
Sign on when requested, using your user id and password.

Enter the following FTP commands:

NOTES on FTP

(1) After you enter the "put" command, if you made a keying mistake, or there is some other reason why the file was not copied, the Microsoft FTP program does NOT give you an error message. Therefore, you must look for positive messages that the file was actually copied. After a successful copy, the FTP program displays statistics about how many bytes were transferred. If you don't see these statistics, then the file was not copied, and you must takes steps to find out why.

binary
cd /
put c:\temp\AWTEMP.SAVF /qsys.lib/aw4.lib/awtemp.file
quit

Go back to the iSeries session. The save file now exists in library AW4. Verify it was correctly uploaded by entering this command and ensure the Save File does contain some objects.
DSPSAVF AW4/AWTEMP

The next step is to restore library AWTEMP from the save file.

Check to ensure a library named AWTEMP does not already exist on the iSeries.
DSPLIB AWTEMP

If it does exist, rename or delete it.
RNMOBJ AWTEMP *LIB AWTEMP.001
or
DLTLIB AWTEMP

Now restore the library from the Save File.
RSTLIB AWTEMP *SAVF SAVF(AW4/AWTEMP)

After this command finishes executing, expect to get the completion message shown below. Any other message indicates a problem occurred, and you must takes steps to find out what went wrong.
(The object count 17 is used here for example only, and will be different in your case.)
"17 objects restored from AWTEMP to AWTEMP."

Library AWTEMP has now been restored to the iSeries. The objects in the library must now be used to update the ActionWare product.

The instructions up to this point have been generic.

You must now follow ActionWare's separate instructions on how to proceed from this point for the specific fix we have sent you. These will normally be sent separately, or in a simple case an ActionWare support person may simply tell you over the phone what it is you need to do with the contents of library AWTEMP.

HOUSEKEEPING

After several days have elapsed and the upgrade was successful, you should clean up by deleting:

. The downloaded file C:\TEMP\AWTEMP.SAVF on your PC using Windows Explorer, and

. The Save File and the temporary library on the iSeries.
DLTF AW4/AWTEMP
DLTLIB AWTEMP