Name
CopyRecord Copy and send a customer record
Description
CopyRecord copies a customer record from a given number, 8MS Routing Set or SMS Template and sends a record change for a second number and date/time. This provides, for example, the ability to apply an 8MS Routing Set record to any dialed number. 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. 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. Note that this field is not used for an SMS Template source. In the case where the source is an SMS Template, the current Active, Sending, most recent Pending or most recent Old record is used.

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.

* destNumber The number for which the change is sent. This field cannot contain any formatting characters; it may only contain alphanumerics.
* 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.
highpriority This parameter provides access to the SMS/800 High Priority Update feature. Setting it to 1 will tell SMS to place this customer record at the front of the SCP queue. Only a small number of these updates can be done each day. After that, if this parameter is set to 1 the message will fail. You may check the Activity Log to see how many such updates remain for the current day.
MGI Messages
CopyRecord sends a REQ-CRC message with an action code of either N or C. The response message is a RSP-CRC.

If the specified dialed number is 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 routing from the 8MS Routing Set called CLASS1, and send it for 8005551212, 08/15/04 02:00P:
source~CLASS1;destNumber~8005551212;destDateTime~08/15/04 02:00P