Gentran:P1us® for zSeries
`
`User’s Guide
`
`Release 6.5
`
`Stenfing Con'amer'::<-2
`
`Sterling Commerce (Mid America), Inc.
`4600 Lakehurst Court Dublin, OH 43016-2000 * 614/793-4000
`© Copyright 1988 — 2009/Sterling Commerce, Inc‘
`
`22 I (»—(150—LlSI£R0 I -0000
`
`

`

`July 2009
`
`Gentran:P|us for zSeries
`
`© Copyright 1988 — 2009
`Sterling Commerce, Inc.
`ALL RIGHTS RESERVED
`
`Sterling Commerce Software
`Trade Secret Notice
`
`THE GENTRAN:PLUS AND GENTRAN:BASIC FOR ZSERIES SOFTWARE (“STERLING
`COMMERCE SOFTWARE”) IS THE CONFIDENTIAL AND TRADE SECRET PROPERTY OF
`STERLING COMMERCE, INC., ITS AFFILIATED COMPANIES OR ITS OR THEIR
`LICENSORS, AND IS PROVIDED UNDER THE TERMS OF A LICENSE AGREEMENT. NO
`DUPLICATION OR DISCLOSURE WITHOUT PRIOR WRITTEN PERMISSION.
`RESTRICTED RIGHTS.
`
`This documentation, the Sterting Commerce Software it describes, and the information and know—how they contain
`constitute the proprietary, confidential and valuable trade secret information of Sterling Commerce, |nc., its affiliated
`companies or its or their licensors, and may not be used for any unauthorized purpose, or disclosed to others without
`the prior written permission of the applicable Sterling Commerce entity. This documentation and the Sterling
`Commerce Software that it describes have been provided pursuant to a license agreement that contains prohibitions
`against and/or restrictions on their copying, modification and use. Duplication, in whole or in part, if and when
`permitted, shall bear this notice and the Sterling Commerce, Inc. copyright notice.
`As and when provided to any governmental entity, government contractor or subcontractor subject to the FARs, this
`documentation is provided with RESTRICTED RIGHTS under 1'It|e 48 CFR 52.227-19. Further, as and when provided
`to any governmental entity, government contractor or subcontractor subject to DFARS, this documentation and the
`Sterling Commerce Software it describes are provided pursuant to the customary Sterling Commerce license, as
`described in 'I'ItIe 48 CFR 227-7202 with respect to commercial software and commercial software documentation.
`
`These terms of use shall be governed by the laws of the State of Ohio, USA. without regard to its conflict of laws
`provisions. If you are accessing the Sterling Commerce Software under an executed agreement, then nothing in these
`terms and conditions supersedes or modifies the executed agreement.
`
`Product names mentioned herein may be trademarks and/or registered trademarks of their respective companies.
`Gentran, Gentran:Basic, Gentran:Control, Gentran:P|us, Gentran:Realtime, Gentran:Structure, and Gentranzviewpoint
`are registered trademarks of Sterling Commerce, Inc.
`
`Third Part
`
`oftware:
`
`Portions of the Sterling Commerce Software may include products, or may be distributed on the same storage media
`with products, (“Third Party Software") offered by third parties ("Third Party Licensors").
`
`Warrany Disclaimer
`
`This documentation and the Sterling Commerce Software which it describes are licensed either "AS IS" or with a
`limited warranty, as set forth in the Sterling Commerce license agreement. Other than any limited warranties provided,
`NO OTHER WARRANTY IS EXPRESSED AND NONE SHALL BE IMPLIED, INCLUDING THE WARRANTIES OF
`MERCHANTABILITY AND FITNESS FOR USE OR FOR A PARTICULAR PURPOSE. The applicable Sterling
`Commerce entity reserves the right to revise this publication from time to time and to make changes in the content
`hereof without the obligation to notify any person or entity of such revisions or changes.
`
`The Third Party Software is provided 'AS IS‘ WITHOUT ANY WARRANTY AND ANY EXPRESSED OR IMPLIED
`WARRANTIES, INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, AND
`FITNESS FORA PARTICULAR PURPOSE ARE DISCLAIMED. FURTHER, IF YOU ARE LOCATED OR ACCESSING
`THIS SOFTWARE IN THE UNITED STATES, ANY EXPRESS OR IMPLIED WARRANTY REGARDING TITLE OR
`NON-INFRINGEMENT ARE DISCLAIMED.
`
`

`

`Table of Contents
`
`Chapter 1
`
`Getting Started
`Features and Benefits ............................................................................................. .. 1-2
`
`System Overview.................................................................................................... .. 1-2
`Function Keys ......................................................................................................... .. 1- 1 7
`Common Keyboard Conventions ........................................................................... .. 1-18
`
`Chapter 2
`
`Communications Tutorial
`
`Overview ................................................................................................................ .. 2-1
`
`Logging on to Gentran............................................................................................ .. 2-3
`Setting Up Communication .................................................................................... .. 2-4
`Holiday Processing Schedule ................................................................................. .. 2-6
`Communication Profile .......................................................................................... .. 2-8
`BISYNC Screens .................................................................................................... .. 2-10
`SNA Screens ........................................................................................................... .. 2-21
`FTP Client Screens ................................................................................................. .. 2-33
`FTP Server Screens ................................................................................................ .. 2-43
`
`Communication Directory ...................................................................................... .. 2-58
`Queue Management ................................................................................................ .. 2-60
`Online Communication Utility Submission ........................................................... .. 2-64
`
`Screens
`
`Overview ................................................................................................................ .. 3-1
`
`Jump Codes ............................................................................................................ .. 3-3
`Communications Security Screen.............................. .. EDIM40V ........................ .. 3-7
`Plus Main Menu ........................................................ .. EDIM400 ....................... .. 3-10
`
`Communications Session Maintenance Selection MenuEDIM40A..................... .. 3-13
`
`Communications Maintenance Utility Menu ............ .. EDIM40B ....................... .. 3-15
`Communications Maintenance History Log Menu
`EDIM40C ....................... .. 3-17
`Interchange Status Screen (for Connect:Enterprise)
`EDIM40E ....................... .. 3-19
`
`Interchange Status Screen (for Connect:Mailbox) .... .. EDlM40M ...................... .. 3-26
`Interchange Detail Screen.......................................... .. EDIM402 ....................... .. 3-34
`Interchange Line Detail Screen ................................. .. EDIM403 ....................... .. 3-38
`Communication Directory Screen ............................. .. EDIM404 ....................... .. 3-42
`Control File Change Audit Screen ............................ .. EDIM405 ....................... .. 3-46
`Communication Profile Screen.................................. .. EDIM406 ....................... .. 3-49
`BISYNC Communications Profile Screen ................ .. EDIM407 ....................... .. 3-55
`
`SNA Communication Profile Screen......................... .. EDIM408 ....................... .. 3-62
`
`Gentran:Plus for zSeries Release 6.5 User’s Guide
`
`

`

`Table of Contents
`
`SNA Communication Profile Remote
`Maintenance Screen.................................................. .. EDIM409 ....................... .. 3-67
`
`Transmission Schedule Screen .................................. .. EDIM410 ....................... .. 3-74
`
`Auto Connect History Screen .................................... .. EDIM411 ....................... .. 3-77
`Remote Connect History Screen ............................... .. EDIM412 ....................... .. 3-82
`Status Maintenance Screen ........................................ .. EDIM413 ....................... .. 3-86
`BISYNC Line Maintenance Screen........................... .. EDIM414 ....................... .. 3-89
`
`Holiday Processing Schedule Screen ........................ .. EDIM415 ....................... .. 3-93
`Communications List Report Screen ......................... .. EDIM416 ....................... .. 3-96
`Communications Log Report Screen......................... .. EDIM417 ....................... .. 3-99
`Auto Connect History User Log Message Screen ..... .. EDIM418 ..................... .. 3-104
`ID List Maintenance Screen ...................................... .. EDIM419 ..................... .. 3-107
`
`FTP Client Communication Profile Screen ............... .. EDIM420 ..................... .. 3-110
`FTP Client Communication Ports Screen.................. .. ED1M421 ..................... .. 3-118
`
`FTP Server Communication Profile Screen .............. .. EDIM422 ..................... .. 3-121
`
`FTP Server Communication Profile Remote
`Maintenance Screen—Part 1 ..................................... .. EDIM423 ..................... .. 3-125
`FTP Server Communication Ports Screen ................. .. EDIM424 ..................... .. 3-131
`
`FTP Server Communication Profile Remote
`Maintenance Screen—Part 2 ..................................... .. EDIM425 ..................... .. 3-135
`FTP Client Communication Profile Part 2 Screen .... .. EDIM426 ..................... .. 3-140
`Network Command Interface Selection Menu .......... .. EDIM450 ..................... .. 3-145
`
`Network Command Directory Screen ....................... .. EDIM451 ..................... .. 3-147
`Network Command Definition Screen ...................... .. EDIM452 ..................... .. 3-150
`Network Command Maintenance Screen .................. .. EDIM453 ..................... .. 3-154
`
`Chapter 4
`
`Program Descriptions
`Overview ................................................................................................................ .. 4-1
`
`Options Definition File Creation Program ................ .. EBDI020 .......................... ., 4-3
`Outbound Acknowledgment Program ....................... .. EBD1021 .......................... .. 4-9
`Databank Batch Number Update Program ................ .. EBDI081 ........................ .. 4-1 1
`Connect Report Processor Program........................... .. EBDIMBX ..................... .. 4-12
`INS TRADANET Reblocker Program ...................... .. EBDI057 ........................ .. 4-14
`
`INS TRADANET Command Generator Program..... .. EBDI058 ........................ .. 4-16
`INS Network Report Tracker Program...................... .. EBDI059 ........................ .. 4-18
`INS Network Command Purge Program ................... .. EBDI066 ........................ .. 4-20
`Extract Utility ............................................................ .. STOUTL ........................ .. 4-21
`Add Utility ................................................................. .. STOUTL ........................ .. 4-22
`File Maintenance Processing Program ...................... .. STOUTL ........................ .. 4-24
`
`Gentran:Plus for zSeries Release 6.5 User’s Guide
`
`

`

`Table of Contents
`
`Chapter 5
`
`File Descriptions
`
`Internal Reader JCL File - LIST Utility .................... .. COMLST ......................... .. 5-2
`Communications Profile File ..................................... .. COMPRF ......................... .. 5-3
`
`Internal Reader JCL File - REPORT Utility ............. .. COMRPT ......................... .. 5-5
`
`Internal Reader JCL File - STATFLG Utility ........... .. COMSTAT ...................... .. 5-6
`HOLIDAY File .......................................................... .. HOLIDAY ....................... .. S-7
`Network Command Detail File ................................. .. NETDTL .......................... .. 5-8
`Network Command Header File ................................ .. NETHDR ......................... .. 5-9
`
`REMOTE File ........................................................... .. REMOTE ....................... .. 5-10
`
`Change Audit File...................................................... .. VSAMAUD ................... .. 5-12
`
`Appendix A Jump Codes
`
`Jump Codes by Screen Title ................................................................................... .. A-1
`Jump Codes by Screen Name ................................................................................. .. A-3
`
`Appendix B Command Examples
`List Commands ....................................................................................................... .. B-1
`Delete Command .................................................................................................... .. B-1
`New Password Command....................................................................................... .. B-2
`
`New Relationship Command .................................................................................. .. B-2
`Select Files Command ............................................................................................ .. B-3
`
`GO Facility ............................................................................................................. .. B-3
`Transmitting Data ................................................................................................... .. B-4
`
`Gentran:Plus for zseries Release 6.5 User’s Guide
`
`

`

`Table of Contents
`
`Gentran:Plus for zSeries Release 6.5 User’s Guide
`
`

`

`Getting Started
`
`Overview
`
`Congratulations! You have selected Gentran:Plus®. As a subsystem of Gentran:Basic®,
`Gentran:Plus is an optional component of the most sophisticated EDI management software
`available. Gentran:Plus is a complete, fiilly-integrated EDI system that meets the two
`qualifications required for automated EDI implementation:
`
`-
`
`-
`
`Full-function EDI translation software
`
`Self—contained communications and mailboxing
`
`Gentran:Plus can accommodate an unlimited number of transactions while using an unlimited
`number of EDI standards Versions. The system supports multiple lines with different protocols for
`concurrent EDI sessions. This combination of translation, communications, and mailboxing makes
`Gentra_n:Plus a highly efficient EDI resource for automating your organization’s communications.
`
`The following topics related to Gentran:Plus are contained in this chapter:
`
`Topic
`
`Page
`
`Features and Benefits ........................................................................................................... 1-2
`
`Subsystems .............................................................................................................. .. 1-2
`System Flow ............................................................................................................ .. 1-3
`Communications Subsystem ................................................................................... .. l-4
`Translation Subsystem............................................................................................. .. 1-9
`Communications Setup and Management Subsystem........................................... .. 1- 14
`
`Function Keys ..................................................................................................................... 1-17
`
`Common Keyboard Conventions ...................................................................................... 1-18
`
`Gentran:Plus for zSeries Release 6.5 User’s Guide
`
`

`

`Getting Started
`
`Features and Benefits
`
`Features and Benefits
`
`With Gentran:Plus, you can configure EDI communications to fit your specific needs using several
`features, including the following:
`
`-
`
`-
`
`-
`
`Default profiles make setting up new profiles simpler.
`
`Backwards scrolling through batches for a remote site makes viewing data easier.
`
`Communication status Values on the Interchange Status screen enable you to
`update and View data on the Communications Control file, data queues, and Log
`file.
`
`Online functions enable you to View the Communications Log file and define
`holidays on which communications are halted.
`
`Gentran:Plus provides a seamless application-to-EDI interface including the following features:
`
`-
`
`Communication with networks and trading partners, including all major third-
`party EDI networks, is simple using common communications protocols.
`
`Communications session options enable you to choose either one-way or two-way
`communications sessions, and to specify these sessions for each of your trading
`partners.
`
`Gentran:Plus can be integrated with the Connect Security Interface and your external security
`package to restrict access to View Connect data and perform certain Gentran:Plus functions. This is
`accomplished by verifying the user’s identity when the Gentran:Plus online subsystem is first
`entered. Users can be identified either by their Gentran User ID, a default ID, or prompted to
`provide a User ID and Password.
`
`System Overview
`Gentran:Plus consists of three major interactive subsystems that automate the inbound and
`outbound communications processes for you, and enable you to manage your communications
`data.
`
`Subsystems
`
`Communications Subsystem
`
`The Communications subsystem (Connect) provides inbound and outbound communications lines,
`automatic dialing, mailbox storage for data batches, and multiple communications protocol
`support.
`
`Translation Subsystem
`
`The Translation subsystem (Gentran:Basic) validates EDI standards, performs compliance
`checking, performs mapping to and from EDI standards, performs error rejection, completes
`acknowledgment processing, and enables file splitting.
`
`Communications Setup and Management Subsystem
`
`Communications Setup (Gentran:Plus) enables you to define the following for each trading
`partner/network: the communication protocol information (such as BISYNC, FTP, or SNA data),
`call contact data (such as company name, contact, phone number, Remote ID, communication
`
`Gentran:Plus for zSeries Release 6.5 User’s Guide
`
`

`

`System Overview
`
`Getting Started
`
`type), selection of holidays during which auto connect schedule creation is suppressed, and a
`transmission schedule.
`
`Communications Management (Gentran:Plus) enables you to View and update the status of stored
`communications data, monitor all EDI transmissions for successful completion, View the raw data
`by document and record, View complete auto connect/remote connect communications history,
`submit communications reports online, and update batch status flags and the communications
`history log failure scan.
`
`System Flow
`
`Figure 1.] illustrates inbound and outbound flow through the subsystems described above. The
`numbers in the illustration correspond to the steps below the figure that describe the flow.
`
`Translation
`
`Subsystem
`
`G)
`
`I|‘ibOl.|I'ld
`Mailbox
`
`Communications
`parameters
`
`Ol.l1b0Lll"|d
`Mailbox
`
`®
`
`communications
`Subsystem
`
`®
`
`Online
`
`C0rnI'nUniCatiOnS
`Setup and
`Management
`Subsystem
`
`Trading Partners
`andlor
`Third-party Networks
`
`Figure 1.1 Gentran:P|us Inbound and Outbound Flows
`
`Gentran:Plus for zSeries Release 6.5 User’s Guide
`
`

`

`Getting Started
`
`System Overview
`
`The following steps describe the inbound and outbound flows through the Gentran:Plus
`subsystems.
`
`1.
`
`The Translation subsystem receives your application file data sent from files,
`maps the data to standard format, and wraps EDI transmission envelopes around
`the data.
`
`The file data is added into the Outbound Mailbox. The data is now ready for
`transmission to your trading partner or third—party network.
`
`The Communications subsystem initiates communications sessions using the
`communications parameters specified for the trading partner/network.
`
`The system reads the data found in the Outbound Mailbox.
`
`The Communications subsystem transmits the data to the appropriate trading
`partner or network.
`
`The Communications subsystem accepts inbound data from a trading partner or
`network.
`
`The inbound data batches received are loaded into the Inbound Mailbox.
`
`The Translation subsystem pulls the data received in the Inbound Mailbox and
`checks it for compliance to EDI standards.
`
`The data is mapped to a specified application file format ready for use in your
`internal applications.
`
`Online communications setup and management screens are used to set up and define the
`communications/transmissions information for each trading partner, and to manage
`communications data that is sent and received.
`
`Communications Subsystem
`
`The Communications subsystem of Gentran:P1us operates on a host mainframe and communicates
`with remote terminals or computers. The system enables you to operate in an unattended mode, to
`receive data from your trading partners/networks, and to transmit data to your trading partners/
`networks. Either you or your trading partners may initiate transmissions.
`
`The following list describes many of the flexible and automated features of the Communications
`subsystem:
`
`-
`
`An optional auto connect feature enables fiilly-automated, unattended data
`transmissions. The auto connect feature enables scheduled transmission to/from
`
`your direct-connect trading partner or third-party networks.
`
`FTP, BSC, and SNA network support enable you to communicate with most
`remote sites or trading partners.
`
`Automated incoming communication batch extraction and logging move data
`more quickly through the translator and into your internal application files.
`
`Gentran:P1us for zSeries Release 6.5 User’s Guide
`
`