Table of contents

Full text search

Use and configuration

Basic information

Current version

Installation requirements

You can determine the version you have installed:

Software downloads

Current version

Request a test installation of gsmtext on the Toolmaker homepage

Hardware for communication with the SMS network

There are various options for connecting the IBM i system to the SMS network.

• GSM module - possibly via a communication server ("Comport") - this is the most common variant - outgoing and incoming SMS

• Modem - synchronous or asynchronous - outgoing SMS only

• TCP/IP connection via an SMS provider (e.g. eCom) - no separate hardware is required for this, the Ethernet card in the IBM i system is sufficient

The pageHardware for communication with the SMS network contains information about the supported Hardware products and the support SMS networks (2G, 3G, 4G).

Initial and update installation

Initial installation

Selection and installation of the required hardware

Before installation, you must decide which method you want to use to connect to the GSM network(s). MidJet GSM Text supports:

• Direct dial connection via an asynchronous modem using the AT command set, connected to a V.24 communication line and a telephone line. This connection type only supports outgoing messages (from IBM i to GSM telephones). This method is not recommended for current installations!

• Connection via a GSM module connected to a V24 line or a communication server (Moxa or W&T Comserver). Both outgoing messages to GSM telephones and incoming messages from GSM telephones are supported.

• Connection via TCP/IP. The availability here depends on the GSM operator. This option offers bidirectional communication.

MidJet GSM Text supports connections to multiple GSM network operators using different connection methods.

Which method is preferable depends on the required functionality and availability of a communication line, the data communication and the GSM network charges.

Required special rights (SpcAut)

If the installation is not to be carried out under the QSECOFR user profile, then the user profile under which the installation is carried out requires the following special rights

1. *ALLOBJ

2. *SAVSYS

3. *SECADM

4. *JOBCTL

Carrying out the installation

The initial installation is carried out with our Toolmaker PC Installer. If you have the current installation file (if necessaryRequest test installation of gsmtext), please follow the steps in these instructions:

Installation with the Toolmaker PC Installer

If the software is to be installed on several systems, it can be "copied" from one system to other IBM i systems. The remote installation function is available for this purpose in the GSMText configuration menu. Further information can be found on the pageRemote installation.

Initial configuration

After installation, the connection to the GSM network must be configured. If messages are also to be sent by e-mail, an SMTP server must also be configured.

A quick installation program is available for this work, which carries out all the necessary configuration steps after you have entered some data. Alternatively, you can carry out the configuration manually. Both options are described in this section.

Initial configuration with the quick installation program

Open

Manual initial configuration

Open

Open

Open

Open

Open

Open

Open

SSL configuration

If you want to use a TCP/IP connection to your network provider with SSL or send e-mails via SSL, carry out the steps described below to configure SSL. The first steps may already be completed if you are already using SSL for other purposes.

1. Start the commandSTRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)

2. Create the certificate memory according to these instructions:Create a certificate store with the Digital Certificate Manager

   1. Follow the instructions to create a new *SYSTEM certificate store (store for other system certificates).

   2. No certificates need to be created or assigned for GSMText.

3. Then start the following command from its command line:

License code entry

Before you can use any function of GSMText, you must enter the license code. Use F23 to start the license code entry.

Refer to chapter 8 for information on how to use this program.

If you have completed the quick installation, go to the Installation check section, otherwise continue with the Manual installation.

Installation check

Now you can check the installation by sending a message. To do this, go back to the MidJet GSM Text menu and:

Enter the following in the user file with Selection 11 enter another entry.

Start the MidJet GSM text subsystem. To do this, use Selection 21.

Create with Selection 1 a message.

If you have installed a GSM module, check the reception quality. From the main menu, select Selection 20 Configuration, then Selection 4 Communication description. Enter 8 before the configuration used, normally GSMT34. The signal quality should be at least 10. If the reception quality is lower, move the antenna.

The first part of the installation is now complete. Now carry out the planning and system check setup using selection 3 on the configuration menu. Use 10 on the main menu to set the selections for monitoring operation. Use selection 20 to specify which commands are to be received by the cell phones.

It is highly recommended that you carefully read the chapter describing all configuration options. You will then be able to configure MidJet GSM Text to best meet your requirements.

Update

Please note: For a new version with a Change the version number before the dot (VV.RR) you need anew license code.

Installing new versions is completely straightforward. Simply carry out the following steps:

1. Register under QSECOFR.

2. ENDGSMTSBS

3. ENDTCPSVR SERVER(*HTTP) INSTANCE(GSMTEXT)

4. WRKOBJLCK GSMTEXT/USUSERP *FILE

   1. The displayed list should be empty. If not, terminate the jobs that are causing these locks and try again.

   2. Such locks could exist, for example, if a second IBM i system with gsmtext uses this system as an "SMS gateway".

5. WRKOBJLCK GSMTEXT *LIB

   1. The list should also be empty here, if not, then terminate the jobs that lock the object.

6. WRKOBJLCK GSMTEXT *USRPRF

   1. The list should also be empty here, if not, then terminate the jobs that lock the object.

7. Make a backup copy of the GSMTEXT library.

8. Install GSMText as described on the pageInstallation with the Toolmaker PC Installer described.

9. If a new license code is supplied, also carry out this step:

10. When the MidJet GSM text menu is displayed, select F23 and then enter the new license code.

The installation program automatically protects the application data and is ready for operation as soon as the MidJet GSM Text menu is displayed.

If you update from version 3.xx or higher, the installation program automatically converts your files to the new formats. It is recommended that you check the entries in the communication and network files before using the application for the first time. Also change/check the values in selection 10 of the configuration menu if you want to use the new operation monitoring function.

MidJet GSM Text should now be ready for operation. Start the subsystem with selection 21 and create a message with selection 1 to ensure that the new version is installed.

Change to a new IBM i system

If you want to transfer GSMText to another system, follow the steps below. This procedure transfers all data from the old system. Make sure that you have a license code from Toolmaker for your new system.

1. Upgrade the old system to the latest version of GSMText.

2. Save the GSMTEXT library on the old system.

3. Register as QSECOFR on the new system.

4. Save the GSMTEXT library back

5. Carry out the upgrade installation as described in the sectionUpdate described above.

6. Execute the CTRGSMT command in a 5250 session

7. When the GSMText menu is displayed, use F23 to enter the license code for the new system.

8. Start the command CLRPFM GSMTEXT/MWMSQMP from a command line

9. Empty all message queues that are monitored by GSMText, typically QSYSOPR and QSYSMSG as well as other defined message queues

This completes the changeover.

Changing SIM cards

If you replace the SIM card of your GSM transmitter, you must always enter the new PIN code via the configuration program and then exit and restart the GSM subsystem so that GSMText can register and activate your GSM transmitter properly.

Attention

If you only change the SIM card without changing the PIN code in the configuration, the SIM card will become unusable!

Libraries (take into account when backing up data)

Library on IBM i

• GSMTEXT

Further documentation on gsmtext

You can find the English manual as a PDF file here:English manual.

Troubleshooting for gsmtext

Versions and compatibility

Notes on licensing

License types

Different license types are available:

LO =Limited to outgoing messages only The functionality is limited to sending messages without a monitoring function for system operator messages.

LB = Limited bidirectional The functionality is limited to sending/receiving messages without the monitoring function of system operator messages

SO = single user outgoing One user, system operator messages and outgoing messages

2B = Two users bidirectional Two users, system operator messages and incoming/outgoing messages

UO = Unlimited outgoing Unlimited number of users, system operator messages and outgoing messages

U1 = 10 users bidirectional 10 users, system operator messages and incoming/outgoing messages

UB = Unlimited bidirectional Unlimited number of users, system operator messages and incoming/outgoing messages

NT = MidJet NT Monitor Support for the MidJet NT monitor. This product is displayed with NT-n, where n is the number of NTs supported. If n > 99, an unlimited number of NT systems are supported.

The license file and data backup

Show active licenses and options

Uninstalling the IBM i software

To completely uninstall the product, proceed as follows:

1. Log in under QSECOFR or another user profile with the required special rights (*ALLOBJ, *SAVSYS, *SECADM, *JOBCTL) to.

2. Exit the subsystem with the commandENDGSMTSBS.

3. Make sure that MidJet GSM Text is not currently being used. To do this, use the commandWRKOBJLCK GSMTEXT *LIB The displayed list should be empty. If not, fix this and try again.

4. Enter the following command: ADDLIBLE GSMTEXT

5. Enter the following command: CALL GSM730C

6. Enter the following command: RMVLIBLE GSMTEXT

7. Enter the following command: DLTLIB GSMTEXT

8. Enter the command WRKDIRE in. If still present, remove all entries with the user ID GSMTEXT.

9. Enter the command DLTUSRPRF USRPRF(GSMTEXT) OWNOBJOPT(*DLT) 

This completes the uninstallation of the product.

License code protection for high availability, mirroring, backup

As part of a high-availability solution with object mirroring, the GSMText license code on the backup machine is repeatedly overwritten with that of the production machine. This can be prevented:

In principle, the respectiveLicense objectwhich contains the license keyword, from theMirroring removed become.

When transferring libraries from production systems to backup systems, the following license-relevant objects must not be synchronized or must be restored from a backup after synchronization on the backup system.

License code objects GSMText :

Product Library Object type Object name
------------------------------------------------
GSMText GSMTEXT *FILE LCLICDP