LOGINOUT requirements

• OS release V5R2 or subsequent
• ILE-RPG compiler
• library CGIDEV2
• System value QRETSRVSEC must be set to '1' to enable validation list data retrieval.

Download LOGINOUT

• Enter the Easy400 site www.easy400.net
• Select Downloads from the navigation bar: free registration required
• In the download page, look for LOGINOUT
• Save download file loginout.zip in a directory of your PC
• Unzip the loginout.zip to obtain two files:
  • readme.txt: read it
  • loginout.sav: this is the save file of library LOGINOUT to be installed on the iSeries

Install library LOGINOUT

1. On the iSeries, enter command:
   CRTSAVF QGPL/LOGINOUT AUT(*ALL)
2. On the PC
   1. Open a DOS prompt
   2. Position to the directory containing file loginout.sav
   3. Start FTP to your iSeries
   4. Enter the following commands:
      quote site namefmt 1
      cd /qsys.lib/qgpl.lib
      bin
      put loginout.sav loginout.savf
      quit
3. On the iSeries logon with a user profile having authority over user profile QPGMR and run command
   RSTLIB LOGINOUT *SAVF SAVF(QGPL/LOGINOUT)

Complete LOGINOUT installation
On the iSeries logon with a user profile having authority over user profile QPGMR and run the following commands
-CHGSYSVAL SYSVAL(QRETSVRSEC) VALUE('1')
to enable retrieving validation list data
-STRREXPRC SRCMBR(INSTALL) SRCFILE(LOGINOUT/QREXSRC)
This REXX procedure performs the following:

• Creates program LOGINOUT/COMPILE. This program is used to re-create the service program LOGINOUT/LOGINOUT and all LOGINOUT programs.
• Runs command LOGINOUT/COMPILE, which executes program LOGINOUT/COMPILE
• Runs command LOGINOUT/INSTALL (complete LOGINOUT installation). This command
  • restores IFS directory /loginout
  • creates validation list LOGINOUT/LOGINOUT

Install HTTP directives
To run LOGINOUT you must add some HTTP directives to the directives of an HTTP instance of your choice.
The http directives to be installed are in the stream file /loginout/apache .
They are as follow:

#=============================================================================== # LOGINOUT HTTP directives # # Add the following directives to the directives of an HTTP instance of your choice # (for instance you may add them to the directives of HTTP instance CGIDEV2APA, # stream file /cgidev/conf/httpd.conf ). # # To display the LOGINOUT manual, use URI /loginout/start . # #=============================================================================== AliasMatch ^/loginout/start$ /loginout/tutorial/start.htm Alias /loginout/ /loginout/ ScriptAliasMatch /loginoutp/(.*) /qsys.lib/loginout.lib/$1 <Directory /loginout> AllowOverride None Options None order allow,deny allow from all </Directory> <Directory /QSYS.LIB/LOGINOUT.LIB> Options +ExecCGI CgiConvMode %%EBCDIC/EBCDIC%% AllowOverride None Options None order allow,deny allow from all </Directory> <LocationMatch ^/loginoutp/wrkvldl(.*)$> AuthType Basic AuthName "LogInOut" PasswdFile %%SYSTEM%% UserID %%CLIENT%% Require valid-user </LocationMatch>

To test the HTTP instance just updated, run the following URL:
http://.../loginout/start
where

• "..." should be replaced by the iSeries IP_address:portnumber

What to do next

• To become acquainted with the LogInOut method, read the LogInOut approach and run the walkthrough example.
• When you feel appropriate for starting some development, go to chapter Application development learn, use and test results from command LOGINOUT/SETLIB.