RegisterCallForwarding

From IRON Test Suite
Jump to navigation Jump to search

DESCRIPTION

This command registers and enables call forwarding for the specified GSM port, under specified conditions, on the specified phone number, for optional specified call class.
Condition could be UNCONDITIONAL, BUSY, NO_REPLY, NOT_REACHABLE, ALL or ALL_CONDITIONAL, and for NO_REPLY the delay time (in seconds) should be specified. Call class could be VOICE, DATA, FAX, SMS, ALL_CALLS or ALL. If call class is omitted call forwarding will be set for ALL.

COMMAND

Command Input arguments Returns
RegisterCallForwarding Port index, Forward condition, Forward number, No reply delay, [ Call class ] In the case of error, Error Code

OUTPUT

None

EXAMPLE

~# RegisterCallForwarding 0 UNCONDITIONAL 06983981244

~# RegisterCallForwarding 3 NO_REPLY 0612843356 10 ALL_CALLS

API

MessageCode: GRA_REGISTER_CALL_FORWARDING_REQUEST

MESSAGE BODY
Field Name Length Description
PortIndex 4 GSM Port index
Condition 4 Call forward condition
ForwardNumber 32 Call forward number
Delay 4 Delay for NO REPLY condition
Class 4 Call Class

The format of Message Body can be coded as the following C-language structure:

typedef struct
{
   ULONG    PortIndex;
   ULONG    Condition;
   UCHAR    ForwardNumber[32];
   ULONG    Delay;
   ULONG    Class;
} GRAM_REGISTER_CALL_FORWARDING_REQUEST;

<source>

  1. define CALL_FW_UNCONDITIONAL 0
  2. define CALL_FW_BUSY 1
  3. define CALL_FW_NO_REPLAY 2
  4. define CALL_FW_NOT_REACHABLE 3
  5. define CALL_FW_ALL 4
  6. define CALL_FW_ALL_CONDITIONAL 5

</source>

<source>

  1. define CALL_CLASS_VOICE 0
  2. define CALL_CLASS_DATA 1
  3. define CALL_CLASS_FAX 2
  4. define CALL_CLASS_SMS 3
  5. define CALL_CLASS_ALL_CALLS 4
  6. define CALL_CLASS_ALL 5

</source>

MessageCode: GRA_REGISTER_CALL_FORWARDING_CONFIRM

MESSAGE BODY
Field Name Length Description
Status 4 Command status (0 if successful, otherwise see list of Error Codes Values)

The format of Message Body can be coded as the following C-language structure:

typedef struct 
{
   ULONG    Status;
} GRAM_REGISTER_CALL_FORWARDING_CONFIRM;