Copyright 2000-2023 Corvedia, Inc. All rights reserved

Secure Easy Internet Messaging is simple and reliable messaging for the Internet.

January 2023

Introduction

Getting Started

Seim Software Installation
       Windows Installation
       Testing Windows Installation
        Linux/Unix Installation
       Testing Linux/Unix Installation
        AS/400 Installation
       Testing AS/400 Installation
        Mac Installation
        Other Platform Installation (OS/2 eCS)

Integration Considerations

Firewall Considerations

Switches

Utilities

Trademarks

Secure Easy IM uses the Internet eforward messaging protocol which is listed by IANA (Internet Assigned Numbers Authority). Listed as port 2181 at http://www.iana.org/assignments/port-numbers.

Message delivery is assured and verifiable. Strong encryption is provided using AES.

Corvedia provides full integration support.

Secure Easy IM is a java application which runs several ways:

Using a desktop application.

Executing a command line (PC batch command, Linux/Unix script, AS/400 CL, Mac X script)

From a java program or command shell
 

 

Command Line
Enter the command line directly or use the command line editor to create a suitable batch command.
The editor can be found in Windows from the menu:
Start - Programs - Secure Easy IM - Setup Command Line
and select Command Line
or for all others run the appropriate batch command named 'setup_cli' in /Eforward/bin.

Group Command
Create a file named 'send.properties' in the directory /Eforward/properties and start the appropriate batch command named 'group' in /Eforward/bin.

The send.properties file can be setup using the command line editor.
The editor can be found in Windows from the menu:
Start - Programs - Secure Easy IM - Setup Command Line
and select Group
or for all others run the appropriate batch command named 'setup_cli' in /Eforward/bin.

The Group Command enables simultaneous execution of multiple commands in a single Java Virtual Machine (JVM). The commands are listed in a 'Properties File".

The behavior of Secure Easy IM is controlled by a set of switches that are set when started. Documentation and examples for the switch settings can be found in the \Eforward\eforward_readme file.
Return to Table of Contents

Getting Started
Secure Easy IM is available as a subscription service offered by Corvedia and as licensed software. Both are available through Corvedia or an authorized reseller.

To begin interchanging data with your Trade Partners, do the following:

Verify that java is installed.  Java can be down loaded from java.sun.com or OEMs. If you have trouble finding java contact Corvedia for assistance.

Secure Easy IM can be down loaded from www.corvedia.com and easily installed.

Access the Secure Easy IM site to setup messaging. The Corvedia help desk will provide information on setups.

Integrate Secure Easy IM with your current operations. See Integration Considerations .

A representative will provide you with your initial administrator ID and password. You may change your password and add additional administrators as desired. Detailed instructions for completing creating iBoxes and proposing/approving trading relationships can be found on the Corvedia web site.
Return to Table of Contents

Secure Easy IM Software Installation
Secure Easy IM is installed on any host supporting java.

This Guide includes instructions for installations on the following Operating Systems

Windows 95/NT/2000/XP/2003
Unix
Linux
AS/400
Mac OS X
Mac Classic
OS/2
eCS

Please contact your Corvedia representative for assistance with installation in other operating environments.
Return to Table of Contents

Windows Installation
Secure Easy IM  Microsoft installers are available from  www.corvedia.com

Download and install Sun Java Windows (any version).

Download and execute Secure Easy IM Windows

Secure Easy IM classes reside in \Eforward\java.
Return to Table of Contents

Testing Windows Installation
The testing will be done using the command line option.
In the menu:
Start - Programs - Secure Easy IM
there are two folders for the send and receive. Files for sending can be copied to the send folder.

Connect to the Internet.

Drop a file in the directory \Eforward\send (or the send folder.)

From the Start - Run menu enter "\Eforward\bin\demo_send" and press OK.

From the Start - Run menu enter "\Eforward\bin\demo_receive" and press OK.

Received files can be found in C:\Eforward\recv (or the receive folder.)

The Secure Easy IM desktop editor can be used to review the send and receive batch commands and experiment with changing the switch settings. See the Secure Easy IM Guide for documentation of the various available switch settings.

The status of the files can be checked by logging on to Secure Easy IM site using:
Username: iBox1
Password: demo1

Once logged in select iMessages and press Next, you will see today's messages which have been sent and received.
Return to Table of Contents

Linux/Unix Installation
The Secure Easy IM for Linux/Unix are available from www.corvedia.com

Download and install Java for the correct Unix platform.

Download seim.tar.

Cd to /usr/local or the directory of choice.

Enter: tar -xvf seim.tar

Delete the temporary files in the send, send2, recv, and recv2 directories.

The Secure Easy IM classes reside in /usr/local/Eforward/java.
Return to Table of Contents

Testing Linux/Unix Installation
The testing will be done using the command line option.

Connect to the Internet.

Drop a file in the directory /usr/local/Eforward/send.

enter "/usr/local/Eforward/bin/unix/demo_send.sh

enter "/usr/local/Eforward/bin/unix/demo_receive.sh

Received files can be found in /usr/local/Eforward/recv.

If you are using an X terminal the Secure Easy IM desktop editor can be used to review the send and receive shell scripts and experiment with changing the switch settings. The shell scripts can be edited directly with vi. See the Secure Easy IM Guide for documentation of the various available switch settings.

The status of the files can be checked by logging on to Secure Easy IM site using:
Username: iBox1
Password: demo1

Once logged in select iMessages and press Next, you will see today's messages which have been sent and received.
Return to Table of Contents

AS/400 Installation
Secure Easy IM for AS/400 is available from www.corvedia.com
The zip file seim.zip is used for the AS/400

Seim runs from a CL once installed.

Install java from AS/400 Licensed Programs (installed by default)

Download seim.zip file from Corvedia.

Copy seim.zip to the IFS file system

Run QSH from a command line.

Change directory to root using "cd /"

Extract using "jar -xvf seim.zip"

Secure Easy IM classes reside in /Eforward/java.
Return to Table of Contents

Testing AS/400 Installation
The testing will be done using the command line option.

Connect to the Internet.

Drop a file in the directory /Eforward/send.

copy the text from demosend.pgm to a CL and run.

copy the text from demorecv.pgm to a CL and run.

demorecv.pgm:
PGM
                 JAVA    CLASS(eforward.client.EdiSend) PARM( +
                                '-hefw.corvedia.net'       +
                                '-p'                       +
                                '-r'                       +
                                '-k/Eforward/recv/'        +
                                '-l/Eforward/logs/Revlon' +
                                '-oiBox2'                  +
                                '-wdemo2'                  +
                                '-a'                       +
                                '-e'                       +
                                '-t,-0' )                  +
                       CLASSPATH('/Eforward/java')
                GOTO    CMDLBL(ENDIT)
  endit: endpgm

Demosend.pgm will convert the file to ASCI and send it from iBox1 to iBox2 . Demorecv.pgm will retrieve the file and convert it to EBCDIC from the iBox2 mailbox.The switch settings are set so Seim will terminate after sending all files in the send directory. Note that this is a shared demo/testing facility and it is possible someone else will be test receiving from iBox2 as you are sending to it--so don't test with any sensitive data. Successfully sent files will be archived in the directory /Eforward/arc (moved to the arc directory from the send directory.)

Received files can be found in /Eforward/recv.

See the Secure Easy IM Guide for documentation of the various available switch settings.

The status of the files can be checked by logging on to Secure Easy IM site using:
Username: iBox1
Password: demo1

Once logged in select iMessages and press Next, you will see today's messages which have been sent and received.
Return to Table of Contents

Mac
Secure Easy IM for Mac Classic (7.6.1-9.1) or Mac X is available from www.corvedia.com

Install java

Download Seim Mac OS Classic or Mac X.

Select the down load file from the desktop and install.

Remove the down load file.

Start Secure Easy IM and select Profile from the top menu and then New from the drop down.

Enter a Profile name, iBox name(iBox1), Password (demo1) and Partner iBox name (iBox2)(Partner iBox is only needed for sending files which are not in EDI format.)

Select send or receive and save the Profile.

Place a file in the Seim Send folder.

From the Secure Easy IM main screen select the Profile entered for sending and press Start.

Or select the profile entered for receiving.

The status of the files can be checked by logging on to Secure Easy IM site using:
Username: iBox1
Password: demo1

Once logged in select iMessages and press Next, you will see today's messages which have been sent and received.

Secure Easy IM classes which do not have icons can be made into applications if the Apple Java JDK is installed.
Return to Table of Contents

Other Platform Installation
All platforms (except for Mac Classic) can be installed using seim.zip downloaded from www.corvedia.com

Download and install java for the correct platform.

Download seim.zip from Corvedia.

Unzip seim.zip and retain the paths.

If the java JDK is installed it can unzip the file using: jar -xvf seim.zip

Integration Considerations
Sending and receiving can be done in one command line. Typically one command for sending and one for receiving. Each command line contains a series of switches for various options. The commands may be executed 'in-line' with other processing and called by a scheduler or a running program. Seim can also run as a Service or by other user or Corvedia supplied programs.

In the simplest (and default) implementation, messages to be sent are deposited into a specified directory e.g. C:\Eforward\send\ from which they will be sent by Seim . Files (messages) once sent will be moved to the specified archive directory e.g. \Eforward\arc\. This is proof that the file has been sent. If the login password or trading partner is not setup the file will be archived with an error message as part of the name.

Seim will receive messages to a specified directory e.g. C:\Eforward\recv\. Pre and post processing utilities are available to assist in preparing messages for sending and for further processing upon receipt.
A typical implementation will use SplitDests for files containing multiple messages with EDI headers (ISA,TDCC,EDIFACT, etc) to create multiple files, one for each message found in the input file. For details see instructions for using SplitDests . XML and proprietary message formats would not use SplitDests.

For receiving, a typical implementation will use Mv to create a unique file name for incoming messages. Mv can also be used to force a desired segment terminators. For details see instructions for using Mv .
Return to Table of Contents

Firewall Considerations
If you are behind a firewall, configure the firewall to allow outbound TCP/IP connections on port 2181. This port is used by Seim to send and receive messages.

Seim can use a UDP notification port. If desired an inbound UDP port can be opened in the firewall pointed to a local machine using Seim. No log-ins or sessions are established through this port. It is a short message that notifies Seim messages are ready to be received.

Return to Table of Contents

Switches
Secure Easy IM is executed with the following command:
java -cp C:\Eforward\java eforward.client.EdiSend
(or Linux: java -cp /usr/local/Eforward/java eforward.client.EdiSend)

    -h{host}
    -p[process][,destination process]
    -l{log path}
    -o{local iBox}
          The origin (login iBox) will be derived from the EDI header if this parameter is not used.
    -k{batch archive/receive path}[,days]
    [-v][1][,filename] Verbose output. With the 1,filename will write to a logfile instead of to the console screen.
    [-w{password}]
    [-d{remote iBox}]
          The destination will be derived from the EDI header if this parameter is not used.
          -da,{file} will derive the destination from the EDI header and then use an alias substitution file.
    [-x[extent size]]
    [-r(receive mode) [[j,]process (FILE)]]
    [-i{process parameters}]
    [-j{batch send path}[,{error path]]
          With error path set files which have errors durring sending will be moved to this directory.
    [-f{file}]
    [-a[retries]] (causes program to exit after sending or receiving is done)
    [-e(EBCDIC)[srb]]
    [-m(error){smtp host},{email from},{email to[,email to,...]}]
    [-n] Just do one time/file.
    [-t{[eForward (server) port][,local port][,local address][,poll rate]}]
    [-z{security key file}]
    [-q{stopfile}]  Magic file to end this process.
    [-b,{BaseSegment},{Properties}] Sets the SeIM base directory where the porperties directories are found.
           The properties directory name can be changed to desired name.

See the \Eforward\eforward_readme file for details.
Return to Table of Contents

Utilities
Clear
efclient.bin.Clear
Clears a directory of files older than a certain age.

Options:
 -d Number of days to preserve. Files older than this are deleted.
 -f Files to delete. '*' is all files.
 [-c{minutes}] Cycle delay
 [-l{directory/path}] Directory the directory listings file will be written to.
 [-q{stopfile}]  Magic file to end this process.

Cmd
efclient.bin.Cmd

This is used for running batches of commands on a schedule.  Commands are placed in a command file, with their own options.

  -p{Path/to/File} The location of the cmd file to be run.
  -v Turn on verbose output.
  -c{minutes} Cycle delay.
  [-q{stopfile}]  Magic file to end this process.

Pack
efclient.bin.Pack

This program packs multiple files into one file for sending via SeIM.  Used
to reduce the number of connections needed.  (And therefore the resources used.)
Mv of recent vintage can unpack the files into their original forms.  (Note that
this is a fairly new utility.)

Options:
  -f{file} The path to the files to be packed.
  -k{destination path} The path to the directory the pack file(s) will be placed in.
  -j{archive path} A location where the unpacked files will be archived.
  -o{orig} An iBox sender for the pack archive.
  -d{dest} An iBox receiver for the pack archive.
  -i[delay] A check to see if the files are still being written.
  -c{count} The maximum number of files to be placed in one pack archive. Default is 50.
  -l{logfile} The path to the logfile.
 

SplitDests
This program will split files containing multiple messages (ISA,TDCC,EDIFACT, etc) based on the receiver Id's contained in the headers. SplitDests uses the 'move' command to place the resulting file(s) into the sending directory. This eliminates the possibility that Seim will attempt to send a file while being written.

Example:
java -cp C:\Eforward\java efclient.bin.SplitDests -f\Eforward\send2\edi* -k\Eforward\send -v -r

efclient.bin.SplitDests

Splits an X12 file with multiple messages into multiple files, one per message.

Options:
  -f{Path/to/Files/} Path of the original files.
  -k{Path/to/Dest} Path of the output files.
  -r Remove original file after creating output files.
  -n Remove all newlines from the file before processing.
  -l{Path/to/log} Creates a daily log file.
  [-i][time]  Delay to prevent "file in use" errors. Set time to zero to disable.
  [-g][x,]{Path/to/file} Send to groups specified in mapping file.
          [x,] Drops orginal file.
  [-j][Path/to/folder] Path for orginal file archives.
  [-a] Groups files together based on destination.
  [-e],[Path/to/file] Send in EBCDIC with optional character mapping file.
  [-q{stopfile}] Magic file to end this process.
  [-s]{segment terminators}[d[new delimiter,new subelement]] Changes X12 and TDCC control characters
        ASCII character values.
        example -s126,13,10d42,94
  [-d]{segment terminators} Changes EDIFACT control characters
        ASCII charater values
  [-t] Strips all 8-bit characters.

Files split out will be named as follows:
receiverid_unique_sequence
Where:
receiverid = receiver ID in header (EDI envelope)
unique = unique file number
sequence = sequential number of message in file

Seim can send using  the -f filter to select files to be sent to
a specified iBox, e.g. -fABC* which will send files with names starting with 'ABC'
to the iBox indicated in the -d switch or, if the -d switch is omitted, in the receiver
ID of the Interchange Header. The filter -f* will send all files deposited in the send directory.
Return to Table of Contents

Mv
This program is provided to move incoming files to another directory after the receive is complete. This will be done instantly if the new directory is in the same file system. Mv can also rename the file with a unique name to avoid the possibility of replacing an existing file before processing. Mv can also be used to replace incoming segment terminators with a specified segment terminator. Mv is invoked as an option in the -r switch contained in the receive command line.
Use:
Mv (Normally used in the -r,j switch of EdiSend.  Full path is efclient.reciever.req.Mv)

Call syntax:  Mv /Path/to/Destination [options]

Options:
  [-s]{segment terminators}[d[new delimiter,new subelement]] Changes X12 and TDCC control characters
        ASCII character values.
        example -s126,13,10d42,94
  [-e]{segment terminators} Changes EDIFACT control characters
        ASCII charater values
  [-p]{properties file} Do EDI header rewrites. (Specified in the properties file.)
  [-a] Append to the output file instead of creating a new one for each message.
  [-t] Include first X12 type in file name.
  [-u] Create unique output file names.
  [-c{Directory/path}] Copies the (original) file to the specifided directory as well as doing the normal move.
  [-f{extention}] Appends a fixed extension on all file names.

Example:
-r"j,Mv C:\Eforward\recv2 -s126 -u"
    makes a tilde( ~ )be the segment terminator and names to a unique name.
-r"j,Mv C:\Eforward\recv2 -s126,13,10"
    makes a tilde, carriage return, new line( ~ CR NL )be the segment terminator.
-r"j,Mv C:\Eforward\recv2 -t -u"

Return to Table of Contents

Information in these materials is furnished for informational use only, is subject to change without notice and does not represent a commitment on the part of Corvedia, Inc. These materials, as well as the software described herein ("Software"), are furnished under license: there is no transfer of title. Corvedia, Inc. assumes no responsibility or liability for any errors or inaccuracies that may appear in these materials. Use these materials at your own risk.

Trademarks
Secure Easy IM, Seim, Secure Easy Internet Messaging, eforward, Corvedia, Release Check, ID Map are Service Marks of Corvedia Inc. Windows is a Trademark of Microsoft. AS/400, OS/2 are Trademarks of IBM. Mac is Trademark of Apple. Java is a Trademark of Sun.