The 'host' property

Character Vector

Valid for: GetMail, SendMail, APL (Child Task), System object

GetMail and SendMail

Before you can use the GetMail or SendMail objects, you need to specify the internet address of the host you are using. For the GetMail object, this is the address of your POP3 server. For the SendMail object, it is the address of your SMTP server. You will probably also need a user name and password. The values to use will normally be supplied by your Internet Service Provider (ISP) or network administrator.

The host address can be specified either as a domain name (such as 'pop3.myisp.com'), or directly as an internet node address (such as '168.9.211.53').

For example:

      M←'⎕' ⎕NEW 'GetMail'
      M.host←'pop3.supernet.com'
      M.user←'microapl'
      M.password←'secret'
      M.Open
0

APL (Child Task)

If you are running a Client-Server implementation of APLX, you can use the host property of the APL object to specify on which machine the new APL task should run. There are three possibilities:

• You can set the host property to an empty string. In this case, the new APL task will be created as a local 32-bit session, running under the same process ID as the Client (user-interface) program.
• You can set the host property to be an internet address or hostname. In this case, APLX will attempt to contact an APLX or APLX64 (i.e. 32-bit or 64-bit) Server program on the named system, and ask it to create the new APL task. If the host name is 'localhost', this will be the same physical machine as the Client program. Note that the APLX Server program must already be running on the specified machine.
• You can leave the host property as its default value. This will be the same as the host property of the parent APL task. This means that the new task will be started on the same system, under the same 32-bit or 64-bit interpreter, as the APL task which created it.

You must set the host property before calling the Open method, but you can read it back at any time. If you are not running a Client-Server implementation of APLX, the host property can only be an empty string.

System Object

For the System object, the host property is read-only. It will be an empty string if the current APL task is running locally on the Client machine, or if you are not running a Client-Server implementation of APLX. It will be 'localhost' if the current APL task is running under an APLX Server on the same machine as the Client. Otherwise, it will be the IP address or host name of the Server on which the current APL task is running.