UDIST - UTBL distribution statement


integer UDIST weight[,...]

Function

The UDIST statement defines a probability distribution to be used in choosing entries from a UTBL statement. The UDIST statement is referenced by the UTBL data field option.

The UDIST statement is optional but if used, it can be coded up to a maximum of 256 times.

Where

integer

Function: Specifies the number to be used to identify this distribution in the TEXT statement special option field.

Format: An integer from 0 to 255.

Default: None. This field is required.

weight[,...]

Function: The number specified assigns a relative weight to the corresponding UTBL entry. Each weight represents a fractional value of the total weights specified on this UDIST statement. This fractional value is determined by dividing the specified weight by the total of all weights. The probability that a particular UTBL entry will be chosen for message generation on any given selection is this fractional value.

Format: A series of integers from 0 to 9999 separated by commas.

You can code up to a maximum of 2000 weights. The number of weights entered must be less than or equal to the number of entries on the corresponding UTBL statement referenced in the TEXT statement special option field. The sum of the weights must be greater than zero and must not exceed 9999.

Default: None. You must code at least one weight.