MidJet GSM Text User’s Guide Version 6.
This manual is intended for the person responsible for the installation and operations of MidJet GSM Text. It is written in a concise form, reading it carefully will maximise the benefit of the product MidJet AB Box 3251 S-103 65 STOCKHOLM Sweden Telephone: (+46) 8 791 76 50 www.midjet.se Company and product names in this documentation are trademarks for respective trademark owners. Copyright 1994 - 2012 MidJet AB. All rights reserved. This documentation applies to version 6.
Table of content 1 2 3 4 INTRODUCTION 1.1 Overview 1.2 License types 9 9 10 GENERAL CONDITIONS FOR USE 11 2.1 License agreement 11 2.2 Maintenance agreement 11 2.3 Limited warranty 11 INSTALLATION ON THE ISERIES 13 3.1 Preparations for initial installation 3.1.1 Installation pre-requisites 13 13 3.2 Initial installation procedure 3.2.1 Quick install program (recommended) 14 14 3.3 Register license code 15 3.4 Manual installation 16 3.5 SSL Configuration 16 3.
5 6 7 8 MIDJET GSM TEXT FUNCTIONS 25 5.1 Create messages 25 5.2 Monitor system operations 25 5.3 Send SMS messages from the iSeries 27 5.4 Send e-mail from the iSeries 28 5.5 Receive SMS messages on the iSeries 28 5.6 Process received messages 28 5.7 File maintenance 29 5.8 Multiple iSeries 29 MIDJET WIN2000/NT MONITOR FUNCTIONS 31 6.1 System monitor functions 31 6.2 Run commands 31 6.3 Reboot Win/2000 or NT system 31 6.4 Send messages 31 6.5 Languages 32 6.
9 8.4 Monitor operations options 8.4.1 Local system values 8.4.2 Win/2000 NT system values 50 51 52 8.5 User maintenance 8.5.1 User details 8.5.2 Advanced options 8.5.3 Copy/rename a user 53 54 56 57 8.6 Distribution groups 8.6.1 Distribution group details 8.6.2 Group members 8.6.3 Add group member 8.6.4 License codes 8.6.5 Register a license code 58 59 60 61 62 63 CONFIGURATION 65 9.1 General configuration 9.1.1 Part 1 9.1.2 Part 2 9.1.3 Part 3 66 66 68 70 9.2 Schedules 9.2.1 Schedule details 9.
9.7 Monitor system operations 9.7.1 Checkpoint type 9.7.2 Configuration status 9.7.3 HTTP Server 9.7.4 Job 9.7.5 Job queue 9.7.6 Message queue 9.7.7 Message filter 9.7.8 Filter entry details 9.7.9 Message queue advanced options 9.7.10 Job in MSGW 9.7.11 Job name filter 9.7.12 Add filter entry 9.7.13 Out queue 9.7.14 POP3 Server 9.7.15 Subsystem 9.7.16 Server 9.7.17 SMTP Server 9.7.18 Active systems 9.7.19 System active systems 9.7.20 Add system 9.7.
10.3 XTRVGTM 151 10.4 XCLRGMO 151 11 ISERIES SAMPLE PROGRAMS 153 11.1 Item inquiry program 153 11.2 Order entry request 153 11.3 Order entry reply processing 153 11.4 User defined system checkpoint 153 12 12.1 MIDJET WIN2000/NT MONITOR CONFIGURATION 155 ConfigTool main menu 155 12.2 Event log 12.2.1 Message selection 12.2.2 Filter 156 156 156 12.3 Other logs 158 12.4 Commands 159 12.5 Processes 160 12.6 TCP/IP Configuration 161 12.7 Language 161 13 13.
16.2 Sending messages to the iSeries 16.3 Usage examples 16.3.1 Command code ZE, Demonstration error 16.3.2 Command code ZM, Test message 16.3.3 Command code ZI, Item inquiry 16.3.
1 Introduction 1.1 Overview MidJet GSM Text is a robust interface to the Short Message Service (SMS) offered by all major GSM network operators. It provides the capability to exchange up to 160 characters long text messages, between iSeries and GSM telephones. The main functions are: - A user-friendly paging system, with ability to create and send SMS messages to individual person(s) or group(s) of persons. - A solid monitor for operational problems.
iSeries or the mobile phone. Messages can be created interactively on the NT, and an API allows the Win2000/NT programmer to include submission of SMS messages in Win2000/NT application programs. 1.2 License types The following license types is available: LO=Limited outgoing only Functionality is limited to sending messages without system operations monitoring functions. LB=Limited bidirectional Functionality is limited to sending/receiving messages without system operations monitoring functions.
2 GENERAL CONDITIONS FOR USE Important, please read carefully! Do not install the software until you have carefully read the following agreement. This agreement sets forth the terms and conditions for licensing the software from MidJet AB to you, and installing the software indicates that you have read this agreement and accept its terms and conditions. 2.1 License agreement By installing the MidJet GSM Text software you agree to be bound to the following conditions for use.
Page 12
3 Installation on the iSeries 3.1 Preparations for initial installation The installation of MidJet GSM Text software is highly automated and will normally require less than two hours of work. All parts of communication, subsystem and other objects required are created automatically by the installation program or by the product itself when used. All configuration related files are also delivered with as much information as possible already in place.
3.2 Initial installation procedure Follow these steps: Verify that your communications equipment is installed and operational. Sign on to the system as QSECOFR. No other user profile will be accepted by the installation program. Place the GSMTEXT CD in the CD drive. Run the command LODRUN (device name). The software will now be loaded, and entries with default values will be created in the files. 3.2.
field when the GSM module is connected to the iSeries via a communication line. IP address comm. server Use this field when the GSM module is connected via a communication server. Specify the IP address of the communication server. MidJet GSM text supports servers from W&T, type numbers supported are W&T #58001, #58004 and #58201. Network ID Specifies the number of the network of the SIM card. Press F4 to display a list of networks.
3.4 Manual installation Use main menu option 20 to display the Configuration menu. Then use: Option 1 to define/review general parameters. Option 3 to define/review systems, if in a multiple system environment. Option 4 to define/review communications parameters. Option 5 to define/review networks. A detailed description how to use the options is found in chapter 9. 3.
This completes the first part of the installation. Continue with options 2, 3 on the configuration menu for Schedules and Systems setup. Use menu option 10 on the main menu to specify options for Monitor Operations. Use option 20 to specify commands to be received from mobile phones. It s highly recommended that you carefully read the configuration chapter describing all options. You will then be able to tailor MidJet GSM Text in a way that best suits your needs.
3.7 Upgrade Installation Please observe that a new license code is required if upgrading from an earlier version than 6.00. The upgrade installation is very easy to perform. Just follow these steps: Sign on as QSECOFR. End the subsystem by running the command ENDGSMTSBS. Make sure that MidJet GSM Text is not being used. This can be done with the command: WRKOBJLCK GSMTEXT/USUSERP *FILE The displayed list shall be empty. If not, end the jobs on the list before proceeding with the installation.
Return to a command line with F3 or F12. Run command CLRPFM GSMTEXT/MWMSQMP Clear all message queues monitored by GSM Text, typically QSYSOPR and QSYSMSG and other message queues that may have been added. This completes the move to the new system. 3.9 Uninstall from iSeries Follow these steps to perform a complete uninstall of the product: Sign on as QSECOFR. End the subsystem by running the command ENDGSMTSBS. Make sure that MidJet GSM Text is not being used.
Page 20
4 Installation on the Win2000 or NT system 4.1 Prepare for initial installation The installation of MidJet NT Monitor software will normally take less than 30 minutes. The software itself is always delivered together with the MidJet GSM Text software. When delivered on a CD, the same CD can be used for installation both on the iSeries and the on NT system. The NT Monitor software is also automatically loaded in a save file in the GSMTEXT library on the iSeries when the MidJet GSM Text product in installed.
Use either the Installation from CD or Installation from IFS procedures described below. 4.2.1 Installation from CD Place the MidJet GSM Text CD in the CD drive on your Win2000 or NT system. Run d:gsmntm/setup where d is the letter of the CD drive. Follow the instructions on the screen. 4.2.2 Installation from IFS This installation method assumes that you have Client Access or other equivalent software installed. On the iSeries, run the configuration menu option 31.
Enter your GSM number (in international format), a message text and click Send. The message will be transferred to the iSeries, and will be delivered to you. To verify the system monitor functions on the NT, sign on to the iSeries with the user ID you normally use. Start the GSM Main menu option 10. Assign yourself as the recipient of operational messages for the Win2000/NT system. Start the menu option 21 on Configuration menu of GSM Text on the iSeries.
Page 24
5 MidJet GSM Text functions This section provides information about the functions in MidJet GSM Text. For a detailed description how to configure and use the product on your iSeries, please consult the following chapters. 5.1 Create messages Messages to be sent out to mobile telephones can be created in different ways: You can use the interactive program from the Main menu. Message text is typed in, and recipient or recipients are selected.
The monitor can report all inquiry type messages entering a message queue. Messages a primarily selected by comparison of the severity level. Message exception handling is defined in the Message filter file. Messages can be selected or excluded based on any combination of message id, job name or user id. Specific messages can be re-routed to another user than the one who was defined for the entire system.
retries, a message will be sent to the receiver of operational messages. The number of retries is controlled by the value specified under General configuration, “Max nbr of IP connect attempts”. Another message is sent when the server resumes to normal operation after a failure. POP3 checkpoint Checks POP3 servers which hold incoming mail. The procedure is the same as for the HTTP checkpoint. SMTP checkpoint Checks SMTP servers which are used to send mail.
5.4 Send e-mail from the iSeries Messages created by GSM Text may user selectable be sent as e-mail. This function is controlled by the user options, main menu option 2. E-mails can be sent in addition to SMS or send instead of SMS. This is achieved by the integrated SMTP client. It has support for encrypted mail using SSL built into it. 5.5 Receive SMS messages on the iSeries MidJet GSM Text has the optional (license types LB, 2B, U1 and UB) capability to receive messages.
5.7 File maintenance All MidJet GSM file maintenance is performed from the Main menu and from the Configuration menu. After the installation is completed, MidJet GSM Text will normally require very little maintenance efforts. A user must have full authority in the user file to be able to use the configuration menu. 5.8 Multiple iSeries There is a well-developed support for installations with multiple iSeries in a network. This includes the possibility to share communications equipment.
Page 30
6 MidJet Win2000/NT Monitor functions 6.1 System monitor functions Monitor the Event Log System, security and program messages from the Event Log can be forwarded to the receiver of operational messages. They can be selected based on category - Information, Warning or Error. A filter function makes it possible to exclude unwanted messages based on event id. Monitor other logs Applications using their own log files in text format can be monitored.
6.5 Languages Screens and help-texts can be displayed in English, German, Spanish or Swedish. 6.6 Message API For the purpose of message creation within user applications, an API is provided. This makes it possible to develop programs that first receive a request from a GSM telephone, and then retrieves information stored in an application on the Win2000/NT, and finally sends the result back as a text message. 6.
7 Start MidJet GSM Text 7.1 Interactive part MidJet GSM Text consists of two major parts. One contains the interactive programs used for message creation, application set-up and maintenance. The other is the batch subsystem which handles message transmission, processing of incoming messages, and monitoring of mail and system operations. To start the interactive part run the command STRGSMT and the MidJet GSM Text menu will be displayed.
It is strongly recommended that you restart the subsystem once a day. This will prevent from having very long job logs on the system and will also free some disk space.
8 Main Menu This is the main menu of MidJet GSM Text and it is displayed when you run the STRGSMT command with parameter 1 default value *MENU in effect. GSMMNU Ver 6.13 T UB (c) MidJet AB MidJet GSM Text Company name 12-02-01 USERID 12.00.00 SYSNAME SBS Active 1. Send GSM Text message 2. User options 5. Message log 10. Monitor operations options 11. User maintenance 12. Distribution groups 20. Configuration 21. Start subsystem 22. End subsystem 90.
8.1 Send GSM Text message This program is used to interactively enter message text and select recipients. Use menu option 1 to display this screen. GSM1001 Send GSM Text message 12-02-01 USERID 12.00.00 SYSNAME Enter message text and select recipients Position to __________ Message text . . . .
F12=Cancel Return to the previous screen. F16=User Maintenance Go to the User maintenance screen. F19=Alarm call When using this function MidJet GSM Text will place an ordinary phone call to the receiving telephone after the message is sent. Enable the function with F19, it will be disabled after a message is sent or by pressing F19 again. F21=Non-display message text in log This function makes the message text unreadable in the message log. Instead ‘*Non-displayable text’ will be displayed.
8.1.1 Distribution group selection This screen is displayed after pressing F10 in the main Send GSM Text message screen. GSM1002 Ver 6.13 Send GSM Text message 12-02-01 USERID 12.00.00 SYSNAME Type option, press Enter Message text . . . . 1=Select Distribut O group _ OPER Description System operators F12=Cancel Distribution groups Option Place a ‘1’ in front of distribution groups to receive this message, and press Enter.
8.2 User options Use menu option 2 to display this screen. GSM1101 Ver 6.13 User options 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter User ID . . . . . . . . . . . USERID Send message as GSM message . 1 Send as GSM msg schedule nbr User Name 0=Never, 1=Always 2=If signed on, 3=If signed off, 4=On schedule F4=List Send msg as e-mail . . . . . . 1 Send msg as e-mail schd nbr Run exit command . . . . . . .
5 Messages will be sent as e-mail if messages are not sent as GSM messages. Send as e-mail schd nbr Schedule number used when ‘Send message as e-mail’ is set to 4. Run exit command This field specifies if and when the exit command shall run. 0 The exit command will not run. 1 The exit command will always run. 2 The exit command will run if the user is signed on. 3 The exit command will run if the user is signed off.
8.3 Message logs 8.3.1 User message log This screen is displayed for a user with authority level 0 or 1 by using menu option 5. GSM1201 Ver 6.13 Message log Type option, press Enter 5=Display Opt Crt date Time Status 03-12-01 9:52 Stored 03-12-01 9:50 Stored 12-02-01 USERID 12.00.
8.3.2 Operator Message log This screen is displayed for a user with authority level 2 by using menu option 5. GSM1301 Ver 6.13 Message log Type option, press Enter 5=Display Opt Status _ Delivered _ Processed F3=Exit F13=Select 12.00.
8.3.3 List type 2 This screen is displayed after pressing F11 in the operator message log screen. GSM1302 Ver 6.13 Message log Type option, press Enter 5=Display Opt Crt date Time Status _ 12-02-01 12:00 Delivered _ 12-02-01 12:01 Processed F3=Exit F13=Select F5=Refresh F17=Top 12-02-01 USERID 12.00.
8.3.4 Message selection This screen is used for specifying message selection criteria. Use any combination of the fields. This screen is displayed after pressing F13 in a message log screen. GSM1306 Ver 6.13 Message log 12-02-01 USERID Type selection value or values and press Enter From date From time To date To time . . . . . . . . . .______ . . . . . . . . . .______ . . . . . . . . . . .______ . . . . . . . . . . .______ Message word or phrase . . . . ____________________ To user . . . . . . . . . .
8.3.5 Sent message details This screen is displayed after selecting a sent message in a message log screen. GSM1302 Ver 6.13 Message log 12-02-01 USERID Sequence number . . 84 Status . . . . . . . Delivered Creation date Creation time To user ID . . . . . USERID GSM number . . . . . 46708360259 Send alarm call . . No Alarm send date Alarm send time . . . 12-02-01 . . . 12:00:00 . . . . Reply number . . . . Reply . . . . Reply date . . . . . Reply time . . . . . Send date . . . . .
For a message, which can be replied to, the reply number is displayed. The reply number start from 1 for every user, and the number is reused. That means, if a user has no outstanding messages to reply to, the next message will have reply number 1. If a reply has arrived it is displayed together with reply time and reply date. If e-mail was requested the e-mail address and the data and time the messages was delivered to the SMTP server is displayed.
8.3.6 Reply entry This screen is displayed after pressing F8 in the message detail screen. GSM1304 Ver 6.13 Message log 12-02-01 USERID Sequence number . . 84 Status . . . . . . . Delivered Creation date Creation time To user ID . . . . . USERID GSM number . . . . . 46708360259 Send alarm call . . No Alarm send date Alarm send time Send date . . . . . 12-02-01 Send time . . . . . 12:00:07 From user ID . . . . GSMTEXT 12.00.00 SYSNAME . . . 12-02-01 . . . 12:00:00 . . . . Reply number . . . .
8.3.7 Received message details This screen is displayed after selecting a received message in a message log screen. GSM1305 Ver 6.13 Message log Sequence number . . 1 Status . . . . . . . Processed Reject reason . . . 12-02-01 USERID Creation date Creation time 12.00.00 SYSNAME . . . 12-02-01 . . . 12:00:00 Target system name . NTSYS From user ID . . . . USERID GSM number . . . . . 46675234890 Message text . . . . ZD Command string . . .
This screen also shows message creation date and time, and the command string that was created. Pressing Enter redisplays the previous screen. F18=Process again Changes the incoming message’s status to new, and causes it to be processed again. F23=Delete Removes the message from the file, independent of message status.
8.4 Monitor operations options This program is used to specify the receiver of operational messages. This screen is displayed after selecting menu option 10. GSM1401 Ver 6.13 Monitor operations options Type option, press Enter 2=Change System Opt name Description _ *LOCAL Local system _ NTSYS NT Server Position to 12-02-01 USERID 12.00.
8.4.1 Local system values This screen is displayed after selecting a system for change. GSM1402 Ver 6.13 Monitor operations options 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter System name . . . . . . . . . *LOCAL System description . . . . . . Local system System descript abbreviation . Operational message receiver . *NONE_____ Send alarm call . . . . . . .
8.4.2 Win/2000 NT system values This screen is displayed after selecting a Win/2000 or NT system. GSM1402 Ver 6.13 Monitor operations options 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter System name . . . . . . . . . NTSYS System description . . . . . . NT System descript abbreviation . 010 Operational message receiver . USERID____ Send alarm call . . . . . . . 0 0=No, 1=Yes Schedule number . . . . . . . Check cykles bypass value . .
8.5 User maintenance This screen is displayed after selecting option 11 on the menu. GSM1501 Ver 6.13 User maintenance Type option, press Enter 2=Change 3=Copy 4=Delete Opt User ID _ USERID Position to 12-02-01 USERID 12.00.00 SYSNAME __________ 7=Rename User name User Name GSM number 123456789 Auth lvl 2 End F3=Exit F6=Create F12=Cancel User’s screen A user could be registered in this file in order to appear in the Select Recipients Screen when entering messages.
8.5.1 User details This screen is displayed after selecting a user to change, or an empty screen if F6 is pressed. GSM1502 Ver 6.13 User maintenance 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter User ID . . . . . . . . . . . USERID User name . . . . . . . . . . User Name ____________________ Country prefix . . . . . . . . 46_ GSM number . . . . . . . . . . 123456789___________ Send via network . . . . . . . 240-01 F4=List E-mail address . . . . . . . . user.name@company.
2 The user can use all functions of the product. F10=User options This function key allows any user with authority level 2 update access to any user’s “User option”. See this section earlier in this manual. F11=Advanced options Go to advanced options screen.
8.5.2 Advanced options This screen is displayed after pressing F11 in the User details screen. GSM1503 Ver 6.13 User maintenance 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter User ID . . . . . . . . . . . USERID User name . . . . . . . . . . User Name Phone display line length . . Originator number . . . . . . ____________________ Exit command string . . . . .
8.5.3 Copy/rename a user This screen is displayed after selecting a user for rename or copy in the screen. GSM1506 Ver 6.13 User maintenance 12-02-01 USERID 12.00.00 SYSNAME Copy - Type new name and press Enter. User ID . . . . . . . . . . . USERID User name . . . . . . . . . . User Name New name . . . . . . . . . . . __________ F12=Cancel Copy/rename screen New name Type the new name. This must not be the same as an existing user in the user or distribution group file.
8.6 Distribution groups Use option 12 on the main menu to display this screen. GSM1601 Ver 6.13 Distribution groups Type option, press Enter 2=Change 4=Delete Distribut Opt group Description _ OPER System operators Position to 12-02-01 USERID 12.00.00 SYSNAME __________ End F3=Exit F6=Create F12=Cancel Distribution groups Option Use option 2 to change the description or add/delete distribution group members. Use option 4 to delete a distribution group and its members.
8.6.1 Distribution group details This screen is displayed after selecting a distribution group to change, or an empty screen if F6, Create, is pressed. GSM1602 Ver 6.13 Distribution groups 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Distribution group name . . . OPER Distribution group description System operators______________ F3=Exit F12=Cancel Distribution group details Press Enter to maintain distribution group members.
8.6.2 Group members This screen is displayed after pressing Enter on a Distribution group detail screen. GSM1611 Ver 6.13 OPER Group members 12-02-01 USERID System operators Type option, press Enter 4=Delete Opt Seq User ID _ 5 USERID F3=Exit User name User Name F6=Create GSM number 46123456789 F12=Cancel Group members This screen allows add or delete of group members. Option Use option 4 to delete one or more members of a group. F6=Create Use F6 to add new group members. Page 60 12.00.
8.6.3 Add group member This screen is displayed after pressing F6 in the distribution group screen. GSM1612 Ver 6.13 Group members 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Distribution group name User ID . . . OPER . . . . . . . . . . . __________ F4=List F12=Cancel Add group member User ID Enter the ID of a user or press F4 for a list of users.
8.6.4 License codes This screen is displayed after pressing F23 in the main menu. GSM1901 Ver 6.13 Type option, 4=Delete License Opt class _ AS400 _ NT Enter license code 12-02-01 USERID 12.00.00 SYSNAME press Enter Lic Temp type Perm UB P NT-99+ T Expiration date Remarks 1998-12-31 End F3=Exit F6=Register license code F12=Cancel License codes This screen contains information about existing license codes.
8.6.5 Register a license code This screen is displayed after pressing F6 in the license code screen. GSM1902 Ver 6.13 Enter license code 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter License code string . . . . . ____ - ____ - ____ - ____ F12=Cancel Register a license code License code string Type the license code string and press Enter. A message will indicate of the code was accepted.
Page 64
9 Configuration MidJet GSM Text is delivered with as much information as possible already entered in the configuration files. The configuration menu items are intended to be used by the person responsible for the installation. It is highly recommended that you read this chapter carefully before performing any of the configuration tasks. Use option 20 on the GSM Text Main Menu to display this screen. GSM2001 Ver 6.13 Configuration 1. 2. 3. 4. 5. 12-02-01 USERID 12.00.
9.1 General configuration This and the following two screens contain base values for MidJet GSM Text operation. Use option 1 on the configuration menu to display this first screen. 9.1.1 Part 1 GSM2101 Ver 6.13 General 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Company name . . . . . . . . . Company Name__________________ Language code . . . . . . . . ENG Country prefix . . . . . . . . 46_ Sending system name . . . . .
Cfg name outgoing/combined msg Specify the configuration name to use for message transmission. This value is used only if “Sending system” is set to “*LOCAL”, and the corresponding field in the network file is set to “*SYS”. Cfg name incoming messages Not in use, leave the value “*NONE”. Configuration name alarm calls Specify the configuration name to use for placing alarm calls. It must be a configuration of connection type 1 (asynchronous modem) or connection type 2 (synchronous modem).
9.1.2 Part 2 GSM2102 Ver 6.13 General 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Use blank as separator charact 1 Additional separator character # Rejected message receiver 0=No, 1=Yes . . USERID____ Keep messages . . . . . . . . Keep communication logs . . . 90 Days 30 Days Exit command string . . . . .
This value is used when the Exit command string value in the user file is set to *SYS.
9.1.3 Part 3 GSM2103 Ver 6.13 General 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Modem command translation from $#@_____________________________ Modem command translation to . ÅÄÖ_____________________________ Operations monitor interval . 15 Seconds Enable group escalation . . . 0 Escalation delay time . . . . 15 0=No, 1=Inquiry msg, 2=All msg Minutes Max nbr of IP connect attempts 5 Incoming SMS validity period . 72 Hours SMTP server . . . . . .
SMTP server The name or ip address to the SMTP server. SMTP server port number Port number to be used for connection to the SMTP server. Usually port number 25 is used for non-SSL connections and port 465 for SSL. Sender e-mail address The sender e-mail address. E-mail address A valid e-mail address. *NOREPLY When this special value is specified 'noreply' will be used as the local part of the address. Domain name will be determined from the system TCP/IP configuration value of DMNNAME.
9.2 Schedules This option is used for maintenance of the schedule file. A schedule describes a week in 30 minute segments, which can be active or not. The monitor functions of MidJet GSM Text uses schedules to decide when the function should be performed. This screen is displayed using menu option 2. GSM2201 Ver 6.13 Type option, 2=Change Sched Opt nbr _ 1 _ 2 Schedules press Enter 4=Delete 12-02-01 USERID Position to 12.00.
9.2.1 Schedule details This screen is displayed after selecting a schedule for change, or an empty screen if F6, Create, was pressed. GSM2202 Ver 6.13 Schedules 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Schedule number . . . . . . . 1 Schedule description . . . . .
9.2.2 Change day of week This screen show all dates that have an alternate day of week assigned to it. It is displayed after pressing F11 in the first schedule screen. GSM2211 Ver 6.13 Change day of week Type option, press Enter 2=Change 4=Delete Alt day Opt Date of week _ 2003-12-24 7 _ 2003-12-25 7 _ 2003-12-26 7 _ 2003-12-31 6 Position to 12-02-01 USERID 12.00.
9.2.3 Change day of week for a date GSM2212 Ver 6.13 Change day of week 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Date . . . . . . . . . . . . . Alternative day of week F3=Exit YYYYMMDD . . . F12=Cancel Change day of week Date Enter the date in YYYYMMDD that should have the day of week value altered. Alternative day of week Enter the day number of the week. Monday is 1, Tuesday is 2 etc.
9.3 Systems This file holds information about the other systems in the network that this iSeries will communicate with using MidJet GSM Text. Also other units like routers, printers or any other device, unit, or node with an IP address can be entered here. They will then be enabled for connection check using the *SYSACT checkpoint. Use option 3 on the configuration menu to display this screen. GSM2301 Ver 6.
9.3.1 Name and type This screen is displayed after selecting a system for change, or after pressing F6 for add. GSM2302 Ver 6.13 Systems 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter System name . . . . . . . . . __________ System description . . . . . . ______________________________ System descript abbreviation . ___ System type . . . . . . . . . ________ F3=Exit F12=Cancel Name and type System name *LOCAL is used for this iSeries system, use a symbolic name for other systems.
9.3.2 Local system This screen is displayed after selecting the local system for change. GSM2303 Ver 6.13 Systems 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Sending system name . . . . . *LOCAL System description . . . . . . Local system System descript abbreviation . System type . . . . . . . . . *AS400 Message prefix . . . . . . . . 1_________ F3=Exit F12=Cancel System details Local system The *LOCAL entry is created during installation.
9.3.3 Remote iSeries This screen is displayed after selecting a remote system for add or change. GSM2304 Ver 6.13 Systems 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter System name . . . . . . . . . SYSNAME System description . . . . . . Text for SYSNAME System descript abbreviation . 001 System type . . . . . . . . . *AS400 Communication protocol . . . .
9.3.4 TCP/IP communication protocol This screen is displayed after selecting the local system for change. GSM23041 Ver 6.13 Systems Type values and press Enter System name . . . . . . . . . REMOTE System description . . . . . . Remote iSeries System descript abbreviation . RMT System type . . . . . . . . . *AS400 Communication protocol . . . . 1 1=TCP/IP, 2=SNA IP address . . . . . . . . . . 192.168.0.
9.3.5 SNA communication protocol This screen is displayed after selecting an entry of type *AS400 for change or add. GSM2304 Ver 6.13 Systems 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter System name . . . . . . . . . REMOTE System description . . . . . . Remote iSeries System descript abbreviation . RMT System type . . . . . . . . . *AS400 Remote location . Device description Local location . . Remote network ID Mode description . F3=Exit . . . . . . . . . . . . . . . . . . . . .
9.3.6 Win/2000 NT System This screen is displayed after selecting an entry of type *NT for change or add. GSM2305 Ver 6.13 Systems 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter System name . . . . . . . . . NTSYS System description . . . . . . NT Server System descript abbreviation . NTS System type . . . . . . . . . *NT IP address . . . . . . . . . . 192.168.1.64___ Message prefix . . . . . . . .
9.3.7 Other system This screen is displayed after selecting an entry of type *OTHER for change or add. GSM2306 Ver 6.13 Systems 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter System name . . . . . . . . . ROUTER System description . . . . . . Router System descript abbreviation . System type . . . . . . . . . *OTHER IP address . . . . . . . . . . 192.168.1.
9.4 Communications descriptions This file holds the information which - together with data from the Network file - is used for creation of communication objects such as line, controller, device descriptions etc. It is important that you only change communication related parameters with this program. If you change the automatically created objects, you will lose your changes when MidJet GSM Text recreates the objects. Use option 4 on the configuration menu to display this screen. GSM2401 Ver 6.
9.4.1 Name and type This screen is displayed after selecting a description to change, or an empty screen if F6, Create, is pressed. GSM2402 Ver 6.13 Communication config descriptions 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Configuration name . . . . . . GSMT11 Configuration description . . Asynchronous modem send_______ Configuration type . . . . . . 1 Connection type . . . . . . . 1 F3=Exit F12=Cancel Communication name and type Type values and press Enter.
Page 86 4 GSM module. This type uses a GSM module for transmission of messages. It is connected to the iSeries through a V.24 line, and supports both outgoing and incoming messages and alarm calls. 5 GSM module. This type uses a GSM module for transmission of messages. It is connected to the iSeries through a W&T TCP/IP Communication server. This configuration supports both outgoing and incoming messages and alarm calls. 6 TCP/IP. Direct connection to the GSM operator using TCP/IP.
9.4.2 Asynchronous modem This screen will be displayed if connection type 1 is selected. GSM2403 Ver 6.13 Communication config descriptions 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Configuration name . . . . . . GSMT11 Configuration description . . Asynchronous modem send Configuration type . . . . . . 1 Connection type . . . . . . . 1 Resource name . . . Dial prefix . . . . Line speed . . . . . Modem initialization ____________ Number of data bits Parity . . . . . . .
Should be set as specified by the GSM operator. Supported values are 0, 1 or 2. Flow control This value controls if flow control is used. Should be set as specified by the GSM operator. 0 Flow control is not used. 1 Flow control is used Tone or pulse dial Page 88 T Tone dial will be used. P Pulse dial will be used.
9.4.3 X.32 communications This screen will be displayed if connection type 2 is selected. GSM2404 Ver 6.13 Communication config descriptions 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Configuration name . . . . . . GSMT12 Configuration description . . X.32 send Configuration type . . . . . . 1 Connection type . . . . . . . 2 Resource name . . . . . . . . CMN03_____ Dial prefix . . . . . . . . . :0:_________________ Line speed . . . . . . . . . . 9600_ F12=Cancel X.
9.4.4 X.25 communications This screen will be displayed if connection type 3 is selected. GSM2405 Ver 6.13 Communication config descriptions 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Configuration name . . . . . . GSMT13 Configuration description . . X.25 send Configuration type . . . . . . 1 Connection type . . . . . . . 3 Resource name . . . . . . . . CMN04_____ Line speed . . . . . . . . . . 9600_ Local network address . . . . 1235544_____________ X.25 line description name . .
9.4.5 GSM Module This screen will be displayed if connection type 4 is selected. GSM2406 Ver 6.13 Communication config descriptions 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Configuration name . . . . . . GSMT34 Configuration description . . Asynchronous GSM device Configuration type . . . . . . 3 Connection type . . . . . . . 4 Resource name Line speed . . Number of data Parity . . . . Number of stop Flow control . . . . . . . bits . . . bits . . . . . . . . . . . . . . . . . . .
Service centre address to use Service centre address to use when sending messages through this configuration. Page 92 1=Sender The service centre address of the SIM card in the GSM module will be used. 2=Receiver The service centre address for the receiver's network defined in the network file will be used.
9.4.6 GSM Module via communication server This screen will be displayed if connection type 5 is selected. GSM2406 Ver 6.13 Communication config descriptions 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Configuration name . . . . . . GSMT34 Configuration description . . Asynchronous GSM device Configuration type . . . . . . 3 Connection type . . . . . . . 4 Configuration name . . . . . . GSMT35 Configuration description . . GSM module communication svr Configuration type . . . . . .
SIM card PIN code The PIN code is used to check authority to the SIM card. A PIN code is assigned by the GSM operator. Place the SIM card in a mobile phone if you want to change it. Network ID The ID of the GSM network that issued the SIM card used in the GSM module. Press F4 to display a window with available networks. Service centre address to use Service centre address to use when sending messages through this configuration.
9.4.7 TCP/IP This screen will be displayed if connection type 6 is selected. GSM240A Ver 6.13 Communication config descriptions 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Configuration name . . . . . . SMS_IP Configuration description . . SMS over TCP/IP Configuration type . . . . . . 3 Connection type . . . . . . . 6 Short ID . . . . . . . . . . .________________ Password . . . . . . . . . . .________________ IP address SMSC primary . . .______________ Port number primary . . . .
9.4.8 Module information This screen is displayed after selecting option 8 on the Communication descriptions first display. GSM2408 Ver 6.13 Communication config descriptions 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Configuration name . . . . . . GSMT34 Configuration description . . Asynchronous GSM device Configuration type . . . . . . 3 Connection type . . . . . . . 4 Resource name . Manufacturer ID Model ID . . . . Version . . . . Serial number . Signal quality .
Retrieve date Date when the information was retrieved. Retrieve time Time when the information was retrieved. F5=Refresh Refresh the screen. F9=Retrieve Submit an instruction to renew the device information. If the device is immediately available, the information is returned in a couple of seconds. Use F5 to refresh the screen. F12=Cancel Return to previous screen.
9.5 Network operators This file contains information about the GSM Network operators. The entries in this file are created during installation, and all supported operators in the country of installation are displayed. Use option 5 on the configuration menu to display this screen. GSM2501 Ver 6.13 Network operators Type option, press Enter 2=Change 4=Delete Opt Nw ID 204-04 204-08 208-01 208-10 214-01 214-03 214-07 222-01 222-10 222-88 222-98 228-01 228-02 228-03 F3=Exit 12.00.
9.5.1 General This screen is displayed after selecting a network to change, or an empty screen if F6, Create, is pressed. GSM2502 Ver 6.13 Network operators 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Network ID . . . . . . . . . . 240-01 Network name . . . . . . . . . Telia Mobitel GSM Text________ Sending system name F12=Cancel . . . . . *SYS______ F4=List F18=Restore default values Network operators, general Network ID A 5 digit identification number of the network.
9.5.2 Name and configuration selection This screen is displayed after pressing Enter in the General screen if this system was selected for message transmission. GSM2503 Ver 6.13 Network operators 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Network ID . . . . . . . . . . 240-01 Network name . . . . . . . . . Telia Mobitel GSM Text Cfg name outgoing/combined msg *SYS__ F4=List Config name incoming messages *NONE_ F4=List Configuration name alarm calls *SYS__ F4=List Country prefix . . . .
9.5.3 Common values for modem transmission This screen is displayed for an operator using a modem connection. GSM2504 Ver 6.13 Network operators 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Network ID . . . . . . . . . . 240-01 Network name . . . . . . . . . Telia Mobitel GSM Text Protocol . . . . . . . International prefix . Send delay in seconds Login prompt . . . . . . . . . . . . . . . . . . UCP_ . 009 . 2 0-99 . *NONE_______________ Response text delivered . . .
9.5.4 CIMD values This screen is displayed if CIMD protocol was selected on the previous screen. GSM2505 Ver 6.13 Network operators 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Network ID . . . . . . . . . . 240-08 Network name . . . . . . . . . Vodafone SMSC login . . . . . . . . . . cimd2_____ SMSC password . . . . . . . . *NONE_____ Login message . . . . . . . . CIMD________________ TMD user ID . . . . . . . . . MIDJET__________________________ Password . . . . . . . . . . .
9.5.5 TAP protocol values This screen is displayed if TAP protocol was selected on the previous screen. GSM2506 Ver 6.13 Network operators 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Network ID . . . . . . . . . . 234-10 Network name . . . . . . . . . O2 (UK) Ltd TAP password . . . . . . . . . *NONE F12=Cancel TAP values TAP password Password in the remote system. Specify *NONE if not used.
9.5.6 Asynchronous access number This screen is displayed if an asynchronous communication description was selected for this operator. GSM2507 Ver 6.13 Network operators 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Network ID . . . . . . . . . . 240-01 Network name . . . . . . . . . Telia Mobitel GSM Text Connection number . . . . . . 0740930000__________ Connect message . . . . . . . CONNECT_____________ Max number of msg/connection .
9.5.7 X.32 values This screen is displayed if a X.32 communication description was selected. GSM2508 Ver 6.13 Network operators 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Network ID . . . . . . . . . . 240-01 Network name . . . . . . . . . Telia Mobitel GSM Text Connection number Data address X.32 . . . . . . 020910032___________ . . . . . . 745101041___________ Network password . . . . . . . password________ Network user number . . . . .
9.5.8 X.25 values This screen is displayed if a X.25 communication description was selected. GSM2509 Ver 6.13 Network operators 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Network ID . . . . . . . . . . 240-01 Network name . . . . . . . . . Telia Mobitel GSM Text Data address X.25 . . . . . . 745101041___________ Data address incoming messages 1___________________ Max number of msg/connection . 1 1-99 F12=Cancel X.25 values Data address X.
9.6 National character translation This file is used for translation of national characters from/to the EBCDIC representation in the iSeries and the ETSI GSM standard ASCII representation. MidJet GSM Text is delivered with translation file entries for supported operators and protocols. Please consult MidJet AB or your distributor for more information before you change the translation. This screen is displayed after selecting option 7 on the configuration menu. GSM2701 Ver 6.
9.6.1 Translation file entry This screen is displayed after selecting an entry to change, or an empty screen if F6, Create, is pressed. GSM2702 Ver 6.13 National character translation 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Network ID . . . . . . . . . . 240-01 Telia Mobitel GSM Text Protocol . . . . . . . . . . . ATP EBCDIC set characters . . . . @$éÅåÉ!#¤ÄÖ§äöü_________________ GSM set characters . . . . . . ÖÅ`$}\¤Ä]#@[{|~_________________ GSM set characters . . . . . .
9.7 Monitor system operations This program is used to select configuration options for the system operating monitoring functions. Use option 10 on the configuration menu to display this screen. GSM2801 Ver 6.13 Monitor system operations Type option, press Enter 2=Change 4=Delete Checkpoint Opt type Description _ *CFGSTS X.
9.7.1 Checkpoint type This screen is displayed after selecting a checkpoint for change, or after pressing F6. GSM2802 Ver 6.13 Monitor system operations 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Checkpoint type . . . . . . . F12=Cancel Checkpoint type Checkpoint type This field specifies the checkpoint type. The following values are valid: *CFGSTS This checkpoint is used to monitor a configuration object.
*OUTQ Works in the same way as the jobq checkpoint. If too many spool files or pages exist in an out queue, a message will be created *POP3 Checks that a POP3 server is responding. *SBS Checks that a subsystem is active on the system. *SERVER Checks that a server accepts a connect attempt. *SMTP Checks that a SMTP server is responding. *SYSACT Active systems checkpoint is used to check that a remote system responds to a connection check.
9.7.2 Configuration status This screen is displayed after selecting a CFGSTS checkpoint for update or add. GSM280A Ver 6.13 Monitor system operations 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Checkpoint type . . . . . . . *CFGSTS Description . . . . . . . . . X.25 line_____________________ Schedule number . . . . . . Operational message receiver Check cycles bypass value . Configuration object name . . 1 F4=List . *SYS______ . 5 .
9.7.3 HTTP Server This screen is displayed after selecting a HTTP checkpoint for update or add. GSM280G Ver 6.13 Monitor system operations 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Checkpoint type . . . . . . . *HTTP Description . . . . . . . . . Web server description Schedule number . . . . . . . 1 F4=List Operational message receiver . *SYS Check cykles bypass value . . 10 Server name . . . . . . . . . www.webserver.
9.7.4 Job This screen is displayed after selecting a JOB checkpoint for update or add. GSM2808 Ver 6.13 Monitor system operations 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Checkpoint type . . . . . . . *JOB Description . . . . . . . . . PRT01_________________________ Schedule number . . . . . . . 1 F4=List Operational message receiver . *SYS______ Check cycles bypass value . . 5 Job name . . . . . . . . . . . PRT01_____ Name, generic* User ID . . . . . . . . . . .
9.7.5 Job queue This screen is displayed after selecting a JOBQ checkpoint for update or add. GSM2806 Ver 6.13 Monitor system operations 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Checkpoint type . . . . . . . *JOBQ Description . . . . . . . . . QBATCH________________________ Schedule number . . . . . . . 1 F4=List Operational message receiver . *SYS______ Check cycles bypass value . . 5 Job queue name . . . . . . . . QBATCH____ Job queue library name . . . .
9.7.6 Message queue This screen is displayed after selecting a MSGQ checkpoint for update or add. GSM2804 Ver 6.13 Monitor system operations 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Checkpoint type . . . . . . . *MSGQ Description . . . . . . . . . QSYSOPR Msgq__________________ Schedule number . . . . . . . 1 F4=List Operational message receiver . *SYS______ Check cycles bypass value . . Message queue name . . . . . . QSYSOPR___ Message queue library name . .
Notify if msgq is unavailable This function can create a message to the receiver of operational messages when the monitored message queue is not available or does not exist. A new message is created when it becomes available again. F10=Message filter Go to the message filter screen. F11=Advanced options Go to the advanced options screen.
9.7.7 Message filter Entries are placed here for message exception handling. A message can be selected or excluded without message severity comparison. Specific messages can be re-routed to another receiver than the appointed receiver of operational messages for this .system. Message filter records are associated with a specific message queue checkpoint. This screen is displayed after pressing F10 in the MSGQ checkpoint screen. GSM2821 Ver 6.13 QSYSOPR Message filter QSYS 12-02-01 USERID 12.00.
9.7.8 Filter entry details This screen is displayed after selecting a filter entry for change, or after pressing F6, Create. GSM2822 Ver 6.13 Type values and press Enter Message ID . Job name . . User ID . . Message data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Message filter . . . . 12-02-01 USERID 12.00.00 SYSNAME CPF1234 *ANY *ANY *ANY Selection code . . . . . . . . 0 0=Omit, 1=Include Operational message receiver .
9.7.9 Message queue advanced options This screen is displayed after pressing F11 in the MSGQ checkpoint screen. GSM2805 Ver 6.13 Monitor system operations 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Checkpoint type . . . . . . . *MSGQ Description . . . . . . . . . QSYSOPR Msgq Message queue name . . . . . . QSYSOPR Message queue library name . . QSYS Include Include Include Include Include Include impromptu messages job name . . . . . job number . . . . job user name . . message id . .
This field controls how to handle messages arrived to the message queue while the monitor was inactive shall be handled. If messages are saved, they will be sent out when the monitor starts. Specify 0 to if you not want messages saved, or 1 to save the messages. Send msg to QSYSOPR msg queue This field controls if messages received in this message queue should be sent to QSYSOPR message queue. Specify 0 to omit or 1 to send the message.
9.7.10 Job in MSGW This screen is displayed after selecting a MSGW checkpoint for update or add. GSM2803 Ver 6.13 Monitor system operations 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Checkpoint type . . . . . . . *MSGW Description . . . . . . . . . Jobs in MSGW__________________ Schedule number . . . . . . . 1 F4=List Operational message receiver . *SYS______ Check cycles bypass value . .
9.7.11 Job name filter This screen is displayed after pressing F11 in the MSGW checkpoint screen. GSM2811 Ver 6.13 Job name filter Type option, press Enter 4=Delete Opt Job name _ *ALL Position to 12-02-01 USERID 12.00.00 SYSNAME _________ _________ User ID QSPLJOB End F3=Exit F6=Create F12=Cancel Job name filter Option Use option 4 to delete an entry. F6=Create F6 displays a screen to create a new filter record.
9.7.12 Add filter entry This screen is displayed if F6 is pressed in the Job name filter screen. GSM2812 Ver 6.13 Job name filter 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Job name . . . . . . . . . . . __________ User ID . . . . . . . . . . . __________ F3=Exit F12=Cancel Add filter entry Job name Job name as it appears on the screen presented by WRKACTJOB command. Entry *ALL is valid, then all jobs for the user will be omitted. User ID The job User ID.
9.7.13 Out queue This screen is displayed after selecting an OUTQ checkpoint for update or add. GSM2807 Ver 6.13 Monitor system operations 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Checkpoint type . . . . . . . *OUTQ Description . . . . . . . . . QEZJOBLOG_____________________ Schedule number . . . . . . . 1 F4=List Operational message receiver . *SYS______ Check cycles bypass value . . 5 Outqueue name . . . . . . . . QEZJOBLOG_ Outqueue library name . . . .
9.7.14 POP3 Server This screen is displayed after selecting a POP3 checkpoint for update or add. GSM280E Ver 6.13 Monitor system operations 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Checkpoint type . . . . . . . *POP3 Description . . . . . . . . . POP3 server description Schedule number . . . . . . . 1 F4=List Operational message receiver . *SYS Check cykles bypass value . . 10 Server name . . . . . . . . . pop3server.
9.7.15 Subsystem This screen is displayed after selecting a SBS checkpoint for update or add. GSM2809 Ver 6.13 Monitor system operations 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Checkpoint type . . . . . . . *SBS Description . . . . . . . . . QSNADS________________________ Schedule number . . . . . . . 2 F4=List Operational message receiver . *SYS______ Check cycles bypass value . . 5 Subsystem name . . . . . . . .
9.7.16 Server This screen is displayed after selecting a Server checkpoint for update or add. GSM280D Ver 6.13 Monitor system operations 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Checkpoint type . . . . . . . *SERVER Description . . . . . . . . . Server description Schedule number . . . . . . . 1 F4=List Operational message receiver . *SYS Check cycles bypass value . . 10 Server name . . . . . . . . . IP address . . . . . . . . . . 192.168.1.1 Port number . . . . . . . . .
9.7.17 SMTP Server This screen is displayed after selecting a SMTP checkpoint for update or add. GSM280F Ver 6.13 Monitor system operations 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Checkpoint type . . . . . . . *SMTP Description . . . . . . . . . SMTP server description Schedule number . . . . . . . 1 F4=List Operational message receiver . *SYS Check cycles bypass value . . 10 Server name . . . . . . . . . smtpserver.
9.7.18 Active systems This screen is displayed after selecting a SYSACT checkpoint for update or add. GSM280B Ver 6.13 Monitor system operations 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Checkpoint type . . . . . . . *SYSACT Description . . . . . . . . . All systems___________________ Schedule number . . . . . . . 1 F4=List Operational message receiver . *SYS______ Check cycles bypass value . . 10 Send system active message . . 1 Send time system active msg .
9.7.19 System active systems The systems that will be checked with the *SYSACT checkpoint is shown in this screen. This screen is displayed after pressing Enter in the *SYSACT checkpoint screen. GSM2831 Ver 6.13 System active systems All systems Position to 12-02-01 USERID 12.00.
9.7.20 Add system This screen is displayed if F6 was pressed in the previous screen. GSM2832 Ver 6.13 System active systems 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Description . . . . . . . . . All systems System name . . . . . . . . . __________ F4=List F12=Cancel Add system System name Enter the name of the system to be added to the *SYSACT checkpoint. Use F4 with the cursor in this field for a list of systems.
9.7.21 User defined checkpoint This screen is displayed after selecting a USRDFN checkpoint for update or add. GSM280C Ver 6.13 Monitor system operations 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Checkpoint type . . . . . . . *USRDFN Description . . . . . . . . . User defined checkpoint________ Schedule number . . . . . . . 1 F4=List Operational message receiver . *SYS______ Check cycles bypass value . . 5 User written program name . . USERPGM___ Library name . . . . . . . . .
9.8 Command codes This file holds the information about the command codes that are used when sending messages from mobile phones to the iSeries. Use option 20 on the configuration menu to display this screen. GSM2901 Ver 6.
9.8.1 Command code details This screen is displayed after selecting an entry to change, or an empty screen if F6, Create, is pressed. GSM2903 Ver 6.13 Command codes 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Command code . . . . . . . . . ZI Command code description . . . Example item inquiry Target system name . . . . . . *LOCAL Command security level Verify SMS protocol . Confirmation message . Transparent mode . . . . . . . . . . . . . . . . . . . 1 1 0 0 Command string . . .
If the command is executing the *MSGRPY message reply function the values in this field will have the following meanings. 0 No. Confirmation message will not be sent. 1 System messages. Confirmation message will be sent on replies to system messages. 2 Non-system messages. Confirmation message will be sent on replies to non-system messages. 3 All messages will generate a confirmation message. For other commands this field will have the following meanings. 0 No.
&T Origin telephone number. The telephone number of the mobile phone that sent the message. &U User ID. The user ID in the User file corresponding to the telephone number. &Z Operator timestamp. The timestamp assigned to the message by the operator. The value is 14 bytes long. The first 6 is the date in YYMMDD format, the following 6 is the time in HHMMSS format and the last two represents the time zone.
9.8.2 Parameter descriptions Description of the assigned parameters, and optional default values. This screen is displayed only if one or more parameters were defined in the previous screen. GSM2904 Ver 6.13 Command codes 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter Command code . . . . . . . . . ZI Command code description . . .
9.8.3 Command authority This screen is displayed if command security level is 0. These are the users currently granted authority to the command. GSM2911 Ver 6.13 Command authority ZI Example item inquiry Position to 12-02-01 USERID 12.00.00 SYSNAME __________ Type option, press Enter 4=Delete Opt User ID _ USERID User name User Name End F3=Exit F6=Create F12=Cancel Command code authority Option Use option 4 to delete command authority for a user.
9.8.4 Grant command authority This screen is displayed if F6 was pressed in the previous screen. GSM2912 Ver 6.13 Command authority Type values and press Enter Command code . . . . . . . . . ZE User ID . . . . . . . . . . . F12=Cancel Grant command authority User ID The user ID of the user who will be granted authority. Page 140 12-02-01 USERID 12.00.
9.8.5 Command code IS The special command code IS can be used to process incoming SMS that does not start with a command code. When this code is processed a search is made to see if there was an outgoing SMS sent to the originator of the incoming SMS. The id of the sender of the outgoing messages is then available in the &O special parameter.
9.9 Simulate message from mobile This program is used to simulate sending messages from a mobile phone to the iSeries. Messages entered are placed on the received messages queue. Use option 21 on the configuration menu to display this screen. GSM5901 Ver 6.13 Simulate msg from mobile __________ __________ __________ __________ F3=Exit F7=Message log 1 2 3 4 5 6 7 8 9 * 0 # 12-02-01 USERID 12.00.
9.9.1 Full screen entry This screen is displayed when F11 is pressed in the Simulate message from mobile phone screen. It works in the same way as the previous screen, the only difference is the possibility to type full length messages. GSM5902 Ver 6.13 Simulate msg from mobile 12-02-01 USERID 12.00.
9.10 Remote installation 9.10.1 Prepare for remote installation The Remote Installation function is intended for distribution of the MidJet GSM Text application to other systems, as an alternative to distribution on CD. Use the following preparation steps: Verify that SNADS is configured and active for the source and target systems. Sign-on to the remote system as the security officer.
9.10.2 Run remote install Select menu option 30 to use this function. This screen is displayed: GSM6801 Remote installation 12-02-01 USERID 12.00.00 SYSNAME Type values and press Enter To system . . . . . ________ F12=Cancel Remote installation Data will be extracted and sent to the remote system. Messages will be sent back to the GSMTEXT message queue on the source system indicating file transfer progress and the installation result.
MidJet GSM Text Commands All MidJet GSM Text commands are copied to library QGPL during the installation. A command may change the library list during execution. The library list is reset when the command is completed. 9.11 CHGGSMTOPR CHGGSMTOPR USID(user ID or distribution group ID) SYSN(system name, default *LOCAL) Purpose This command is used to change the receiver or operational messages from a system. Parameters USID User ID or distribution group for the new receiver of operational messages.
9.14 ENDGSMTSBS ENDGSMTSBS Purpose The ENDGSMTSBS command is used to end the MidJet GSM Text subsystem in a controlled way. Always use this command instead of ENDSBS command. This command has no parameters. 9.15 RUNGSMTRPP RUNGSMTRPP SELECT(program name, default *ALL) ORDER(sort order, default *FIFO) This command runs the reply processing programs specified in the XSBMGTM API with option delayed selected. SELECT Use this parameter to specify the name of the reply processing program you want to run.
GSM number in international format. Can be used at the same time as the USID parameter. This parameter is available for LO, LB, UO and UB license types only. MTXT The message text can be up to 160 characters long. If the message to be sent exceeds 160 characters, just divide the text into 160 character blocks and send multiple messages. SNAC Send alarm call. Specify 0 for no, 1 for yes. NDMT Non-display message in log. Specify 0 for no, 1 for yes. 9.
10 MidJet GSM Text API’s Five call level API’s are included in the product. A source file with sample programs is available, see chapter Sample programs. 10.1 XSBMGTM This API is used to create GSM Text messages. See the example program EXP001 for an example how to use this API.
in the reply column of the send log. This field is only in effect if the Request reply field is set to 1. Validity period, minutes Works in conjunction with the previous field. Reply processing program library The name of the library where the reply processing program is stored. This field is only in effect if the Request reply field is set to 1. Reply processing program name The name of the reply processing program. This field is only in effect if the Request reply field is set to 1.
Format name Use SND010 for messages in the send log and RCV010 for messages in the receive log. Return code The following codes can be returned: 0 Message successfully retrieved. 1 Message not found. 8 Wrong format name specified. 9 Program error. Receiver variable Formats SND010 and RCV010 are available in the GSMTEXT/EXPSRC source file. 10.3 XTRVGTM This API was used in version 3 of MidJet GSM Text for the same purpose as XRTVGT4 is now. It is still supported for compatibility reasons. 10.
Page 152
11 iSeries sample programs The following programs are included in the source file GSMTEXT/EXPSRC. They also exist in object form in the GSMTEXT library. 11.1 Item inquiry program EXP001 This program performs a simulated database lookup based on an item number, and sends a message back to the originator. The program is called using the ZI command code. 11.2 Order entry request EXP002 The purpose of this program is to demonstrate how message reply technique can be used.
Page 154
12 MidJet Win2000/NT Monitor Configuration This program is used for configuration of the options on the NT. Please note that the MidJet Monitor service program must first be stopped to perform most of the options. 12.1 ConfigTool main menu Main Menu Select an option by clicking on one of the buttons. Throughout the configuration program online help is available. Just click the help button, move the cursor to the desired position, and click again.
12.2 Event log This program is used to configure how the event log should be monitored. Messages arriving at the Win2000/NT’s event log will be processed by the service program MidJet Monitor. Messages selected will be transferred to the controlling iSeries. The messages will then be sent to the operator appointed for the Win2000/NT system. The ID of the operator is specified on the iSeries GSM Text Main Menu, option 10. 12.2.
process first reads all the filter entries. If a filter entry matches, the event log entry is included or excluded based on that filter entry. Event log filter Event-ID The ID of the event you want to include or exclude. Special value (any) allows you to make the selection based only on the source. Source The source of the event you want to include or exclude. Special value (any) allows you to make the selection based only on the event id Note.
12.3 Other logs This screen is used to define other than NT system log files that you want to monitor. The log files must be in text format. Other logs Active logs This box holds the names of the logs currently being monitored. By selecting a file and press the > button the log will be moved to the Inactive logs box. By pressing the >> all active logs will be moved to Inactive logs. Inactive logs This box holds the names of the inactive logs.
12.4 Commands This screen is used to define the command codes for program start requests from the GSM telephone. A message indicating successful program start can be sent as an option. This is set in the iSeries. If the program start fails, a message is always created. Commands Commands List of define command codes. Command code The one or two character command code. This code must also be created on the iSeries.
12.5 Processes NT processes monitored to check they are active are configured in this screen. If a process is missing, this will be reported to the operator of the NT. When a missing process is recovered, this will also be reported. Processes Processes List of processes to be monitored. Process name The name of the process, without any file extension. Description Descriptive text of the process.
12.6 TCP/IP Configuration IP address of the iSeries with MidJet GSM Text product installed. TCP/IP Configuration IP Address The IP address of the iSeries. Port number outgoing Port number to use for outgoing communication. The value 6851 is assigned during installation, and should only be changed if it must be used for another purpose. Port number incoming Port number to use for incoming communication.
Page 162
13 Win2000/NT Monitor Background program 13.1 Program purpose MidJet Win2000/NT Monitor uses a program, MidJetMonitor, implemented as a service. This program handles the system monitor function and program start requests initiated from the iSeries.
Page 164
14 MidJet NT Monitor DLL This DLL is constructed using Borland C+++ Builder and contains two API’s: SndMsg and SndErr. Together with the DLL file there is also a LIB file called MidJet.lib. 14.1 SndMsg API This API will send a message to a TCP/IP server. The message is built up of a telephone number, a message text and an alert code. The IP-address and port number of the server has to be specified in the ConfigTool of the MidJet NT Monitor software.
Page 166
15 Modems and GSM modules 15.1 Asynchronous modems MidJet GSM Text is developed using asynchronous modems of types Ericsson V34DT and Multitech MT1932ZDXI. No change of the factory configuration of these modems is required. If you intend to use asynchronous connection type we recommend that you use one of these, or a 100% compatible.
Page 168
16 Using the mobile phone 16.1 Prepare the mobile phone In order to use the mobile phone to send messages to the iSeries, follow these steps if you have not yet used the message function. Verify that the short message centre address is registered on the mobile phone. The telephone should send messages as text. Send a message to your own GSM number to verify the function. If it does not arrive, or if a related question arises, consult your GSM operator’s help desk. 16.
ZE command completed. This message is received because the Confirmation message field is set to 1. Then the following message is received: RPG0102 DEMOERR 1800 tried to divide by zero (factor 2) (C G S D F). --> Rpy to nbr: 1. The format for sending replies to messages is always: Rn reply Where R is the command code for message reply, n is the reply number assigned by the iSeries. If the reply number is 1, it can be omitted, as in the following example.
Enter message text ZO 100 200 300 and send the message to the iSeries. The response will be: Item: 0000100, Customer: 0200, Qty: 300 available. Crt order? (Y N)--> Rpy to nbr: 1. By sending the reply R Y an example order printout will be created in out queue GSMTEXT/GSMTEXT and the following confirmation message will be received: Successful reply Y to nbr 1. Message text: Item: 0000100, Customer: 0200, Qty: 300 available.
Page 172
17 Index * *CFGSTS ................................................................................................................ 110, 112 *HTTP ..................................................................................................................... 110, 113 *JOB ....................................................................................................................... 110, 114 *JOBQ...................................................................................................
Country prefix ...................................................................................................... 54, 66, 100 CRTGSMTSRV ............................................................................................................... 146 D data address ........................................................................................................... 105, 106 Date......................................................................................................................
L Language ........................................................................................................................ 161 Language code ................................................................................................................. 66 license ......................................................................................................................... 13, 18 License agreement ..........................................................................................
PIN code ............................................................................................................... 15, 91, 94 POP3............................................................................................................................. 9, 27 Port number .................................................................................................. 67, 93, 95, 128 Processes ...........................................................................................................
SNDGSMTMSG .................................................................................................. 25, 27, 147 SndMsg API .................................................................................................................... 165 spool files ........................................................................................................................ 125 SSL .....................................................................................................................