Activity User Exit Program USR600
"as is documentation"
This interface is available with Version 5.1 of ActionWare400
(formerly
TeleMagic/400).
Because of the complexity of the activity structure, this
interface is
conceptually different to the USR100 interface.
It does not give the degree
of control which the USR100 gives to the interface programmer.
The call to USR600 is immediately after the output operation
for an activity
add or change, and immediately before for a delete.
The user program can in
no way influence the action, or report back errors or
whatever, it is simply
informed of what is happening. It is passed the
id of the activity (field
TRAID), and some other basic information (see the parameter
list below), and
enough information for it to work out what the TM/400
user was doing. No
other record information is made available. If it needs
data, it has to read
it from a logical, say TRAN41. It may also need
to access earlier versions
of the record in the archive file ACTH.
ActionWare400 determines on the first call (to each program
in the list
below) if the USR600 program exists or not, so subsequent
calls are not made.
This logic is identical to that in USR100.
It is not expected that the user program will make changes
to the activity
file as a result of the interface call, but instead would
use the information
to inform their own application of what TM/400 has just
done. Any change
made to any ActionWare400 file by any external process,
whether it originates
from any TM/400 interface or is completely independent
of TM/400, is outside
of the scope of our standard support agreement.
As with any external interface exit, Appintec does not
undertake to maintain
compatibility with this interface in subsequent releases
of the product.
Appintec will endeavor to do so, but if in future changes
to this interface
are deemed to be necessary, Appintec will attempt to
implement those changes
according to AS/400 standard practices for such interfaces
as defined by IBM.
If your user exit requirement is to create activities
as a result of a user
action, please refer to the Activity API document for
more information.
Activities should not be created or added to ActionWare
except by using the
Activity API. This document may be requested from
the ActionWare Support
Desk or from your Account Manager.
Demonstration
A demonstration of the USR600 facility can be achieved
by compiling display
file USR600FM and CL program USR600 from ActionWare400
version 5.1 or later
library TM4/QMODSRC (not TM4L) into your database library,
normally this will
be library TM4L.
This test program can also be very useful to a programmer
developing their
own USR600 program. It provides an easy way to see what
data is provided
under what circumstances.
When finished the demonstration or test, simply delete
program USR600 from
the database library.
=========================================================================
=========================================================================
Parameters
All parameters are input only parameters to program USR600.
1. 11,0
AID of the activity involved.
2. 3,0
Version of the activity involved.
3. 1,A
Return code, not currently used.
4. 10,A
Name of program issuing the call.
5. 1,A
Action being taken. A=add new record, C=change existing
record, D=delete. (Records can be deleted by the UNDO
function.)
6. 1,A
Action qualifier, a sequential letter A, B, C, etc which is
unique within a given program to identify the exact
ActionWare400 function being performed,
7. 1,A
Internal reserved field, do not use or change.
8. 1,A
Internal reserved field, do not use or change.
9. 1,A
Internal reserved field, do not use or change.
=========================================================================
Programs
AM340 * Main Activity Add & change
windows, small & large.
AM341 * Work with related activities.
AM347 * Retrieve next/prior activity
from message list. Message List,
status change only.
AM348 * Change activity PID/SID after
contact record change.
AM350 * Automatic add/change after
phone, wordprocessing, fax functions.
AM352 * Add activity API
AM433 * Message List, status change
only.
AM452 * Work with linked group window.
AM456 * Campaign Management Activity
Change.
AM459 * Campaign Management Mass Mail
Generation.
=========================================================================
Last Updated: May, 1996