Skip to main content  
        iSeries home   |   Easy400  
Why this utility
Basic Operations
 Advanced operations

Advanced WRKVLDL operations

WRKVLDL provides further functions if the utility MMAIL is installed.

Fixing existing validation lists
If you were already using the utility WRKVLDL to maintain validation lists before that WRKVLDL started interfacing MMAIL (January 2015), the existing validation lists were missing some useful information, such as the e-mail addresses of users. Support of user e-mail addresses is important, because it allows an user to receive his login credentials via e-mail messages.
If you want to add e-mail addresses to the existing validation list entries, you may do that from a green screen workstation by running command WRKVLDL/FIXLIBL.
This command requires a validation list name be specified. It then allows you to go through the validation list entries and to add the person names and their e-mail addresses.

Receiving login credentials by e-mail
A very common case is when an Internet user does not recall his username/password. The following shows how this case can be helped out.
Once a validation list is equipped with e-mail addresses for each entry, you can provide some WEB feature that allows an user to receive by e-mail his login credentials.
What you need, is a WEB program (for instance a CGI) that runs command WRKVLDL/GETCREDS. This command has a single parameter, the user e-mail address. It then goes across all the validation lists created through WRKVLDL and sends the user a mail message containing the existing login credentials (username and password) for each validation list reporting that e-mail address.
Of course command WRKVLDL/GETCREDS can also be run from a green screen workstation.

Password reset
When the access to a website is protected through username/password, it may happen that a user, while remembering his user name, does not recall the related password. In such a case, the site developer may provide some tool to solve the problem. Usually the solution works as follow:

  1. The user is allowed to reset his password,
  2. As soon as the user resets his password, a mail message is sent to his e-mail address. The message contains a link.
  3. When the user reads the message and clicks the link, he gets a screen where he can define a new password.
  4. After defining his new password, the user may use it to access again the website.
The following tells how you can implement this support using the WRKVLDL utility, provided that also the MMAIL utility is installed.

  1. In your WEB page you should provide a "password reset" button as follow:
    <input type="hidden" name="xvldlname" value="vldl name"> <input type="hidden" name="xvldlib" value="vldl library name"> <input type="hidden" name="xusrname" value="vldl username for this user"> <input type="submit" value="password reset"> </form>

  2. When the user presses the button "password reset", the page in Figure 12 appears:
    The user types in his username ("Johnny", in the example) and presses the "go" button.
    Figure 12 - Start password reset
    The user will then receive a screen (see Figure 13) saying that an-email message was sent to his e-mail address.
    Figure 13 - Password was reset

  3. When the user checks his mail, he will see the following message:
    Figure 14 - E-mail message received by the user

  4. When the user clicks on the link "set new password", he receives the WEB page in Figure 15:
    Figure 15 - Set the new password
    When the user types in a new password of his choice and presses the "go" button, a confirmation screen is displayed:
    Figure 16 - The new password was set

    and if the user presses the "mail it to me" button, then a reminder message is sent to his e-mail address.

In order to include the above process in your website, you may need to get a little practice on it, so that you understand better the HTML you have to set. This practice you can get starting with the URL:
    http://yourIPaddress/wrkvldlp/resetask.pgm .

previous page
next page