PMICAL 2.50 March 2016

To install

1. Unzip all files from Pmicalnnn.zip into your Pegasus Mail executables directory (eg c:\pmail\Programs).
   For Network installs, check with your administrator for information on the location to use.
   Two dynamically created files, PMICAL.HTM and PMICAL.ICS will be created in your %TEMP% directory, when PMICAL is run.
2. Go into Pegasus Mail menu Tools/Options/Content Viewers
3. Add an entry for filename extension ".vcs" (and ".ics") and point to the location where PmIcal.exe was stored.
4. Try it out by going to a message attachment page in Pegasus Mail and clicking the "Open" button. You can also use PMIcal in Windows Explorer by drag and Dropping file onto PmIcal.exe. PMIcal also detects vCalendar files that are contained in the text version of a message.
5. If the vCalendar file requests a response (via RSVP=YES) then in the PMICAL menu, File/Reply Yes or Reply No can be clicked to either Accept or Decline the meeting request. and if Pegasus Mail is not running, you will be prompted to start Pegasus Mail. Pegasus Mail will immediately display the normal Compose Message screen, and will be filled in with the originator email address, the subject, and a brief message, which can be edited.
6. If the recipient of a request wants to send a message to the organizer, just click on the organizer email address, and if Pegasus Mail is not running, you will be prompted to start Pegasus Mail. Pegasus Mail will immediately display the normal Compose Message screen, and will be filled in with the originator email address and the subject, which can be edited to change the message.
7. Individual parts of the display can be Selected/Copied to the clipboard for use outside PMICAL.

Known issues:

None at present.

Notes:

• Both vCalendar Version 1 and 2 are supported, repeat rules are working.
• vCalendar streams that are embedded in the message body and not listed on the attachments dialog, can be extracted (select/copy) and saved as an ICS filetype. This file can then be opened (Drag/Drop) in Windows Explorer and presented to PMIcal for display
• Alternatively setting up a NewMail rule to detect and trigger on vCalendar streams. A sample rule is included in this distribution. The location of PmIcal.exe in the rule will probably need to be changed for example to c:\pmail\programs\pmical.exe. As incoming mail will only trigger the Newmail rule once, the resulting report will be saved to disk (as PmIcal.htm) for later review(s) or printing off.

Timezones (new)

Timezone information associated with the sender of the request, and the recipient are displayed. When the sender does not have Daylight Time, their Standard Time is used. For most of America and Europe the Daylight times are present. You can check the settings in PMICALTZ.TXT.

minor issues

The following files are detected and processed:
• Filetypes: .ICS and .VCS as attachments
• Filetypes: .PM$ , .CNM as complete messages

Not supported

• FREEBUSY requests
• Any commands that start with X-
• VTODO and VALARM command sets

Background information

VCALENDAR Url: VCALENDAR

Future versions:


I am planning to save meeting requests to a Sqlite database (Pmical.db). This will include loading of multiple iterations, where Repeat Rules are indicated, for Daily, Weekly, Monthly and Yearly events. Displaying the database content is not provided at this time.
I am planning to detect and display VToDo and VAlarm requests.
I am currently implementing detection and handling VTimeZone definitions, which may/will handle time changes that are different between sender and recipient machines. TimeDate information in the "Z" format (GMT/UTC) is already converted to recipient time zone. More information on this feature will be supplied when it is implemented

I would appreciate any feedback on issues etc

Martin Ireland
irelam@telus.net