Name
SmsTemplateCopy Copy and send an SMS Template record
Description
SmsTemplateCopy copies a record from a given number, 8MS Routing Set or SMS Template and sends an SMS Template record change. This provides the ability to convert a toll-free number CAD record or an 8MS Routing Set record to an SMS Template as well as the ability to copy one SMS Template (directly, by specifying a source SMS Template or indirectly by specifying a source toll-free number PAD record) to another SMS Template. The following are the allowed fields in reqparams:
* source The number, 8MS Routing Set or SMS Template containing the 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.

If a toll-free number has been specified as the source, and the record is a CAD record, the CAD data is copied to the destination SMS Template. If the record is a PAD record, the SMS Template referenced by this PAD record is used as the source and is copied to the destination SMS Template.

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.

* destTemplatename The SMS Template for which the change is sent.
* destDateTime The effective date/time of the destination SMS Template 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 SMS Template 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
SmsTemplateCopy sends a REQ-TRC message with an action code of C. The response message is a RSP-TRC.

If the specified source SMS Template is not known in the 8MS database, the SMS Template information will first be retrieved from SMS/800. This requires sending a REQ-CRV message; the response is a RSP-CRV.

Example
The following request parameters will copy the routing from the SMS Template *AR-CSF-01, and send it for *AR-CSF-02, 11/15/12 02:00P:
source~*AR-CSF-01;destTemplatename~*AR-CSF-02;destDateTime~11/15/12 02:00P