OSI/MHS Management Programming Manual

Commands and Responses
OSI/MHS Management Programming Manual—424824-001
5-44
ADD APPL
ZSTRING
is the OSI address NSAP. This value must be a hexadecimal string of the
length specified in ZSTRING.
ZMHS-MAP-APPL-DUPL-SUPRN
is a structured token that defines the duplicate suppression attributes for an MS
APPL. This token is optional. The ZMHS-MAP-APPL-DUPL-SUPRN definition,
ZMHS-DDL-APPL-DUPL-SUPRN, contains the following fields:
ZDUPL-SUPRN
specifies whether duplicate message and report suppression is enabled
(ZMHS-VAL-FLAG-ON) or disabled (ZMHS-VAL-FLAG-OFF) for the
MS APPL object. The default value is ZMHS-VAL-FLAG-OFF.
ZDUPL-SUPRN-WINDOW
specifies the minimum length of time that duplicate suppression is enforced for
an individual message or report received by the MS APPL object. This is the
minimum length of time OSI/MHS retains the context of a message or report
delivered to the MS APPL object for the purpose of detecting duplicates. The
time period is measured beginning with the time the first copy of a particular
message or report is received by the MS APPL object. The time is specified in
minutes in the range from 1 minute through 28800 minutes (20 days). The
default is 2 days (2880 minutes).
If ZDUPL-SUPRN is ZMHS-VAL-FLAG-OFF, ZDUPL-SUPRN-WINDOW is
meaningless and is ignored if specified.
If ZDUPL-SUPRN is ZMHS-VAL-FLAG-ON, and ZDUPL-SUPRN-WINDOW
is omitted, the default value (2880 minutes) is assumed for ZDUPL-SUPRN-
WINDOW.
If a value for ZDUPL-SUPRN-WINDOW is specified and ZDUPL-SUPRN is
omitted or has a null value, the value ZMHS-VAL-FLAG-ON is assumed for
ZDUPL-SUPRN.
ZMHS-MAP-SET-RTVL-PARAMS
is a structured token that defines the action the MHS manager takes on the LIST and
FETCH attribute defaults each time an APPL object is added or altered. This token
is optional. The ZMHS-MAP-SET-RTVL-PARAMS definition, ZMHS-DDL-SET-
RTVL-PARAMS, contains the following field:
ZSET-RTVL-DEFAULTS
is an attribute that recalculates the defaults when an MS APPL object is added or
altered. The default is ZMHS-VAL-FLAG-OFF.
Note. If communication with the APPL object is over X.25 (1980), you must specify the ASCII
equivalent of the DTE address for the APPL object in the ZNSAP attribute. For example, if the
DTE address is 12345, you must specify 3132333435.