COPY_MESSAGE

 CAS Tags
The COPY_MESSAGE function creates a copy of a message, assigning ownership of the copied message to a specified fax server user.  The original message remains unaffected.  This function requires a MESSAGE_HANDLE tag to identify the message to copy, and a USER_NAME tag to identify the owner of the copied message.

The functionality of forwarding a message from one user to another can be achieved by copying a message to a new user, and then deleting the original message.   

You must provide valid REGISTERED_NAME and REGISTERED_PASSWORD tags in the taglist for this function to execute.  This function allows a user to copy their own messages, and a supervisor to copy messages belonging to any user.
 
  Type Max Size Multiple Allowed
Function N/A No

Example:
function ForwardMessage( MsgHandle, ToThisUser, DeleteOriginal )
  {
  var Tl, NewMsgHandle, Status;

  Tl = CAS.New();
  CAS.AddTag(Tl,"COPY_MESSAGE","");
  CAS.AddTag(Tl,"REGISTERED_NAME",UserName);
  CAS.AddTag(Tl,"REGISTERED_PASSWORD",UserPassword);
  CAS.AddTag(Tl,"MESSAGE_HANDLE",MsgHandle);
  CAS.AddTag(Tl,"USER_NAME",ToThisUser);
    // Copy message on this already open session
  Tl = CAS.Send(Instance,Tl);

  NewMsgHandle = parseInt(CAS.GetTag(Tl,"MESSAGE_HANDLE",0));
  Status       = parseInt(CAS.GetTag(Tl,"STATUS_NUM",0));
  CAS.Delete(Tl);

  if (Status == 0 && DeleteOriginal)
    {
    Tl = CAS.New();
    CAS.AddTag(Tl,"DELETE_MESSAGE","");
    CAS.AddTag(Tl,"REGISTERED_NAME",UserName);
    CAS.AddTag(Tl,"REGISTERED_PASSWORD",UserPassword);
    CAS.AddTag(Tl,"MESSAGE_HANDLE",MsgHandle);
      // Delete original message on this already open session
    Tl = CAS.Send(Instance,Tl);
    CAS.Delete(Tl);
    }

  return(NewMsgHandle);
  }

See Also:
MESSAGE_HANDLE, USER_NAME, DELETE_MESSAGE, REGISTERED_NAME, REGISTERED_PASSWORD