MAILTOOL has been updated to v10.70.  The main update for this version is allow the user to specify a file containing a list of mail routers (and other settings for the router) in case of a failure.

To use a mail router file you need to specify *STMF for the Mail Router (MAILRTR) paramter on the MAILTOOL command (or in the configuration file if you're using one) and on the Router Stream File(RTRSTMF) parameter you will specify either *DFT or the fully qualified path to the router file.

Example settings for a config file using a mail router file:

    {
		"name":"mail_router_stmf",
		"default":"/bvstools/routers_test.json"
	},
	{
		"name":"mail_router",
		"default":"*STMF"
	},
	{
		"name":"use_mail_router",
		"default":"*ONLY"
	},

If you are using the MAILTOOL ILE functions you will set value mail_router to *STMF and set value mail_router_stmf to either *DFT or the fully qualified path to the router file.

Both options allow the use of *DFT for the mail router file setting.  This value will first search for the file:

/bvstools/mailtool/config/<USERID>/routers.json

If this file isn't found then MAILTOOL will look for:

/bvstools/mailtool/config/routers.json

The router file layout will consist of a JSON array that specifies 1 or more mail routers that you can use.

{
  "mail_routers": [
    {
      "mail_router": "first.smtp.mail.com",
      "from_email": "email@domain.com",
      "perform_mx_lookup": "*NO",
      "use_ssl": "*YES",
      "smtp_port" : "465",
      "smtp_auth_user" : "userid",
      "smtp_auth_password" : "password",
      "sequence": 10
    },
    {
      "mail_router": "second.smtp.mail.com",
      "from_email": "email@domain.com",
      "perform_mx_lookup": "*YES",
      "use_ssl": "*TLS",
      "smtp_port" : "587",
      "smtp_auth_user" : "userid",
      "smtp_auth_password" : "password",
      "sequence": 20
    }
  ]
}

The only required value in each JSON array element is the mail_router setting.  The rest of the settings are optional and will default to the value used on the command.

If any of the secondary mail routers use a different sign on id and password, the from_email, smtp_auth_user and smtp_auth_password should be specified in the mail router element.

The values of *G4MSMAIL and *G4GSMAIL can be used for the mail_router parameter in the routers file as well.  That would simply look like this:

{
  "mail_routers": [
    {
      "mail_router": "*G4MSMAIL",
      "from_email": "email@domain.com",
      "sequence": 10
    },
    {
      "mail_router": "*G4GSMAIL",
      "from_email": "email@domain.com",
      "sequence": 20
    },
    {
      "mail_router": "second.smtp.mail.com",
      "from_email": "email@domain.com",
      "perform_mx_lookup": "*YES",
      "use_ssl": "*TLS",
      "smtp_port" : "587",
      "smtp_auth_user" : "userid",
      "smtp_auth_password" : "password",
      "sequence": 30
    }
  ]
}