Gentran:Rea1time® for zSeries
`
`User’s Guide
`
`Release 6.5
`
`Sier"fir1g Cmnmerce
`
`Sterling Commerce (Mid America), inc.
`4600 Lakehurst Court Dublin, OH 43016-2000 * 614/793-4000
`© Copyright 1988 — 2009/Sterling Commerce, Inc‘
`
`2217—65(J—USERU1—0U0]
`
`

`

`July 2009
`
`Gentran:Rea|ti me for zSeries
`
`© Copyright 1988 — 2009
`Sterling Commerce, Inc.
`ALL RIGHTS RESERVED
`
`Sterling Commerce Software
`Trade Secret Notice
`
`THE GENTRAN:REALTIME AND GENTRAN:BASIC FOR ZSERIES 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
`AGREENIENT. NO DUPLICATION OR DISCLOSURE VVITHOUT 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, |nc., 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 1'It|e 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 'I'ItIe 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, Gentran:Basic, Gentranzcontrol, Gentran:PIus, Gentran:ReaItime, Gentran:Structure, and Gentranzviewpoint
`are registered trademarks of Sterling Commerce, Inc.
`
`Third Part
`
`oftware:
`
`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").
`
`Warrany 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 FORA 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.
`
`

`

`Table of Contents
`
`Chapter 1
`
`Getting Started
`Overview ................................................................................................................ .. l -1
`
`Overview of Gentran:Realtime ............................................................................... .. 1-3
`Overview of Features ............................................................................................. .. 1-5
`
`System Overview .................................................................................................. .. 1-13
`
`How Gentran:Realtime Operates .......................................................................... .. 1- 16
`Monitoring System Activity ................................................................................. .. 1- 17
`Dynamically Enabling or Disabling the Gentran:Realtime System ..................... .. 1- 17
`Who Should Maintain the Gentran:Realtime System .......................................... .. 1-17
`Gentran:Realtime Menus ...................................................................................... .. 1- 18
`Gentran:Realtime Screens .................................................................................... .. 1- 19
`
`Function Keys ....................................................................................................... .. 1-22
`Common Keyboard Conventions ......................................................................... .. 1-23
`Basic File Maintenance Procedures ...................................................................... .. 1-24
`
`Jump Codes .......................................................................................................... .. 1-25
`Interactions Between Gentran:Basic and Gentran:Realtime ................................ .. 1-28
`
`Gentran:Plus Processing ....................................................................................... .. 1-3 1
`
`Chapter 2
`
`System Setup Screens
`Overview ................................................................................................................ .. 2-1
`Gentran:Realtime Main Menu .................................. .. EDIM800 ........................... .. 2-2
`
`System Maintenance Menu ...................................... .. EDI)/I801 ........................... .. 2-5
`
`System Options Screen ............................................ .. EDI‘\/[301 ........................... .. 2-8
`Immediate Directory Screen ..................................... .. EDIMS 1 0 ......................... .. 2- 14
`
`Immediate Options Screen ....................................... .. EDl‘\/[81 1 ......................... .. 2- 17
`Queue Directory Screen ........................................... 4. EDI‘\/[302 ......................... .. 2-22
`Queue Options Screen .............................................. ..ED1‘\/[303 ......................... .. 2-26
`Extended Queue Options Screen .............................. .. ED1\/I305 ......................... .. 2-36
`Queue Options Debug Detail Screen ........................ .. EDlI\/I306 ......................... .. 2-39
`Queue File Data Detail Screen ................................. .. EDIM307 ......................... .. 2-44
`
`Schedule Directory Screen ....................................... .. EDIM820 ......................... .. 2-46
`Schedule Options Screen .......................................... .. EDI‘\/[821 ......................... .. 2-49
`Extended Schedule Options Screen .......................... ..ED1I\/[822 ......................... .. 2-54
`
`Gentran:Realtime for zseries Release 6.5 User’s Guide
`
`

`

`Table of Contents
`
`Chapter 3 Monitoring Function Screens
`Overview ................................................................................................................ .. 3-1
`
`Online Log Display Screen ...................................... .. EDIM304 ........................... .. 3-2
`Online Log Detailed Display Screen ........................ .. EDIM308 ........................... .. 3-9
`
`Report Selection Screen ........................................... .. EDI\/I3 1 0 ......................... .. 3- 14
`Gentran:Realtime EDI Report Display Screen........... EDI\/I311 ......................... .. 3-21
`Exception Processing Directory Screen ................... .. EDI\/I850 ......................... .. 3-24
`Exception Data List Screen ...................................... .. EDI\/I851 ......................... .. 3-29
`Exception Data Detail Screen ................................... .. EDIIVI85 3 ......................... .. 3-33
`Gentran:Realtime Activity Summary Screen ........... .. EDI\/I870 ......................... .. 3-35
`Gentran:Realtime Activity Detail Screen ................. .. EDIM871 ......................... .. 3-38
`
`OCF Change Audit Directory................................... .. EDIM320 ......................... .. 3-43
`OCF Change Audit Status ........................................ .. EDI)/I321 ......................... .. 3-45
`OCF Change Audit Detail ........................................ .. EDI‘\/I322 ......................... .. 3-48
`Request Change Audit Directory .............................. .. EDI‘\/I880 ......................... .. 3-50
`Request Change Audit Status ................................... ..EDI\/I881 ......................... .. 3-52
`Request Change Audit Detail ................................... .. EDI‘\/I882 ......................... .. 3-55
`
`Chapter 4
`
`Translation Parameter Screens
`Overview ................................................................................................................ .. 4-1
`
`Enhanced Navigation Feature ................................................................................. .. 4-3
`
`Path Options Directory Screen ................................. .. EDIM830 ........................... .. 4-4
`Outbound Flow ....................................................................................................... .. 4-7
`Inbound Flow ........................................................................................................ .. 4-95
`
`Utility Screens
`Overview ................................................................................................................ .. 5-1
`
`Online Copy Maintenance Screen ............................ .. EDI‘\/I860 ........................... ,. 5-2
`Databank Parameter Maintenance Menu.................. .. EDI\/I862 ........................... .. 5-7
`
`Outbound Application Databank Screen .................. .. EDIM863 ......................... .. 5-10
`Outbound EDI Databank Screen .............................. .. EDIM864 ......................... .. 5-17
`Inbound EDI Databank Screen ................................. .. EDIM865 ......................... .. 5-26
`
`Inbound Application Databank Screen..................... .. EDI\/I866 ......................... .. 5-33
`Change Audit Maintenance Screen .......................... .. EDI\/I874 ......................... .. 5-40
`Acknowledgment Parameter Maintenance Screen
`EDI\/I867 ......................... .. 5-46
`Separator Main Menu ............................................... .. EDIM934 ......................... .. 5-50
`Separator Systems Options Maintenance Screen
`EDIM935 ......................... .. 5-52
`Priority Options Directory Screen ............................ .. EDIM936 ......................... .. 5-59
`
`Priority Options Maintenance Screen ....................... .. EDIM937 ......................... .. 5-62
`Separator Monitor Screen ......................................... .. EDIM938 ......................... .. 5-67
`
`Gentran:Realtime for zseries Release 6.5 User’s Guide
`
`

`

`Table of Contents
`
`Chapter 6 Configuration Strategies
`Overview ................................................................................................................ .. 6-1
`
`Before You Begin ................................................................................................... .. 6-4
`Developing a Configiration Strategy ..................................................................... .. 6-5
`Configuring Application Interfaces ...................................................................... .. 6-12
`Configuring Error Handling and Monitoring ....................................................... .. 6-43
`Configuring TSQ Chaining .................................................................................. .. 6-60
`Configuring Databanking ..................................................................................... .. 6-63
`Configuring System Performance ...................................................................... .. 6-107
`
`Configuring Separator/Router/Splitter Processing ............................................. .. 6-1 19
`Configuring Communications ............................................................................ .. 6- 143
`Configuring Printed Audit Reports .................................................................... .. 6-163
`Configuring Gentran:Realtime for Associated Data Processing ........................ .. 6-166
`Configuring Asynchronous Reporting ............................................................... .. 6- 171
`Configuring JCL Submission and User Security ................................................ .. 6-175
`
`Appendix A Jump Codes
`
`Jump Codes by Screen Title .................................................................................. .. A-1
`Jump Codes by Screen Name ................................................................................ .. A-3
`
`Appendix B System Flow Charts
`
`Overview ................................................................................................................ ..B—1
`
`Appendix C Temporary Storage Queue Usage
`
`Temporary Storage Queues .................................................................................... ..C—1
`
`Terminal-Oriented TSQs ........................................................................................ ..C-2
`
`Appendix D Lock Levels & Multi-threading Considerations
`
`Lock Levels ........................................................................................................... .. D-1
`
`Appendix E CICS Region Information
`
`File Sharing Between Batch and CICS .................................................................. ..E-1
`CICS Region Configuration and Requirements ..................................................... .. E-2
`
`Definition of Terms ............................................................................................... .. G—1
`Reserved Word Constants ................................................................................... .. G-13
`
`Application Data Types ....................................................................................... .. G- 17
`EDI Data Types ................................................................................................... .. G-20
`
`Index
`
`Gentran:Rea1time for zseries Release 6.5 User’s Guide
`
`

`

`Table of Contents
`
`Gentran:Realtime for zseries Release 6.5 User’s Guide
`
`

`

`Getting Started
`
`Overview
`
`Welcome to Gentran:Realtime for zSeries Release 6.5, Sterling Commerce’s Electronic Data
`Interchange (EDI) software for real-time processing. Gentran:Rea1time® provides the tools you
`need to perform EDI in a real-time enviromnent, so transactions are processed and responded to as
`soon as they are received.
`
`This chapter provides an introduction to Gentran:Realti1ne, including information about features
`and benefits, system architecture, and system operation. The following topics related to
`Gentran:Realtime are contained in this chapter:
`
`Topic
`
`Page
`
`Overview of Gentran:Realtime ........................................................................................... 1-3
`
`Gentran:Realtime Functionality .............................................................................. .. 1-4
`Overview of Features............................................................................................................ 1-5
`
`Acknowledgment Processing .................................................................................. .. 1-5
`
`Automated Operations ............................................................................................. .. 1-5
`Choice of Application/Communications Interfaces ................................................ .. 1-5
`CICS-based Translation and Distribution ............................................................... .. 1-5
`
`Interface Options ..................................................................................................... .. 1-6
`Databank Features ................................................................................................... .. 1-7
`
`Error Handling ......................................................................................................... .. 1-9
`Interchangeable Data Maps, Tables, and Profiles ................................................. .. 1-10
`
`Multiple System Images ........................................................................................ .. 1- 10
`Online Configuration and Control ......................................................................... .. 1- 10
`
`Online Reporting ................................................................................................... .. 1- 1 1
`Online Scanner/Initiator ........................................................................................ .. 1-1 1
`
`Separator/Routing .................................................................................................. .. 1- l 1
`System Maintenance .............................................................................................. .. 1-1 1
`System Monitor ..................................................................................................... .. 1- 1 1
`System Online Log ................................................................................................ .. 1- 1 1
`
`Trace Facility ......................................................................................................... .. 1-12
`
`System Overview.....................................
`System Architecture ...................................................................... ..
`
`Gentran:Realtime Gateways .................................................................................. .. 1-14
`Online System Maintenance .................................................................................. .. 1- 14
`Online Log Display ............................................................................................... .. 1- 15
`
`Gentran:Realtime for zseries Release 6.5 User’s Guide
`
`

`

`Getting Started
`
`Overview
`
`Report Selection .................................................................................................... .. 1- 15
`Exception Processing Facility ............................................................................... .. 1- 15
`
`Gentran:Realtime Activity..................................................................................... .. 1-15
`
`How Gentran:Realtime Operates ...................................................................................... 1-16
`Overview of Operation .......................................................................................... .. 1-16
`
`Monitoring System Activity ............................................................................................... 1-17
`
`Dynamically Enabling or Disabling the Gentran:Realtime System .............................. 1-17
`
`Who Should Maintain the Gentran:Realtime System..................................................... 1-17
`Gentran:Realtime Menus................................................................................................... 1-18
`
`Gentran:Realtime Screens .....................
`
`Screen Component Descriptions ........................................................................... ,. 1-20
`
`Function Keys ..................................................................................................................... 1-22
`
`Common Keyboard Conventions .................................................................................... .. 1-23
`Basie File Maintenance Procedures .................. ..
`
`Update Task ........................................................................................................... .. 1-24
`Delete Task ............................................................................................................ .. 1-24
`
`Jump Codes ......................................................................................................................... 1-25
`Jumping Between Screens ..................................................................................... .. 1-25
`Types of Jump Codes ............................................................................................ .. 1-25
`User-Defined Jump Code Table ............................................................................ .. 1-26
`Jump Code Guidelines ........................................................................................... .. 1-27
`Interactions Between Gentran:Basic and Gentran:Realtime......................................... 1-28
`Overview ............................................................................................................... .. 1-28
`
`Databank Considerations ....................................................................................... .. 1-28
`
`Acknowledgment Processing ................................................................................ .. 1-30
`
`Gentran:Plus Processing .................................................................................................... 1-31
`
`Gentran:Realtime for zseries Release 6.5 User’s Guide
`
`

`

`Overview of Gentran:Realtime
`
`Getting Started
`
`Overview of Gentran:Realtime
`
`Gentran:Realtime gives you CICS-based, transaction-oriented translation capabilities for your EDI
`requirements. Mapping, compliance checking, auditing, and acknowledgment processing are run
`online. Some of the features Gentran:Realtime provides are the following:
`
`Gentran:Realtime provides online and batch program-level interfaces (gateways)
`to enable your applications and communications to exchange data with
`Gentran:Realtime.
`
`Gentran:Realtime provides immediate, queue, and schedule modes of processing
`online programs, and queue processing with batch programs. These modes fillfill
`time-sensitive and process-sensitive requirements.
`
`Gentran:Realtime provides online, rea1—time maintenance of your EDI system
`configuration.
`
`Gentran:Realtime provides online, real-time monitoring and reporting of EDI
`processing.
`
`Gentran:Realtime is completely compatible with Gentran:Basic for zSeries
`Release 6.5. Maps, tables, and partners are shared between Gentran:Basic and
`Gentran:Realtime.
`
`Gentran:Realtime provides a direct link with communications through the
`Connect Communications product.
`
`Gentran:Realtime provides a system of separating batches of interchanges into
`individual interchanges and routing these to Gentran:Realtime or Gentran:Basic
`translation.
`
`Gentran:Realtime for zSeries Release 6.5 User’s Guide
`
`

`

`Getting Started
`
`Overview of Gentran:Realtime
`
`Gentran:Rea|time Functionality
`
`Figure 1.1 describes Gentran:Rea1time functionality.
`
`Application Gateway
`
`Security
`
`Core Translation
`
`System Operation
`
`Mapping & Compliance
`
`System '—099i"Q
`
`Acknowledgment Processing
`
`Communications Gateway
`
`Figure 1.1 Gentran:Rea|time Functionality
`
`Gentran:Realtime for zSeries Release 6.5 User’s Guide
`
`