Name
ReserveActivate Reserve numbers
Description
ReserveActivate is used to reserve numbers in the SMS/800 database and then immediately activate those numbers. The following are the allowed fields in reqparams:
numbers A comma-separated list of up to 10 particular numbers to be reserved, or a single number containing either * or & (i.e., a pattern or wildcard search).
* resporg The resporg to be associated with any numbers reserved.
npa The NPA of the toll-free number(s).
nxx The starting NXX of the toll-free number(s).
line The starting line of the toll-free number(s).
count The count of numbers to be reserved.
contiguous Whether or not the reserved numbers must be contiguous; value must be 0 or 1.
minimum For a contiguous request, the minimum count of numbers that is acceptable. For example, if a request for 100 contiguous numbers cannot be satisfied, with a minimum of 50, 50 contiguous numbers will be returned if available.
* cname The contact person name.
* cphone The contact person phone number.
notes Descriptive notes.
numlist If set to 1, number lists will be created containing the numbers successfully reserved, and those that were not reserved. If set to 0 or omitted, no such lists are made.
nlname The name of the number list to be created. This is only used if numlist is set to 1.
* source The number or 8MS Routing Set containing the customer record to be copied. The value specified will first be tried as a the name of an 8MS Routing Set. If an 8MS Routing Set with the given name is found, it is used as the source. Otherwise, it is assumed that the source is a toll free number.
* sourceDateTime The effective date/time of the source record, to be used when source is a toll-free number. 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.

If sourceDateTime is omitted, the latest ACTIVE or SENDING record in the source dialed number will be used. If there is no such record, CopyRecord fails.

* 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 activate operation.
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
ReserveActivate sends a REQ-NSR message with an action code of R. The response message is a RSP-NSR.

The SMS/800 MGI will allow, at most, 10 numbers to be reserved in a single REQ-NSR request. If the specfied count is greater than ten, 8MS will automatically generate additional REQ-NSR messages.

For each number successfully reserved, ReserveActivate sends a REQ-CRC with an action code of N. The response message is a RSP-CRC

Example
The following will attempt to reserve 10 800 numbers starting at NXX 777 and activate the numbers in the 8MS Routing Set called CLASS1, on 08/15/05 02:00P:
npa=800;nxx=777;count=10;resporg=ART01;cname=BSO; cphone=7323566999;source~CLASS1;destDateTime~08/15/05 02:00P