SafeFire PPP REXX API Extension

v.0.9 beta

Message Reference

Informational Messages.
MessageReasonDescription
MSG_00000001Clock timer message This message is passed every second
MSG_00000003Connection established IPCP negotiation is completed and connection may be considered established
MSG_00000004Connection lost IPCP detected loss of connection
MSG_00000005Modem status message Modem has produced status string recognised by SafeFire PPP and translated into some standartized string.

Following messages may appear:
MessageDescription
modem error Modem reported error condition.
phone is busyPhone is busy.
no carrier Modem can't establish connection.
no dialtone Modem is not connected to phone line or phone line is not working.
selecting next phone numberResponse produced by SafeFire for MSG_00000044 control message (see below).

MSG_00000006Carrier loss detected by modem Modem is signalled carrier loss
MSG_00000007Connection at modem level is established Modem is established connection with other side and switched into data transfer mode.
MSG_00000020Phase changed SafeFire PPP goes through certain phases during work. Each phase change is notified by this message.
Following phases may appear:
Phase Description
AUTHPerform authentication
CALLBACKPerform callback negotiations
CFGCONConnect and perform initial LCP negotiations
DODWait for a packet to start connection
INITIALStarting phase
ONLINELCP is online. Configure NCPs and start data processing
STARTStart connection
STOPClose current connection and exit SafeFire PPP
STOPPINGWait for connection close
MSG_00000031Idle timer messages Following messages may appear:
MessageDescription
EXPIREDIdle timer is expired.
numberNumber of secons left before timer will expire.
MSG_00000032Connection timer messages Following messages may appear:
MessageDescription
EXPIREDConnection timer is expired.
numberNumber of secons left before timer will expire.
MSG_00000061Our IP IP address for our interface obtained during IPCP negotiation.
MSG_00000062Peer IPIP address for peer side obtained during IPCP negotiation.
MSG_00000063Primary DNSPrimary DNS address received from peer.
MSG_00000064Secondary DNSSecondary DNS address received from peer.
MSG_000000F0Init Initialisation. *
MSG_000000F1Done Deinitialisation.*
MSG_000000F2StartStart work. *
MSG_000000F3Stop Stop work. *

* At present time there are no significant difference between Init - Start and Done - Stop pairs. But future versions of SafeFire PPP may change the situation. In general difference between Init and Start (as well as between Done and Stop) is that Init and Done messages are appear only once but Start and Stop will be issied by SafeFire PPP every time when internal structure is started and stopped.

Control messages.
MessageActionDescription
MSG_00000043Exit program Reset connection and exit SafeFire PPP.
MSG_00000044Next phone Skip to next phone number or initiate immediate redial.*
MSG_00000045Cancel redial timer Skip to next phone number or initiate immediate redial.*
MSG_00000046Reset connection Reset current connection if connection established.
MSG_00000051Reset idle timer Reset idle timer to value set in configuration file.
MSG_00000052Reset connection timerReset connection timer to value set in configuration file.

* At present time this two messages are identical but in future version of SafeFire PPP their functions will be separated according to Action.

Return to documentation index SafeFire PPP (C) Link Guard Solutions 1999