TID101501 (gw5xob26) GroupWise 5 Token Commander (Delphi App)

From Developer Community

NOVELL TECHNICAL INFORMATION DOCUMENT

TITLE: GroupWise 5 Token Commander (Delphi App) AUTHOR: RL DOCUMENT ID: TID101501 DOCUMENT REVISION: DATE: 02/10/98 8:44 AM ALERT STATUS: Yellow INFORMATION TYPE: Issue README FOR: GW5XOB26.EXE NOVELL PRODUCT CLASS:

NetWare API

NOVELL PRODUCT and VERSION:

NetWare SDK

CATEGORY:

none

ABSTRACT:

This sample uses the Token commander interface.

The interface shows how to send tokens to GroupWise using the token commander interface.

NOTE: The FindDlg() token will fail when sending it to GroupWise. This is included to show the return values when a Token execution fails.

DETAILED DESCRIPTION

Problem: Can I send messages from my application to the GroupWise 5 Client, without writing a Custom 3rd Party Object?

Solution: Use the Token Commander interface.

To get a session started use the following line of code for Delphi: //variables Commander:variant;

Commander:=CreateOleObject("GroupWiseCommander");

The only method that exists for the commander object is Execute. Execute takes two parameters and returns a value.

Execute(CMD:string, RETVAL:string) : integer

CMD = Token command string to send to GroupWise (example 'AboutDlg()')

RETVAL = String returned as a token return value if token execution succeeds, if token has a return value. If token doesn't return a value then this string will be empty. = Error string returned if token execution fails.

Integer Returned = 0 if token execution fails = 1 if token execution succeeds

This is a simple interface that is quick to implement.

The sample application provides an Edit control that allows the user to enter a Token string by typing. Or the user can select from a combobox that lists a few tokens that can be used to see how the interface works.

NOTE: the RuleCreate token will fail unless you execute the FilterCreate token first. The FilterCreate(1;1) token will setup a default filter which the RuleCreate uses.

Also, FindDlg() token currently fails, but has been include to give an example of the return value and return string when a token fails to execute.

The documentation for the tokens in the envoy file Gw5tokns.exe. You can download a free envoy viewer from the following web page "http://www.novell.com/envoy/".

DISCLAIMER THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL. NOVELL MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION. HOWEVER, THE INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY. NOVELL MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION.

Self-Extracting File Name: GW5XOB26.EXE

Files Included: Size Date Time

GW5XOB26.TXT (this file) TKCMD.ZIP 100007 2-10-98 8:44 AM GW5TOKNS.EXE 2750424 2-10-98 8:44 AM GW5XOB26.TXT 3529 2-10-98 8:44 AM GW5XOB26.MSG 295 2-10-98 8:44 AM

Installation Instructions:

GW5XOB26.EXE can be found on: The DeveloperNet Support forum on CompuServe The DeveloperNet Support World Wide Web site (devsup.novell.com) The DeveloperNet Support Bulletin Board

Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information.

[edit]