Slipstream

Installing

If you downloaded Slipstream from the Internet, or received the product via e-mail, you will have received a zip file called STMEXPV4R1.ZIP. This zip file contains everything you need to get started with Slipstream.

This section describes two possible procedures for installing Slipstream on your iSeries, one using FTP and one using the IFS and a network drive. 

Steps to be carried out on the PC are shown in green, steps to be carried out on the iSeries in blue.

Method 1: Installing Slipstream using FTP

This method uses FTP (File Transfer Protocol) to transfer the Slipstream product files from your PC to your iSeries. It is assumed that you have stored the STMEXPV4R1.ZIP file which your downloaded from the Internet or received via e-mail on your PC and that you have enabled an FTP link between your PC and your iSeries.

Step 1

On your PC, create an install directory for Slipstream, either within Windows Explorer, or from the DOS prompt, e.g.:

          md c:\STMEXP

Save or copy the zip file that you downloaded or received into this directory.

Step 2

On your PC, unzip the contents of the zip file into the directory you just created using pkunzip, WinZip, Norton UnZip etc.

Step 3

On your iSeries, decide which library you wish to use for the install procedure and create a save file in that library, e.g.

            crtsavf lib_name/STMEXP

where lib_name is the name of the library you chose to use.

Step 4

On your PC, start an FTP session to your iSeries. You may use FTP packages such as CuteFTP or simply go to the DOS prompt and type:

ftp AS400_name

where AS400_name is the name of your iSeries.

You will be prompted to enter your user id and password. Please ensure that you sign on with a user id that has adequate authority. We recommend that you sign on as the Security Officer QSECOFR.

Issue the following FTP commands within the FTP session:

          binary

This command instructs FTP not to carry out any conversion on the data to be sent to the iSeries.

          quote site na 0

This makes sure the iSeries is using naming format 0 (library naming). This is important if your FTP attributes (CHGFTPA command NAMEFMT parameter) have the initial naming format set to *PATH (IFS path naming) rather than *LIB (library/file.member naming).

          cd lib_name

where lib_name is the name of the library in which your created the save file in Step 3. This command makes lib_name your current library on the iSeries.

          lcd dir_name

where dir_name is the name of the directory on your PC in which you unzipped the install files earlier. This command makes dir_name your current directory on the PC.

          put STMEXPV4R1.sav STMEXP

This command transmits the contents of the file STMEXPV4R1.sav, which was earlier unzipped from STMEXPV4R1.zip, and stores them in the save file called STMEXP which you created earlier on your iSeries.

Step 5

On your iSeries, ensure that the previous step worked by displaying the contents of save file STMEXP:

            dspsavf lib_name/STMEXP

If you see the message (No records in save file) then something has gone wrong during the preceding steps. Try following them again. If you still cannot get this procedure to work, contact us at support@ariadnesoftware.co.uk.

Step 6

On your iSeries, issue the following command to restore the Slipstream licensed program to your system:

rstlicpgm           licpgm(4STMEXP)

                             dev(*savf)

                             option(*base)

                             rstobj(*all)

                             lng(*primary)

                             output(*none)

                             rls(*first)

                             replacerls(*only)

                                      savf(lib_name/STMEXP)

where lib_name is the name of the library in which your created the save file in Step 3.

Step 7

If you have downloaded Slipstream from the Internet, you can use the product without a license key for up to 30 days. At the end of that period Slipstream will notify you that it can no longer be used without a license key.

To obtain a license key contact ariadne at sales@ariadnesoftware.co.uk.

If you have been issued with a license key, proceed as follows.

On your iSeries, issue the following command to add a license key to enable you to use the Slipstream licensed program:

            addlickey           lickeyinp(*prompt)

prdid(4STMEXP)

licterm(V4R1)

feature(5001)

serial(*local)

prcgrp(Ppp)

lickey(XXXXXX YYYYYY ZZZZZZ)

usglmt(*nomax)

expdate(exp_date)

                                      vnddta(*none)

 

where:                 

 

XXXXXX YYYYYY ZZZZZZ is the license key you received by  e-mail from us

exp_date is the expiry date mentioned in the e-mail

Ppp is the processor group mentioned in the e-mail

Slipstream is now ready for you to use!

If you have any trouble at any point in this procedure, please contact us by e-mail at support@ariadnesoftware.co.uk.

Method 2: Installing Slipstream using the IFS

This method uses a Client Access network drive assigned to the IFS of your iSeries to transfer the Slipstream product files from your PC to your iSeries. It is assumed that you have stored the STMEXPV4R1.zip file (which your downloaded from the Internet or received via e-mail) on your PC. If you have a file called STMEXP.zip you probably have the install file for an older version of Slipstream, but you can still follow the procedures described below.

Step 1

On your PC, create an install directory for Slipstream, either within Windows Explorer, or from the DOS prompt, e.g.:

md c:\PC_dir

where PC_dir is the name of the directory you wish to use for this installation.

Save or move the zip file that you downloaded or received into this directory.

Step 2

On your PC, unzip the contents of the zip file into the directory you just created using pkunzip, WinZip, Norton UnZip etc.

Step 3

On your PC, ensure that you have a network drive assigned to a directory in the root file system of your iSeries’s IFS. This can be done in Windows Explorer by selecting Tools, Map Network Drive.

Create a directory in the IFS to receive the Slipstream files. This can be done in Windows Explorer by selecting File, New, Folder, or at the DOS prompt as follows:

md i:\IFS_dir

where I: is the network drive assigned to your iSeries and IFS_dir is the name of the directory you wish to use for this installation.

Step 4

Copy the contents of your PC’s install directory created in Step 1 above to the IFS directory created in Step 3 above using Windows Explorer, or from the DOS prompt as follows:

copy c:\PC_dir\*.* I:\IFS_dir

where PC_dir is the name of the directory on your PC, I: is the network drive assigned to your iSeries and IFS_dir is the name of the directory you wish to use for this installation.

Step 5

On your iSeries, decide which library you wish to use for the install procedure and create a save file in that library, e.g.

crtsavf lib_name/STMEXP

where lib_name is the name of the library you chose to use.

Step 6

On your iSeries, copy the contents of the STMEXPV4R1.sav file from the IFS directory to the save file just created, by issuing the following command:

cpyfrmstmf        fromstmf(‘/IFS_dir/STMEXPV4R1.sav’)

tombr(‘/qsys.lib/lib_name.lib/STMEXP.file’)

mbropt(*replace)

cvtdta(*none)

endlinfmt(*fixed)

tabexpn(*no)

where IFS_dir is the name of the IFS directory into which you copied the install files in Step 4 above, and lib_name is the name of the library in which you created the save file in Step 5 above.

(If you have a file called STMEXP.sav rather than STMEXPV4R1.sav, you probably have the install file for an older version of Slipstream, but you can still follow the procedures described below).

Step 7

On your iSeries, ensure that the previous step worked by displaying the contents of save file STMEXP:

dspsavf lib_name/STMEXP

where lib_name is the name of the library in which your created the save file in Step 5.

If you see the message (No records in save file) then something has gone wrong during the preceding steps. Try following them again. If you still cannot get this procedure to work, contact us at support@ariadnesoftware.co.uk.

Step 8

On your iSeries, issue the following command to restore the Slipstream licensed program to your system:

rstlicpgm           licpgm(4STMEXP)

                             dev(*savf)

                             option(*base)

                             rstobj(*all)

                             lng(*primary)

                             output(*none)

                             rls(*first)

                             replacerls(*only)

                                      savf(lib_name/STMEXP)

where lib_name is the name of the library in which your created the save file in Step 5.

Step 9

If you have downloaded Slipstream from the Internet, you can use the product without a license key for up to 30 days. At the end of that period Slipstream will notify you that it can no longer be used without a license key.

To obtain a license key contact ariadne at sales@ariadnesoftware.co.uk.

If you have been issued with a license key, proceed as follows.

On your iSeries, issue the following command to add a license key to enable you to use the Slipstream licensed program:

            addlickey           lickeyinp(*prompt)

prdid(4STMEXP)

licterm(V4R1)

feature(5001)

serial(*local)

prcgrp(Ppp)

lickey(XXXXXX YYYYYY ZZZZZZ)

usglmt(*nomax)

expdate(exp_date)

                                      vnddta(*none)

 

where:                 

 

XXXXXX YYYYYY ZZZZZZ is the license key you received by  e-mail from us

exp_date is the expiry date mentioned in the e-mail

Ppp is the processor group mentioned in the e-mail

Slipstream is now ready for you to use!

If you have any trouble at any point in this procedure, please contact us by e-mail at support@ariadnesoftware.co.uk.

Installing a Program Temporary Fix (PTF)

Method 1: Installing a PTF using FTP

This method uses FTP (File Transfer Protocol) to transfer the PTF file from your PC to your iSeries. It is assumed that you have stored the zip file which your downloaded from the Internet on your PC and that you have enabled an FTP link between your PC and your iSeries.

Step 1

On your PC, create a directory for the PTF installation, either within Windows Explorer, or from the DOS prompt, or re-use the directory you used to install originally, e.g.:

          md c:\STMEXP

Save or copy the zip file that you downloaded or received into this directory.

Step 2

On your PC, unzip the contents of the zip file into the directory you just created using pkunzip, WinZip, Norton UnZip etc.

Step 3

On your iSeries, first sign off then sign back on again to ensure that you do to have any Slipstream objects in your QTEMP library. Then decide which library you wish to use for the PTF install procedure and create a save file in that library. The name of this save file should be Q3SXnnnn, where nnnn is the PTF id, e.g.

            crtsavf lib_name/Q3SX0001

where lib_name is the name of the library you chose to use.

Step 4

On your PC, start an FTP session to your iSeries. You may use FTP packages such as CuteFTP or simply go to the DOS prompt and type:

ftp AS400_name

where AS400_name is the name of your iSeries.

You will be prompted to enter your user id and password. Please ensure that you sign on with a user id that has adequate authority. We recommend that you sign on as the Security Officer QSECOFR.

Issue the following FTP commands within the FTP session:

          binary

This command instructs FTP not to carry out any conversion on the data to be sent to the iSeries.

          quote site na 0

This makes sure the iSeries is using naming format 0 (library naming). This is important if your FTP attributes (CHGFTPA command NAMEFMT parameter) have the initial naming format set to *PATH (IFS path naming) rather than *LIB (library/file.member naming).

          cd lib_name

where lib_name is the name of the library in which your created the save file in Step 3. This command makes lib_name your current library on the iSeries.

          lcd dir_name

where dir_name is the name of the directory on your PC in which you unzipped the install files earlier. This command makes dir_name your current directory on the PC.

          put Q3SXnnnn.sav Q3SXnnnn

This command transmits the contents of the file Q3SX0001.sav, which was earlier unzipped from Q3SX0001.zip, and stores them in the save file called Q3SXnnnn which you created earlier on your iSeries.

Step 5

On your iSeries, ensure that the previous step worked by displaying the contents of save file Q3SXnnnn:

            dspsavf lib_name/Q3SXnnnn

If you see the message (No records in save file) then something has gone wrong during the preceding steps. Try following them again. If you still cannot get this procedure to work, contact us at support@ariadnesoftware.co.uk.

Step 6

On your iSeries, issue the following command to load the PTF on to your system:

lodptf                  licpgm(4STMEXP)

                             dev(*savf)

                             select(3SXnnnn)

                                      savf(lib_name/Q3SXnnnn)

where lib_name is the name of the library in which your created the save file in Step 3 and nnnn is the PTF id.

Step 7

On your iSeries, issue the following command to apply the PTF to your system:

            apyptf                 licpgm(4STMEXP)

                             select(3SXnnnn)

apy(*temp)

 

where:                 nnnn is the PTF

If you have any trouble at any point in this procedure, please contact us by e-mail at support@ariadnesoftware.co.uk.

Method 2: Installing a PTF using the IFS

This method uses a Client Access network drive assigned to the IFS of your iSeries to transfer the PTF from your PC to your iSeries. It is assumed that you have stored the PTF zip file (which your downloaded from the Internet or received via e-mail) on your PC.

Step 1

On your PC, create an install directory for the PTF, either within Windows Explorer, or from the DOS prompt, or use the directory you created for the original installation, e.g.:

md c:\PC_dir

where PC_dir is the name of the directory you wish to use for this installation.

Save or move the zip file that you downloaded or received into this directory.

Step 2

On your PC, unzip the contents of the zip file into the directory you just created using pkunzip, WinZip, Norton UnZip etc.

Step 3

On your PC, ensure that you have a network drive assigned to a directory in the root file system of your iSeries’s IFS. This can be done in Windows Explorer by selecting Tools, Map Network Drive.

Create a directory in the IFS to receive the PTF. This can be done in Windows Explorer by selecting File, New, Folder, or at the DOS prompt as follows:

md i:\IFS_dir

where I: is the network drive assigned to your iSeries and IFS_dir is the name of the directory you wish to use for this installation.

Step 4

Copy the contents of your PC’s PTF directory created in Step 1 above to the IFS directory created in Step 3 above using Windows Explorer, or from the DOS prompt as follows:

copy c:\PC_dir\*.* I:\IFS_dir

where PC_dir is the name of the directory on your PC, I: is the network drive assigned to your iSeries and IFS_dir is the name of the directory you wish to use for this installation.

Step 5

On your iSeries, first sign off then sign back on again to ensure that you do to have any Slipstream objects in your QTEMP library. Then decide which library you wish to use for the install procedure and create a save file in that library. The save file should be called Q3SXnnnn, where nnnn is the PTF id, e.g.

crtsavf lib_name/Q3SXnnnn

where lib_name is the name of the library you chose to use

and      nnnn is the PTF id.

Step 6

On your iSeries, copy the contents of the Q3SXnnnn.sav file (where nnnn is the PTF id) from the IFS directory to the save file just created, by issuing the following command:

cpyfrmstmf        fromstmf(‘/IFS_dir/Q3SXnnnn.sav’)

                             tombr(‘/qsys.lib/lib_name.lib/Q3SXnnnn.file’)

                             mbropt(*replace)

                             cvtdta(*none)

                             endlinfmt(*fixed)

                             tabexpn(*no)

where IFS_dir is the name of the IFS directory into which you copied the PTF files in Step 4 above, and lib_name is the name of the library in which you created the save file in Step 5 above.

Step 7

On your iSeries, ensure that the previous step worked by displaying the contents of save file Q3SXnnnn:

            dspsavf lib_name/Q3SXnnnn

If you see the message (No records in save file) then something has gone wrong during the preceding steps. Try following them again. If you still cannot get this procedure to work, contact us at support@ariadnesoftware.co.uk.

Step 8

On your iSeries, issue the following command to load the PTF on to your system:

lodptf                  licpgm(4STMEXP)

                             dev(*savf)

                             select(3SXnnnn)

                                      savf(lib_name/Q3SXnnnn)

where lib_name is the name of the library in which your created the save file in Step 3 and nnnn is the PTF id.

Step 9

On your iSeries, issue the following command to apply the PTF to your system:

            apyptf                 licpgm(4STMEXP)

                             select(3SXnnnn)

apy(*temp)

 

where:                 nnnn is the PTF

If you have any trouble at any point in this procedure, please contact us by e-mail at support@ariadnesoftware.co.uk.