         Welcome to SEAGULL Print File Server


1 Installing the SEAGULL Print File Server on the iSeries 400

This file only contains instructions for installing the Print File Server.
The installation of this Print File Server is required for the Client
Print feature when users authorization is declared with limited capabilities.


IMPORTANT
=========
SEAGULL iSeries 400 products have the option to be automatically
installed to your iSeries 400 when using TCP/IP (required).
If you choose to use this feature, simply start the automatic
install procedure and follow the provided instructions.
If you wish to follow the traditional manual installation
approach, specify a working directory and proceed following
the Manual Install instructions provided within this document.


1.1 Before installing
Before installing the SEAGULL Print File Server, you should check
the following points.

1.1.1 OS/400
This installation covers both RISC (V3R7 and higher) and non-RISC
(V3R1 and higher) installation.

1.1.2 PTF
If your iSeries 400 is running OS/400 V3R1, check that PTF MF 09253 is
installed, otherwise the installation procedure may fail.

1.1.3 iSeries 400 shared folder
If you are using Client Access (and you want to do a manual
install as described in 1.2) and have not yet connected to the
iSeries 400s shared folders for installing, it will be necessary for
you to connect DRIVE I: to the iSeries 400 system folder called QDLS.
The connection will look something like: \\NLSBSD35\QDLS.

1.1.4 FTP over TCP/IP
If you are using TCP/IP connections between your PC and the
iSeries 400(s), you can connect and transfer the SEAGULL
Print File Server software installation by using the
File Transfer Protocol (FTP).

1.1.5 Connecting Client/Server to Print File Server over TCP/IP.
Both Client/Server and Print File Server daemon need to know which
PORT to use for the connection. They both have a default value of 1025.
If this value conflicts with another TCP/IP application, then
this default port can be changed as follows.

On the iSeries 400
     - Use WRKSRVTBLE to add a table entry for service 'seapfs'
       using protocol 'tcp'. It is advisable to do this even if the
       default port is used. This allows WRKTCPSTS to give the port
       name.
       It also ensures that when another service is installed, it
       can be seen in the services file that this port is already
       in use.
     - It is also possible to specify another PORT when starting the
       PFS daemon by specifying PORT(xxxx) at STRLMSTCP command.

     Determining PORT to be used:
     a) If PORT(xxxx) specified at STRLMSTCP, use port 'xxxx',
     b) else if PORT(*DFT), look for 'sealms' entry in SERVICES file
     c) else use default port 1025.


On the PC
     - Add an entry to the SERVICES file for protocol 'seapfs'
       using protocol 'tcp'. It is advisable to do this even if the
       default port is used. This makes centralized maintenance
       possible.
     - It is also possible to specify another PORT in the used
       section of Client/Server's INI file, or on the command line
       using the parameter 'TcpIpLicensePort='.

     Determination PORT to be used:
     a) If parameter '/GTcpIpLicensePort=xxxx' specified on
        commandline, use port 'xxxx',
     b) else if 'TcpIpLicensePort=yyyy' is specified in used
        section of INI file, use port 'yyyy'
     c) else look for 'seapfs' entry in SERVICES file,
     d) else use default port 1025.


1.1.6 Connecting Client/Server to Print File Server (PFS)
      over SPX/IPX.
On the iSeries 400 you must use WRKSRVTBLE to add a table entry for
service 'seapfs-x' using protocol 'spx'.

1.2 Manual Installation of the SEAGULL PFS (via shared folder)

The SEAGULL PFS is delivered on CD-ROM or diskette.
In order to install this, the security officer should
have a PC connected to the iSeries 400 using PC-Support with
the shared folders function enabled. In the following instructions,
it is assumed that the installation disk is in drive A: and that the
shared folders are on drive I:. This installation procedure has been
found to be suitable for about 90% of customers. If the procedure
fails due to high security or accounting limitations, then you
should try the alternate installation procedure as described in
section 1.3.

For the normal installation procedure, follow these steps :

1.   Log on as QSECOFR.

2.   Go to the Print File Server on the SEAGULL CD or
     first diskette and select SETUP.EXE.

     This installation program copies all the necessary files
     into the shared folder (i.e. I:\TEMP).

3.   On the iSeries 400 the following CL commands should be executed.

     Note that you should do this as QSECOFR. If you use another
     userid then please make sure that this userid has the necessary
     authorizations
          (*IREXX and *BREXX are needed to execute PFSINS).

          CRTSRCPF FILE(QTEMP/QREXSRC)

          CPYFRMPCD FROMFLR(TEMP) TOFILE(QTEMP/QREXSRC)
             FROMDOC(PFSINS.BIN) TOMBR(PFSINS)

          STRREXPRC SRCMBR(PFSINS) SRCFILE(QTEMP/QREXSRC)

          DLTF FILE(QTEMP/QREXSRC)

     On completion, the following message should appear.

     "SEAGULL PRINT FILE SERVER IS INSTALLED IN LIBRARY SEAPFS"

     The SEAGULL Print File Server is now installed.

     NOTE:
     If an error occurs, then you should try the alternate
     installation procedure in section 1.3.


4.   Delete temporary files.

     On the PC the files may be deleted from the directory TEMP and
     the directory may be deleted.

          Example:  DEL I:\TEMP\*.*
                    RD I:\TEMP

1.3 Alternate installation procedure (via shared folder).

In the alternate installation procedure, CL commands are used where
possible. This means that you can understand what is being done and
take corrective steps where necessary. The only step that cannot be
done using CL commands is the conversion of the database file to a
save file.  To do this a simple REXX procedure is used.

For the alternate installation procedure, follow these steps :


1.   Log on as QSECOFR.

2.   Go to the Print File Server on the SEAGULL CD or
     first diskette and select SETUP.EXE.

     This installation program copies all the necessary files
     into the shared folder (i.e. I:\TEMP).

3.   On the iSeries 400 the following CL commands should be executed.

     Note that you should do this as QSECOFR. If you use another
     userid then please make sure that this userid has the necessary
     authorizations:
          *IREXX and *BREXX are needed to execute CPYSAVF.

          CRTSRCPF FILE(QTEMP/QREXSRC)

          CPYFRMPCD FROMFLR(TEMP) TOFILE(QTEMP/QREXSRC)
             FROMDOC(CPYSAVF.BIN) TOMBR(CPYSAVF)

          CRTSAVF FILE(QTEMP/PFSSAVF) AUT(*ALL)

          CRTPF FILE(QTEMP/PFSTEMP) RCDLEN(528) MBR(*FILE)
             MAXMBRS(*NOMAX) SIZE(*NOMAX) CCSID(*HEX) ALWUPD(*YES)
             AUT(*ALL)

          If this is a first time installation, create the SEAPFS
          library:

          CRTLIB LIB(SEAPFS)
             TEXT('SEAGULL PRINT FILE SERVER')
             AUT(*CHANGE) CRTAUT(*CHANGE)


          continue here:

          When you are installing on OS/400 V3R7 or higher:

          CPYFRMPCD FROMFLR(TEMP) TOFILE(QTEMP/PFSTEMP)
             FROMDOC(SEAPFSV7.BIN) TOMBR(*FIRST) MBROPT(*REPLACE)
             TRNTBL(*NONE) TRNFMT(*NOTEXT)

         or, when you are installing on OS/400 V3R1 or higher:

         CPYFRMPCD FROMFLR(TEMP) TOFILE(QTEMP/LMSTEMP)
         FROMDOC(SEAPFSV2.BIN) TOMBR(*FIRST) MBROPT(*REPLACE)
         TRNTBL(*NONE) TRNFMT(*NOTEXT)

         continue here:

        STRREXPRC SRCMBR(CPYSAVF) SRCFILE(QTEMP/QREXSRC)
        PARM('PFSTEMP PFSSAVF')

        RSTOBJ OBJ(*ALL) SAVLIB(SEAPFSREL) DEV(*SAVF) OBJTYPE
        (*ALL)SAVF(QTEMP/PFSSAVF) OPTION(*ALL) FILEMBR((*ALL *ALL))
         MBROPT(*ALL) ALWOBJDIF(*ALL) RSTLIB(SEAPFS)
         RSTASP(*SAVASP) OUTPUT(*NONE)

     At the end you should see a message like:
          "xxx objects restored from SEAPFSREL to SEAPFS"


     Tidy up:

          DLTF FILE(QTEMP/QREXSRC)

          DLTF FILE(QTEMP/PFSTEMP)

          DLTF FILE(QTEMP/PFSSAVF)

4.   Delete temporary files.

     On the PC the files may be deleted from the directory TEMP
     and the directory may be deleted.

          Example:  DEL I:\TEMP\*.*
                    RD I:\TEMP

1.4 Manual Installation procedure (on TCP/IP).

1.   Log on as QSECOFR.

2.   Go to the License and Message Server on the SEAGULL CD or
     first diskette and select SETUP.EXE.

     This installation program copies all the necessary files
     into the shared folder (i.e. C:\TEMP).

3.   On the iSeries 400 the following CL commands should be executed.

     Note that you should do this as QSECOFR. If you use another
     userid, please make sure that this userid has the necessary
     authorizations:
          *IREXX and *BREXX are needed to execute CPYSAVF

          CRTLIB LIB(TMPLIB)

          CRTSRCPF FILE(TMPLIB/QREXSRC)

          CRTPF FILE(TMPLIB/PFSTEMP) RCDLEN(528) MBR(*FILE)
             MAXMBRS(*NOMAX) SIZE(*NOMAX) CCSID(*HEX) ALWUPD(*YES)
             AUT(*ALL)

4.  On your local PC, the following commands should be executed:

          Go to the directory where you installed the SEAGULL PFS
          on your PC:

              C:
              CD \TEMP

          Start your File Transfer Protocol Software:
              FTP

          Now the FTP program will start. Connect to your iSeries 400
          system. In most FTP versions, this can be done by typing:
              OPEN

          Now, the program will ask you the system name you want to
          connect to and which user-name and password to use. Make
          sure to connect to your iSeries 400 as QSECOFR. After you
          typed the system name, user-name (QSECOFR) and password,
          you will see the FTP prompt. This prompt usually look
          like: ftp>

          Although there is a wide variety in FTP versions, each
          having its own user interface, the following commands
          should work in most FTP versions. After the ftp> prompt,
          type the following:
              CD TMPLIB

          If your FTP version doesn't support this command, use
          CHDIR TMPLIB instead.

          Type:
              ASCII

          or another command that will put FTP in ASCII mode.
          Then type:
              SEND

          FTP now will ask for the local filename (the file on
          your PC) and the remote filename (the file on the iSeries 400).

          The local filename should be: C:\TEMP\PFSINS.BIN
          The remote filename should be: QREXSRC.PFSINS
              SEND

          The local filename should be: C:\TEMP\PFSINS2.BIN
          The remote filename should be: QREXSRC.PFSINS2

          Now, the file will be transferred to your iSeries 400. After
          this, type:
              BINARY

          Or another command that will put FTP in BINARY mode.
          Now type:
              SEND

          FTP will ask for a local and a remote filename again.

          The local filename should be C:\TEMP\SEAPFSV2.BIN
          The remote filename should be PFSTEMP.SEAPFSV2
              SEND

          FTP will ask for a local and a remote filename again.

          The local filename should be C:\TEMP\SEAPFSV7.BIN
          The remote filename should be PFSTEMP.SEAPFSV7

          When the file is transferred, you can leave FTP by typing:
              QUIT

5.  After the files are transferred to the iSeries 400, you should type
    the following commands on your iSeries 400:

    Again, please note you should do this as QSECOFR.

          STRREXPRC SRCMBR(PFSINS) SRCFILE(TMPLIB/QREXSRC)
             PARM('TMPLIB')

     If during execution next message appears:

          "Start of terminal session."
          "Error in line xxx: Invalid character in program."
          "Press ENTER to end terminal session."

     The FTP file transfer has added an extra line to both REXX
     source files PFSINS and PFSINS2. Remove these lines by means
     of an iSeries 400 editor and give the following command again:

          STRREXPRC SRCMBR(PFSINS) SRCFILE(TMPLIB/QREXSRC)
             PARM('TMPLIB')

     On completion, the following message should appear.

 "SEAGULL PRINT FILE SERVER IS INSTALLED IN LIBRARY SEAPFS"

     The SEAGULL Print File Server is now installed.

          DLTLIB LIB(TMPLIB)

6.   Delete temporary files.

     On the PC the files may be deleted from the directory TEMP and
     the directory may be deleted.

          Example:  DEL C:\TEMP\*.*
                    RD C:\TEMP



If you have any questions or suggestions for enhancements then
please contact your local supplier, Rocket Seagull Office, or
Rocket Seagull's Headquarters directly:

                   ROCKET SEAGULL
           http://seagull.rocketsoftware.com/


