HMF Tutorial: The HMF REMINDER Facility

Background -- Section 1 of 4

A REMINDER is an example of an HMF "personal event". Each userid may have an unlimited number of personal events. Reminder personal events trigger no more than once per day (system commands, such as CP Message, may trigger once every "hh:mm").

You can define, alter and delete your own reminders. A full-screen interface is available to work with reminders; use the HMF command to see this full-screen interface. There is also a programmers interface. However, in this tutorial, we'll exclusively use a third interface: the command-line interface.

HMF has a limited capability to allow you to work with the reminders of others. To enable this HMF capability, the HMF administrator (currently Wayne T. Smith -- WTS@Maine.edu) makes authorizing entries in various HMF system tables.

Syntax of related commands -- Section 2 of 4

To list all personal events

Query MYevent

displays your personal events.

FOR userid Query MYevent

displays all personal events for the specified userid.

Query MYevent SHOW ALL

displays your personal events with all attributes. (Some attributes such as TASKID are not listed via the default query output).

The format of a displayed REMINDER message is

hh:mm:ss Reminder: reminder_text

To cause HMF to send a REMINDER to an SVM instead of your console, the REMINDER should be set in the personal events of the SVM.

To define a new REMINDER personal event

REMinder AT time ON date reminder_text

defines a one-time or recurring reminder, depending on the format of "date".

where ...

time

is "hh:mm:ss" or "hh.mm.ss". Both forms cause an HMF REMINDER message to be sent to you at the specified time. Using the colon(:) format causes the message to be sent later, if you are not logged on at the specified time.

date

defines the day(s) that the one-time or recurring reminder will be sent to you.

The date may be expressed as ...

yy/mm/dd

With "yy/mm/dd", yy, mm, and/or dd may be replaced with an asterisk (*) to cause the reminder to recur.

*

With a date of "*", the reminder recurs daily, forever.

ddd or ddd*

If the date is MON, TUE, WED, ... the reminder is displayed once on the specified day. Adding an asterisk (*) to the day (MON*, etc.) causes the reminder to recur once every week on the specified day, forever.

dddn or dddn*

If the date is MON2, TUE3, WED4, ... the reminder is displayed once every month on the specified day of the specified week. Adding an asterisk (*) to the specification (MON1*, SAT3*, etc.) causes the reminder to recur once a month, forever.

LWD

The reminder recurs on the last working day of every month.

WD

The reminder recurs on every weekday (Monday through Friday).

WE

The reminder recurs on every weekend day (Saturday/Sunday).

If the "ON date" parameter is omitted, the Reminder will be sent (once) at the next occurance of "time".

The format of a displayed REMINDER message is

hh:mm:ss Reminder: reminder_text

To alter a REMINDER personal event

Use the "ALter refid" command. For more information, please see the HMF User's Guide and Reference book.

To remove/delete a personal event

DELete refid

discards the specified reminder. To obtain the "refid", use the "Query MYevent" command.

An example -- Section 3 of 4

Let's say we need a monthly reminder to help us remember to defragment our Windows desktop hard drive. This is easily accomplished with:

cp sm hmfserve at * reminder at 08:00 on lwd Defrag disk today!

References -- Section 4 of 4

• The HMF User's Guide and Reference (SG24-615-01) is available online. It may be viewed using the "Library reader for Windows" by going to the UNET directory "nwocc\caps\dos\docs\bookie\" directories. The "Windows" directory has the viewer program; the "Books" directory has the ".boo" format books.
• This book is also available via the internet at

  http://www.s390.ibm.com/bookmgr-cgi/bookmgr-cmd/Shelves/ACVA2A01

• The HMF Vendor home page may be viewed at

  http://www.vm.ibm.com/related/hmf/

• The CMS "HMF" command runs the full-screen interface. This interface has context-sensitive help via the F1 key. Type a slash (/) to select a menu item.

This is An Introduction to the HMF REMINDER facilities  

Go to An Introduction to the HMF CP Message facilities  

Go to An Introduction to the HMF XAUTOLOG facilities  

• Back to the UNET Admin Guide to HMFSERVE
• Back to the UNET Home Page
• Back to the UMS Home Page

Copyright © University of Maine System, 2001. Wayne T. Smith
This page was most recently revised on Monday, June 20, 2005
Your comments and suggestions are most welcome!