IBM® Sterling Gentran Gz OS66_Gentran_Basic_User_Guide OS66 Basic User Guide

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

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

IBM Sterling Gentran:Basic for z/OS
User Guide
Release 6.6
2204-650-USER01-0002
This edition applies to the 6.6 Version of IBM® Sterling Gentran:Basic® for z/OS® and to all
subsequent releases and modifications until otherwise indicated in new editions.
Before using this information and the product it supports, read the information in Notices on page
N-1.
Licensed Materials - Property of IBM
IBM® Sterling Gentran:Basic® for z/OS®
© Copyright IBM Corp. 1988, 2011. All Rights Reserved.
US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP
Schedule Contract with IBM Corp.
.
Chapter
IBM Sterling Gentran:Basic for zOS Release 6.6 User Guide - i
Table of Contents
Partner Maintenance Menu...................................................... EDIM005......... 2-10
Partner Directory.................................................................... EDIM010......... 2-13
Partner Selection Menu............................................................ EDIM007......... 2-17
Header Information Screen...................................................... EDIM026......... 2-22
Interchange Directory Screen................................................... EDIM027......... 2-27
Control Information 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....................EDIM017......... 2-48
Control Information Screen 2—UNA Options..............................EDIM012 ........ 2-52
Control Information Screen 2—UNB Options..............................EDIM019......... 2-57
Control Information Screen—UNB Options
Part 1 / Syntax Version 4.......................................................... EDIM021......... 2-62
Control Information Screen—UNB Options
Part 2 / Syntax Version 4.......................................................... EDIM022......... 2-67
Control Information Screen 2—SCH Options.............................. EDIM013......... 2-71
Control Information Screen 2—STX Options.............................. EDIM014......... 2-76
Group Directory........................................................................... EDIM020......... 2-81
Group Information Screen EDIM030......... 2-86
Group Information Screen—BAT Options EDIM031......... 2-93
Group Information Screen—UNG Options EDIM032......... 2-98
Group Information Screen—GS Options ................................... EDIM033....... 2-103
Transaction Directory.............................................................. EDIM025....... 2-108
Transaction Information Screen................................................ EDIM040....... 2-113
Transaction Information Screen—ST Options ........................... EDIM043....... 2-120
Transaction Information Screen—UNH Options
Part 1 .................................................................................... EDIM042....... 2-124
Transaction Information Screen—UNH Options
Part 2..................................................................................... EDIM046....... 2-128
Transaction Information Screen—UNH Options
Part 3..................................................................................... EDIM047....... 2-132
Transaction Information Screen—MHD Options........................ EDIM041....... 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............................................................. EDIM050....... 2-152
Error Rejection Screen................................................................ EDIM055....... 2-158
Copy All Records Screen.......................................................... EDIM060....... 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
- ii IBM Sterling Gentran:Basic for zOS Release 6.6 User Guide
Trading Partner Relationship Menu............................................. EDIM009....... 2-175
Trading Partner Relationship By EDI ID Screen..........................EDIM023....... 2-177
Trading Partner Relationship By Partner Screen.......................... EDIM024....... 2-182
Standards Maintenance Menu.................................................... EDIM100........... 3-8
Version Directory..................................................................... EDIM111......... 3-11
Version Screen............................................................................ EDIM110......... 3-14
Version/Transaction Directory................................................... EDIM113......... 3-17
Transaction Directory....................................................... EDIM121/EDIM122 3-21
Transaction Screen.................................................................. EDIM120......... 3-27
Segments Screen........................................................................... EDIM130......... 3-33
Segment Element Screen........................................................... EDIM140......... 3-38
Segment Element.......................................................................... EDIM141......... 3-44
Segment Element Activity Screen................................................ EDIM150......... 3-49
Data Element Definition Screen....................................................EDIM160......... 3-54
Standard Code Menu................................................................. EDIM170......... 3-58
Standard Code Directory........................................................... EDIM171......... 3-60
Standard Code Maintenance Screen............................................ EDIM172......... 3-63
Code Maintenance List Options Screen....................................... EDIM173......... 3-66
Transaction in Use Screen......................................................... EDIM180......... 3-68
Standard Association Screen...................................................... EDIM105......... 3-72
Databank Maintenance Menu.................................................... EDIM250......... 4-24
Interchange Directory Screen................................................... EDIM254......... 4-27
Group Directory...................................................................... EDIM255......... 4-31
Group Directory – Date........................................................... EDIM25A ........ 4-36
Interchange Status Screen............................................................. EDIM251 ........ 4-41
Group Status Screen................................................................ EDIM252......... 4-48
Transaction Status Screen........................................................ EDIM253......... 4-55
Document Directory................................................................ EDIM262......... 4-62
Document Status Screen.......................................................... EDIM263......... 4-66
Change Audit Directory............................................................ EDIM268......... 4-72
Change Audit Status Screen...................................................... EDIM269......... 4-76
Online Log Display Screen...........................................................EDIMOLD ....... 4-81
Acknowledgment Overdue Directory Screen............................... EDIM240......... 4-86
Acknowledgment Overdue Detail Screen.................................... EDIM241......... 4-91
Interchange Status Detail Screen—Outbound.............................. EDIM271......... 4-96
Interchange Status Detail Screen—Inbound................................ EDIM271....... 4-101
Interchange Display Screen.......................................................... EDIM256....... 4-105
Group Display Screen............................................................... EDIM257....... 4-110
Transaction Status Detail Screen—Outbound...............................EDIM258....... 4-115
Transaction Status Detail Screen—Inbound................................. EDIM258....... 4-120
Transaction Display Screen...........................................................EDIM259....... 4-125
Segment Display Screen............................................................ EDIM260....... 4-129
Data Element Display Screen...................................................... EDIM261....... 4-133
Document Status Detail Screen – Outbound.................................EDIM265....... 4-137
Document Status Detail Screen—Inbound....................................EDIM265 ...... 4-142
Document Display Screen............................................................ EDIM264....... 4-147
Record Display Screen.............................................................. EDIM266....... 4-151
Field Display Screen.................................................................. EDIM267....... 4-154
Change Audit Status Detail Screen.............................................. EDIM270....... 4-157
Administrative Main Menu...........................................................EDIM210........... 5-7
IBM Sterling Gentran:Basic for zOS Release 6.6 User Guide - iii
Security Maintenance Menu..........................................................EDIM200......... 5-10
User ID Directory..................................................................... EDIM203......... 5-12
User ID Maintenance Screen...................................................... EDIM201......... 5-15
User ID Maintenance Screen – Add On Products.........................EDIM202......... 5-23
Message Maintenance Menu...................................................... EDIM211......... 5-25
Message Directory...................................................................... EDIM212......... 5-27
Message Maintenance Screen....................................................... EDIM213......... 5-30
Error Rejection Maintenance Screen........................................... EDIM214......... 5-35
Configuration Directory............................................................ EDIM230......... 5-38
Configuration Maintenance Screen...............................................EDIM231......... 5-40
Configuration Maintenance Screen...............................................EDIM231......... 5-43
Configuration Maintenance Screen...............................................EDIM231......... 5-47
Configuration Maintenance Screen...............................................EDIM231......... 5-50
Configuration Maintenance Screen.............................................. EDIM231......... 5-53
Configuration Maintenance Screen...............................................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
Configuration Maintenance Screen...............................................EDIM231......... 5-69
Configuration Maintenance Screen............................................. EDIM231......... 5-72
Global Parameter Maint 1 Screen....................................... EDIM220/EDIM22A 5-74
Global Parameter Maint 2 Screen....................................... EDIM221/EDIM22B 5-78
Global Parameter Maint 3 Screen............................................... EDIM222......... 5-83
Global Parameter Maint 4 Screen....................................... EDIM223/EDIM22D 5-86
Global Parameter Maint 5 Screen....................................... EDIM224/EDIM22E 5-90
Global Parameter Maint 6 Screen....................................... EDIM225/EDIM22F 5-95
Partner Migration Menu............................................................. EDIY100......... 5-99
User Selection Screen................................................................ EDIY200....... 5-102
User Maintenance Screen............................................................ EDIY500....... 5-104
Partner Selection Screen............................................................ EDIY300....... 5-107
Relationship Maintenance Screen................................................ EDIY400....... 5-110
Data Translation Table Directory Screen..................................... EDIY600....... 5-113
Data Table Migration Selection Screen........................................ EDIY610....... 5-116
Data Table Migration Maintenance Screen...................................EDIY620 ....... 5-118
Upload Process Maintenance...................................................... EDIM235....... 5-121
Separator Main Menu................................................................ EDIM934....... 5-124
Separator Systems Options Maintenance Screen..........................EDIM935....... 5-126
Priority Options Directory Screen............................................... EDIM936....... 5-133
Priority Options Maintenance Screen.......................................... EDIM937....... 5-136
Change Audit Main Menu.......................................................... EDIM209....... 5-141
Partner Change Audit Directory.................................................. EDIM070....... 5-144
Partner Change Audit Status........................................................ EDIM071....... 5-147
Partner Change Audit Detail......................................................... EDIM072....... 5-152
XREF Change Audit Directory................................................... EDIM074....... 5-156
XREF Change Audit Status........................................................ EDIM075....... 5-158
XREF Change Audit Detail......................................................... EDIM076....... 5-161
PARTREL Change Audit Directory............................................. EDIM077....... 5-163
PARTREL Change Audit Status.................................................. EDIM078....... 5-165
PARTREL Change Audit Detail...................................................EDIM079....... 5-168
- iv IBM Sterling Gentran:Basic for zOS Release 6.6 User Guide
Standards Change Audit Directory................................................EDIM181 ...... 5-171
Standards Change Audit Status................................................... EDIM182....... 5-173
Standards Change Audit Detail.....................................................EDIM183....... 5-177
Application Change Audit Directory............................................ EDIM560....... 5-180
Application Change Audit Status................................................. EDIM561....... 5-183
Application Change Audit Detail..................................................EDIM562....... 5-186
Transaction Change Audit Directory............................................ EDIM520....... 5-189
Transaction Change Audit Status................................................ EDIM521....... 5-192
Transaction Change Audit Detail................................................. EDIM522....... 5-195
Code Table Change Audit Directory............................................ EDIM587....... 5-198
Code Table Change Audit Status................................................. EDIM588....... 5-201
Code Table Change Audit Detail.................................................. EDIM589....... 5-204
Security Change Audit Directory................................................ EDIM204....... 5-207
Security Change Audit Status....................................................... EDIM205....... 5-209
Security Change Audit Detail EDIM206....... 5-212
Error Message Change Audit Directory........................................EDIM215....... 5-214
Error Message Change Audit Status............................................. EDIM216....... 5-216
Error Message Change Audit Detail............................................ EDIM217....... 5-219
Configuration Change Audit Directory........................................ EDIM232....... 5-222
Configuration Change Audit Status............................................. EDIM233....... 5-224
Configuration Change Audit Detail.............................................. EDIM234....... 5-227
Global Parameter Change Audit Directory...................................EDIM226....... 5-229
Global Parameter Change Audit Status........................................ EDIM227....... 5-231
Global Parameter Change Audit Detail.........................................EDIM228....... 5-234
Separator Change Audit Directory............................................... EDIM938....... 5-236
Separator Change Audit Status................................................... EDIM939....... 5-239
Separator Change Audit Detail.................................................... EDIM940....... 5-243
Message Center Job Summary................................................... EDIM245....... 5-246
Message Center Job Detail........................................................... EDIM246....... 5-250
Message Center Report Display.................................................. EDIM247....... 5-253
Mapping Maintenance Menu....................................................... EDIM599......... 6-14
Application Definition Menu........................................................ EDIM550......... 6-16
Application Directory....................................................................EDIM551......... 6-19
Application Data ID Screen......................................................... EDIM552......... 6-23
Copy Application Definition Screen.............................................EDIM557......... 6-28
Application Records Screen......................................................... EDIM553......... 6-31
Application Fields Screen............................................................ EDIM554......... 6-37
Application Partner Reference Screen.......................................... EDIM555......... 6-43
Application Envelope Definition Screen.......................................EDIM558......... 6-47
Transaction Mapping Menu.......................................................... EDIM500......... 6-52
Transaction Mapping Directory.................................................. EDIM512......... 6-55
Transaction Maintenance Screen................................................. EDIM503......... 6-58
Copy Transaction Screen............................................................. EDIM501......... 6-63
Copy Segments From Standard Screen....................................... EDIM502......... 6-66
Segments Screen......................................................................... EDIM504......... 6-70
Element Mapping Inbound Screen................................................EDIM514......... 6-76
Element Mapping Outbound Screen............................................. EDIM511......... 6-83
Extended Element Mapping Inbound Screen................................EDIM513......... 6-89
Extended Element Mapping Outbound Screen..............................EDIM508 ...... 6-100
Build Repeating Data Elements Screen.........................................EDIM517 ...... 6-110
IBM Sterling Gentran:Basic for zOS Release 6.6 User Guide - v
Element Information Screen....................................................... EDIM515....... 6-115
Select Codes Screen................................................................. EDIM509....... 6-119
Select Application Data Screen.....................................................EDIM510....... 6-122
Copy Segments From Transaction Screen.................................... EDIM505....... 6-125
Subfield Screen............................................................................. EDIM507....... 6-129
Code and Data Translation Menu................................................. EDIM580....... 6-134
Table Directory............................................................................. EDIM586....... 6-136
Define Translation Table Screen...................................................EDIM581....... 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 1 Getting Started
Overview of Sterling Gentran:Basic ........................................................................ 1-3
How to Learn About Sterling Gentran:Basic ........................................................... 1-4
What is EDI? ............................................................................................................ 1-5
EDI Terms ................................................................................................................ 1-6
System Overview...................................................................................................... 1-7
Databank Maintenance ........................................................................................... 1-12
Getting Started with Sterling Gentran:Basic .......................................................... 1-13
Sterling Gentran:Basic Online System Operation Basics ...................................... 1-15
Sterling Gentran:Basic Menu Options.................................................................... 1-18
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.......................................................... EDIM005......... 2-10
Partner Directory........................................................................ EDIM010......... 2-13
Partner Selection Menu........................................ .................... EDIM007......... 2-17
Header Information Screen........................................................... EDIM026......... 2-22
Interchange Directory Screen....................................................... EDIM027......... 2-27
Control Information 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....................EDIM017......... 2-48
Control Information Screen 2—UNA Options............................. EDIM012......... 2-52
Control Information Screen 2—UNB Options............................. EDIM019......... 2-57
Control Information Screen—UNB Options
Part 1 / Syntax Version 4.......................................................... EDIM021......... 2-62
Control Information Screen—UNB Options
Part 2 / Syntax Version 4............................................................. EDIM022......... 2-67
Control Information Screen 2—SCH Options.............................. EDIM013......... 2-71
- vi IBM Sterling Gentran:Basic for zOS Release 6.6 User Guide
Control Information Screen 2—STX Options.............................. EDIM014......... 2-76
Group Directory....................................................................... EDIM020......... 2-81
Group Information Screen......................................................... EDIM030......... 2-86
Group Information Screen—BAT Options ..................................EDIM031......... 2-93
Group Information Screen—UNG Options ................................. EDIM032......... 2-98
Group Information Screen—GS Options..................................... EDIM033....... 2-103
Transaction Directory................................................................ EDIM025....... 2-108
Transaction Information Screen................................................... EDIM043....... 2-120
Transaction Information Screen—UNH Options
Part 1............................................................................................ EDIM042....... 2-124
Transaction Information Screen—UNH Options
Part 2........................................................................................... EDIM046....... 2-128
Transaction Information Screen—UNH Options
Part 3..............................................................................................EDIM047 ...... 2-132
Transaction Information Screen—MHD Options .........................EDIM041 ...... 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............................................................. EDIM050....... 2-152
Error Rejection Screen.............................................................. EDIM055....... 2-158
Copy All Records Screen........................................................... EDIM060....... 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...........................EDIM023...... 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...................................................................... EDIM111......... 3-11
Version Screen.............................................................................. EDIM110......... 3-14
Version/Transaction Directory......................................................EDIM113......... 3-17
Transaction Directory....................................................... EDIM121/EDIM122 3-21
Transaction Screen........................................................................ EDIM120......... 3-27
Segments Screen........................................................................... EDIM140......... 3-38
Segment Element.......................................................................... EDIM141......... 3-44
Segment Element Activity Screen.................................................EDIM150......... 3-49
Data Element Definition Screen................................................... EDIM160......... 3-54
Standard Code Menu.....................................................................EDIM170......... 3-58
Standard Code Directory............................................................ EDIM171......... 3-60
Standard Code Maintenance Screen............................................. EDIM172......... 3-63
Code Maintenance List Options Screen........................................EDIM173......... 3-66
Transaction in Use Screen.......................................................... EDIM180......... 3-68
Standard Association Screen...................................................... EDIM105......... 3-72
IBM Sterling Gentran:Basic for zOS Release 6.6 User Guide - vii
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
Databank Maintenance Menu..................................................... EDIM250......... 4-24
Interchange Directory Screen...................................................... EDIM254......... 4-27
Group Directory....................................................................... EDIM255......... 4-31
Group Directory – Date............................................................... EDIM25A ........ 4-36
Interchange Status Screen............................................................. EDIM251 ........ 4-41
Group Status Screen......................................................................EDIM252......... 4-48
Transaction Status Screen......................................................... EDIM253......... 4-55
Document Directory.................................................................. EDIM262......... 4-62
Document Status Screen.............................................................. EDIM263......... 4-66
Change Audit Directory............................................................. EDIM268......... 4-72
Change Audit Status Screen...................................................... EDIM269......... 4-76
Online Log Display Screen....................................................... EDIMOLD ....... 4-81
Acknowledgment Overdue Directory Screen.............................. EDIM240......... 4-86
Acknowledgment Overdue Detail Screen.................................... EDIM241......... 4-91
Interchange Status Detail Screen—Outbound.............................. EDIM271......... 4-96
Interchange Status Detail Screen—Inbound................................ EDIM271....... 4-101
Interchange Display Screen...................................................... EDIM256....... 4-105
Group Display Screen.............................................................. EDIM257....... 4-110
Transaction Status Detail Screen—Outbound.............................. EDIM258....... 4-115
Transaction Status Detail Screen—Inbound ............................... EDIM258....... 4-120
Transaction Display Screen....................................................... EDIM259....... 4-125
Segment Display Screen........................................................... EDIM260....... 4-129
Data Element Display Screen...................................................... EDIM261....... 4-133
Document Status Detail Screen – Outbound.................................EDIM265....... 4-137
Document Status Detail Screen—Inbound................................... EDIM265....... 4-142
Document Display Screen........................................................... EDIM264....... 4-147
Record Display Screen................................................................ EDIM266....... 4-151
Field Display Screen.................................................................. EDIM267....... 4-154
Change Audit Status Detail Screen.............................................. EDIM270....... 4-157
Chapter 5 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..........................................................................EDIM203......... 5-12
User ID Maintenance Screen...................................................... EDIM201......... 5-15
User ID Maintenance Screen – Add On Products.........................EDIM202......... 5-23
Message Maintenance Menu....................................................... EDIM211......... 5-25
Message Directory..................................................................... EDIM212......... 5-27
Message Maintenance Screen...................................................... EDIM213......... 5-30
Error Rejection Maintenance Screen.............................................EDIM214......... 5-35
Configuration Directory............................................................... EDIM230......... 5-38
Configuration Maintenance Screen.............................................. EDIM231......... 5-40
- viii IBM Sterling Gentran:Basic for zOS Release 6.6 User Guide
Configuration Maintenance Screen............................................. EDIM231......... 5-43
Configuration Maintenance Screen............................................. EDIM231......... 5-47
Configuration Maintenance Screen.............................................. EDIM231......... 5-50
Configuration Maintenance Screen.............................................. EDIM231......... 5-53
Configuration Maintenance Screen...............................................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
Configuration Maintenance Screen...............................................EDIM231......... 5-69
Configuration Maintenance Screen.............................................. EDIM231......... 5-72
Global Parameter Maint 1 Screen....................................... EDIM220/EDIM22A 5-74
Global Parameter Maint 2 Screen ....................................... EDIM221/EDIM22B 5-78
Global Parameter Maint 3 Screen................................................ EDIM222......... 5-83
Global Parameter Maint 4 Screen........................................ EDIM223/EDIM22D 5-86
Global Parameter Maint 5 Screen.................... ................... EDIM224/EDIM22E 5-90
Global Parameter Maint 6 Screen.........................................EDIM225/EDIM22F 5-95
Partner Migration Menu............................................................ EDIY100......... 5-99
User Selection Screen............................................................... EDIY200....... 5-102
User Maintenance Screen.......................................................... EDIY500 ....... 5-104
Partner Selection Screen............................................................ EDIY300....... 5-107
Relationship Maintenance Screen................................................ EDIY400....... 5-110
Data Translation Table Directory Screen..................................... EDIY600....... 5-113
Data Table Migration Selection Screen........................................ EDIY610....... 5-116
Data Table Migration Maintenance Screen...................................EDIY620 ....... 5-118
Upload Process Maintenance...................................................... EDIM235....... 5-121
Separator Main Menu................................................................ EDIM934....... 5-124
Separator Systems Options Maintenance Screen..........................EDIM935....... 5-126
Priority Options Directory Screen............................................... EDIM936....... 5-133
Priority Options Maintenance Screen........................................... EDIM937....... 5-136
Change Audit Main Menu........................................................... EDIM209....... 5-141
Partner Change Audit Directory....................................................EDIM070....... 5-144
Partner Change Audit Status....................................................... EDIM071....... 5-147
Partner Change Audit Detail....................................................... EDIM072....... 5-152
XREF Change Audit Directory.....................................................EDIM074....... 5-156
XREF Change Audit Status........................................................ EDIM075....... 5-158
XREF Change Audit Detail......................................................... EDIM076....... 5-161
PARTREL Change Audit Directory............................................. EDIM077....... 5-163
PARTREL Change Audit Status...................................................EDIM078....... 5-165
PARTREL Change Audit Detail...................................................EDIM079....... 5-168
Standards Change Audit Directory............................................... EDIM181....... 5-171
Standards Change Audit Status.....................................................EDIM182....... 5-173
Standards Change Audit Detail.................................................... EDIM183....... 5-177
Application Change Audit Directory............................................ EDIM560....... 5-180
Application Change Audit Status..................................................EDIM561....... 5-183
Application Change Audit Detail..................................................EDIM562....... 5-186
Transaction Change Audit Directory............................................ EDIM520....... 5-189
Transaction Change Audit Status..................................................EDIM521....... 5-192
Transaction Change Audit Detail..................................................EDIM522....... 5-195
Code Table Change Audit Directory.............................................EDIM587....... 5-198
IBM Sterling Gentran:Basic for zOS Release 6.6 User Guide - ix
Code Table Change Audit Status................................................ EDIM588....... 5-201
Code Table Change Audit Detail................................................. EDIM589....... 5-204
Security Change Audit Directory................................................ EDIM204....... 5-207
Security Change Audit Status..................................................... EDIM205....... 5-209
Security Change Audit Detail....................................................... EDIM206....... 5-212
Error Message Change Audit Directory........................................EDIM215....... 5-214
Error Message Change Audit Status..............................................EDIM216 ...... 5-216
Error Message Change Audit Detail..............................................EDIM217 ...... 5-219
Configuration Change Audit Directory.........................................EDIM232....... 5-222
Configuration Change Audit Status.............................................. EDIM233....... 5-224
Configuration Change Audit Detail.............................................. EDIM234....... 5-227
Global Parameter Change Audit Directory...................................EDIM226....... 5-229
Global Parameter Change Audit Status.........................................EDIM227....... 5-231
Global Parameter Change Audit Detail.........................................EDIM228....... 5-234
Separator Change Audit Directory.............................................. EDIM938....... 5-236
Separator Change Audit Status................................................... EDIM939....... 5-239
Separator Change Audit Detail..................................................... EDIM940....... 5-243
Message Center Job Summary.................................................... EDIM245....... 5-246
Message Center Job Detail........................................................... EDIM246....... 5-250
Message Center Report Display.................................................. EDIM247....... 5-253
Chapter 6 The Mapping Subsystem
Overview .................................................................................................................. 6-1
Before You Begin..................................................................................................... 6-2
Mapping Maintenance Menu...................................................... EDIM599......... 6-14
Application Definition Menu....................................................... EDIM550......... 6-16
Application Directory....................................................................EDIM551......... 6-19
Application Data ID Screen.......................................................... EDIM552......... 6-23
Copy Application Definition Screen.............................................EDIM557......... 6-28
Application Records Screen..........................................................EDIM553......... 6-31
Application Fields Screen............................................................. EDIM554......... 6-37
Application Partner Reference Screen.......................................... EDIM555......... 6-43
Application Envelope Definition Screen.......................................EDIM558......... 6-47
Transaction Mapping Menu......................................................... EDIM500......... 6-52
Transaction Mapping Directory.................................................. EDIM512......... 6-55
Transaction Maintenance Screen................................................ EDIM503......... 6-58
Copy Transaction Screen.............................................................. EDIM501......... 6-63
Copy Segments From Standard Screen........................................ EDIM502......... 6-66
Segments Screen....................................................................... EDIM504......... 6-70
Element Mapping Inbound Screen................................................EDIM514......... 6-76
Element Mapping Outbound Screen............................................. EDIM511......... 6-83
Extended Element Mapping Inbound Screen................................EDIM513......... 6-89
Extended Element Mapping Outbound Screen.............................EDIM508....... 6-100
Build Repeating Data Elements Screen........................................ EDIM517....... 6-110
Element Information Screen...................................................... EDIM515....... 6-115
Select Codes Screen................................................................. EDIM509....... 6-119
Select Application Data Screen.................................................... EDIM510....... 6-122
Copy Segments From Transaction Screen.................................... EDIM505....... 6-125
Subfield Screen......................................................................... EDIM507....... 6-129
- x IBM Sterling Gentran:Basic for zOS Release 6.6 User Guide
Code and Data Translation Menu..................................................EDIM580....... 6-134
Table Directory......................................................................... EDIM586....... 6-136
Define Translation Table Screen................................................. EDIM581....... 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 Sterling 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-137
Unload/Upload Facility ........................................................................................ 7-159
Using the User Security Facility........................................................................... 7-171
Appendix A Jump Codes
Jump Codes By Subsystem ..................................................................................... A-1
Jump Codes By Screen Name ............................................................................... A-10
Notices
Trademarks .............................................................................................................. N-3
Glossary
Definition of Terms ................................................................................................. G-1
Reserved Word Constants ..................................................................................... G-11
Application Data Types......................................................................................... G-17
EDI Data Types ..................................................................................................... G-20
Index
Chapter
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 1 - 1
1Getting Started
This chapter introduces IBM® Sterling Gentran:Basic® for z/OS® Release 6.6 and provides
descriptions of the system features and benefits, system architecture, and operation. This chapter
contains the following topics:
Topic Page
Overview of Sterling Gentran:Basic ................................................................................... 1-3
How to Learn About Sterling 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................................................................................................................... 1-7
Inbound Processing ................................................................................................... 1-8
Outbound Processing............................................................................................... 1-10
Databank Maintenance ...................................................................................................... 1-12
Why Use Databanking?........................................................................................... 1-12
Functions of Databanking........................................................................................ 1-12
Getting Started with Sterling Gentran:Basic ................................................................... 1-13
Where Sterling Gentran:Basic Fits Into Your Computer Environment................... 1-13
Files Used by Sterling Gentran:Basic...................................................................... 1-14
Sterling Gentran:Basic Online System Operation Basics ............................................... 1-15
Logging on to Sterling Gentran:Basic..................................................................... 1-15
Changing Your Password ........................................................................................ 1-17
Sterling Gentran:Basic Menu Options ............................................................................. 1-18
Sterling Gentran:Basic Menus................................................................................. 1-21
Sterling Gentran:Basic Screens ............................................................................... 1-21
Screen Component Descriptions ............................................................................. 1-22
Using Action Codes............................................................................................................. 1-24
Getting Help ........................................................................................................................ 1-25
Accessing Online Field-Level Help ........................................................................ 1-25
Accessing Online Screen-Level Help...................................................................... 1-26
Function Keys ..................................................................................................................... 1-27
Getting Started
1 - 2 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Common Keyboard Conventions ...................................................................................... 1-28
Basic File Maintenance Procedures .................................................................................. 1-29
Add .......................................................................................................................... 1-29
Update...................................................................................................................... 1-29
Delete....................................................................................................................... 1-29
Jump Codes ......................................................................................................................... 1-30
How to Jump Between Screens ............................................................................... 1-30
Types of Jump Codes............................................................................................... 1-31
User-defined Jump Code Table ............................................................................... 1-32
Jump Code Guidelines............................................................................................. 1-32
Overview of Sterling Gentran:Basic Getting Started
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 1 - 3
Overview of Sterling Gentran:Basic
IBM® Sterling Gentran:Basic® for z/OS® Release 6.6 provides the flexibility, efficiency, and
thoroughness required to meet the most demanding EDI requirements.
Sterling Gentran:Basic facilitates EDI in several ways, including:
Translates data between your application and the standard format required (such
as, ASC X12, UCS, WINS, EDIA (TDCC), EDIFACT, and ANA
TRADACOMS).
Compliance checks data by table-driven syntax-checking programs.
Allows you to set a multitude of options based on your trading partner.
Delivers an easily-managed system.
Provides control for audit trails, security, and error reporting.
Provides a powerful tool for mapping via the Mapping Maintenance subsystem.
Specifically, Sterling Gentran:Basic offers the following features:
All EDI Transactions Handled — Tables that define all EDI transactions, segments, and
elements. These include ASC X12 transactions as well as the Air, Ocean, Motor, and Rail
standards of EDIA (TDCC), UCS, WINS, TRADACOMS, and EDIFACT.
Multiple Standards Versions — For meeting the requirements of trading partners, enables the use
of multiple standards versions.
Standards Translated to Readily-used Formats — Transactions received by your computer in
ASC X12 or other standard formats are variable-length, variable-position logical segments.
Sterling Gentran:Basic produces fixed-length output that is easy to use.
Partner-specific Decisions — A large number of decisions may vary by partner. For example, the
transactions and functional groups sent may be controlled by partner.
Databanking Functions — Sterling Gentran:Basic provides auditing capabilities on all incoming
and outgoing transactions, groups, and interchanges.
Suspended Data is Easily Reprocessed — Data that cannot be initially interpreted is put into a
Suspense file for later user action.
Envelope Segment Generation — Specify the partner envelope information one time. Use this
information to subsequently generate envelopes. Sterling Gentran:Basic automatically generates
the appropriate interchange, functional group, and transaction envelope segments.
Getting Started How to Learn About Sterling Gentran:Basic
1 - 4 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
How to Learn About Sterling Gentran:Basic
This chapter provides instruction to assist you in the operation of the online portion of Sterling
Gentran:Basic. Use the Sterling Gentran:Basic Reference Library, provided with your purchase of
Sterling Gentran:Basic, to perform the following tasks:
Create and maintain trading partner records
Perform databanking of translations
Map application data to standard formats for inbound and outbound data
View and maintain standards formats
Maintain Sterling Gentran:Basic system security
View and maintain system configuration, error messages, and global parameters
This guide, the IBM® Sterling Gentran:Basic® for z/OS® Release 6.6 User Guide, provides
reference information related to the online portion of the Sterling Gentran:Basic system, which is
organized as follows:
This chapter provides a high-level overview of the Sterling Gentran:Basic system.
You will learn about the flow of documents in and out of the system, how they are
translated, and how they are managed.
This chapter also provides detailed information about the operation of the online
system in general: the basics of how to use the Sterling Gentran:Basic online
system.
The following chapters in this guide correspond to each online subsystem of
Sterling Gentran:Basic and introduce you to the specific tasks you can perform
with each particular feature. A complete description of all Sterling Gentran:Basic
screens, including the screen fields, are detailed in the appropriate chapters.
Finally, the appendix of this guide contains an updated reference listing of jump
codes. You will learn more about jump codes later in this chapter.
In addition to the IBM® Sterling Gentran:Basic® for z/OS® Release 6.6 User Guide, the Sterling
Gentran:Basic documentation set contains the following guides:
IBM® Sterling Gentran:Basic® for z/OS® Release 6.6 Installation Guide
Use the Installation Guide to help you install the Sterling Gentran:Basic system.
IBM® Sterling Gentran:Basic® for z/OS® Release 6.6 System Message Guide
Use this guide as a reference of system messages you might encounter while using
the Sterling Gentran:Basic system.
IBM® Sterling Gentran:Basic® for z/OS® Release 6.6 Technical Reference
Guide
Use this guide to obtain specific technical and program operational information
about inbound and outbound processing, programs, files, and more.
What is EDI? Getting Started
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 1 - 5
What is EDI?
EDI is electronic data interchange. Simply, EDI is a method for communicating data at high rates
of speed – from computer to computer. The following descriptions explain the basic requirements
to accomplish communication.
Standards
Standards are extremely detailed formats for communicating specific types of
information. Standards are created and agreed upon by various industries and
countries. Standards are not a language. They are a specification for how data is to
be arranged. By using public standards, individual companies can use any
computer system and application and still communicate without confusion.
Translation
Translation is the process of taking data that is prepared by your application
programs and placing the data into a public standard, or the reverse process. You
set up translations between application file formats and public standards by a
process called mapping. Sterling Gentran:Basic is the software program that
translates the data to and from standards.
Trading Partners
Trading partners are the parties with whom you agree to exchange data, such as
your vendors or suppliers.
To explain how EDI works, we first describe how data is exchanged manually. Then, we describe
how the same data can be electronically exchanged.
Manual Data Exchange
The following example shows how data might be manually exchanged. Notice how many steps it
can take to complete the exchange for purchasing only one pocket protector.
1. The buyer begins preparing a purchase order (P.O.) form for the pocket protector.
2. The buyer researches to determine how the manufacturer requires submission of P.O.s for
pocket protectors.
3. After gathering the data, the buyer translates the order to meet the manufacturer's
requirements.
4. The buyer incorporates the translated data into the P.O. Then, the buyer mails the P.O.
form to the manufacturer.
5. After progressing through a mail-sorting process, the P.O. is delivered to the manufacturer.
6. The manufacturer routes the P.O. for the pocket protector to the proper department(s) for
processing (such as billing, picking, and shipping).
The entire process repeats in reverse when the manufacturer responds with an invoice. With all
conditions being ideal and no errors occurring, the entire exchange can take up to eight business
days. If there are any problems, corrections, or incorrect translations, the process may stretch into
weeks.
Getting Started EDI Terms
1 - 6 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Electronic Data Interchange
The following example shows how data might be electronically exchanged. Most of the steps
necessary to purchase one pocket protector automatically occur; thus, reducing processing time
and data-entry errors.
1. The buyer enters the order for one pocket protector into a computer terminal and an
in-house purchasing system. After initiating the order, the following tasks occur behind-
the-scenes:
a. The in-house application passes the P.O. to Sterling Gentran:Basic.
b. Sterling Gentran:Basic maps the in-house application format to the appropriate
public standards format.
c. The standard is verified and transmission envelopes are generated.
d. An audit trail is created for tracking the document and acknowledgments.
e. Sterling Gentran:Basic passes the standardized document to the buyers
communications system and the document is transmitted to the manufacturer.
2. The manufacturer receives the document and transmits an acknowledgment of its receipt,
and then processes it.
Even in a reverse situation when the manufacturer sends the buyer an invoice and the buyer
responds with an acknowledgment, a reduction in processing time occurs. In addition, a number of
verifications, confirmations, and detailed records result for both the buyer and the manufacturer.
EDI Terms
The following list provides definitions for basic EDI terms used frequently throughout this guide.
Application An in-house program that processes data. Your application file format
is the way your business prefers to view and process data.
Document One complete piece of data. For example, one purchase order.
Transaction Set When you translate from your application file format to a public
standard, you are translating your document to a transaction set.
Envelope An electronic transmission header and trailer that can surround one or
more transaction sets and/or types. For example, one envelope could
contain three purchase orders, four invoices, and six
acknowledgments.
Segment A single line of a transaction set; for example, the Bill To segment.
Data Element The individual parts of a segment; for example, Bill To City or Bill To
Postal Code).
System Overview Getting Started
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 1 - 7
System Overview
Sterling Gentran:Basic is a data translation and management system. It allows you to easily
communicate with your trading partners (those with whom you do business) through electronic
data interchange — EDI. To accomplish this action, you need to provide, through
communications, all your documents in a public standard, and likewise be prepared to interpret
documents sent to you in a defined public standard.
This process might be relatively simple if you deal with only one standard and one trading partner.
However, each industry has specific requirements that must be met, and every trading partner has
different requirements for doing business. These requirements mean that you must be able to
communicate in the appropriate standard, as well as the appropriate version of the standards, for
each trading partner. The task is further complicated by the need to acknowledge the receipt of
documents and monitor data for errors.
The normal operation of Sterling Gentran:Basic can be divided into two types of processing:
inbound processing and outbound processing.
Getting Started System Overview
1 - 8 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Inbound Processing
When your trading partner sends you EDI documents, they are in the format of a public standard.
When your computer system receives an EDI document, Sterling Gentran:Basic goes to work.
Figure 1.1, on the next page, illustrates a high-level view of inbound processing.
Figure 1.1 Inbound Translation Processing
User Application
Inbound
Editor
Data Split
Inbound
Mapper
EDI Input
File
Intermediate
File
Application
File
System Overview Getting Started
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 1 - 9
The following steps outline inbound processing from the receipt of transaction sets from a trading
partner to your application file format:
1. Your trading partner sends you documents in a public standard that you have mutually
agreed upon. You will probably receive these files via telecommunications.
2. The documents are stored in an EDI input file.
3. The EDI input file is passed to the inbound Editor. The Editor also uses the following files:
If the documents are wrapped, they are unwrapped at this point. Unwrapping means each
new segment is aligned to the start of a new record.
The inbound Editor uses the partner profile information for this trading partner to know
what to do (e.g., data separation and error rejection) and how to respond to the inbound
documents (e.g., acknowledgments generated). The Editor checks the EDI data to ensure
that it complies with the standard. If it doesn’t, the Editor creates an error report, and
possibly marks the data, or part of it, for rejection.
4. The edited data is passed to an Intermediate file. The Databanking file is updated to record
receipt of documents and acknowledgements of previous documents that you transmitted.
5. The Intermediate file is passed to the Inbound Split program. This program separates the
inbound data according to your criteria and rejects data that does not comply with
standards (as previously marked by the inbound Editor).
6. The separated data is translated to your application file format, using the maps you have
created in the online Mapping subsystem.
File Contents of File
Table File Public standards
Error Message File Sterling Gentran:Basic error messages
Databanking File Records of inbound and outbound
activity
Global Parameters File Overall system operating rules
Partner Profile Partner-specific operating rules
Getting Started System Overview
1 - 10 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Outbound Processing
Outbound processing prepares your application output data for transmission to your trading
partners. Like inbound processing, outbound processing translates your application data to the
chosen standard and checks all data to ensure compliance with the selected public standard.
Figure 1.2 illustrates a high-level view of outbound processing.
Figure 1.2 Outbound Translation Processing
User Application
Outbound
Editor
Application
File
Data
Split
EDI Intermediate
File
Outbound
Mapper
Envelope
Generator
(Optional)
System Overview Getting Started
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 1 - 11
These steps outline outbound processing from your application file format to transaction sets for
your trading partner.
1. The system takes the data from your application output file. Using the maps you created,
Sterling Gentran:Basic translates this data to a public standard.
2. The system generates the control envelopes necessary for transmitting the data.
3. The Intermediate file is passed to the outbound Editor. The Editor also uses the following
files:
Along with this intermediate file, functional acknowledgments created by the inbound
Editor are input for compliance checking and audit updating. The outbound Editor uses
the partner profile information for this trading partner as instructions (such as, standards,
data separation, or error rejection). The Editor ensures that the document complies to the
standard. If it does not comply, the Editor creates an error report and may mark the data for
rejection.
4. The Databanking file is updated to record transmission of functional acknowledgments
and outbound documents.
After the outbound data has been translated to standard format, it must continue on toward
transmission to the trading partner.
5. The standard format file is passed to the Outbound Split program. This program divides
the outbound data according to your criteria and rejects data that does not comply with
standards (as previously marked by the outbound Editor).
6. The separated data is now ready for transmission to your trading partner.
File Contents of File
Table File Public standards
Error Message File Sterling Gentran:Basic error messages
Databanking File Records of inbound and outbound
activity
Global Parameters File Overall system operating rules
Partner Profile Partner-specific operating rules
Getting Started Databank Maintenance
1 - 12 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Databank Maintenance
Databank Maintenance provides the online ability to directly control and view application data and
EDI data processed by Sterling Gentran:Basic. Change Audit functions provide complete details of
all online changes made by users to databank data. The Online Log display is also available within
the Databank subsystem for viewing system status and exceptions.
Why Use Databanking?
Benefits derived from using databanking include:
Improved data control
Reduced number of re-transmissions
Improved response to trading partners requirements
Functions of Databanking
Databanking functions fall into four general categories:
EDI data-related control and inquiry functions
Application document-related control and inquiry functions
Change Audit-related inquiry functions
Online Log display from which you can monitor system status and exceptions
The Sterling Gentran:Basic Databank facility takes advantage of the proven functions already in
the Sterling Gentran:Basic family of products, while adding functionality that provides flexible
control of documents as they pass through the system. The Databank Facility option, if
implemented, is an integral part of your Sterling Gentran:Basic system.
Note: Using the Databank facility is optional.
Getting Started with Sterling Gentran:Basic Getting Started
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 1 - 13
Getting Started with Sterling Gentran:Basic
As you are getting ready to install Sterling Gentran:Basic, put together a project team that
understands all the components of the system and how it works in your operation. You will install
Sterling Gentran:Basic and ensure that it is running according to design. We can provide
consultants to train your staff in the use of the parameters to manage the activities of the system.
See the IBM® Sterling Gentran:Basic® for z/OS® Release 6.6 Installation Guide for specific
details on arranging the Sterling Gentran:Basic libraries.
Your responsibilities for installing Sterling Gentran:Basic include the following tasks:
Initial loading and testing of the system
Daily operation/running of the system, including job control language (JCL)
Understanding and setting up a few system parameters
Getting data to and from other EDI partners (This action is usually accomplished
with data communications.)
Creating and maintaining the maps that translate data from your application file
format to the public standards used in communicating with your trading partners,
and the reverse
Defining where the system files reside in your environment
Where Sterling Gentran:Basic Fits Into Your Computer Environment
Sterling Gentran:Basic is designed to be the user interface between your application systems and
your EDI trading partners. The system takes the application files you have defined and translates
them to standard formats, validates them, and prepares them for transmission. The system expects
incoming data from your trading partner to be in a specified public standard that it verifies and
translates to your application file format.
To complete this process, Sterling Gentran:Basic expects incoming data files to have been created
from another source and deposited on your computer. The typical method used to perform this task
is data communication, such as standard RJE (remote job entry), using any acceptable data
communication protocol. However, RJE is not a requirement. Tape transfer of data between
machines (or any other mechanism) for depositing the incoming data on your computer is
acceptable. Sterling Gentran:Basic is not sensitive to the way data is deposited on your computer.
Getting the data to the computer is the responsibility of you and your EDI partners.
Getting Started Getting Started with Sterling Gentran:Basic
1 - 14 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Files Used by Sterling Gentran:Basic
As with any computer system, there are certain types of files required for system operation.
Sterling Gentran:Basic supplies the programs and job control/command language to run the
programs in the suggested processing order. You may tailor the job control/command language to
fit your company’s standards of operation.
These files are included:
Sterling Gentran:Basic also supplies an Error Message file that stores a list of possible error
messages. IBM® Sterling Gentran® enables you to customize these error messages to make them
more specific to the needs of your environment.
Caution: Changes to the actual error message numbers
could result in generating misleading
information as data passes through the Editors.
Global parameters enable you to direct the operation of the system when you want to take
advantage of the available Sterling Gentran features. To run the default mode for all variable
features, no global parameters are necessary. You can modify the global parameters online or
through the job control/command language.
The other files Sterling Gentran uses are either the EDI input file it expects or the EDI output files
it creates.
File Description
Partner Profile Contains detailed information about your trading partner.
Databanking File
(optional)
Provides tracking of Sterling Gentran:Basic processing actions
by storing directory data for outbound application, outbound
EDI, inbound EDI, and/or inbound application processes.
Tables File Contains all the standards for data translation.
Mapping File Contains definitions of your application file formats, the
transaction tables, and the transaction maps necessary to
translate your data to and from public standards.
Security File Contains Sterling Gentran:Basic system security information
in which all User IDs and passwords are encrypted.
Configuration
File
Contains system level information that applies to all functions
of processing.
Sterling Gentran:Basic Online System Operation Basics Getting Started
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 1 - 15
Sterling Gentran:Basic Online System Operation Basics
This section defines the basics of operating the Sterling Gentran:Basic online system. The design
of the online system allows easy access and maintenance of the required information for smooth
communication using EDI. Although there are several system features that have specific
commands and uses, the majority of the system can be operated using a few basic commands.
Logging on to Sterling Gentran:Basic
Sterling Gentran:Basic uses a security system that limits access through the use of User IDs and
passwords. Sterling Gentran:Basic security controls who can use the online system and what
features they may access.
See Chapter 5, “The Administration Subsystem,” for specific information about security.
1. See your system administrator to receive a Logon ID and password to start the online
Sterling Gentran:Basic system. You also need information on how to access CICS.
The Sterling Gentran:Basic User ID is an identifier, most likely your initials or name. This
ID enables the system to recognize you, determines which features you have access to, and
tracks file changes. The password is a word, including letters and numbers, that prevents
others from logging on to the system using your ID (only you and the system administrator
should know your password). If someone else uses your User ID and password, any
changes that a user makes in a Sterling Gentran:Basic file are attributed to you.
The system administrator informs you about how to use your company’s specific terminal
hardware and operating system. The administrator also shows you how to start Sterling
Gentran:Basic. Typically, you start Sterling Gentran:Basic from a menu, but you can also
start Sterling Gentran:Basic by entering a specific command.
2. Sign on to CICS.
3. Start Sterling Gentran:Basic as instructed by your system administrator.
The Sterling Gentran:Basic Logon screen is displayed with the proprietary trade/secret
notice.
Getting Started Sterling Gentran:Basic Online System Operation Basics
1 - 16 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
The information on the Logon screen indicates the Sterling Gentran:Basic system
configuration and the product versions that have been installed.
The following three fields are standard for all users:
SYSTEM IMAGE: SIM
Where SIM is the user-defined system image associated with the Sterling
Gentran:Basic system. The system image is determined by the CICS Transaction
ID entered to access Sterling Gentran:Basic.
PROGRAM IMAGE: PIM
Where PIM is the user-defined program image associated with the Sterling
Gentran:Basic system. The program image is retrieved from Record Type 0 of the
Configuration file (EDICFG).
See Chapter 5, “The Administration Subsystem,” for more information about
online configuration.
DBK CONFIG: cccc
Each c in the field represents one of the four Databank types. Databank valid
values include F for Full, D for Directory, and N for No Databank. The order of
representation is:
Outbound Application Databank
Outbound EDI Databank
Inbound EDI Databank
Inbound Application Databank
EDIM000 06/01/2011
12:00:00
IBM® Sterling Gentran® for z/OS®
System Image: EDI Program Image: EDI
Databank Config: FFFF Sterling Gentran:Realtime 6.6.00
Sterling Gentran:Control 6.6.00 Sterling Gentran:Basic 6.6.00
Sterling Gentran:Plus 6.6.00 Sterling Gentran:Viewpoint-Excp 6.6.00
Sterling Gentran:Viewpoint-Trck 6.6.00 Sterling Gentran:Structure 6.6.00
User ID: Password:
New Password:
Licensed Materials - Property of IBM
© Copyright IBM Corp. (1988, 2011) All Rights Reserved
IBM and the IBM logo are Trademarks of International Business Machines
Enter PF3=Exit
Sterling Gentran:Basic Online System Operation Basics Getting Started
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 1 - 17
For example, if the value in this field is DDFN, your Sterling Gentran:Basic
Databanking system has been configured as the following:
Outbound Application Databank= Directory
Outbound EDI Databank = Directory
Inbound EDI Databank = Full
Inbound Application Databank = None
Dbk Config is retrieved from Record Type 2 of the Configuration file (EDICFG).
4. Type your assigned ID in the User ID field and press Tab to move the insertion point to
the Password field.
Note: If you do not remember your password, see your system
administrator.
5. Type your password. Notice that the password that you are typing does not appear on the
screen. Press Enter to display the Sterling Gentran Main Menu.
Note: We recommend that you keep your password stored in a
secure location to ensure that unauthorized users do not
access the system.
Changing Your Password
For security purposes, you should change your password periodically.
Perform the following steps to change your password.
1. From the Sterling Gentran:Basic Logon screen, type your existing User ID and password.
Then, press Tab instead of Enter to move the insertion point to the New Password field.
Note: The minimum length for the new password is based on
your installation configuration.
2. Because characters do not appear on the screen as you are typing, cautiously type a new
password and press Enter. The screen displays a confirmation message:
TO UPDATE PASSWORD PRESS ENTER OR F12 TO CANCEL
3. Press Enter to update the system with your new password.
Getting Started Sterling Gentran:Basic Menu Options
1 - 18 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Sterling Gentran:Basic Menu Options
The Sterling Gentran Main Menu (shown below) provides direct access to the primary functions of
the Sterling Gentran:Basic product. Your ability to access a menu option depends on whether your
logon ID has been granted access. If you are not authorized to use a feature, its corresponding
menu option appears dimmed, and (N/A) displays to the right of the option.
EDIM001 0.0_______ GENTRAN MAIN MENU XXX 06/01/2011
EDI/EDI XXXXXXXX 12:00:00
Type the number of your selection below and press ENTER, or
press the PF3 key to Exit.
__ 1. Partner Maintenance Menu
2. Standards Maintenance Menu
3. Databank Maintenance Menu
4. Administrative Maintenance
5. Mapping Maintenance Menu
6. Sterling Gentran:Plus Main Menu (N/A)
7. Sterling Gentran:Control Main Menu (N/A)
8. Sterling Gentran:Realtime Main Menu (N/A)
9. Sterling Gentran:Viewpoint Main Menu (N/A)
Enter PF1=Help PF3=Exit
PF15=Logoff
Sterling Gentran:Basic Menu Options Getting Started
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 1 - 19
The following list contains short descriptions of the options available from the Sterling Gentran
Main Menu.
Note: IBM® Sterling Gentran:Plus® for z/OS®, IBM®
Sterling Gentran:Control® for z/OS®, IBM® Sterling
Gentran:Realtime® for z/OS®, and IBM® Sterling
Gentran:Viewpoint® for z/OS® are optional add-on
products to Sterling Gentran:Basic.
Option Description
Partner Maintenance Menu Enables you to easily enter or change information about
each of your trading partners.
Standards Maintenance Menu Enables you to view and maintain EDI Standards files.
Databank Maintenance Menu Enables you to directly control and view application data
and EDI data that is processed by Sterling
Gentran:Basic.
Administrative Maintenance Menu Enables you to directly control and view security,
configuration, message handling, and global (system)
settings.
Mapping Maintenance Menu Enables you to translate your internal application
formats for EDI standard formats for the documents you
want to send (outbound mapping) and to translate the
EDI standard format to application formats for
documents that you receive (inbound mapping).
Sterling Gentran:Plus Manages your communications data through automated
inbound and outbound communications processes.
Sterling Gentran:Control Enables you to integrate your applications and
communications with Sterling Gentran:Basic functions
in an event-driven EDI system.
Sterling Gentran:Realtime Enables you to manage processing online in a real-time
environment.
Sterling Gentran:Viewpoint Enables you to monitor, control, and manage your EDI
environment.
Getting Started Sterling Gentran:Basic Menu Options
1 - 20 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
The Sterling Gentran:Basic high-level navigation, as shown in Figure 1.3, is outlined on the
Sterling Gentran Main Menu.
Figure 1.3 Sterling Gentran:Basic High-Level Navigation
Sterling Gentran
Main Menu
Sterling
Sterling
Partner Mapping
Sterling
Sterling
Standards
Databank
Maintenance
Maintenance Maintenance
Maintenance
Administrative
Maintenance
Administrative
Maintenance
Security
Maintenance
Message
Maintenance
Global Parameter
Maintenance
Configuration
Maintenance
Upload Process
Maintenance
Partner Conversion
(optional)
Gentran:Viewpoint
Gentran:Control
Gentran:Plus Gentran:Realtime
Sterling Gentran:Basic Menu Options Getting Started
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 1 - 21
Sterling Gentran:Basic Menus
After you have logged on to the system, the Sterling Gentran Main Menu is displayed.
All Sterling Gentran:Basic menus have the same characteristics and operate in the same manner.
The menu displays a list of numbered options. The option can be either another menu or a screen
that enables you to perform a system task.
To select an option, type the number corresponding to the menu option you want to choose and
press Enter.
Sterling Gentran:Basic Screens
All Sterling Gentran:Basic screens include the following features:
Screen name
Jump code
Screen title
User initials
Date and time
Screen fields
Message line
Function key(s)
Online help
EDIM001 0.0_______ GENTRAN MAIN MENU XXX 06/01/2011
EDI/EDI XXXXXXXX 12:00:00
Type the number of your selection below and press ENTER, or
press the PF3 key to Exit.
__ 1. Partner Maintenance Menu
2. Standards Maintenance Menu
3. Databank Maintenance Menu
4. Administrative Maintenance
5. Mapping Maintenance Menu
6. Sterling Gentran:Plus Main Menu (N/A)
7. Sterling Gentran:Control Main Menu (N/A)
8. Sterling Gentran:Realtime Main Menu (N/A)
9. Sterling Gentran:Viewpoint Main Menu (N/A)
Enter PF1=Help PF3=Exit
PF15=Logoff
Getting Started Sterling Gentran:Basic Menu Options
1 - 22 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Some screens, called multi-record screens, also contain an action bar and an Action Code field
(abbreviated to “the A field”). The following screen is an example of a multi-record screen; thus, it
contains the action bar and the A field.
Screen Component Descriptions
Screen Name
This is the technical name for the screen. Each screen begins with the prefix EDIM, followed by a
three-digit identifier.
Jump Code
The jump code is located in the upper left corner of each screen, to the right of the screen name.
The jump code is displayed automatically for each new menu or screen that is displayed. You can
press Home to move the insertion point to the Jump Code field, type the jump code of another
screen you want to display, and then press Enter to jump to that screen.
See “Jump Codes” later in this chapter for further information on how to use jump codes.
Screen Title
This is the textual identifier of the screen, centered at the top of each screen.
Add Delete Update Select
EDIM553 5.1.3_____ APPLICATION RECORDS XXX 06/01/2011
12:00:00
Application Data ID..: __________ Send or Receive..: _
Description..........:
Start Rec Type.......: __________ Area....: _ Seq: ___
A Seq Rec Area Lp Max Rec Mn Wr Description HL User
No Type ID Use Len Cd Fl Level Exit
_ ___ __________ _ ____ _____ _____ _ _ __________________________ __ _______
_ ___ __________ _ ____ _____ _____ _ _ __________________________ __ _______
_ ___ __________ _ ____ _____ _____ _ _ __________________________ __ _______
_ ___ __________ _ ____ _____ _____ _ _ __________________________ __ _______
_ ___ __________ _ ____ _____ _____ _ _ __________________________ __ _______
_ ___ __________ _ ____ _____ _____ _ _ __________________________ __ _______
_ ___ __________ _ ____ _____ _____ _ _ __________________________ __ _______
_ ___ __________ _ ____ _____ _____ _ _ __________________________ __ _______
_ ___ __________ _ ____ _____ _____ _ _ __________________________ __ _______
_ ___ __________ _ ____ _____ _____ _ _ __________________________ __ _______
Enter PF1=Help PF3=Exit PF4=Data Id PF5=Fields
PF7=Bwd PF8=Fwd
Message Line
Function Key
Screen Title
Screen Fields
Jump Code Date and Time
Screen Name
Action Code
Field
Action Bar
User Initials
Sterling Gentran:Basic Menu Options Getting Started
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 1 - 23
User Initials
This displays the users initials.
Date and Time
This shows the date and time the screen is displayed.
Screen Fields
These fields contain data specific to each screen. Some fields require you to enter information;
others are display-only. Screen fields are located between the screen title and the message line.
Message Line
This line displays Sterling Gentran messages. These messages inform you that an error has
occurred, verify that a function was performed, or supply you with additional information. The
message line is located above the function keys.
Function Keys
Function keys include both standard commands that are common throughout the Sterling Gentran
system, as well as commands that are specific to the current screen. The function key line varies
from screen to screen; only the function keys that are valid for the current screen are displayed.
You will see only function keys for commands that you are allowed to perform. This is maintained
under the Security Maintenance Menu. Each valid program function key and the function it
executes are displayed at the bottom of each screen.
Where function keys are located on your keyboard depends on your keyboard model. In addition,
some keyboards do not have dedicated function keys, and instead require you to press a
combination of keys to perform a function key function.
See your system administrator for information about your hardware configuration and function
key usage.
Action Bar
The action bar is the top line of multi-record screens, such as directory screens. The action bar
displays available actions that you can perform for the current screen. Single-record screens
typically use PF keys to perform desired functions.
Action Code Field
The Action Code field (abbreviated to the A field) is the left-most column of each line item on
multi-record screens. An action code is the first letter of any action listed in the action bar.
Getting Started Using Action Codes
1 - 24 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Using Action Codes
Use the following procedure to perform an action:
1. In the A field next to the item for which you want to perform an action, type the first letter
of an action specified on the Action Bar. For example, type S for Select.
2. Press Enter or the appropriate PF key.
You can perform more than one action at a time for file maintenance tasks, such as adding,
updating, and deleting. To perform more than one action, type an action code in the A fields of
each item for which you want to perform an action and press Enter. The system performs the
actions that you have designated for the selected items, starting at the top of the screen and
proceeding downward. File maintenance actions are recognized and performed before other
actions.
See the topic “Basic File Maintenance Procedures” for more information about file maintenance
tasks.
Actions codes, such as Select and Copy are single item actions. This means that you can perform
the action for only one item at a time.
Common Action Codes
Note: Action Code options can vary from screen to screen.
Action Code Description
Add A Adds a new record.
Update U Updates an existing record.
Delete D Deletes the selected record.
Select S Displays the selected record.
Copy C Copies the selected record.
Getting Help Getting Started
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 1 - 25
Getting Help
Sterling Gentran:Basic provides the ability to obtain specific information about whatever part of
the program you are using at any particular moment. Sterling Gentran uses context-sensitive Help
from within the program.
The online help system is designed to allow you to access either specific information about a field
or general information about the entire screen.
This section defines how to use the online help feature in Sterling Gentran:Basic.
Accessing Online Field-Level Help
To access online help for a field, move the insertion point anywhere in the field. Press the
PF1=Help key and a pop-up help window appears on top of the current screen so the field is still
visible.
When further information is available about a field, More displays in the lower right corner of the
pop-up box. Press PF7=Bkwd or PF8=Fwd to scroll through the entire definition. When you have
reached the top or the bottom of the help information, Top or Bottom displays respectively in the
lower right corner of the pop-up box. To exit the pop-up box, press the PF12=Cancel key.
Select
EDIM010 1.1_______ PARTNER DIRECTORY 06/01/2011
12:00:00
Starting Partner Id: ___________________________________
U
A Partner Qual Name A
_ !!!GENTRAN-RESERVED-PARTNER-ID-1 *** NAME NOT ON FILE *** N
_ !!!GENTRAN-RU1 !!!GENTRAN-RP1 *** NAME NOT ON FILE *** N
_ ABLANK ACRAIG *** NAME NOT ON FILE *** N
..............................................................................
: STARTING PARTNER ID: :
: :
: A 35-POSITION ALPHANUMERIC FIELD USED TO SPECIFY A PARTNER ID FROM WHICH :
: VIEWING BEGINS. ENTER THE DESIRED PARTNER ID. YOU MAY KEY A PARTIAL :
: PARTNER ID INTO THIS FIELD AND THE SYSTEM DISPLAYS UP TO 13 PARTNER IDS :
: STARTING WITH THE CLOSEST PARTNER ID MATCH. :
: :
: NOTE: THIS DIRECTORY LISTS PARTNER IDS ONLY AS THEY ARE DISPLAYED :
: More... :
: :
: F7=Bkwd F8=Fwd F12=Cancel :
:............................................................................:
Field-Level Help
Function Keys in Help
Definition Location
Getting Started Getting Help
1 - 26 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Accessing Online Screen-Level Help
To display online Help for the entire screen, move the insertion point anywhere outside a field and
press PF1=Help. The Help provides an overview that describes the purpose of the screen.
Select
EDIM010 1.1_______ PARTNER DIRECTORY 06/01/2011
12:00:00
Starti ................................................................
: Help :
: :
A Pa : THE PARTNER DIRECTORY SCREEN DISPLAYS A LISTING OF ALL :
_ !! : PARTNER IDS CURRENTLY ON FILE. THIS LISTING INCLUDES ONLY :
_ !! : THE PARTNER ID'S THAT EXIST ON YOUR PARTNER CONTROL RECORDS. :
_ AB : :
_ AB : YOU CAN ONLY VIEW A LISTING OF THOSE TRADING PARTNERS THAT :
_ AC : HAVE THE SAME SECURITY DIVISION AS DEFINED FOR YOUR LOGON OR :
_ AP : THOSE DEFINED WITH DIVISION CODE OF SPACES. LOGON IDS :
_ AP : DEFINED WITH A DIVISION OF '000' MAY VIEW ALL TRADING :
_ AP : PARTNER RECORDS. :
_ BE : :
_ DA : Bottom :
_ DA : :
_ DA : F7=Bkwd F8=Fwd F12=Cancel :
_ DA :..............................................................:
INVALID FUNCTION KEY PRESSED
Enter PF1=Help PF3=Exit PF5=Maint
PF7=Bwd PF8=Fwd
Screen-Level Help
Function Keys in Help
Function Keys Getting Started
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 1 - 27
Function Keys
The Sterling Gentran:Basic system has a number of standard function keys. The standard function
key commands always use the same function key number and are displayed in the same relative
screen position. However, not all standard function keys necessarily are displayed on all the
screens; rather, only the function keys that are required for a particular screen are displayed on that
screen.
Standard function keys are defined below and are not defined in the subsequent subsystem
chapters for each screen definition. Only function keys that are unique to a particular screen are
defined for that screen.
See the “Function Key Descriptions” topics in the appropriate chapters of this guide for
descriptions of the function keys that apply to each particular screen or menu.
Function
Key Function Description
PF1 Help Displays field-level and/or screen-level help text.
PF3 Exit Exits to the next higher level (the previous menu). No
actions are performed, even if there is a value in the A
field.
PF7 Bwd Scrolls backward to data that occurred earlier in the
current screen or record (for multi-line screens only).
PF8 Fwd Scrolls forward to data that occurred later in the
current screen or record (for multi-line screens only).
PF9 Add Adds the item selected.
PF10 Updt Updates the item selected.
PF11 Del Deletes the item selected. The Sterling Gentran:Basic
system prompts you to confirm the deletion by
pressing PF11 again.
PF12 Cancel Cancels the current function when the Sterling
Gentran:Basic system prompts you for a confirmation
(such as Delete).
PF14 Info Displays the date, time, and user initials on the
message line to indicate when the information on this
screen was created or last changed.
PF15 Logoff Logs off the Sterling Gentran:Basic system and
displays the Sterling Gentran:Basic Logon screen.
Logoff is available only on menus.
Getting Started Common Keyboard Conventions
1 - 28 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Common Keyboard Conventions
Keyboard conventions that are common throughout Sterling Gentran:Basic are described below:
Each menu contains a selection field in which you type the number of a task selection as listed on
the menu. After you type the task selection number and press Enter, the system displays the
appropriate screen.
Key Description
Enter Instructs Sterling Gentran to process the current function selected.
You must press Enter to initiate the processing of most commands
in Sterling Gentran, with the exception of the PF5=Select
command. When specified on a screen, use PF5 to process the
desired function.
Note: On your keyboard, the Enter key might be labeled Return
or CR, or with an arrow pointing down and then to the left.
Erase EOF Clears all data in the available screen field to the right of the
insertion point (including the character the insertion point is
currently on). Sometimes this key is labeled End on the keyboard.
Backspace Moves the insertion point left and deletes data in enterable screen
fields.
Arrow keys Moves the insertion point right or left within the line but does not
alter the contents of the line.
Insert Sets the keyboard to the insert mode. In the insert mode, any
characters entered are inserted at the insertion point position and
all the characters to the right of the insertion point position shift to
the right.
Delete Deletes the character where the insertion point is currently
positioned. To delete more than one character, select all the
characters in the field and press Delete. The insertion point returns
to the first position in the field.
Home Moves the insertion point to the Jump Code field at the top of the
screen.
Basic File Maintenance Procedures Getting Started
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 1 - 29
Basic File Maintenance Procedures
Online file maintenance procedures are the same for all Sterling Gentran:Basic features. File
maintenance consists of these three tasks:
•Add
•Update
•Delete
The following sections describe these tasks in more detail.
Add
The Add command creates a record that did not previously exist. Type the data in the appropriate
screen fields, and press PF9 to process the Add command. The system displays a message
informing you that the record was added. If the system was unable to add a record, or if there are
missing required field data or errors, a warning is displayed. If you exit the screen before you press
PF9 to add the record, the data you entered on the screen is not saved.
Update
When you change an existing record, update the record to apply the changes. The system displays
a message telling you that the record has been updated, or a warning if there were any errors. If
you exit the screen before you press PF10 for Update, the information you entered on the screen is
not saved. To update the file, press PF10 before you exit the screen.
Delete
When you want to delete an existing record from the Sterling Gentran:Basic system, use the Delete
command. You cannot recover a deleted record.
See your system administrator for more information on data recovery.
To delete a file or record, first display the correct record and then press PF11 to delete the file or
record. The system displays a message requesting you to verify that the item you selected is the
item you want to delete by pressing PF11 again. The system displays a message telling you that
the record has been deleted. If you decide not to delete the record, press PF12 for Cancel key. The
cancel feature does not work if you have already confirmed the deletion.
Note: The Databanking feature uses the term delete in a slightly
different manner from the file maintenance delete. In the
online Databank Maintenance, you mark a record for
deletion but it is not physically removed from the file
until the batch Databank Maintenance is run against the
databank file.
Getting Started Jump Codes
1 - 30 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Jump Codes
A jump code is a 10-character alphanumeric field located at the upper left corner of each Sterling
Gentran:Basic screen. This field enables you to move, or jump, directly from one screen to another
while bypassing menus. All screens that are accessible via a Sterling Gentran:Basic menu have
jump code values associated with them. Screens that are accessible only from detail screens do not
have jump code values associated with them.
How to Jump Between Screens
You can jump between screens without having to navigate using the Sterling Gentran:Basic
menus. Use the following procedure to jump between screens:
1. Press Home.
The insertion point moves to the Jump Code field at the top of the screen to the right of the
screen name.
2. Type the jump code and press Enter.
See Appendix A for a complete list of jump codes and their associated screens.
Following are some terms and definitions used in this discussion:
Term Meaning
Subsystem A set of functionally-related screens that are directly accessible
from the Sterling Gentran Main Menu (Partner Maintenance,
Standards Maintenance, Databank Maintenance, Administrative
Maintenance, Mapping Maintenance)
Navigation The movement from screen to screen by entering data then
pressing function keys (such as PF1, PF2) or by selecting options
on menus and pressing Enter
Position The location within a subsystem file (or group of files) that
displays the data (either one record or multiple records) on the
screen
Jump Codes Getting Started
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 1 - 31
Types of Jump Codes
There are three types of jump codes, which are listed below. These types of jump codes are
described more fully in the paragraphs that follow.
•Numeric
• Alphabetic
Special character
Numeric Jump Codes
Numeric jump codes consist of numbers separated by periods (.). The numbers in the jump code
correspond to the numbers selected on menus, in the order in which they are selected.
Example
To display the Application Data ID screen, you could navigate using the Sterling Gentran:Basic
menus by performing the following steps:
1. Type 5 on the Sterling Gentran Main Menu and press Enter.
2. Type 1 on the Mapping Maintenance Menu and press Enter.
3. Type 2 on the Application Definition Menu and press Enter.
... OR you could jump directly to the Application Data ID screen by performing these steps:
1. Press Home.
2. Type 5.1.2 in the Jump Code field of any screen and press Enter.
See Appendix A for a complete list of jump codes and their associated screens.
Alphabetic Jump Codes
Alphabetic jump codes consist of alphabetic characters separated by periods (.). The alphabetic
code is an abbreviated reference to the screen name or function. For example, to display the
Application Data ID screen using the alphabetic jump code, type APP.DEF or APP.ID in the Jump
Code field of any screen and press Enter.
See Appendix A for a complete list of jump codes and their associated screens.
Special Character Jump Codes
Special character jump codes enable you to perform standard or generic functions with jump
codes. The two special character jump codes are SWAP and EXIT.
SWAP enables you to jump between Sterling Gentran:Basic online subsystems
(not within subsystems). When you use jump code SWAP, you jump to the last
screen you jumped from (but not navigated from), from another subsystem. When
you jump from a different subsystem, you reset the SWAP positioning to the
screen you are jumping from.
Getting Started Jump Codes
1 - 32 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Example
Let’s say you have the Group Information screen in the Partner subsystem
displayed, and then you display the Transaction Information screen (also in the
Partner subsystem). From here, you jump to the Name and Address screen (again,
in the Partner subsystem). Next, you jump to the Transaction screen in the
Standards subsystem. After you view the information on the Transaction screen,
you type SWAP in the Jump Code field to return to your previous location in the
Partner subsystem. As you expect, SWAP returns you to the Name and Address
screen in the Partner subsystem, because this is the screen from which you jumped
to the Standards subsystem.
EXIT (or X) enables you to jump to the Sterling Gentran:Basic Logoff screen.
This feature provides a quick and easy way to exit the Sterling Gentran:Basic
system from any screen.
User-defined Jump Code Table
The User-Defined Jump Code table is a user customization facility that enables you to define your
own jump code values. This facility requires a table that consists of the 10-character user code and
the 10-character Sterling Gentran:Basic jump code. It must be coded in an Assembler table and the
name of the table must be entered on the Configuration file (Record Type 0). An entry for the table
name must be added to your CICS resource definitions.
When you type a jump code, the system verifies that the jump code you entered is valid by first
checking the User-Defined Jump Code table. If you have not defined a User-Defined Jump Code
table, or if the jump code you entered is not in that table, then the system checks the default jump
code table.
For help using the User-Defined Jump Code Table, see member EDIJUMP in the
GENTRAN.V6X6.UTILITY SOURCE LIBRARY.
Jump Code Guidelines
The Sterling Gentran:Basic system keeps independent position information for each subsystem
(Partner, Standards, Databank, Administrative, Mapping), as well as for Sterling Gentran:Basic
add-on products (Plus, Control, Realtime, Viewpoint). The independence of these subsystems
enables you to jump or navigate from subsystem to subsystem without having to re-enter a key for
that screen.
The general rules for using jump codes are the following:
You can jump to only screens that are directly accessible through selecting menu
options.
You can jump from any screen.
Navigating or jumping to the Sterling Gentran:Basic Copyright/Signon screen, or
exiting the Sterling Gentran:Basic system, clears the positions for all subsystems.
After you jump from one subsystem to another subsystem, you can return directly
to the screen you jumped from by typing SWAP in the Jump Code field.
Jump Codes Getting Started
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 1 - 33
You cannot use SWAP to jump between screens within the same subsystem.
Typing SWAP is the only method by which you can jump to a screen that has no
jump code associated with it, as long as SWAP positioning has been established
by jumping from one subsystem screen to a different subsystem screen.
An invalid jump code causes the system to return to the jumped from screen and
display the message Invalid jump code entered.
You cannot jump to subsystems that are not installed or for which you do not have
security access. The message Invalid jump — user lacks authority is
displayed on the screen.
How To Get Help
The IBM® Sterling Customer Center provides a wealth of online resources that are available
around the clock to enrich your business experience with IBM® Sterling Gentran®. By using
Sterling Customer Center, you gain access to many self-support tools, including a Knowledge-
Base, Documentation, Education, and Case Management. Access Sterling Customer Center at
http://customer.sterlingcommerce.com.
Once logged in, select Support Center from the top navigation menu, and then locate Sterling
Gentran product-specific support information from the left navigation menu.
Additionally, our Customer Support Reference Guide outlines our support hours, contact
information, and key information that will enhance your support experience with us. For detailed
information about Customer Support, please refer to the Customer Support Reference Guide
accessible from the login page. (http://customer.sterlingcommerce.com)
Getting Started Jump Codes
1 - 34 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Chapter
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 1
2The Partner Subsystem
Overview
This chapter contains the following topics related to the Partner subsystem.
Topic Page
Before You Begin .................................................................................................................. 2-3
Partner Maintenance Menu.............................................................EDIM005 .................... 2-10
Partner Directory ............................................................................EDIM010 .................... 2-10
Partner Selection Menu ..................................................................EDIM007 .................... 2-17
Header Information Screen ............................................................EDIM026 .................... 2-22
Interchange Directory Screen .........................................................EDIM027 .................... 2-27
Control Information 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.....................EDIM017 .................... 2-48
Control Information Screen 2—UNA Options...............................EDIM012 .................... 2-52
Control Information Screen 2—UNB Options...............................EDIM019 .................... 2-57
Control Information Screen—UNB Options
Part 1 / Syntax Version 4 ................................................................EDIM021 .................... 2-62
Control Information Screen—UNB Options
Part 2 / Syntax Version 4 ................................................................EDIM022 .................... 2-67
Control Information Screen 2—SCH Options................................EDIM013 .................... 2-71
Control Information Screen 2—STX Options................................EDIM014 .................... 2-76
Group Directory..............................................................................EDIM020 .................... 2-81
Group Information Screen ..............................................................EDIM030 .................... 2-86
Group Information Screen—BAT Options ....................................EDIM031 .................... 2-93
Group Information Screen—UNG Options ...................................EDIM032 .................... 2-98
Group Information Screen—GS Options ......................................EDIM033 .................. 2-103
Transaction Directory .....................................................................EDIM025 .................. 2-108
Transaction Information Screen .....................................................EDIM040 .................. 2-113
Transaction Information Screen—ST Options ..............................EDIM043 .................. 2-120
The Partner Subsystem Overview
2 - 2 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Transaction Information Screen—UNH Options
Part 1 ..............................................................................................EDIM042 .................. 2-124
Transaction Information Screen—UNH Options
Part 2...............................................................................................EDIM046 .................. 2-128
Transaction Information Screen—UNH Options
Part 3...............................................................................................EDIM047 .................. 2-132
Transaction Information Screen—MHD Options .........................EDIM041 .................. 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...................................................................EDIM050 .................. 2-152
Error Rejection Screen....................................................................EDIM055 .................. 2-158
Copy All Records Screen ...............................................................EDIM060 .................. 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 ...........................EDIM023 .................. 2-177
Trading Partner Relationship By Partner Screen............................EDIM024 .................. 2-182
Before You Begin The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 3
Before You Begin
What is a Partner Profile?
To successfully facilitate electronic commerce, Sterling Gentran requires specific information
about each trading partner. Whether intra-company or inter-company in nature, all trading partner
relationships are defined and maintained in Sterling Gentran, on the Partner Maintenance
subsystem.
You can choose from two processing methodologies when defining the partner profile: Partner/
Qualifier mode and Relationship mode. The Partner/Qualifier method defines your organization
and each trading partner as separate and distinct entities on the partner profile. This method
permits each trading partner to be used in multiple relationships. With the Relationship method,
you first identify the inter- or intra- business relationships. Then, you define each identified
relationship separately and distinctly on the partner profile. This method is ideal for defining
multiple entities within your organization with shared (common) trading partners. In addition, the
Relationship method provides uniqueness for identification purposes that would not be possible if
the trading partner were defined using the Partner/Qualifier method. Both processing modes can
be selected and maintained through the Configuration subsystem.
The Partner/Qualifier mode creates a loosely coupled relationship between trading partners. One
Partner ID and Qualifier is defined for each trading partner and for each entity within an
organization involved with e-commerce. With the Partner/Qualifier method, relationships are
defined externally to the partner profile during processing.
The Relationship mode creates a closely coupled relationship between trading partners. Each
relationship is uniquely defined on the partner profile in a user/partner format where the User side
always represents your organization and the Partner side always represents your trading partner.
To bridge the transition from EDI Sender ID, EDI Sender ID Qualifier, EDI Receiver ID, and EDI
Receiver ID Qualifier found on your EDI documents to a user/partner key on the partner profile,
Sterling Gentran uses a partner Relationship file. This file is built and maintained online through
CICS.
Note: For the existing Sterling Gentran user who used
Relationship mode in Release 6.0 and who does not want
to expand that usage to the partner profile, a Mixed mode
is available in Release 6.6. In Mixed mode, the partner
profile is configured in Partner/Qualifier mode, and the
databank is set up in Relationship mode.
The Partner Subsystem Before You Begin
2 - 4 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
What is in this Chapter?
This chapter explains the menus and screens of the Sterling Gentran:Basic partner profile, which is
accessed through the Partner subsystem. In addition, this chapter describes how to perform the
following functions:
Add a new trading partner using either Partner/Qualifier or Relationship mode
Copy and rename an existing trading partner
Add name, address, and contact information for a trading partner
Set up error rejection criteria by trading partner
Set up data separation by trading partner
Add notes or special instructions to a user defined record by trading partner
Define an alias Partner ID and Qualifiers through a partner cross-reference file
Define user/partner relationships for a trading partner
Define and maintain multiple interchange, group, and transaction sets under a
common trading partner
Maintain interchange header, functional groups, and transaction set information
for inbound and outbound processing by trading partner
How to Access the Partner Subsystem
The screen flow is determined by the partner processing mode, Partner/Qualifier or Relationship
mode, selected from Configuration Maintenance.
Note: In the Configuration Maintenance, the On-Line Options –
Record Type 0 (Panel 2 of 3) screen enables you to define
the partner processing mode for the trading partner
profile.
See Chapter 5, “The Administration Subsystem,” for
more information about Configuration Maintenance.
You can display all the screens in the Partner subsystem from the Partner Maintenance Menu.
Perform either of these two actions to display the Partner Maintenance Menu:
From the Sterling Gentran Main Menu, type 1 to select the Partner Maintenance
Menu subsystem.
•Type 1.0 in the Jump Code field on any screen in Sterling Gentran:Basic.
Before You Begin The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 5
Each menu contains a selection field allowing you to type the number of a task selection as listed
on the menu. After typing the task number and pressing Enter, Sterling Gentran displays the
appropriate screen. When you make a menu selection, the system displays screens that prompt you
through the processes available in the Partner Profile Maintenance feature. There are 39 screens
available in the Partner Profile Maintenance feature. Some screens allow you to perform a subtask
and are only accessible from another screen (e.g., Control Information screens). Subtask screens
are not listed on the menus.
When performing partner profile maintenance, consider the following:
1. There are eight record types that comprise a single trading partner definition on the partner
profile. All screens point to one or more of these records. The order of the record key is
defined by you and consists of the Partner ID and Qualifier (Partner/Qualifier mode) or
user/partner (Relationship) mode. Adding or selecting a particular trading partner can only
be accomplished through the Partner Selection Menu screen. The record key entered on
this screen is used to read (or write) all other record types that make up a trading partner
on the partner profile.
2. For any hexadecimal conversion fields (e.g., element separators), the system evaluates the
single position alphanumeric field first, then the two position hexadecimal field.
Therefore, any time data is entered in both fields, the system overlays the value entered in
the hexadecimal field with the hexadecimal value of the first alphanumeric field.
3. Users with Level 1 security have unrestricted file maintenance rights. If you have Level 2
security, you may be allowed to perform additions, updates, and deletions to the trading
partner profile records. The system displays the PF9=Add, PF10=Updt, and PF11=Del
function keys. If you have Level 3 security, you are not able to add, update, or delete
trading partner profile records, and the function keys are not displayed. When adding a
new record, the default value is Y for the Update Flag.
4. You can view and maintain records only for those trading partners having the same
division code as your own. The system displays all trading partners when the division
code equals 000. Any record that contains a division code of spaces is considered to be a
corporate record, and can be used by more than one division. All users can access these
records.
See the topic “User ID Maintenance Screen” in Chapter 5, “The Administration
Subsystem,” for more information on Division access.
Figure 2.1 and Figure 2.2 illustrate how to navigate through the Partner subsystem for the
Partner/Qualifier and Relationship modes. The labeled boxes represent screens in the subsystem.
The Partner Subsystem Before You Begin
2 - 6 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Partner/Qualifier Mode
Figure 2.1 Partner Subsystem Screen Flow
Partner
Menu
Partner
Directory
Partner
Cross
Reference
Partner
Selection
Maintenance
Group
Directory
Name
Address
and
User
Defined
Data
Separation
Copy All
Records
Error
Rejection
Menu
Group
Information
Transaction
Information
Partner
Cross Ref
by X–Ref ID
Partner
Cross Ref
by Partner ID
Header
Control
Information
Control
Directory
Transaction
Directory
Before You Begin The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 7
Relationship Mode
Figure 2.2 Relationship Screen Flow
Note: The screen flow is determined by the partner profile
processing mode selected on the Configuration file to
define a trading partner, Partner/Qualifier or Relationship
(user/partner).
Partner Jump Codes
A jump code is a 10-character alphanumeric field located at the upper left corner of each Sterling
Gentran:Basic screen. This field enables you to move, or jump, directly from one screen to
another, within a subsystem, while bypassing menu screens. All screens that are accessible through
a Sterling Gentran:Basic menu have jump codes associated with them. Screens that are accessible
only from detail screens do not have jump codes associated with them.
See Chapter 1, “Getting Started,” for further information on using jump codes.
Group
Directory
User
Defined
Data
Separation
Copy All
Records
Error
Rejection
Group
Information
Transaction
Information
Header
Control
Information
Partner Trading
Relationship
Menu
Partner
Maintenance
Menu
Partner
Selection
Menu
Partner
Directory
Trading Partner
Relationship by
EDI ID
Trading Partner
Relationship by
User/Part ID
Name
and
Address
(User)
Name
and
Address
(Part)
Control
Directory
Transaction
Directory
The Partner Subsystem Before You Begin
2 - 8 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
You can jump between screens without having to display the Sterling Gentran:Basic menus. Use
the following procedure to jump between screens:
Step 1: Press Home.
The insertion point moves to the Jump Code field at the top of the screen to the
right of the screen number.
Step 2: Type the jump code and press Enter.
Note: If you move the insertion point to the Jump Code field
and you then decide not to enter a jump code, press Tab
to return to the next entry field on the screen.
The following table lists the jump codes for the Sterling Gentran:Basic Partner subsystem menus
and screens. The screens are listed by name and are arranged in the order in which they are
displayed on the Sterling Gentran:Basic menus.
Screen Jump Codes
Screen Title Number Numeric Alphabetic
Sterling Gentran Main Menu EDIM001 0.0
0
BSC
MAIN
Partner Maintenance Menu EDIM005 1.0
1
PART
Partner Directory EDIM010 1.1 PART.DIR
Partner Selection Menu EDIM007 1.2 PART.MENU
Header Information EDIM026 1.2.1 PART.HDR
Interchange Directory EDIM027 1.2.2 PART.INTD
Control Information EDIM015 1.2.2.1 PART.CNTL
PART.CTL
Group Directory EDIM020 1.2.3 PART.GRPD
Group Information EDIM030
EDIM033
1.2.3.1 PART.GRP
Transaction Directory EDIM025 1.2.4 PART.TRND
Transaction Information EDIM040
EDIM043
1.2.4.1 PART.TRN
Name and Address EDIM035 1.2.5 PART.NAME
User Defined EDIM045 1.2.6 PART.USER
Data Separation EDIM050 1.2.7 PART.DSEP
PART.SEP
Error Rejection EDIM055 1.2.8 PART.ERR
Copy All Records EDIM060 1.2.9 PART.CPY
PART.COPY
Before You Begin The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 9
Note: You can jump to the Partner screens at the 1.2.# level
only if the partner position has already been established
(e.g., a Partner ID has already been selected and is
present in the Position work area).
In instances in which multiple screens comprise a logical
operation, only the first screen is assigned a jump code.
To display subsequent screens in this scenario, jump to
the first screen, and then press PF5 to display the next
screen.
See Appendix A for a complete list of jump codes and their associated screens.
Partner/Qualifier Mode
Partner Cross-Reference
Menu
EDIM009 1.3 PART.XREF
Partner Cross Reference by
X-Ref ID
EDIM008 1.3.1 PART.XREFX
Partner Cross Reference by
Partner ID
EDIM006 1.3.2 PART.XREFP
Relationship (User/Partner) Mode
Trading Partner Relationship
Menu
EDIM009 1.3 PART.REL
Trading Partner Relationship
by EDI ID
EDIM023 1.3.1 PART.RELE
Trading Partner Relationship
by User/Partner
EDIM024 1.3.2 PART.RELP
Screen Jump Codes
Screen Title Number Numeric Alphabetic
The Partner Subsystem Partner Maintenance Menu EDIM005
2 - 10 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Partner Maintenance Menu EDIM005
Purpose
The Partner Maintenance Menu contains three menu options for both Partner/Qualifier and
Relationship (user/partner) modes that you can use to perform partner profile maintenance. The
three maintenance screens allow you to display, add, and maintain Partner profiles.
How to Access
Access the Partner Maintenance Menu in either of these two ways:
From the Sterling Gentran Main Menu, type 1 to select the Partner Maintenance
Menu and press Enter.
•Type 1.0 in the Jump Code field of any screen and press Enter.
Menu Examples
The following examples illustrate the Partner Maintenance Menu for both Partner/Qualifier and
Relationship (user/partner) modes.
Partner/Qualifier Mode
EDIM005 1.0_______ PARTNER MAINTENANCE MENU XXX 06/01/2011
12:00:00
Type the number of your selection below and press ENTER, or
press the PF3 key to Exit.
_ 1. Partner Directory
2. Partner Maintenance
3. Partner Cross-Reference Menu
Enter PF1=Help PF3=Exit
PF15=Logoff
Partner Maintenance Menu EDIM005 The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 11
Relationship Mode
Menu Options
The following table describes the three menu options on the Partner Maintenance Menu for both,
Partner/Qualifier and Relationship (user/partner) modes.
Partner/Qualifier Mode
Menu Options Description
1. Partner Directory Lists all currently defined partner control
records.
2. Partner Maintenance Enables you to add, display, and maintain
trading partner record definitions for each of
your trading partners.
3. Partner Cross-Reference Menu Enables you to perform a search by Cross
Reference ID or Partner ID to display and
maintain a particular trading partner cross-
reference.
EDIM005 1.0_______ PARTNER MAINTENANCE MENU XXX 06/01/2011
12:00:00
Type the number of your selection below and press ENTER, or
press the PF3 key to Exit.
_ 1. Partner Directory
2. Partner Maintenance
3. Trading Partner Relationship
Enter PF1=Help PF3=Exit
PF15=Logoff
The Partner Subsystem Partner Maintenance Menu EDIM005
2 - 12 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Field Descriptions
Note: Fields that are display-only contain the statement
(protected) next to the field name in the documentation.
Fields in which you must enter a value contain the
statement (required) next to the field name in the
documentation.
Jump Code
A 10-position alphabetic or numeric field containing the jump code for this screen. A
screen’s jump code automatically is displayed in the Jump Code field for that screen.
To jump to another screen, press Home; type the jump code of the screen to which you
want to jump, and then press Enter.
See Chapter 1, “Getting Started,” for further information on using jump codes.
Selection
This field is used to make a menu selection. Type a valid value (1, 2, or 3) and press
Enter to perform the selected function.
Relationship (User/Partner)
Mode Menu Option Description
1. Partner Directory Lists all currently defined partner control
records.
2. Partner Maintenance Enables you to add, display, and maintain
trading partner record definitions for each of
your trading partners.
3. Trading Partner Relationship Enables you to perform a search by EDI ID or
User/Partner ID to display and maintain a
particular trading partner relationship.
Partner Directory EDIM010 The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 13
Partner Directory EDIM010
Purpose
The Partner Directory displays a list of all Partner IDs currently on file. This list includes only the
Partner IDs that exist on your trading partner header records.
You can only view a list of those trading partners that have the same security division as defined
for your logon or those defined with a division code of spaces. Logon IDs defined with a division
of ‘000’ may view all trading partner records.
See the topic “User ID Maintenance Screen” in Chapter 5, “The Administration Subsystem,” for
more information on division access.
How to Access
Access the Partner Directory in either of the following ways:
•Type 1 to select the Partner Directory option from the Partner Maintenance Menu
and press Enter.
•Type 1.1 in the Jump Code field of any screen and press Enter.
Screen Examples
The following examples illustrate the Partner Directory for both Partner/Qualifier and
Relationship modes.
Partner/Qualifier Mode
Select
EDIM010 1.1_______ PARTNER DIRECTORY XXX 06/01/2011
12:00:00
Starting Partner Id: ___________________________________
U
A Partner Qual Name A
_ !!!GENTRAN-RESERVED-PARTNER-ID-1 GENTRAN RESERVED PARTNER Y
_ BG-PARTNER EXAMPLE OF A BG PARTNER Y
_ ICS-PARTNER EXAMPLE OF AN ICS PARTNER Y
_ ISA-PARTNER EXAMPLE OF AN ISA PARTNER Y
_ STX-PARTNER EXAMPLE OF AN STX PARTNER Y
_ UNA-PARTNER EXAMPLE OF A UNA PARTNER Y
_ VENDOR-1 TUTORIAL - XYZ COMPUTER COMPANY Y
_ VENDOR-2 TUTORIAL - BULK PAPER COMPANY Y
_ VENDOR-3 TUTORIAL - TWO WAY COMMUNICATIONS Y
_ VENDOR-4 TUTORIAL - RANDOM OFFICE SUPPLY Y
_ VENDOR-5 TUTORIAL - OVERSEAS MINING COMPAN Y
_ VENDOR-6 TUTORIAL - SOFTWARE HOUSE PLC Y
_
END OF PARTNERS
Enter PF1=Help PF3=Exit PF5=Maint
PF7=Bwd PF8=Fwd
The Partner Subsystem Partner Directory EDIM010
2 - 14 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Relationship Mode
Screen Actions
In the Partner Directory, Sterling Gentran displays a list of all Partner IDs on file.
Note: You can advance to the trading partner you want to
access by using the Starting Partner Id field for Partner/
Qualifier mode, or the Starting User and Starting Partner
fields for Relationship mode.
See the following “Field Descriptions” sub-topic for
more information.
The screen actions are displayed on the top line of the Partner Directory. The following table
describes each screen function and gives instructions on how to perform those functions.
To perform
this action...
Associated
with this
screen
action...
Do this...
Retrieve the Partner
Selection Menu screen
for a trading partner
selected on the Partner
Directory
Select To select a Partner ID to view or maintain,
type S in the A field next to the Partner ID
you want to view on the Partner Directory.
Then, press PF5.
Select
EDIM010 1.1_______ PARTNER DIRECTORY XXX 06/01/2011
12:00:00
Starting User .....: ___________________________________
Partner ..: _______________
U
A User Partner User Name Partner Name A
_ YOUR COMPANY VENDOR-1 YOUR COMPANY NAME VENDOR-1 NAME Y
_
_
_
_
_
_
_
_
_
_
_
_
TO SELECT, TYPE "S" BESIDE THE PARTNER AND PRESS THE APPROPRIATE KEY
Enter PF1=Help PF3=Exit PF5=Maint
PF7=Bwd PF8=Fwd
Partner Directory EDIM010 The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 15
Function Key Descriptions
Note: Standard function keys, such as PF1=Help, PF3=Exit,
PF7=Bwd, PF8=Fwd, PF12=Cancel, and
PF15=Logoff, as well as the Enter key, are defined in
Chapter 1.
PF5=Maint Displays the Partner Selection Menu with the Partner ID you have selected.
Field Descriptions
Note: Fields that are display-only contain the statement
(protected) next to the field name in the documentation.
Fields in which you must enter a value contain the
statement (required) next to the field name in the
documentation.
Jump Code
A 10-position alphabetic or numeric field containing the jump code for this screen. A
screen’s jump code is displayed in the Jump Code field for that screen.
To jump to another screen, press Home, type the jump code of the screen to which you
want to jump, and then press Enter.
See Chapter 1, “Getting Started,” for further information on using jump codes.
Partner/Qualifier Mode Relationship Mode
Field Description Field Description
Starting
Partner Id
A 35-position alphanumeric field
used to specify a Partner ID from
which viewing begins. Type the
Partner ID you want to access. If
you type a partial Partner ID in
this field, the system displays up
to 13 Partner IDs starting with the
nearest Partner ID match.
Starting
User
A 15-position alphanumeric field used
to specify the User portion of a User/
Partner ID from which viewing
begins. Type the desired User ID. You
can type a partial User ID in this field
and the system displays up to 13 User/
Partner IDs starting with the nearest
User ID match.
The Partner Subsystem Partner Directory EDIM010
2 - 16 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
A (Action Code)
A 1-position alphabetic field used to specify an action to perform. Type S (Select) and
press PF5 to display the Partner Selection Menu.
UA (Update Allowed) (protected)
Displays the current value for the Update Allowed flag that controls whether this trading
partner may be updated. Valid values are:
N = No, user cannot make updates to the current parameters. The value N
is set for a user maintaining Level 1 Security (typically a system
administrator) to lock the established parameters set for Partner IDs
that are currently in production.
Y= Yes, allow a user with Level 2 or Level 1 Security to change the
parameters for the specified trading partner.
Partner
(protected)
Displays the Partner ID. Starting
Partner
A 15-position alphanumeric field used
to specify the Partner portion of a
User/Partner ID from which viewing
begins. Type the desired Partner ID.
You can type a partial Partner ID in
this field and the system displays up
to 13 User/Partner IDs starting with
the closest User/Partner ID match.
Note: This directory lists Partner IDs
only as they are displayed on their
header records. Also, remember that
you can only view a listing of those
Partner IDs having the same security
division as defined for your logon.
Division 000 displays ALL Partner
IDs.
See the topic “User ID Maintenance
Screen” in Chapter 5 for more
information on division access.
Qual
(protected)
Displays the Qualifier associated
with the trading partner, if
applicable.
User
(protected)
Displays the User portion of the User/
Partner Profile ID.
Name
(protected)
Displays the trading partner name
describing the Partner ID, if it
exists on file.
Partner
(protected)
Displays the Partner portion of the
User/Partner Profile ID.
User Name
(protected)
Displays the trading partner name
defining the User ID, if it exists on
file.
Partner
Name
(protected)
Displays the trading partner name
describing the Partner ID, if it exists
on file.
Partner/Qualifier Mode Relationship Mode
Field Description Field Description
Partner Selection Menu EDIM007 The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 17
Partner Selection Menu EDIM007
Purpose
The Partner Selection Menu displays a list of menu selections from which to choose to view, add,
or maintain Partner Profile IDs.
From the Partner Selection Menu, you can select a record type to display information for an
existing Partner Profile ID by typing the selection number of the record type in the selection field.
Information for each of the eight record types listed on the Partner Selection Menu is entered on a
separate screen. The Control Information, Group, and Transaction records have multiple screens.
This section discusses each partner maintenance screen and the Copy All feature.
How to Access
Access the Partner Selection Menu in either of the following ways:
•Type 2 to select Partner Maintenance from the Partner Maintenance Menu and
press Enter.
•Type 1.2 in the Jump Code field of any screen and press Enter.
Menu Examples
The following examples illustrate the Partner Selection Menu for both Partner/Qualifier and
Relationship modes.
Partner/Qualifier Mode
EDIM007 1.2_______ PARTNER SELECTION MENU XXX 06/01/2011
12:00:00
EXAMPLE OF AN ISA PARTNER
Part ID: VENDOR-1___________________________ Qual: _______________
Copy ID: ___________________________________ Qual: _______________
Type the number of your selection below and press ENTER,
or press the PF3 key to Exit.
_ 1. Header Information
2. Interchange Directory
3. Group Directory
4. Transaction Directory
5. Name and Address
6. User Defined
7. Data Separation
8. Error Rejection
9. Copy All Records
Job Name: _______
Enter PF1=Help PF3=Exit PF4=Dir
PF7=Rpt
The Partner Subsystem Partner Selection Menu EDIM007
2 - 18 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Relationship Mode
Menu Options
There are nine selections on the Partner Selection Menu. There are eight partner maintenance
record options and one menu function available (i.e., Copy All Records feature).
Note: The Partner Selection Menu provides the same menu
options for both Partner/Qualifier and Relationship
modes.
The following table provides the eight options and their descriptions.
Menu Option Description
1. Header Information Enables you to add, change, or delete partner profile
information
2. Interchange Directory Enables you to add, change, or delete interchange
control records for partner profile information
3. Group Directory Enables you to add or maintain separate processing
rules for various groups
4. Transaction Directory Enables you to add or maintain separate processing
rules for various transactions
5. Name and Address Enables you to add or maintain each trading partner's
name, address, and telephone number
EDIM007 1.2_______ PARTNER SELECTION MENU XXX 06/01/2011
12:00:00
YOUR COMPANY NAME XYZ COMPUTER COMPANY
User: YOUR_COMPANY_______________________ Partner: VENDOR-1_______
Copy User: ___________________________________ Partner: _______________
Type the number of your selection below and press ENTER,
or press the PF3 key to Exit.
_ 1. Header Information
2. Interchange Directory
3. Group Directory
4. Transaction Directory
5. Name and Address
6. User Defined
7. Data Separation
8. Error Rejection
9. Copy All Records
Job Name: _______
Enter PF1=Help PF3=Exit PF4=Dir PF5=Ref
PF7=Rpt
Partner Selection Menu EDIM007 The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 19
Menu Functions
Copy All Feature
Sterling Gentran:Basic helps prevent you from duplicating and overwriting user records that may
already exist. The Copy All Records feature provides you with the ability to efficiently copy
records from an existing trading partner to a newly added trading partner. From the Partner
Selection Menu, you can add a new Partner Profile ID and copy to it all of the records from an
existing Partner Profile ID.
See the topic “Copy All Records Screen” for more information about the Copy All feature.
Function Key Descriptions
Note: Standard function keys, such as PF1=Help, PF3=Exit,
PF8=Fwd, PF12=Cancel, and PF15=Logoff, as well as
the Enter key, are defined in Chapter 1.
To display a record type for an existing Partner Profile ID, or to begin to create a record type for a
new Partner ID, type the Partner ID and associated Qualifier code for Partner/Qualifier mode or
User and Partner for Relationship mode. Use the Tab key to move the insertion point to the
selection field, type the selection number of the desired record type and press Enter. The system
then displays the selected record type entry screen.
PF4=Dir Returns to the Partner Directory where you can view a listing of Partner
Profile IDs. If a complete or partial Partner ID exists in the Partner ID field,
the system displays the directory starting with the selected Partner ID (or
nearest match) at the top.
PF7=Rpt Allows you to submit the batch Partner Print report for the Profile ID
displayed at the top of the screen.
6. User Defined Enables you to maintain additional reference
information that you want to define for any trading
partner
7. Data Separation Enables you to establish inbound split files based
upon group or transaction type or outbound split files
based upon trading partner
8. Error Rejection Enables you to designate those errors that you decide
are not acceptable, allowing you to reject the data at
the partner (interchange), group, or transaction level
9. Copy All Records Enables you to duplicate all of an existing trading
partner's records using one step to create a new
partner record
(Continued)
Menu Option Description
The Partner Subsystem Partner Selection Menu EDIM007
2 - 20 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Field Descriptions
Note: Fields that are display-only contain the statement
(protected) next to the field name in the documentation.
Fields in which you must enter a value contain the
statement (required) next to the field name in the
documentation.
Jump Code
A 10-position alphabetic or numeric field containing the jump code for this screen. A
screen’s jump code is displayed in the Jump Code field for that screen.
To jump to another screen, press Home, type the jump code of the screen to which you
want to jump, and then press Enter.
See Chapter 1, “Getting Started,” for further information on using jump codes.
Selection
This field is used to make a menu selection. Type a valid value (1, 2, 3, 4, 5, 6, 7, 8, or 9)
and press Enter to access to the selected menu.
Job Name
An 8-position alphanumeric field used to designate a user-specified jobname when
printing a report using the PF7 key. Valid values are any valid jobname.
To select reports for printing, type the user-specified jobname in the Job Name field and
press PF7. If you do not type a value in the Job Name field, the system uses a default
value, which is user-specified during installation customization of the JCL (EDIRJCL)
file.
Partner/Qualifier Mode Relationship Mode
Field Description Field Description
(Partner
Name -
protected)
A 35-position
alphanumeric field used
to display the partner
name, as found on the
Name and Address
record. The partner name
can help to help to further
identify the Partner ID.
(User
protected)
Displays up to a 15-position
User ID, if it exists on file for
Relationship mode.
Part ID A 35-position alphabetic
field used to select a
Partner ID for which you
are displaying, creating,
modifying, or deleting
records.
(Partner
protected)
Displays up to a 15-position
alphabetic Partner ID, if it exists
on file for Relationship mode.
Partner Selection Menu EDIM007 The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 21
Qual A 4-position
alphanumeric field used
to enter the Qualifier
associated with the
Partner ID, if applicable.
User/
Partner
(required)
Two 15-position alphanumeric
fields used to select a User ID
and Partner ID for the
Relationship for which want to
display, create, modify, or delete
records.
Copy ID A 35-position
alphanumeric field used
to enter the Partner ID of
an existing trading
partner from which you
are copying all records.
This field (on this screen)
is used only with the
COPY ALL feature. The
COPY ALL feature is
discussed in detail under
the Menu Functions
header above.
Copy User/
Partner
Two 15-position alphanumeric
fields used to enter the User/
Partner ID of an existing trading
relationship from which you are
copying all records. The Copy
User/Partner ID field is used
only with the Copy All feature.
See the topics “Menu Functions”
and “Menu Options” previously
in this section for more
information about the COPY
ALL feature.
Qual A 4-position
alphanumeric field used
to enter the Qualifier
Code (if applicable)
associated with the
Partner ID entered in the
Copy From ID field.
Partner/Qualifier Mode Relationship Mode
Field Description Field Description
The Partner Subsystem Header Information Screen EDIM026
2 - 22 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Header Information Screen EDIM026
Purpose
The Header Information screen enables you to display, update, add, or delete information about a
trading partner. This information is required for all other partner profile maintenance procedures
and screens. The Header Information screen is the first record that you will need to create to add a
new trading partner.
Caution: When you delete the header record for a trading partner,
all other records for this trading partner are deleted as
well.
How to Access
Access the Header Information screen in either of the following ways:
•Type 1 to select Header Information from the Partner Selection Menu and press
Enter.
•Type 1.2.1 in the Jump Code field of any screen and press Enter (this functions
only if the Partner ID has been established).
At installation, Sterling Gentran:Basic automatically sets up a default Partner ID. The default
Partner ID contains default Group and Transaction records that are required for each trading
partner. Each time you add a new Partner ID and Control record, the system automatically uses the
default Group and Transaction record templates to create default Group and Transaction records
for the new trading partner. You have the capability to modify the values in the generic default
records to create your own default records. After modification, Sterling Gentran will then use the
values specified in your default records.
Partner/Qualifier Mode
The default Partner ID containing the default Group and Transaction records is:
!!! GENTRAN–RESERVED–PARTNER–ID–1
Relationship Mode
Following is the default Partner Profile ID containing the default Group and Transaction records:
!!! GENTRAN–RU1 !!! GENTRAN–RP1
The default Partner ID can be viewed and modified from the Partner Selection Menu like any other
ID (and associated records).
See the topic “Partner Selection Menu” for information on how to display and change the records
for a specified Partner ID.
Header Information Screen EDIM026 The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 23
Screen Examples
The following examples illustrate the Header Information screen for both Partner/Qualifier and
Relationship (user/partner) modes.
Partner/Qualifier Mode
Relationship Mode
EDIM026 1.2.1_____ HEADER INFORMATION XXX 06/01/2011
12:00:00
EXAMPLE OF AN ISA PARTNER
Part ID: ISA-PARTNER Qual:
Description:
EXAMPLE_OF_AN_ISA_PARTNER_______________
________________________________________
Underscore Character : _
Division . . . . . . : 000
Update Allowed . . . : Y (Y/N)
Last Update Date . . : 00/00/00 Time . . : 00:00:00 User . . : SCI
Enter PF1=Help PF3=Exit PF5=IDir
PF9=Add PF10=Updt PF11=Del
EDIM026 1.2.1_____ HEADER INFORMATION XXX 06/01/2011
12:00:00
YOUR COMPANY NAME VENDOR-1 NAME
User...: YOUR COMPANY Partner: VENDOR-1
Description:
GENTRAN_TEST_PARTNER____________________
________________________________________
Underscore Character : _
Division . . . . . . : 000
Update Allowed . . . : Y (Y/N)
Last Update Date . . : 00/00/00 Time . . : 00:00:00 User . . : SCI
Enter PF1=Help PF3=Exit PF5=IDir
PF9=Add PF10=Updt PF11=Del
The Partner Subsystem Header Information Screen EDIM026
2 - 24 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Function Key Descriptions
Note: Standard function keys, such as PF1=Help, PF3=Exit,
PF7=Bwd, PF8=Fwd, PF12=Cancel, and
PF15=Logoff, as well as the Enter key, are defined in
Chapter 1.
PF5=IDir Displays the Interchange Directory.
PF9=Add Adds a header record for a new Partner ID being added to the partner profile.
Note: When you add a new header record, the system
automatically adds default Group and Transaction
records, based on the
!!!GENTRAN–RESERVED–PARTNER– ID–1 (Partner/
Qualifier mode)
OR
!!!GENTRAN-RU1/!!!GENTRAN-RP1
(Relationship mode)
PF10=Updt Updates the header record for an existing Partner ID.
PF11=Del Deletes a header record AND SUBSEQUENTLY ALL OTHER
RECORDS for an existing Partner ID.
Field Descriptions
Note: Fields that are display-only contain the statement
(protected) next to the field name in the documentation.
Fields in which you must enter a value contain the
statement (required) next to the field name in the
documentation.
Jump Code
A 10-position alphabetic or numeric field containing the jump code for this screen. A
screen’s jump code is displayed in the Jump Code field for that screen.
To jump to another screen, press Home, type the jump code of the screen to which you
want to jump, and then press Enter.
See Chapter 1, “Getting Started,” for further information on using jump codes.
Header Information Screen EDIM026 The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 25
Description
A 120-position alphanumeric field that can be used to further describe this partner profile,
if you are processing in Partner/Qualifier mode. This field also describes the user/partner
relationship if you are processing in Relationship mode.
Underscore Character
A 1-position alphabetic field that contains the underscore substitution character that will
be used in place of the actual underscore ( _ ) on the screen display of selected fields for
this partner. Valid values are: ~, ! , @ , #, $, %, ¬, &, *,
( , ) , - , = , +, { , } , : , ; , < , > , / , ? , | , \ , and space.
See the topic “Using Underscore Substitution Characters” in Chapter 7 for more
information about this feature.
Division (protected, except Division 000)
A 3-position alphanumeric field assigned by the user at the time the partner profile is
added. The default value is 000. Although this field is called Division, it is used for
grouping partners under a common access. That is, access to a trading partner is tied to the
Division code on your Security Profile. Before changing the Division code from 000,
consider how users are organized in respect to adding and updating the partner profile. For
most companies, leaving the Division code as 000 and preventing unauthorized changes
through the Security Profile by access and level is sufficient.
Any record that contains a Division code of spaces is considered to be a corporate record
and can be used by more than one division. All users can access these records.
Partner/Qualifier Mode Relationship Mode
Field Description Field Description
(Partner
Name -
protected)
A 35-position
alphanumeric field used
to display the partner
name, as found on the
Name and Address
record. The partner name
can help to further
identify the Partner ID.
(User Name -
protected)
Displays up to a 35-position
alphanumeric user name, if
it exists on file for the User/
Partner ID.
Part ID
(protected)
Displays the Partner ID
you have entered or
selected.
Note: The Partner ID and
Qualifier make up the key
for all associated records.
(Partner Name -
protected)
Displays up to a 35-position
alphanumeric partner name,
if it exists on the file for the
User/Partner ID.
Qual
(protected)
Displays the Qualifier
associated with the
Partner ID, if applicable.
User/Partner
(protected)
Displays two 15-position
alphabetic fields that
contain the User/Partner ID
you have entered or
selected.
The Partner Subsystem Header Information Screen EDIM026
2 - 26 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Update Allowed (May be protected for users with Level 2 or 3 Security)
Displays the current value for the Update Allowed flag that controls whether this trading
partner may be updated. Valid values are:
N = No, user cannot make updates to the current parameters. The value N
is set for a user maintaining Level 1 Security (typically a system
administrator) to lock the established parameters set for Partner IDs
that are currently in production.
Y= Yes, allow a user with Level 2 or Level 1 Security to change the
parameters for the specified trading partner.
Note:Remember, ONLY a user with Level 1 security can
change the Update Allowed field.
Last Update Date (protected)
An 8-position field that displays the date on which this Trading Partner Header was
created or last changed. The date format is MM/DD/YY.
Last Update Time (protected)
An 8-position field that displays the time at which this Trading Partner Header was created
or last changed. The time format is HH:MM:SS.
Last Update User (protected)
A 3-position field that displays the initials of the user who created or last changed this
Trading Partner Header.
Interchange Directory Screen EDIM027 The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 27
Interchange Directory Screen EDIM027
Purpose
The Interchange Directory displays a list of all interchange control records currently on file for this
Partner Profile ID.
How to Access
Access the Interchange Directory in either of these two ways:
•Type 2 to select Interchange Directory from the Partner Selection Menu.
•Type 1.2.2 in the Jump Code field (this functions only if the Partner Profile ID
has already been established).
Screen Examples
The following examples illustrate the Interchange Directory for both Partner/Qualifier and
Relationship (user/partner) modes.
Partner/Qualifier Mode
Select
EDIM027 1.2.2_____ INTERCHANGE DIRECTORY XXX 06/01/2011
12:00:00
GENTRAN RESERVED PARTNER
Part ID: !!!GENTRAN-RESERVED-PARTNER-ID-1 Qual:
MULTIPLE HEADER
A ENV ID OPTION VERSION
_ ISA ISA
_
_
_
_
_
_
_
_
_
_
_
TO SELECT INTERCHANGE ENTER AN S BESIDE THE ID
Enter PF1=Help PF3=Exit PF4=Hdr PF5=Ctrl
PF7=Bwd PF8=Fwd
The Partner Subsystem Interchange Directory Screen EDIM027
2 - 28 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Relationship Mode
Screen Actions
The screen actions are displayed on the top line of the Interchange Directory. The following table
describes each screen function and gives instructions on how to perform those functions.
Function Key Descriptions
Note: Standard function keys, such as PF1=Help, PF3=Exit,
PF7=Bwd, PF8=Fwd, PF12=Cancel, and
PF15=Logoff, as well as the Enter key, are defined in
Chapter 1.
PF4=Hdr Displays the Header Information screen.
PF5=Ctrl Displays the Control Information screen with the header option you have
selected.
To perform
this action...
Associated
with this
screen
action...
Do this...
View the Control screen
for the header option
selected on the
Interchange Directory
Select To select a header option to view or
maintain, type S in the A field, next to the
header option you want to view, on the
Interchange Directory. Then, press PF5.
Select
EDIM027 1.2.2_____ INTERCHANGE DIRECTORY XXX 06/01/2011
12:00:00
YOUR COMPANY NAME XYZ COMPUTER COMPANY
User: YOUR COMPANY Partner: VENDOR-1
MULTIPLE HEADER
A ENV ID OPTION VERSION
_ ISA ISA
_
_
_
_
_
_
_
_
_
_
_
TO SELECT INTERCHANGE ENTER AN S BESIDE THE ID
Enter PF1=Help PF3=Exit PF4=Hdr PF5=Ctrl
PF7=Bwd PF8=Fwd
Interchange Directory Screen EDIM027 The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 29
Field Descriptions
Note: Fields that are display-only contain the statement
(protected) next to the field name in the documentation.
Fields in which you must enter a value contain the
statement (required) next to the field name in the
documentation.
Jump Code
A 10-position alphabetic or numeric field containing the jump code for this screen. A
screen’s jump code is displayed in the Jump Code field for that screen.
To jump to another screen, press Home, type the jump code of the screen to which you
want to jump, and then press Enter.
See Chapter 1, “Getting Started,” for further information on using jump codes.
A (Action Code)
A 1-position alphabetic field used to specify an action to perform. Type S (Select) next to
a Partner ID, and then press PF5 to display the Partner Selection Menu.
Multiple Env ID (protected)
A 3-position alphabetic field used to identify the envelope type for the interchange record
within the partner profile. This field allows a single partner profile to have multiple EDI
standards (e.g., X12, EDIFACT, TRADACOMS) defined under it. It eliminates the need
to create multiple partner profiles for a single trading partner in the event that the partner
Partner/Qualifier Mode Relationship Mode
Field Description Field Description
(Partner
Name
protected)
A 35-position
alphanumeric field
displaying the partner
name, if it exists on file
for the Partner ID.
(User Name -
protected)
A 35-position alphabetic
field displaying the user
name, if it exists on file for
the User/Partner ID.
Part ID
(protected)
A 35-position alphabetic
field used to select a
Partner ID for which you
are displaying, creating,
modifying, or deleting
records.
(Partner Name -
protected)
A 35-position alphabetic
field displaying the partner
name, if it exists on file for
the User/Partner ID.
Qual
(protected)
A 4-position
alphanumeric field used
to enter the Qualifier
associated with the
Partner ID, if applicable.
User/Partner
protected
Two 15-position alphabetic
fields that are used to select
a Partner Relationship for
which you are displaying,
creating, modifying, or
deleting records.
The Partner Subsystem Interchange Directory Screen EDIM027
2 - 30 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
uses more than one EDI standard. Valid values include these standards: ISA, ICS, BG,
GS, UNA, UNB, SCH, STX, and spaces.
Header Option (protected)
A 3-position alphabetic field identifying the type of interchange envelope. Valid values
include these standards: ISA, ICS, BG, GS, UNA, UNB, SCH, and STX.
Example: ISA = the segment ID for the interchange envelope header segment; GS = the
segment ID for group envelope header segment when an interchange envelope is not used.
Version (protected)
A 12-position field that displays the version associated with this header option, if it exists.
Control Information Screen 1 EDIM015 The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 31
Control Information Screen 1 EDIM015
Purpose
The Control Information – screen 1 enables you to specify control information, required for all
other file maintenance procedures and screens, for a trading partner. You can display, update, add,
or delete control information. After you add this record, Sterling Gentran creates default group and
transaction records.
Note: You can modify default group and transaction records
with customized data or you can use the system default
values.
How to Access
Access the Control Information screen (screen 1) in either of these two ways:
From the Interchange Directory, select the header option and press PF5.
•Type 1.2.2.1 in the Jump Code field of any screen and press Enter (this
functions only if the Partner ID has been established).
Screen Examples
The following examples illustrate the Control Information screen (screen – 1) for both Partner/
Qualifier and Relationship (user/partner) modes.
Partner/Qualifier Mode
EDIM015 1.2.2.1___ CONTROL INFORMATION XXX 06/01/2011
12:00:00
GENTRAN RESERVED PARTNER
Part ID:!!!GENTRAN-RESERVED-PARTNER-ID-1 Qual:
Multiple Envelope Id: ___ Version: ____________
Interchange Header Option....: ___ (ISA ICS BG GS UNA UNB SCH STX)
Last Incoming Sequence Number: ______________
EDI Databank Inbound.........: _ (D/N) Outbound.........: _ (F/D/N)
Expect a TA1, AC1, or UCI....: _ (Y/N) Network Tracking.: _ (Y/N)
Acknowledge Interchange......: _ (Y/N/E) Errors...........: _ (Y/N)
Last Incoming BG Password....: __________ Syntax Version...: _
Remote ID..(For PLUS)........: ________
Network ID.(For PLUS)........: _______________
Viewpoint - Exception........: _ (Y/N) Tracking.........: _ (Y/N)
Reconciliation Delay (days)..: ___
Enter PF1=Help PF3=Exit PF4=IDir PF5=Control PF6=Next Ctl
PF9=Add PF10=Updt PF11=Del PF14=Info
The Partner Subsystem Control Information Screen 1 EDIM015
2 - 32 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Relationship Mode
Function Key Descriptions
Note: Standard function keys, such as PF1=Help, PF3=Exit,
PF7=Bwd, PF8=Fwd, PF12=Cancel, and
PF15=Logoff, as well as the Enter key, are defined in
Chapter 1.
PF4=IDir Displays the Interchange Directory.
PF5=Control Displays the Control Information screen (screen 2), for the Partner ID and
interchange header option selected. For example, if the ISA interchange
header option is selected for the specified Partner ID, the Control Information
screen (screen 2 – ISA OPTIONS) screen is displayed.
PF6=Next Ctl Displays the next sequential control record.
PF9=Add Adds a control record for a new Partner ID being added to the partner profile.
Note: When you add a new Control record, Sterling Gentran
automatically adds default Group and Transaction
records, based on the !!!GENTRAN–RESERVED–
PARTNER– ID–1 (Partner/Qualifier mode)
OR
!!!GENTRAN-RU1/!!!GENTRAN-RP1
(Relationship mode)
PF10=Updt Updates the control record for an existing Partner ID.
EDIM015 1.2.2.1___ CONTROL INFORMATION XXX 06/01/2011
12:00:00
YOUR COMPANY NAME XYZ COMPUTER COMPANY
User...: YOUR COMPANY Partner: VENDOR-1
Multiple Envelope Id: ___ Version: ____________
Interchange Header Option....: ISA (ISA ICS BG GS UNA UNB SCH STX)
Last Incoming Sequence Number: ______________
EDI Databank Inbound.........: D (D/N) Outbound.........: F (F/D/N)
Expect a TA1, AC1, or UCI....: N (Y/N) Network Tracking.: Y (Y/N)
Acknowledge Interchange......: Y (Y/N/E) Errors...........: Y (Y/N)
Last Incoming BG Password....: __________ Syntax Version...: _
Remote ID..(For PLUS)........: TEST____
Network ID.(For PLUS)........: TEST___________
Viewpoint - Exception........: _ (Y/N) Tracking.........: _ (Y/N)
Reconciliation Delay (days)..: ___
Enter PF1=Help PF3=Exit PF4=IDir PF5=Control PF6=Next Ctl
PF9=Add PF10=Updt PF11=Del PF14=Info
Control Information Screen 1 EDIM015 The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 33
PF11=Del Deletes a control record and its subordinates (i.e., records with the same
Version/Multiple Envelope IDs) for an existing Partner ID for the indicated
header option.
PF14=Info Displays the date, time, and user initials, on the message line, that indicate
when the information on this screen was created or last changed.
Field Descriptions
Note: Fields that are display-only contain the statement
(protected) next to the field name in the documentation.
Fields in which you must enter a value contain the
statement (required) next to the field name in the
documentation.
Jump Code
A 10-position alphabetic or numeric field containing the jump code for this screen. A
screen’s jump code is displayed in the Jump Code field for that screen.
To jump to another screen, press Home, type the jump code of the screen to which you
want to jump, and then press Enter.
See Chapter 1, “Getting Started,” for further information on using jump codes.
Partner/Qualifier Mode Relationship Mode
Field Description Field Description
(Partner
Name
protected)
A 35-position
alphanumeric field used
to display the partner
name, as found on the
Name and Address
record. The partner name
can help to further
identify the Partner ID.
(User Name -
protected)
A 35-position alphabetic
field displaying the user
name, if it exists on file for
the User/Partner ID.
Part ID
(protected)
Displays the Partner ID
that you have entered or
selected.
Note: The Partner ID and
Qualifier make up the key
for all associated records.
(Partner Name -
protected)
A 35-position alphabetic
field displaying the partner
name, if it exists on file for
the User/Partner ID.
Qual
(protected)
Displays the Qualifier
associated with the
Partner ID, if applicable.
User/Partner
(protected)
Two 15-position alphabetic
fields that display the User/
Partner ID you have entered
or selected.
The Partner Subsystem Control Information Screen 1 EDIM015
2 - 34 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Multiple Envelope Id
A 3-position alphabetic field used to identify the envelope type for this interchange record
within the partner profile. This field allows a single partner profile to have multiple EDI
standards (e.g., X12, EDIFACT, TRADACOMS) defined under it. It eliminates the need
to create multiple partner profiles for a single trading partner in the event that the partner
uses more than one EDI standard. Valid values include these standards: ISA, ICS, BG,
GS, UNA, UNB, SCH, STX, and spaces.
Version
A 12-position alphanumeric field used when more than one control with the same header
option is needed. This is an optional field in the key and should only be used if multiple
controls with the same header option need to be defined. For example, if you currently run
ISAs with version 004010 and need to test 004020 with the trading partner, you would set
up another ISA control with the version being 004020.
Caution: Setting up partners using the version should only be used
when two like envelopes need to be generated with
different information.
Interchange Header Option (required)
A 3-position alphabetic field identifying the type of interchange envelope to be used for
outbound transactions. The envelope allows you to label an outbound transaction.
standards: ISA, ICS, BG, GS, UNA, UNB, SCH, STX. For example, ISA = the segment
ID for the interchange envelope header segment; GS = the segment ID for group envelope
header segment when an interchange envelope is not used.
Sterling Gentran:Structure Installed
Value: GEN = Generic
Last Incoming Sequence Number
A 14-position numeric field defining the control number of the last incoming interchange
received. If left as spaces, sequence checking for this interchange is not done.
Only applicable if used with the PARTNER SEQUENCE ERROR – INCREMENTAL or
PARTNER SEQUENCE ERROR – CHRONOLOGICAL global parameters.
EDI Databank Inbound
A 1-position alphabetic field that identifies the level of databank used. Valid values are:
D= Directory only
N=None
Only applicable if used with the PARTNER DATABANK LEVEL global parameter.
Outbound
A 1-position alphabetic field identifying the level of databank to be used. Valid values are:
F= Full (message store and directory)
D= Directory only
N=None
Only applicable if used with the PARTNER DATABANK LEVEL global parameter.
Control Information Screen 1 EDIM015 The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 35
Expect a TA1, AC1, or UCI
A 1-position alphanumeric field that indicates if interchange acknowledgments are
expected for outbound interchanges. A TA1 acknowledges an ISA interchange, an AC1
acknowledges an ICS interchange, and a UCI acknowledges a UNB interchange
(EDIFACT). Valid values are:
Y= Yes, expect TA1, AC1, or UCI acknowledgments.
Databank Acknowledgment Status is initially set to W(aiting).
N= No, do not expect a TA1, AC1, or UCI acknowledgments.
Databank Acknowledgment Status is initially set to N(ot required).
Network Tracking
A 1-position field indicating whether network tracking is done. Valid values are:
Y= Yes, network tracking is done.
N= No, network tracking is not done.
Acknowledge Interchange
A 1-position alphabetic field used to tell the system whether to create an acknowledgment
(that is, TA1 or AC1) for each inbound interchange. The default value is N (no, do not
create interchange acknowledgments). Valid values are:
Y= Yes, create interchange acknowledgment.
N= No, do not create interchange acknowledgment.
E= Create interchange acknowledgment based on incoming envelope.
Only applicable if used with the PARTNER ACKNOWLEDGMENT global parameter.
Errors
A 1-position alphabetic field used to designate whether you create segments identifying
errors in the received transactions (AK3/AK4, A1, USC, UCD). Valid values are:
Y= Yes, create segments to identify errors.
N= No, do not create segments to identify errors (default value).
Only applicable if used with the PARTNER ACKNOWLEDGMENT global parameter.
Note: If errors occur and this field is set to Y, acknowledgments
are generated (even if acknowledgment generation is
turned off at the group and transaction levels).
Last Incoming BG Password
A 10-position alphanumeric field defining the valid password for an incoming BG
segment (interchange header record).
Only applicable if used with the BG PARTNER YES global parameter.
Syntax Version
A 1-position numeric field used to define the Syntax Rules version number of the ISO
9735 to be used. This is only valid for the UNA/UNB header option.
The Partner Subsystem Control Information Screen 1 EDIM015
2 - 36 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Remote ID (For PLUS) (For Sterling Gentran:Plus Only)
An 8-position alphanumeric field that is used to link the partner profile to the remote
identifier, if applicable.
Network ID (For PLUS) (For Sterling Gentran:Plus Only)
A 15-position alphanumeric field that is used to link the partner profile to the network
identifier, if applicable.
Sterling Gentran:Viewpoint Installed
Viewpoint – Exception
A 1-position field indicating whether Sterling Gentran:Viewpoint Exception Management
activity is performed at the interchange level for this partner. Valid values are:
Y= Yes, Exception Management is performed.
N= No, Exception Management is not performed.
blank= Defaults to the value Y and the Exception Management processing is
controlled by the Configuration File Exception Management Partner
Default Indicator.
Viewpoint – Tracking
A 1-position field indicating whether Sterling Gentran:Viewpoint Tracking Management
activity is performed at the interchange level for this trading partner. Valid values are:
Y= Yes, Tracking Management is performed.
N= No, Tracking Management is not performed.
blank= Defaults to the value Y and the Tracking Management processing is
controlled by the Configuration Field Tracking Management Partner
default indicator.
See the topic “Defining and Initializing Files” in the IBM® Sterling Gentran:Viewpoint®
for z/OS® Release 6.6 Installation Guide. The installation default is Exception
Management is performed.
Control Information Screen 2—ISA Options EDIM016 The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 37
Control Information Screen 2ISA Options EDIM016
Purpose
The Control Information (screen 2) is used for creating outbound envelopes. If you are not sending
documents to your trading partner, you can skip this screen. If you plan to send outbound
documents, you must complete this screen.
For each interchange segment type identified on screen 1, another screen (screen 2) exists that
identifies the information needed to generate that interchange segment. From screen 2, you can
display or change any of the fields shown for this outbound interchange envelope.
How to Access
Access this screen from the Control Information screen (screen 1) by pressing PF5.
Screen Examples
The following examples illustrate the Control Information screen (screen – 2, ISA Options), for
both Partner/Qualifier and Relationship (user/partner) modes.
Partner/Qualifier Mode
EDIM016 __________ CONTROL INFORMATION XXX 06/01/2011
12:00:00
EXAMPLE OF AN ISA PARTNER
Part ID: ISG DOMESTIC PARTNER ISSUE M10840 Qual:
Multiple Envelope Id: ISA Version:
Outbound envelope information for ISA segment:
Authorization Qual....ISA01: 00 Authorization.ISA02: __________
Security Code Qual....ISA03: 00 Security Code.ISA04: __________
Sender ID Qual........ISA05: ZZ Sender ID.....ISA06: YOUR_COMPANY___
Receiver ID Qual......ISA07: ZZ Receiver ID...ISA08: TRADING_PARTNER
Repeat Sep / Stds ID..ISA11: ? or Hex 6F
Version...............ISA12: 00200 Use................: I (A/I/D)
Control Number........ISA13: 000000000 Ack Requested.ISA14: 0 (1=Yes,0=No)
Test or Production....ISA15: P (T/P)
Subelement Separator..ISA16: > or Hex 5C
Element Separator..........: * or Hex 5C
Segment Terminator.........: _ or Hex 15
Enter PF1=Help PF3=Exit PF4=Control PF5=GDir
PF10=Updt PF14=Info
The Partner Subsystem Control Information Screen 2—ISA Options EDIM016
2 - 38 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Relationship Mode
Function Key Descriptions
Note: Standard function keys, such as PF1=Help, PF3=Exit,
PF7=Bwd, PF8=Fwd, PF12=Cancel, and
PF15=Logoff, as well as the Enter key, are defined in
Chapter 1.
To delete the specified trading partner's ISA parameters, you must first return to the Control
Information screen (screen 1) by pressing the PF4 key.
PF4=Control Displays the first Control Information screen for the Partner ID selected.
PF5=GDir Displays the Group Directory for the Partner ID currently displayed.
PF10=Updt Updates the ISA parameters for an existing Partner ID.
PF14=Info Displays the date, time, and user initials on the message line that reflects
when the information on this screen was created or last changed.
Field Descriptions
Note: Fields that are display-only contain the statement
(protected) next to the field name in the documentation.
Fields in which you must enter a value contain the
statement (required) next to the field name in the
documentation.
EDIM016 __________ CONTROL INFORMATION XXX 06/01/2011
12:00:00
User...: YOUR COMPANY Partner: VENDOR-1
Multiple Envelope Id: Version:
Outbound envelope information for ISA segment:
Authorization Qual....ISA01: __ Authorization.ISA02: __________
Security Code Qual....ISA03: __ Security Code.ISA04: __________
Sender ID Qual........ISA05: __ Sender ID.....ISA06: _______________
Receiver ID Qual......ISA07: __ Receiver ID...ISA08: _______________
Repeat Sep / Stds ID..ISA11: _ or Hex __
Version...............ISA12: _____ Use................: _ (A/I/D)
Control Number........ISA13: _________ Ack Requested.ISA14: _ (1=Yes,0=No)
Test or Production....ISA15: _ (T/P)
Subelement Separator..ISA16: _ or Hex __
Element Separator..........: _ or Hex __
Segment Terminator.........: _ or Hex __
Enter PF1=Help PF3=Exit PF4=Control PF5=GDir
PF10=Updt PF14=Info
Control Information Screen 2—ISA Options EDIM016 The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 39
Jump Code
A 10-position alphabetic or numeric field containing the jump code for this screen. A
screen’s jump code is displayed in the Jump Code field for that screen.
To jump to another screen, press Home, type the jump code of the screen to which you
want to jump, and then press Enter.
See Chapter 1, “Getting Started,” for further information on using jump codes.
Multiple Envelope Id
A 3-position alphabetic field used to identify the envelope type for this interchange record
within the partner profile. This field allows a single partner profile to have multiple EDI
standards (e.g., X12, EDIFACT, TRADACOMS) defined under it. It eliminates the need
to create multiple partner profiles for a single trading partner in the event that the partner
uses more than one EDI standard. Valid values include these standards: ISA, ICS, BG,
GS, UNA, UNB, SCH, STX, and spaces.
Version
A 12-position alphanumeric field used when more than one control with the same header
option is needed. This is an optional field in the key and should only be used if multiple
controls with the same header option need to be defined.
Authorization Qual
A 2-position alphanumeric field used to define the Qualifier associated with the
authorization code your trading partner has assigned to you.
Partner/Qualifier Mode Relationship Mode
Field Description Field Description
(Partner
Name
protected)
A 35-position
alphanumeric field used
to display the partner
name, as found on the
Name and Address
record. The partner name
can help to further
identify the Partner ID.
(User Name -
protected)
A 35-position alphabetic
field displaying the user
name, if it exists on file for
the User/Partner ID.
Part ID
(protected)
Displays the Partner ID
that you have entered or
selected.
Note: The Partner ID and
Qualifier make up the key
for all associated records.
(Partner Name -
protected)
A 35-position alphabetic
field displaying the partner
name, if it exists on file for
the User/Partner ID.
Qual
(protected)
Displays the Qualifier
associated with the
Partner ID, if applicable.
User/Partner
(protected)
Two 15-position alphabetic
fields that display the User/
Partner ID you have entered
or selected.
The Partner Subsystem Control Information Screen 2—ISA Options EDIM016
2 - 40 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Authorization
A 10-position numeric field used to define the authorization code your trading partner has
assigned to you. If you are not sending an authorization code, type 00 for the Qualifier.
Security Code Qual
A 2-position alphanumeric field used to define the Qualifier associated with the security
code your trading partner has assigned to you.
Security Code
A 10-position numeric field used to define the security code your trading partner has
assigned to you. If you are not sending a security code, type 00 for the Qualifier.
Sender ID Qual
A 2-position alphanumeric field used to define the Qualifier for your Sender ID as it is
displayed on the interchange header segment sent to this trading partner.
Sender ID
A 15-position alphanumeric field used to define your interchange identifier.
Note: This field supports the underscore substitution character
(USC). To use a USC, the substitution character must
exist on the defined partner header record.
See the topic “Using Underscore Substitution
Characters” in Chapter 7 for more information about this
feature.
Receiver ID Qual
A 2-position alphanumeric field used to define the Qualifier for the trading partner as it is
displayed on the interchange header segment.
Receiver ID
A 15-position alphanumeric field used to define the trading partner’s interchange ID.
Note: This field supports the underscore substitution character
(USC). To use a USC, the substitution character must
exist on the defined partner header record.
See the topic “Using Underscore Substitution
Characters” in Chapter 7 for more information about this
feature.
Control Information Screen 2—ISA Options EDIM016 The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 41
Repeat Sep / Stds ID
A 1-position field that contains either the repetition separator or the Interchange Control
Standards ID Code. As of ASC X-12 version 004030, the ISA 11 contains the repetition
separator that is to be used for repeating data elements. Sterling Gentran will check the
ISA 12 Interchange Version to determine the correct value for this field. If ISA 12 is less
than 00403, valid values are:
U= United States of America
X= ANSI Accredited Standards Committee X12
If ISA 12 is 00403 or greater, select any non-alphabetic, non-numeric character not
contained in the EDI data.
Version
A 5-position numeric field defining the version of the EDI standards used to process
interchange control envelopes sent to or received from this trading partner.
Use
A 1-position alphabetic field used to tell the system when to use the Version previously
defined. Valid values are:
A = Always use the version designated.
I = Use the version designated in the input.
D = Use this version as a default if the input’s identified version cannot be
located in the standards table.
blank = Defaults to the value I, use the version designated in the input.
Only applicable if used with the PARTNER VERSION global parameter.
Control Number
A 9-position numeric field used to designate the beginning control sequence number for
generating outbound interchange envelopes. The system assigns control numbers
sequentially, adding 1 (one) to the number you type in this field. If you type a zero (0), the
system assigns 1 (one) as the beginning control number for your first interchange. Control
Number is also termed Envelope Reference ID.
Ack Requested
A 1-position numeric field used to set the Acknowledgment Requested field on an
outbound ISA. Valid values are:
1= Yes, interchange acknowledgment requested.
0= No, interchange acknowledgment not requested.
Test or Production
A 1-position alphabetic field used to indicate whether data is test or production. Valid
values are:
T=Test data.
P= Production data.
The Partner Subsystem Control Information Screen 2—ISA Options EDIM016
2 - 42 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Subelement Separator
Either a 1-position alphanumeric field, OR a 2-position hexadecimal field used to define
the value that separates portions of an outbound element.
In the first field, type the special character, and the system enters the hexadecimal value
for that character in the second field.
OR
In the second field, type the two-character hexadecimal value, and the system enters the
special character for that hexadecimal value. If no printable characters exist that
correspond to the hexadecimal value, the character field is blank.
Note: The Subelement Separator and Element Separator fields
must have different values.
Element Separator
Either a 1-position alphanumeric field, OR a 2-position hexadecimal field, used to define
the value that separates elements in an outbound data segment.
In the first field, type the special character, such as * and ^, and the system converts and
enters the hexadecimal value for that character in the second field.
OR
In the second field, type the two-character hexadecimal value, and the system converts and
enters the special character for that hexadecimal value. If no printable characters exist that
correspond to the hexadecimal value, the character field is blank.
Note: The Subelement Separator and Element Separator fields
must have different values.
Segment Terminator
Either a 1-position alphanumeric field, OR a 2-position hexadecimal field used to define
the value identifying the end of an outbound data segment.
In the first field, type the special character, and the system enters the hexadecimal value
for that special character in the second field.
OR
In the second field, type the two character hexadecimal value, and the system enters the
special character for that hexadecimal value. If no printable characters exist that
correspond to the hexadecimal value, the character field is blank.
Control Information Screen 2—ICS Options EDIM018 The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 43
Control Information Screen 2ICS Options EDIM018
Purpose
This Control Information (screen 2) is used for creating outbound envelopes. If you are not
sending documents to your trading partner, you can skip this screen. If you plan to send outbound
documents, you must complete this screen.
For each interchange identified on screen 1, a separate screen (screen 2) exists that identifies the
information needed to generate that interchange segment. From screen 2, you can display or
change any of the fields shown for this outbound interchange envelope.
How to Access
Access this screen by pressing PF5 on the Control Information screen (screen 1).
Screen Examples
The following examples illustrate the Control Information screen (screen – 2, ICS Options), for
both Partner/Qualifier and Relationship (user/partner) modes.
Partner/Qualifier Mode
EDIM018 __________ CONTROL INFORMATION XXX 06/01/2011
12:00:00
EXAMPLE OF AN ICS PARTNER
Part ID: ICS-PARTNER Qual:
Multiple Envelope Id: ICS Version:
Outbound envelope information for ICS segment:
Element Separator.............ICS01: * or Hex 5C
Subelement Separator..........ICS02: : or Hex 7A
Control Standards Identifier..ICS03: _ or ____
Version.......................ICS04: 00200
Version Use........................: A (A/I/D)
Sender ID Qualifier...........ICS05: 01
Sender ID.....................ICS06: YOUR-ID________
Receiver ID Qualifier.........ICS07: 01
Receiver ID...................ICS08: TRADING-PARTNER
Control Number................ICS11: 000000001
Segment Terminator............ICS12: _ or Hex 15
Enter PF1=Help PF3=Exit PF4=Control PF5=GDir
PF10=Updt PF14=Info
The Partner Subsystem Control Information Screen 2—ICS Options EDIM018
2 - 44 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Relationship Mode
Function Key Descriptions
Note: Standard function keys, such as PF1=Help, PF3=Exit,
PF7=Bwd, PF8=Fwd, PF12=Cancel, and
PF15=Logoff, as well as the Enter key, are defined in
Chapter 1.
To delete ICS parameters for the trading partner, you must first return to the Control Information
screen (screen 1) by pressing the PF4 key.
PF4=Control Displays the Control Information screen for the Partner ID selected.
PF5=GDir Displays the Group Directory for the Partner ID currently displayed.
PF10=Updt Updates the ICS parameters for an existing Partner ID.
PF14=Info Displays the date, time, and user initials on the message line that reflects
when the information on this screen was created or last changed.
Field Descriptions
Note: Fields that are display-only contain the statement
(protected) next to the field name in the documentation.
Fields in which you must enter a value contain the
statement (required) next to the field name in the
documentation.
EDIM018 __________ CONTROL INFORMATION 06/01/2011
12:00:00
YOUR COMPANY NAME XYZ COMPUTER COMPANY
User...: YOUR COMPANY Partner: VENDOR-1
Multiple Envelope Id: ICS Version:
Outbound envelope information for ICS segment:
Element Separator.............ICS01: * or Hex 5C
Subelement Separator..........ICS02: : or Hex 7A
Control Standards Identifier..ICS03: _ or AIAG
Version.......................ICS04: 00200
Version Use........................: A (A/I/D)
Sender ID Qualifier...........ICS05: 01
Sender ID.....................ICS06: YOUR-ID________
Receiver ID Qualifier.........ICS07: 01
Receiver ID...................ICS08: TRADING-PARTNER
Control Number................ICS11: 000000001
Segment Terminator............ICS12: _ or Hex 15
Enter PF1=Help PF3=Exit PF4=Control PF5=GDir
PF10=Updt PF14=Info
Control Information Screen 2—ICS Options EDIM018 The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 45
Jump Code
A 10-position alphabetic or numeric field containing the jump code for this screen. A
screen’s jump code is displayed in the Jump Code field for that screen.
To jump to another screen, press Home, type the jump code of the screen to which you
want to jump, and then press Enter.
See Chapter 1, “Getting Started,” for further information on using jump codes.
Multiple Envelope Id (protected)
A 3-position alphabetic field used to identify the envelope type for this interchange record
within the partner profile. This field allows a single partner profile to have multiple EDI
standards (e.g., X12, EDIFACT, TRADACOMS) defined under it. It eliminates the need
to create multiple partner profiles for a single trading partner in the event that the partner
uses more than one EDI standard. Valid values include these standards: ISA, ICS, BG,
GS, UNA, UNB, SCH, STX, and spaces.
Version
A 12-position alphanumeric field used when more than one control with the same header
option is needed. This is an optional field in the key and should only be used if multiple
controls with the same header option need to be defined.
Partner/Qualifier Mode Relationship Mode
Field Description Field Description
(Partner
Name
protected)
A 35-position
alphanumeric field used
to display the partner
name, as found on the
Name and Address
record. The partner name
can help to further
identify the Partner ID.
(User Name -
protected)
A 35-position alphabetic
field displaying the user
name, if it exists on file for
the User/Partner ID.
Part ID
(protected)
Displays the Partner ID
you have entered or
selected.
Note: The Partner ID and
Qualifier make up the key
for all associated records.
(Partner Name -
protected)
A 35-position alphabetic
field displaying the partner
name, if it exists on file for
the User/Partner ID.
Qual
(protected)
Displays the Qualifier
associated with the
Partner ID, if applicable.
User/Partner
(protected)
Two 15-position alphabetic
fields that display the User/
Partner ID you have entered
or selected.
The Partner Subsystem Control Information Screen 2—ICS Options EDIM018
2 - 46 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Element Separator
Either a 1-position alphanumeric field, OR a 2-position hexadecimal field, used to define
the value that is used to separate elements in an outbound segment.
In the first field, type the special character, and the system converts and enters the
hexadecimal value for that character in the second field.
OR
In the second field, type the two-character hexadecimal value, and the system converts and
enters the special character for that hexadecimal value. If no printable characters exist that
correspond to the hexadecimal value, the character field is blank.
Note: The Subelement Separator and Element Separator fields
must have different values.
Subelement Separator
Either a 1-position alphanumeric field, OR a 2-position hexadecimal field used to define
the value used to separate portions of an outbound element.
In the first field, type the special character, and the system enters the hexadecimal value
for that special character in the second field.
OR
In the second field, type the two-character hexadecimal value, and the system enters the
special character for that hexadecimal value. If no printable characters exist that
correspond to the hexadecimal value, the character field is blank.
Note: The Subelement Separator and Element Separator fields
must have different values.
Control Standards Identifier
A 1-position or 4-position alphabetic field (long or short) used to define the organization
responsible for the EDI standard used in the interchange. Valid values are:
U= USA EDI community
X=ASC X12
E=EDIFACT
Version
A 5-position numeric field that is used to define the version of the EDI standards used to
process control envelopes sent to or received from this trading partner.
Control Information Screen 2—ICS Options EDIM018 The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 47
Version Us e
A 1-position alphabetic field used to tell the system when to use the version previously
defined. Valid values are:
A= Always use the version designated.
I= Use the version designated in the input.
D= Use this version as a default if the identified version in the input
cannot be located in the standards table.
blank= Defaults to the value I, use the version designated in the input.
Only applicable if used with the PARTNER VERSION global parameter.
Sender ID Qualifier
A 2-position alphanumeric field used to define the Qualifier for your Sender ID as it is
displayed on the interchange header segment sent to this trading partner.
Sender ID
A 15-position alphanumeric field used to define your interchange identifier.
Receiver ID Qualifier
A 2-position alphanumeric field used to define the Qualifier for the trading partner as it is
displayed on the interchange header segment.
Receiver ID
A 15-position alphanumeric field used to define the trading partner’s interchange ID.
Control Number
A 9-position numeric field used to designate the beginning control sequence number for
generating outbound interchange envelopes. The system assigns control numbers
sequentially, adding 1 (one) to the number you type in this field. If you type a zero (0), the
system assigns 1 (one) as the beginning control number for your first interchange.
Segment Terminator
Either a 1-position alphanumeric field, OR a 2-position hexadecimal field used to define
the value used to identify the end of an outbound segment.
In the first field, type the special character, and the system enters the hexadecimal value
for that special character in the second field.
OR
In the second field, type the two-character hexadecimal value, and the system enters the
special character for that hexadecimal value. If no printable characters exist that
correspond to the hexadecimal value, the character field is blank.
The Partner Subsystem Control Information Screen 2—GS and BG Options EDIM017
2 - 48 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Control Information Screen 2GS and BG Options EDIM017
Purpose
This Control Information (screen 2) is used for creating outbound envelopes. If you are not
sending documents to your trading partner, you can skip this screen. If you plan to send outbound
documents, you must complete this screen.
For each interchange identified on screen 1, a separate screen (screen 2) exists that identifies the
information needed to generate that interchange segment. From screen 2, you can display or
change any of the fields shown for this outbound interchange envelope.
How to Access
Access this screen by pressing PF5 on the Control Information screen (screen 1).
Screen Examples
The following examples illustrate the Control Information screen (screen – 2, GS and BG
Options), for both Partner/Qualifier and Relationship (user/partner) modes.
Partner/Qualifier Mode
EDIM017 __________ CONTROL INFORMATION XXX 06/01/2011
12:00:00
EXAMPLE OF A BG PARTNER
Part ID: BG-PARNTER Qual:
Multiple Envelope Id: BG Version:
Outbound envelope information for GS and BG segments:
Element Separator................: * or Hex 5C
Segment Terminator...............: ' or Hex 7D
Outbound envelope information for BG segment:
Communication ID.............BG01: YOUR-ID___
Communication Password.......BG02: TP-PASSWD_
Application Sender Code......BG03: 6147937900__
Application Receiver Code....BG04: 6147937155__
Control Number...............BG07: 00017
Enter PF1=Help PF3=Exit PF4=Control PF5=GDir
PF10=Updt PF14=Info
Control Information Screen 2—GS and BG Options EDIM017 The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 49
Relationship Mode
Function Key Descriptions
Note: Standard function keys, such as PF1=Help, PF3=Exit,
PF7=Bwd, PF8=Fwd, PF12=Cancel, and
PF15=Logoff, as well as the Enter key, are defined in
Chapter 1.
To delete the GS or BG parameters for a trading partner, you must first return to the Control
Information screen (screen 1) by pressing the PF4 key.
PF4=Control Displays the previous Control Information screen (screen 1) for the Partner ID
selected.
PF5=GDir Displays the Group Directory for the Partner ID currently displayed.
PF10=Updt Updates either the GS or BG parameters for an existing Partner ID.
PF14=Info Displays the date, time, and user initials on the message line that reflects
when the information on this screen was created or last changed.
Field Descriptions
Note: Fields that are display-only contain the statement
(protected) next to the field name in the documentation.
Fields in which you must enter a value contain the
statement (required) next to the field name in the
documentation.
EDIM017 __________ CONTROL INFORMATION 06/01/2011
12:00:00
YOUR COMPANY NAME XYZ COMPUTER COMPANY
User...: YOUR COMPANY Partner: VENDOR-1
Multiple Envelope Id: BG Version:
Outbound envelope information for GS and BG segments:
Element Separator................: * or Hex 5C
Segment Terminator...............: ' or Hex 7D
Outbound envelope information for BG segment:
Communication ID.............BG01: YOUR-ID___
Communication Password.......BG02: TP-PASSWD_
Application Sender Code......BG03: 6147937900__
Application Receiver Code....BG04: 6147937155__
Control Number...............BG07: 00017
Enter PF1=Help PF3=Exit PF4=Control PF5=GDir
PF10=Updt PF14=Info
The Partner Subsystem Control Information Screen 2—GS and BG Options EDIM017
2 - 50 IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide
Jump Code
A 10-position alphabetic or numeric field containing the jump code for this screen. A
screen’s jump code is displayed in the Jump Code field for that screen.
To jump to another screen, press Home, type the jump code of the screen to which you
want to jump, and then press Enter.
See Chapter 1, “Getting Started,” for further information on using jump codes.
Multiple Envelope Id (protected)
A 3-position alphabetic field used to identify the envelope type for this interchange record
within the partner profile. This field allows a single partner profile to have multiple EDI
standards (e.g., X12, EDIFACT, TRADACOMS) defined under it. It eliminates the need
to create multiple partner profiles for a single trading partner in the event that the partner
uses more than one EDI standard. Valid values include these standards: ISA, ICS, BG,
GS, UNA, UNB, SCH, STX, and spaces.
Version
A 12-position alphanumeric field used when more than one control with the same header
option is needed. This is an optional field in the key and should only be used if multiple
controls with the same header option need to be defined.
Partner/Qualifier Mode Relationship Mode
Field Description Field Description
(Partner
Name
protected)
A 35-position
alphanumeric field used
to display the partner
name, as found on the
Name and Address
record. The partner name
can help to further
identify the Partner ID.
(User Name -
protected)
A 35-position alphabetic
field displaying the user
name, if it exists on file for
the User/Partner ID.
Part ID
(protected)
Displays the Partner ID
you have entered or
selected.
Note: The Partner ID and
Qualifier make up the key
for all associated records.
(Partner Name -
protected)
A 35-position alphabetic
field displaying the partner
name, if it exists on file for
the User/Partner ID.
Qual
(protected)
Displays the Qualifier
associated with the
Partner ID, if applicable.
User/Partner
(protected)
Two 15-position alphabetic
fields that display the User/
Partner ID you have entered
or selected.
Control Information Screen 2—GS and BG Options EDIM017 The Partner Subsystem
IBM Sterling Gentran:Basic for z/OS Release 6.6 User Guide 2 - 51
Element Separator
Either a 1-position alphanumeric field, OR a 2-position hexadecimal field, used to define
the value that is used to separate elements in an outbound data segment.
In the first field, type the special character, and the system converts and enters the
hexadecimal value for that character.
OR
In the second field, type the hexadecimal value, and the system converts and enters the
special character for that hexadecimal value. If no printable characters exist that
correspond to the hexadecimal value, the character field is blank.
Segment Terminator
Either a 1-position alphanumeric field, OR a 2-position hexadecimal field used to define
the value used to identify the end of an outbound data segment.
In the first field, type the special character, and the system enters the hexadecimal value
for that special character.
OR
In the second field, type the hexadecimal value, and the system enters the special character
for that hexadecimal value. If no printable characters exist that correspond to the
hexadecimal value