Gentran:Basic® for zSeries
`
`User’s Guide
`
`Release 6.5
`
`Sire.-‘iing Commerce
`
`Sterling Commerce (Mid America), Inc.
`4600 Lakehurst Court Dublin, OH 43016-2000 * 614/793-4000
`© Copyright 1988 — 2009/Sterling Commerce, Inc‘
`
`2204-650-USERO 1-000 I
`
`

`

`July 2009
`
`Gentran:Basic for zSeries
`
`© Copyright 1988 — 2009
`Sterling Commerce, Inc.
`ALL RIGHTS RESERVED
`
`Sterling Commerce Software
`Trade Secret Notice
`
`THE 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 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 Iicensors, 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 'I'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 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, Gentran:Basic, Gentran:Contro|, Gentran:P|us, Gentran:Rea|time, Gentran:Structure, and Gentran:Viewpoint
`are registered trademarks of Sterling Commerce, Inc.
`
`Thir P
`
`wr:
`
`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").
`
`Warrang 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.
`
`

`

`Table of Contents
`
`Chapter 1
`
`Getting Started
`Overview of Gentran:Basic .................................................................................... .. 1-3
`How to Learn About Gentran:Basic ....................................................................... .. 1-4
`What is EDI? .......................................................................................................... .. 1-5
`EDI Terms .............................................................................................................. .. 1-6
`
`System Overview.................................................................................................... .. 1-7
`Databank Maintenance ......................................................................................... .. 1-12
`
`Getting Started with Gentran:Basic ...................................................................... .. I-13
`Gentran:Basic Online System Operation Basics .................................................. .. 1-15
`Gentran:Basic Menu Options ............................................................................... .. 1- 1 8
`Using Action Codes .............................................................................................. .. 1-24
`Getting Help ........................................................................................................ .. 1-25
`Function Keys ....................................................................................................... .. 1-27
`Common Keyboard Conventions ......................................................................... .. 1-28
`Basic File Maintenance Procedures ...................................................................... .. 1-29
`
`Jump Codes .......................................................................................................... .. 1-30
`
`Chapter 2
`
`The Partner Subsystem
`Overview ................................................................................................................ .. 2-1
`
`Before You Begin ................................................................................................... .. 2-3
`Partner Maintenance Menu................................................................... .. EDI\/1005 2-10
`
`Partner Directory .................................................................................. .. EDIVI010 2-13
`Partner Selection Menu ........................................................................ .. EDIM007 2-17
`Header Information Screen .................................................................. .. EDIM026 2-22
`
`Interchange Directory Screen ............................................................... .. EDI\/I027 2-27
`Control Infomiation Screen 1 ............................................................... .. EDIM015 2-31
`
`Control Information Screen 2—ISA Options ....................................... .. EDIM016 2-37
`Control Information Screen 2—ICS Options ....................................... .. EDIM018 2-43
`Control Information Screen 2—GS and BG Options ........................... .. EDI\/I017 2-48
`Control Information Screen 2—UNA Options ..................................... .. EDI\/1012 2-52
`Control Information Screen 2—UNB Options ..................................... .. EDI\/I019 2-57
`Control Information Screen—UNB Options
`Part 1 / Syntax Version 4 ...................................................................... .. EDI_\/I021 2-62
`Control Information Screen—UNB Options
`Part 2 / Syntax Version 4 ...................................................................... .. EDI\/I022 2-67
`Control Information Screen 2—SCH Options ..................................... .. EDI\/I013 2-71
`Control Information Screen 2—STX Options ...................................... .. EDIM014 2-76
`Group Directory.................................................................................... .. EDI.\/I020 2-81
`Group Information Screen .................................................................... .. EDI\/I030 2-86
`Group Information Screen—BAT Options ......................................... .. EDI\/I031 2-93
`Group Information Screen—UNG Options ......................................... .. EDIM032 2-98
`Group Infomiation Screen—GS Options .......................................... .. EDIM033 2-103
`
`Gentran:Basic for zseries Release 6.5 User’s Guide
`
`

`

`Table of Contents
`
`Transaction Directory ......................................................................... .. EDIM025 2-108
`Transaction Information Screen ......................................................... ..EDI‘\/I040 2-1 13
`
`Transaction Information Screen—ST Options .................................. .. EDIM043 2-120
`Transaction Information Screen—UNH Options
`Part 1 .................................................................................................. ..EDII\/I042 2-124
`
`Transaction Information Screen—UNH Options
`Part 2 ................................................................................................... .. EDIVI046 2-128
`
`Transaction Information Screen—UNH Options
`Part 3 ................................................................................................... .. EDIVI047 2-132
`
`Transaction Information Screen—l\/HID Options ............................. .. EDI)/I041 2-136
`Name and Address Screen .................................................................. .. EDIM035 2-140
`Name and Address Part 2 Screen ....................................................... .. EDIM036 2-144
`User Defined Screen .......................................................................... .. EDIM045 2-148
`
`Data Separation Screen....................................................................... .. EDI)/I050 2-152
`Error Rejection Screen ....................................................................... .. EDIM055 2-158
`Copy All Records Screen ................................................................... .. EDIMO60 2-162
`Partner Cross Reference Menu ........................................................... .. EDIM009 2-166
`
`Partner Cross Reference By X-Ref ID Screen ................................... .. EDIM008 2-168
`Partner Cross Reference By Partner ID Screen .................................. .. EDIM006 2-172
`Trading Partner Relationship Menu ................................................... .. EDIM009 2-175
`Trading Partner Relationship By EDI ID Screen ............................... ..EDI‘\/1023 2-177
`Trading Partner Relationship By Partner Screen................................ .. EDIM024 2-182
`
`Chapter 3
`
`The Standards Subsystem
`Overview ................................................................................................................ .. 3-1
`
`Before You Begin ................................................................................................... .. 3-2
`Standards Maintenance Menu ................................................................ .. EDIM100 3-8
`
`Version Directory ................................................................................. .. EDI\/I1 1 1 3-11
`Version Screen...................................................................................... .. EDIM1 10 3-14
`
`Version/Transaction Directory ............................................................. .. EDIVI1 13 3-17
`Transaction Directory .......................................................... ..EDIM121/EDIVI122 3-21
`Transaction Screen ............................................................................... .. EDIM120 3-27
`
`Segments Screen ................................................................................... .. EDI.\/I130 3-33
`Segment Element Screen ...................................................................... .. EDI\/I140 3-38
`Segment Element .................................................................................. .. EDI\/I141 3-44
`Segment Element Activity Screen ........................................................ .. EDL\/I150 3-49
`Data Element Definition Screen ........................................................... .. EDI)/I160 3-54
`Standard Code Menu ............................................................................ .. EDIM170 3-58
`
`Standard Code Directory ...................................................................... .. EDIVI171 3-60
`Standard Code Maintenance Screen ..................................................... 1. EDI}/I172 3-63
`
`Code Maintenance List Options Screen ............................................... .. EDIMI73 3-66
`Transaction in Use Screen .................................................................... .. EDIM180 3-68
`Standard Association Screen ................................................................ .. EDD/I105 3-72
`
`Chapter 4
`
`The Databank Subsystem
`Overview ................................................................................................................ .. 4-1
`
`Before You Begin ................................................................................................... .. 4-3
`Databank Screens and Functions .......................................................................... .. 4-10
`How to Use the Maintenance Functions ............................................................... .. 4-14
`
`Gentran:Basic for zSeries Release 6.5 User’s Guide
`
`

`

`Table of Contents
`
`Databank Maintenance Menu ............................................................... .. EDI\/I250 4-24
`
`Interchange Directory Screen ............................................................... .. EDIM254 4-27
`Group Directory.................................................................................... .. EDI.\/I255 4-31
`Group Directory — Date ....................................................................... .. EDIM25A 4-36
`Interchange Status Screen.................................................................... .. EDI\/I251 4-41
`Group Status Screen ............................................................................. .. EDLVI252 4-48
`Transaction Status Screen..................................................................... .. EDIM253 4-55
`
`Document Directory ............................................................................. .. EDI.\/I262 4-61
`Document Status Screen ....................................................................... .. EDIM263 4-65
`
`Change Audit Directory ....................................................................... .. EDI)/I268 4-70
`Change Audit Status Screen ................................................................. .. EDIM269 4-74
`Online Log Display Screen ................................................................ ..EDIMOLD 4-79
`Acknowledgment Overdue Directory Screen ....................................... .. EDI\/[240 4-83
`Acknowledgment Overdue Detail Screen ............................................ .. EDl\/1241 4-88
`Interchange Status Detail Screen—Outbound ...................................... .. EDIM271 4-93
`Interchange Status Detail Screen—Inbound ........................................ .. EDIM271 4-98
`Interchange Display Screen ................................................................ CA EDIVI256 4-102
`Group Display Screen......................................................................... .. EDIM257 4-107
`Transaction Status Detail Screen—Outbound .................................... .. EDIM258 4-112
`Transaction Status Detail Screen—Inbound ..................................... .. EDIM258 4-117
`
`Transaction Display Screen ................................................................ .. EDIM259 4-122
`Segment Display Screen ..................................................................... .. EDIM260 4-126
`Data Element Display Screen ............................................................. .. EDI\/I261 4-130
`Document Status Detail Screen — Outbound ...................................... .. EDIM265 4-134
`Document Status Detail Screen—Inbound ......................................... .. EDI\/[265 4-139
`
`Document Display Screen .................................................................. .. EDIM264 4- 144
`Record Display Screen ....................................................................... .. EDIM266 4-148
`Field Display Screen........................................................................... .. EDI\/[267 4-15]
`Change Audit Status Detail Screen .................................................... .. EDI)/I270 4-154
`
`The Administration Subsystem
`Overview ................................................................................................................ .. 5-1
`
`Before You Begin ................................................................................................... .. 5-4
`Administrative Main Menu .................................................................... .. EDIM210 5-7
`
`Security Maintenance Menu ................................................................. .. EDIM200 5-10
`User ID Directory ................................................................................. .4 EDI\/I203 5- 12
`User ID Maintenance Screen ................................................................ .. EDI\/I201 5-15
`User ID Maintenance Screen — Add On Products ................................ .. EDI\/I202 5-23
`
`Message Maintenance Menu ................................................................ .. EDIM21l 5-25
`Message Directory ................................................................................ .. EDIM212 5-27
`Message Maintenance Screen............................................................... .. EDIVI213 5-30
`Error Rejection Maintenance Screen .................................................... .. EDIM214 5-35
`Configuration Directory ....................................................................... .. EDIM230 5-38
`Configuration Maintenance Screen ...................................................... .. EDIM231 5-40
`Configuration Maintenance Screen ...................................................... .. EDI\/[231 5-43
`Configuration Maintenance Screen ...................................................... .. EDIVI231 5-47
`Configuration Maintenance Screen ...................................................... .. EDIVI231 5-50
`
`Gentran:Basie for zSeries Release 6.5 User’s Guide
`
`

`

`Table of Contents
`
`Configuration Maintenance Screen ...................................................... .. EDIM231 5-53
`Configuration Maintenance Screen ...................................................... 1. EDIM231 5-55
`Configuration Maintenance Screen ...................................................... .. EDIM231 5-58
`Configuration Maintenance Screen ...................................................... .. EDIM231 5-61
`Configuration Maintenance Screen ...................................................... .. EDIM231 5-64
`Configuration Maintenance Screen ...................................................... .. EDIM231 5-66
`Configiration Maintenance Screen ...................................................... .. EDIM231 5-69
`Configuration Maintenance Screen ...................................................... .. EDIM231 5-71
`Global Parameter Maint 1 Screen ....................................... .. ED1M220/EDIM22A 5-73
`Global Parameter Maint 2 Screen ...................................... .. EDIM22l/EDIM22B 5-77
`Global Parameter Maint 3 Screen......................................................... .. EDIM222 5-82
`Global Parameter Maint 4 Screen ....................................... ..ED1M223/EDIM22D 5-85
`Global Parameter Maint 5 Screen ....................................... .. EDIM224fEDIM22E 5-89
`Global Parameter Maint 6 Screen ....................................... .. EDIM225/EDIM22F 5-94
`
`Partner Migration Menu ........................................................................ ..EDIY100 5-98
`User Selection Screen .......................................................................... ..EDIY200 5-101
`User Maintenance Screen .................................................................... ..ED1Y500 5-103
`Partner Selection Screen ...................................................................... ..EDIY300 5-106
`
`Relationship Maintenance Screen ....................................................... ..EDIY400 5-109
`Data Translation Table Directory Screen ............................................ ..EDIY600 5-112
`Data Table Migration Selection Screen............................................... ..EDIY610 5-115
`Data Table Migration Maintenance Screen ......................................... ..ED1Y620 5-117
`Upload Process Maintenance ............................................................. .. EDIM235 5-120
`Separator Main Menu ......................................................................... .. EDIM934 5-123
`Separator Systems Options Maintenance Screen ............................... .. EDI)/I935 5-125
`Priority Options Directory Screen ...................................................... .. EDIM936 5-132
`Priority Options Maintenance Screen ................................................. ..ED1M937 5-135
`Change Audit Main Menu .................................................................. ..ED1M209 5-140
`Partner Change Audit Directory ......................................................... .. EDI)/I070 5-143
`Partner Change Audit Status .............................................................. .. EDlM07l 5-146
`Partner Change Audit Detail .............................................................. ..ED1M072 5-151
`XREF Change Audit Directory .......................................................... ..ED1M074 5-155
`XREF Change Audit Status ................................................................ .. EDIM075 5-157
`XREF Change Audit Detail ................................................................ ..ED1I\/1076 5-160
`PARTREL Change Audit Directory ................................................... .. EDIMO77 5-162
`PARTREL Change Audit Status ........................................................ ..ED1M078 5-164
`PARTREL Change Audit Detail ........................................................ .. EDIM079 5-167
`Standards Change Audit Directory..................................................... .. EDIMl8l 5-170
`Standards Change Audit Status .......................................................... .. ED1Ml82 5-172
`Standards Change Audit Detail .......................................................... .. EDlMl83 5- 176
`Application Change Audit Directory .................................................. .. ED1M56O 5-179
`Application Change Audit Status ....................................................... ..ED1M561 5-182
`Application Change Audit Detail ....................................................... .. EDIM562 5-185
`Transaction Change Audit Directory .................................................. .. EDIM520 5-188
`Transaction Change Audit Status ....................................................... .. EDlM52l 5-191
`Transaction Change Audit Detail ....................................................... .. EDIM522 5-194
`Code Table Change Audit Directory .................................................. .. EDIM587 5-197
`Code Table Change Audit Status ....................................................... .. EDIM588 5-200
`Code Table Change Audit Detail ....................................................... .. EDIM589 5-203
`Security Change Audit Directory ....................................................... .. EDlM204 5-206
`
`Gentran:Basic for zSeries Release 6.5 User’s Guide
`
`

`

`Table of Contents
`
`Security Change Audit Status ............................................................. .. EDIVI205 5-208
`Security Change Audit Detail ............................................................. ..EDII\/[206 5-211
`Error Message Change Audit Directory ............................................. .. EDD/I215 5-213
`Error Message Change Audit Status ................................................... .. EDIM216 5-215
`Error Message Change Audit Detail ................................................... .. EDIVI217 5-218
`Configuration Change Audit Directory .............................................. .. EDIM232 5-221
`Configuration Change Audit Status.................................................... .. EDI\/[233 5-223
`Configuration Change Audit Detail.................................................... .. EDIM234 5-226
`Global Parameter Change Audit Directory ........................................ .. EDIM226 5-228
`Global Parameter Change Audit Status .............................................. .. EDIM227 5-230
`Global Parameter Change Audit Detail .............................................. .. EDlM228 5-233
`Separator Change Audit Directory ..................................................... .. EDIM938 5-235
`Separator Change Audit Status ........................................................... .,EDl‘\/[939 5-238
`Separator Change Audit Detail ........................................................... .. EDlM94O 5-242
`Message Center Job Summary .......................................................... ,. EDIM245 5-245
`Message Center Job Detail ................................................................ .. EDLVI246 5-249
`Message Center Report Display ........................................................ .. EDIM247 5-252
`
`Chapter 6
`
`The Mapping Subsystem
`Overview ................................................................................................................ .. 6-1
`
`Before You Begin ................................................................................................... .. 6-2
`Mapping Maintenance Menu ................................................................ .. EDIM599 6-14
`Application Definition Menu ............................................................... .. EDI\/[550 6-16
`Application Directory ........................................................................... .. EDIM551 6- 19
`Application Data ID Screen .................................................................. .. EDIM552 6-23
`Copy Application Definition Screen .................................................... .. EDIM557 6-28
`Application Records Screen ................................................................. .. EDI.\/I553 6-31
`Application Fields Screen..................................................................... .. EDI\/I554 6-37
`Application Partner Reference Screen.................................................. .. EDD/I555 6-43
`Application Envelope Definition Screen .............................................. .. EDIM558 6-47
`Transaction Mapping Menu ................................................................. .. EDl\/1500 6-52
`Transaction Mapping Directory ........................................................... .. EDIM512 6-55
`Transaction Maintenance Screen .......................................................... .. EDIM503 6-58
`
`Copy Transaction Screen ...................................................................... .. EDL\/I501 6-63
`Copy Segments From Standard Screen .................................................. EDIM502 6-66
`Segments Screen ................................................................................... .. EDl\/I504 6-70
`Element Mapping Inbound Screen ....................................................... .. EDIVI514 6-76
`Element Mapping Outbound Screen .................................................... .. EDI\/I511 6-83
`Extended Element Mapping Inbound Screen ....................................... .. EDIM513 6-89
`Extended Element Mapping Outbound Screen .................................. .. EDIM508 6-100
`Build Repeating Data Elements Screen.............................................. .. EDIM5l7 6-1 10
`Element Information Screen ............................................................... .. EDIM515 6- 1 15
`Select Codes Screen ........................................................................... .. EDIMSO9 6-119
`
`Select Application Data Screen .......................................................... .. EDIM510 6-122
`Copy Segments From Transaction Screen ......................................... .. EDIMSOS 6-125
`Subfield Screen ................................................................................... ..EDlM507 6-129
`Code and Data Translation Menu ....................................................... .. EDIM5 80 6-134
`
`Gentran:Basic for zSeries Release 6.5 User’s Guide
`
`

`

`Table of Contents
`
`Table Directory ................................................................................... .. EDIM586 6-136
`Define Translation Table Screen ........................................................ .. EDIM58l 6-139
`
`Copy Code or Data Screen ................................................................. ..EDIM582 6-144
`Code Translation Screen..................................................................... .. EDIM583 6-148
`
`Data Translation By Partner Screen ................................................... .. EDIM584 6-152
`Data Validation Screen ....................................................................... .. EDIM585 6-157
`
`Chapter 7
`
`System Features: Tips and Techniques
`Overview ................................................................................................................ .. 7-1
`Associated Data — ASC X12 102 Transactions ...................................................... .. 7-4
`
`Associated Data — EDIFACT Packages ............................................................... .. 7-11
`Batch Separator .................................................................................................... .. 7-25
`Binary Data — X12 ............................................................................................... .. 7-36
`Change Audit in Gentran:Basic ............................................................................ .. 7-44
`Configuring JCL Submission and User Security.................................................. .. 7-85
`Inbound Application Constant Records................................................................ .. 7-90
`Interchange Version.............................................................................................. .. 7-94
`Multiple Envelope IDs ....................................................................................... .. 7-100
`Repeating Data Elements ................................................................................... .. 7-107
`Element Mapping Inbound screen example: ...................................................... .. 7-115
`Standards Updates .............................................................................................. .. 7-116
`Underscore Substitution Characters ................................................................... .. 7-136
`
`Unload/Upload Facility ...................................................................................... .. 7-15 8
`Using the User Security Facility ......................................................................... .. 7-170
`
`Appendix A Jump Codes
`
`Jump Codes By Subsystem ................................................................................... .. A-1
`Jump Codes By Screen Name ............................................................................. .. A-10
`
`Glossary
`
`Definition of Terms ............................................................................................... .. G-1
`Reserved Word Constants ................................................................................... .. G-1 1
`
`Application Data Types ....................................................................................... .. G—17
`EDI Data Types ................................................................................................... .. G-20
`
`Gentran:Basic for zSeries Release 6.5 User’s Guide
`
`

`

`Getting Started
`
`This chapter introduces Gentran:Basic® for zSeries® and provides descriptions of the system
`features and benefits, system architecture, and operation. This chapter contains the following
`topics:
`
`Topic
`
`Page
`
`Overview of Gentran:Basic.................................................................................................. 1-3
`
`How to Learn About Gentran:Basic ................................................................................... 1-4
`
`What is EDI? ......................................................................................................................... 1-5
`
`Manual Data Exchange ............................................................................................ .. 1-5
`Electronic Data Interchange .................................................................................... ,. 1-6
`
`EDI Terms ............................................................................................................................. 1-6
`
`System Overview..............