Name
BatchCopyRecord Batch customer record copy
Description
BatchCopyRecord copies a customer record from a given number, 8MS Routing Set or SMS Template and sends a record change for a group of other numbers. This provides, for example, the ability to apply an 8MS Routing Set record to a large set of toll-free numbers. The following are the allowed fields in reqparams:
* source The number, 8MS Routing Set or SMS Template containing the customer record to be copied. The value is interpreted according to these rules:
  1. If a sourceDateTime is specified the value of source is assumed to be a toll free number unless the source begins with a *, in which case it is assumed to be an SMS Template. The pair of values identifies the exact record from which the copy is to be made.
  2. If no sourceDateTime is specified, the value is assumed to name an 8MS Routing Set from which the copy is to be made.
  3. If no sourceDateTime is specified and no matching 8MS Routing Set is found, the value is assumed to be a toll free number unless the source begins with a *, in which case it is assumed to be an SMS Template. In either case, the latest ACTIVE or SENDING record for that number or SMS Template is used as the source for the copy.
If an 8MS Routing Set has been given a toll free number as its name, and the intended action is to use the toll free number as the source of a copy, sourceDateTime must be used to specify the exact record to be copied from. Otherwise, the 8MS Routing Set will be used as the source.
sourceDateTime The effective date/time of the source record, to be used when source is a toll-free number or an SMS Template. The format of this value is:
mm/dd/yy hh:mmX/Y
where X is the meridiem (A or P), and Y is the SMS/800 timezone indicator. An example of a valid date/time would be: 07/01/98 10:15A/C.
Be aware that Somos only allows schedule date/times where the minute on the quarter hour :00, :15, :30, or :45.

Any other value for minute will cause the record to fail validation.

* dnlist The list of numbers for which the change is sent.
* destDateTime The effective date/time of the destination record. The format of this value is as described for sourceDateTime above, and may also contain the value NOW to request an immediate change.
comment A comment describing the batch operation.
flowmax The maximum number of messages per hour sent to SMS/800.
rundate The date/time when this batch will run. The format of this value is:
mm/dd/yy hh:mmX
where X is the meridiem (A or P).

To run a batch immediately, either don't use this parameter or set the value to NOW.

MGI Messages
BatchCopyRecord sends a REQ-CRC message with an action code of either N or C. The response message is a RSP-CRC.

If any of the specified dialed numbers are not known in the 8MS database, the number status information will first be retrieved from SMS/800. Note that the retrieve will only be done on dedicated and private sites; it will not be done on any of the service bureau sites. This requires sending a REQ-NSR message; the response is RSP-NSR.

Example
The following request parameters will retrieve the 08/01/04 10:00A record from the 8MS Routing Set CLASS1, and send it for the given list of numbers with an effective date/time of 08/15/04 02:00P.
source~CLASS1;dnlist~8005551212,8775551212,8885551212;
destDateTime~08/15/04 02:00P
See Also
CopyRecord