v1.00 - Original
v1.10 - Updated JSON parsing routines
v1.20 - Update Service Registration to use shorter URL (from our site)
Added scope of *OUTLOOKSMTP to allow use of OAuth 2.0 in MAILTOOL
when using outlook mail servers.
v1.30 - Updated to check for expiring token 2 minutes before instead of 1.
Updated _list and _upload functions to return a -2 if the error
was expired token.
v2.00 - Updated licensing to subscription based.
Added folder to G4MSLSTFIL command to subset results by folder name.
Replace JSON parsing with the IBM i port of the YAJL JSON parser provided
by Scott Klement.
v2.01 - Added file reorganization.
Added REDO option to G4MSREGSVC command to allow you to re-register a
a service if the refresh token becomes invalid.
v3.00 - Added scope of *OFFICE365EMAIL which allows sending emails using Microsoft
APIs included in the F.G4MSMAIL subprocedure. This requires registration
of the G4MSMAIL addon.
Included GETURI v6.00 in the G4MS library for compatibility reasons. When
using this software make sure if you have GETURI in another library it is
not above G4MS in your library list.
Updated the registration of services so you don't need to copy and paste
codes from a web page back to the green screen. Requires internet
v3.10 - Updated G4MSMAIL to v2.00.
Removed YAJLR4 *SRVPGM and made it Bind by Copy instead for compatibility
Added a log file for sending email named G4MSMLGPF.
Added #g4ms_resendMail() function to allow user to resend a mail if it
ended in error and the email was created. You must provide the unique
ID of the email to resend (which can be found in the log file) and the
.json file created during the email (also in the log file) attempt must
Renamed constants in the P.G4MS /COPY memeber by appending g4ms_ to the
beginning so they won't conflict with other possible constant definitions.
Added unique_id settable parameter. This can be used to set the unique ID
of the email being sent by the user. If this is not set, the system will
create a unique ID. Note, this ID MUST not exist in the G4MSMLGPF file
to be unique.
Updated the #g4ms_sendMail() function to optionally return the unique ID
of the email that was sent.
SP162706 - Updated F.G4MSMAIL and F.G4MSDRV so the ID is case insensitive.
v3.11 - Updated registration program to use lower case for all IDs.
SP160705 - Updated F.G4MSMAIL so if it errored out before refreshing a
token from a connection error the email is still able to be
resent using MTG4MSLOG.
v4.00 - Added G4MSRMAIL addon which allows you to retrieve email messages and their
attachments/embedded objects via a command interface or ILE subprocedures.
v4.10 - Updated to use GETURI v6.20.
SP161201 - Updated G4MSMAIL so that when the \n sequence is used in
a message it is converted to a new line, like MAILTOOL
v4.20 - Updated GETURI to v7.00 to allow non-strict SSL communications.
v4.30 - Added the following subprocedures:
- #g4msmail_init() - Initialize G4MSMAIL
- #g4msmail_loadDefaults() - Load defaults from a configuration file.
When using this option you must set the configuration file using
- #g4msmail_dumpSettings() - This will produce a JSON file in the temp
directory containing the values of the variables used
New paramters for #g4msmail_setValue():
- dump_file - Set the dump file path and name
- configuration_file - Set the configuration file path and name. If the value
*DFT is used it will look for a file named
Where <userid> is the user id of the person running the application. If a file
isn't found it will use
Updated application so that all files created use the temporary directory
specified instead of just /tmp. /tmp is the default temporary directory.
If the email ends in error, along with the other debug files a configuration
file is created using #g4msmail_dumpSettings().
#g4msmail_resendMail() will attempt to find the .json config file to use
when resending emails.
Updated so that the port used for communications is not hard coded. Instead
it will use the port in the G4MSSVCPF file URLs.