1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML3.2 EN">
<HTML>
<HEAD> <link rel="canonical" href="http://www.mcs.anl.gov/petsc/petsc-current/docs/manualpages/Sys/PetscTextBelt.html" />
<META NAME="GENERATOR" CONTENT="DOCTEXT">
<TITLE>PetscTextBelt</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<div id="version" align=right><b>petsc-3.14.5 2021-03-03</b></div>
<div id="bugreport" align=right><a href="mailto:petsc-maint@mcs.anl.gov?subject=Typo or Error in Documentation &body=Please describe the typo or error in the documentation: petsc-3.14.5 v3.14.5 docs/manualpages/Sys/PetscTextBelt.html "><small>Report Typos and Errors</small></a></div>
<A NAME="PetscTextBelt"><H1>PetscTextBelt</H1></A>
Sends an SMS to an American/Canadian phone number
<H3><FONT COLOR="#CC3333">Synopsis</FONT></H3>
<PRE>
<A HREF="../Sys/PetscErrorCode.html#PetscErrorCode">PetscErrorCode</A> <A HREF="../Sys/PetscTextBelt.html#PetscTextBelt">PetscTextBelt</A>(<A HREF="../Sys/MPI_Comm.html#MPI_Comm">MPI_Comm</A> comm,const char number[],const char message[],<A HREF="../Sys/PetscBool.html#PetscBool">PetscBool</A> *flg)
</PRE>
Not collective, only the first process in <A HREF="../Sys/MPI_Comm.html#MPI_Comm">MPI_Comm</A> does anything
<P>
<H3><FONT COLOR="#CC3333">Input Parameters</FONT></H3>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>comm </B></TD><TD>- the MPI communicator
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>number </B></TD><TD>- the 10 digit telephone number
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>message </B></TD><TD>- the message
</TD></TR></TABLE>
<P>
<H3><FONT COLOR="#CC3333">Output Parameter</FONT></H3>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>flg </B></TD><TD>- <A HREF="../Sys/PETSC_TRUE.html#PETSC_TRUE">PETSC_TRUE</A> if the text was sent
</TD></TR></TABLE>
<P>
<H3><FONT COLOR="#CC3333">Options Database</FONT></H3>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-textbelt <phonenumber[,message]></B></TD></TABLE>
<P>
<P>
<H3><FONT COLOR="#CC3333">Notes</FONT></H3>
TextBelt is run for testing purposes only, please do not use this feature often
<P>
As of November 2016 this service does not seem to be actually transmitting the SMS, which is unfortunate since it is such a great service. Consider
registering and using <A HREF="../Sys/PetscTellMyCell.html#PetscTellMyCell">PetscTellMyCell</A>() instead. Or email us with other alternatives we might add or make a pull request.
<P>
<H3><FONT COLOR="#CC3333">Developer Notes</FONT></H3>
I do not know how to make the buff[] long enough to receive the "success" string but short enough that the code does not hang
waiting for part of the message to arrive that does not exist, hence the success flg may be improperly set to false even
though the message was delivered.
<P>
<H3><FONT COLOR="#CC3333">See Also</FONT></H3>
<A HREF="../Sys/PetscTellMyCell.html#PetscTellMyCell">PetscTellMyCell</A>(), PetscOpenSocket(), <A HREF="../Sys/PetscHTTPRequest.html#PetscHTTPRequest">PetscHTTPRequest</A>()
<BR><P><B></B><H3><FONT COLOR="#CC3333">Level</FONT></H3>intermediate<BR>
<H3><FONT COLOR="#CC3333">Location</FONT></H3>
</B><A HREF="../../../src/sys/webclient/textbelt.c.html#PetscTextBelt">src/sys/webclient/textbelt.c</A>
<BR><A HREF="./index.html">Index of all Sys routines</A>
<BR><A HREF="../../index.html">Table of Contents for all manual pages</A>
<BR><A HREF="../singleindex.html">Index of all manual pages</A>
</BODY></HTML>
|
