User manual

Using the Mail Service
260
33002479 06 07/2008
Parameter
Description
The following table describes the MSTR parameters:
Parameter Data Type Description
ENABLE None ON = enables selected MSTR operation
ABORT None ON = terminates active MSTR operation
ACTIVE None ON while the instruction is active
ERROR None ON if the MSTR operation is terminated prior to completion
SUCCESS None ON = operation successful
CONTROL INT, UINT Control block is the first of several network-dependant,
contiguous, holding words, and the first of nine contiguous
words entered in the top node.
The remaining eight words are:
Displayed: Identifies one of the MSTR = 13
First implied displays error status (see Mail Service
Error Codes (see Mail Service Error
Codes, p. 262))
Second implied displays length (number of words
transferred)
Third implied (not used)
Fourth implied high byte: slot address of the NOE module
or 0xFE for the 140 CPU 651 x0
low byte: 0 (not used)
Fifth implied (not used)
Sixth implied (not used)
Seventh implied (not used)
Eighth implied (not used)
DATABUF INT, UINT The DATABUF parameter is the address of the buffer including
the data inserted into the body of the email message. The data
should be in ASCII format starting at the second word.
Note:
1. Least significant byte of the first word: contains a valid
(configured) mail header (should be of value 1, 2, or 3).
2. Most significant byte of the first word: contains the length of
the dynamic part of the message’s subject field. The length
must be between 0 and 238 characters.