Commoduser Gentran_Communications_Module_User_Guide Gentran Communications Module User Guide

User Manual: Gentran_Communications_Module_User_Guide user guide pdf - FTP File Search (14/20)

Open the PDF directly: View PDF PDF.
Page Count: 678 [warning: Documents this large are best viewed by clicking the View PDF Link!]

Gentran:Server® for iSeries®
Communications Module
User Guide
Release 3.5
Sterling Commerce (Mid America), Inc.
4600 Lakehurst Court Dublin, OH 43016-2000 * 614/793-4000
© Copyright 1988–2008—Sterling Commerce, Inc.
0281-350-USER01-0000
April 2008
Gentran:Server for iSeries
© Copyright 1988 – 2008
Sterling Commerce, Inc.
ALL RIGHTS RESERVED
Sterling Commerce Software
Trade Secret Notice
THE GENTRAN:SERVER FOR ISERIES SOFTWARE (“STERLING COMMERCE
SOFTWARE”) IS THE CONFIDENTIAL AND TRADE SECRET PROPERTY OF STERLING
COMMERCE, INC., ITS AFFILIATED COMPANIES OR ITS OR THEIR LICENSORS, AND IS
PROVIDED UNDER THE TERMS OF A LICENSE AGREEMENT. NO DUPLICATION OR
DISCLOSURE WITHOUT PRIOR WRITTEN PERMISSION. RESTRICTED RIGHTS.
This documentation, the Sterling Commerce Software it describes, and the information and know-how they contain
constitute the proprietary, confidential and valuable trade secret information of Sterling Commerce, Inc., its affiliated
companies or its or their licensors, and may not be used for any unauthorized purpose, or disclosed to others without
the prior written permission of the applicable Sterling Commerce entity. This documentation and the Sterling
Commerce Software that it describes have been provided pursuant to a license agreement that contains prohibitions
against and/or restrictions on their copying, modification and use. Duplication, in whole or in part, if and when
permitted, shall bear this notice and the Sterling Commerce, Inc. copyright notice.
As and when provided to any governmental entity, government contractor or subcontractor subject to the FARs, this
documentation is provided with RESTRICTED RIGHTS under Title 48 CFR 52.227-19. Further, as and when provided
to any governmental entity, government contractor or subcontractor subject to DFARs, this documentation and the
Sterling Commerce Software it describes are provided pursuant to the customary Sterling Commerce license, as
described in Title 48 CFR 227-7202 with respect to commercial software and commercial software documentation.
These terms of use shall be governed by the laws of the State of Ohio, USA, without regard to its conflict of laws
provisions. If you are accessing the Sterling Commerce Software under an executed agreement, then nothing in these
terms and conditions supersedes or modifies the executed agreement.
Product names mentioned herein may be trademarks and/or registered trademarks of their respective companies.
GENTRAN and GENTRAN:Server are registered trademarks of Sterling Commerce, Inc.
Third Party Software:
Portions of the Sterling Commerce Software may include products, or may be distributed on the same storage media
with products, (“Third Party Software”) offered by third parties (“Third Party Licensors”).
Warranty Disclaimer
This documentation and the Sterling Commerce Software which it describes are licensed either "AS IS" or with a
limited warranty, as set forth in the Sterling Commerce license agreement. Other than any limited warranties provided,
NO OTHER WARRANTY IS EXPRESSED AND NONE SHALL BE IMPLIED, INCLUDING THE WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR USE OR FOR A PARTICULAR PURPOSE. The applicable Sterling
Commerce entity reserves the right to revise this publication from time to time and to make changes in the content
hereof without the obligation to notify any person or entity of such revisions or changes.
The Third Party Software is provided 'AS IS' WITHOUT ANY WARRANTY AND ANY EXPRESSED OR IMPLIED
WARRANTIES, INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, AND
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. FURTHER, IF YOU ARE LOCATED OR ACCESSING
THIS SOFTWARE IN THE UNITED STATES, ANY EXPRESS OR IMPLIED WARRANTY REGARDING TITLE OR
NON-INFRINGEMENT ARE DISCLAIMED.
Gentran:Server for iSeries Communications Module Release 3.5 User Guide i
Table of Contents
Chapter 1 Overview ..........................................................................................1-1
How is the Documentation Organized?.................................................................... 1-1
In this Book .............................................................................................................. 1-1
What is in Each Chapter? ......................................................................................... 1-2
Other Gentran:Server for iSeries Communications Module Guides........................ 1-4
Chapter 2 System Essentials ...........................................................................2-1
In this Chapter .......................................................................................................... 2-1
Take a Closer Look at the Communications Module............................................... 2-3
Gentran:Server Panels .............................................................................................. 2-5
Getting Help ........................................................................................................... 2-23
Print Reports in Gentran:Server ............................................................................. 2-29
Product Support and Remote Maintenance ............................................................ 2-31
Chapter 3 Environment Control .......................................................................3-1
In this Chapter .......................................................................................................... 3-1
What is Environment Control?................................................................................. 3-1
What Does the Environment Control Subsystem Do? ............................................. 3-2
Panel Quick Reference ............................................................................................. 3-2
Environment Control Panels..................................................................................... 3-3
Reports.................................................................................................................... 3-14
Common Questions ................................................................................................ 3-17
Chapter 4 Using Communications ..................................................................4-1
In this Chapter .......................................................................................................... 4-1
What Is Communications? ....................................................................................... 4-2
What Does the Communications Subsystem Do?.................................................... 4-2
Take a Closer Look at Communications .................................................................. 4-3
Panel Quick Reference ............................................................................................. 4-5
Access the Communications Subsystem ................................................................ 4-12
Communications Setup........................................................................................... 4-15
Copy Profiles and Scripts ....................................................................................... 4-58
Operations and Management of Communications ................................................. 4-64
Use the ezCOMM Command ............................................................................... 4-123
Reports.................................................................................................................. 4-126
Common Questions .............................................................................................. 4-129
Table of Contents
ii Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Chapter 5 Using Scripts ...................................................................................5-1
Work with Session Control Scripts .......................................................................... 5-1
Script Decision Tables............................................................................................ 5-11
Extended Script Logic ............................................................................................ 5-24
Remote Command Support .................................................................................... 5-29
What is Dynamic Scripting?................................................................................... 5-41
Sync Extended Script Logic ................................................................................... 5-45
Chapter 6 Bisync Communications Support ..................................................6-1
Introduction .............................................................................................................. 6-1
Bisync Configuration................................................................................................ 6-2
BSC Tables............................................................................................................. 6-13
BSC Print Carriage Control Conversion ............................................................... 6-16
Requirements Checklist.......................................................................................... 6-17
Chapter 7 SNA Communications Support ......................................................7-1
Introduction .............................................................................................................. 7-1
SNA/LU0 Configuration .......................................................................................... 7-2
SNA/LU0 Tables .................................................................................................... 7-11
Remote Program Start Request .............................................................................. 7-14
Connect:Mailbox/Supertracs .................................................................................. 7-21
Communicate with JES2 SNA ............................................................................... 7-29
Chapter 8 SNA LU6.2 Communications Support ...........................................8-1
Introduction .............................................................................................................. 8-1
LU6.2 Configuration ................................................................................................ 8-2
X62/L62 Tables...................................................................................................... 8-11
LU6.2 via SDLC Examples................................................................................... 8-14
LU6.2 via X.25 Examples ..................................................................................... 8-34
Chapter 9 Asynchronous Communication Support ......................................9-1
Overview of Asynchronous Data Transmission....................................................... 9-1
Asynchronous Protocols.......................................................................................... 9-1
Modem Considerations............................................................................................. 9-2
Error Detection and Correction ................................................................................ 9-3
Clear To Send........................................................................................................... 9-4
AT or V.25bis Command Set ................................................................................... 9-5
Default Modem Strings in the Profile ...................................................................... 9-6
Modem Initialization Commands............................................................................. 9-7
Modem Dialing Commands ..................................................................................... 9-8
Receive Calls............................................................................................................ 9-9
Flow Control........................................................................................................... 9-10
Table of Contents
Gentran:Server for iSeries Communications Module Release 3.5 User Guide iii
Translation.............................................................................................................. 9-11
Translation Examples ............................................................................................. 9-13
Scripting Considerations ........................................................................................ 9-14
Basic Scripting Concepts........................................................................................ 9-14
Supported Script Transaction Types and Actions .................................................. 9-16
Use of ETX, EOT, and End-of-Cmd Characters.................................................... 9-19
Use of the Command Field..................................................................................... 9-20
Explanation of Script Indicators............................................................................. 9-21
Asynchronous Extended Script Logic.................................................................... 9-25
“Create Your Own” Protocol.................................................................................. 9-33
Print Control ........................................................................................................... 9-34
Dynamic Scripting.................................................................................................. 9-35
Remote Command Support .................................................................................... 9-36
Transparent Data .................................................................................................... 9-37
Evoke Considerations............................................................................................. 9-38
Asynchronous (ASC) Communication Examples.................................................. 9-40
Asynchronous (XAS) via X.25 Examples.............................................................. 9-50
Chapter 10 XMODEM File Transfer Support ...................................................10-1
Introduction ............................................................................................................ 10-1
Considerations ........................................................................................................ 10-2
Configuration.......................................................................................................... 10-4
Chapter 11 OFTP Communication Support ....................................................11-1
Overview ................................................................................................................ 11-1
Create an OFTP Profile .......................................................................................... 11-4
Create an OFTP Script.......................................................................................... 11-13
Chapter 12 FTP Communication Support .......................................................12-1
Introduction ............................................................................................................ 12-1
Considerations ........................................................................................................ 12-2
Gentran:Server FTP Configuration ........................................................................ 12-7
FTP Communication Session Control Scripts...................................................... 12-12
Use the FTP Server Interface ............................................................................... 12-33
Chapter 13 Using Line Pools ...........................................................................13-1
Introduction ............................................................................................................ 13-1
Create a Line Pool .................................................................................................. 13-3
Set Up a Line Pool with a Comm Profile............................................................... 13-4
Table of Contents
iv Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Chapter 14 MQSeries Interface ........................................................................14-1
In this Chapter ........................................................................................................ 14-1
Overview of MQSeries Interface............................................................................ 14-1
MQ Link Panels...................................................................................................... 14-3
Gentran MQSeries Configuration......................................................................... 14-11
Send Files to MQSeries........................................................................................ 14-13
Receive Files from MQSeries .............................................................................. 14-15
Report ................................................................................................................... 14-17
Chapter 15 Gentran IFS Gateway ....................................................................15-1
In this Chapter ........................................................................................................ 15-1
What is GIFSGATE?.............................................................................................. 15-2
How to use the GIFSGATE command................................................................... 15-4
Stopping the IFS Gateway.................................................................................... 15-10
How to Use the GENIBQIFS Command.............................................................. 15-11
Chapter 16 Job Scheduler ................................................................................16-1
In this Chapter ........................................................................................................ 16-1
What is the Job Scheduler?..................................................................................... 16-1
What does the Job Scheduler Function Do?........................................................... 16-2
Take a Closer Look at the Job Scheduler ............................................................... 16-2
Start the Subsystem Used by the Job Scheduler..................................................... 16-3
Panel Quick Reference ........................................................................................... 16-3
Use the Job Scheduler Panels................................................................................. 16-5
Common Questions .............................................................................................. 16-31
Chapter 17 System Configuration File ............................................................17-1
In this Chapter ........................................................................................................ 17-1
What is the System Configuration File?................................................................. 17-2
Use the System Configuration Menu ..................................................................... 17-4
Chapter 18 Gentran File Tracking ...................................................................18-1
In this Chapter ........................................................................................................ 18-1
What is Gentran File Tracking? ............................................................................. 18-1
Panel Quick Reference ........................................................................................... 18-2
Access the Gentran File Tracking Subsystem ........................................................ 18-3
Configure Gentran File Tracking ........................................................................... 18-5
Work with Gentran File Tracking .......................................................................... 18-8
Print the Gentran File Tracking Report................................................................ 18-18
Purge the File Tracking Entries (PRGFILETRK)................................................ 18-23
Retrieve the Gentran File Tracking Entries (RTVFILETRK).............................. 18-27
Reports.................................................................................................................. 18-30
Table of Contents
Gentran:Server for iSeries Communications Module Release 3.5 User Guide v
Appendix A Modems: Configuration and Troubleshooting ............................. A-1
Overview ................................................................................................................. A-1
Configuration Requirements ................................................................................... A-4
Troubleshooting Problems....................................................................................... A-4
Appendix B Translating between ASCII and EBCDIC....................................... B-1
Outbound Translation Table (EBCDIC-to-ASCII) .................................................. B-2
Inbound Translation Table (ASCII-to-EBCDIC)..................................................... B-3
Glossary
Index
Table of Contents
vi Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Chapter
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 1 - 1
1 Overview
How is the Documentation Organized?
Information about the Gentran:Server for iSeries Communications Module is available through
both online help and the user documentation (provided on CD-ROM). Online help contains
reference material (panel definitions, field definitions, etc.). It gives you quick access to relevant
documentation as you are using the Communications Module. The user documentation describes
procedures (“how to. . .”) and is intended to complement and enhance the online help.
In this Book
The User Guide is comprised of 17 chapters, two appendices, a glossary of communication terms,
and an index. The Using Communications chapter is presented in tutorial format and is intended as
an instructional procedural reference. The other chapters cover specific communications topics,
such as one of the supported protocols or line pools, in greater detail. To get the most out of these
chapters, we recommend that you start by reading the first chapter thoroughly to familiarize
yourself with the basics of the Communications Module. The other chapters are intended for more
referential use, and they will be more easily understood if you are familiar with the basic
information presented in the Using Communications chapter.
# NOTE
Due to the uniqueness of each implementation, the predefined Communication scripts are
provided as examples only and are intended to assist you in getting stated. Please read the
User Guide provided by your value-added network or communication partner to ensure that
the setup correctly reflects their specific requirements.
What is in Each Chapter? Overview
1 - 2 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
What is in Each Chapter?
1. Overview
This chapter provides information about how this guide is organized and a summary of the
contents of each chapter.
2. System Essentials
This chapter provides an overview of the Gentran:Server for iSeries Communications
Module, including the online help feature. The chapter covers general techniques for using
the system. It explains how to move from one panel to the next, how to use the function
keys and options, and other important information. We recommend that everyone read this
chapter.
3. Environment Control
This chapter presents the procedures for setting up each users work environment,
including parameters for output destinations, batch job description, and data formats. The
chapter also covers the procedures for defining security at the subsystem, function and
data levels.
The audience for this chapter is the System Administrator or Security Officer
(QSECOFR), who should be solely responsible for these tasks.
4. Using Communications
This chapter illustrates the use of the communications subsystem within Gentran:Server
for iSeries. General information sections explain the capabilities of the software and the
concepts on which the subsystem is based. The general information is supplemented by
step-by-step examples, presented in a tutorial format, that detail how the communications
subsystem is used. Information in this section is intended for all users of the
communications subsystem.
5. Using Scripts
This chapter contains detailed information about creating and using communications
scripts, including extended script logic, remote command support, and dynamic scripting.
6. Bisync Communications Support
This chapter covers specific information about using bisynchronous communications with
the Gentran:Server communications subsystem.
7. SNA Communications Support
This chapter covers specific information about using SNA/LU0 communications with the
Gentran:Server communications subsystem.
8. SNA LU6.2 Communications Support
This chapter covers specific information about using the optional add-on SNA LU6.2
module (purchased separately) with the Gentran:Server communications subsystem.
Overview What is in Each Chapter?
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 1 - 3
9. Asynchronous Communication Support
This chapter covers specific information about using the optional add-on asynchronous
module (purchased separately) with the Gentran:Server communications subsystem.
10. XMODEM File Transfer Support
This chapter contains information about using XMODEM. You must also have the
asynchronous add-on module to use XMODEM.
11. OFTP Communication Support
This chapter contains information about using the Odette File Transfer Protocol (OFTP).
You must also have the asynchronous add-on module to use OFTP.
12. FTP Communication Support
This chapter covers specific information about using the optional add-on File Transfer
Protocol (FTP) module (purchased separately) with the Gentran:Server communications
subsystem.
13. Using Line Pools
This chapter covers specific information about using line pools with Gentran:Server
communications. Line pools enable you to have a number of communications jobs active
at one time, all sharing the same “pool” of up to five iSeries line resources.
14. MQSeries Interface
This chapter covers information about the Gentran:Server interface with MQSeries.
15. Gentran IFS Gateway
This chapter covers specific information about the Gentran IFS Gateway (GIFSGATE).
GIFSGATE is an interface between the Gentran:Server for iSeries Communications
Module and the Integrated File System (IFS).
16. Job Scheduler
This chapter covers the tasks associated with the Job Scheduler, which is a function that
allows you to specify the dates, times, frequency, and other parameters for running jobs in
an unattended mode.
The audience for this chapter is the System Administrator or Security Officer
(QSECOFR), who is normally responsible for these tasks.
17. System Configuration File
This chapter provides the procedures to set the break year and date format for commands.
Appendix A. Modems: Configuration and Troubleshooting
This appendix contains a list of recommended modems for use with
Gentran:Server and troubleshooting tips.
Appendix B. Translating between ASCII and EBCDIC
This appendix contains a translation table for EBCDIC to ASCII, and one for
ASCII to EBCDIC translations.
Other Gentran:Server for iSeries Communications Module Guides Overview
1 - 4 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Other Gentran:Server for iSeries
Communications Module Guides
The Gentran:Server for iSeries Communications Module documentation set includes other guides
and instructional materials. The following publications are available as part of the licensed system:
Gentran:Server for iSeries Communications Module Release 3.5 Release Notes and
Impact Information
The Release Notes describe system enhancements and new functionality that have been
incorporated into this release. Please read the 3.5 Release Notes carefully prior to
installing Gentran:Server.
The Impact Information gives users of previous releases information on structural
changes, including any changes to commands, CLs, and database files. These may
necessitate changes to your implementation of Gentran:Server for iSeries
Communications Module. Please read the Impact section carefully prior to installation.
Gentran:Server for iSeries Communications Module Release 3.5 Installation Guide
The Installation Guide provides step-by-step product installation instructions and cumulative
fix installation instructions. Please read all the instructions prior to beginning the installation.
Chapter
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 2 - 1
2 System Essentials
In this Chapter
Thank you for selecting the Gentran:Server for iSeries Communications Module (the
Communications Module).
To take full advantage of this powerful system, it is important that you understand some basic
concepts before you begin. “System Essentials” serves as an introductory chapter to help you
become familiar with the system’s purpose, features, organization, and operation. This chapter
covers the following topics:
¾What is the Communications Module?............................................................................ 2-2
¾Take a Closer Look at the Communications Module....................................................... 2-3
¾Gentran:Server Panels...................................................................................................... 2-5
The ‘Work With’ Concept ......................................................................................... 2-6
Understand the Panel Structure ................................................................................. 2-6
The Components of a Gentran:Server Panel ............................................................. 2-8
¾Shortcuts......................................................................................................................... 2-18
Access a Panel from a Service................................................................................. 2-20
Use the Command Line........................................................................................... 2-21
¾Getting Help................................................................................................................... 2-23
Use Online Help ...................................................................................................... 2-23
Use the Search Index............................................................................................... 2-28
¾Print Reports in Gentran:Server..................................................................................... 2-29
¾Product Support and Remote Maintenance.................................................................... 2-31
In this Chapter System Essentials
2 - 2 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
What is the Communications Module?
The Gentran:Server Communications Module enables you to send/receive data electronically with
communication partners, while tracking and monitoring the entire process. The Communications
Module enables you to perform these tasks:
Create communication profiles for many different protocols
Create scripts
Monitor active communication sessions
View the history log
Manage the data sent and received
Schedule jobs
Perform traces
Purge and retrieve data.
System Essentials Take a Closer Look at the Communications Module
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 2 - 3
Take a Closer Look at the Communications
Module
This section explains the organization of the Gentran:Server for iSeries Communications Module.
Gentran:Server acts as an interface between your in-house applications and your communication
partners. The communications process can be fully automated. You can initiate communications
processing through the menu interface or by scheduling it to run at a predefined time. Application
processing jobs to add or extract data from the communication queues can also be scheduled.
Day-to-day user interaction is recommended to review the online Communications history log,
communication queues, and job scheduler entries to monitor the flow of data.
How is the Communications Module Organized?
The Gentran:Server for iSeries Communications Module is comprised of several integrated
program subsystems. The following table lists the subsystems and highlights their functionality.
Subsystem Purpose
Communications Set up the profiles and scripts for data transmissions between you
and your partner(s).
Environment Control Define environment parameters (such as libraries and print
queues) and the security privileges for each Gentran:Server user.
Security controls access at the subsystem and function levels as
well as data update authority.
System Administration
Job Scheduler
System Configuration
Control system activities such as the Job Scheduler and System
Configuration.
Take a Closer Look at the Communications Module System Essentials
2 - 4 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Find Subsystems and Functions within the Communications
Module
Gentran:Server subsystems are used to group similar programs and commands into a category.
Each subsystem is made up of a group of functions (commands and programs), each of which
performs a specific activity such as setting up a communication partner. Typically, entries on the
main menu identify a subsystem. In the Communications Module, however, the job scheduler and
system configuration menu are both in the system administration subsystem, as shown in
Figure 2.1.
Figure 2.1 Subsystems and functions within Gentran:Server
Select option 1 on the GENMAIN menu and press Enter. The Communications menu is
displayed.
As you use Gentran:Server, keep in mind that the functions within each subsystem are linked
together like a network. Your path (the sequence of panels that appear) depends on the data that
you enter on each panel. This flexible structure allows Gentran:Server to move quickly between
the functions without multiple layers of menu trees.
# NOTE
In addition to the subsystems, the main menu includes the Gentran:Server Search Index,
which displays online help for glossary terms, field definitions, and other topical information
available as hypertext. This index is comprehensive for the entire Gentran:Server product and
is not limited to the Communications Module.
GENMAIN Gentran:Server for iSeries Communications 3.5
System: ISDDEV01
Select one of the following:
1. Communications Menu (GENCOM)
2. Work with Job Scheduler
3. Work with Environment Control
4. System Configuration Menu (GENSYSCFG)
10. Gentran:Server Search Index
13. Gentran File Tracking Menu (GENFILETRK)
90. Sign off
Bottom
Selec
===>
F3=Exi
(C) CO
Gentran:Server for iSeries Communications 3.5 Main Menu
GENCOM Gentran:Server Communications 3.5
System: ISDDEV01
Select one of the following:
1. Work with Communications
2. Work with Session Scripts
3. Work with Comm History File
4. Work with Outbound Queue
5. Work with Inbound Queue
6. Work with Active Comm Jobs
7. Work with Network Profiles
8. Work with MQ Links
10. Start a Comm Session (STRCOMSSN)
11. Start a Comm Session with Trace (STRCOMSSNT)
12. End Active Comm Jobs (SHUTDOWN)
13. Gentran Line Pools (GENLINP)
14. Purge All Communication Files (PRGALL)
More...
Selection or command
===>
F3=Exit F4=Prompt F9=Retrieve F12=Cancel F13=User Support
(C) COPYRIGHT Sterling Commerce Inc., 2008, ALL RIGHTS RESERVED.
Functions in Gentran:Server
Communications Module
Subsystems in Gentran:Server
Communications Module
System Essentials Gentran:Server Panels
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 2 - 5
Gentran:Server Panels
This section presents basic instructions for using the Gentran:Server panels and commands.
Although the many system features vary in complexity from “simple” to “expert” level, most of
the system can be operated with just a few basic commands.
To use Gentran:Server, you must have a valid iSeries user profile. Gentran:Server uses your
iSeries User ID to identify who you are, to control which subsystems and functions you can access,
and to track the changes that you make in any files.
Your iSeries Security Officer can give you instructions for using the terminal hardware and
operating system at your location. You should be familiar with basic iSeries concepts prior to using
Gentran:Server.
Based on the configuration of your iSeries user profile and the conventions in place at your site,
you might start up Gentran:Server in one of three ways.
As Part of Your Login Routine
Your iSeries user profile can be set up so that each time you log on to the iSeries, you
automatically access the Gentran:Server main menu. If this is the case, you can immediately
begin to use Gentran:Server menu options.
From a Menu
Many sites set up their own menu structure or customize third-party software so Gentran can
be invoked from a menu.
From the iSeries Command Line
If Gentran:Server is not offered as a menu option at your site, you can invoke it by using the
iSeries GO (go to menu) command. Type GO GENMAIN on the iSeries command line and press
the Enter key. The Gentran:Server main menu appears, allowing you to begin accessing
Gentran’s menu options.
Two other Gentran:Server menus available from the command line are: the Communications
menu (GO GENCOM) and the System Configuration menu (GO GENSYSCFG).
# NOTE
Prior to accessing Gentran, you may have to add one or more Gentran:Server libraries to your
library list. If you are unsure about this process, please contact your System Administrator
for instructions on adding or modifying entries in your library list. The default libraries that
are supplied with Gentran:Server are G35DTA and G35PGM. Make sure the library QTEMP
is in your library list.
Gentran:Server Panels System Essentials
2 - 6 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
The ‘Work With’ Concept
Gentran:Server uses the iSeries ‘Work With’ concept. When you first access the Gentran:Server
system, the main menu (GENMAIN) appears as shown in Figure 2.2. From GENMAIN, you can
access any of the Gentran:Server subsystems by typing the associated option number on the
command line and pressing the Enter key. For example, if you want to access Communications,
type 1 on the command line and press Enter.
Figure 2.2 Enter the subsystem number on the command line.
Gentran:Server displays the Gentran:Server Communications (GENCOM) menu.
If Gentran:Server does not display a menu, the next panel to appear depends on the entries that you
made on the previous panel. In a sense, Gentran:Server “protects” you from making mistakes or
omissions. Based on the entries you make on various Gentran:Server panels, the system leads you
through a series of related panels on which you need to fill in information before you can complete
the task. This “captive” feature ensures that the profiles and scripts you create have all the
information necessary to be processed successfully.
Understand the Panel Structure
The online screens Gentran:Server displays are called “panels”. All Gentran:Server panels have
the same “look and feel”. That is, all panels have the same general appearance and respond to your
input in a similar way. There are several components on a Gentran:Server panel. Some
components are always present; other components occur only on certain types of panels.
These components appear on all Gentran:Server panels:
Program and Format Name
Panel Description
Users Initials
Message Line
GENMAIN Gentran:Server for iSeries Communications 3.5
System: ISDDEV01
Select one of the following:
1. Communications Menu (GENCOM)
2. Work with Job Scheduler
3. Work with Environment Control
4. System Configuration Menu (GENSYSCFG)
10. Gentran:Server Search Index
13. Gentran File Tracking Menu (GENFILETRK)
90. Sign off
Bottom
Selection or command
===> 1
F3=Exit F4=Prompt F9=Retrieve F12=Cancel F13=User Support
(C) COPYRIGHT Sterling Commerce Inc., 2008, ALL RIGHTS RESERVED.
System Essentials Gentran:Server Panels
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 2 - 7
Function Keys
Panel Fields
System Date/Time
These components appear only on some Gentran:Server panels:
Option Fields
Option Codes
Panel Continuation
Command Line
Key Entry Line
Figure 2.3 shows the components of a typical Gentran:Server panel.
Figure 2.3 The components of a typical Gentran:Server panel
EDIX400 Work with Communications EDI 04/30/08
FMT01 pgmlib: G3X5PGM dtalib: G3X5DTA 12:00:00
Position to Profile ID . . . . . .
Type option (and Information), press Enter.
1=Create 2=Revise 3=Copy 4=Delete 5=View 11=Line/Ctl/Dev
Opt Profile ID Company
ADVBSC ADVANTIS BSC
ADVLU0 ADVANTIS SDLC
ATLASFTX Atlas in France via OFTP/X.25
ATTEASY AT&T EASYLINK SERVICES
ATTUK AT&T IN THE UNITED KINGDOM
AUTOANS TEST AUTOANSWER CONFIG
BTASCL BT UK GNS EDI*NET Async "Live" Sys
BTASCT BT UK GNS EDI*NET Async "Test" Sys
BTOFTP BT UK GNS EDI*NET OFTP via Async
More...
Parameters or command
===>
F1=Help F3=Exit F12=Cancel F15=Sort F23=More Options F24=More Keys
option fields
panel fields function keys panel
continuation
user’s
initials
option
codes
program and
format name
key
entry
line
current
system
date &
time
panel description
current active program
and data libraries
Gentran:Server Panels System Essentials
2 - 8 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
The Components of a Gentran:Server Panel
Program and Format Name
Most Gentran:Server panels have a unique program name and format name on the upper left
corner of the panel. The program name remains the same for all panels in a multi-panel function.
The format name will change for each panel in a multi-panel function.
Panel Description
This is a textual name for the panel. Since panel descriptions are not always unique, be careful
when you refer to panels by name. Always check both the panel description and the
program/format name.
# NOTE
Using Captive Panels
Many Gentran:Server panels are “captive”. This means that the panel automatically appears
based on the values you entered on a previous panel. You can tell whether a new panel has
appeared by checking the program name and format name, which are unique identifiers
located on the upper left corner of the panel. (SEE the sections on options and function keys
later in this chapter for more information about moving between panels.)
Program and Data Libraries
The current active program and data libraries are shown below the panel description. This
information is retrieved from the data area GENLIB.
Option Codes
Option codes appear only on panels that display multiple records. Option codes are numbers that
represent actions to be performed on one or more of the records. For example, in the previous
figure, the panel displays multiple elements for a segment in a particular standards transaction. The
option codes represent actions that can be performed on one or more of the elements. Additional
option codes can be shown by pressing F23 (More Options), where available.
Option Fields
To select an option, type the number in the Option field to the left of the appropriate line item(s)
and press Enter. You can perform more than one option (i.e., View, Copy, Add, Change, Delete)
associated with a field maintenance task at a time. Enter as many option codes in the option fields
as you like, then press Enter. The system performs the options starting at the top of the panel and
continuing down to the bottom of the page.
# NOTE
With the exception of “Work with” panels, options can be carried forward from one page to
the next.
System Essentials Gentran:Server Panels
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 2 - 9
Panel Fields
You will need to enter values in one or more fields on each panel. These fields describe the profiles
and scripts you are creating and/or instruct Gentran:Server on what to do with the profiles you are
creating. Depending on the types of information being entered, the panel fields appear on various
areas of the panel. The field values that you type in are not entered into the system until you press
a specific function key, usually the Enter or F10 (Update) key. Pressing this key enters all the field
values on the panel into the system at the same time. (SEE the “Function Keys” section later in this
chapter for more information about entering data into the system).
User’s Initials
Your initials are defined in the Environment Control subsystem. These always display in the upper
right corner of the panel. (By the way, have you been introduced to Elizabeth D. Ingram? Liz was
kind enough to supply all the tutorial materials for this manual and her initials (EDI) appear on
every panel.)
System Date and Time
The current date and time are shown in the upper right corner of the panel. The date is displayed in
a variety of date formats with various separators and can be customized for each user.
Key Entry Line
This is the blank line at the top of the subfile in which you enter the key fields necessary to
advance to the next panel, as specified by the option code selected.
Message Line
In response to actions that you perform, the system displays messages just below the function
keys. Always be sure to read the messages displayed in this area. For additional information, place
the cursor on the message and press F1 (Help). This is available for most messages.
Function Keys
The list of function keys appears at the bottom of the panel. Function keys perform many actions
such as exiting from a panel, printing a report or sorting a file. Gentran:Server uses a wide variety
of function keys. Each panel displays only those functions keys that are active for that particular
panel. Consult your hardware manual for information about using multiple key strokes to access
the higher numbered function keys. Additional function keys can be shown by pressing F24 (More
Keys).
Panel Continuation
Some panels contain more information than the screen can hold at one time. These panels appear
as multiple “pages”. Panels with multiple pages have the word “More...” at the bottom right
corner of the panel. Use the Page Up (Roll Down) and Page Down (Roll Up) keys on your
keyboard to move between the multiple pages of the panel.
Gentran:Server Panels System Essentials
2 - 10 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Basic System Terms and Concepts
Before we can explain the options and function keys available in Gentran:Server, we must first
define some basic terms that are used throughout this manual in discussing the panels.
Access Mode
This defines the type of activity you can perform on a panel. Typically, the mode is
determined by the option you selected on the previous panel. For example, you could
select option 1 (Create) on a panel so the next panel is accessed in “create mode”,
allowing you to add a new record.
Captive Panel
Captive panels refer to panels that are “tied” together and must be reviewed before
“creates” are performed. This arrangement prevents you from inadvertently missing a
panel that contains important information critical for processing.
In create mode, if F10 (Update) is pressed from a panel that has associated captive panels,
the system displays the next captive panel with a message indicating that you must review
this panel before updating. Once all captive panels have been reviewed, press F10 again to
actually add the record and return to the calling panel.
To access captive panels in any mode, press Enter or F8 (Next) to advance forward or
press F7 (Back) to advance backward. To confirm updates, press F10.
Key Entry Line
This is the blank line at the top of the list on a “Work with” panel in which you enter the
key fields necessary to advance to the next panel, as specified by the option code selected.
Use the Function Keys
Active function keys appear at the bottom of each panel. Press F24 (More Keys) repeatedly to
display additional function keys. The following standard function keys are active on most panels:
F1=Help
Provides either additional information about the panel in general or about a specific field
within the panel depending on the where the cursor is located on the panel when you press F1.
When displaying help information for a field, you can press F2 (Extended help) to get panel
help. This help can be printed. (SEE “Getting Help” later in this chapter for more information
about online help.)
F3=Exit
Ends the current function and returns you to the display from which the function was
started.
F4=Prompt
Supplies a window containing valid field values or a selection list for the appropriate file.
When you press F4 on a menu or in a field on a “Work with” panel for which no values
have been defined, the system displays the iSeries’ Major Command Groups (MAJOR)
panel. Press F3 (Exit) or F12 (Cancel) to return to the active panel.
System Essentials Gentran:Server Panels
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 2 - 11
F5=Refresh
Redisplays the panel with the most recent information and removes any outstanding
selections or keyed data.
F7=Back
Displays the previous panel associated with a captive panel (associated with the same
record).
F8=Next
Displays the next panel associated with a captive panel.
F9=Retrieve
Shows the last command entered on the command line along with any included
parameters. Press this key once to retrieve the last command you ran. Press this key twice
to retrieve the next to the last command you ran. Continue pressing this key until you have
retrieved all commands entered.
If no commands were entered, or, you are not authorized to use the iSeries command line
(as defined in your iSeries user profile), no command is retrieved and the panel redisplays.
F10=Update
Updates the record and returns to the calling program from which you invoked this panel.
F11=Delete
Confirms the delete operation and deletes all records associated with this ID. The system
automatically returns to the calling program from which you invoked this panel.
F12=Cancel
Returns to the previous menu or display. When on a single record panel, outstanding
updates (must apply using (Update)) are cancelled.
On a multi-record panel, updates applied by pressing Enter are not lost when F12
(Cancel) is pressed.
F13=Services
Displays a pop-up window with available options for other functions that can be invoked.
The system suspends actions for the current panel and branches to the selected function (if
authorized). Upon completion, the system returns to the Services Window. You can select
another option or cancel (F12) to the calling program from which you invoked the
Services function. Typically, options are available for tasks related to the current panel.
F15=Sort
Displays a pop-up window with available sort criteria. The cursor is positioned next to the
field currently controlling the Sort order for the display. Selecting different sorting options
affects the Position-to field(s) shown at the top of the panel. The default sort order for each
of the “Work With” panels is set in the System Configuration file (SEE the “System
Configuration” chapter in this guide for more information about the System Configuration
file.)
Gentran:Server Panels System Essentials
2 - 12 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
F16=Record-1(Rolling Update)
Displays the previous record in the file for the current panel. Edits are performed and, if
successful, the data is updated prior to displaying the previous record.
If a record is protected, the rolling update is prohibited. If a record is not protected, the
system performs a rolling update. In view mode, rolling is performed, but no data is
updated.
F17=Record+1 (Rolling Update)
Displays the next record in the file for the current panel. Edits are performed and, if
successful, the data is updated prior to displaying the next record.
If a record is protected, the rolling update is prohibited. If a record is not protected, the
system performs a rolling update. In view mode, rolling is performed, but no data is
updated.
F21=Print
Submits the appropriate Print Report job to be executed.
F22=Resequence
Redisplays this multi-record panel forcing any re-sequencing of records to occur.
Typically, a sequence number is used as a key field. As new records are added, you can
refresh the panel with F22 (Resequence) to display all the records in their new order based
on the sequence number used.
F23=More Options
Displays additional option codes available with this panel. You can scroll through all
available option codes by pressing F23 (More Options) repeatedly.
F24=More Keys
Displays additional function keys available with this panel. You can scroll through all
available function keys by pressing F24 (More Keys) repeatedly.
On Command panels, the following keys have different functions:
F9=All Parameters
Shows parameters that are normally displayed only when specific values are entered in
other fields.
F10=Additional Parameters
Provides selections usually related to printing and job options.
System Essentials Gentran:Server Panels
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 2 - 13
Additional Function Keys that are used include:
Enter
Enter can be used for positioning into a display list or advancing to a function when using
an option. Enter is also used to update information on panels. In this case, edits are
performed and, if successful, the data is updated. On single record panels, F10 (Update)
must be pressed to confirm the update, otherwise changes are lost when F12 (Cancel) is
pressed.
Help
Provides additional information about using the panel or a specific field on the panel.
Some keyboards have a specific Help key that can also be used to access the same Help
information as F1 (Help).
Home
When pressed on a Gentran panel, Home moves the cursor to the primary “Position-to”
field at the top of the panel.
Page Down (Roll Up)
Pages down to the next set of items until the bottom of the file is reached. The indicator
“Bottom” is displayed at the end of the file; “More...” is displayed if more items remain.
Page Up (Roll Down)
Pages up to the previous set of items until the top of the file is reached.
Print
Prints information currently displayed. The Print key does not print data from files. Use
the separate options and function keys within Gentran to print data.
Tab Key
The Tab Key moves the cursor from one field to the next on the panel, left to right, top to
bottom. To move the cursor in reverse (bottom to top, right to left), press the Shift and Tab
keys simultaneously.
Use a mouse
If your computer hardware is configured with a mouse, you can position the mouse cursor
on a panel field anywhere on the panel, click the mouse button and begin to enter values in
the field. Additionally, to execute a menu option or function key, you can double click the
mouse button on that menu option or function key. See your System Administrator to
determine if you have the proper hardware and software to use your mouse with the
iSeries.
Gentran:Server Panels System Essentials
2 - 14 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Use the Option Codes
In Gentran:Server, option codes are grouped in categories for consistency as shown below (greater
than 10 have special uses as shown).
1 – 10 standard option codes
11 – 29 vary according to the panel on which they appear
30 – 39 invoke Processing commands
40 – 49 invoke purge and retrieve commands
50 invokes ezEDI commands
Many panels include a list of available option codes you can use for navigation to advance to a
desired panel or function. Available option codes appear in the top portion of the panel. Press F23
(More Options) repeatedly to display additional option codes.
To use the options, type the option code in the Opt (Option) field next to the desired identifiers and
press Enter. You can type option codes next to more than one entry at a time to perform more than
one task, one after the other.
The key entry line must be used when creating a record. It can also be used for other options with
entry of the specific parameters.
1=Create
To create a new record, type 1 in the option field, fill in the required identifier(s) on the
key entry line and press Enter. The system advances you to a subsequent panel in create
mode, where you can add the record by completing the required fields and pressing F10
(Update).
2=Revise
To revise an existing record, type 2 in the option field next to the desired entry and press
Enter. You can also type in the desired identifier(s) on the key entry line with option 2 and
press Enter. The system advances you to a subsequent panel in revise mode where you
can modify the record by updating the desired fields and pressing F10 (Update).
3=Copy
The copy function can be performed at several levels. When selected on a “Work with”
panel, the entire selected definition is copied to a new definition. For example, if the copy
function was selected from the Work with Communications panel (EDIX400-FMT01), the
entire profile is copied to a new profile (including all scripts).
On lower levels within a subsystem, the copy function, in many places, only copies a
single record. For example, if the copy function was selected on the Communication
Session Control panel (EDIX403), only a single record is copied.
When the copy function is invoked, a pop-up window displays to allow entry of the key
fields necessary to create the new record(s). For more information, press F1 (Help) while
in the copy window.
System Essentials Gentran:Server Panels
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 2 - 15
4=Delete
The delete function can be performed at several levels. When using this function on a
“Work with” panel, the entire selected definition is deleted. On lower levels within a
subsystem, the delete function might only delete a single record. For example, if the delete
function was selected on the Communications Session Control panel (EDIX403), only a
single record is deleted.
When accessing a single record panel in delete mode such as the Communication Profile
panel (EDIX401), F11 (Delete) must be pressed to confirm the deletion, On multi-record
panels, option 4 must be entered to indicate the records to be deleted. In this case, no
confirmation is requested.
5=View
The view option is selected as an access mode for single record panels when no
information should be changed. When using F16 (Record-1) and F17 (Record+1), records
will be accessed in a rolling view mode instead of a rolling update mode.
Since you cannot specify a view-only mode on multi-record panels, you must ensure no
changes are made. The data rights for a subsystem can be set to 3 to ensure a user can only
view data throughout that entire subsystem. Alternately, the entire definition can be
protected by setting the Update-Allowed flag to N. (SEE the “Environment Control”
chapter for more information about the Update-Allowed flag.)
6=Print
The print option prompts the appropriate print report command for the user to submit. If
selected beside an ID on a “Work with” panel, the identifier is pre-loaded into the
command.
The print function is also available on many panels by using F21 (Print). This function
automatically submits the appropriate print report to batch for the currently displayed
identifier.
Using the Prompt Key
When you are creating or editing existing entries, Gentran:Server requires you to enter specific
information. These entries may be either a reference to a record that you created elsewhere in the
system, or a value from a list of valid choices.
The F4 (Prompt) key is very helpful in these situations, and may be pressed while on a field. This
function key appears at the bottom of many Gentran:Server panels such as the one in the following
figure.
On “Work with” panels, an option must be entered on the key entry line, with F4 (Prompt) pressed
on any field on the key entry line; if available, a list of valid values will be shown. If F4 (Prompt)
is pressed without an option specified or pressed outside the key entry line, the system displays the
Major Command Groups (MAJOR) menu.
The following two examples illustrate using the F4 (Prompt) feature from a file maintenance panel
and a “Work with” panel.
Gentran:Server Panels System Essentials
2 - 16 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Select a Value from a File Maintenance Panel
In Figure 2.4, the cursor is placed on the Protocol field. The system requires you to specify a
Protocol. If you know the Protocol, you can type it in and press Tab to move the cursor to the next
field. However, you could also move the cursor to the field and then press F4 (Prompt). You would
then see a pop-up window with a list of Protocols. At this point you could select an entry by typing
1 in the option field next to the Protocol and then pressing Enter.
Figure 2.4 Use the F4 (Prompt) Function Key from a File Maintenance panel
# NOTE
If an option is entered and the cursor is on a field for which there is no prompt information
available when F4 (Prompt) is pressed, the system displays the message Prompt function
not defined for (fieldname).
EDIX401 Communication Profile EDI 04/30/08
FMT01 12:00:00
Comm Profile ID. . . . . . . . . .
Company. . . . . . . . . . . . . . COMMERCE: Network RELEASE3
Contact. . . . . . . . . . . . . . NETWORK COMMUNICATIONS
Phone. . . . . . . . . . . . . . . (614 ) 793 - 7000 x
International Dial Code. . . . . .
Protocol . . . . . . . . . . . . . BSC
D
F Position to Code
U 1=Select
Protocol Description
ASC Asynchronous Communication
ASX Asynchronous Communication with XMODEM
BSC Binary Synchronous Communication
FTP TCP/IP FTP Client
More...
F3=Exit F12=Cancel
F
Put cursor here and press F4 (Prompt)
System Essentials Gentran:Server Panels
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 2 - 17
Use F4 on a “Work with” Panel
On “Work with” panels, an option must be entered on the key entry line before pressing F4
(Prompt) to see a list of valid values. Figure 2.5 illustrates using the Work with Communications
Session panel (EDIX402) to create a session script record of a comm profile ID. The option 1
(Create) has been entered on the key entry line. Pressing F4 while the cursor is on the comm
Profile ID field will bring up a window containing a list of available comm Profiles.
Figure 2.5 Use the F4 (Prompt) Function Key on a “Work with” panel
# NOTE
If an option is entered and the cursor is on a field for which there is no prompt information
available when F4 (Prompt) is pressed, the system displays the message “Prompt function
not defined for (fieldname)”.
EDIX402 Work with Communications Session EDI 04/30/08
FMT01 pgmlib: G3X5PGM dtalib: G3X5DTA 12:00:00
Position to Profile ID . . . . . .
Type option (and Information), press Enter.
1=Create 2=Revise 3=Copy 4=Delete 5=View 6=Print 30=Start Session
Opt Profile SN Company
1
Position to Profile ID . . . . . .
1=Select
Profile ID Company
ADVBSC ADVANTIS BSC
ADVLU0 ADVANTIS SDLC
ATLASFTX Atlas in France via OFTP/X.25
ATTEASY AT&T EASYLINK SERVICES
More...
F1=Help F3=Exit F12=Cancel F15=Sort
Par
===
F1=
Place the cursor on the key entry line and press F4 (Prompt)
Gentran:Server Panels System Essentials
2 - 18 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Shortcuts
Gentran:Server provides many features to make your work quicker and easier. The following
shortcuts can be used by novice as well as experienced Gentran:Server users.
Access Panels Directly from the Command Line
Sometimes you may prefer not to access panels through the “Work with” subsystems and the
various functions below them. Gentran has a special feature that allows you to directly access most
Gentran functions from the command line. EXCPGM is a specialized “call” command that is
supplied with Gentran to give you direct access to most functions.
To directly access a Gentran function, type the following command on the command line and press
Enter:
EXCPGM EDIXnnn Where nnn is the panel number.
This feature could be useful in many situations. Perhaps a co-worker asks you for information
about EDI information in Gentran that is totally unrelated to the work that you are currently doing.
If you know the program name of the function that contains this information, you can use the
EXCPGM command to quickly display that function and then return to your work.
System Essentials Gentran:Server Panels
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 2 - 19
For example, in Figure 2.6, the Work with Outbound Queue panel (EDIX404) is accessed from the
command line.
Figure 2.6 Use the EXCPGM feature to access a function directly from the command line
GENMAIN Gentran:Server for iSeries Communications 3.5
System: ISDDEV01
Select one of the following:
1. Communications Menu (GENCOM)
2. Work with Job Scheduler
3. Work with Environment Control
4. System Configuration Menu (GENSYSCFG)
10. Gentran:Server Search Index
13. Gentran File Tracking Menu (GENFILETRK)
90. Sign off
Bottom
Selection or command
===> EXCPGM EDIX404
F3=Exit F4=Prompt F9=Retrieve F12=Cancel F13=User Support
(C) COPYRIGHT
EDIX404 Work with Outbound Queue Control EDI 04/30/08
FMT01 pgmlib: G3X5PGM dtalib: G3X5DTA 12:00:00
Position to Profile ID . . . . . . Profile Seq 9999999
Type option (and Information), press Enter.
2=Revise 4=Delete 5=View 6=Print 30=Extract Data 31=Find String
Profile Comm Batch Batch
Opt Profile Sts Seq # Date Time Records Stamp Seq # ID
CN3BSC Q 187 12/13/01 11:40:20 3 241
CN3BSC Q 186 12/13/01 11:40:20 4 240
CN3BSC Q 185 12/11/01 14:28:01 4 239
CN3BSC Q 184 12/11/01 14:28:01 4 238
CN3BSC Q 183 12/11/01 14:28:01 4 237
CN3BSC Q 182 05/25/00 14:22:42 4 236
CN3BSC Q 181 05/25/00 14:20:18 4 234
CN3BSC Q 180 05/25/00 11:06:01 4 233
CN3BSC Q 179 05/25/00 11:03:18 4 231
More...
Parameters or command
===>
F1=Help F3=Exit F12=Cancel F15=Sort F24=More Keys
Gentran:Server Panels System Essentials
2 - 20 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Access a Panel from a Service
There may be times when you want to access another related function without leaving the current
panel. For example, you might be entering information on a certain panel and realize that you need
some information from another function. Maybe you forgot an entry on another panel or you need
to change an entry that relates to the information you are entering on the current panel. You want to
enter the new information, but you don’t want to use the F12 (Cancel) key to leave your work on
the current panel.
Gentran has another special “shortcut” feature to handle this situation. On some Gentran panels,
you may notice the F13 (Services) function key. Pressing this key displays a pop-up window with
a list of menu options related to your current task.
Figure 2.7 Shortcuts for Accessing Panels using Services
If, for example, you are entering values on the Communication Profile panel (EDIX401), pressing
the F13 (Services) function key displays a pop-up window as shown in Figure 2.7. In this example,
option 1 advances you to the Work with Communications Session panel to work with any scripts
defined for the profile.
At this point, you can select any one of the menu options, and Gentran:Server displays a new
panel. Enter all the field values as you would normally do. When you are finished with the panel,
press the appropriate key to exit. Gentran returns to the Service Menu again. At this point, you can
select another menu option or press F12 (Cancel) or F3 (Exit) to return to the exact point at which
you left the original panel.
EDIX401 Communication Profile EDI 04/30/08
FMT01 12:00:00
Comm Profile ID. . . . . . . . . . CN3BSC
Compan Service Menu EASE3
Contac NS
Phone. x
Intern 1. Work with Communications Session
Protoc 2. Work with Communication Inbound Que
Days t 3. Work with Communication Outbound Qu
FIFO/L
Update
Service: 1
F3=Exit F12=Cancel
F1=Help F10=Update F12=Cancel F13=Services F24=More Keys
Select a Service
System Essentials Gentran:Server Panels
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 2 - 21
Use the Command Line
Any iSeries, Gentran-specific, or user-specific command may be executed from the command line
(Gentran supports iSeries security authorization). To use the command line, type the command,
then press F4 to prompt or Enter to execute. The following figure shows the STRCOMSSN
command entered on the GENMAIN command line. Entering the command displays the Start
Communications Session (STRCOMSSN) panel, where parameters can be entered and the job
submitted.
# NOTE
Command line usage is determined by your iSeries user profile. SEE your System
Administrator for more information.
Gentran:Server Panels System Essentials
2 - 22 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Figure 2.8 illustrates prompting the Start Communications Session (STRCOMSSN) command
from the command line using F4.
Figure 2.8 Using the STRCOMSSN command from the command line
# NOTE
When you execute a Gentran-specific command from the command line, information is
retrieved from your Gentran:Server environment profile to control the runtime environment.
(SEE the “Environment Control” chapter for more information.)
Start Communications Session (STRCOMSSN)
Type choices, press Enter.
Communications Profile ID . . . CN3BSC Comm Profile Id
Session Type . . . . . . . . . . Name
Delete Previous Jobs? . . . . . *YES *YES, *NO
Schedule Job? . . . . . . . . . *NO *YES, *NO
Run Continually? . . . . . . . . *NO *YES, *NO
Bottom
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters F12=Cancel
F13=How to use this display F24=More keys
GENMAIN Gentran:Server for iSeries Communications 3.5
System: ISDDEV01
Select one of the following:
1. Communications Menu (GENCOM)
2. Work with Job Scheduler
3. Work with Environment Control
4. System Configuration Menu (GENSYSCFG)
10. Gentran:Server Search Index
13. Gentran File Tracking Menu (GENFILETRK)
90. Sign off
Bottom
Selection or command
===> STRCOMSSN
F3=Exit F4=Prompt F9=Retrieve F12=Cancel F13=User Support
Start Communications Session Command
Start Communications Session (STRCOMSSN)
Type choices, press Enter.
Communications Profile ID . . . CN3BSC__ Co m m P ro f il e I d
Session Type . . . . . . . . . . ____ Name
Delete Previous Jobs? . . . . . *YES__ *Y ES, *NO
Schedule Job? . . . . . . . . . *NO *YES, *NO
Run Continually? . . . . . . . . *NO *YES, *NO
Bottom
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters F12=Cancel
F13=How to use this display F24=More keys
System Essentials Getting Help
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 2 - 23
Getting Help
Additional help for using Gentran:Server for iSeries Communications Module, beyond what you
will find in the documentation set, is available in a variety of ways.
Use Online Help
One of the most exciting features in Gentran:Server for iSeries Communications Module Release
3.5 is the online help. Gentran:Server uses the iSeries User Interface Manager (UIM)© Search
Index/Help feature. Through online help, you can access information such as field definitions and
panel descriptions while you are working, without interrupting any data entry activities.
Gentran:Server for iSeries Communications Modules online help is “context-sensitive”. This
means that the information displayed is based on the current panel and the position of the cursor on
the panel. This allows you to access either specific information about a field or general
information about the whole panel.
Online help is accessed by first positioning the cursor in one of the context-sensitive areas of the
panel, as shown in the following figure. Press the F1 (Help) key (or the HELP key, depending on
your keyboard) and a pop-up help window appears on top of the current panel so that the given
field is still visible.
Getting Help System Essentials
2 - 24 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Figure 2.9 shows the areas on a panel for which Gentran:Server for iSeries Communications
Module provides context-sensitive help.
Figure 2.9 The context-sensitive online help areas of a typical panel
Pressing the F1 (Help) key with the cursor in the System message area activates the iSeries help
utility for system messages. All messages issued for the online panels have first level help. Many
errors also have second level help that further explains that specific error, identifies its cause, or
suggests a course of action to remedy the error. To display second level help, place the cursor on
any message and press F1 (Help).
Sometimes more than one message is issued. A plus sign (+) displays at the right side of the
message line whenever additional messages exist. Move the cursor to the message line and press
Page Down (Roll Up) or Page Up (Roll Down) to scroll through all error messages issued.
Messages are shown from the language-specific error message file, GENERRxxx, where xxx
represents the language ID (i.e., GENERRENU is the English error message file).
EDIX400 Work with Communications EDI 04/30/08
FMT01 pgmlib: G3X5PGM dtalib: G3X5DTA 12:00:00
Position to Profile ID . . . . . .
Type option (and Information), press Enter.
1=Create 2=Revise 3=Copy 4=Delete 5=View 11=Line/Ctl/Dev
Opt Profile ID Company
ADVBSC ADVANTIS BSC
ADVLU0 ADVANTIS SDLC
ATLASFTX Atlas in France via OFTP/X.25
ATTEASY AT&T EASYLINK SERVICES
ATTUK AT&T IN THE UNITED KINGDOM
AUTOANS TEST AUTOANSWER CONFIG
BTASCL BT UK GNS EDI*NET Async "Live" Sys
BTASCT BT UK GNS EDI*NET Async "Test" Sys
BTOFTP BT UK GNS EDI*NET OFTP via Async
More...
Parameters or command
===>
F1=Help F3=Exit F12=Cancel F15=Sort F23=More Options F24=More Keys
Comm Profile ID cannot be blank.
Help for the Entire Panel
Help for Options
Help for Field
Definitions
Help for System
Messages
System Essentials Getting Help
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 2 - 25
Online Help for a Single Field Definition
Online help is also available for individual field definitions. Position the cursor anywhere on a
field and press F1 (Help), as shown in Figure 2.10. For field information specific to the current
panel, refer to the online help for the whole panel and to the paper documentation.
# NOTE
In most cases, the generic field definitions are not included in the paper documentation. As
you read the manuals, you may find it convenient to have an active Gentran session in front
of you so that you can access the field definitions and other online information.
Figure 2.10 Access online help for a field definition
EDIX400 Work with Communications EDI 04/30/08
FMT01 pgmlib: G3X5PGM dtalib: G3X5DTA 12:00:00
Position to Profile ID . . . . . .
Type option (and Information), press Enter.
1=Create 2=Revise 3=Copy 4=Delete 5=View 11=Line/Ctl/Dev
Opt Profile ID Company
ADVBSC
ADVLU0 Profile ID - Help
ATLASFTX
ATTEASY The Communication Profile ID is a unique identifier for a
ATTUK collection of information required to communicate with a
AUTOANS remote computer system or network.
BTASCL Bottom
BTASCT F2=Extended help F10=Move to top F11=Search Index
BTOFTP F12=Cancel F13=Information Assistant F24=More keys
Parameters or
===>
F1=Help F3=Exit F12=Cancel F15=Sort F23=More Options F24=More Keys
Comm Profile ID cannot be blank.
Press F1 (Help)
Getting Help System Essentials
2 - 26 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Online Help for a Whole Panel
To display online help for the entire panel, move the cursor anywhere outside a field and press F1
(Help), as shown in Figure 2.11. Another method of accessing help for the whole panel is to press
F2 (Extended Help) while you are in help mode for a field.
Figure 2.11 Access online help for a whole panel
While there is some variation in content for individual panel descriptions, in general, the help for
the entire panel typically includes an Overview that describes the purpose of the panel; activities
that can be performed from the panel; related topics; field definitions; and function key definitions.
EDIX400 Work with Communications EDI 04/30/08
..............................................................................
: Work with Communications (EDIX400) - Help :
: :
: Work with Communications (EDIX400-FMT01) :
: :
: The Work with Communications panel (EDIX400-FMT01) allows you to :
: initiate set up and maintenance functions for communication profiles :
: and provides access to other functional areas associated with :
: communications such as communication sessions, inbound and outbound :
: queue maintenance and inquiry, etc. A communication profile is a :
: set of communication parameters associated with a given company or :
: application in Gentran:Server for iSeries. The profile contains :
: information specific to the communication such as phone numbers, :
: protocol, and contact names. :
: :
: Panel Activities :
: :
: The ability to select the mode for accessing a panel for creating, :
: More... :
: F3=Exit help F10=Move to top F11=Search Index F12=Cancel :
: F13=Information Assistant F14=Print help :
: :
:............................................................................:
System Essentials Getting Help
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 2 - 27
Use Hypertext
On some online help panels, certain words or phrases are underlined and/or highlighted in
high-intensity. This indicates that additional information (hypertext) is available for the
highlighted text. To display the additional information, either move the mouse or press Tab until
the cursor is positioned in the highlighted text. Press Enter.
# NOTE
All of the definitions available through hypertext are also available through the Search Index.
(SEE “Using the Search Index” section.)
Figure 2.12 shows words that have hypertext definitions available through Gentran online help.
Figure 2.12 Access hypertext definitions by moving the cursor onto the word
and pressing Enter
EDIX400 Work with Communications EDI 04/30/08
..............................................................................
: Work with Communications (EDIX400) - Help :
: :
: revising, deleting, or viewing information can be performed from :
: this panel. For example, to create a record, use option '1' on the :
: key entry line with an ID to be added. This will advance you :
: forward into the panel in create mode, where you can actually add :
: the ID. :
: :
: Note: You can only "create", or create by "copy", Communication :
: Profile ID's that are not currently on file. All other options can :
: only be performed if a Communication Profile ID record exists. :
: :
: Related Topics :
: :
: => Additional Message Information :
: :
: ***** Field and Function Key Definitions ***** :
: More... :
: F3=Exit help F10=Move to top F11=Search Index F12=Cancel :
: F13=Information Assistant F14=Print help :
: :
:............................................................................:
Hypertext
Getting Help System Essentials
2 - 28 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Use the Search Index
The Search Index is another way to obtain online help. Here are two ways that you can access the
Search Index from Gentran:Server:
From any online help panel: press F11
From the Gentran:Server main menu (GENMAIN): select menu option 10 (Search Index)
# NOTE
The Gentran:Server Search Index is called “GENSCHIDX” and is found in the
Gentran:Server data library (G35DTA).
How to Select Topics in the Search Index
The Search Index contains an alphabetic list of all topics that are linked to hypertext throughout
the Gentran documentation. It also contains other topical entries that are found only here. You can
view topics in one of two ways:
Using either the mouse or the Tab key, position the cursor in the option field next to the
selection you would like to view or print. Type in 5 to view the topic; type 6 to print the topic.
Multiple entries may be selected at one time.
Type a key word or a portion of a key word or phrase on the command line and press the Enter
key. The system searches an internal table of key words and synonyms and displays a list of
topics that best match the words you entered. Type in 5 to view the topic; type 6 to print the
topic.
Hints for Entering Search Words
The following tips can help you take full advantage of the Search Index.
You can use either upper or lowercase letters – the search is not case sensitive.
Make the topic you enter as complete and specific as possible. For example, if you enter only
the word “job”, the system will display a long list of topics about jobs. For a shorter list of
more specific topics, you could enter “changing the position of a job queue”.
(SEE the iSeries documentation for more information.)
System Essentials Print Reports in Gentran:Server
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 2 - 29
Print Reports in Gentran:Server
Reports are integrated throughout the Gentran:Server system. Report options are found throughout
the subsystems on panels wherever appropriate. Reports can also be run from the command line
using one of the command prompts (see information earlier in this chapter).
There are two general types of reports in Gentran:Server; User-generated reports and
System-generated reports, which are illustrated in the following figures.
User-generated reports
User-generated reports are optional reports that are initiated by a user request. This usually occurs
when you select option 6 (Print) or you press the F21 (Print) function key. Many of these reports
can also be generated from the command line.
System-generated reports
System-generated reports occur automatically, regardless of requests by the user. These types of
reports generally occur when activities such as purges and processing occur. At these times the
system automatically creates a report documenting the task just performed.
System-generated reports are generated automatically as a result of executing a job. Figure 2.13
shows an example of this situation. When the Purge All Communication Files (PRGALL)
command is executed, the system generates the Purge Communication reports (one for each group
of files purged).
Figure 2.13 Purge Comm reports are generated automatically
Purge All Comm Files (PRGALL)
Type choices, press Enter.
Selection Criteria for Purge . . *DATE, *DAYS, *ALL
Comm Profile Id . . . . . . . . *ALL *ALL, Comm Profile Id
+ for more values
Status . . . . . . . . . . . . . *ALL *ALL, RN, RA, PI, SN, SA, QE,H
+ for more values
Schedule Job ? . . . . . . . . . *NO *YES, *NO
Purge Method? . . . . . . . . . *TAPE, SAVF, *NONE, *CL
Bottom
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters F12=Cancel
F13=How to use this display F24=More keys
Print Reports in Gentran:Server System Essentials
2 - 30 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
User-generated reports generally have a panel for entering report parameters similar to the one
shown in Figure 2.14 for the Comm Profile script. This can be particularly useful for tailoring the
report to exactly the kind of information that you need.
Each report has a unique identifier. The program name of the program that generated the report is
always displayed in the top left corner of the report.
Figure 2.14 Enter parameters for the Comm Script report
By default, all reports go to the iSeries Output Queue defined for your user ID. (SEE the
“Environment Control” chapter for more information on defining Output Queues in a users
Environment Profile.) If you like, you can also customize the print job.
Print Comm Control Script (PRTCOM)
Type choices, press Enter.
Comm Profile Id to Print . . . . CN3BSC Comm Profile Id
Session Type to Print . . . . . RA Session Type
Bottom
F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display
F24=More keys
System Essentials Product Support and Remote Maintenance
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 2 - 31
Product Support and Remote Maintenance
Sterling Commerce Software Support (SSS)
General Information
Sterling Commerce Software Support (SSS) configures a temporary, dial-up connection between
Sterling Commerce’s Customer Service iSeries system and your system. This connection allows
Sterling Commerce to directly assist you with the resolution of software problems.
The SSS connection uses display station pass-through and SNADS. This enables the support
personnel to sign on to your system and diagnose the problem. If necessary, they can retrieve
diagnostic data for further analysis or send you a program fix.
This allows Sterling Commerce to be responsive to critical situations that demand the ultimate in
customer support.
The following commands are used to configure and control SSS:
SSSCONFIG – Create objects and configuration entries needed for SSS
SSSREMOVE – Delete SSS objects and configuration entries
SSSON – Enable access to your system via SSS
SSSOFF – Disable access to your system via SSS
SSS requires a number of objects and SNADS configuration entries. These are created when you
issue the SSSCONFIG command. They will all be given names starting with SSSx, where x is the
“User qualifier character” specified on the SSSCONFIG command. The user qualifier character
you use will be determined by the support person with whom you are working.
System Requirements
These are the requirements for using SSS:
1. A user profile will be created by SSSCONFIG. The profile will be named SSSxUSER,
where x is the user qualifier character. The SSSxUSER profile will be used by Sterling
Commerce customer support to access your system.
2. A user profile with at least SECADM authority must be used to run SSSCONFIG. This is
necessary to create the SSSxUSER profile and make the necessary SNADS distribution
directory entries. Likewise, SECADM is required for SSSREMOVE.
Product Support and Remote Maintenance System Essentials
2 - 32 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
3. Your system must have the subsystems QSNADS and QCMN active, and must have a
communications entry for device *ALL and mode *ANY in the QCMN subsystem. You
can see which subsystems are active by using the WRKSBS command. Both subsystems
must appear on the Work with Subsystems display. Assuming QCMN appears, you can
check for the communications entry by doing an option 5 (Display subsystem description)
and then 8 (Communications entries). SSSCONFIG will not set up the subsystems or
communications entry.
4. Your system must have a communications line and synchronous modem available. Your
best bet is to use the line and modem that are used for IBM ECS (Electronic Customer
Support). You will need to know the resource name (LINxxx) that the modem is attached
to. Tell the support person working with you the phone number to dial to connect to that
modem.
Sterling Commerce Software Support
Perform the following steps to configure and use Sterling Software Support:
1. Verify the availability of the system requirements listed previously. Tell the customer
support person the phone number to dial to connect to your modem.
2. Use the SSSCONFIG command to configure your system to answer. Specify the user
qualifier character given to you by customer support.
3. If the customer support person will need to access your Gentran:Server system, use the
“Work with Environment Control” option from the GENMAIN menu to add the user id
SSSxUSER that corresponds to the user profile created by SSSCONFIG.
# NOTE
Replace the x in SSSxUSER with the user qualifier character from step 2.
4. Wait for the connection to be initiated by customer support.
5. When customer support has finished using the connection, use the SSSOFF command to
make the SSS connection unavailable, and make your line and modem available for other
uses.
6. If customer support needs to access your machine again, use the SSSON command to
make the SSS connection available.
7. When the problem has been resolved to the point that customer support will no longer
need to access your system, delete the SSS configuration by using the SSSREMOVE
command. Specify the same user qualifier character that was used for SSSCONFIG.
System Essentials Product Support and Remote Maintenance
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 2 - 33
Command Descriptions
SSSCONFIG
The SSSCONFIG command is used to configure your system to run Sterling Software Support.
This includes creating line, controller, and device descriptions, creating the SSSxUSER profile,
and adding the entries needed for SNADS. To make them easy to identify, all of the objects created
will have names starting with SSSx, where x is the user qualifier character.
When prompted using F4, the SSSCONFIG command appears as (Figure 2.15):
Figure 2.15 SSCONFIG Command
# NOTE
The SSSCONFIG command requires at least SECADM authority to run. Since not everyone
has SECADM authority, you may need to get the system administrator to run the
SSSCONFIG command.
Once configured, the system can be enabled and disabled without any special authority, so the
system administrator will not be needed again until you want to delete the SSS configuration.
Field Definitions
User Qualifier Character
This parameter specifies the character that will be used to qualify all names of objects used
for the SSS connection. For example, if the user qualifier is A, the profile SSSAUSER will
be created, and the session will use line SSSALN, controller SSSACT, and device
SSSADV. The support person you are working with will tell you the user qualifier
character to use.
Config Sterling Commerce Supt. (SSSCONFIG)
Type choices, press Enter.
User qualifier character . . . . A-Z
Comm Line Resource Name . . . . CMN01 Name
Configure this system to . . . . *ANS *ANS, *DIAL
Bottom
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters F12=Cancel
F13=How to use this display F24=More keys
Product Support and Remote Maintenance System Essentials
2 - 34 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Comm Line Resource Name
This parameter specifies the iSeries line name that is attached to the modem and phone
line that you want to use. The field will initially be displayed with the default: CMN01.
Configure this System to
This parameter determines whether your system will be configured to dial or answer the
call. The Sterling Commerce system will initiate the connection to your system, so you
should always accept the default of *ANS.
Model Profile for SSSxUSER
The Model profile parameter specifies the user profile that will be copied to create
SSSxUSER. The SSSxUSER profile does not have to have any special authority and can
be modeled after any profile on your system.
) RECOMMENDATION
Ideally, the SSSxUSER profile should be modeled after the profile used by the
person working with customer support. That way, when customer support signs on
as SSSxUSER, they will have the same library list, job description, authorities, and
see the same displays and menus as the person with whom they are working.
SSSxUSER Profile Password
You may optionally specify the password that will be assigned to the SSSxUSER profile.
If you do not specify one, it will default to *USRPRF, which will make the password the
same as the user profile name. Obviously, the password you choose is a security
consideration.
As the SSSCONFIG command configures your system, progress messages will be displayed. The
command should complete in a minute or two. If it completes successfully, your system will be
waiting to answer a call from Sterling Commerce’s customer service system.
System Essentials Product Support and Remote Maintenance
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 2 - 35
SSSREMOVE
The SSSREMOVE command allows you to “clean up” your system after Sterling Commerce
customer support has finished using SSS. It will delete all the objects and SNADS entries that SSS
created. It will not delete the SSS programs and commands, so SSS can be reconfigured any time
you need it.
# NOTE
This command must be run from a user profile with at least SECADM authority.
You must not be signed on as SSSxUSER when you issue the SSSREMOVE command, because it
needs to delete the user profile.
The SSSREMOVE command requires one parameter, which is the user qualifier character. Specify
the same user qualifier character that was used on the SSSCONFIG command.
SSSON
The SSSON command varies on the line (SSSxLN), controller (SSSxCT), and device (SSSxDV)
used by SSS and verifies that they achieve the proper state for connection. If they do not, a
warning message will be issued.
When the line, controller, and device are varied on, the communications line and modem are
available for SSS, and are not available for other uses.
The line, controller, and device must be varied on before the modem will answer calls and allow a
connection to be established.
The SSSON command accepts one optional parameter: the user qualifier character. You should not
need to specify this parameter.
SSSOFF
The SSSOFF command varies off the line, controller, and device and verifies that they all achieve
varied off status.
You should use the SSSOFF command after Sterling Commerce has finished using your machine.
This stops your system from answering calls, and makes the SSS connection temporarily
unavailable. If Sterling Commerce needs to access your system again, you can use the SSSON
command to make the connection available.
Varying off the configuration makes the communications line and modem available for other uses,
such as ECS. Therefore, you should always keep the configuration varied off when the SSS
connection is not needed.
The SSSOFF command accepts one optional parameter: the user qualifier character. You should
not need to specify this parameter.
Product Support and Remote Maintenance System Essentials
2 - 36 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Command Examples
Example 1: SSSCONFIG QUALIFIER(A)
This command will configure SSS to answer calls on the default, CMN01, and will create
a user profile called SSSAUSER with password SSSAUSER. The SSSAUSER profile
will be a copy of the profile that issues the SSSCONFIG command.
After completing the SSSCONFIG command, the SSS system will be varied on and
waiting to answer a call.
# NOTE
The user profile issuing the SSSCONFIG command must have at least SECADM
authority. Therefore, the SSSAUSER profile in this example would be created with
equivalent authority because the MODEL parameter was allowed to default to
*CURRENT.
Example 2: SSSCONFIG QUALIFIER(B) LINE(LIN031) MODEL(JOE)
This command will configure SSS to answer calls on LIN031. It will create an
SSSBUSER profile that is a copy of the user profile JOE, with password SSSBUSER.
After completing this command, the SSS system will be varied on and waiting to answer a
call.
Example 3: SSSREMOVE QUALIFIER(A)
This command will delete all SSSA objects and SSSA SNADS configuration entries from
your system.
Chapter
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 3 - 1
3 Environment Control
In this Chapter
¾What is Environment Control? ........................................................................................ 3-1
¾What Does the Environment Control Subsystem Do?..................................................... 3-2
¾Panel Quick Reference..................................................................................................... 3-2
¾Environment Control Panels ............................................................................................ 3-3
¾Define the Environment Profile ....................................................................................... 3-7
¾Define the Security Profile............................................................................................... 3-8
¾Reports ........................................................................................................................... 3-14
¾Common Questions........................................................................................................ 3-17
What is Environment Control?
Environment Control is an administration tool for creating and managing Gentran:Server user
profiles for each user on the system. In this chapter, the term “user profile” refers to the
combination of these two files:
1. Environment profile – parameters (such as the User ID, Name, Division, Output Queue,
Language ID, Date Format, etc.) that affect the environment in which the user runs jobs
2. Security profile – authority codes that define which Gentran:Server subsystems and
functions the user can access and whether the user has privilege to view data only or to
update data
What Does the Environment Control Subsystem Do? Environment Control
3 - 2 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
What Does the Environment Control
Subsystem Do?
The Environment Control subsystem provides these capabilities:
Add new users by creating a new user profile or copying an existing one.
View, modify, or delete existing user profiles.
Define environment options that control how the users jobs run.
Identify which subsystems and functions each user can access.
Define each users update privileges for the subsystems and/or functions to which they have
access.
Panel Quick Reference
The following table gives the purpose and access methods for the primary Environment Control
panels.
Panel Name Purpose Access Methods
EDIX200-FMT01
Work with
Environment Control
Create, revise, copy, delete, or
view a user profile.
Select option 3 on the GENMAIN
Menu.
Enter EXCPGM EDIX200 on the
command line.
EDIX201-FMT01
Environ. Control
Define the user’s environment
profile.
Select an option and User ID on
panel EDIX200-FMT01.
Enter EXCPGM EDIX201 on the
command line.
EDIX201-CTL02
Environ. Control
Define the user’s security
profile.
Press Enter or F8 on panel
EDIX201-FMT01.
Press F10 in create mode on panel
EDIX201-FMT01.
PRTENV
Print Environment
Control
Print an environmental control
profile
Select option 6 (Print) on panel
EDIX200-FMT01.
Press F21 (Prt Env) on panel
EDIX201-FMT01 or
EDIX201-CTL02.
Enter PRTENV on the command
line.
Environment Control Environment Control Panels
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 3 - 3
Environment Control Panels
Access the Subsystem
To access the Environment Control subsystem, select option 3 (Work with Environment Control)
on the GENMAIN menu, as shown in Figure 3.1.
Figure 3.1 Access the Environment Control subsystem from GENMAIN
Manage User Profiles
After you select the Environment Control subsystem on the GENMAIN menu, the next panel that
appears is the Work with Environment Control panel (EDIX200-FMT01). This panel lists all User
IDs currently defined on the Gentran:Server system.
# NOTE
All Gentran:Server User IDs must be valid User IDs on the iSeries system. See your Security
Officer (QSECOFR) for the iSeries User IDs for your site.
GENMAIN Gentran:Server for iSeries Communications 3.5
System: ISDDEV01
Select one of the following:
1. Communications Menu (GENCOM)
2. Work with Job Scheduler
3. Work with Environment Control
4. System Configuration Menu (GENSYSCFG)
10. Gentran:Server Search Index
13. Gentran File Tracking Menu (GENFILETRK)
90. Sign off
Bottom
Selection or command
===> 3
F3=Exit F4=Prompt F9=Retrieve F12=Cancel F13=User Support
Environment Control Panels Environment Control
3 - 4 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Figure 3.2 shows panel EDIX200-FMT01 and three ways to use it.
Figure 3.2 Work with Environment Control panel (EDIX200-FMT01)
Select an Option
The Work with Environment Control panel (EDIX200-FMT01) has five options:
1 = Create a new user profile
2 = Revise an existing user profile
3 = Copy an existing user profile to create a new user profile
4 = Delete an existing user profile
5 = View an existing user profile
To create a user profile, you must specify a valid iSeries user profile that is not yet defined in
Gentran:Server. All other options (revise, copy, delete, and view) can be performed only after a
User ID has been created in Gentran:Server.
EDIX200 Work with Environment Control EDI 04/30/08
FMT01 pgmlib: G3X5PGM dtalib: G3X5DTA 12:00:00
Position to User ID. . . . . . . .
Type option (and Information), press Enter.
1=Create 2=Revise 3=Copy 4=Delete 5=View 6=Print
Opt User ID Name Init Div
EDI
BXK Kay, Brendan X. BXK 000
CBCOMM carol, b CB 000
CF Fry, Cheryl CF 000
CSG Grear, Christy S. CSG 000
CSGCHK GREAR, CH S. CSG 000
CSGLIMIT TESTING, TEST S. CSG 000
CSGSEC GREAR, CHRISTY S. CSG 000
DCS SMITH, DON C. DCS 000
More...
Parameters or command
===>
F1=Help F3=Exit F12=Cancel F15=Sort F24=More Keys
Position to field
Key Entry Line
Option field
Environment Control Environment Control Panels
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 3 - 5
Specify a User ID
There are three ways to specify a User ID on panel EDIX200-FMT01:
Use the option field
Move the cursor next to the User ID you want to select, type the appropriate option (2, 3, 4, or 5)
in the option field and press Enter.
Use the key entry line
Type the appropriate option (1, 2, 3, 4, or 5) and the User ID on the key entry line and press Enter.
When creating a new User ID from scratch, the key entry line must be used.
Use the Position to field
Type a complete or partial User ID in the Position to User ID field and press Enter. The system
displays the closest match at the top of the list of users. To select a User ID, you still have to use
one of the methods above.
Create a User Profile
Use this option if you are creating a new User Profile. If you are adding a user who will have the
same security profile as a current user on the system, it might be easier to use option 3 (Copy).
1. Type 1 and the new User ID on the key entry line and press Enter. (The value you enter
for User ID must be a valid iSeries User ID.)
2. The system displays the Environment Control panel (EDIX201-FMT01), which defines
the user’s environment profile. (This panel is shown later in the chapter.) Notice that the
field entries are the environment parameters from the user’s iSeries user profile. Change
the appropriate fields and press Enter, F8 (Next), or F10 (Update).
When you create a new Gentran:Server User ID through the copy option, the system
copies the specified environment profile as it currently exists. The copy option does not
retrieve the parameters from the users iSeries user profile.
3. The system advances to the Environment Control panel (EDIX201-CTL02), which
defines the user’s Security Profile. (This panel is also described later in the chapter.)
Change the appropriate authority codes and press F10 (Update).
4. The system adds the new Gentran:Server User ID and returns to the Work with
Environment Control panel (EDIX200-FMT01).
Environment Control Panels Environment Control
3 - 6 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Revise a User Profile
1. Type 2 in the option field next to the appropriate User ID and press Enter.
—OR—
Type 2 and the User ID on the key entry line and press Enter.
2. The system displays the Environment Control panel (EDIX201-FMT01), which defines
the Environment Profile. (This panel is shown later in the chapter.) Type the new
information in the appropriate fields and press Enter or F8 (Next).
3. The system displays the Environment Control panel (EDIX201-CTL02), which defines
the user’s Security Profile. (This panel is also described later in the chapter.) Change the
appropriate authority codes and press F10 (Update).
Copy an Existing User Profile
1. Type 3 in the option field next to the appropriate User ID and press Enter.
—OR—
Type 3 and the existing User ID on the key entry line and press Enter.
2. A pop-up window appears with a single field “Copy To”. Enter the User ID for the new
User Profile in this field. (Remember that you must enter a valid iSeries User ID.) The
system displays panel EDIX201-FMT01.
3. If you need to make changes to the new User Profile, follow Steps 2, 3, and 4 under
“Creating a User Profile”.
Delete a User Profile
1. Type 4 in the option field next to the appropriate User ID and press Enter.
—OR —
Type 4 and the User ID on the key entry line and press Enter.
2. Confirm that you want to delete the record by pressing F11 (Delete). To cancel the Delete
function, press F12 (Cancel).
View an Existing User Profile
1. Type 5 in the option field next to the appropriate User ID and press Enter.
—OR—
Type 5 and the User ID on the key entry line and press Enter.
Environment Control Environment Control Panels
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 3 - 7
2. The system displays the Environment Control panel (EDIX201-FMT01), which defines
the environment profile and is described later in the section.
3. To view the security profile, press Enter or F8 (Next) and the system displays the
Environment Control panel (EDIX201-CTL02), which is described later in the section.
Define the Environment Profile
The Environment Control panel (EDIX201-FMT01), as shown in Figure 3.3, defines a user’s
environment profile. The fields on this panel determine the controlling environment under which
processing runs.
Figure 3.3 Environment Control panel (EDIX201-FMT01)
When you first access panel EDIX201-FMT01 to create a new user, the fields contain the run time
parameters from the user’s iSeries user profile. (SEE the iSeries documentation or your Security
Officer (QSECOFR) for more information.) Any values you change on this panel will override the
users iSeries options for Gentran jobs that are executed.
EDIX201 Environment Control EDI 04/30/08
FMT01 12:00:00
User ID. . . . . . . . . . . . . . EDI
Division . . . . . . . . . . . . . 000
Last Name. . . . . . . . . . . . . Ingram
First Name . . . . . . . . . . . . Elizabeth
MI . . . . . . . . . . . . . . . . D
Initials . . . . . . . . . . . . . EDI
Job Description. . . . . . . . . . GENTRAN
Print Device . . . . . . . . . . . QPRINT
Output Queue . . . . . . . . . . . QPRINT
Message Queue. . . . . . . . . . . EDI
Job Queue. . . . . . . . . . . . . QBATCH
Print File . . . . . . . . . . . . QSYSPRT
Gentran:Server Program Library . . G35PGM
Gentran:Server Data Library. . . . G35DTA
Date Format/Date Separator . . . . *MDY /
Language ID. . . . . . . . . . . . *SYSVAL
F1=Help F8=Next F12=Cancel F24=More Keys
Environment Control Panels Environment Control
3 - 8 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Field Information
This section contains information about specific fields, and in some cases, recommendations for
settings.
Output Queue Field
For the Output Queue field, we recommend you specify a queue that is not associated with an
active writer. This allows both system-generated and user-generated reports to be spooled rather
than printed immediately. At any time, you can print the spooled output by moving it to a queue
associated with an active writer. (SEE the iSeries online help for more information about queues,
devices, and printing.)
Date Format and Date Separator Fields
The default value in both the Date Format and Date Separator fields is *SYSVAL. When *SYSVAL
is used, Gentran:Server retrieves the date format from the system value in QDATFMT and the date
separator from the system value in QDATSEP. To see a list of valid options for the current field,
press F4 (Prompt). If new values are specified, the following dates are impacted by these settings.
Date fields on panels (excluding commands, which are controlled through the system
configuration file – see Note below)
Report dates
# NOTE
To apply these date settings to command panels, use *ENVCTL as the value in the ‘Set
Gentran Date Formats for Commands’ option on the system configuration file. (SEE the
“System Configuration” chapter in this guide for more information.)
Define the Security Profile
Gentran:Server uses a hierarchical security scheme based on authority codes that are defined at
three levels: subsystem, function, and data. These authority codes determine both the users system
access and data update privileges.
The Environment Control panel (EDIX201-CTL02) defines a users security profile. This panel
allows the EDI Coordinator to control each users access to whole subsystems and to individual
functions within subsystems. Panel EDIX201-CTL02 also determines the data privileges (view
only or update) for the subsystems and/or functions to which the user has access.
)RECOMMENDATION
The EDI Coordinator (System Administrator) and iSeries Security Officer (QSECOFR)
should be the only ones with update access to the Environment Control panel
(EDIX201-CTL02). This is necessary to protect the integrity of the system.
Environment Control Environment Control Panels
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 3 - 9
Figure 3.4 shows the primary components on the Environment Control panel (EDIX201-CTL02).
Figure 3.4 Environment Control panel (EDIX201-CTL02)
# NOTE
All the subsystems in the Gentran:Server product are displayed even if you only have the
Communications Module installed.
As you work with panel EDIX201-CTL02, keep in mind that you can use online help to display
the valid authority codes (and their meanings) for each level. To do this, move the cursor to the
authority code field and press F1 (Help). To select a code, press F4 (Prompt).
When you create a new user profile, all the authority codes are initially set to 1. To change the
authority codes, move the cursor and type over the existing value. When you finish making
changes, press Enter or F10 (Update). Press Enter to resequence information on the panel (the
subsystem, function, and data level entries) based on the new authority codes you typed on the
panel. Press F10 (Update) to confirm the add of the new user profile and return to the Work with
Environment Control panel (EDIX200-FMT01).
EDIX201 Environment Control EDI 04/30/08
CTL02 12:00:00
User ID. . . . . . . . . . . . . . EDI
Name . . . . . . . . . . . . . . . Elizabeth D. Ingram
Subsystem Level Function Name
1 Application Definition Subsystem
1 Application Definition Data
1 Audit Subsystem
1 Audit Data
1 Communications Subsystem
1 Communications Data
1 Environment Control Subsystem
1 Environment Control Data
1 Message Center Subsystem
1 Message Center Data
1 Partner Subsystem
1 Partner Data
1 Processing Subsystem
1 Processing Data
More...
F1=Help F4=Prompt F7=Back F10=Update F12=Cancel F24=More Keys
Authority Code
Environment Control Panels Environment Control
3 - 10 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Define Authority Codes
To fully explain the authority codes, we must first define the other fields on the Environment
Control panel (EDIX201-CTL02).
Subsystem
This field lists the subsystems (the asterisks indicate subsystems included in the Communications
Module):
Application Definition
Audit
Communications*
Environment Control*
Partner
Gentran:Server Processing
SAP Extension
Standards
Gentran:Server System Administration (*Job Scheduler and System Configuration)
Transaction Mapping
Viewpoint
# NOTE
The Utilities subsystem also appears on the list of Gentran:Server subsystems on the
Environment Control panel (EDIX201-CTL02). This subsystem is for internal use only. The
authority code should be set to 1.
Level
This field defines the scope of the authority code. Security can be defined for these three levels:
Subsystem – The authority code applies to accessing the whole subsystem identified
underneath “Subsystem” on the panel.
Function – The authority code applies to accessing the part of the subsystem identified
underneath “Function Name” on the panel. Function names are either panel names (like Work
with Application Definition and Application Fields) or F4 (Prompt) windows such as
Application Definition Search. Function levels appear on the panel only if the Subsystem level
authority code is 2 (partial access). The valid values for authority codes are explained under
“Authority Codes”.
Data – The authority code applies to the data on the panels within the whole subsystem (if the
Subsystem level authority code is 1) or within a function (if the Subsystem level authority
code is 2). Data levels do not appear on the panel if the Subsystem level authority code is 3 (no
access).
Environment Control Environment Control Panels
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 3 - 11
Function Name
When the Level field is set to Function, there is an entry in the Function Name field, otherwise this
field is blank. The function name consists of the program or command name and a corresponding
description.
Authority Codes
The authority codes vary in meaning based on whether the Level field (two columns to the right of
the authority code) contains “Subsystem”, “Function”, or “Data”.
Subsystem Level Authority Codes
Subsystem level can have an authority code of 1, 2, or 3, as explained below.
1 ALL – The user has access to the entire subsystem. When the Subsystem level authority
code is 1, the panel does not display individual functions since the user has access to all
functions in the subsystem. The panel displays the Data level authority code, which
determines the user’s data update privileges for the given subsystem. In the security
profiles for the EDI coordinator and Security Officer (QSECOFR), every Subsystem level
authority code should be 1.
2 PARTIAL – The user’s access to the subsystem is defined on a function-by-function basis.
Access is determined by the authority code on each line that contains Function in the
Level field. (SEE “Function” below for details.) When the Subsystem level authority code
is 2, the panel displays all the functions in the subsystem, with an authority code
associated with each one. The panel also displays the Data level authority codes, which
determines the user’s data update privileges for the subsystem.
# NOTE
The Subsystem level authority code must be set to 2 (PARTIAL) if you want to define access
at the Function level (on a function-by-function basis).
3 NONE – The user cannot access the subsystem. (The subsystem still appears on the
GENMAIN menu, but the user cannot access the subsystem panels.) When the Subsystem
level authority code is 3, the panel does not display Function level or Data level authority
codes since they have no meaning in this case.
Function Level Authority Codes
Function level can have an authority code of 1 or 3, as explained below.
1 ALL – The user can access the function listed under “Function Name”.
3 NONE – The user cannot access the function listed under “Function Name”.
Environment Control Panels Environment Control
3 - 12 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Data Level Authority Codes
# NOTE
The Data level authority code determines the users data update privileges for the subsystem.
To define Data level privileges, the Subsystem level authority code must be set to 1 (ALL) or
2 (PARTIAL).
If the Subsystem level authority code is 1, then the Data level code applies to the data on any
panel within the whole subsystem.
If the Subsystem level authority code is 2, then the Data level authority code applies to data
on only those panels within the given function.
Data level can have an authority code of 1, 2, or 3, as explained below.
1 ALL – The user can update the data if the Update Allowed field is set to Y. The user can
change the Update Allowed field.
2 PARTIAL – The user can update the data if the Update Allowed field is Y. The user has
display only rights if the Update Allowed field is N. The user cannot change the Update
Allowed field.
3 NONE – The user can only display the data. The user cannot change the data or the
Update Allowed field.
Environment Control Environment Control Panels
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 3 - 13
Quick Reference for Setting Authority Codes
The following table gives an overview of the security scheme. It shows the possible combinations
of authority codes and their meanings.
Subsystem
Level Authority
Code:
Function
Level Authority
Code:
Data
Level Authority
Code:
Users Rights:
1 1 Access all functions within
the subsystem. Can update
data if the Update Allowed
field is Y. Can change the
Update Allowed field.
1 2 Access all functions within
the subsystem. Can update
data if the Update Allowed
field is Y. Cannot change the
Update Allowed field.
1 3 Access all functions within
the subsystem with view only
privileges.
2 1 1 Access the given function.
Can update data if the Update
Allowed field is Y. Can
change the Update Allowed
field.
2 1 2 Access the given function.
Can update data if the Update
Allowed field is Y. Cannot
change the Update Allowed
field.
2 1 3 Access the given function
with view only privileges
23Cannot access the function.
3 ——Cannot access the subsystem.
Reports Environment Control
3 - 14 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Reports
EBDI201—Environment Control Report
Contents of the Report
The Environment Control Report contains information about the user’s profile and authority
assigned to each subsystem.
How to Identify the Report
The identifier “EBDI201” displays in the upper left corner of the report. The report title
“ENVIRONMENT CONTROL PROFILE REPORT” displays in the center at the top of the
report. The identifier “EBDI201” also displays in the User Data field associated with the spooled
report in the Output Queue.
How to Generate the Report
This is a user-generated report. It can be generated by selecting option ‘6’ (Print) on the Work with
Environment Control panel (EDIX200-FMT01) and entering the appropriate information on the
Print Environment Control (PRTENV) panel. It can also be generated by pressing F21 (Prt Env) on
the environment control panels.
Special Considerations
Like all other Gentran:Server reports, the Environment Control Profile Report automatically goes
to the Output Queue defined for the user running the job.
Environment Control Reports
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 3 - 15
Sample Report
EBDI201 RUN DATE 04-30-08 ENVIRONMENT CONTROL PROFILE REPORT RUN TIME 16:40:06 PAGE 1
USER ID. . . . . . . QSECOFR JOB DESCRIPTION. . . GENTRAN PRINT FILE. . . . . . . . . . . . . QSYSPRT
DIVISION . . . . . . 000 PRINT DEVICE . . . . PRTHOLD GENTRAN:SERVER PROGRAM LIBRARY. . . G3X5PGM
LAST NAME. . . . . . Officer OUTPUT QUEUE . . . . PRTHOLD GENTRAN:SERVER DATA LIBRARY . . . . G3X5TSTDTA
FIRST NAME . . . . . Security MESSAGE QUEUE. . . . QSECOFR DATE FORMAT/DATE SEPARATOR. . . . . *SYSVAL *SYSVAL
MIDDLE INITIAL . . . JOB QUEUE. . . . . . QBATCH LANGUAGE ID . . . . . . . . . . . . ENU
INITIALS . . . . . . SEC
SEC SUBSYSTEM LEVEL FUNCTION NAME
------------------------------------------------------------------------------------------------------------------------------------
1 Application Definition Subsystem
1 Application Definition Function APPCPY Copy Application ID
1 Application Definition Function APPRENBR Application Renumber
1 Application Definition Function APPSYNCH Application Synchronization
1 Application Definition Function EDIX550 Work with Application Definition
1 Application Definition Function EDIX551 Application Definition Search
1 Application Definition Function EDIX552 Application Definition
1 Application Definition Function EDIX553 Application Records
1 Application Definition Function EDIX554 Application Fields
1 Application Definition Function EDIX556 Application Key Structure
1 Application Definition Function EDIX556S Application Field Key Prompt
1 Application Definition Function EDIX559 Application Partner Reference
1 Application Definition Function EDIX559S Application Partner Reference Prompt
1 Application Definition Function EDIX560 Application Envelope Definition
1 Application Definition Function EZAPPDEF ez Application Definition
1 Application Definition Function EZAPPDEF2 ez Application Definition
1 Application Definition Function PRTAPP Print Application Definition
1 Application Definition Data
1 Audit Subsystem
1 Audit Function AUDITPURGE Purge Audit (AUDITPURGE)
1 Audit Function EBDIEDIT Edit Extracted Edi Data for Requeue
1 Audit Function EDIX251 Work with Audit Interchange Status
1 Audit Function EDIX252 Work with Audit Group Status
1 Audit Function EDIX253 Work with Audit Transaction Status
1 Audit Function EDIX254 Audit Acknowledgements
1 Audit Function EDIX255 Audit Deletes
1 Audit Function EDIX256 Audit Interchange Search
1 Audit Function EDIX257 Audit Group Search
1 Audit Function EDIX259 Work with Selected Audit Records
1 Audit Function EDIX451 Audit Interchange Data Inquiry
1 Audit Function EDIX452 Audit Group Data Inquiry
1 Audit Function EDIX453 Audit Transaction Data Inquiry
1 Audit Function EDIX454 Segment Inquiry
1 Audit Function EDIX455 Data Element Definition
1 Audit Function GENAUD Audit Menu
1 Audit Function PRGAUD Purge Audit
1 Audit Function PRGNET Purge Network Status File
1 Audit Function PRTAUD Print Audit
1 Audit Function PRTNETSTS Print Network Status Report
1 Audit Function REQUEUE Requeue EDI Data from Audit
1 Audit Function RTVAUD Retrieve Audit
1 Audit Function RTVNET Retrieve Network Status File
1 Audit Function SLTAUD Audit Search Utility
1 Audit Data
1 Communications Subsystem
1 Communications Function CHGDUP Change Duplex
1 Communications Function CHGNRZI Change NRZI Setting
1 Communications Function CHGPHNUM Change Phone Number
Sterling Commerce
Reports Environment Control
3 - 16 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Fields on the Environment Control Profile Report (EBDI201)
Field Name Description
Report Header
User ID Displays the user ID.
Job Description Specifies the job description under which the Gentran server jobs are
executed.
Print File Displays the type of output for printed document.
Division Displays the division.
Print Device Displays the printer where the output is directed.
Gentran:Server
Program Library
Name of the library where all Gentran:Server programs are stored.
Last Name Displays the user’s last name.
Output Queue Specifies the name of the output queue to which the output files will be
printed.
Gentran:Server Data
Library
Specifies the name of the library where all Gentran:Server data files are
stored.
First Name Displays the user’s first name.
Message Queue Specifies the name of the queue where the messages are stored.
Date Format/
Date Separator
Specifies the format and separator used when displaying dates on
screen and in printed reports.
Middle Initial Displays the user’s middle initial.
Job Queue Specifies the name of the job queue to which the jobs are submitted.
Language ID Identifies the language-specific message file for Gentran processing.
Initials Displays the three-letter initials of the user.
Detail Section
Sec(urity) Code Identifies whether the user can access a subsystem or function.
Subsystem Identifies the name of the subsystem.
Level Displays the level of security.
Function Displays the name of the program or command.
Name Displays a description of the program or command.
Environment Control Common Questions
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 3 - 17
Common Questions
What if I want two Gentran:Server User IDs?
If you are both the QSECOFR (or EDI Coordinator) and a Gentran:Server user, you may want two
User IDs with different Security Profiles. Another reason for two User IDs is to define two
different environment profiles (i.e. different job descriptions or division codes).
To have two Gentran:Server User IDs, you need two separate iSeries User IDs and then follow the
steps in “Creating a User ID.”
How can I create a uniform running environment for multiple
users?
When multiple users are using Gentran:Server, it is typical for each user to have their own
environment and security profile for testing. For production processing in this scenario, it is more
appropriate to set up a unique user that will always have the same environment parameters. You
may choose to create an iSeries user profile called “COM” and then create a Gentran:Server user
profile for this User ID with specific environment parameters. This User ID could be used for
scheduling jobs or submitting jobs manually for all production work.
The dates on command panels are showing in a different
format from the dates on panels and reports – why are they
different?
The format for dates displayed on panels (other than commands) is controlled through each users
Gentran:Server environment profile. The date format for command panels is controlled by the
Gentran:Server System Configuration file. If you prefer to have each individual user’s
environment profile settings apply, however, make *ENVCTL the value in the ‘Set Gentran Date
Format’ option in the system configuration file.
Previously, date parameters on commands were defined to use IBM’s *DATE attribute to allow for
automatic date validation, which required the date to be entered in the job-date format. With the
Gentran:Server for iSeries Communications Module Release 3.1 and higher, you can decide which
format to use when entering dates on commands.
# NOTE
See “Define the Environment Profile” on page 7 in this chapter for more information about
setting up environment profiles, and see the “System Configuration” chapter in this guide for
more information about working with the system configuration file.
Common Questions Environment Control
3 - 18 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Chapter
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 1
4Using Communications
In this Chapter
Gentran:Server for iSeries Communications Module allows you to configure, operate, and manage
communications between your system and third-party networks or direct communication partners.
This chapter includes specific information and exercises to help you set up and manage your
communications. This chapter covers the following topics:
¾What Is Communications?............................................................................................... 4-2
¾What Does the Communications Subsystem Do?............................................................ 4-2
¾Take a Closer Look at Communications .......................................................................... 4-3
¾Panel Quick Reference..................................................................................................... 4-5
¾Access the Communications Subsystem........................................................................ 4-12
¾Communications Setup .................................................................................................. 4-15
Communication Profiles.......................................................................................... 4-16
Communications Session Control Scripts ............................................................... 4-28
Network Scripts....................................................................................................... 4-38
¾Copy Profiles and Scripts............................................................................................... 4-58
¾Operations and Management of Communications......................................................... 4-64
Initiate Communication Sessions ............................................................................ 4-65
Monitor Active Communication Sessions............................................................... 4-71
View the Communications History Log.................................................................. 4-73
Manage the Outbound Queue.................................................................................. 4-79
Manage the Inbound Queue..................................................................................... 4-92
Purge the Communications Files........................................................................... 4-114
¾Use the ezCOMM Command....................................................................................... 4-123
¾Reports ......................................................................................................................... 4-126
¾Common Questions...................................................................................................... 4-129
What Is Communications? Using Communications
4 - 2 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
What Is Communications?
Communications is the process by which you send/receive data to/from value-added networks
(VANs) or direct communication partners. To do this, you must define communication profiles,
write and/or copy scripts, and initiate communication sessions. Successful communications
requires hardware information related to modems, dialers, and lines, as well as software related
information such as options regarding record separators and blank suppression.
What Does the Communications Subsystem
Do?
The Communications subsystem provides the following capabilities:
Create, copy, and maintain Communication Profiles and scripts (predefined profiles and
scripts are provided for major EDI networks).
Initiate and terminate communication sessions.
Monitor active communication sessions.
Manage the data in the Inbound and Outbound Queues (repositories for the EDI data that is
sent and received).
View the Communication History log to see the results of communication sessions.
Purge and retrieve the History log and the Inbound and Outbound Queues.
Perform Dynamic Scripting and Remote Command Support.
Continuously process communication sessions.
Perform a Communications Trace for troubleshooting.
Using Communications Take a Closer Look at Communications
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 3
Take a Closer Look at Communications
The Communications feature can be divided into two major components: the communications
setup (profiles and scripts) and the operations and management of communications.
Communications Setup
Gentran:Server provides predefined communication profiles (comm profiles) and scripts for the
major EDI networks. When setting up for your communication sessions, you can modify one of
these predefined profiles or create a new profile with the information about your configuration.
The profile contains information (i.e., protocol, manual or auto dial, the number to dial) necessary
to establish and use the link to the remote system. The script defines the “conversation” that the
two systems conduct over the communications line.
Gentran:Server provides a utility, the Network Profile feature, that can be used with most of the
predefined profiles and scripts for quick “customizing.” It recognizes the network values and
replaces them with your identifiers supplied by the VAN, such as the Mailbox ID and the
password. This utility can be used with any profile classified as a “network profile.”
# NOTE
Due to the uniqueness of each implementation, the predefined Communication scripts are
provided as examples only and are intended to assist in getting you started. Please read the
User Guide provided by your value-added network or communication partner to ensure that
the setup correctly reflects their specific requirements.
Operations and Management of Communications
Operations refers to the initiation and monitoring of communication sessions. A “session” is when
the actual transfer of data occurs. Each session is a planned connection between your system and a
specific network or a particular direct communication partner. The Start Communications Session
(STRCOMSSN) command can be run one of three ways:
Scheduled to run in batch at a later time
Submitted to run in batch immediately
Executed interactively (immediately)
# NOTE
SEE the “Job Scheduler” chapter in this guide for more information on scheduling
communication sessions.
Take a Closer Look at Communications Using Communications
4 - 4 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Active sessions can be monitored from within Gentran:Server allowing the user to perform all
operational tasks on the session from a central location. Effective management of the
communications data is an essential process in the day-to-day operation of your Communications
system. This includes managing and controlling the actual data to queue, de-queue, view, purge,
and retrieve. Details of all comm sessions can be viewed in the History log and later purged.
Periodic purges help to maintain efficient throughput.
Figure 4.1 depicts the Communications subsystem.
Figure 4.1 Communications Subsystem Diagram
Trading Partner
VAN
(Leased Line)
(Switched Line)
History
User File
SPOOL
Outbound
Queue
Gentran:Server for iSeries Communications Module
Modem
Communications
Profile Script
WAN/Internet
U
S
E
R
A
P
P
L
I
C
A
T
I
O
N
S
iSeries
Inbound
Queue
IFS Gateway
Using Communications Panel Quick Reference
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 5
Panel Quick Reference
The following table gives the purpose and access method for all of the Work with Communication
panels in this chapter.
Panel Name Purpose Access Methods
Gentran:Server
Communications Menu
(GENCOM)
Access all communications
functions.
Select option 1 on the GENMAIN menu.
Enter GO GENCOM on the command line.
EDIX400-FMT01
Work with
Communications
Access all Communications
functions.
Select option 1 on the GENCOM menu.
Enter EXCPGM EDIX400 on the command
line.
EDIX401-FMT01
Communication Profile
— Part 1
Define the Protocol and
FIFO/LIFO method.
Select an option (1-5) on panel
EDIX400-FMT01.
Enter EXCPGM EDIX401 on the command
line.
EDIX401-FMTnn
Communication Profile
— Part 2 (where ‘nn’ is
02 – 09)
Define the configuration
information for the profile.
Formats will vary
depending on the protocol.
Press Enter or F8 (Next) on panel
EDIX401-FMT01.
Press F10 (Update) in add mode on panel
EDIX401.
EDIX401-FMT20
Communication Profile
— Part 3
Define the line, controller,
and device description.
Press Enter or F8 (Next) on
Communications Profile Part 2
(EDIX401-FMT02 thru EDIX401-FMT09).
EDIX819-FMT01
Communication
Line/Control/
Device
View or revise the line,
control, and device
description names.
Select option 11 on panel
EDIX400-FMT01.
Enter EXCPGM EDIX819 on the command
line.
EDIX402-FMT01
Work with
Communications
Session
Access session control
scripts for comm profiles.
Select option 2 on the GENCOM menu.
Select option 12 on panel
EDIX400-FMT01.
Enter EXCPGM EDIX402 on the command
line.
EDIX403-CTL01
Communication
Session Control
Define detailed instructions
(action data) for a session
script.
Select option 1 or 2 on panel
EDIX402-FMT01.
Enter EXCPGM EDIX403 on the command
line.
Panel Quick Reference Using Communications
4 - 6 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
EDIX43B-FMT01
Communication
Session Control
Extended Parms
Define extended parameters
for each script record or
maintain the “command” in
hex mode.
Select option 11 on panel
EDIX403-FMT01.
Enter EXCPGM EDIX43B on the command
line.
EDIX43C-FMT01
Communication Evoke
Define the Evoke record
used for X62 and L62
protocols to start a comm
session on a remote system.
Add a script record on panel
EDIX403-CTL01 with Tran type E.
Press F13 (Services) on panel EDIX403 or
EDIX43B and select the option for
‘Communication Evoke’.
Enter EXCPGM EDIX43C on the command
line.
EDIX817-FMT01
Work with
Communication Jobs
Monitor and control active
comm jobs.
Select option 6 on the GENCOM menu.
Select option 13 on panel
EDIX400-FMT01.
Enter EXCPGM EDIX817 on the command
line.
EDIX406-FMT01
Work with
Communications
History Log
View the history
information for previous
communication sessions.
Select option 3 on the GENCOM menu.
Select option 14 on panel
EDIX400-FMT01.
Enter EXCPGM EDIX406 on the command
line.
EDIX404-FMT01
Work with Outbound
Queue Control
Access Outbound data and
change the status of batches.
Select option 4 on the GENCOM menu.
Select option 15 on panel
EDIX400-FMT01.
Enter EXCPGM EDIX404 on the command
line.
EDIX405
Outbound Queue
Inquiry
View the actual data on a
selected Outbound batch.
Select option 5 on panel EDIX404-FMT01.
Select option 11 on panel
EDIX406-FMT01 for an Outbound session.
EDIX407-FMT01
Work with Inbound
Queue Control
Access Inbound data and
change the status of batches.
Select option 5 on the GENCOM menu.
Select option 16 on panel
EDIX400-FMT01.
Enter EXCPGM EDIX407 on the command
line.
Panel Name Purpose Access Methods
Using Communications Panel Quick Reference
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 7
EDIX408
Inbound Queue Inquiry
View the actual data in a
selected Inbound batch.
Select option 5 on panel EDIX407-FMT01.
Select option 11 on panel
EDIX406-FMT01 for an Inbound session.
EDIX820-FMT01
Work with Network
Profiles
Access network profiles that
can be used by the
automatic network update
utility.
Select option 7 on the GENCOM menu.
Select option 17 on panel
EDIX400-FMT01.
Enter EXCPGM EDIX820 on the command
line.
EDIX821-FMT01
Network Profiles
Define the network
identifiers for your
company to be updated
automatically in all the
scripts for a given profile.
Select option 2 or 5 on panel
EDIX820-FMT01.
Enter EXCPGM EDIX821 on the command
line.
EDIX460-FMT01
Work with MQ Links
Access all the queue
information supported in the
Gentran system.
Select option 8 on the GENCOM menu.
Select option 18 on panel
EDIX400-FMT01.
Enter EXCPGM EDIX460 on the command
line.
Enter J MQ on the command line.
EDIX461-FMT01
MQ Link
Configuration
Define the queues to be
used in sending/receiving
files within MQSeries.
Select an option (15) on panel
EDIX460-FMT01.
Enter EXCPGM EDIX461 on the command
line.
STRCOMSSN
Start Communications
Session
Initiate a communication
session for a specified
comm profile and script
name.
Select option 10 on the GENCOM menu.
Select option 30 on panel
EDIX400-FMT01 or on panel
EDIX402-FMT01.
Select option 33 on panel
EDIX404-FMT01.
Prompt STRCOMSSN on the command line.
SHUTDOWN
End active Comm Jobs
End active Communication
Jobs.
Select option 12 on the GENCOM menu.
Select option 31 on panel
EDIX400-FMT01.
Prompt SHUTDOWN on the command line.
Panel Name Purpose Access Methods
Panel Quick Reference Using Communications
4 - 8 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
GENLINP
Gentran Line Pool
Create line pool description
and identify modem lines to
be used in pool for
Gentran:Server
communications.
Select option 13 on the GENCOM menu.
Select option 33 on panel
EDIX400-FMT01.
Prompt GENLINP on the command line.
PRGCHF
Purge Comm History
File
Purge the Communication
History Log using selection
criteria.
Select option 15 on the GENCOM menu.
Select option 40 on panel
EDIX400-FMT01.
Prompt PRGCHF on the command line.
PRGOBQ
Purge Outbound Queue
Purge the Outbound Queue
(control and data files)
using selection criteria.
Select option 17 on the GENCOM menu.
Select option 41 on panel
EDIX400-FMT01.
Prompt PRGOBQ on the command line.
PRGIBQ
Purge Inbound Queue
Purge the Inbound Queue
(control and data files)
using selection criteria.
Select option 16 on the GENCOM menu.
Select option 42 on panel
EDIX400-FMT01.
Prompt PRGIBQ on the command line.
PRGALL
Purge All Comm Files
Purge all Communication
files (History Log,
Outbound and Inbound
Queue) using the same
selection criteria.
Select option 14 on the GENCOM menu.
Select option 43 on panel
EDIX400-FMT01.
Prompt PRGALL on the command line.
RTVCHF
Retrieve Comm
History File
Retrieve the
Communication History
Log using selection criteria.
Select option 19 on the GENCOM menu.
Select option 44 on panel
EDIX400-FMT01.
Prompt RTVCHF on the command line.
RTVOBQ
Retrieve Outbound
Queue
Retrieve the Outbound
Queue (control and data
files) using selection
criteria.
Select option 21 on the GENCOM menu.
Select option 45 on panel
EDIX400-FMT01.
Prompt RTVOBQ on the command line.
RTVIBQ
Retrieve Inbound
Queue
Retrieve the Inbound Queue
(control and data files)
using selection criteria.
Select option 20 on the GENCOM menu.
Select option 46 on panel
EDIX400-FMT01.
Prompt RTVIBQ on the command line.
Panel Name Purpose Access Methods
Using Communications Panel Quick Reference
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 9
RTVALL
Retrieve All Comm
Files
Retrieve all Comm files
(History Log, Outbound and
Inbound Queue) using the
same selection criteria.
Select option 18 on the GENCOM menu.
Select option 47 on panel
EDIX400-FMT01.
Prompt RTVALL on the command line.
PRGALLA
Purge all Comm Files
Purge all Comm files
automatically at the end of
each Comm session, if
activated.
Enter a value in “Days to Purge” on panel
EDIX401-FMT01 (not 999) and the
command will run at the end of a comm
session.
PRTEDIDTA
Print EDI Data
Print EDI data for a selected
batch at the segment level.
This data can be directed to
the printer or an output file.
Press F21 on panel EDIX405 or EDIX408.
Select option 6 on panel EDIX404 or
EDIX407.
Select option 37 on the GENCOM menu.
Prompt PRTEDIDTA on the command line.
PRTCOM
Print Comm Control
Script
Print the session control
records for a specified
comm profile and script
name.
Select option 6 on panel EDIX402-FMT01.
Prompt PRTCOM on the command line.
PRTCOMHST
Print Communications
History
Print the Communications
History records for the
selected entries.
Select option 22 on the GENCOM menu.
Prompt PRTCOMHST on the command line.
Select *YES for the ‘Print Comm Session
Log’ parameter on the STRCOMSSN
command.
Select option 34 from the EDIX406 panel.
GENMQSND
Send File to MQ Queue
Send a file to an MQSeries
queue.
Select option 39 on the GENCOM menu.
Prompt GENMQSND on the command line.
Enter J MQS on the command line.
GENMQRCV
Receive File from MQ
Queue
Receive a file from an
MQSeries queue.
Select option 38 on the GENCOM menu.
Prompt GENMQRCV on the command line.
Enter J MQR on the command line.
FNDSTRCOM
Find String in Comm
Queues
Locate a string of data in the
inbound or outbound queues
for any profile.
Select option 36 on the GENCOM menu.
Select option 31 on panel EDIX404.
Select option 31 on panel EDIX407.
Prompt FNDSTRCOM on the command line.
Panel Name Purpose Access Methods
Panel Quick Reference Using Communications
4 - 10 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
GIFSGATE
Gentran IFS Gateway
Allow data to be moved
back and forth from the
Gentran Comm queues to
the integrated file system
Select option 41 on the GENCOM menu.
Prompt GIFSGATE on the command line.
Select option 32 on panel EDIX404.
GENIBQIFS
Gentran IBQ to IFS
Gateway
Allow batches from
inbound communication
queue to be copied to the
IFS file system.
Select option 42 on t he GENCOM menu.
Select option 32 on panel EDIX407.
Prompt GENIBQIFS on the command line.
ADD
Add Data to Queues
Add a batch of data to the
inbound or outbound queue.
Select option 30 on the GENCOM menu.
Prompt ADD on the command line.
EXTRACT
Extract Data from
Queues
Extract (make a copy of the
data) a batch of data from
the inbound or outbound
queue.
Select option 31 on the GENCOM menu.
Prompt EXTRACT on the command line.
Select option 30 on panel EDIX404 or
EDIX407
STATFLG
Change Status
Changes the status of a
batch on the inbound or
outbound queue.
Select option 32 on the GENCOM menu.
Prompt EXTRACT on the command line.
Select option 30 on panel EDIX404 or
EDIX407.
CHGDUP
Change Duplex
Changes the Duplex switch
for a comm profile between
full and half duplex.
Select option 33 on the GENCOM menu.
Prompt CHGDUP on the command line.
CHGPHNUM
Change Phone Number
Change the phone number
for a comm profile.
Select option 34 on the GENCOM menu.
Prompt CHGPHNUM on the command line.
CHGNRZI
Change NRZI
Change the NRZI setting for
a comm profile.
Select option 35 on the GENCOM menu.
Prompt CHGNRZI on the command line.
STRRPSR
Start Rmt Pgm Start
Requests
Varies on all configured
Gentran Remote Program
Start Requestable devices so
that they are available to
respond to incoming
program start requests
Select option 40 on the GENCOM menu.
Prompt STRRPSR on the command line.
Panel Name Purpose Access Methods
Using Communications Panel Quick Reference
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 11
CHGCOMPRF
Change Partner Comm
Profiels
Change the Comm Profile
listed on the partner
interchange records or
group record
Select option 43 on the GENCOM menu.
Prompt CHGCOMPRF on the command line.
RPLCHARS
Replace Characters
Find and replace characters
on the user defined file
Select option 44 on the GENCOM menu.
Prompt RPLCHARS on the command line.
Panel Name Purpose Access Methods
Access the Communications Subsystem Using Communications
4 - 12 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Access the Communications Subsystem
Figure 4.2 Gentran:Server Communications Main Menu (GENMAIN)
To access the Communications subsystem, select option 1 (Communications Menu) on the main
menu (Figure 4.2) or type GO GENCOM on the command line and press Enter.
GENMAIN Gentran:Server for iSeries Communications 3.5
System: ISDDEV01
Select one of the following:
1. Communications Menu (GENCOM)
2. Work with Job Scheduler
3. Work with Environment Control
4. System Configuration Menu (GENSYSCFG)
10. Gentran:Server Search Index
13. Gentran File Tracking Menu (GENFILETRK)
90. Sign off
Bottom
Selection or command
===> 1
F3=Exit F4=Prompt F9=Retrieve F12=Cancel F13=User Support
(C) COPYRIGHT Sterling Commerce Inc., 2008, ALL RIGHTS RESERVED.
Using Communications Access the Communications Subsystem
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 13
The Gentran:Server Communications menu (GENCOM) is displayed (Figure 4.3).
Figure 4.3 Gentran:Server Communications menu (GENCOM)
Select option 1 (Work with Communications) on the GENCOM menu. The system displays the
Work with Communications panel (EDIX400-FMT01), as shown in Figure 4.4. All tasks
associated with communications are performed from either the GENCOM menu or the Work with
Communications panel.
GENCOM Gentran:Server Communications 3.5
System: ISDDEV01
Select one of the following:
1. Work with Communications
2. Work with Session Scripts
3. Work with Comm History File
4. Work with Outbound Queue
5. Work with Inbound Queue
6. Work with Active Comm Jobs
7. Work with Network Profiles
8. Work with MQ Links
10. Start a Comm Session (STRCOMSSN)
11. Start a Comm Session with Trace (STRCOMSSNT)
12. End Active Comm Jobs (SHUTDOWN)
13. Gentran Line Pools (GENLINP)
14. Purge All Communication Files (PRGALL)
More...
Selection or command
===> 1
F3=Exit F4=Prompt F9=Retrieve F12=Cancel F13=User Support
(C) COPYRIGHT Sterling Commerce Inc., 2008, ALL RIGHTS RESERVED.
Access the Communications Subsystem Using Communications
4 - 14 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
The Work with Communications panel (EDIX400-FMT01) contains a list of Communication
Profile IDs from which all options can be accessed.
Figure 4.4 Work with Communications Panel (EDIX400-FMT01)
The initial sort order for panel EDIX400-FMT01 is by the comm profile ID. An alternate sort
option, accessed with F15 (Sort), is available by Company (Profile Description). The Position To
field may be used to access the desired Profile ID more quickly.
You can perform the following tasks from panel EDIX400-FMT01:
Set up communications
Create or modify a Communications Profile
View the Line/Controller/Device description setup
Maintain communication session control scripts
Use the automatic Network script and profile update feature
Operate and manage communications
Initiate a communication session
Monitor active communication sessions
Work with the Outbound Queue (outgoing EDI data)
Work with the Inbound Queue (EDI data received)
View the Communication History log
Purge communication data (History log and Inbound and Outbound Queues)
EDIX400 Work with Communications EDI 04/30/08
FMT01 pgmlib: G3X5PGM dtalib:G3X5DTA 12:00:00
Position to Profile ID . . . . . .
Type option (and Information), press Enter.
1=Create 2=Revise 3=Copy 4=Delete 5=View 11=Line/Ctl/Dev
Opt Profile ID Company
ADVBSC ADVANTIS BSC
ADVLU0 ADVANTIS SDLC
ATLASFTX Atlas in France via OFTP/X.25
ATTEASY AT&T EASYLINK SERVICES
ATTUK AT&T IN THE UNITED KINGDOM
AUTOANS TEST AUTOANSWER CONFIG
BTASCL BT UK GNS EDI*NET Async "Live" Sys
BTASCT BT UK GNS EDI*NET Async "Test" Sys
BTOFTP BT UK GNS EDI*NET OFTP via Async
More...
Parameters or command
===>
F1=Help F3=Exit F12=Cancel F15=Sort F23=More Options F24=More Keys
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 15
Communications Setup
The setup of Communications pertains to defining communications profiles and scripts necessary
to establish a communications link with another party.
Create and manage a Communication Profile
Each third party network or direct communication partner with whom you wish to communicate
must have a defined communication profile (comm profile). A typical comm profile contains
hardware information such as modems, dialers, and lines, as well as software related information
such as options regarding record separators and blank suppression.
Modify a Communication Session Control Script
Session Control records are the detailed instructions for conducting a communication session. One
or more session control records may be combined to form a session control script. The script
consists of the step-by-step instructions that control how the transmission and/or reception of data
will take place. An example of a script type is ‘SR’ (send first, then receive).
# NOTE
You must have *IOSYSCFG authority to add, create, and delete user profiles when working
with any protocol other than FTP.
Communications Setup Using Communications
4 - 16 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Communication Profiles
Each third party network or direct communication partner with whom you wish to communicate
must have a defined communication profile (comm profile). A typical comm profile contains
software and hardware information related to your configuration, such as modems, dialers, lines,
record separators, and blank suppression. Gentran:Server supplies predefined profiles for the
major EDI networks. If necessary, a new profile can be created for a unique communication
partner.
Figure 4.5 Work with Communications Panel (EDIX400-FMT01)
As shown in Figure 4.5, from the Work with Communications panel (EDIX400-FMT01), type 2
(Revise) in the option field next to the desired Profile ID and press Enter. If creating a new Profile
ID, type 1 (Create) and a Profile ID on the key entry line and press Enter.
# NOTE
Due to the uniqueness of each implementation, the predefined Communication scripts are
provided as examples only and are intended to assist in getting you started. Please read the
User Guide provided by your value-added network or communication partner to ensure that
the setup correctly reflects their specific requirements.
EDIX400 Work with Communications EDI 04/30/08
FMT01 pgmlib: G3X5PGM dtalib:G3X5DTA 12:00:00
Position to Profile ID . . . . . .
Type option (and Information), press Enter.
1=Create 2=Revise 3=Copy 4=Delete 5=View 11=Line/Ctl/Dev
Opt Profile ID Company
BTOFTPX BT UK GNS EDI*NET OFTP via X.25
BTUK BT UK GNS EDI*NET BISYNC
BTXAS BT UK GNS EDI*NET ASYNC VIA X.25
CHRY CHRYSLER CTX MAILBOX
CHRY480 CHRYSLER - 830, 861, 862
CHRY512 CHRYSLER - 824, 856, 997
CNBTASC COMMERCE:NETWORK via BT async pad
CNFALASC COMMERCE:NETWORK via Australian FAL
2 CN3BSC COMMERCE:NETWORK RELEASE3
More...
Parameters or command
===>
F1=Help F3=Exit F12=Cancel F15=Sort F23=More Options F24=More Keys
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 17
Set Protocol-Independent Parameters for a Communication Profile
The Communication Profile panel (EDIX401-FMT01), as shown in Figure 4.6, is the first panel
used to define the comm profile. The next panel that is shown for the comm profile ID will vary
depending on the protocol specified, for example, BSC or SNA.
Figure 4.6 Communication Profile Panel (EDIX401-FMT01)
Enter or change the desired information and press Enter or F8 (Next) to advance to the
configuration panel (Protocol-Specific Parameters) for the corresponding protocol. Pressing F10
(Update) in create mode also advances you to the configuration panel.
Field Definitions
Company
A 35-position alphanumeric field used to enter your direct communication partners
company name.
Contact
A 35-position alphanumeric field used to enter the name of a personal contact at your
direct communication partners company.
Phone
A 14-position alphanumeric field used to enter the contact’s phone number. Format is nnn
nnn-nnnn nnnn. You may enter the area code, phone number, and internal company
extension.
International Dial Code
A 3-position alphanumeric field used to enter an international dial code with the telephone
number. Format is nnn where nnn is the international access code.
EDIX401 Communication Profile EDI 04/30/08
FMT01 12:00:00
Comm Profile ID. . . . . . . . . . CN3BSC
Company. . . . . . . . . . . . . . COMMERCE:NETWORK RELEASE3
Contact. . . . . . . . . . . . . . NETWORK COMMUNICATIONS
Phone. . . . . . . . . . . . . . . ( 614 ) 793 - 7000 x
International Dial Code. . . . . .
Protocol . . . . . . . . . . . . . BSC
Days to Purge. . . . . . . . . . . 999
FIFO/LIFO. . . . . . . . . . . . . F
Used Most Frequently . . . . . . . N
Update Allowed . . . . . . . . . . Y
F1=Help F10=Update F12=Cancel F13=Services F24=More Keys
Communications Setup Using Communications
4 - 18 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Protocol
Valid values are: SNA, BSC, LU0, GMC, L62, X62, ASC, XAS, FTP, OFA, OFX, ASX.
# NOTE
Please note that LU62 (for L62/X62), Async (for ASC, XAS, OFA, OFX, and ASX), and
FTP are optional add-on modules that may be purchased separately.
The following table lists the valid protocols and their configurations.
The configuration panel that will be used will differ based on the specified protocol. SEE
the Using Scripts chapter in this guide for sample profile definitions for well-known
communication products.
Protocol
Specified Configuration Used
SNA SNA LU1 profile will be used.
The SNA specification should be used when communicating with
Connect:Supertracs (SNA), Connect:Tracs for MVS (SNA), JES2, and
JES3 using SNA LU1.
BSC Bisync profile will be used
LU0 Should be used when communicating with Advantis CICS SNA LU0
GMC Bisync profile with GM-specific header information will be used
L62 SNA LU6.2 SDLC/APPC profile will be used
X62 SNA LU6.2 SDLC/APPC profile running over an X.25 line will be
used
ASC Asynchronous profile will be used
XAS Asynchronous profile running over an X.25 line will be used
FTP FTP profile using customer’s existing TCP/IP configuration will be
used
OFA OFTP profile using an async line will be used
OFX OFTP profile using an X.25 line will be used
ASX XMODEM profile using an async line will be used
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 19
Days to Purge
A 3-position numeric field used to indicate the number of days for automatic purge option.
Use spaces or 999 or 000 to bypass the automatic purge function.
When auto purge is enabled, the following files will be purged of any data retained longer
than the Days to Purge specified at the conclusion of a communication session for the
comm profile ID:
Communication History
Inbound Queue Control File
Outbound Queue Control File
Inbound Queue Data File
Outbound Queue Data File
If the Days to Purge field contains a value other than 999, 000, or blanks, then the
automatic Purge All Communication Files (communication PRGALLA) command is
executed at the end of every communication session performed for the comm profile ID.
)RECOMMENDATION
Set this value to 999 or 000 or leave it blank to deactivate the automatic purge procedure.
Data can be purged during “off-hours” independent of the communication sessions, using the
other purge commands available.
# NOTE
Auto purge and continuous processing cannot be selected at the same time.
FIFO/LIFO (Mandatory)
A 1-position alphanumeric field that identifies the order in which batches are sent from the
Outbound Queue during a Comm session – in either FIFO (first in, first out) or LIFO (Last
in, first out) sequence.
)RECOMMENDATION
Set this value to F (FIFO) to ensure the data is sent in the order in which it was processed.
This maintains the sequence of Control numbers generated for the envelopes.
Used Most Frequently
This flag is used for online display purpose only. To display a sublist of communication
profile IDs used most often, set this flag to ‘Y’ and then sort to that field on the Work with
Communication panel (EDIX400) or permanently in the Syste Config Menu
(GENSYSCFG) by selecting option 22, Set W/W Communications Sort Option
(SETCOMMSRT).
Update Allowed
A 1-position alphanumeric field defining whether or not the communication information
for this Profile ID can be updated and maintained by users with a security level of “2.”
Valid values are Y – yes, and N – no.
Communications Setup Using Communications
4 - 20 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Set Protocol-Specific Parameters for a Communication Profile
The configuration panel for the comm profile will vary depending on the protocol specified. The
specific fields presented will be the parameters required by the protocol being used. For additional
information on these fields, see the online help (F1). The following example depicts a BSC
protocol. Some protocols support a novice setup panel to aid in “quick” changes to the
configuration information. These panels are referred to as “basic” views. They provide a
simplified configuration process requiring fewer parameters and providing more standard default
values automatically, requiring you to do less input.
Each time a new BSC (or other protocol that supports basic views) profile is created, the basic
view will be shown first. If the basic configuration values are not sufficient, you can toggle to an
extended view by pressing F2 (More/Less). The extended view enables you to change additional
parameters.
# NOTE
Hint: Your next session will begin in the mode from which you last exited. If you have been
working in extended view, and prefer to begin sessions in basic view, toggle back to basic
view by pressing F2 (More/Less) before exiting from a session.
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 21
Both basic and extended view panels are shown in Figure 4.7.
Figure 4.7 Basic and extended view of Communication Profile panel
(EDIX401-FMT03 and EDIX401-FMT02)
Enter or change the desired information and press Enter or F8 (Next) to advance to the
Line/Control/Device panel. If you do not want to change any of the default settings that are shown
in Figure 4.8, press F10 (Update) to create the profile and return to the Work with
Communications panel (EDIX400-FMT01).
Field Definitions (Basic View)
Comm Profile ID
An 8-position alphanumeric field used to enter the Profile ID.
Company (Protected)
Displays the direct communication partners company name.
EDIX401 Communication Profile EDI 04/30/08
FMT03 BSC 12:00:00
Comm Profile ID. . . . . . . . . . CN3BSC
Company. . . . . . . . . . . . . . COMMERCE:NETWORK RELEASE3
Modem Port . . . . . . . . . . . . LIN021
Dial . . . . . . . . . . . . . . . 18006275883
EDIX401 Communication Profile EDI 04/30/08
FMT02 BSC 12:00:00
Comm Profile ID. . . . . CN3BSC
Company. . . . . . . . . COMMERCE:NETWORK RELEASE3
Modem Port . . . . . . . LIN021 Retries. . . . . . . . 02
Switched Line. . . . . . Y (Y/N) Auto Dial. . . . . . . Y (Y/N)
Auto Call Unit . . . . . V Auto Call Port . . . .
Dial . . . . . . . . . . 18006275883
Host ID Verify . . . . . N (Y/N) Duplex . . . . . . . . *FULL
Local Site ID. . . . . .
Record Size. . . . . . . 0080 Block Size . . . . . . 0512
Inter-Record Separator . 3780
Transparency . . . . . . N (Y/N)
Blank Compress . . . . . N (Y/N)
Trailing Blank Trunc . . N (Y/N) Remote Cmd Password. . *NONE
F1=Help F2=More/Less F4=Prompt F10=Update F12=Cancel F24=More Keys
Prompt function not defined for field (CPFDUP)
F2=More/Less function key
for basic and extended view
Communications Setup Using Communications
4 - 22 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Modem Port
A 6-position alphanumeric field specifying the iSeries Resource Name associated with the
communication port to be used with this profile. The port named by this field must be
attached to communication hardware that is compatible with the rest of the entries made
on this panel.
Dial
A 32-position alphanumeric field used to define the phone number to be passed to the
autodialer or modem, or it may be displayed to the operator’s console if manual dial is
used. This field may also contain control characters.
# NOTE
When manual dial is used, the number to be dialed must be present. Omitting the number will
cause an assumed Auto answer configuration by the system and outgoing calls will fail.
Field Definitions (Extended View)
Retries
A 2-position numeric field used to define the number of dial retries you permit your
system to attempt before it discontinues dialing the Remote ID. Valid values are 00
through 99.
Switched Line
A 1-position alphabetic field used to designate whether or not a switched line will be used
(as opposed to a dedicated line) for remote communication.
Auto Dial (Required for Auto Call)
A 1-position alphabetic field used to designate whether or not the auto dial feature will be
used for remote communication. If “N,” this indicates that you will be MANUALLY
dialing or auto answering for sessions that use this communication profile ID. Auto Dial
may be specified for self-dialing modems or separate modems/auto dial units.
Auto Call Unit
A 1-position alphabetic field used to designate whether or not an auto call device will be
used for remote communication. If Y (use Auto Call Unit) is designated, an Auto Call Port
must also be entered. If N, do not enter an Auto Call Port. A value of N must be selected
when using a self-dialing modem (a modem with its own autodial capabilities). Valid
values are:
Y 801 Auto Call Unit on a second port.
V V25BIS Autodialing Modem.
N UDS201C/D or UDS208B/D self-dialing Bisync modem (or compatible), or if
auto dial also equals N, manual dial or Auto Answer is used.
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 23
Auto Call Port (Required for use with Auto Call)
A 6-position alphanumeric field used to define the auto call port of the auto call unit. If the
Auto Call feature is selected, an auto call port must be designated. Format is “LINXX2” or
“CMNX2”, where XX is the communication Port ID, and 2 is a literal “2,” representing
the second line on that port. The Auto Call Port must be the second line on the same port
that the modem is connected to. This field is not used for self-dialing modems.
To configure dialing or answering modes, set parameters accordingly in the Switched
Line, Auto Call, and Auto Dial fields in Extended View mode. The following chart lists
the values for each parameter and each dial setting.
Host ID Verify
A 1-position alphabetic field used to designate whether or not the Host ID Verify feature
will be used for remote communication. This feature provides the capability to verify an
Exchange ID function between your system and the remote site’s system. The Host ID
Verify is often referred to as the Exchange ID function or “handshake.” If this field
contains a Y, the Local Site ID field must contain the code value expected by the remote
site.
Duplex (Required)
Determines the duplex setting that will be used on the line description that is created. The
value may be either *FULL or *HALF and must correspond to the modem that is being
used. The default response is *FULL and is appropriate for most v.25bis dial, autoanswer,
and leased line configurations. Some older hardware may require *HALF duplex.
Local Site ID (Required for use with Host ID Verify)
A 15-position alphanumeric field used to define the name or identification code of the
Local ID Verifier that you expect to send to the Remote Site location when initiating a
communication session. This field is required if a value of Y exists in the “Host ID Verify”
field.
Dial Settings
Field Names Two-Port
Autodial
One-Port
Non-V.25bis
Autodial
Manual Dial
One-Port
V.25bis
Autodial
Auto
Answer
Switched Line YYYYY
Auto Dial YYNYN
Auto Call Unit YNNVN
Auto Call Port Include an
entry
Leave blank Leave blank Leave blank Leave
blank
Phone Number Include an
entry
Include an
entry
Include an
entry
Include an
entry
Leave
blank
Communications Setup Using Communications
4 - 24 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Record Size
A 4-position numeric field used to indicate the maximum record size to be transmitted
from or received to a user specified file or to the Gentran:Server for iSeries data queues.
Data received to the print spool is excluded from the normal rules used to handle incoming
data streams, and should not be used as a factor in calculating record or block sizes. Data
sent from or received to Gentran:Server may use any record size between 1 and 4096, as
long as the record size is not greater than the block size.
Block Size
A 4-position numeric field used to define the maximum block size of data that your system
may send to a remote network. Valid values are 80 through 4096. Accepted industry
standards are:
“400” for 2780
“512” for 3780
Block Size dictates the maximum block size to be transmitted or received during a
communication session. When none is selected for the inter-record separator field on this
panel, it is assumed that all data received will have a record size equal to the block size
specified.
Inter-Record Separator
A 4-position numeric field used to define the inter-record separator number of a character
used by the system to separate records.
Valid values are 3780, 2780, or NONE, where 3780 represents HEX 1E, and 2780
represents HEX 1F.
The selection of NONE for the Inter-Record Separator field on this panel has an effect on
the way the records are handled during a communication session. When this option is
selected, it will cause the record sizes to appear equal to the block size selected. When a
record size of 80 has been selected, but the inter-record separator is set to NONE the block
will be filled with as many full 80-byte records as can be placed into the block with no
record separators. It will appear as though the actual record size is much larger than 80.
When the records are placed into the block, one record is moved to the block, and the
remaining space is calculated. When there is not enough space to fit another full record
into the block, the end of the block will be marked and it will be transmitted. When the
block size is evenly divisible by the record size, the block size and the record size will be
the same. As an example, the record size is set to 80, the block size is set to 400, the
inter-record separator is set to NONE – five 80-byte records will be placed into the block
(5 X 80=400), and with no record separators. The block will be transmitted as a 400-byte
block containing one 400-byte record. When the block size is not evenly divisible by the
record size, the block size and the record size will be equal to the number of whole records
that will fit into the block size, multiplied by the record size. As an example, the record
size is set to 100, the block size is set to 512, and the inter-record separator is set to NONE.
Five 100-byte records will be placed into the block (5 X 100=500). No more full records
will fit into the block, so the end of the block is marked and the block is sent with both the
record and the block size equal to 500.
If Inter-Record Separator: 2780 (Hex 1F) is selected, only Transparency is valid.
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 25
Transparency
A 1-position alphabetic field used to designate whether or not the Transparency feature
will be used for remote communication. This feature enables you to transmit codes (i.e.,
control characters) without interfering with the communication. The codes remain
“transparent” to the system. This option must be set to Y if the Remote System will be
sending transparent data.
Blank Compress
A 1-position alphabetic field used to designate whether or not the Blank Compress feature
may be used for remote communication. This feature automatically compresses blanks as
they exist in the communicated raw data. This option must be set to Y if the Remote
System will be sending compressed data.
Trailing Blank Trunc
A 1-position alphabetic field used to designate whether or not the Trailing Blank
Truncation feature will be used for remote communication. This feature automatically
truncates all blanks as they exist at the end of each record sent to the remote site.
# NOTE
The options for Transparency, Blank compress, and Trailing Blank Truncation are mutually
exclusive and only one of the options may be used at a time.
Remote Cmd Password
Defines the optional password that will be used to validate commands received from the
remote system, while in Remote Command mode. The specified value must be received as
the password parameter of the remote command. If the correct password is not received,
the communication session will be terminated. The default *NONE, specifies that no
password is required.
# NOTE
An option called the Global Inactivity Timer, which is an option for setting a global inactivity
timer for BSC (which operates like receive timer for SNA), is available by issuing the
command SETTIMER. The data is numeric, 6 positions with an HHMMSS
(Hours/Minutes/Seconds) format. Once the timer is set, it is used by all BSC profiles. This
may be changed at any time. The default time is 5 minutes as shipped. The global receive
timer is checked for all receive steps that do not contain a receive timer value on the script
record.
Communications Setup Using Communications
4 - 26 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Set Line/Controller/Device Descriptions for a Communication Profile
# NOTE
The Line/Controller/Device panel (EDIX819-FMT01) can also be accessed later by selecting
option 11 from the Work with Communications panel (EDIX400-FMT01).
By default, the system creates the line, controller, and device descriptions when you create or
modify a comm profile. This is most helpful when the connection is through a dial-up line.
The Communication Line/Controller/Device panel (EDIX401-FMT20), as shown in Figure 4.8,
allows you to override the default names for the line, controller, and device descriptions or to
override the automatic creation of some of these objects if you have a protocol of SNA LU0, X62,
XAS, or OFX.
Figure 4.8 Communications Line/Controller/Device Panel (EDIX401-FMT20)
Modify the desired information and press F10 (Update). When the profile is updated, the system
creates the associated line, controller, and device descriptions on the iSeries. These objects are
required to perform communication sessions. To exit without updating information, press F12
(Cancel).
The names for the line, controller, and device descriptions are generated automatically by using
the comm profile ID concatenated with a two-byte identifier for the line (LN), controller (CT), and
device (DV).
When the connection is to be made over an existing leased line, a compatible line may already
exist.
For SNA, LU0, and L62 protocols, you may want to prevent the line and controller descriptions
from being created if you are using a leased line that may be shared with other devices. To do this,
type N in the Create Line/Controller field. If N (No) is specified, only the device description is
created.
EDIX819 Communication Line/Control/Device EDI 04/30/08
FMT01 12:00:00
Comm Profile ID. . . . . . . . . . CN3BSC
Company. . . . . . . . . . . . . . COMMERCE:NETWORK RELEASE3
Create Line/Controller . . . . . . Y
Line Name. . . . . . . . . . . . . CN3BSCLN
Controller Name. . . . . . . . . . CN3BSCCT
Device Name. . . . . . . . . . . . CN3BSCDV
Remote Location. . . . . . . . . . CN3BSC
F1=Help F4=Prompt F5=Refresh F10=Update F12=Cancel F24=More Keys
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 27
For X62, XAS, and OFX protocols, you may want to prevent the line description from being
created if you are making a connection over an existing X.25 line. To do this, type N (No) in the
Create Line field. If N (No) is specified, only the controller and device descriptions are created.
After you have successfully created a communication profile, you must create a communication
session control script.
Communications Setup Using Communications
4 - 28 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Communications Session Control Scripts
The session control script defines the conversation two systems conduct over the communications
line. Session Control records are the detailed instructions for conducting a communication session.
One or more session control records may be combined to form a session control script. The script
consists of the step-by-step instructions that control how the transmission and/or reception of data
will take place. An example of a script name is SR (Send first, then receive).
The concept is much the same as a telephone conversation between two people. The most notable
difference is that during a phone conversation, people have the ability to “sense” when another
person has finished saying what is necessary. For example, when a friend calls and asks “How was
your day?”, the friend doesn’t have to tell you that there’s nothing more to say or that it’s your turn
to talk. Machines, unfortunately, are not that smart. When a machine sends a message to another
machine, it must indicate that it has finished “speaking” by sending special protocol characters.
Figure 4.9 depicts a telephone conversation between two people and the relationship between two
computers using the script.
Figure 4.9 Script Conversation Example
People Machines
Cliff Marty iSeries Partners Computer
Start Communications
using STRCOMSSN
Software running
awaiting call
Dials Answers Dials (per Profile)
(begins script)
Answers
<-Hello <- Partner’s logon screen
Marty, it’s Cliff. -> Logon and password ->
<- Hi, Cliff. <- Welcome to your
Partner’s Network
How about going to
lunch today at 11:45?
-> Purchase Orders ->
<- Sounds good. Meet
me in the lobby.
<- Acknowledgment
report from your
Partner’s Network
OK Marty. See you
later, bye.
-> Logoff command ->
Hangup Hangup Disconnect Disconnect
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 29
Gentran:Server provides the capability to create one or more scripts that are associated with each
comm profile. Each script for a given profile is identified by a two-character Session Name and
may contain up to 999 session control records. This Session Name is used in conjunction with the
comm profile ID to execute a communication session.
Figure 4.10 Work with Communications Panel (EDIX400-FMT01)
To access session control scripts, type 12 (Session Ctrl) in the option field next to the desired
comm profile ID and press Enter, as shown in Figure 4.10. To access scripts for all profiles, type
12 on the key entry line and press Enter.
EDIX400 Work with Communications EDI 04/30/08
FMT01 pgmlib: G3X5PGM dtalib:G3X5DTA 12:00:00
Position to Profile ID . . . . . . CN3BSC
Type option (and Information), press Enter.
12=Session Ctrl 13=Jobs 14=History Log 15=Outb Queue 16=Inb Queue
Opt Profile ID Company
12 CN3BSC COMMERCE:NETWORK RELEASE3
CN3SNA COMMERCE:NETWORK RELEASE3 SNA
DEFAULT STERLING DEFAULT
DOCDEMO this is a demo web comm profile
EIROFTP INS LTD OFTP via EIRPAC Async PAD
EIROFTPX INS LTD OFTP via EIRPAC X.25
EVAL STERLING COMMERCE RELEASE3
FORD FORD SOLMIS NETWORK
GEIS GENERAL ELECTRIC INFO SYSTEMS
More...
Parameters or command
===>
F1=Help F3=Exit F12=Cancel F15=Sort F23=More Options F24=More Keys
Communications Setup Using Communications
4 - 30 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Work with Session Control Scripts
The Work with Communications Session panel (EDIX402-FMT01), shown in Figure 4.11,
enables you to add, update, copy, delete, and view the session control scripts for a specified
Communications Profile ID. The “script” contains action data that is used to control the sessions
initiated for each profile.
Figure 4.11 Work with Communications Sessions Panel (EDIX402-FMT01)
To select a session control script, type 2 in the option field next to the desired session name and
press Enter. When creating a script, type 1 and a Session Name on the key entry line and press
Enter.
# NOTE
The first character of the session name cannot be numeric.
The Communication Session panel (EDIX403-CTL01) appears, as shown in Figure 4.12.
# NOTE
Sometimes it is easier to copy an existing script than to build a new one. (SEE the section
“Copying Communications Scripts” later in this chapter for more information.)
EDIX402 Work with Communications Session EDI 04/30/08
FMT01 12:00:00
Position to Session Name . . . . . For CN3BSC
Type option (and Information), press Enter.
1=Create 2=Revise 3=Copy 4=Delete 5=View 6=Print 30=Start Session
Opt SN Company
RA COMMERCE:NETWORK RELEASE3
RD COMMERCE:NETWORK RELEASE3
RR COMMERCE:NETWORK RELEASE3
SO COMMERCE:NETWORK RELEASE3
2 SR COMMERCE:NETWORK RELEASE3
ST COMMERCE:NETWORK RELEASE3
Bottom
Parameters or command
===>
F1=Help F3=Exit F4=Prompt F12=Cancel F15=Sort F24=More Keys
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 31
Session Control Maintenance
A record exists for each action (command) that occurs when communicating with a remote site.
You can display these “command lines” for each session, or use the unfolded view to see the
“control data lines” as well.
Press F9 (Fold/Unfold) to toggle between the basic and extended views.
Figure 4.12 Folded and Unfolded Views of the Communication Session Control Panel
(EDIX403-CTL01)
EDIX403 Communication Session Control EDI 04/30/08
CTL01 12:00:00
Comm Profile ID. . . . . . . . . . CN3BSC
Session Name . . . . . . . . . . . SR
Company. . . . . . . . . . . . . . COMMERCE:NETWORK RELEASE 3
Type option, press Enter.
3=Copy Seq# 4=Delete 11=Extended Parms
Opt Seq No Tran File File Name Ind Description
20 C 0 SEND REQUEST FOR REPORTS
$$REQUEST ID=SX999R BATCHID='TEST'
30 C 0 SEND REQUEST FOR X12 DATA
$$REQUEST ID=SX999D BATCHID='TEST'
40 C 0 SEND $$ADD RECORD
$$ADD ID=SX999D BATCHID='TEST'
50 S OQ 2 SEND X12 DATA FROM OUTQUE
60 R SP 7 RECEIVE REPORTS TO SPOOL
*** ERROR *** NO BATCHES FOR TRANSMISSION
More...
F1=Help F4=Prompt F9=Fold/Unfold F10=Update F12=Cancel F24=More Keys
EDIX403 Communication Session Control EDI 04/30/08
CTL01 12:00:00
Comm Profile ID. . . . . . . . . . CN3BSC
Session Name . . . . . . . . . . . SR
Company. . . . . . . . . . . . . . COMMERCE:NETWORK RELEASE 3
Type option, press Enter.
3=Copy Seq# 4=Delete 11=Extended Parms
Opt Seq No Tran File File Name Ind Description
20 C 0 SEND REQUEST FOR REPORTS
30 C 0 SEND REQUEST FOR X12 DATA
40 C 0 SEND $$ADD RECORD
50 S OQ 2 SEND X12 DATA FROM OUTQUE
60 R SP 7 RECEIVE REPORTS TO SPOOL
70 R IQ 7 RECEIVE X12 DATA TO INQUE
More...
F1=Help F4=Prompt F9=Fold/Unfold F10=Update F12=Cancel F24=More Keys
Communications Setup Using Communications
4 - 32 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
The creation of script records is protocol-specific. However, many general characteristics are
applicable to all protocols. The following information describes the general concepts. For specific
information, see the chapter for the protocol you are using.
Field Definitions
Seq No
A 3-position numeric field used to define the sequence number assigned by the user to
each protocol session record.
Leaving gaps between sequence number assignments may be useful for inserting
additional control records at a later time.
Tran
A 1-position alphabetic field used to define the transaction type code identifying the type
of record displayed. Valid values are:
CSend the literal that is entered in the control data line. For example,
this can be used for sending signon cards or other control data that is
required by the remote.
SSend data to the remote site followed by any special characters as
instructed by the indicator field.
RReceive data from the remote system.
DWait to receive a literal as specified on the control data line. This
transaction type can be used for verification of incoming data or for
trapping and discarding prompt messages.
ESend an Evoke Record to the Remote System. This must be the first
record of the script. This code is only used if your system starts the
session and is valid only for the X62, L62, and XAS protocols. Use
the F16=Evoke Record Maint key to access the Evoke Record
Maintenance panel.
XInvoke extended script logic functions.
File
A 2-position alphabetic field used to define the file type code that identifies the type of file
that the transaction record is written to. Valid values are as follows:
OQ Outbound Queue; only valid for Tran Type S.
OM Outbound Multiple; only valid for type S.
Sends the outbound data in such a way that individual batches can be
separated as they are received by the remote. This function is
complementary to IM, which is defined below.
OF Outbound File; only valid for Tran Type S.
IQ Inbound Queue; only valid for Tran Type R.
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 33
IM Inbound Multiple; only valid for type R.
Receive inbound data so that individual batches can be separated as
they are received by your system. This function is complementary to
OM, which is defined above.
IF Inbound File; only valid for Tran Type R.
“IF” (Inbound File) receive to an inbound user file and overwrite all
existing data in the file.
IA Inbound Append; Append to existing data in user file.
ID Inbound Device; only valid for Tran Type R and BSC sessions.
Received data is sorted to the inbound queue or to the spool file based
on the device selection codes that precede the data during the receive
process.
SP Spool File; only valid for Tran Type R.
JR JES Receive; only valid for Tran type R and SNA sessions. Print data
will be sent to the spool and punch data will be stored on the
Gentran:Server for iSeries inbound queue.
JQ JES Queue; only valid for Tran Type R and SNA sessions. All data
received from JES is placed on the Gentran:Server for iSeries
inbound queue.
File Name (Required for File Types OF, IF, and IA)
A 10-position alphanumeric field used to enter the name of the file where inbound and
outbound data will be stored. The file must exist in a library, in the library list used by the
Gentran:Server job because the file must be retrieved before the data can be sent or
received from the remote network.
Ind
A 1-position numeric field used in conjunction with the transaction type to indicate what
processing will be done. Refer to the tables at the end of this section to determine the
allowed values for specific transactions. These values will differ based on the protocol
used.
Description
A 30-position alphanumeric field used to document the session protocol record.
Communications Setup Using Communications
4 - 34 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Comm Session Control — Extended Parameters
There are additional fields, collectively referred to as “extended parms,” that provide complete
flexibility and are available for each script record. These fields include Batch ID, Receive Timer,
Timeout Continue flag, and Timeout Status flag.
Figure 4.13 Communications Session Control Panel (EDIX403-CTL01)
To access the extended parameters, type 11 (Extended Parms) next to the selected script records
(from either folded or unfolded view) and press Enter, as shown in Figure 4.13.
The Communication Session Control panel (EDIX43B-FMT01) appears, as shown in Figure 4.14.
It can be used to edit a session control record in hex, simplifying the construction of script records
that require nondisplayable characters. Additional parameters may be used to control the script
processing, such as Receive Timer and Timeout flags.
# NOTE
Due to the uniqueness of each implementation, the predefined Communication scripts are
provided as examples only and are intended to assist in getting you started. Please read the
User Guide provided by your value-added network or communication partner to ensure that
the setup correctly reflects their specific requirements.
EDIX403 Communication Session Control EDI 04/30/08
CTL01 12:00:00
Comm Profile ID. . . . . . . . . . CN3BSC
Session Name . . . . . . . . . . . SR
Company. . . . . . . . . . . . . . COMMERCE:NETWORK RELEASE 3
Type option, press Enter.
3=Copy Seq# 4=Delete 11=Extended Parms
Opt Seq No Tran File File Name Ind Description
20 C 0 SEND REQUEST FOR REPORTS
30 C 0 SEND REQUEST FOR X12 DATA
11 40 C 0 SEND $$ADD RECORD
50 S OQ 2 SEND X12 DATA FROM OUTQUE
60 R SP 7 RECEIVE REPORTS TO SPOOL
70 R IQ 7 RECEIVE X12 DATA TO INQUE
More...
F1=Help F4=Prompt F9=Fold/Unfold F10=Update F12=Cancel F24=More Keys
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 35
Figure 4.14 Comm Session ControlExtended Parms Panel with Character/Hex Views
To toggle between the character and hex display of the command, press F2 (Hex On/Off). Make
the desired changes and press F10 (Update). The record is updated and you are returned to the
Communication Session Control panel (EDIX403-FMT01).
Optionally, you can continue editing script records from the Extended Parms panel
(EDIX43B-FMT01) by pressing F16 (Record-1) or F17 (Record+1), which advances you to the
next session control record after updating the modified record.
EDIX43B Communication Session Control EDI 04/30/08
FMT01 12:00:00
Comm Profile ID. . . . . . . . . . CN3BSC
Session Name . . . . . . . . . . . SR
Company. . . . . . . . . . . . . . COMMERCE:NETWORK RELEASE 3
Sequence Number. . . . . . . . . . 40
Transaction Code . . . . . . . . . C
File . . . . . . . . . . . . . . .
File Name. . . . . . . . . . . . .
Indicator. . . . . . . . . . . . . 0
Description. . . . . . . . . . . . SEND $$ADD RECORD
Command: (Top Line CHAR, Bottom Lines HEX)
$$ADD ID=SX999D BATCHID='TEST'
55CCC4CC7EEFFFC4CCECCCC77ECEE744444444444444444444444444444444444444444444444444
BB144094E27999402133894ED3523D00000000000000000000000000000000000000000000000000
Batch ID . . . . . . .
Receive Timer. . . . . 0000 (MMSS)
Timeout Continue . . . Timeout Status . . . .
F1=Help F2=Hex On/Off F4=Prompt F10=Update F12=Cancel F24=More Keys
EDIX43B Communication Session Control EDI 04/30/08
FMT01 12:00:00
Comm Profile ID. . . . . . . . . . CN3BSC
Session Name . . . . . . . . . . . SR
Company. . . . . . . . . . . . . . COMMERCE:NETWORK RELEASE 3
Sequence Number. . . . . . . . . . 40
Transaction Code . . . . . . . . . C
File . . . . . . . . . . . . . . .
File Name. . . . . . . . . . . . .
Indicator. . . . . . . . . . . . . 0
Description. . . . . . . . . . . . SEND $$ADD RECORD
Command:
$$ADD ID=SX999D BATCHID='TEST'
Batch ID . . . . . . .
Receive Timer. . . . . 0000 (MMSS)
Timeout Continue . . . Timeout Status . . . .
F1=Help F2=Hex On/Off F4=Prompt F10=Update F12=Cancel F24=More Keys
Communications Setup Using Communications
4 - 36 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Extended Parameter Field Definitions
# NOTE
SEE the field definitions under “Session Control Maintenance” for descriptions of the basic
parameter fields.
Command
This 80-position alphanumeric and/or hexadecimal field is used to edit and display session
Command records. The command record is used for several purposes depending on the
Transaction Type of the script record in which the Command record appears:
The Command field on the EDIX43B panel has a “hex mode” that can be toggled on and
off by pressing the F2=Hex On key. When hex mode is off, the field allows entry of
alphanumeric data, just like the Command fields on the unfolded view of the EDIM403
panel. When hex mode is on, the field also allows entry of hexadecimal data. The panel
will initially be displayed with hex mode off. For more information, see Hex Mode
Command Editing.
Batch ID
This 44-position alphanumeric field is used to specify the Batch ID of the data that is
being sent or received. For send commands, Batch ID will be used to select the data that
will be transmitted from the outbound queue. For receive commands, data that is received
to the inbound queue will be assigned the Batch ID that has been specified. When Batch
ID is left blank, the system interprets the value as meaning that no particular Batch ID has
been assigned.
Receive Timer
This four-position numeric field is used in receive steps and data traps to specify the
length of time that the system will wait for data to be received before considering it a
timeout. This allows varying timeout periods to be specified for individual steps within a
communication script. If this field is left blank or filled with zeros, then the receive timer
value for this step will automatically be copied from one of two places; BSC profiles will
take the value from the system-wide bisync timer (accessed via the SETTIMER command),
and the SNA profiles will take the value from the Inactivity Timer field within the
EDIM818 Communication Profile Maintenance panel. Valid values for this field are
0000 9999. The default is 0000. (The units are MMSS, minutes/seconds).
Timeout Continue
This one-position alphanumeric field specifies the action that the system is to take if a
receive timeout occurs in this script step. If the Timeout Continue field is set to Y, then
script execution will continue with the next step. This is the default. If the Timeout
Continue field is set to N, then script execution will terminate.
Timeout Status
This one-position alphabetic field specifies the batch status that is to be assigned to the
data that has been received to the inbound queue during this script step, in the event that a
receive timeout occurs in this step. Valid values are N to mark the data Received Normal,
or A to mark the data Received Abnormal. The default value is N.
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 37
Hex Mode Command Editing
The EDIM43B hex mode Command editor allows for the entry of nondisplayable data within the
session Command field. This capability may be necessary for the construction of certain
communication scripts, such as those for remotes that are not based on the EBCDIC character set.
This can also be useful when constructing scripts for international communication, where
differences in language, keyboards, and display devices could present barriers to the entry of valid
Command data if a character-only input field was used.
The hex mode editor can be toggled on and off by pressing the F2=Hex Mode key. When hex
mode is active, two additional lines of data will be displayed immediately below the Command
field. These lines will contain the hexadecimal values that represent the character appearing above
them in the top line of the Command input field. For example, the Command data LOGON
SUCCESSFUL would appear as:
COMMAND:
LOGON SUCCESSFUL______________________________________________
DDCDD4EECCCEECED4444444444444444444444444444444444444444444444
36765024335226430000000000000000000000000000000000000000000000
where the first character, L, is represented by the hexadecimal value D3, which is displayed
directly below the character, with the high-order hex digit D on the second line, and the low-order
hex digit 3 on the third line. Continuing, O is represented by hex D6, G is represented by hex C7,
etc.
When the Command record contains nondisplayable characters (values below hex 40), the period
character (“.”) will be displayed in the first line (character representation) of the Command field.
For example, the Command data shown above is followed by the carriage return (hex 0D) and
newline (hex 15) characters. The display would appear as:
COMMAND:
LOGON SUCCESSFUL..____________________________________________
DDCDD4EECCCEECED0144444444444444444444444444444444444444444444
3676502433522643D500000000000000000000000000000000000000000000
To use the hex mode Command editor in an Add or Update operation, first use the F2=Hex Mode
key to activate hex mode. Then enter session control data as necessary. In the Command field,
enter character data on the first line, and/or hexadecimal data on the second and third lines. Press
ENTER to redisplay or F10 to add or update the current script record and display the updated
record. Note that using F16 or F17 to move to previous or next record will also execute an update.
Both character data and hex data can be entered at the same time. However, if both the character
and hex values are changed for the same byte within the Command record, the hex changes will
take precedence. If invalid data (characters other than 0 – 9 and A – F) is entered in the hex portion
of the input field, then the value from the character portion of the input field will be used.
# NOTE
The use of the INSERT and DELETE keys may cause unexpected results when editing with
hex mode on, or when editing records that contain nondisplayable characters with hex mode
off. The use of these keys is not supported.
Communications Setup Using Communications
4 - 38 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Network Scripts
Gentran:Server supplies predefined session control scripts for the major EDI networks. These
scripts need to be modified with your network identifiers, such as the Mailbox ID and password,
before they can be used for a communication session.
There are two methods for updating the predefined scripts:
Manually edit the necessary session control records in each script defined for the comm profile
Automatically update all scripts for a designated comm profile ID (only network profiles can
be updated automatically)
Manually Update Network Scripts
This section identifies the information that needs to be manually changed for each of the
predefined scripts. Script examples are included for the comm profiles shown in the following
table.
# NOTE
Due to the uniqueness of each implementation, the predefined Communication scripts are
provided as examples only and are intended to assist in getting you started. Please read the
User Guide provided by your value-added network or communication partner to ensure that
the setup correctly reflects their specific requirements.
Comm Profile ID Network Name
ADVBSC Advantis Network (BSC)
ADVLU0 Advantis Network (SNA/LU0)
ATTEASY AT&T EasyLink Network
ATTUK AT&T in the United Kingdom
BTASC British Telecom United Kingdom (ASC)
BTUK British Telecom United Kingdom (BSC)
BTXAS British Telecom United Kingdom (XAS)
CN2BSC Commerce:Network Release 2 Network (BSC)
CN3BSC Commerce:Network Release 3 Network (BSC)
CN3SNA Commerce:Network Release 3 (SNA)
GEIS GE Information Services
KLEIN Kleinschmidt Network
MCIBSC MCI (BSC)
SEARS Sears Information Services
TRANS Transettlements
WSUN Western Union
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 39
# NOTE
If you wish to communicate with a public network not included in this list, contact Product
Support. A technical support person can assist you in building and testing communication
scripts for other networks. To establish custom scripts for communicating with specific
partners, SEE the “Exercise: Creating a Direct Communication Partner” in this chapter.
In the following section, refer to the appropriate Network Profile example for your system’s
configuration.
Advantis BSC (Comm Profile ID: ADVBSC)
Session Names
Contact the Advantis Network to obtain User ID, password, and account information, and replace
the values on the specified Record Sequences as follows:
RA (Receive All)
Replace ACCT with the Account Number on Record Seqs 015 and 025.
Replace USRID with the User ID on Record Seqs 015 and 025.
Replace PSWD with the Password on Record Seqs 015 and 025.
SO (Send Only)
Replace ACCT with the Account Number on Record Seqs 015 and 025.
Replace USRID with the User ID on Record Seqs 015 and 025.
Replace PSWD with the Password on Record Seqs 015 and 025.
SR (Send Receive)
Replace ACCT with the Account Number on Record Seqs 015 and 025.
Replace USRID with the User ID on Record Seqs 015 and 025.
Replace PSWD with the Password on Record Seqs 015 and 025.
Figure 4.15 Session Control for Comm Profile ID: Advantis (ADVBSC)
EDIX403 Communication Session Control EDI 04/30/08
CTL01 12:00:00
Comm Profile ID. . . . . . . . . . ADVBSC
Session Name . . . . . . . . . . . RA
Company. . . . . . . . . . . . . . IBM INFORMATION NETWORK
Type option, press Enter.
3=Copy Seq# 4=Delete 11=Extended Parms
Opt Seq No Tran File File Name Ind Description
5 C 2 SEND EXCHANGE I.D.
RJE2
10 R SP 7 RECV IBM INFO NETWORK LOGO
15 C 2 SEND IBM LOGON
/*L ACCT,USRID,PSWD/*S EDIRECT/*U BSCEDI
20 R SP 7 RECV WELCOME MESSAGE
25 C 2 SEND INFO EXCHANGE LOGON
IELOGON ACCOUNT(ACCT) USERID(USRID) PASSWORD(PSWD);
More...
F1=Help F4=Prompt F9=Fold/Unfold F10=Update F12=Cancel F24=More Keys
Communications Setup Using Communications
4 - 40 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Advantis LU0 (Comm Profile ID: ADVLU0)
Session Names
Contact the Advantis Network to obtain User ID, password, and account information, and replace
the values on the specified Record Sequences as follows:
RA (Receive All)
Replace ACCT with the Account Number on Record Seqs 010 and 050.
Replace USRID with the User ID on Record Seqs 010 and 050.
Replace PSWD with the Password on Record Seq 010.
SO (Send Only)
Replace ACCT with the Account Number on Record Seqs 020 and 050.
Replace USRID with the User ID on Record Seqs 020 and 050.
Replace PSWD with the Password on Record Seq 020.
SR (Send Receive)
Replace ACCT with the Account Number on Record Seqs 010 and 040.
Replace USRID with the User ID on Record Seqs 010 and 040.
Replace PSWD with the Password on Record Seq 010.
Figure 4.16 Session Control for Comm Profile ID: Advantis (ADVSNA)
EDIX403 Communication Session Control EDI 04/30/08
CTL01 12:00:00
Comm Profile ID. . . . . . . . . . ADVSNA
Session Name . . . . . . . . . . . RA
Company. . . . . . . . . . . . . . IBM INFORMATION NETWORK
Type option, press Enter.
3=Copy Seq# 4=Delete 11=Extended Parms
Opt Seq No Tran File File Name Ind Description
5 C 2 SEND EXCHANGE I.D.
RJE2
10 R SP 7 RECV IBM INFO NETWORK LOGO
15 C 2 SEND IBM LOGON
/*L ACCT,USRID,PSWD/*S EDIRECT/*U BSCEDI
20 R SP 7 RECV WELCOME MESSAGE
25 C 2 SEND INFO EXCHANGE LOGON
IELOGON ACCOUNT(ACCT) USERID(USRID) PASSWORD(PSWD);
More...
F1=Help F4=Prompt F9=Fold/Unfold F10=Update F12=Cancel F24=More Keys
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 41
AT&T EASYLINK SERVICES (Comm Profile ID: ATTEASY)
Session Names
Contact AT&T EasyLink Services to obtain User ID and password information, and replace the
values on the specified Record Sequences as follows:
SR (Receive and Send)
Replace USRNM with the User Name on the Record Seq 010.
Replace PSWD with the Password on the Record Seq 010.
RO (Receive Only)
Replace USRNM with the User Name on the Record Seq 010.
Replace PSWD with the Password on the Record Seq 010.
SO (Send Only)
Replace USRNM with the User Name on the Record Seq 010.
Replace PSWD with the Password on the Record Seq 010.
Figure 4.17 Session Control for Communication Profile ID: ATTEASY
EDIX403 Communication Session Control EDI 04/30/08
CTL01 12:00:00
Comm Profile ID. . . . . . . . . . ATTEASY
Session Name . . . . . . . . . . . SR
Company. . . . . . . . . . . . . . AT&T EASYLINK SERVICES
Type option, press Enter.
3=Copy Seq# 4=Delete 11=Extended Parms
Opt Seq No Tran File File Name Ind Description
10 C 0 SEND THE SIGNON RECORD
+:SIGNON USERNAME=USRNM PASSWORD=PSWD
20 S OQ 2 SEND DATA THEN EOT
30 R IM 7 RECV MSG BUNDLES UNTIL EOT
More...
F1=Help F4=Prompt F9=Fold/Unfold F10=Update F12=Cancel F24=More Keys
Communications Setup Using Communications
4 - 42 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
AT&T in the UK (Comm Profile ID: ATTUK)
Session Names
Contact AT&T to obtain User ID and password information, and replace the values on the
specified Record Sequences as follows:
SR (Receive and Send)
Replace USRNM with the User Name on the Record Seq 010.
Replace PSWD with the Password on the Record Seq 010.
RO (Receive Only)
Replace USRNM with the User Name on the Record Seq 010.
Replace PSWD with the Password on the Record Seq 010.
SO (Send Only)
Replace USRNM with the User Name on the Record Seq 010.
Replace PSWD with the Password on the Record Seq 010.
Figure 4.18 Session Control for Communication Profile ID: ATTUK
EDIX403 Communication Session Control EDI 04/30/08
CTL01 12:00:00
Comm Profile ID. . . . . . . . . . ATTUK
Session Name . . . . . . . . . . . SR
Company. . . . . . . . . . . . . . AT&T IN THE UNITED KINGDOM
Type option, press Enter.
3=Copy Seq# 4=Delete 11=Extended Parms
Opt Seq No Tran File File Name Ind Description
10 C 0 SEND THE SIGNON RECORD
/*SIGNON USERNAME=USRNM PASSWORD=PSWD
30 S OM 2 SEND FROM OUTQUE
40 R IM 8 RECV EDI TO INQUE
NO DATA AVAILABLE
50 R SP 8
More...
F1=Help F4=Prompt F9=Fold/Unfold F10=Update F12=Cancel F24=More Keys
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 43
BT UK GNS EDI*NET in the UK Async (Comm Profile ID: BTASC)
Session Names
Contact British Telecom to obtain User ID and password information, and replace the values on
the specified Record Sequences as follows:
RS (Receive and Send)
Replace &MBX with the Mailbox ID on the Record Seq 020.
Replace &PSW with the Password on the Record Seq 020.
RO (Receive Only)
Replace &MBX with the Mailbox ID on the Record Seq 020.
Replace &PSW with the Password on the Record Seq 020.
SO (Send Only)
Replace &MBX with the Mailbox ID on the Record Seq 020.
Replace &PSW with the Password on the Record Seq 020.
Figure 4.19 Session Control for Communication Profile ID: BTASC
EDIX403 Communication Session Control EDI 04/30/08
CTL01 12:00:00
Comm Profile ID. . . . . . . . . . BTASC
Session Name . . . . . . . . . . . RS
Company. . . . . . . . . . . . . . BT UK GNS EDI*NET ASYNC
Type option, press Enter.
3=Copy Seq# 4=Delete 11=Extended Parms
Opt Seq No Tran File File Name Ind Description
10 D 0 WAIT FOR WELCOME MESSAGE
and press RETURN: .
12 C 0 SEND SYSTEM PASSWORD
BGLEFBOLLN..
14 D 0 WAIT FOR X.25 CONNECT MSG
Connected to 23421231102001...
20 C 0 SEND LOGON SEQUENCE
&MBX;&PSW;A120;..
40 D 7 RECV LOGON MSG OR ABORT SCRIPT
WELCOME TO EDI*NET .
More...
F1=Help F4=Prompt F9=Fold/Unfold F10=Update F12=Cancel F24=More Keys
Communications Setup Using Communications
4 - 44 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
BT UK GNS EDI*NET in the UK Bisync (Comm Profile ID: BTUK)
Session Names
Contact British Telecom to obtain User ID and password information, and replace the values on
the specified Record Sequences as follows:
RS (Receive and Send)
Replace &MBX with the Mailbox ID on the Record Seq 020.
Replace &PSW with the Password on the Record Seq 020.
RO (Receive Only)
Replace &MBX with the Mailbox ID on the Record Seq 030.
Replace &PSW with the Password on the Record Seq 030.
SO (Send Only)
Replace &MBX with the Mailbox ID on the Record Seq 030.
Replace &PSW with the Password on the Record Seq 030.
Figure 4.20 Session Control for Communication Profile ID: BTUK
EDIX403 Communication Session Control EDI 04/30/08
CTL01 12:00:00
Comm Profile ID. . . . . . . . . . BTUK
Session Name . . . . . . . . . . . RS
Company. . . . . . . . . . . . . . BT UK GNS EDI*NET BISYNC
Type option, press Enter.
3=Copy Seq# 4=Delete 11=Extended Parms
Opt Seq No Tran File File Name Ind Description
10 C 0 SEND LOGON COMMAND
/$NETCMD LOGON UKLBSX
20 C 2 SEND LOGON SEQUENCE & EOT
&MBX;&PSW;A120;
30 D 7 RECV GARBAGE RECORD
INTENTIONAL NO MATCH
40 D 0 RECV LOGON MSG OR ABORT SCRIPT
WELCOME TO EDI*NET ...................................
50 D 7 RECV ETX/EOT AFTER LOGON MSG
INTENTIONAL NO MATCH
More...
F1=Help F4=Prompt F9=Fold/Unfold F10=Update F12=Cancel F24=More Keys
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 45
BT UK GNS EDI*NET in the UK XAS (Comm Profile ID: BTXAS)
Session Names
Contact British Telecom to obtain User ID and password information, and replace the values on
the specified Record Sequences as follows:
RS (Receive and Send)
Replace &MBX with the Mailbox ID on the Record Seq 010.
Replace &PSW with the Password on the Record Seq 010.
RO (Receive Only)
Replace &MBX with the Mailbox ID on the Record Seq 010.
Replace &PSW with the Password on the Record Seq 010.
SO (Send Only)
Replace &MBX with the Mailbox ID on the Record Seq 010.
Replace &PSW with the Password on the Record Seq 010.
Figure 4.21 Session Control for Communication Profile ID: BTXAS
EDIX403 Communication Session Control EDI 04/30/08
CTL01 12:00:00
Comm Profile ID. . . . . . . . . . BTXAS
Session Name . . . . . . . . . . . RS
Company. . . . . . . . . . . . . . BT UK GNS EDI*NET ASYNC VIA X.25
Type option, press Enter.
3=Copy Seq# 4=Delete 11=Extended Parms
Opt Seq No Tran File File Name Ind Description
10 C 0 SEND LOGON SEQUENCE
&MBX;&PSW;A120;..
20 D 7 RECV LOGON MSG OR ABORT SCRIPT
WELCOME TO EDI*NET .
30 R IQ 7 RECV EDI DATA UNTIL EOT
NO DATA TO SEND FROM EDI*NET
40 S OQ 2 SEND EDI DATA AND EOT
NO DATA TO SEND FROM EDI*NET
50 R SP 7 RECV STATISTICS FILE UNTIL EOT
More...
F1=Help F4=Prompt F9=Fold/Unfold F10=Update F12=Cancel F24=More Keys
Communications Setup Using Communications
4 - 46 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Commerce:NetworkRelease 2 BSC (Comm Profile ID: CN2BSC)
Session Names
Contact the Commerce:Network — Release 2 Network to obtain Mailbox ID and password
information, and replace the values on the specified Record Sequences as follows:
SR Send Receive
Replace X999 with the Mailbox ID on Record Seq 001.
Replace 99999 with the Mailbox ID on Record Seq 010.
Replace PASSWRD with the password on Record Seqs 001 and 020.
SO Send Only
Replace X999 with the alpha Mailbox ID on Record Seq 001.
Replace 99999 with the Mailbox ID on Record Seq 005.
Replace PASSWRD with the password on Record Seqs 001 and 015.
RR Receive Reports
Replace X999 with the alpha Mailbox ID.
Replace PASSWRD with the password on Record Seq 001.
RA Receive All
Replace X999 with the alpha Mailbox ID.
Replace PASSWRD with the password on Record Seq 001.
Figure 4.22 Session Control for Comm Profile ID: CN2BSC
EDIX403 Communication Session Control EDI 04/30/08
CTL01 12:00:00
Comm Profile ID. . . . . . . . . . CN2BSC
Session Name . . . . . . . . . . . SO
Company. . . . . . . . . . . . . . STERLING COMMERCE COMMERCENET RELEASE2
Type option, press Enter.
3=Copy Seq# 4=Delete 11=Extended Parms
Opt Seq No Tran File File Name Ind Description
1 C 2 SEND SIGNON
/*SIGNON CN2BSC MX999 A PASSWRD
5 C 0 SEND BATCH RECORD
$$BATCH ONUC A A 999990101
10 C 0 SEND NETWORK APPLICATION REC
*.NTAP 02001+
15 C 0 SEND PASSWORD RECORD
*.PASS PASSWRD
20 S OQ 2 SEND UCS DATA
More...
F1=Help F4=Prompt F9=Fold/Unfold F10=Update F12=Cancel F24=More Keys
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 47
Commerce:NetworkRelease 3 BSC (Comm Profile ID: CN3BSC)
Session Names
Contact the Commerce:Network — Release 3 Network to obtain Mailbox ID and Batch
ID/password information, and replace the values on the specified Record Sequences as follows:
SR (Send Receive)
Replace SX999R with the Report Mailbox ID on Record Seq 020.
Replace SX999D with Data Mailbox ID on Record Seqs 030 and 040.
Replace TEST with the Batch ID/Password on Record Seqs 020, 030, and 040.
SO (Send Only)
Replace SX999D with the Data Mailbox ID on Record Seq 020.
Replace TEST with the Batch/ID Password on Record Seq 020.
RR (Receive Reports)
Replace SX999R with the Report Mailbox ID on Record Seq 020.
Replace TEST with the Batch ID/Password on Record Seq 020.
RD (Receive Data)
Replace SX999D with the Data Mailbox ID on Record Seq 020.
Replace TEST with the Batch ID/Password on Record Seq 020.
RA (Receive All)
Replace SX999R with the Report Mailbox ID on Record Seq 020.
Replace SX999D with Data Mailbox ID on Record Seq 030.
Replace TEST with the Batch ID/Password on Record Seqs 020 and 030.
ST (Receive Network Reports)
Replace SX999D with the Data Mailbox ID and TEST with the Batch ID/Password on
Record Seqs 020 and 030.
Figure 4.23 Session Control for Comm ID: CN3BSC
EDIX403 Communication Session Control EDI 04/30/08
CTL01 12:00:00
Comm Profile ID. . . . . . . . . . CN3BSC
Session Name . . . . . . . . . . . RA
Company. . . . . . . . . . . . . . STERLING COMMERCE COMMERCENET RELEASE3
Type option, press Enter.
3=Copy Seq# 4=Delete 11=Extended Parms
Opt Seq No Tran File File Name Ind Description
20 C 0 SEND REQUEST FOR REPORTS
$$REQUEST ID=SX999R BATCHID='TEST'
30 C 2 SEND REQUEST FOR X12 DATA
$$REQUEST ID=SX999D BATCHID='TEST'
40 R SP 7 RECEIVE REPORT DATA TO SPOOL
*** ERROR *** NO BATCHES FOR TRANSMISSION
50 R IQ 7 RECV X12 DATA TO INQUE
*** ERROR *** NO BATCHES FOR TRANSMISSION
More...
F1=Help F4=Prompt F9=Fold/Unfold F10=Update F12=Cancel F24=More Keys
Communications Setup Using Communications
4 - 48 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Commerce:NetworkRelease 3 SNA (Comm Profile ID: CN3SNA)
Session Names
Contact the Commerce:Network — Release 3 Network (SNA) to obtain Mailbox ID and Batch
ID/password information, and replace the values on the specified Record Sequences as follows:
RA (Receive All)
Replace SX999R with the Report Mailbox ID on Record Seq 050.
Replace SX999D with the Data Mailbox ID on Record Seq 030.
Replace TEST with the Batch ID/Password on Record Seqs 030 and 050.
RD (Receive Data)
Replace SX999D with the Data Mailbox ID on Record 030.
Replace TEST with the Batch ID/Password on Record Seq 030.
RR (Receive Reports)
Replace SX999R with the Report Mailbox ID on Record Seq 030.
Replace TEST with the Batch ID/Password Record Seq 030.
SO (Send Only)
Replace SX999D with the Data Mailbox ID on Record Seq 030.
Replace TEST with the Batch ID/Password on Record Seq 030.
SR (Send Receive)
Replace SX999D with the Data ID and TEST with the Batch ID/Password on Seq 030.
Replace SX999R with the Report Mailbox ID on Record Seq number 030, 060, and 080.
ST (Receive Network Reports)
Replace SX999D with the Data ID and TEST with the Batch ID/Password on Seqs 030 and
040.
Figure 4.24 Session Control for Comm Profile ID: CN3SNA
EDIX403 Communication Session Control EDI 04/30/08
CTL01 12:00:00
Comm Profile ID. . . . . . . . . . CN3SNA
Session Name . . . . . . . . . . . SO
Company. . . . . . . . . . . . . . COMMERCE:NETWORK RELEASE 3
Type option, press Enter.
3=Copy Seq# 4=Delete 11=Extended Parms
Opt Seq No Tran File File Name Ind Description
10 R SP 7 TRAP SUPERTRACS READY MSG
SUCCESSFUL LOGON TO GENTRAN/SUPERTRACS
20 R SP 7 TRAP SUPERTRACS READY MSG
*** SUPERTRACS READY FOR INPUT
30 C 0 SEND ADD RECORD
$$ADD ID=SX999D BATCHID='TEST'
40 S OQ 3 SEND FROM OUTBOUND QUEUE
50 C 0 SEND LOGOFF TO END SESSION
$$LOGOFF APPLID=APPLIDNAME RMT=LUNAME
More...
F1=Help F4=Prompt F9=Fold/Unfold F10=Update F12=Cancel F24=More Keys
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 49
GE Information Services (Comm Profile ID: GEIS)
Session Names
Contact the GEIS Network to obtain User ID and password information, and replace the values on
the specified Record Sequences as follows:
RA (Receive All)
Replace IDX with the User ID in Record Seq 005 and 015.
Replace PASSW with the password on Record Seq 005.
SR (Send and Receive)
Replace IDX with the User ID in Record Seqs 005, 015, 020, and 035.
Replace PASSW with the password on Record Seq 005.
RP (Receive Prior -repeats last received documents)
Replace IDX with the User ID in Record Seqs 005 and 015.
Replace PASSW with the password on Record Seq 005.
RR (Receive Reports—receive status reports)
Replace IDX with the User ID in Record Seqs 005, 015, and 038.
Replace PASSW with the password on Record Seq 005.
RM (Receive Mailbox — receive specific mailbox: trading partner)
Replace IDX with the User ID in Record Seqs 005 and 015.
Replace PASSW with the password on Record Seq 005.
Replace MAILNUM with the selected mailbox number (up to 8) on Record Seq 037.
RV (Receive Network Reports)
Replace IDX with the User ID in Record Seqs 005, 020, 040,and 060.
Replace PASSW with the password on Record Seq 005.
Figure 4.25 Session Control for Comm Profile ID: GEIS
EDIX403 Communication Session Control EDI 04/30/08
CTL01 12:00:00
Comm Profile ID. . . . . . . . . . GEIS
Session Name . . . . . . . . . . . RA
Company. . . . . . . . . . . . . . GENERAL ELECTRIC INFO SYSTEMS
Type option, press Enter.
3=Copy Seq# 4=Delete 11=Extended Parms
Opt Seq No Tran File File Name Ind Description
5 C 0 SEND USER ID & PASSWORD
IDX,PASSW,MAILA
10 C 0 SEND MAILBOX/PUNCH RECORD
*LTID MAILBOXA,CPUNCH
15 C 0 SEND MODE INPUT RECORD
*MODE INPUT(OUTPUT(HISTIDXA),LIST),WAIT,TAB(HSSTABLE)
37 C 0 SEND RECEIVE REQUEST
/EDXRCV
45 C 2 SEND END OF SESSION RECORD
*EOS
More...
F1=Help F4=Prompt F9=Fold/Unfold F10=Update F12=Cancel F24=More Keys
Communications Setup Using Communications
4 - 50 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Kleinschmidt (Comm Profile ID: KLEIN)
Session Names
Contact the Kleinschmidt Network to obtain User ID and password information, and replace the
values on the specified Record Sequences as follows:
RA (Receive ALL)
Replace USERID with the User ID and PASSWORD with the Password on Record Seq 005.
SO (Send Only)
Replace USERID with the User ID and PASSWORD with the Password on Record Seq 005.
SR (Send Receive)
Replace USERID with the User ID and PASSWORD with the Password on Record Seq 005.
Figure 4.26 Session Control for Comm Profile ID: Klein
EDIX403 Communication Session Control EDI 04/30/08
CTL01 12:00:00
Comm Profile ID. . . . . . . . . . KLEIN
Session Name . . . . . . . . . . . RA
Company. . . . . . . . . . . . . . KLEINSCHMIDT NETWORK
Type option, press Enter.
3=Copy Seq# 4=Delete 11=Extended Parms
Opt Seq No Tran File File Name Ind Description
5 C 2 SEND SIGNON RECORD
#SIGNON USERID,PASSWORDX
10 C 2 SEND REQUEST FOR OUTPUT
#SEND TSTDATA
15 R IQ 7 RECV X12 DATA TO INBOUND QUEUE
NO ACTIVITY SINCE LAST REQUEST
20 C 2 SEND SIGNOFF
#SIGNOFF
More...
F1=Help F4=Prompt F9=Fold/Unfold F10=Update F12=Cancel F24=More Keys
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 51
MCI Bisync (Comm Profile ID: MCIBSC)
Session Names
Contact MCI to obtain User ID and password information, and replace the values on the specified
Record Sequences as follows:
SR (Receive and Send)
Replace MAILBOXID with the Mailbox ID on the Record Seq 012.
Replace PASSWD with the Password on the Record Seq 012.
RO (Receive Only)
Replace MAILBOXID with the Mailbox ID on the Record Seq 012.
Replace PASSWD with the Password on the Record Seq 012.
SO (Send Only)
Replace MAILBOXID with the Mailbox ID on the Record Seq 012.
Replace PASSWD with the Password on the Record Seq 012.
Figure 4.27 Session Control for Communication Profile ID: MCIBSC
EDIX403 Communication Session Control EDI 04/30/08
CTL01 12:00:00
Comm Profile ID. . . . . . . . . . MCIBSC
Session Name . . . . . . . . . . . SR
Company. . . . . . . . . . . . . . MCI
Type option, press Enter.
3=Copy Seq# 4=Delete 11=Extended Parms
Opt Seq No Tran File File Name Ind Description
5 C 0 SEND PROFILE & TYPE
/$NETCMD PROFILE TYPE2
10 C 0 SEND SIGNON
/$NETCMD SIGNON EDIBSC01;BSC*EDI
12 C 2 SEND HOST SIGNON & DIALOG
MAILBOXID;PASSWD;B135;
14 R SP 7 RECV WELCOME MSG
20 R IQ 7 RECV X12 EDI DATA
NO DATA TO SEND FROM EDI*NET
More...
F1=Help F4=Prompt F9=Fold/Unfold F10=Update F12=Cancel F24=More Keys
Communications Setup Using Communications
4 - 52 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
SEARS Communication Network (Comm Profile ID: SEARS)
Session Names
Contact the Sears Network to obtain ID number and password information, and replace the values
on the specified Record Sequences. The following three session names share the same replacement
instructions.
SR (Send Receive)
RA (Receive All)
SO (Send Only
Replace IDXXXXX with the ID Number on Record Seq 005.
Replace PASSWORD with the password on Record Seq 005.
Figure 4.28 Session Control for Comm Profile ID: Sears
EDIX403 Communication Session Control EDI 04/30/08
CTL01 12:00:00
Comm Profile ID. . . . . . . . . . SEARS
Session Name . . . . . . . . . . . SR
Company. . . . . . . . . . . . . . SEARS INFORMATION NETWORK
Type option, press Enter.
3=Copy Seq# 4=Delete 11=Extended Parms
Opt Seq No Tran File File Name Ind Description
5 C 0 SEND SIGNON
.LOGON SEARSEDI,IDXXXXX,PASSWORD
15 R IQ 7 RECV X12 FROM PARTNERS
More...
F1=Help F4=Prompt F9=Fold/Unfold F10=Update F12=Cancel F24=More Keys
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 53
Transettlements (Comm Profile ID:TRANS)
Session Names
Contact the Transettlements Network to obtain Account number and password information, and
replace the values on the specified Record Sequences. The following three session names share the
same replacement instructions.
RA (Receive All)
SO (Send Only)
SR (Send Receive)
Replace ACCT with the Account number on Record Seq 001.
Replace PASSWORD with the password on Record Seq 001.
Figure 4.29 Session Control for Comm Profile ID:TRANS
EDIX403 Communication Session Control EDI 04/30/08
CTL01 12:00:00
Comm Profile ID. . . . . . . . . . TRANS
Session Name . . . . . . . . . . . RA
Company. . . . . . . . . . . . . . TRANSETTLEMENTS NETWORK
Type option, press Enter.
3=Copy Seq# 4=Delete 11=Extended Parms
Opt Seq No Tran File File Name Ind Description
1 C 2 SEND ACCT. NO. & PASSWORD
LOG 2434,ACCT,PASSWORD
2 D 7 RECV PROMPT FOR SECUITY CODE
SECURITY CODE >
3 C 2 SEND SECURITY CODE
SECURITY
6 D 7 RECV PROMPT FOR NEXT COMMAND
COMMAND >
40 C 2 SEND A REQUEST TO RECEIVE DATA
RECEIVE
More...
F1=Help F4=Prompt F9=Fold/Unfold F10=Update F12=Cancel F24=More Keys
Communications Setup Using Communications
4 - 54 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Western Union (Comm Profile ID: WSUN)
Session Names
Contact the Western Union Network to obtain Account number and password information, and
replace the values on the specified Record Sequences. The following three session names share the
same replacement instructions.
SR (Send Receive)
SO (Send Only)
RA (Receive All)
Replace ACCOUNT99 with the Account number on Record Seq 005.
Replace PASSW.PASSW with the password on Record Seq 005.
Figure 4.30 Session Control for Comm Profile ID:WSUN
EDIX403 Communication Session Control EDI 04/30/08
CTL01 12:00:00
Comm Profile ID. . . . . . . . . . WSUN
Session Name . . . . . . . . . . . SR
Company. . . . . . . . . . . . . . WESTERN UNION
Type option, press Enter.
3=Copy Seq# 4=Delete 11=Extended Parms
Opt Seq No Tran File File Name Ind Description
5 C 0 SEND SIGNON
SIGNON ACCOUNT99 PASSW.PASSW
10 C 0 SEND SEND-RECORD
#SENDEDI
15 S OQ 0 SEND X12 DATA
20 C 2 SEND RECEIVE REQUEST RECORD
#RCVEDI
25 R IQ 8 RECEIVE X12 FROM PARTNERS
More...
F1=Help F4=Prompt F9=Fold/Unfold F10=Update F12=Cancel F24=More Keys
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 55
Automatically Update Network Scripts
Gentran:Server offers a utility that can be used with network profiles to automatically update the
predefined scripts with your identifiers provided by the network. The utility is referred to as the
“Network Profile” feature.
This feature simplifies the customization of communication scripts for networks by automatically
updating the network scripts with the unique values associated with that network user.
For example, rather than manually editing each of the scripts to insert your unique User ID and
password where required, the User ID and password can be entered on the Network Profile panel
(EDIX821-FMT01). The system then finds old network values and replaces them with new
network values for all scripts for that network profile. Later, if your password changes, you can
again update all the scripts for a specific network by typing a new password into the Password
field on panel EDIX821-FMT01. Several major network profiles are included in the “Network
Profile” section.
Figure 4.31 Work with Communications Panel (EDIX400-FMT01)
To access the Network Profiles, type 17 (Network Prf) on the key entry line and press Enter, as
shown in Figure 4.31
EDIX400 Work with Communications EDI 04/30/08
FMT01 pgmlib: G3X5PGM dtalib:G3X5DTA 12:00:00
Position to Profile ID . . . . . .
Type option (and Information), press Enter.
17=Network Prf 18=MQ Links 30=Start Session 31=End Session 32=Copy Comm
Opt Profile ID Company
17
CN3BSC COMMERCE:NETWORK RELEASE 3
CN3SNA COMMERCE:NETWORK RELEASE 3
REDINET CONTROL DATA / REDINET NETWORK
RMTDAA Remote Dial Line/Answer/ASYNC
RMTDAL Remote Dial Line/Answer/SDLC/APPC
RMTDAN Remote Dial/Answer/No X25 Network
RMTLAL Remote Leased-line/answer/SDLC/APPC
RMTLAN Remote Lease Lin/Answer/No X25 Netw
RMTLAX Remote Leased Line/Answer/X25 Netwk
More...
Parameters or command
===>
F1=Help F3=Exit F12=Cancel F15=Sort F23=More Options F24=More Keys
Communications Setup Using Communications
4 - 56 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
The Work with Network Profile panel (EDIX820-FMT01), shown in Figure 4.32, contains a list of
comm profile IDs that have been classified as “Network Profiles.” When this panel is accessed
with option 17 (Network Prf) next to a specific Profile ID, the list is automatically positioned to
the closest matching entry. Many EDI networks are supported by this automatic script update
utility.
Figure 4.32 Work with Network Profile Panel (EDIX820-FMT01)
To perform the automatic script update procedure, type 2 in the option field next to the selected
Network ID (Network comm profile ID) and press Enter.
EDIX820 Work with Network Profile EDI 04/30/08
FMT01 pgmlib: G3X5PGM dtalib: G3X5DTA 12:00:00
Position to Network ID . . . . . . CN3BSC
Type option (and Information), press Enter.
2=Revise 5=View
Last Update
Opt Network ID Network Name Date User
2 CN3BSC COMMERCE:NETWORK RELEASE 3 12/27/01 EDI
CN3SNA COMMERCE:NETWORK RELEASE 3 05/12/97 DSH
SEARS SEARS INFORMATION NETWORK 07/21/97 COM
TRANS TRANSETTLEMENTS NETWORK 03/29/97 XXX
WSUN WESTERN UNION 08/13/97 JBS
Bottom
Parameters or command
===>
F1=Help F3=Exit F12=Cancel F15=Sort F24=More Key
Using Communications Communications Setup
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 57
The Network Profile panel (EDIX821-FMT01) appears, as shown in Figure 4.6.
Figure 4.33 Network Profile Panel (EDIX821-FMT01)
After making any necessary changes, press F10 (Update).
The system scans all scripts for this comm profile ID, looking for a match on the old identifiers. If
found, they are replaced with the new identifiers. The system returns you to panel
EDIX820-FMT01 with a message indicating the scripts were updated.
Additionally, the Dial number can be updated for the comm profile from this panel. If you change
the Dial number, the system updates the profile, and then recreates the line, controller, and device
descriptions.
# NOTE
Users converting to Gentran:Server for iSeries Release 3.5 from a prior release may have an
out-of-sync problem with their scripts that should be corrected before using this utility. (SEE
the “Common Questions” section in this chapter for more information on how to convert the
scripts in preparation for using the automatic script update utility.)
EDIX821 Network Profile EDI 04/30/08
FMT01 12:00:00
Comm Profile ID. . . . . . . . . . CN3BSC
Network Name . . . . . . . . . . . COMMERCE:NETWORK RELEASE 3
Dial . . . . . . . . . . . . . . . 1800627588312
Data Mailbox ID. . . . . . . . . . SX222D
Report Mailbox ID. . . . . . . . . SX999R
Batch ID/Password. . . . . . . . . TEST
F1=Help F4=Prompt F10=Update F12=Cancel F24=More Keys
Copy Profiles and Scripts Using Communications
4 - 58 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Copy Profiles and Scripts
When creating custom profiles, it may be easier to copy an existing profile and/or script and
modify it to meet your requirements.
Copy Communication Profiles
The copy function for the profile copies the comm profile ID and all session scripts from the
source Profile. If the scripts are not needed, you can delete them after copying.
Figure 4.34 Work with Communications Panel (EDIX400-FMT01)
To copy a Profile ID, advance to the Work with Communications panel (EDIX400-FMT01),
type 3 (Copy) in the option field next to the selected profile and press Enter, as shown in Figure
4.34. A pop-up window is shown to specify the new comm profile ID. Type the new ID and press
Enter.
EDIX400 Work with Communications EDI 04/30/08
FMT01 pgmlib: G3X5PGM dtalib:G3X5DTA 12:00:00
Position to Profile ID . . . . . . CN3BSC
Type option (and Information), press Enter.
1=Create 2=Revise 3=Copy 4=Delete 5=View 11=Line/Ctl/Dev
Opt Profile ID Company
3 CN3BSC COMMERCE:NETWORK RELEASE 3
Copy To
TESTCOPY
F3=Exit F12=Cancel
RMTLAX Remote Leased Line/Answer/X25 Netwrk
More...
Parameters or command
===>
F1=Help F3=Exit F12=Cancel F15=Sort F23=More Options F24=More Keys
Using Communications Copy Profiles and Scripts
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 59
The system copies the necessary information and advances you to the comm profile ID panel
(EDIX401-FMT01) to let you customize the profile and configuration information before the copy
is performed.
Figure 4.35 Communication Profile Panel (EDIX401-FMT01)
Make any necessary changes to the new comm profile and press Enter, as shown in Figure 4.35.
EDIX401 Communication Profile EDI 04/30/08
FMT01 12:00:00
Comm Profile ID. . . . . . . . . . TESTCOPY
Company. . . . . . . . . . . . . . COMMERCE:NETWORK RELEASE3
Contact. . . . . . . . . . . . . . NETWORK COMMUNICATIONS
Phone. . . . . . . . . . . . . . . ( 614 ) 793 - 7000 x
International Dial Code. . . . . .
Protocol . . . . . . . . . . . . . BSC
Days to Purge. . . . . . . . . . . 999
FIFO/LIFO. . . . . . . . . . . . . F
Used Most Frequently . . . . . . . N
Update Allowed . . . . . . . . . . Y
F1=Help F10=Update F12=Cancel F13=Services F24=More Keys
Copy Profiles and Scripts Using Communications
4 - 60 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Figure 4.36 Communication Line/Control/Device panel (EDIX401-FMT02)
Make necessary changes and press F10 (Update), as shown in Figure 4.36.
The Profile ID is created and the system automatically creates the line, controller, and device
descriptions.
# NOTE
The system also copies all session scripts from the source Profile to the new Profile ID.
Review each script.
EDIX401 Communication Profile EDI 04/30/08
FMT02 BSC 12:00:00
Comm Profile ID. . . . . TESTCOPY
Company. . . . . . . . . COMMERCE:NETWORK RELEASE3
Modem Port . . . . . . . LIN021 Retries. . . . . . . . 02
Switched Line. . . . . . Y (Y/N) Auto Dial. . . . . . . Y (Y/N)
Auto Call Unit . . . . . V Auto Call Port . . . .
Dial . . . . . . . . . . 18006275883
Host ID Verify . . . . . N (Y/N) Duplex . . . . . . . . *FULL
Local Site ID. . . . . .
Record Size. . . . . . . 0080 Block Size . . . . . . 0512
Inter-Record Separator . 3780
Transparency . . . . . . N (Y/N)
Blank Compress . . . . . N (Y/N)
Trailing Blank Trunc . . N (Y/N) Remote Cmd Password. . *NONE
F1=Help F2=More/Less F4=Prompt F10=Update F12=Cancel F24=More Keys
Using Communications Copy Profiles and Scripts
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 61
Copying Communication Scripts
The copy function is also available to copy a session control script within a comm profile or
between Profiles.
Figure 4.37 Work with Communications Panel (EDIX400-FMT01)
Copy Scripts between Profiles
On the Work with Communications panel (EDIX400-FMT01), shown in Figure 4.37, type 12
(Session Ctrl) in the option field on the key entry line and press Enter. All scripts for all profiles
are shown.
Copy Scripts within a Profile
On the Work with Communications panel (EDIX400-FMT01), shown in Figure 4.37, type 12
(Session Ctrl) in the option field next to the selected Profile ID. All scripts for the selected profile
are shown.
EDIX400 Work with Communications EDI 04/30/08
FMT01 pgmlib: G3X5PGM dtalib:G3X5DTA 12:00:00
Position to Profile ID . . . . . .
Type option (and Information), press Enter.
12=Session Ctrl 13=Jobs 14=History Log 15=Outb Queue 16=Inb Queue
Opt Profile ID Company
12
ATTEASY AT&T EASYLINK SERVICES
ATTUK AT&T IN THE UNITED KINGDOM
AUTOANS TEST AUTOANSWER CONFIG
BSCRMT Test for BSC REMOTE
BTASC BT UK GNS EDI*NET ASYNC
BTUK BT UK GNS EDI*NET BISYNC
BTXAS BT UK GNS EDI*NET ASYNC VIA X.25
CHRY CHRYSLER CTX MAILBOX
CHRY480 CHRYSLER - 830, 861, 862
More...
Parameters or command
===>
F1=Help F3=Exit F12=Cancel F15=Sort F23=More Options F24=More Keys
Copy Profiles and Scripts Using Communications
4 - 62 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
The Work with Communications Session panel (EDIX402-FMT01) is shown in Figure 4.38. This
panel will appear slightly different when accessed for all profiles or for a single profile.
Figure 4.38 Work with Communications Session Panel (EDIX402-FMT01)
To copy the session script, type 3 (Copy) next to the selected profile and session name (or just
session if the list was accessed for a specific profile) and press Enter. A pop-up window is shown
to specify the new profile and session name. Type the target information and press Enter.
The system copies all session control records for the script and re-displays panel
EDIX402-FMT01.
EDIX402 Work with Communications Session EDI 12/27/01
FMT01 12:00:00
Position to Session Name . . . . . CN3BSC
Type option (and Information), press Enter.
1=Create 2=Revise 3=Copy 4=Delete 6=Print
Opt PROFILE SN Company
CN3BSC RA COMMERCE:NETWORK RELEASE 3
CN3BSC RD COMMERCE:NETWORK RELEASE 3
CN3BSC RR COMMERCE:NETWORK RELEASE 3
CN3BSC SO COMMERCE:NETWORK RELEASE 3
3 CN3BSC SR COMMERCE:NETWORK RELEASE 3
Copy To
TESTCOPY SR
F3=Exit F12=Cancel
Pa
===>
F1=Help F3=Exit F12=Cancel F15=Sort F24=More Keys
Using Communications Copy Profiles and Scripts
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 63
Copy Communication Script Records
The copy function is also available to copy a session control script record within a script or
between profiles.
Figure 4.39 Work with Communication Session Control Panel (EDIX403-CTL01)
Copy Script Record between Profiles
On the Communication Session Control panel (EDIX403-CTL01), as shown in Figure 4.39, type 3
(Copy) in the option field next to the selected sequence number (and, optionally, type a new
sequence number over the selected sequence number) and press Enter. A pop-up window is
shown to specify the new profile and session name. Type the target information over the current
profile or current session name and press Enter.
The system copies the sequence number and re-displays panel EDIX403-CTL01.
Copy Script Record within a Script
On the Communication Session Control panel (EDIX403-CTL01), as shown in Figure 4.39, type 3
(Copy) in the option field next to the selected sequence number and type the new sequence number
desired over the selected sequence number and press Enter. A pop-up window is shown to
(optionally) specify a new profile and session name. If the copy is within the current profile and
session name, press Enter without changing the profile or session name.
The system copies the session control record to the new sequence number and re-displays panel
EDIX403-CTL01.
EDIX403 Communication Session Control EDI 04/30/08
CTL01 12:00:00
Comm Profile ID. . . . . . . . . . CN3BSC
Session Name . . . . . . . . . . . SR
Company. . . . . . . . . . . . . . Commerce:Network RELEASE 3
Type option, press Enter.
3=Copy Seq# 4=Delete 11=Extended Parms
Opt Seq No Tran File File Name Ind Description
20 C 0 SEND REQUEST FOR REPORTS
30 C 0 SEND REQUEST FOR X12 DATA
40 C 0 SEND $$ADD RECORD
50 S OQ 2 SEND X12 DATA FROM OUTQUE
60 R SP 7 RECEIVE REPORTS TO SPOOL
3 70 R IQ 7 RECEIVE X12 DATA TO INQUE
Copy To
CN3BSC SR
F3=Exit F12=Cancel
Operations and Management of Communications Using Communications
4 - 64 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Operations and Management of
Communications
Operations and management allows the user to initiate (or schedule) specific communications
sessions, work with active sessions, work with the data in the Inbound and Outbound Queues,
view the history of previous transmissions, and perform routine file maintenance on the
communications files.
Operations
Prior to initiating communication sessions, the setup of profiles and scripts must already be done.
These profiles and scripts are the foundation of the comm session. Data needs to be added to the
queue via the ADD command (will have a ready status of Q) before it can be transmitted.
Data remains in the Outbound Queue until you send it to a communication partner via a comm
session. Typically, these jobs add data to the queue and initiate comm sessions that are scheduled
to run on a routine basis (that is, every day at 10:00 and 2:00) in an unattended mode.
Data received during a comm session is placed in the Inbound Queue with a status of RN (Received
Normal). The data remains in the Inbound Queue until you run an EXTRACT command to copy
the data into a file and the status is updated to PI (processed inbound) These jobs are also typically
scheduled to run at specific times in an unattended mode.
Management
From time to time, data may need to be retransmitted or reprocessed. This can be accomplished by
resetting the status of the batch and executing the comm session (STRCOMSSN) or EXTRACT
jobs again. History of previous transmissions can be accessed to ensure all sessions have
completed successfully, and detailed information can be examined when troubleshooting. Another
management function that should be performed on a routine basis is file clean up. Several purge
jobs are available to purge individual or all communication files that meet the purge criteria. These
purge jobs are commonly scheduled to be run on a routine basis during “off-hours” and can be
optionally purged to tape or save file. If the data is purged to tape or save file, it can be restored
using the various retrieve commands.
Using Communications Operations and Management of Communications
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 65
Initiate Communication Sessions
When you initiate a communication session, the system determines the type of session to be
performed based on the parameters you set for the comm profile. These parameters may include
Switched Line, Auto Dial, Auto Call Unit/Port, and Dial. The following types of sessions are
performed by the system:
Auto Dial
Manual Dial
Auto Answer
Auto dial sessions are the most common but require an auto-dial modem or a manual-dial modem
with an auto call unit attached on a secondary line. (This enables the modem to become an
auto-dial modem.) Your system initiates the call and can be set up to run unattended at scheduled
times.
Manual dial sessions are also initiated by your system but require operator intervention. An
operator needs to manually dial the number and respond once the connection is established.
Auto answer sessions are initiated by a remote system. Your system must be ready to receive. This
type of session requires you to start the session and then wait for the remote to call you. You have
the ability to place the system in a continuous “ready-to-receive” mode by setting the Run
Continually parameter to Y.
# NOTE
Only one active session per physical line can take place at any time.
Operations and Management of Communications Using Communications
4 - 66 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
Access the Work with Communications panel (EDIX400-FMT01) to initiate communications
sessions by selecting option 1 from the GENMAIN menu and then selecting 1 from the GENCOM
menu.
Figure 4.40 Work with Communications Panel (EDIX400-FMT01)
To start a communication session, type 30 (Start Session) next to the desired comm profile ID and
press Enter, as shown in Figure 4.40.
There are two other ways to run the STRCOMSSN command.
1. From the Work with Comm Session panel (EDIX402) using option ‘30.’ From this screen,
the Profile ID and Session Name are both pre-loaded.
2. From the Work with Outbound Queue Control page (EDIX404) using option ‘33’ and
press Enter. Press F4 on the Profile ID and session name for a list of valid profile IDs and
session names.
The Start Communication Session (STRCOMSSN) command panel is shown with the selected
comm profile ID pre-loaded.
EDIX400 Work with Communications EDI 04/30/08
FMT01 pgmlib: G3X5PGM dtalib:G3X5DTA 12:00:00
Position to Profile ID . . . . . . CN3BSC
Type option (and Information), press Enter.
17=Network Prf 30=Start Session 31=End Session 32=Copy Comm 33=Line Pool
Opt Profile ID Company
30 CN3BSC COMMERCE:NETWORK RELEASE 3
CN3SNA COMMERCE:NETWORK RELEASE 3
REDINET CONTROL DATA / REDINET NETWORK
RMTDAA Remote Dial Line/Answer/ASYNC
RMTDAL Remote Dial Line/Answer/SDLC/APPC
RMTDAN Remote Dial/Answer/No X25 Network
RMTLAL Remote Leased-line/answer/SDLC/APPC
RMTLAN Remote Lease Lin/Answer/No X25 Netw
RMTLAX Remote Leased Line/Answer/X25 Netwk
More...
Parameters or command
===>
F1=Help F3=Exit F12=Cancel F15=Sort F23=More Options F24=More Keys
Using Communications Operations and Management of Communications
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 67
The Start Communications Session (STRCOMSSN) command panel, as shown in Figure 4.41, is
used to initiate a communication session, whether auto dial, manual, or auto answer.
# NOTE
Only one session per communication profile can be executed at the same time.
Figure 4.41 Start Communications Session Panel (STRCOMSSN)
Comm Profile ID
The comm profile ID is passed into the command when selected from the Work with
Communications panel with option 30 (Start Session). The session type must also be
specified to indicate the script to be used. For example, SR indicates that the “Send and
Receive” script should be used.
Press F10 (Additional Parameters) to specify additional parameters. Press F1 (Help) on
any parameter to obtain help for the parameter or for the command in general.
Trace
The Trace parameter is extremely useful when resolving communication error problems,
since it generates additional job log messages and trace files. The default is *No (do not
trace the job). The Trace parameter is also an excellent tool to use when creating new
scripts and profiles, or when running initial tests with a script or profile.
CAUTION
STOP
Setting the Trace parameter to *YES generates additional system overhead and should only
be used for diagnostic purposes.
Trace cannot be run on more than one session at a time. If you run concurrent sessions with
Trace on in both sessions, you will encounter failures.
Start Communications Session (STRCOMSSN)
Type choices, press Enter.
Communications Profile ID . . . > 'CN3BSC' Comm Profile Id
Session Type . . . . . . . . . . Name
Delete Previous Jobs? . . . . . *YES *YES, *NO
Schedule Job? . . . . . . . . . *NO *YES, *NO
Run Continually? . . . . . . . . *NO *YES, *NO
Bottom
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters F12=Cancel
F13=How to use this display F24=More keys
Operations and Management of Communications Using Communications
4 - 68 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
# NOTE
To gather additional diagnostic data, use the STRCOMSSNT command. This command is the
same as the STRCOMSSN command, except that it also generates OS/400 ICF and OS/400
Communications traces.
Connect If No Data
The Connect If No Data parameter can be used to force the system to start a comm session
even when there’s no data to be sent. When set to *YES, the system connects without
checking the Outbound Queue. A value of *NO makes the system check the Outbound
Queue for data. It then decides to initiate a session if outbound data is present and if the
script contains a send from the Outqueue command. The default value is set to *YES.
Reset Queues on Fail
If the Reset Queues on Fail parameter is set to *YES, Gentran:Server will interpret a
failure that occurs at any point in a session to be a failure of the entire session, even if
some data has already been transferred successfully. If RESETQ(*YES) is specified and
the communication session ends with a failed completion status, Gentran:Server will set
any inbound queue batches that were received during the session to status RA (Received
Abnormally), so that they will not automatically be processed by Gentran:Server inbound
processing. Gentran:Server will set any outbound queue batches that were transmitted
during the session to status SA (Sent Abnormally), so that they will be transmitted again
the next time an outbound communication session is run for the same communication
profile. The default value is set to *NO.
Number of Restarts
The Number of Restarts parameter specifies the number of times the communication
session should be retried if the first attempt completes with a failed status. Valid values
range from 0 to 99. The number entered does not include the initial communication
session attempt. The default value is set to 0.
When transmitting data from the Outbound Queue, a copy of the data is sent if the batch
status is Q (Queued), IP (In Progress), or SA (Sent Abnormal). After data is transmitted,
the system updates the status to SN or SA. Outbound batches can contain the following
status codes:
Q (Queued)
QE (Queued with errors — rejected data)
SN (Sent Normal)
SA (Sent Abnormal)
IP (In Progress)
H (Held)
# NOTE
Batches are sent in the order specified for the comm profile ID on panel EDIX400-FMT01.
They are sent by either the FIFO (First in, first out) or LIFO (Last in, first out) method.
Using Communications Operations and Management of Communications
Gentran:Server for iSeries Communications Module Release 3.5 User Guide 4 - 69
When receiving data to the Inbound Queue, the batches are given a status of RN (Received
Normal) or RA (Received Abnormal). Only batches with a RN status are processed. After
each batch is extracted inbound, the system updates the status to PI. Inbound batches can
contain the following status codes:
RN (Received Normal)
RA (Received Abnormal)
CP (Currently in Progress – temporary status assigned by the Inbound Editor
during processing.
PI (Processed Inbound)
H (Held)
The STRCOMSSN command can be executed in one of three ways:
Submitting it to run as a batch job immediately
Scheduling it to run as a batch job at a later time
Executing it interactively (immediately)
To submit the command to run the job as a batch job immediately, keep the default
value *No in the Schedule Job and Run Interactively parameters. The job is submitted to
batch as soon as you press Enter.
To schedule the command to run as a batch job (at a later time), type *YES in the
Schedule Job parameter. The system displays the Schedule Job (SCHJOB) command
panel, which contains the job run parameters.
To execute the command interactively (immediately), keep the default value *NO in the
Schedule Job parameter and type *YES in the Run Interactively parameter. (Press F10
[Additional Parameters] to modify.)
# NOTE
Executing a command interactively locks up your terminal until the job is complete.
Operations and Management of Communications Using Communications
4 - 70 Gentran:Server for iSeries Communications Module Release 3.5 User Guide
If you specify *YES in the Schedule Job field, the Schedule Job panel (SCHJOB) panel appears, as
shown in Figure 4.42.
Figure 4.42 Sched