Peek/400
========

The installation procedure consists of 2 steps. First you have to
upload the Peek/400 save file to your System i and then you need
to proceed with restoring the Peek/400 objects from the save file.

1. Uploading Peek/400 to your System i
======================================

1.1. Logon to your System i and create a save file:

        CRTSAVF FILE(QGPL/PEEK)

1.2. Open a DOS box, e.g. on a MS-Windows PC:

        cmd

1.3. Start FTP:

        FTP your.server.name

1.4. Enter user and password when being asked for it.

1.5. Switch to binary mode:

        binary

1.6. Transfer the save file to your System i:

        put PEEKnnn.SAVF qgpl/peek
		
     nnn = Peek/400 version number

1.7. Terminate FTP:

        quit

1.8. Exit the DOS box:

        exit


2. Restoring Peek/400
=====================

Please follow the steps at 2.1 or 2.2 depending on the special
authorities of your user profile. Users with limited authorities
must follow the steps at 2.2!

Follow 2.3 if you want to restore library PEEK into another library.

2.1. Users with sufficient authority, preferable SPCAUT(*ALLOBJ)
----------------------------------------------------------------

2.1.1. Logon to your System i and restore library PEEK:

          RSTLIB SAVLIB(PEEK) DEV(*SAVF) SAVF(QGPL/PEEK)

2.1.2. Execute command PEEKINIT if you want to switch
       to English (ENG), Spanisch (SPA) or Italian (ITA):

          ADDLIBLE PEEK
          PEEKINIT LANGUAGE(ENG)


2.2. Users with insufficient authority, missing SPCAUT(*ALLOBJ)
---------------------------------------------------------------

The following steps were tested and verified with a user
profile with USRCLS(*USER), SPCAUT(*NONE), GRPPRF(*NONE) and
GRPAUT(*NONE).

2.2.1. Logon to your System i and create library PEEK:

          CRTLIB LIB(PEEK) TEXT('Peek/400')

2.2.2. Restore the Peek/400 objects from the save file:

          RSTOBJ OBJ(*ALL) SAVLIB(PEEK) DEV(*SAVF)
            SAVF(QGPL/PEEK)
            OMITOBJ((PEEK *CMD) (TREE *CMD))

       You will receive messages like these:
       "131 security or data format changes occurred."
       "131 objects restored. 0 not restored to PEEK."

2.2.3. Add library PEEK to your library list:

          ADDLIBLE LIB(PEEK)

2.2.4. Create missing commands PEEK and TREE:

          PEEKINIT LANGUAGE(ENG)

       Possible languages are: GER, ENG, SPA, ITA.


2.3. Restoring Peek/400 into a different library
------------------------------------------------

The following steps were tested and verified with a user
profile with USRCLS(*USER), SPCAUT(*NONE), GRPPRF(*NONE) and
GRPAUT(*NONE).

2.3.1. Logon to your System i and create library PEEK:

2.3.2. Create a temporary library:

          CRTLIB LIB(PEEKTMP) TEXT('Peek/400')

2.3.3. Restore the Peek/400 objects from the save file:

          RSTOBJ OBJ(*ALL) SAVLIB(PEEK) DEV(*SAVF)
            SAVF(QGPL/PEEK)
            OMITOBJ((PEEK *CMD) (TREE *CMD))
            RSTLIB(PEEKTMP)

       You will receive messages like these:
       "131 security or data format changes occurred."
       "131 objects restored. 0 not restored to PEEK."

2.3.4. Add library PEEKTMP to your library list:

          ADDLIBLE LIB(PEEKTMP)

2.3.5. Ask your security officer to change the owner of
       library PEEKTMP and all objects of library PEEKTMP to your
       user profile.
       
       You may compile and use programs PEEK96A and PEEK96B for it:
       
          CALL PGM(PEEK96A) PARM('PEEKTMP' 'yourUserProfile')
       
       Note: Not required for users with sufficient authority.

2.3.6. Clone library PEEKTMP:

          CALL PGM(PEEKCLONE) PARM('PEEKFINAL' 'PEEKTMP')

2.3.7. Remove library PEEKTMP from your library list:

          RMVLIBLE LIB(PEEKTMP)

2.3.8. Add library PEEKFINAL to your library list:

          ADDLIBLE LIB(PEEKFINAL)

2.3.9. Create missing commands PEEK and TREE:

          PEEKINIT LANGUAGE(ENG)

       Possible languages are: GER, ENG, SPA, ITA.


3. Cloning Peek/400
===================

In case you want to run multiple version of Peek/400 in parallel,
you can clone a Peek/400 product library like this:

        ADDLIBLE PEEK
        CALL PEEKCLONE PARM('PEEKNEW' 'PEEK')

The first parameter is the name of the clone and the second
parameter is the name of the original Peek/400 product library.


4. Copying user settings and update programs
============================================

If you want to copy your user settings file and all update programs
to another Peek/400 product library, you can do it like this:

        ADDLIBLE PEEKOLD
        CALL PEEKUPDATE PARM('PEEKNEW' 'PEEKOLD')

The first parameter is the name of the target library and the second
parameter is the name of the source library.

07.08.2012, Thomas Raddatz