Release Notes and Impact Guide - delivery04.dhe.ibm.com

1 IBM Sterling Gentran Server for iSeriesRelease Notes and Impact GuideVe r s i o n IBM Sterling Gentran Server for iSeriesRelease Notes and Impact GuideVe r s i o n This edition applies to the version of IBM Sterling Gentran:Server for iSeries and to all subsequent releasesand modifications until otherwise indicated in new editions. Copyright IBM Corporation 1990, Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Sterling Gentran:Server for iSeries Release Notes andImpact Guide for Information about Sterling Gentran:Server document describes the changes to IBM Sterling Gentran:Server for iSeries for fixpack Release , which contains the Repeating Data Elements feature. TheSterling Gentran:Server documentation set is not yet updated for this Release .

2 Thisdocument is the only information available for this Release and it supplements theinformation in theIBM Sterling Gentran:Server for iSeries User GuideandIBMS terling Gentran:Server for iSeries Technical Reference DownloadsTo download Sterling Gentran:Server version from Fix Central: LinksThe IBM product information website for Sterling Gentran:Server is: Sterling Gentran:Server documentation is available at: for Sterling Gentran:ServerSterling Gentran:Server software is supported by trained product supportpersonnel who are available to help with product questions or can access the Sterling Gentran:Server Customer Support page (SupportPortal) at: :Server_for_iSeriesYou can also call Customer Support at 1-800-IBM-SERV (1-800-426-7378).To help us provide prompt service, we ask that you do the following:vAttempt to recreate any problem that you encounter and record the exactsequence of you call product support, you should be prepared to provide us with theinformation listed in the following table.

3 Copyright IBM Corp. 1990, 20131 Table 1. Information to provide product supportInformationDescriptionIdentificat ionYour company name, your name, telephone number andextension, your company s IBM customer number (ICN), andthe problem management record (PMR) number (if thequestion refers to a previously reported issue)System ConfigurationSterling Gentran:Server version (and any patches or optionsinstalled) and information about any machines experiencingproblems, includingvOperating system versionvPoint releaseAlso, please describe any recent changes in your hardware,software, or the configuration of your MessagesIf possible, get a screen capture of any error messages and thepoint at which the error occurred, as well as any log files. (Ifyou cannot get a screen capture, record the exact wording ofthe error.)Attempted SolutionsRecord any steps that you took attempting to resolve theproblem and note all outcomes.

4 Provide an estimate on howmany times the problem occurred and whether it can InformationRequired Hardware and SoftwareThis information assumes that you are downloading the product .zip file to a PCor workstation and then uploading it to your Sterling Gentran:Server system. Thefollowing items are required:vApproximately 500 MB (total) free space on your PC hard drive for both thezipped (140 MB) and unzipped (350 MB) softwarevAdobe Acrobat Reader (for documentation PDFs)If you do not have Acrobat Reader, you can download a free version from theAdobe of the Documentation FileUse the WinZip software to expand the file into a Release folder. You should have the following documents:vSterling Gentran:Server What s NewvSterling Gentran:Server Installation Guide Release Gentran:Server Cumulative Fix Installation Guide Release Gentran:Server Communications Guide Release Gentran:Server Manager s Implementation Planner Release Gentran:Server Technical Reference Guide Release Gentran:Server User Guide Release :Viewpoint for iSeries for Gentran:Server Release Complete, ANSI X12 Tutorial Guide for Sterling Gentran:Server Release Complete, EDIFACT Tutorial Guide for Sterling Gentran:Server Release Sterling Gentran Server for iSeries: Release Notes and Impact GuideContents of the Product FileUse the WinZip software to expand the file.

5 You should have thefollowing Save files:vG3X6 DTAvG3X6 FIXDTAvG3X6 PGMvG3X6 FIXPGMvG3X6 SAMPvG3X6 SAMPFXvG3X6 TOOLvQGPLG3X6 Moving Save FilesAfter downloading the files, you need to move them to Sterling this taskComplete the following steps to move the Save files from the download drive toSterling each item that you plan to install, create a Save file on your SterlingGentran:Server. Use the following commands, whereG3X6 TEMPis the librarywhere your Save files will reside (this is the library of your choice):CRTSAVF FILE(G3X6 TEMP/G3X6 DTA)CRTSAVF FILE(G3X6 TEMP/G3X6 PGM)CRTSAVF FILE(G3X6 TEMP/G3X6 FIXDTA)CRTSAVF FILE(G3X6 TEMP/G3X6 FIXPGM)CRTSAVF FILE(G3X6 TEMP/G3X6 SAMP)CRTSAVF FILE(G3X6 TEMP/G3X6 SAMPFX)CRTSAVF FILE(G36 EMP/G3X6 TOOL)CRTSAVF FILE(G3X6 TEMP/QGPLG3X6)Note:G3X6 SAMPandG3X6 SAMPFX only need to be created if you are restoring thetutorial needs to be created if you are restoring thetools you saved your files to a mapped network drive, complete the the following commands from an Sterling Gentran:Server commandline (whereG3X6 TEMPis the library where your save files will reside).

6 CPYFRMSTMF FROMSTMF( location of file/QGPLG3X6 )TOMBR(' ') MBROPT(*REPLACE)\CPYFRMSTMF FROMSTMF( location of file/G3X6 DTA )TOMBR(' ') MBROPT(*REPLACE)\CPYFRMSTMF FROMSTMF( location of file/G3X6 PGM )TOMBR(' ') MBROPT(*REPLACE)\CPYFRMSTMF FROMSTMF( location of file/G3X6 FIXDTA )TOMBR(' ') MBROPT(*REPLACE)\CPYFRMSTMF FROMSTMF( location of file/G3X6 FIXPGM )TOMBR(' ') MBROPT(*REPLACE)\IBM Sterling Gentran:Server for iSeries Release Notes and Impact Guide for you are downloading the Sample (tutorial) library, enter the followingcommands:CPYFRMSTMF FROMSTMF( location of file/G3X6 SAMP )TOMBR(' ') MBROPT(*REPLACE)\CPYFRMSTMF FROMSTMF( location of file/G3X6 SAMPFX )TOMBR(' ') MBROPT(*REPLACE)\ you are downloading the Tools library, enter the following command:CPYFRMSTMF FROMSTMF( location of file/G3X6 TOOL )TOMBR(' ') MBROPT(*REPLACE)\ you saved your files to a PC hard drive, complete the following a DOS prompt, the(to)parameter, enter the IP address for your SterlingGentran:Server your Sterling Gentran:Server user profile and password as you are logged on, :If you do not enter this command, the file transfer will not beexecuted the following commands to send the files to your SterlingGentran:Server server (whereG3X6 TEMPis the library where your save fileswill reside):put c:\location\of\the\savf\QGPLG3X6 G3X6 TEMP/QGPLG3X6 (replaceput c:\location\of\the\savf\G3X6 DTA G3X6 TEMP/G3X6 DTA (replaceput c:\location\of\the\savf\G3X6 PGM G3X6 TEMP/G3X6 PGM (replaceput c:\location\of\the\savf\G3X6 FIXDTA G3X6 TEMP/G3X6 FIXDTA (replaceput c.))))

7 \location\of\the\savf\G3X6 FIXPGM G3X6 TEMP/G3X6 FIXPGM ( you are downloading the Sample (tutorial) library, enter the followingcommands:put c:\location\of\the\savf\G3X6 SAMP G3X6 TEMP/G3X6 SAMP (replaceput c:\location\of\the\savf\G3X6 SAMPFX G3X6 TEMP/G3X6 SAMPFX ( you are downloading the Tools library, enter the following command:put c:\location\of\the\savf\G3X6 TOOL G3X6 TEMP/G3X6 TOOL ( completed, enterquitto exit your ftp to do nextNow follow the installation instructions included in the documentation Repeating Data ElementsRepeating Elements is a standards feature that became available with the ASCIIX12 004030 and EDIFACT D 99B releases. This feature allows simple andcomposite elements to appear multiple times in a segment without each occurrencebeing explicitly defined in the segment standards that were issued in December 2012 contain all of the necessaryrepeat structures.))))

8 You can continue to use your current standards; however, if youwish to use repeating elements, you must download the newer versions. Thisreloads the versions with the appropriate repeat functions, allowing SterlingGentran:Server to recognize the elements that contain Sterling Gentran Server for iSeries: Release Notes and Impact GuideFor examples of segments that contain Repeating Elements, review the following inthe standards:vDMG segment in ASCII X12 version 006040, transaction 810vCOM segment in the EDIFACT version D 10B, transaction INVOICNote:To use the Repeating Data Elements feature, you must be on SterlingGentran:Server point Release or TermsRepeating Data ElementA simple data element or a composite data structure that repeats aspecified number of times within a segment ValueThe number of times a repeating data element can repeat.

9 The maximumvalue that an element can repeat is 99 times. This repeat value isdetermined by the SeparatorThe delimiter that separates each simple data element or composite datastructure found within a repeating data Simple Data ElementA segment with a repeating simple data element could be represented as follows:TAG*DE-1*DE-2*RDE-1|RDE-2|RDE-3| RDE-4*DE-4?where * is the element separator, | is the repetition separator, ? is the segmentterminator, and the repeat value is RepeatThe standards allow for certain occurrences of a repeat to be optional, causing anull repeat:TAG*DE-1*DE-2*RDE-1||RDE-3|RDE-4* DE-4?where || indicates a null repeat (RDE-2).Dropped Trailing RepeatsThe standards allow for trailing repeats to be dropped if they are not meaningful:TAG*DE-1*DE-2*RDE-1|RDE-2*DE- 4?where RDE-3 and RDE-4 are dropped but the repeat value is still Composite Data StructureA segment with a repeating composite data structure could be represented asfollows:TAG*DE-1*DE-2*CE1:CE2:CE3|CE1: CE2:CE3|CE1:CE2:CD3|CE1:CE2:CE3*DE-4?

10 IBM Sterling Gentran:Server for iSeries Release Notes and Impact Guide for * is the element separator, | is the repetition separator, : is the sub-elementor component separator, ? is the segment terminator, the repeat value is 4, andCE1:CE2:CE3 is the composite repeating data Repeating Data Elements are ProcessedThe Inbound and Outbound Editors validate the repetition separator to ensure thatit contains a valid Repeating Indicator field on the Standards Transaction (EDIX120) screen mustbe set to Y for the transaction to be validated. If the transaction has a segment thathas repeating data elements defined but a valid repetition separator is not found,an error will be generated and the transaction will be X12 ProcessingBefore version 004020, the ISA11 was defined as the Interchange Control StandardsIdentifier (element type = ID, minimum length = 1, maximum length = 1).