SMTP-X with
SMAPImail (Mail Posting)
SMAPImail is the powerful combination
of SMTP-X, mail gateway, and SMAPI, API, that
allows mail integration of the HP3000 with the
Internet. SMTP-X provides inbound and outbound SMTP
mail with full MIME base-64 encoding. SMAPI
provides an easy-to-use front-end in the form of an MPE
program for mail-enabling the HP 3000 environment, including
batch jobs, command files, programmatic access and more with SMTP
access.
SMAPImail
allows ANY HP 3000 in the line of mini-computers by
Hewlett-Packard to exchange SMTP mail with another SMTP host
via the Internet or any local area TCP/IP network
intranet.
SMAPImail's front-end is an intuitive
and easy-to-use API that sits directly in front of the
gateway, providing a snap-in hook for
your applicatons, command files, batch jobs,
etc. With SMAPImail you will enrich the HP3000's
entire environment. SMAPI allows you to very quickly and
easily
-
ENABLE -- mail-enable your
jobs
-
ALERT -- send alerts and job failure
notifications
-
ATTACHMENTS -- send and receive
attachments readable by any mail-client
-
SPOOL DATA -- pick up raw spool
files as text attachments
-
JOBS -- provide, send and route
job listings
-
BATCH -- do batch
mailers
SMTP-X with
SMAPIweb (Web Posting)
SMAPIweb
is the powerful combination of the SMTP-X gateway
and SMAPI API that provides content posting
to URLs in the POSIX file domain. Designed for HP 3000
computers, SMAPIweb is perfect for publishing data taken directly
from your HP 3000 to a website or a POSIX file.
SMAPIweb
will publish output from any applicaton running on an
HP3000 to a web server like Apache or the Web Wise MPE/ix Secure
Server from HP. HP 3000 users are constantly
updating their web servers with new content taken from their HP 3000
applications. With SMAPIweb you e-mail content, as
you would any e-mail message, and it is delivered to your
website as SMTP mailings in the form of POSIX files (i.e.,
URLs). For example, you may have information that
regularly needs updating on your website, such as pricing and
product code changes, operations infomation, links to financial
postings or images, etc.
SMAPIweb
makes heavy use of the POSIX file system to provide
an effective and unique way to move valuable application data to
UNIX applications, like an APACHE web server. When your
application runs and creates spool files, job listings and
batch files, for example, SMAPI takes these, or any other
output from a job, and saves the results directly as a URL - this
could be a website or other POSIX file application. It
does this by integrating your job output with a template file
of HTML and automatically saving the merged
contents as the URL that you have designated. With
SMAPI you can specify an HTML template file along with a URL
designator with every attachment in your message.
SMTP-X and
SMAPImail -- Technical Data
SMAPI's
sole purpose -- SMAPI's sole purpose is to allow easy
access to your mail environment on your HP 3000. Globally,
corporations are still relying heavily on the HP 3000s to
process their critical data, often in the background on
self-contained networks. Much of this data is critical to
corporate communications. SMAPI lets you get this information
emailed out quickly and reliably.
You can use SMAPI in different ways to invoke
the use of the SMTP-X gateway:
- SEND mail from the command
line, batch jobs, UDC's, and your applications.
- CONNECT all your HP 3000
application jobs to SMAPI and mail to your Exchange server,
for example.
- COMPLETE rfc 821 SMTP mail with
MIME 64 base encoding.
- RECEIVE any kind of
attachment you would like.
Note! You can specify the name of
the attachment's application, such as a word processing or a
spreadsheet name, to enable double-click window retrieval on the
receiving end. You can even send your spool files, as is, as
text attachments.
SMAPI allows you to mail-enable your job
environment and customize it to your needs. You can call SMAPI
in order to communicate with the SMTP-X gateway from a command line
or from within a job housing your application. SMAPI uses the
command line INFO= parameter of the MPE RUN command to pass itself a
string that comprises a list of values required to send a
message.
:RUN SMAPI;INFO=
"/FROM/TO/SUBJECT/TEXT"
Some values can have more than one
incantation. For example, the TEXT value can be either in
the form of an attachment (a pre-existing MPE ASCII or binary file)
or of a quick "blurb" of text passed directly into the INFO= string
in the text value slot. It can even be a file that contains
the names of other files (i.e., redirection).
For
example, to send a one-line message notifying you of a job failure
you would insert a line in your jobstream like this:
:RUN SMAPI;INFO=
"/job@shop.com/operator@shop.com/failure on !HPJOBNUM/This job has
failed"
Redirection is also possible from the TEXT
value. You can pass a file name containing the names of other
text files or attachments by prefacing the filename in the TEXT
slot with a "~". Indirection to a file with the "~" character
is also possible from the TO and SUBJECT values. To
redirect the recipient TO value to a file containing a list of
recipients (for a batch mailer, for example), use the tilde("~")
character before the file name in the TO value slot.
SMAPImail is a pure software solution.
Using the Internet or a private network intranet,
SMAPImail uses an HP 3000 computer to act as a mail server with
another mail host via the Simple Mail Transfer Protocol (SMTP) for
electronic mail exchange. All mail is formatted locally and
exchanged via TCP/IP over socket connections. Hardware,
dial-up modems, or personal computer bridges are not required.
No special ports are required. All attachments are MIME
(Multipurpose Internet Mail Extensions) base-64 encoded.
SMAPImail is a complete SMTP
solution. SMAPImail completely conforms to open RFC 821
Internet standards. With SMAPImail you can do much more than
connect your mail systems. In summary, you can SMAPI-enrich
your entire command line environment; mail-enable your jobs; send
attachments to any mail client, particularly Windows attachments;
send raw spool files, job listings, stdlist captures, batch
mailings, and much more -- all with SMAPImail.
SMTP-X and SMAPIweb -- Technical
Data
SMAPIweb
is unique -- SMAPIweb is a powerful side of the
SMTP-X product unlike any other that exists on the HP 3000
Hewlett-Packard line of mainframe computers. SMAPIweb is
a combination of SMTP-X with SMAPI to perform URL posting to
your POSIX file based application, such as your web
server. Now, with SMAPIweb, you can redirect your output from
your HP 3000 applications directly to your website make the updates
instantly available to your website viewers. For example, you
could post the SHOWTIME command to your website every minute if you
so desired.
You can use SMAPIweb in many
different ways. Using SMTP-X and SMAPI you can:
- INTEGRATE output from your command
line, batch jobs, UDC's, and applications with HTML
automatically with the use of HTML templates and save the
content under a POSIX file name, which means you
can post to your website.
SAVE time on lengthy and
time-consuming scripts by using SMAPIweb. SMAPIweb
automates the
"grunt" tasks of integrating your data over and over again with
HTML files and posting the results as URL files.
USE the POSIX file-saving
features of SMAPIweb you can post your Apache
website directly. If you mail large files internally,
you can mail an HTML page witha link to the
file and post the page directly to your website, instead of e-mail
large files. The link (URL) could actually be a
symbolic link pointing to the actual file, so you do not need
to relocate the large file to your website directory.
For SMAPIweb to work, you
provide the HTML in a template file along with the name of the URL
by which to save your data. SMAPIweb does the data
integration and file-saving on the POSIX file
system. Because the POSIX file system is UNIX and URLs
are essentially filenames, you can make SMAPIweb automate
the repetitive process of continually updating a website with
changing content in the same HTML format. This saves
you time and helps you avoid detailed and
time-consuming script-writing tasks. SMAPIweb does
the work for you of integrating your HTML with your output
data. With SMAPI you enable your environment for web updates
via batch jobs, command files, custom applications, or in whatever
fashion your environment demands.
SMAPIweb uses SMTP-X to run silently in the
background waiting for your applications to post updates via
SMAPI. When an update occurs, SMAPIweb post the message
contents to the designated URL instead of e-mail the message.
In effect, you website becomes the recipient of your e-mail
message. You can automate any URL updating process with
SMAPIweb.
SMTP-X and
SMAPImail -- Technical Usage
You can
use SMTP-X in many different ways -- and many of
them invoke the use of the SMAPI application programming interface
for sending electronic mail. Hence the name SMAPImail. You can
capture and mail valuable HP 3000 data from jobs and sessions of all
types, including raw spools files, binary files, job failures, and more.
With SMAPImail you mail-enable any application or process on
your HP 3000.
Three steps toward implementing SMAPImail:
- CONNECTION -- Make sure that
you have connectivity from your HP 3000 to the SMTP host that
you are connecting to. An entry to this machine should
exist in your HOSTS.NET.SYS file or your should run DNS and
enable your RESLVCNF.NET.SYS file.
- GET
STARTED -- Use the SMAPITRY.GATESMTP job packaged
with SMTP-X or the listing below in Step 8 to get familiar
with the SMAPI environment. This job is a basic
template for SMAPI job use.
- APPLY -- Streamline
the use of SMAPImail in your jobs with a SMAPI command.
Here are eight powerful examples that
deploy SMAPImail in the enterprise.
1. Sending a one-line message from a job as an
alert with SMAPImail
You can use
the SMAPI program from within a job stream to send one-line messages
with ease as given in the example below.
RUN SMAPI.GATEMHS;INFO = /job@myco.com/ops@myco.com/job
!HPJOBNUM/Job Failure"
2. Capturing
Stdlist Input from a Job for Mailing with SMAPImail
You can capture data with redirection directly
from a job and send this data in a mail message, as in the example
below.
ECHO some text line 1 >
MSG
ECHO Job number
!HPJOBNUM >> MSG
ECHO end of
msg file >> MSG
RUN
SMAPI.GATEMHS;INFO =
"/job@emailinc.com/ops@myco.com/test/MSG"
3. Using the
Command Line to Invoke Mail with SMAPImail
You can use the SMAPI program to create command
files like the one below for sending mail interactively from your
session command line. Here's an example of a mailx run, imitating
the UNIX mailx command. The SMTP-X product comes with sample
command files, like this one, to get you started.
:mailx
> SMTP-X
MAILX
> Welcome to Mailx
> From? chris
From: chris@emailinchp.com
To? Chris@emailinc.com
> To: Chris@emailinc.com
> Subject? just a text
Text? how you doing anyway?
END OF PROGRAM
:
4. Sending Raw Spool FIles with SMAPI and
SMTP-X
You can use the SMAPI program to
send raw spool files, as in the example here below. This
example sends a spool file and allows the recipient to view the file
with a different name than the original MPE filename, or what we
call the object name. Here the receiving end of the message,
will know the spool file as a ".txt" file, easily viewable
under Windows. You can give any name, which can also
include the use of an extension. With the aid of an extension, any
mail client can double click on the attachment to open it directly.
:RUN
SMAPI;INFO="/ops@myco.com/Chris@myco.com/text spool file/
o4244.out.hpspool=joblist.txt"
5. Sending
attachments with object names with SMAPImail
You can use the SMAPI program to send
attachments with object names either directly or by reference using
indirect files for multiple attachments. The first example
below sends one attachment by name with the object reference.
The second example sends multiple attachments all defined in
another file, one filename per line, also with the indication
of an object name specified on the same line using the equal
sign "= " delimiter, as follows:
:RUN
SMAPI.GATEMHS.EMAIL;INFO="/Chris@myco.com/Chris@myco.com/word
doc/wordmpe.mgegrp.mpeacct= word1.doc"
:RUN
SMAPI.GATEMHS.EMAIL;INFO="/Chris@emailinc.com/Chris@emailinc.com/multiple
files/~binlist.mtamail.email"
Contents of binlist.mtamail.email, the
indirect attachment file:
attach1.mpegrp.mpeacct=word1.doc
attach2.mpegrp.mpeacct=word2.doc
attach3.mpegrp.mpeacct= xcel.xls
6. Doing batch mailers with SMAPI and
SMTP-X
You run batch mailers by putting
all the addresses of you recipients into one file, one per line and
separated by newlines. Then use the indirect specifier ("~") to send
the file with SMAPI. In the following example, a message is sent to
everyone listed in the customers.mpegrp.mpeacct file.
:RUN SMAPI.GATEMHS.EMAIL;INFO=
"/dept@store.com/~customers.mpegrp.mpeacct/yourorder
confirmation/new product
announcement!"
7. Sending HTML mail
You can send HTML mail either by creating
content with HTML and sending this directly with SMAPI, or by using
HTML templates and merging the dynamic content form your job, for
example, with the static web provided by your template
file.
:RUN
SMAPI.GATEMHS.EMAIL;INFO=
/jobrunning@myco.com/ops@myco.com/Product
Announcement/MSG=myobj.txt=htmltmpl.gatemhs.email"
8. Using a job
to send e-mail with SMAPImail
Here's a sample job that you use to
get started which illustrates how easy it is to mail enable a job
with an HTML template.
!JOB
TELLOPS,MGR.EMAIL,OPS;INPRI=8;OUTCLASS=LP,1
!CONTINUE !COMMENT ** This job provides a
template for smapi job sending mail
!COMMENT ** usage in an app with easy to modify
declarations
!COMMENT ** RUN SMAPI.GATEMHS
for help
!PURGE textdata
!
!COMMENT Set
hardcoded values
!SETVAR sender
"opsguy@myco.com"
!SETVAR recipient
"Managers@myco.com"
!SETVAR subject "OPS
Web Posting"
!SETVAR template
"HTMLTMPL.OPS"
!
!ECHO -- Last Updated: > textdata
!SHOWTIME >> textdata
!ECHO -- >> textdata
!ECHO "here is some job output" >>
textdata
!
!COMMENT Assign vars for SMAPI
!SETVAR from "!sender"
!ECHO !recipient > to
!SETVAR subj "!subject"
!SETVAR objectname "Mydoc.TXT"
!SETVAR templ "!template"
!
!COMMENT Run SMAPI with loaded values
!RUN SMAPI.GATEMHS;INFO="/!from&
!/~to&
!/!subj
from #j!HPJOBNUM&
!/textdata=&
!!objectname=&
!!templ
!
!COMMENT Error Recovery
!SETJCW CIERROR = OK
!IF CIERROR <> OK THEN
! SETJCW JOBCOND = FATAL
! TELLOP TELLOPS -- Job failure in
TELLOPS.OPS
!ELSE
! COMMENT STREAM TELLOPS.GATEWEB;IN=,,1
! COMMENT SET STDLIST=DELETE
!ENDIF
!
!EOJ
9. Creating
SMAPI files on the fly with SMAPI and SMTP-X
You can create your own SMAPI file in any
HP3000 editor program so long as you strictly conform to the SMAPI
format as defined in the next section.
Example SMAPI file that sends
displayable text (control characters are in first column):
+
D Apr 12,
2000 7:00 PM
N Chris
FLYNN/EMAIL/HQ&
Chris@emailinc.com
T Ginger Morison&
Ginger@emailinc.com
C Chuck Long
S Test
D file
M
Here is some text for the
test. You can put many lines of text in a message.
F mympefile.mpegrp.mpeacct=mydoc.doc=mytemplate=myurl
+
SMTP-X and SMAPIweb -- Technical
Usage
You can use SMAPIweb in many different
ways -- and many of them invoke the use of the SMAPI
application programming interface. You can capture valuable HP 3000
data from jobs and sessions of all types, including raw spools
files, query outputs, data extractions, etc. With SMAPIweb you can now
publish this collected data directly on your website. Below,
are a few ways in which you can use SMAPIweb to post
data directly to your web site or POSIX file system.
Here are three examples deploying
SMAPIweb in the enterprise. The method is exactly the same as
would be for SMAPImail, except for the addtion of the URL parameter
(outlined in blue below) that indicates to SMTP-X that the message
contents should be saved as as URL. In the case below
the URL is a website page existing on an APACE web server running
locally on the HP 3000.
1. Using a job
to post to a website with SMAPIweb
!JOB
WEBOPS,WWW.APACHE,OPS;INPRI=8;OUTCLASS=LP,1
!CONTINUE !COMMENT ** This job provides a
template for smapi job
!COMMENT ** usage
in an app with easy to modify declarations
!COMMENT ** You can also use the SMAPI
program
!COMMENT ** with SWEBGATE as in
this example
!COMMENT ** RUN
SMAPI.GATEMHS for help
!FILE
MTAESUB.MTAMAIL.EMAIL=MTAESUB.MTAMAIL.APACHE
!PURGE textdata
!
!COMMENT Set hardcoded values
!SETVAR sender "OPS@myco.com"
!SETVAR recipient "Managers@myco.com"
!SETVAR subject "OPS Web Posting"
!SETVAR template "HOME.OPS"
!SETVAR
urlname "/APACHE/PUB/htdocs/ops/home.htm"
!
!COMMENT Read
values from file if file is there else use hard-coded values
!CONTINUE
!IF
FINFO("JOBVALS.OPS", "EXISTS") = TRUE
!
IF FINFO("JOBVALS.OPS", "EOF") > 0
!
RUN QUAD.LIB.NETBASE
t
jobvals.ops:u
c 1 to ':SETVAR sender
',1 C
c 1 to ':SETVAR recipient ',2
C
c 1 to ':SETVAR subject ',3 C
c 1 to ':SETVAR template ',4 C
c 1 to ':SETVAR urlname ',5 C
xecute all
EXIT
YES
! ENDIF
!ENDIF
!
!COMMENT Read text
from file if file is there and format for HTML/JCL
!CONTINUE
!IF
FINFO("WEBTEXT.OPS", "EXISTS") = TRUE
!
IF FINFO("WEBTEXT.OPS", "EOF") > 0
!
RUN QUAD.LIB.NETBASE t webtext.ops:u
c
:<: :!<:, all
c :>: :!>:, all
c 1 ":ECHO ", all
c 86 " >> textdata ", all
l all
xecute show
all
EXIT
YES
! ENDIF
!ENDIF
!
!ECHO -- Last
Updated: > textdata
!SHOWTIME >>
textdata
!ECHO -- >> textdata
!print webtext.ops >> textdata
!
!COMMENT Assign
vars for SMAPI
!SETVAR from "!sender"
!ECHO !recipient > to
!SETVAR subj "!subject"
!SETVAR objectname "Mydoc.TXT"
!SETVAR templ "!template"
!ECHO !urlname > url
!
!COMMENT Run SMAPI with loaded values
!RUN SMAPI.GATEMHS;INFO="/!from&
!/~to&
!/!subj
from #j!HPJOBNUM&
!/textdata=&
!!objectname=&
!!templ=&
!~url"
!
!COMMENT Error Recovery
!SETJCW CIERROR = OK
!IF CIERROR <> OK THEN
! SETJCW JOBCOND = FATAL
! TELLOP WEBGATE -- Job failure in
WEBOPS.OPS
!ELSE
! COMMENT STREAM WEBOPS.GATEWEB;IN=,,1
! COMMENT SET STDLIST=DELETE
!ENDIF
!
!EOJ
:print jobvals.ops;page=0
"ops@myco.com"
"Chris@emailinc.com"
"Operations Posting"
"home.ops"
"/APACHE/PUB/htdocs/ops/home.htm"
Note! You can create your own SMAPI
file in any HP3000 editor program as long as you strictly conform
to the SMAPI format as defined in the SMAPImail product manual.
Example SMAPI file that
sends displayable text (control characters are in the first
column):
+
DApr
12, 2000 7:00 PM
NChris FLYNN&
Chris@emailinc.com
TChris@emailinc.com
TGinger Morison&
Ginger@emailinc.com
CChuck_Long@drugstore.com
MHere's a quick blurb o
f text
STest D
file
Fmyfile.MPEgrp.MPEaact=msword1.doc=template.MPEgrp.MPEacct
=urlname
Fmyfile2.MPEgrp.MPEacct=contupd2.txt=TempIt2.MPEgrp.MPEacct=urlname
+
2. Displaying
the SHOWTIME command on your WEBSITE from a job using SMAPIweb
You can
implement SMTP-X with SMAPIweb in three steps:
-
Create the HTML template file
-
Specify URL posting
information
-
Create the job stream or command file
Create the Template
File
You must create an ASCII
file (suggested: TEMP;REC=-132,,,ascii) to
hold your HTML. Create this file on the HP 3000
in the local group where you run the SMAPI command to begin with
as a staging area. With SMAPIweb you can now
publish this data collected with SMAPI directly on your
website. Here’s how.
Insert the string <!HP 3000 DATA> somewhere in your
HTML where you want to see displayed the contents of your
SMAPI captured data. This
string must begin in the first column of the line it appears
on.
Since the string is an HTML comment, it will not affect the
file in any way other than to flag where the HP 3000 data
goes.
Save the file on your HP 3000 as a standard ASCII file (not
a binary or byte stream file, unnumbered).
Remember the name of this file, for this is the first piece
of important information that you need to get started. Here
is a print out of HOMET.MTAMAIL.APACHE, the template file used in
this example.
<html>
<head>
<title>E-Mail, Inc.</title>
<link rel="STYLESHEET" type="text/css"
href="stylesheets/email.css">
<meta NAME="description" CONTENT="Internet
Security and SMTP software">
<meta NAME="keywords" CONTENT="X9,
Prowler, SMTP-X, SMTP, HP, HP3000, security,
</head>
<body>
<table WIDTH="100%" BORDER="0">
<tr>
<td
WIDTH="5%"> </td>
<td WIDTH="85%" align="left"
class="section"> </td>
<td
WIDTH="10%"> </td>
</tr>
<tr>
<td WIDTH="5%"> </td>
<td WIDTH="85%" align="left" class="section">Welcome to
E-Mail, Inc.
<p></p>
<!HP
3000 DATA>
</td>
<td
WIDTH="10%"> </td>
</tr>
<tr>
<td WIDTH="5%"> </td>
<td WIDTH="85%" align="middle"> </td>
<td WIDTH="10%"> </td>
</tr>
<tr>
<td
WIDTH="5%"> </td><td WIDTH="85%" class="text">
E-Mail, Inc.
provides external communication
for Hewlett Packard
customers through host-based connect
products. These
products include:
<ol>
<li>SMAPI/mail is a gateway that
connects your HP to
any SMTP wide area or local Internet
<a href="smapimail.htm"
class="link">See
</li>
<li>SMAPI/web updates your
local website instant
<a href="smapiweb.htm"
class="link">See
< /li>
</ol>
</td>
<td
width="10%"></td></tr>
<tr>
<td width="5%"></td
><td width="85%">
</td>
<td
WIDTH="10%"> </td>
</tr>
<tr>
<td WIDTH="5%"> </td>
<td WIDTH="85%"
align="middle"> </td>
<td WIDTH="10%"> </td>
</tr>
<tr>
<td
WIDTH="5%"> </td>
<td
WIDTH="85%">
</td>
<td
WIDTH="10%"> </td><
BR></tr>
</table>
</body>
</html>
Specify the URL Posting
Information
Identify the name
of the uniform resource locator (URL) you want to save the sum
total of data and HTML as on your website.
With SMAPIweb you publish this data collected with
SMAPI directly on your website. Remember this name, as well,
for this is the second important piece of information that you
need to get started.
Make sure that the URL posting file is a
valid POSIX file name. Try building the file manually first
to make sure that you have a valid filename.
Create the Job stream
The only other item that you need to launch
your first SMAPIweb job is the jobstream itself. You
can used command files, but in this example we are demonstrating
job stream use. You use SMAPI to create a
posting for SMTP-X directly from your job. Here
is an example that uses SMAPI to pass the name of the HTML
template file and the name of the URL file (bold) to save the
posting on the website. The name of the object
(italicized) is not required but you should use a space as a
placeholder or use a dummy value for reference to the object
anyway.
Use the examples in the GATEWEB.EMAIL group in the SMTP-X
package to get you started.
!JOB
SMAPITRY,MGR.APACHE,MTAMAIL;INPRI=8;OUTCLASS=LP,1
!CONTINUE
!COMMENT ** This job illustrate the use of
the SMAPI program
!COMMENT ** with web posting
!PURGE textdata
!CONTINUE
!SHOWTIME > textdata
!ECHO -- >> textdata
!ECHO
!<i!> Welcome to SMAPI!! !</i!> >> textdata
!ECHO .. WEBGATE updates this page each
minute &
! with MPE's SHOWTIME command! >>
textdata
!ECHO This website is using webtime! >>
textdata
!ECHO !<p!> !<i!> WEBGATE is
!</i!> Here! !</p!> >> textdata
!
!COMMENT ** below some are vars and some are
indirect file
!COMMENT **
references depending on SMAPI usage.
!COMMENT ** RUN SMAPI.GATEMHS for
help
!SETVAR from "ops@mycom.com"
!ECHO Chris@emailinc.com > to
!SETVAR subject "Smapi is here!"
!SETVAR objectname "MYDOC.TXT"
!SETVAR template "HOMET.GATEWEB"
!ECHO
/APACHE/PUB/apache_1.2.5_mpe/htdocs/home.htm >
urlname
!
!COMMENT ** The SMAPI command
!RUN SMAPI.GATEMHS;INFO="/!from&
!/~to&
!/!subject&
!/textdata=&
!!objectname=&
!!template=&
!~urlname"
!
!COMMENT
** Error recovery
!SETJCW CIERROR = OK
!IF CIERROR <> OK THEN
! SETJCW JOBCOND = FATAL
! TELLOP WEBGATE -- Job failure in
SMAPITRY.GATEWEB
!ELSE
! STREAM SMAPITRY.GATEWEB;IN=,,1
! SET STDLIST=DELETE
!ENDIF
!EOJ
3.
Displaying the SHOWTIME command on your WEBSITE from a job using
SMAPIT
You can use also create the SMAPI file
directly in your job and skip using SMAPI and run SMAPIT instead
directly from the job to post the url message. In
this example, we create the SMAPI file directly in the job and
call it “D1212121” because we must call all our SMAPI files in the
?####### format (where ? is defined in the SMAPI UDC as the letter
"D").
!WEBTIME,MGR.APACHE,MTAMAIL;INPRI=8;OUTCLASS=LP,1
!CONTINUE
!PURGE MSG
!CONTINUE
!PURGE D1212121.MTAMAIL
!CONTINUE
!SHOWTIME > MSG
!ECHO -- >> MSG
!ECHO
!<i!> Welcome to SMAPI!! !</i!> >> MSG
!ECHO .. WEBGATE updates this page each
minute &
! with MPE's SHOWTIME command! >>
MSG
!ECHO This website uses WEBTIME! >>
MSG
!ECHO !<p!> !<i!> WEBGATE is
!</i!> Here! !</p!> >> MSG
!SAVE MSG
!ECHO + > D1212121
!ECHO D >> D1212121
!ECHO NChris@emailinc.com >>
D1212121
!ECHO TChris@emailinc.com >>
D1212121
!ECHO SSmapi is here! >> D1212121
!ECHO FMSG.MTAMAIL=WB.TXT=HOMET.GATEWEB=&
!/APACHE/PUB/apache_1.2.5_mpe/htdocs/home.htm
>> D1212121
!ECHO + >> D1212121
!SAVE D1212121
!SETJCW CIERROR = OK
!SMAPIT
!IF CIERROR <> OK THEN
! SETJCW JOBCOND = FATAL
! TELLOP WEBGATE -- Job failure
in WEBTIME.GATEWEB
!ELSE
! STREAM WEBTIME.GATEWEB;IN=,,1
! SET STDLIST=DELETE
!ENDIF
!EOJ
Frequently Asked Questions
(FAQ)
What are SMAPImail and SMAPIweb?
-- SMAPImail and SMAPIweb are one product -
SMTP-X. When you purchase SMTP-X you receive the power of
SMAPImail and SMAPIweb, two names given to the two different sides
of SMTP-X, one, the e-mail posting or normal SMTP delivery and ,
two, the web posting side, a unique element of
SMTP-X.
What is SMAPImail?
-- SMAPImail is a powerful combination of a mail
gateway (SMTP) and an API (SMAPI) that allows for total mail
integration of the HP3000 with the Internet. SMAPImail
(the gateway) provides complete inbound and outbound mail
with full MIME base-64 encoding. In addition,
SMAPImail provides an easy-to-use front-end in the form of SMAPI
(the API) to mail-enable the HP 3000 environment, including batch
jobs, command files, programmatic access and more.
What is SMAPIweb? -- SMAPIweb
is a URL posting product to publish any output from your HP 3000
directly to your website or POSIX file application. SMAPIweb
provides e-mail confirmation, as well, through SendMail for
confirming webposting events. Any HP 3000 data can be posted
to a website including output from jobs, raw spoolfiles, data base
queries, etc. HTML templates provide integration with web
presentation for your data.
Are SMAPImail and SMAPIweb just for the HP
3000? -- Yes. SMAPI products are designed
exclusively for the HP 3000 and allow ANY HP 3000 in the line of
mini-computers by Hewlett-Packard to exchange SMTP mail via the
Internet or any local area TCP/IP network intranet or do web
posting to the POSIX file system.
What is SMAPI?
-- SMAPI stands for 'Simple Mail Application Program
Interface' and is exactly what the name applies. SMAPI is the
most straight-forward front-end designed ever for the intuitive
sending of e-mail through the use of flat files. SMAPI
resides exclusively on the HP 3000.
What does SMAPI do? --
SMAPI provides intuitive and easy-to-use API
that sits directly in front of the
gateway, providing snap-in hooks for
your applicatons, command files, batch jobs, etc.
With SMAPImail you will enrich the HP3000's
entire environment. SMAPI allows you to very quickly and
easily mail-enable your jobs, send alerts, send and receive
attachments readable by any mail-client, pick up raw spool
files, provide job listings, integrate batch mailings and much
more.
MIME-64 Encoder
MPE Program for HP
3000 -- Free MIME anytime! You can have a
free copy of our MIMEX converter program for outbound use for
messaging from your HP 3000. This code has been extracted and
compiled from the actual SMTP-X code so it's MIME methods are fully
tested and time proven on the HP 3000. This a shareware
version and e-Mail, Inc. fully disclaims all liability fo the use of
this program on your machine. Download the MPE program
file directly as a WRQ Reflection LABELS file at mimex.
To use mimex upload the file to your
machine with the LABELS option using Reflection and run as any mpe
program. Self-help is available for this program by simply
running the progam with no parameters. RUN MIMEX. To
use the mimex program supply the name of any MPE file (ASCII or
BINARY) in the INFO= command line parameter. For
example:
RUN
MIMEX;INFO="mydoc.mpegrp.mpeacct"
MIME Conversion
-- Mime is taking three octets of a data stream
and outputting four using a base-64 alphabet. You increase the
size of a file by 25% when you encode. But we view this as
acceptable because we need 7-bit data transmission of ASCII
characters to represent our binary alphabet for cross-platform
ease-of-use.
Notes on
MIMEX -- The MIMEX program creates a flat
ASCII file with the data from your file converted to MIME
format. The program is smart enough to take any kind of MPE
file (binary, ASCII, spool) with record length <= 1024 and write
the MIME converted output directly into a flat ASCII file with a
record size calculated large enough to hold the MIME-expanded
data. You can then pass this file created directly to your
application. Also, you'll have to output a MIME header on your
own, but you can do this with a few ECHO commands from a job.
Future shareware versions could use a MIME template file letting
you tailor your own MIME header or accept a workable default
version.
Note!
This version assigns an arbitrary file code 666 only
so the SMTP-X gateway can recognize the binary file is
already base 64 encoded and therefore needs to be transmitted as
ASCII not binary 8-bit data. You don't want to encode the MIME
into MIME again! Then you'll just have an ASCII MIME file on
the other end.
Plus!
You can pass the Windows name of the object along with
the name of the MPE file. For example:
RUN
MIMEX;INFO="mydoc.mpegrp.mpeacct=objectname.ext"
Interesting! The object name
information is written to the user label of the mime created
file. You apps can read this user label (only if they really
want to) to retrieve the name of the object with FREADLABEL at any
point if necessary or desirable in your app. SMTP-X uses this
label to pass the windows file name (name.ext) for the given MPE
file.
These files can be passed directly to SMTP-X
even though there would be little reason to do this since you can
you can just pass the file directly to SMTP-X without the MIME
conversion.
Pricing
The HP 3000's SMTP-X All SMTP-X Products include SMAPImail and SMAPIweb.
Are prices are independent of machine size and RTC fees. It's
one fee per machine.
Master License:
SMTP-X with SMAPImail and
SMAPIweb together
one price $799.00 per machine copy
There's
Support:
Full 24-hour
e-mail support, 9-5 telephone Message Support / Free Fix
Support - $699.00 per machine
annually.
Free DEMO:
Receive a DAT-tape 30-day demo
mailed directly to you by sending e-mail to us@emailinc.com or,
Try
DOWNLOAD:
Download
the time trial and complete Manuals included in a Quark setup
file. If you don't have Quark Download Quark, too (Quark is a
shareware compression utility).
FAQ or email questions to us@emailinc.com .
You must register
only your name and address to receive a free evaluation copy of the
products at demos. Contact us@emailinc.com with
any comments.
Demos
Free Download -- Downloads are
available free from the Internet now. Try
one one of the most established and
time-tested Hewlett-Packard 3000 e-mail
gateways ever, serving hundreds of HP 3000
machines messaging daily.
For Downloading a QUARK file for immediate
installation via web:
For Software on DAT or via e-mail with
Complete Manuals included send
email to: us@emailinc.com
For
Smtp-x sent to you electronically direct e-mail to us@emailinc.com for an e-mail installation kit.
The entire product is under 2 megabytes -- you can contact
us@emailinc.com.
*Note!
Quark shareware is HP 3000 compression utility and used
by all SMAPI installations via the web. If you don't have
quark, download this the QUARK9 compression utility first
(LABEL option WRQ Reflection file transfer is easiest).
QUARK shareware comes with the SMTP-X product and the entire
software can be installed from a quark file. You can also
request a DAT tape of us via e-mail with enclosed shipping
address and contact us@emailinc.com.
Messaging Solutions for HP 3000 Computers.
Publications
Webifying
your HP 3000 -- Download this help document here to help you
bring your HP 3000 up-to-date with various Internet
technologies. Help is available for several Internet
applications on the HP 3000 including information on
implementing Apache, Java, Enhydra, Samba, DNS, Syslogix and
more.
This publication is available as Acrobat PDF
file directly here at Webifying your HP 3000.
This document is also published in the November 2000 CSL/MPE Catalog and Cross-Reference Index of
User-Contributed Software for HP 3000 Series
Computers.
E-Mail,
Inc. also provides a free mime converter, mimex, and extensive documentation for all
products.
|
