Chapter 5 - Technical reference

5.1 - WM files

Filename

Description

addressb-add.wm

Add to AddressBook page.

addressb-table.wm

AddressBook table.

addressb.wm

AddressBook listing page.

attachment-no.wm

No attachment text.

attachment-table.wm

Attachment table

attachment-yes.wm

Attachment exists.

composeemail.wm

Compose email.

footer.wm

Footer html.

header.wm

Header html.

help.wm

Help button html.

jump-table.wm

Jump email page table.

listemails-table.wm

List emails table.

listemails.wm

List emails main html page.

loginerror.wm

Access denied page.

newuser-thankyou.wm

Page displayed after new user registration.

newuser.wm

New User Registration page.

nomail.wm

No mail text.

priority-high.wm

High priority text.

priority-low.wm

Low priority text.

priority-normal.wm

Normal priority text.

reademail.wm

Read email page.

reply.wm

Reply email page, includes dual To: field.

servererror.wm

Server Error page.

userlogin.wm

User login page.

userlogin2.wm

User login page for New User Registration feature.

5.2 - WM file variables

Variable

Location

Description

*!WMVERSION!*

Anywhere

WebMail/2 logo name

*!WMUSER!*

Anywhere

User email ID, effective after user login.

*!WMPASS!*

Anywhere

User password, only used for administration, effective after user login.

*!WMFILENAME!*

Anywhere

The actual CGI filename (webmail2.cmd), reported by SCRIPT_NAME environment.

*!WMEMAILNUM!*

Inbox, Read

The number represents a specific email on the email server.

*!WMEMAILFROM!*

Inbox, Read, Compose

Email source address (From: field).

*!WMEMAILSUBJECT!*

Inbox, Read, Compose

Email subject (Subject: field)

*!WMEMAILDATE!*

Inbox, Read

Email date (Date: field)

*!WMEMAILBODY!*

Read, Compose

The body of the email while reading, or replying.

*!WMEMAILTABLE!*

Inbox

Table listing emails on email server.

*!SERVERERROR!*

Anywhere

If there is an error, this variable is initialized.

*!WMATTACHMENT!*

Inbox, Read

Shows attachment status.

*!WMEMAILPRIORITY!*

Inbox, Read

Show email priority level.

*!WMAUTHID!*

Anywhere

Unique ID number set by cookies, effective after user login.

*!WMATTACHMENTSTABLE!*

Read

List of file attachments.

*!WMATTACHFILE!*

Attachment Table

Attachment filename.

*!WMJUMPTABLE!*

Inbox

Page numbers of email pages.

*!WMJUMPPAGE!*

Jump Table

Page number.

*!WMPREVEMAILNUM!*

Read

Previous email number.

*!WMNEXTEMAILNUM!*

Read

Next email number

*!WMEMAILCC!*

Compose

List of emails for Cc: field, separated by spaces.

*!WMEMAILREPLYTO!*

Compose

Replaced with the From: email when Reply-To: exists.

*!WMPAGE!*

Anywhere

Points to the current Inbox page.

*!WMTOTALSIZE!*

Inbox

Total size (kb) of emails in the account.

*!WMADDRBTABLE!*

AddressBook

Table listing AddressBook entries.

*!WMADDRBALIAS!*

AddressBook

The alias for this AddressBook entry.

*!WMADDRBNAME!*

AddressBook

The name for this AddressBook entry.

*!WMADDREMAIL!*

AddressBook

The email for this AddressBook entry.

5.3 - JunkSpy

Application

URL

JunkSpy 2.0 or later

www.junkspy.com

JunkSpy is a junk mail detector for OS/2. It runs between WebMail/2 and the POP3 server. When an email is detected as junk the body of the email is replaced with an appropriate message telling the user that the particular email is junk.

Bellow are the instructions to configure JunkSpy with WebMail/2.

1) Install JunkSpy, version 2.0 or later.

2) Start JunkSpy. If you have a POP3 server running on the same machine you'll get an error that JunkSpy couldn't bind the TCP port, that is not a problem, ignore the error.

3) Right-click on JunkSpy and select Settings->Post Office.

4) At the top of the window, section "Servers", enter the IP address of the machine running your POP3 and SMTP servers. Those are the same addresses that you use in WebMail/2 under the WebManager settings.

5) At the bottom of the window enable "Local Connection", and enter in the "Listen Port" section the number 111. If you have something else using TCP port 111 then enter a free TCP port number.

6) Again right-click on JunkSpy and select Settings->Detector.

7) At the "Action" settings select "Destroy Message". You might also want to disable the External Detectors if you are on dialup.

8) Start WebManager go to the "Settings - Page 1". At the "POP3/SMTP Servers" section change the IP address and Port number of the POP3 server to point to the IP and Port of the machine running JunkSpy. The port number is the same as the one entered under the "Local Connection" in JunkSpy.

9) Restart JunkSpy and WebManager for the settings to take effect.

It's strongly suggested to use JunkSpy at the same machine as your email server and to use the local loopback (127.0.0.1) address for communications between the two programs and the email server for improved performance.