Z-MLDFLT

This document covers the following topics:


Description

Modify the send defaults for a mail item that is to be sent with Z-MAILA or Z-MAILAX. You should call Z-MLDFLT before calling Z-MAILA or Z-MAILAX.

Delivery date and time are interpreted as GMT date and time. When you do not specify date and time (or set them to zero), the current date and time are used.

The parameter Suspended-transport-flag only applies to a transport service item. It is used to control when the transport service item is to be created. When this parameter is not marked, Z-MAILA or Z-MAILAX automatically invokes Z-CNFIRM in order to create the transport service item. When this parameter is marked, Z-MAILA or Z-MAILAX does not invoke Z-CNFIRM; in this case, you must invoke Z-CNFIRM yourself (see the description of Z-CNFIRM).

When you use Z-MLDFLT to modify the send defaults of a telex, teletex or telefax that is to be sent using Con-nect Teleservices and you specify a value in the parameter Delivery-time, you must observe the following, otherwise this value will not be used. In the address of the telex, teletex or telefax node, both values for the time range in which the mail item is to be sent must be set to zero; i.e. the time range must be defined as follows:

Send between 0000 (hhmm) in GMT
         and 0000 (hhmm) in GMT

However, if values other than zero have been defined in the address of the telex, teletex or telefax node, the mail item is always sent at the earliest possible time.

Example: the time range between 18:00 and 22:00 was defined in the address and you specify 20:00 in the parameter Delivery-time. In this case, your specification (20:00) is ignored and the mail item is sent at the earliest possible time which is 18:00.

The Work-parameter must be blank when calling Z-MLDFLT. Its contents is passed to Z-MAILA or Z-MAILAX.

Parameters

Parameter Format In Out Remarks
Return-code N2   X  
Suspended-transport-flag A1 O   Only applies to a transport service item. If not marked, Z-MAILA or Z-MAILAX automatically creates a transport service item. If marked, you must invoke Z-CNFIRM in order to create a transport service item.
Delivery-date P8 O   The date when the mail item is to be sent. Format yyyymmdd.
Delivery-time P4 O   The time when the mail item is to be sent. Format hhmm. When you specify a Delivery-time, you must also specify a Delivery-date (otherwise, the Delivery-time is set to zero). See the above description for limitations that apply to Con-nect Teleservices.
Delivery-interval N1 O   0=no repeated delivery, 1=daily delivery, 2=weekly delivery, 3=monthly delivery.
Delivery-count N2 O   If Delivery-interval is 1, 2 or 3, you must specify how many times the mail item is to be delivered. The Delivery-count can be any number between 1 and 99.
Priority N1 O   The priority of the mail item. 0=normal, 1=low, 2=urgent. Default: 0.
Message-flags A16 O    
Redefine Message-flags
  Alternate-recipient A1 O   If marked, the mail item may be delivered to a default cabinet, if the addressee cannot be found at the target node.
  Message-conversion A1 O   If marked, conversion of your mail is allowed.
  Disclose-recipients A1 O   If marked, the addressee can display the name of all other addressees.
  Validate-recipient-list A1 O   If marked, it is checked whether the specified addressee is known at the target node.
  Filler A12     For future use.
Work-parameter A128     For internal use. See The Work Parameter.

Return Codes

00 Success
90 Message has already been sent - defaults can no longer be modified
91 Invalid delivery interval
92 Invalid delivery count
93 Invalid priority

Subprograms

None