Port (Email property): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (Created page with "This method retrieves or sets the TCP port number of the SMTP server. ==Port syntax== <p class="pre"> %email:Port = portnum %curr = %email:Port </p> ===Syntax terms=== <tabl...")
 
(3 intermediate revisions by 2 users not shown)
Line 6: Line 6:
===Syntax terms===
===Syntax terms===
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>%email</th>
<tr><th>%currentPort</th>
<td>A previously declared <var>Email</var> object.
<td>A numeric variable to contain the current value of the <var>Port</var> property.</td></tr>
</td></tr>
<tr><th>email</th>
<tr><th>portnum</th>
<td>An <var>Email</var> object.</td></tr>
<tr><th>newPort</th>
<td>The target server TCP port number to which the SMTP connection request is sent.
<td>The target server TCP port number to which the SMTP connection request is sent.
</td></tr>
</td></tr>
<tr><th>%curr</th>
</table>
<td>A numeric variable to contain the current value of the <var>Port</var> property.
 
</td></tr></table>
==Usage notes==
==Usage notes==
<ul>
<ul>
<li>The initial value of the <var>Port</var> property is zero.
<li>The initial value of the <var>Port</var> property is zero.
This means that <var>[[Mail (Email function)|Mail]]</var> method
This means that <var>[[Mail (Email function)|Mail]]</var> method invocations will try to use the
invocations will try to use the
<var>[[REMOTE (JANUS DEFINE parameter)|REMOTE]]</var> port number (if present) from the Janus client socket port definition.
REMOTE port number (if present) from the Janus client socket port definition.
If the Janus client port does not have a <var>REMOTE</var> definition that specifies a TCP port number, you ''must'' set this <var>Port</var> property to the correct value for the target SMTP server.
If the Janus client port does not have a REMOTE
 
definition that specifies a TCP port number, you ''must''
set this <var>Port</var> property to the correct value for the target SMTP server.
<li>If you set the <var>Port</var> property value, and the Janus client socket
<li>If you set the <var>Port</var> property value, and the Janus client socket
port you are using has a TCP port defined, your <var>Port</var> property value must
port you are using has a TCP port defined, your <var>Port</var> property value must
match the client port value.
match the client port value.
<li>The "well-known" port number for SMTP connections is 25.
<li>The "well-known" port number for SMTP connections is 25.
</ul>
</ul>
==See also==
==See also==
{{Template:Email:Port footer}}
{{Template:Email:Port footer}}

Latest revision as of 21:46, 14 August 2012

TCP port number of the SMTP server (Email class)


This method retrieves or sets the TCP port number of the SMTP server.

Syntax

%currentPort = email:Port email:Port = newPort

Syntax terms

%currentPort A numeric variable to contain the current value of the Port property.
email An Email object.
newPort The target server TCP port number to which the SMTP connection request is sent.

Usage notes

  • The initial value of the Port property is zero. This means that Mail method invocations will try to use the REMOTE port number (if present) from the Janus client socket port definition. If the Janus client port does not have a REMOTE definition that specifies a TCP port number, you must set this Port property to the correct value for the target SMTP server.
  • If you set the Port property value, and the Janus client socket port you are using has a TCP port defined, your Port property value must match the client port value.
  • The "well-known" port number for SMTP connections is 25.

See also