HOSTRWlockinfo

MicroFocusVisualCOBOL2.
3Update2forEclipseReleaseNotesMicroFocusTheLawn22-30OldBathRoadNewbury,BerkshireRG141QNUKhttp://www.
microfocus.
comCopyrightMicroFocus2009-2016.
Allrightsreserved.
MICROFOCUS,theMicroFocuslogoandVisualCOBOLaretrademarksorregisteredtrademarksofMicroFocusIPDevelopmentLimitedoritssubsidiariesoraffiliatedcompaniesintheUnitedStates,UnitedKingdomandothercountries.
Allothermarksarethepropertyoftheirrespectiveowners.
2016-09-16iiContentsMicroFocusVisualCOBOL2.
3Update2forEclipseReleaseNotes4What'sNew5SignificantChangesinBehaviororUsage7KnownIssues9ResolvedIssues11OtherIssuesResolvedinThisRelease28Installation30BeforeInstalling30DownloadingtheProduct30OnWindows30OnUNIX32BasicInstallation36OnWindows37OnUNIX37AdvancedInstallationTasks39OnWindows39OnUNIX40AfterInstalling41OnWindows42OnUNIX43LicensingInformation45Tobuyandactivateafullunlimitedlicense45TostartMicroFocusLicenseAdministration45Installinglicenses45Ifyouhavealicensefile45Ifyouhaveanauthorizationcode46Toobtainmorelicenses47UpdatesandSupportLine48FurtherInformationandProductSupport48InformationWeNeed48CreatingDebugFiles50Disclaimer51Contents|3MicroFocusVisualCOBOL2.
3Update2forEclipseReleaseNotesThesereleasenotescontaininformationthatmightnotappearintheHelp.
Readthemintheirentiretybeforeyouinstalltheproduct.
Note:ThisdocumentcontainsanumberoflinkstoexternalWebsites.
MicroFocuscannotberesponsibleforthecontentsoftheWebsiteorforthecontentsofanysitetowhichitmightlink.
Websitesbytheirnaturecanchangeveryrapidlyandalthoughwetrytokeepourlinksup-to-date,wecannotguaranteethattheywillalwaysworkasexpected.
ChecktheProductDocumentationsectionoftheMicroFocusSupportLineWebsiteandtheMicroFocusInfocenterforanyupdatestothedocumentationwhichmighthavebeenuploaded.
UpgradingfromearlierMicroFocusproductsApplicationexecutablesthatwerecompiledusingearlierMicroFocusproductsmustberecompiledfromthesourcesusingVisualCOBOL.
4|MicroFocusVisualCOBOL2.
3Update2forEclipseReleaseNotesWhat'sNewThisreleaseprovidesenhancementsinthefollowingareas:IntegrationwithEclipseCOBOLlanguageenhancementsClassicDataFileToolsCompilerdirectivesEditorwritingassistanceFilehandlingInterfaceMappingToolkitLibraryroutinesTutorialsIntegrationwiththeEclipseIDEBacktoTopEnhancementsareavailableinthefollowingareas:Usingthesearchfacility,Search>MicroFocus,youcannowlimitthesearchtothecopybooksusedbythecurrentprogramratherthanallcopybooksintheprojectortheentireworkspace.
Theeditorprovidesanewcontextmenucommand,ExtractCOBOLcodetocopybook,thatenablesyoutomoveaselectedsegmentofthecodetoanewcopybookfileinyourproject.
ThesegmentofcodemovedtoacopybookisreplacedwithaCOPYstatementintheoriginalprogram.
SupportforEclipse4.
5-afterinstallingVisualCOBOL,youcanadditasapluginintoaseparateinstanceofEclipse4.
5.
Seeyourproduct'sInstallationnotes.
COBOLlanguageenhancementsBacktoTopNumeric,editedandexternalfloatingpointitemscannowspecifyUSAGENATIONALwhentheNATIONAL"2"Compilerdirectiveisineffect.
SignednumericitemsmustbespecifiedwiththeSIGNISSEPARATEclause.
ClassicDataFileToolsBacktoTopAnewcommandlineutilityisavailablewhichenablesyoutoinitiatethefollowingactions:opendatafiles,createoropenrecordlayoutfiles,createoropensegmentlayoutfiles,andopenIMSdatabasesusingaDBDorPSBfile.
Notethatalthoughyoucaninitiatetheseactionsfromthecommandline,youmustcompletethemfromwithintheIDE.
CompilerdirectivesBacktoTopThefollowingCompilerdirectivesarenewinthisrelease:COMMAND-LINE-LINKAGE-enablesyoutocallaprogramandpassthecommandlinetothemainprogramasaparametertobeaccessedviatheLinkageSection.
Thisoffersequivalentfunctionalitytothecommand_line_linkagetunable,whichhasnowbeendeprecated.
EBC-COL-SEQ-controlsthebehaviorofanEBCDICcollatingsequence,specifiedinaNATIVE"EBCDIC"program.
EBC-COL-SEQ"1"(thedefault)maintainsuseofthelong-standingfixedWhat'sNew|5(platform-independent)EBCDICcollatingsequence.
EBC-COL-SEQ"2"promptsuseofthelatestCODESETtable,whichvariesaccordingtoplatformanduser-controlledMFCODESETenvironmentvariablesetting.
NATIONAL-enablesyoutospecifynumeric,editedandexternalfloatingpointitemsasUSAGENATIONAL.
EditorwritingassistanceBacktoTopThisreleaseprovidesthefollowingenhancements:Colorizationofconditionalcompilationregions-bydefault,inactivecodeisnowcoloredthesameasCompilerdirectiveelements.
InactivecodeisdefinedascodewithinconditionalblocksthatdonotevaluatewiththeappliedCompilersettings.
$REGIONstatement-supportisprovidedforthe$REGIONCompiler-controlstatement.
Youcanuse$REGION-$END-REGIONtosurroundblocksofcodethatyouwanttofoldorexpandintheeditor.
AutoCorrect-youcanconfiguretheeditortoautomaticallyfixthemostfrequentlymisspelledwords.
YouusetheIDEpreferencestospecifyalistofwordsthatyousometimesmistype,andthecorrectspellingsforthem.
Wheneveryoumisspellthatword,theeditorautomaticallyreplacesitwithcorrectversion.
ThisfeatureisenabledbydefaultandcanbeconfiguredfromanewpreferencepageinWindow>Preferences>MicroFocus>COBOL>Editor>AutoCorrect.
FilehandlingBacktoTopMFJSORTICETOOLnowsupportstheUSINGparameterintheSELECToperator.
InterfaceMappingToolkitBacktoTopThisreleasesupportsJSONschemasforthegenerationofRESTWebserviceclientsintheEclipseIDE.
LibraryroutinesBacktoTopThefollowinglibraryroutinecontainsnewfunctionality:CBL_GET_PROGRAM_INFO-anewfunction(function10)hasbeenaddedfornativeCOBOLwhichreturnsthepathandprogramname,ortheprogramnameonlyofaparticularprogram.
TutorialsBacktoTopTheproducthelpincludesthefollowingnewtutorial:Tutorial:SQL-DeployinganEnterpriseJavaBeanContainingJVMCOBOLtoaJBossApplicationServer-thatwalksyouthroughtheprocessofdeployinganEJBthatcontainsJVMCOBOLcode.
6|What'sNewSignificantChangesinBehaviororUsageThissectiondescribessignificantchangesinbehaviororusage.
Thesechangescouldpotentiallyaffectthebehaviorofexistingapplicationsorimpactthewaythetoolsareused.
Wherepresent,thenumbersthatfolloweachissuearetheSupportIncidentNumbersfollowedbytheReportedProblemIncident(RPI)number(inparentheses).
EnterpriseServerCompilerEclipseIDEMFDirectoryServerMonitoringandManagementRun-TimeSystemCompilerBacktothelistReplacingapartialtokennolongercausesthesecondpartofthetokentoappearonanewline.
Thiscouldhappenifthenewtextwaslargerthanthetextbeingreplaced.
2869185(1105763)ThereisnolongeraproblemopeninganRM/COBOLindexedfilewhentheprogramhasaRECORDCONTAINSnCHARACTERSclauseandtherearerecorddescriptionswithlengthslessthann.
Thissituationpreviouslycauseda39errorontheOPEN(otherthanOPENOUTPUT)becausetherewasamismatchintheminimumrecordlength.
EclipseIDEBacktothelistThisupdatemodifiesanyexistingconnectionsdefinedinanEclipseworkspace.
Iftheconnectionshadanynon-defaultvalues,thosevaluescouldreverttotheiroriginaldefaultsetting.
Afterinstallingthisrelease,beforeyouuseanyremoteconnectionsforthefirsttime,youneedtocheckthesettingsandamendthemasnecessary.
2852872(1103699)EnterpriseServerBacktothelistPreviously,itwaspossibletoinstallgroupsthatshouldnothavebeeninstalled.
Ifagroupname,asdefinedintheStartupList,didnotexistinthelistofGroupsthenthenextGroupinthealphabeticalorderwouldbeloadedinstead.
Now,ifaGroupisnotdefinedinthelistofGroups,awarningthattheGroupcouldnotbeloadedisissued.
2869848(619107)OnUNIX,ifthe"FilePath"settingwasnotspecifiedintheconfigurationofanEnterpriseServer,theenvironmentvariableTXFILEPwasdefaultingto$COBDIR/etc/cas.
ThishasbeenchangedandTXFILEPisnotpopulatedwhenthe"FilePath"isnotspecified.
(618668)MFDirectoryServerBacktothelistSignificantChangesinBehaviororUsage|7The"-n"optionforthemfdscommandnowsupportshostnamesasthenetworkaddressesinadditiontoIPv4addresses.
2816871(1099564)MonitoringandManagementBacktothelistMessagesthatarewrittentotheconsolelogbyapplicationsthatperform"displayuponconsole"nowcontainastandardmessageID(CASMG0001I).
2854207(1103659)Run-TimeSystemBacktothelistThecommand_line_linkagetunablehasbeendeprecated;equivalentfunctionalitycanbeachievedbyusingtheCOMMAND-LINE-LINKAGECompilerdirectiveinstead.
2838118(1101539)8|SignificantChangesinBehaviororUsageKnownIssuesRefertotheKnownIssuesandRestrictionstopicintheProductInformationsectionofyourproductHelp.
Inaddition,notethefollowing:DebuggingWhendebuggingaremoteprogram,theperformanceofthenetwork,specificallythelatencybetweenthelocalandremotemachines,willhaveaneffectontheresponsivenessofEclipse.
WheneverEclipsehastoshowthenewexecutionposition,anumberofmessagesaresentfromtheremotemachine,overthenetwork,togettherequiredinformation.
TheeffectofthisisthatitcantakeafewsecondsafteraStepcommandisissuedbeforeEclipsehasupdatedthescreenandisreadyforthenextcommand.
Youcanmitigatethisdelaybyclosinganyunnecessarydebugviews.
Forinstance,byclosingtheExpressionsviewandtheVariablesview,thenumberofmessagesthataresentisreduced,whichallowsEclipsetoupdatequicker.
Largeprogramscansufferfromalargedelaythefirsttimethattheprogramisdisplayedinthedebuggerandanexpressionisevaluated.
Youcanreducethisdelaybyfollowingthesesteps:1.
Createatextfilecalleddebugconfig.
xml.
2.
Addthefollowinglines,andthensavethefile:3.
Atacommandorshellprompt,settheenvironmentvariableDEBUG_CONFIGtothefullpathnamefordebugconfig.
xml.
4.
StartEclipsefromthesamecommandorshellprompt.
RemotedebuggingdoesnotworkforprogramsrunningonAIXorHPmachines,ifyouaretryingtodebugusingVisualCOBOLinstalledonaLinuxmachine.
DatabaseAccessIfyouhavearemoteCOBOLprojectunderEclipsethatusesDB2ECMinVisualCOBOLorHCOforDB2LUWinEnterpriseDeveloperandtheDB2softwareisnotinstalledontheclientmachinewhereyouareusingtheEclipseIDE,youreceivebackgroundparsingerrorsinyourapplication.
Toresolvetheissue,youcandoeitheroneofthefollowing:DisablebackgroundparsingWindow>Preferences>MicroFocus>COBOL>EditoranddisablingthecheckboxforBackgroundparsing.
InstalltheIBMDB2client-sidesoftwareonthemachineonwhichyouarerunningEclipse.
GototheIBMSupportHomeandlocatethepageentitled"IBMDownloadFixPacksforIBMDataServerClientPackages".
EnterpriseServerTheHistoricalStatisticsFacilitymaygenerateincorrectrecordsforSSTM-enabledenterpriseservers.
OnWindows10,ifyouareusingMicrosoft'sEDGEbrowsertoaccesstheEnterpriseServerAdministrationGUI,issueswithEDGEcancausetheautomaticrefreshfeaturetodisplayadialogaskingwhetheryouwanttoresubmitaform.
Toworkaroundthisissue,canceltheresubmitrequestandthenrefreshtheserverlistpageortheHomepageofEnterpriseServerAdministration.
YoucanalsoturnofftheautomaticrefreshbysettingtheAuto-refreshintervalsettingontheHomepageofEnterpriseServerAdministrationto0.
KnownIssues|9ResourceAdaptersTryingtodeploythelocalresourceadaptormfcobol-localtx.
rartoWebLogicmayfailwithaClassCastException.
Toworkaroundthisissue,youneedtodeploymfcobol-xa.
rarfirst,thenneedtoundeploythisfileanddeploythelocalone,mfcobol-localtx.
rar.
IfthereareissuesdeployingusingtheWebLogicGUI,youcanusethecommandline.
Ifthereareissueswiththisaswell,tryreducingthelengthofthecommand(forexample,bymovingthefiletoalocationwithashorterpath).
REST/JSONIMTKimplementationandthesame-originpolicy(SOP)HTTPrequestssentfromscriptswithinawebbrowsertoRESTservicesdeployedonanenterpriseservermightfailduetothesame-originpolicy(SOP).
Somebrowsersmightimplement(orsupportpluginsthatimplement)techniquesforrelaxingSOPsuchascross-originresourcesharing(CORS)thatenablesendingcross-originrequestssuccessfully.
ForRESTservices,EnterpriseServerdoesnotimplementamethodforrelaxingSOP.
ThismeansthatbrowsersthatimplementCORS(oranyotherSOPrelaxationtechnique)mightstillforbidrequestsmadefromscriptsduetoEnterpriseServernotimplementingtheequivalenttechniqueontheserverside.
ViewingtheProductHelpAknownissueinJRE1.
7.
0_45(issueJDK-8028111)causesproblemswithsearchingandindexingthehelpintheEclipsehelpviewerifyouarerunningEclipseonamachinethathasthisversionofJREinstalled.
10|KnownIssuesResolvedIssuesThenumbersthatfolloweachissuearetheSupportIncidentNumbersfollowedbytheReportedProblemIncident(RPI)number(inparentheses).
CharacterAnimatorCodeAnalysisCodesetSupportCommonCommunicationsInterfaceCompilerDataToolsDebuggingDialogSystemDocumentationEditorWritingAssistanceEnterpriseServerFileHandlingH2cpyIDEInterfaceMappingToolkitLicensingMicroFocusDirectoryServerMVSREXXEmulationOpenESQLSetupSQL:COBSQLSQL:DB2SQL:OpenESQLSQLOptionforDB2XMLSyntaxSupportCharacterAnimatorBacktothelistThesourcefileisnowfoundwhenitislocatedinthesamedirectoryasthe.
idyfile.
2852782(1103425)CodeAnalysisBacktothelistTheGOTOstatementstargetingnon-exitparagraphsquerynolongerreturnspointsinsideEXECstatements.
Theperformancehasbeenimproved.
Thecriterionfordeadstatementswithinaprogramhasbeenmodifiedtoexcludechildelementsofstatements.
Level78constantnamesusedinpicturedefinitionsarenowreplacedwiththeactualvalues.
Anissuewithde-referencingNULLpointersduringprogramgenerationhasbeenfixed.
Anissuewithde-referencingaNULLpointerhasbeenfixed.
ResolvedIssues|11CodesetSupportBacktothelistAnumberofDBCStranslationtablesforCODESEThavebeenaddedtothedeploymentproducttofixthe'COBRT255CODESETcannotopendoublebyteconversiontable'error.
2858171(1104157)ThefollowingchangeshavebeenmadetoCODESETtables:TheJapaneseKatakanaExtendedcodeset(countrycode81)nowcorrespondstoEBCDICcodepage290whenconvertingbetweenASCIIandEBCDIC,whichmeanslowercaseletters(whichstartatx61,andnotx81)cannowbeconverted.
Unusedentriesforthefollowingcodesetshavebeenfilledinordertoallowroundtripping(ASCII>EBCDIC>ASCIIconversions)ofSBCSvalues:JapaneseLatinExtended,countrycode939,whichcorrespondstoEBCDICcodepage1027.
Korean,countrycode82,whichcorrespondstoEBCDICcodepage833.
SimplifiedChinese,countrycode86,whichcorrespondstoEBCDICcodepage836.
TraditionalChinese,countrycode886,whichcorrespondstoEBCDICcodepage37.
CommonCommunicationsInterfaceBacktothelistTheformattingofthecontexthelppagesfortheEnterpriseServerAdministrationHTMLGUIhasbeenimproved.
CompilerBacktothelistWhenaprogramusesSQL,thedebuggercouldhighlightthewronglinewhenenteringthatprogram.
Thishasbeenfixed.
2869190(1105765)On32-bitIntelplatformsyoucouldreceiveanerror"001-FInternalerror38"whengeneratingfordebug.
2856865(1104040)ACOBRT114errorproducedatgeneratetimehasbeenfixed.
2853877(1103611)Anerrorinthe"ACCEPTbinary-floating-point-item"syntax,whichoccurredonIntelx86platformsin32-bitgeneratedcode,hasbeenfixed.
OnUNIXorLinux,Intelx86,32-bitplatforms,callablesharedobjectsnolongerstateaspuriouslinenumberwhenreportingRTS163runtimeerrors.
IfmorethanonereportsharedthesameFD,forexample:REPORTSAREREPORT-1REPORT-2.
thenunderHOSTRW,therecordlengthwaswrong.
Thishasbeencorrected.
2865849(1105553)ProgramsusingB-AND,B-OR,orB-XORnowcompilewiththeARITHMETIC"ENTCOBOL"Compilerdirectiveineffect.
2864991(1105087)ADISPLAYstatementcontainingaverylargenumberofoperandsnowcompilesasexpected.
2864361(1105017)Aninlinemethodinvokewithavariable-lengthgroupitemnowproducescorrectobjectcode.
2864131(1105018)ReportWriternowgeneratesthecorrectrecordlength.
Previously,iftheBLOCKCONTAINSclausecameaftertheRECORDCONTAINSclauseintheFileDescriptor,theBLOCKwouldcorruptthevaluefromtheRECORDclause,causingtherecordtohavethewronglengthwhenwrittentothefile.
2863045(1105008)12|ResolvedIssuesTheuseof'AS'asadata-nameforprogramsusinganSQLECMnowworksasexpected.
2863002(1104821)IfanINVOKEstatementspecifiesmoreparametersthanthemethodactuallyhas,anappropriateerrormessageisproduced.
Previously,an'internalerror'errormessagewasproduced.
2860899(1104519)AnINITIALIZEstatementperformedonasubscriptedtablecontainingfieldsthatareobjectreferencesorprocedurepointersnowexecutesasexpected.
2860416(1104588)MessagesproducedbytheFLAGSTDdirectivenowhavethecorrectlineandcolumninforeportedintheIDE.
2859026(1104318)ACOBOLprogramcompiledwiththePROFILECompilerdirectivenowshowsinformationonthenumberoftimestheprogramhasbeencalled,aswellasloaded.
2858944(1104278)WhenREPLACEisactive,aliteralcontaining''''nowcompilesasexpected.
2858804(1104264)Acompilationwhereauserpre-processorisspecifiedbelowCPinthepre-processorstack,andthispre-processorpassesCOPYstatementsthroughunopened,nowworksasexpected.
2858013(1105427)CompilationofaSTRINGstatement,withanoperandthatreferencemodifiestheresultreturnedbyauserfunction,nowworksasexpected.
2857266(1104189)Anewdirective,EBC-COL-SEQ,nowcontrolsthebehaviorofanEBCDICcollatingsequence,specifiedinaNATIVE"EBCDIC"program.
EBC-COL-SEQ"1"(thedefault)maintainsuseofthelongstandingfixed(platformindependent)EBCDICcollatingsequence.
EBC-COL-SEQ"2"promptsuseofthelatestCODESETtable,whichvariesaccordingtoplatformanduser-controlledMFCODESETenvironmentvariablesetting.
2856776(1104074)SCREENSECTIONswithverylargeamountsoffields,whichworkedinNetExpress,nowworkinVisualCOBOL.
2854533(1103648)CopybookdependencyinformationisnowshowncorrectlyinEclipseforprogramscompiledwithapreprocessorsuchasCP.
2854371(1103662)Compilerwarningmessage"COBCH972Linkageitem(orsubordinateitem)isreferencedbuthasnoaddressability"isnolongerproducedinappropriately.
2854113(1103542)TheuseoftheHOSTRWandCURRENT-DATEdirectivesnolongercausesanexcessivenumberoflinesinareportproducedfromtheReportWriter.
2853789(1105472)SubscriptsspecifiedviaintrinsicfunctionLENGTH-ANnolongerreceivespuriousboundaryviolationerrormessages.
2851928(1103254)PreprocessorcreatederrormessagescontainingSJIScharactersarenowdisplayedcorrectly,asexpected.
2646229(1089272)ResolvedIssues|13AUSEFORDEBUGGINGstatementthatreferencesatableitemandistriggeredbyaconditionwherethetableitemisreferencedbutnotevaluated(duetoshort-circuitevaluation)nowexecutesasexpected.
2433731(1073167)Thereisanewoption,CP,inEXECPERIOD.
ItcontrolstheprocessingofperiodsthatfollowEXECstatements.
Inmostscenarios,thedefaultoption,EXECPERIOD(SMART),enablesyoutocompilebyapplyingaflexiblebehaviorbasedontheprogram'scontext.
2867788(1105608)ACALLstatementinsideamethodcouldsometimesleadtobadcodegeneration,leadingtoverificationerrorsonprogramload.
Thisisnowfixed.
2856883(1103973)DataToolsBacktothelistDFCONVnowcorrectlysupportsacommandlinelengthof1024characters,asdocumented.
2868190(1105640)TheclassicDataFileToolsutilitynowshowsthecorrectfieldsizesforPL/Iarrayelements.
2858068(1104147)TheDFCONVutilitynowconvertscorrectlybetweenIEEEand370floatingpoints.
2857502(1104054)DebuggingBacktothelistInEclipse,programbreakpointsinaprogramwithDECLARATIVESnowstopcorrectlywhentheprogramisentered.
2868653(1105740)Whenrepeatingthedebuggingofremote64-bitapplications,Eclipsewouldoccasionallyhang.
2846587(1102616)WhentheCOBANIMSRVenvironmentvariablewasusedunderWindowsforcross-sessiondebuggingunderEclipse,theworking-storagedataitemsmighthavedisplayed'RT114error'instead.
Theseitemsshouldnowdisplaycorrectly.
Whendebuggingaprogramorcorefile,stackunwindthroughasignaltrampolinecouldfailonAIX7.
1.
DialogSystemBacktothelistTheDialogSystemconfigurationinformationcannowbeupdatedusingthepainter.
DocumentationBacktothelistThedocumentationoftheformatofCCI.
INIhasbeencorrected.
2867660(1105532)TheproducthelpnowclarifiesthatnavigationbarinVisualStudiodisplaysthelistsoftheobjectsandproceduresusedinthecurrentprogramaswellastheProcedureDivision,anysections,paragraphs,andgroupleveldatadefinitionsandenablesyoutopositionthecursoronanyofthem.
14|ResolvedIssues2858290(1104219)Thetopic"MakingtheMostOutofTheCOBOLEditor"intheproducthelpforVisualStudionowprovidesalinktotheinformationaboutlimitationswithsinglefilesupport.
2858263(1104217)Informationonsettingthemfdepinstsecuritycredentialsinthe.
mfdeployfileinthedeploymentparentdirectoryhasbeenaddedtothedocumentation.
2854625(1103607)TheproducthelpnowincludesinformationabouttheExcilRespExceptionandInvalidDataExceptionclassesandcorrespondingserializedforminformation.
2851195(1103171)The'ThisPage'helplinkinEnterpriseServeronUNIXnowopenstheHelp.
2818256(1099110)Changingtheproject'sconnectiontypecanresultintheprojectlosingtheconnectiontoitsversioncontrolsystem.
Youcanre-establishtheconnectionwithyourversioncontrolsystemintheShareProjectdialog.
2792882(1101965)StepfiveintheinstallingonUNIXwasmissingtheperiodthatgoesbefore"/opt".
Itnowreads:.
/opt/microfocus/EnterpriseDeveloper/bin/cobsetenv2855600(1103829)Theproducthelphasbeenupdatedtoremovetherequirementtoinstallthegcclibraries.
Theselibrariesarenotrequiredtoinstallandconfiguretheproductandthenforthebasicfunctionality.
gccisonlyrequiredifyouneedtouseCandCOBOLtogetherandgccwillbeinstalledtogetherwiththerequireddevelopmenttools.
2863618(1104878)UserexitsMFDASIMPandMFDASEXParenowdocumented.
2858575(1104507)UpdatedtheinformationontheactionoftheMFJESPWRuserexitprogramcontainedinthedocumentation.
2856725(1103944)TheDATAFIELDbuilt-infunctionhasbeenremovedfromthedocumentation.
2852986(1103391)Detailshavebeenaddedtothetopics"ToenableWindowsEventLogging"and"ToenablePerformanceCounters"tostatethattheusermustbeabletowritetotheappropriateregistry,andhaveappropriateprivileges,tocompletethesetasks.
2840002(617369)ECIprogramsthatusemfccl.
jarraiseanerrorexception,EXCIException,ifexciResp1andexciResp2arenotbothequaltozero.
ToensureyourECIprogramcapturesallerrors,youmustcatchthisexceptioninyourcode.
Pleaseaddthefollowingcodesnippet,whichenablesyourprogramtocompileandexecuteproperly:try{…}catch(ExciExceptione){StringrcMsg=e.
getRcMsg();}Ifanerroroccurs,rcMsgcapturestheappropriateerrormessage.
2830787(1100664)Thedocumentationforthe"MFDirectoryServerSecurity"pagehasbeenclarified,toshowthattheSecurityFacilityConfigurationparametersareavailableonthisscreenonlywhenMFDSisconfiguredtouseanESF(i.
e.
setuptouseaSecurityManagerotherthan"MFDSInternalSecurity"),otherwisenoESFsecurityconfigurationoptions(includingthecachingoptions)willbeseenonthisMFDSSecuritytabscreen.
Theseparametersare:AllowunknownresourcesAllowunknownusersCachelimitCacheTTLCreateauditeventsVerifyagainstallSecurityManagersResolvedIssues|15TheproductHelpnowincludessomeadditionaldetailsoncreatingadvancedfiltersforusingregularexpressionswiththeCompareandSynchronizationMonitor.
2645110(1089268)EditorWritingAssistanceBacktothelistIntelliSense(VisualStudio)andContentAssist(Eclipse)wouldsometimesnotofferreservedwordtypeswheretheywerevalid.
IntelliSense(VisualStudio)andContentAssist(Eclipse)offeredunqualifiedmanagedmemberswheretheycouldnotbeusedwithoutqualification.
IntelliSense(VisualStudio)andContentAssist(Eclipse)sometimesofferedinvalidpointeritems.
IntelliSense(VisualStudio)andContentAssist(Eclipse)incorrectlyofferredlevel88itensorrequirethemtobequalified.
IntelliSense(VisualStudio)andContentAssist(Eclipse)didnotofferitemsinthePERFORMUSINGstatement.
Anissuewherememberswithreservedwordnameswerenotcolorizedcorrectlyhasbeenfixed.
IntelliSense(VisualStudio)andContentAssist(Eclipse)suggestionsarenowofferedinmemberheadersformemberswithnamesthatarereservedwords.
IntelliSense(VisualStudio)andContentAssist(Eclipse)didnotshowoptionsafteritemswhichweresubscriptedorreferencemodified.
IntelliSense(VisualStudio)andContentAssist(Eclipse)didnotcorrectlyoffertypedefsinLENGTHOFphrases.
ItemsfromexternalprogramswereincorrectlyofferedinIntelliSense(VisualStudio)andContentAssist(Eclipse).
IntelliSense(VisualStudio)andContentAssist(Eclipse)didnotoffervariableswiththesamenameasclasses,methodsorpropertiesinthesamefile.
IntelliSense(VisualStudio)andContentAssist(Eclipse)didnotoffersuggestionsaftervariableswiththesamenameasclasses,methodsorpropertiesinthesamefile.
IntelliSense(VisualStudio)andContentAssist(Eclipse)omittedoptionsaftertheSETSIZE[OF]statement.
IntelliSense(VisualStudio)andContentAssist(Eclipse)didnotofferitemswithinindexersonnativelytypedarrays.
IntelliSense(VisualStudio)andContentAssist(Eclipse)didnotofferorrecognisePIC1itemswithinconditionalexpressions.
IntelliSense(VisualStudio)showedthewrongmembersafteracasttoSUPER.
IntelliSense(VisualStudio)andContentAssist(Eclipse)sometimesdidnotlistanymembersafternamesofunqualifiedtypes.
TheContentAssist(Eclipse)andIntelliSense(VisualStudio)listswouldnotincludeanyoptionsiftherewhereunknownparametertypesinthecode.
SomeIntelliSense(VisualStudio)andContentAssist(Eclipse)proposalsforitemsfromexternalprogramsdidnothaveanydescriptions.
IfthereweremultipleitemswiththesamenamedeclaredinexternalprogramsmtheywerenotofferedcorrectlybyIntelliSense.
IntelliSensenowsupportsconstructinginstancesofthecurrentorparenttypeusingeitherNEWSELForNEWSUPER.
IntelliSenseinVisualStudiowouldsometimesshowthewrongmembersforunqualifiedtypenameswithinpartialclasses.
ContentAssist(Eclipse)andIntelliSense(VisualStudio)nowoffertoqualifyfilerecorditemsbytheirFDitems.
IntelliSense(VisualStudio)andContentAssist(Eclipse)wouldsometimeslistthewrongmembersafteranunqualifiedtypename.
16|ResolvedIssuesEnterpriseServerBacktothelistTheCASGLM.
LCKandESCLRMLs.
cfgfileswerenotgeneratedifthesystemcatalogwasinaspaceypath.
ThesecuritywhendisplayinganyoftheEnterpriseServerconfigurationpagesintheEnterpriseServerAdministrationHTMLGUIhasbeenincreased.
2846702(1102642)The"Renew"commandavailablefromthelefthandsidenavigationpaneintheEnterpriseServerAdministrationHTMLGUIdidnotworkwhenSSLwasenabled.
ApotentialmemorycorruptionwhenaSEPexecutinganEXECCICSDELAYiskilledhasbeenfixed.
ThissituationonlyoccurredwhenTRANCLASSwasenabled.
2865931(1105228)Aninitial3270terminalconnectioncouldhangiftherewasanattempttosendanerrormessagetotheterminalnotyetconnectedandanXAerroroccurredatthesametime.
2865927(1105226)IN-onlymessagesarenowsupportedforCICSWebServices.
2864329(1104991)AnissuecausinganRTS114errorinmfjclsubwhenaCICSprogramexecuteda'display'callinanSSTM-enabledregionhasbeenfixed.
2858651(1104770)ItisnowpossibletoprogrammaticallychangethenameofaWebservicedisplayedintheHSFrecordsbycallingthefollowingentrypoint:call'ES_trace_application_data'usingbyreferencews-trace-block.
Wherews-trace-blockisdefinedasfollows:01ws-trace-block.
03ws-trace-versionpicxcomp-x.
03ws-trace-data.
05ws-trace-typepicxcomp-x.
05ws-trace-textpicx(255).
-ws-trace-versionandws-trace-typemusthaveavalueof1.
-ws-trace-textisrestrictedto255bytesinlength,mustbeterminatedbylow-values(x'00)andmustnothaveanyspacesembeddedinit.
2856234(1103860)WhenusingcassoutfromtheAPIandnotcancellingitbetweencalls,itwaspossibletooverwritethefileoutputfromapreviousinvocationifthe'-d'option(outputtofile)wasnotspecified.
Theproductnowinitializestherequiredenvironmentvariablesoneachinvocationtoensurethisproblemdoesnotoccur.
2852058(1103778)TryingtoaccessESMACinasecureregionnolongerresultsintheapplicationcrashing.
2851933(1103724)OnaCICSstatefulrequest,afterarun-timesystemfailure,atransientSEPcouldloop,produceanRTS114errororanabendCDCDonshutdownduringSDP2.
ThiswascausedbytheATPnotbeingattheexpectedlevelwhenrunningSDP2.
2851618(1103389)Thecasutlcommandlineutilitysupportsanewoption,/n.
Whenusedwith/n,theutilitystartsanewconsole.
logandsavesthecontentsofthecurrentconsole.
logtoanewfile,console.
nnn_switch_date_time(wherennnisanumber).
2851178(1103265)VisualCOBOLandCOBOLServerwithSOAnowincludecastranwiththeCANCELsupport.
2849934(1103037)Credentialsarenowmaskedoutintheformatteddump.
2848888(1102908)AdefaultpasswordforanexternalSecurityManagerconnectionisnolongerusedwhenyouspecifyauseridbutnotapassword.
Thisistohelpavoidlockingouttheuserid.
Also,ifnopasswordhasbeenResolvedIssues|17specified,theEnterpriseServerAdministrationHTMLGUInolongerdisplaysadummyvalueinthepasswordfieldontheSecurityManagerconfigurationpage.
2864790(1105187)Underheavyloads,theESFCA0401Ilogmessageswerenotappearingatthecorrectintervals.
2863222(1104948)RestrictingaccesstotheEnterpriseServerExternalSecurityFacility'sAdminAPIfortheMLDAPESMModulenowworkscorrectlywhenyouuseresourcedefinitionsintheoptionalAdminAPIclass.
2830660(1100636)Withsometypesoftracingenabled,theMLDAPESMModuleforEnterpriseServersecuritywouldsometimesreportthatagroupACEmatchedtheuser'slogongroupwheninfactitdidnotmatch.
ThetracemessagenowcorrectlyindicateswhethertheACEmatchedornot.
WhenusingEnterpriseServersecuritywithLDAP,onsomeplatforms,aresourceaccessrulewithanemptyaccesscontrollist(ACL)couldcauseanRTS114orotherprogramcrash.
Thishasnowbeenfixed.
FileHandlingBacktothelistAninternalfieldusedtostorethecurrentfilestatuswasbeingoverwrittenbytheallocationofabuffer.
Nowwestoreitoffbeforehandsoitsvaluecanberestored,andanaccuratefilestatusreturned.
2868664(1105707)Whencertainin-flightrewrittenrecordswererolledbackattheendofatransaction,theFileHandlerwassettingincorrectvaluesforthelengthfieldinsomerecordsandvariouswarningmessagesweredisplayedduringindexfilevalidation.
2864802(1106106)VBfilesarenowcreatedwiththecorrectlrecl,takingintoaccounttheextraspaceforaprintcharacterwhencreatingthefileheader.
2856899(1104023)FS_CHECK_FILE_EXISTisnowbeingprocessedcorrectlywhencalledwithanenvironmentvariablethatcontainsaFileshareserver-name.
Previously,therequestwasnotbeingsenttotheserver.
2851717(1103253)MemoryisnowcorrectlybeingdeallocatedatendofIMSrollbackrecoveryprocessing;previously,itwasnot.
2840046(1101795)Whenrunningnon-transactionalfilehandling,arecord-lockedstatuswillalsoreturntheprocess-idofthelockingprocesswhenrunonUNIXandusingFCD3.
ThismeansC$LOCKINFOcanalsoreturnthisinformationforMicroFocusfiles.
ThisbehaviordoesnotapplytoFileshare.
2832733(1101061)Therollbackrecoveryprocessisnowworkingasexpected.
2802180(1097066)Forcorruptedfiles,whereacorruptedoffsetoccursbeyondtheendofthefile,younowreceiveavalidationmessageinsteadofaRun-TimeSystemerror114.
2860981(1104576)WhenMFJSORTfailstoopenSYSOUT,itnowgivesanerrormessagetotheconsole,andthenabends.
2861239(1104614)TheMFJSORTE15userexitisnowgivingthecorrectrecordlength.
2858360(1104276)18|ResolvedIssuesACOBOLSORTcalledfromJCLnolongercausesaCOBRT200errormessageinmanagedcode.
2857600(1104073)SORTnowtreatsleadingspacesinZDfieldsaszero,whichemulatesmainframebehavior.
2855141(1103700)TheconversionofPDtoZDisnowgivingcorrectSORTresultsfornegativenumbers.
2854443(1103597)H2cpyBacktothelistH2cpynowsuccessfullyparsescURLheaderfiles.
2858155(1104162)HCOforMicrosoftSQLServerBacktothelistTheOpenESQLpre-compilergeneratedcodehasbeenmodifiedtoperformswaplogicforCOMPfieldsifanSQLCODEof-305or-811isalsoreturned,asdatacanbereturnedwitheitherofthoseSQLCODEs.
2871163(1106063)AnissuewithOpenESQLhandlingcursornamesthatstartwith"CURSOR"hasbeenfixed.
2866507(1105337)AnissuewhereHCOSSwasnotlocatingthecorrectstoredprocedureforaboundstatementinmulti-stepJCLjobshasbeenfixed.
2861657(1104733)WhenusingDIALECT=MAINFRAME,ifaprogramreferencesaDECLAREGLOBALTEMPORARYTABLEbeforethedeclaration,theprecompilernowproducesawarningandnotanerrormessage.
2853667(1103453)IDEBacktothelistCopybookdependenciesarenowshowncorrectlywithinEclipsefor64-bitcompilations.
2866406(1105576)YoucannowcustomizetasktagsfortheCOBOL,JCL,andPL/Ieditors.
2865386(1105306)ApasswordinnolongerrequiredtoestablishanSSHconnectionintheRemoteSystemview.
2863953(1105480)Additionaloptionsarenowcorrectlysavedinthe.
cobolBuildand.
cobolProjfiles.
2863027(1104789)APL/Imacroinvocationusedasastatementparameterisnolongerreportedasanerror.
2862571(1104763)PL/IbackgroundparsenolongerreportsanerrorwhenamacroreplacementstringisaDCLstatementthatendswithasemicolon.
2862568(1104767)Codecoveragereportgenerationnowworkswhereaprojectdependsuponacopylibproject.
2858045(1104184)ResolvedIssues|19TheMFAconnectionsign-ondialogcouldbedisplayedatstartup,itisnowdisplayedwhentheconnectionisbeingestablished.
2857986(1104150)HyperlinkdetectorsdefinedintheEclipsepreferencesfor"TextualEditors"werenotenabledforthePL/IandCOBOLeditors.
2856932(1103984)Theperformanceofthe"UpdatingMicroFocusmodel"job,userinterfaceresponsivenessandmemoryconsumptionhavebeenimprovedwhenfolderscontaininglargenumbersoffilesareaddedtoanEclipseproject.
2856154(1105184)Itisnowpossibletoloadtemplatesincolumns1-7inCOBOLprogramsusingcontentassist.
2855703(1103770)UpdatingtheMicroFocusModelcouldresultinhighCPUandDiskIO.
Thishasnowbeenfixed.
2854512(1103605)Theauth.
plprocessnolongerhangswhentheuserIDisblankornull.
2851049(1103233)Thegenerated.
cobolBuildantscriptsnowcontainstargetnamesusingsimplefilenamesinsteadoffullfilesystempathsfortheFileCompile.
filenametargets.
2847988(1102977)AproblemwiththecoreEclipsecodecouldcauseafullprojectrebuildtooccurwhennotrequired.
Thishasnowbeenfixed.
2816310(1104735)InterfaceMappingToolkitBacktothelistClientgenerationnowworksasexpectedwheninvokedfromtheTeamDeveloperTreeView.
2869050(1105758)AWebServicesfolderisnowcreatedwhencreatingawebserviceinaCOBOLremoteproject,specifyingCREATEXFDasanadditionalprojectdirective.
2849983(1103157)LicensingBacktothelistTheSafeNetinstallernowusestarinsteadofPaX.
Thisistoensurecompatibilityacrossplatforms.
2860254(1104400)MicroFocusDirectoryServerBacktothelistFixedanissuewhereXAopenstringwhichincludedthe"="characterwouldnotdisplaycorrectlyintheEnterpriseServerAdministrationHTMLGUI.
2856722(1103958)IfauserattemptstologintotheMFDSprocessusingavalidIDbutaninvalidpasswordthemessage"ML3073WUnknownuser"isnolongerloggedintheMFDSjournaloutput.
2842321(1102116)20|ResolvedIssuesMVSREXXEmulationBacktothelistThisreleaseprovidesatechnologypreviewsupportfortheDSNREXXcommandsforDB2LUW.
2842140(1102170)OpenESQLBacktothelistAproblemwithSQL(SQLCLRTRANS)thatcausedaCOBOL173runtimeerroronstoredproceduresthatmakeCOBOLcallstoothermoduleshasbeenfixed.
2871330(1106084)AproblemusingSQL(CHECK)withstatementsthatcontainaFOR:hostVariableprefixhasbeenfixed.
2868823(1105704)Inmanagedcodeonly,aproblemwiththeOpenESQLpreprocessorsometimesgeneratingincorrectcodeafterastoredprocedurecallresultedinsomedatabeingreturnedincorrectly.
Thishasbeenfixed.
2868405(1105663)CompilererrorssometimesresultedwhentheSQLCLRwrappergeneratorgeneratedduplicateparameternames.
Thishasbeenfixedbyupdatingthegeneratortocheckforthepotentialofduplicatenamesandchooseanalternateextensiontoinsureuniquenames.
2866086(1105262)TheOpenESQLpre-compilerincorrectlygeneratedcodeforprogramscompiledwithCHARSET(EBCDIC)andSQL(DBMAN=ADO)whenSQLstatementsweregreaterthan4000characters.
2864850(1105064)Previously,theSPDGeneratordidnothandlecorrectlysomeoftheparameterswhichresultedingeneratinganincorrectCOBOLcode.
2864348(1104993)TheOpenESQLcomponentwasupdatedtoresolveanissueexecutingtheHCOSSAssessApplicationMigrationtoolwheneithernoVisualStudioproductwasinstalled,orjusttheVisualStudioIntegratedShellwasinstalled.
2864021(1104951)TheSPDgeneratorincorrectlyhandledquotesaroundtheprocedurename,resultinginacompileerrorofgeneratedCOBOLcode.
Thishasbeencorrected.
2863699(1104906)HCOSSwasimproperlyhandlingUPDATEstatementsthatusesrowconstructorsbasedonasubquery.
Thishasbeenfixed.
2860329(1104628)UsingSQL(DETECTDATE=SERVER)withqueriescontainingsinglequotecharacterssometimesresultedinanerror.
Thishasbeenfixed.
2857619(1104103)TheDCLGENfunctionofOpenESQLAssistantnowsupportsincludingcommentsincopybooksfortheLabelextendedpropertiesonSQLServercolumns.
2856215(1104118)TheSQL(CHECKSP)Compilerdirectivehasbeenaddedtolistofdirectiveswhichyoucansetfromtheproject'sorafile'sproperties.
Also,receivinganerrormessagethattheSPDfilewasnotfoundnolongercausescompilingtohang.
2853668(1103454)ResolvedIssues|21Run-TimeSystemBacktothelistAstatement"MOVETO"nolongerproducesaCOBRT200error.
2869985(1105986)IftheAuditManagerwasunderheavyloadbymanyclientprocessesandwasthenre-cycled,itwaspossiblethattheclientprocesseswouldnotsendthecorrectdetailswhenattachingtothenewAuditManagerprocess,whichwouldcauseAuditManagertocrash.
Thisisnowfixed.
2863509(1104863)PastingofDBCScharactersthathavea2ndbyteofx"E0"isnowworkingcorrectly.
2861398(1104580)AdynamicallyboundapplicationDLLthatusesObjectCOBOLnolongerhangsintermittentlywhenloadedconcurrentlyinmultiplethreads.
2858271(1104328)Anadditionalsub-functionhasbeenaddedtotheCBL_GET_PROGRAM_INFOlibraryroutine.
Thesub-function,number10,returnsaprogram'sfullpath,ornameonly,dependingonflagsettings.
(618769)Detachingfromanimationthatwasstartedusingthedebug_on_errortunablecouldcauseanimationtore-startagainfortheinitialerror-thishasnowbeenresolved.
SetupBacktothelistTheUNIXsetupfilenowsupportstheSuSE12SP1versionofspax.
2866227(1105283)TheInstall.
shscriptnowperformsthecorrectdiskspacecheckstodetermineifthereisenoughspaceonSOLARISSPARCmachinespriortoinstalling.
2854557(1103628)SQL:CobsqlBacktothelistAproblemwithprocessinganSQLstatementwhenitwasonthesamelineasaCOBOLconditionresultedinaCSQL-F-026error.
Thishasbeenfixed.
2864989(1105085)AproblemwithCOBSQLincorrectlyhandlingEXECSQLINCLUDEstatementshasbeenfixed.
2821960(1099586)AproblemwithCOBSQLnotrecognizingorproperlyprocessingasectionthatcomesdirectlyaftercommentlinesandreturninganerrorhasbeenfixed.
2818934(1099169)AproblemwithCOBSQLnotproperlyinvokingcobpre64whenCOBSQLTYPEissettoSYBASEhasbeenfixed.
2794407(1096173)SQL:DB2ECMBacktothelist22|ResolvedIssuesAproblemwiththeHCOimporttoolincorrectlyhandlingpackeddecimalsgreaterthan18digitshasbeenfixed.
Ithasbeenupdatedtonowhandlepackeddecimalsupto26digits.
2866180(1105278)TheDB2pre-compilersometimesincorrectlyrestoredtheRETURN-CODEafteraSQLstatementwasexecuted.
2857403(1104045)SQL:OpenESQLBacktothelistTheINSENSITIVEoptionisnolongeravailablefortheSTATICREADONLYdirective.
2871907(1106251)AproblemwitherrormessagehandlingintheODBCruntimeforSAVEPOINTstatementshasbeenfixed.
2870141(1105889)AproblemwithHCOSSincorrectlyrenamingparenthesizedexpressionsinselectlistshasbeenfixed.
2869320(1105787)SQL(SPTHROWEXCPETION)nowthrowsanexceptiononlyforerrorsthatresultwhenSQLServerterminatesthecurrenttransaction.
2868965(1105736)SQL(DETECTDATE)wouldsometimesincorrectlymatchdatesandtimesinEuropeanandUSAformats.
2868282(1105622)AproblemwiththeOpenESQLpreprocessorfailingtoproperlycheckthelengthofanSQLstatementproperly,resultingina153RTSerror,hasbeenfixed.
2867772(1105549)AproblemwithOpenESQLSQLEntryandExitnotshowingintraceoutputhasbeenfixed.
ThetraceoutputisnowsenttoAuxiliarytraceduringCICStransactionexecution.
2867423(1105490)AproblemrunningSQLCLRstoredproceduresonheavilyloadedservershasbeenfixed.
2865750(1105229)AproblemwithOpenESQLallocatingduplicateservercursornamesforpositionedupdatesinstoredprocedureshasbeenfixed.
2865750(1105230)AproblemwiththeOpenESQLAssistantgeneratingcopybookswithTINYINTcolumnsasPICS9(2)COMP-5ratherthanPICS9(4)COMP-5hasbeenfixed.
2865378(1105139)HCOSSnowcorrectlyhandleshexadecimalconstantstrings.
2865026(1105146)AproblemwiththeOpenESQLpreprocessorwhencompilingwiththeCHARSET(EBCDIC)directivesometimesgeneratingCOBCH0002/COBCH0302compilationerrorsforprogramsthatusedarraysashostvariablesinSQLstatementshasbeenfixed.
2864585(1105039)OpenESQLnowsupportsDESCRIBECURSORstatements.
2863839(1104939)AproblemwithHCOSShandlingtheSUBSTRINGfunctionwhenonlythreeparametersaresuppliedhasbeenfixed.
ResolvedIssues|232862754(1105122)HCOSSnowcorrectlyhandlestheDB2TRUNCATEscalarfunctionwhenthefunctioniscalledwithonlyoneparameter.
2862064(1104674)HCOSScouldsometimesreportaSQL(CHECK)errorasawarninginsteadofanerror.
2861897(1104668)TheODBCpre-compilernowswapsarrayvariablesusingDOUNTILloopssimilarlytohowitdoesthisforCOBOL.
Thisconsiderablyreducesthenumberofstatementsgeneratedforarrayvariables.
2861580(1104613)HCOSSnowcorrectlysetsSQLCODE=100forarowsetfetchthatretrievesfewerrowsthanthehostarraysize.
2861570(1104629)HCOSSnowhandlescorrectlyFETCHFIRSTandORDERBYclausesinqueriesthatusesetoperators.
2861567(1104751)AproblemwithOpenESQLincorrectlyhandlingDBCASTexpressionsthatuseFORBITDATAhasbeenfixed.
2861516(1104689)HCOSSnolongertrimstrailingspacesautomaticallyfrominputhostvariableswhenSQL(DIALECT=MAINFRAME)isset.
2859565(1104692)Previously,youcouldincorrectlyreceivetruncationwarningsforoutputparametersofOraclestoredprocedurecallsthatarecharacterfieldsnarrowerthan19characters.
2859200(1104598)UsingMySQLODBC5.
6orlaterwithOpenESQLinVC/ED2.
3orlatercausedanRTS114error.
Thishasbeenfixed.
2858980(1105338)ProblemswiththeOpenESQLAssistantthatcausedthe"nocolumnsintable"errorhavebeenfixed.
2856643(1103936)AproblemwithapplicationscompiledwiththeSQL(INIT=PROT)directivecausedEnterpriseServer.
NETjobstohang.
Thishasbeenfixed.
2856198(1104002)HCOSSnowsupportsDB2RELEASESAVEPOINTstatementsandproblemswithglobaltemporarytablehousekeepingandROLLBACKTOSAVEPOINTstatementshavebeenfixed.
2856008(1103831)TheSPTHROWEXCEPTIONSQLcompilerdirectiveoptionhasbeenaddedtoimprovediagnosticsreturnedtocallingapplicationsfromCOBOLSQLCLRstoredproceduresinthecaseofanimplicitSQLServerrollbackonatransaction.
2854780(1103670)AproblemwithOpenESQLnotallowing'NO'tobeusedasanSQLidentifierhasbeenfixed.
2854592(1103598)AproblemwiththeJDBCruntimeincorrectlysettingSQLCODEonrepeatexecutionofEXECUTEIMMEDIATEstatementshasbeenfixed.
2854393(1103713)AproblemprocessingtheEXECADODATATABLEBINDstatementresultedinaCOBES0100error.
Thishasbeenfixed.
2854004(1103529)24|ResolvedIssuesSomeproblemswithDB2-styleresultsetswhereallocatedcursorsarereusedwithoutbeingclosedandwherecursorsmustremainopenacrossmultiplecallstothesamestoredprocedurehavebeenfixed.
2853859(1103520)EXCELtablenamesenclosedinsinglequoteswereincorrectlyhandledbytheDCLGENfunctionoftheOpenESQLAssistant,resultinginanunhandledexception.
Thishasbeenfixed.
2853832(1103555)TheCOBOLRun-TimesystemnowsuccessfullyloadstheODBCRW64.
DLLfilewhenanativeCOBOLapplicationisbeingcalledfromaC#application.
2853578(1104167)TheOpenESQLdirectivesSQLCLRTRANSandSPDISPLAYnowworkcorrectlyforEnterpriseServer.
NETbatchjobs.
2853439(1103430)AnHCOSSproblemtransformingSQLstatementsthatcontainbothXMLandCONCAToperatorshasbeenfixed.
2853412(1103426)TheOpenESQLODBCruntimehasbeenupdatedtoensurethatconnectionsareclosedafteraDISCONNECT.
2853341(1103461)HCOSSnowcorrectlyhandlesWITHDEFAULTclausesintabledefinitionsthatdonotspecifyadefaultvalue.
2852996(1103431)HCOSSnowsupportsDB2DECLAREGLOBALTEMPORARYTABLEstatementsthatuseASandLIKE.
2850369(1103793)TheSQL(PROCOB)directiveoptionfortheOpenESQLpreprocessornowsupportsPro*COBOL'ssyntaxforcallingdatabasefunctionswhenSQL(DBMAN=ADO)isalsoset.
Inaddition,aproblemthatpreventedDMLfrombeingexecutedinuser-definedfunctionshasbeenfixed.
2849318(1102957)TheSQL(PROCOB)directiveoptionfortheOpenESQLpreprocessorhasbeenupdatedtoprocessOraclegroupedhostarraysyntax.
2849301(1102956)TofixaproblemwiththeDETECTDATEdirectivenotallowingruntimecontrolofdatetimedataformatting,theOpenESQLSETandSETOPTIONstatementshavebeenenhancedtoallowdatetimedataformattingbehaviorequivalenttotheOpenESQLDATE,TIME,DATEDELIM,TIMEDELIM,TSTAMPSEP,andDETECTDATEdirectives.
AproblemwithpositionedupdatewhenusingthelatestreleaseofthePostgreSQLADO.
NETproviderhasbeenfixed.
ThenamespaceusedbytheJDBCruntimeforOpenESQLhaschangedfromMicroFocus.
COBOL.
SqlJVMtocom.
microfocus.
openesql.
The32-bitWindowsDLLnamesusedinOpenESQLJESprogram-aliasmappinghavebeenchangedasfollows:SQLTP232toSQLTP2SQLUTB32toSQLUTB.
UsingtheCHARSET(EBCDIC)directivewithOpenESQLsometimescausedthepreprocessortogenerateincorrectcodeforconvertingSQLCAfields,resultinginCONNECTfailures.
Thishasbeenfixed.
TheSEThost-variableembeddedSQLstatementhasbeenaddedtoOpenESQLtoenableyoutoquerythecurrentconnectionnameanddatabasetype.
CursorprefetchbehaviorinOpenESQLhasbeenmademoreconsistentwithupdatestothePF_RO_CURSORandPF_UPD_CURSORprimitivecompilerdirectiveoptionsforBEHAVIOR,andtheMARScompilerdirectiveoption.
Seeyourproductdocumentationforcompletedetails.
ResolvedIssues|25SQLOptionforDB2BacktothelistTheSQLNvalueinSQLDAisnolongermodifiedwhenaFETCHisperformedusinginvalidSQLVARSQLDATApointers.
2854157(1103541)ARun-TimeSystemerror"-84UNACCEPTABLESQLstatement"couldoccurwhentherewasaVARCHARhostvariabledefinitionwithanextra49levelFILLERstatement.
2867096(1105432)ModifiedtheXDBprecompilertonolongergenerateCOBSQ0413SerrorsiftheprogramiscompiledwithdirectiveXDB(BEHAVIOR=STACKED).
2855151(1103687)TheXDBSetuputilitysupportscreatingauserXDB.
INIintheuser'slocalapplicationspace.
2839228(1101904)Anissuewithscalarfunctionsinvokingaggregatefunctionsinvokingmorescalarfunctionswithembeddedhostvariableshasbeenfixed.
2869971(1105862)AproblemthatresultedinXDBServerprovidingincorrectSORTresultswhenusingROWSETPOSITIONINGhasbeenfixed.
2867209(1105454)ImplicitcastingisnowcarriedoutforSUBSTR()argumentsintheV10XDBengine.
2865204(1105108)Aproblemwithuninitializedquerycommonspacegeneratinganillegaldecimaldataerrorhasbeenresolved.
2860427(1104449)XDBServerhasbeenupdatedtocorrectlyreturnresultsfromXDBSQLwhencertainstatementcombinationsareexecuted.
2856158(1103932)SomeSQLqueriesthatreturndataonthemainframedidnotreturndatainXDB.
ThesequeriesnowreturndatainXDBaswell.
2853378(1103442)TheXDBSQLoptimizerhasbeenupdatedtouseanewcompoundindexroutine.
Thiscorrectsaproblemthatcausedathreadaccessviolationwhenprocessingaverylargejoinrestrictionqueuethathadoverflowedtodisk.
2853078(1103385)AproblemwiththeXDBservercorruptingarowafterexecutingaprogramthatusesaFORUPDATEcursorhasbeenfixed.
2850725(1103117)MultipleissuesthatoccurredwhenthereservedwordSELECTwasusedasanidentifierhavebeenresolved.
2849898(1103024)AproblemcausingtheSQLresulttobeinconsistentwhenusingtheSELECT.
.
.
INclausehasbeenfixed.
2849892(1103103)Aproblemwhencreatingauniqueindex,thatresultedinan"x020:Syntaxerror.
Lastsymbolreadwas'INCLUDE'"errormessage,hasbeenfixed.
26|ResolvedIssues2847745(1102766)SQLOptionnowsupportsPARTITIONBYSIZEsyntaxforDB2version9.
2845161(1102494)XDBnolongerthrowsanX405errormessagewhenitencountersaNOToperatorthatispartofacompoundpredicate.
2640689(1088784)XMLSyntaxSupportBacktothelistInsomescenarios,XMLPARSEreturnedanRTS114errorwhileparsingcertainXMLdocuments.
2851143(1103185)WhenreadinganemptyXMLdocument,thereturnedfilestatusisnow-7.
2851074(1103216)ResolvedIssues|27OtherIssuesResolvedinThisReleaseThenumberslistedaretheSupportIncidentNumbersfollowedbytheReportedProblemIncident(RPI)number(inparentheses).
2865238(1105114)2871930(1106185)2866567(1105346)2865516(1105153)2865065(1105097)2857117(1104003)2872217(1106234)2864576(1105124)2855891(1103807)2864100(1104959)2867120(1105479)2865687(1105211)2864343(1105019)2858008(1104163)2858007(1104161)2835721(1101500)2835605(1101499)2858091(1104136)2865419(1105238)2864875(1105074)2861263(1104753)2859986(1104407)2855942(1103906)2679133(1093595)2852255(1104353)2856233(1103855)2867934(1105578)2867215(1105455)2866174(1105419)2858808(1104227)2855088(1103672)2853477(1103462)2852874(1103543)2839669(1101704)2836259(1101305)2808029(1098883)2790796(1095836)2854829(1103653)2854739(1103627)2866458(1105348)2865807(1105205)2864327(1104989)2862599(1104785)2848016(1102774)2843761(1102734)2841092(1101887)2865193(1105135)2864092(1106070)2859740(1104343)2859539(1104350)2856245(1103972)2855704(1104105)2855440(1103871)2853585(1103448)2852872(1103696)2852872(1103930)2852872(1103931)2851306(1103352)2840161(1101839)2799183(1096680)2863024(1104786)2853074(1103489)2848947(1103100)2816310(1104173)2859923(1104371)2650949(1090062)2854470(1103640)2857870(1104107)2809343(1099937)2858035(1104156)2856499(1104222)2857318(1104188)2858539(1104204)2856795(1103963)2840704(1103249)2863482(1104862)2861561(1104610)2860719(1104512)2858941(1104253)2858723(1104229)2856941(1103977)2856206(1103880)2861649(1104679)2853710(1103578)2867842(1105600)2865028(1105119)2860212(1104480)2854400(1103587)2852486(1103340)2842820(1103533)2855179(1103705)2855179(1103707)2819868(1099861)2865350(1105129)2864599(1105025)2853376(1103486)2855231(1103701)2870740(1106000)2858161(1104152)2864758(1105772)2856295(1103875)2839181(1101830)2864619(1105054)2861296(1104593)2860006(1104387)2854108(1104290)2848917(1103264)2838891(1101791)2648290(1089566)2864197(1105004)2852655(1103333)2869703(1105832)2869126(1105760)2852996(1103913)2859001(1104312)2869594(1105948)2867462(1105499)2866779(1105567)2865650(1105214)2865630(1105243)2865078(1105100)2865051(1105317)2865003(1105132)2863175(1104845)2860863(1104746)2860785(1104563)2859507(1104314)2859155(1104316)2859044(1104282)2857023(1104176)2857021(1103995)2856592(1104053)2852281(1103298)2818259(1099422)2865602(1105177)2863239(1105044)2861423(1104585)2858787(1104233)28|OtherIssuesResolvedinThisRelease2869763(1105896)2851107(1103173)OtherIssuesResolvedinThisRelease|29InstallationBeforeInstallingDownloadingtheProduct1.
UsethedownloadlinksinyourElectronicProductDeliveryemail.
FormoreinformationfollowthelinksfortheinstallationinstructionsandtheEndUserLicenseAgreement.
OnWindowsSystemRequirementsforVisualCOBOLforEclipse(Windows)HardwareRequirementsVisualCOBOLhasthefollowingrequirementsinadditiontotherequirementsofEclipse.
SeetheEclipsedocumentationfordetailsofitsrequirements.
Thediskspacerequirementsare,approximately:VisualCOBOLSentinelRMSLicenseManager3.
7GB75MBNote:ThediskspacerequirementsincludethesizeoftheEclipseIDEandtheversionofJavaandthe.
NETFrameworkprovidedwiththeVisualCOBOLsetupfile.
Thisincludesthespaceneededtocacheinformationlocallysothatyoucanmodifytheinstallationwithouttheoriginalsourcemedia.
OperatingSystemsSupportedForalistofthesupportedoperatingsystems,checktheProductAvailabilitysectionontheMicroFocusSupportLineWebsite:http://supportline.
microfocus.
com/prodavail.
aspx.
Note:VisualCOBOLenablesyoutoproduceboth64-bitand32-bitapplicationson64-bitoperatingsystems.
TheEnterpriseServerfeatureisnotsupportedonWindowsXP.
SoftwarerequirementsNote:ThisproductincludesOpenSSLversion1.
0.
1p.
Thesetupfilewillcheckyourmachineforwhethertheprerequisitesoftwareisinstalledandwillinstallanymissingprerequisitesandtheproductcomponents.
EclipserequirementsThesetupfileinstallsVisualCOBOLandEclipse4.
4.
2.
30|InstallationSeeInstallingVisualCOBOLintootherinstancesofEclipseforinstructionsonhowtoinstallVisualCOBOLintootherinstancesofEclipseinstalledonyourmachine.
Note:IfyouareinstallingVisualCOBOLintoEclipse4.
5,youmustinstalltheEclipseTargetManagementpluginsintotheEclipseIDEforJavaEEDeveloperspackage(32-bit):1.
ClickHelp>InstallNewSoftwareinyourEclipse4.
5andaddanewrepositoryforthelocationhttp://download.
eclipse.
org/tm/updates/4.
0.
2.
ExpandRSE3.
8MainFeatures,checkRSETerminalsUI(Deprecated)andcompletetheinstallationoftheplugin.
VisualCOBOLdoesnotsupportthe64-bitEclipse.
Youcan,however,usethe32-bitEclipsetocreateboth32-bitand64-bitapplications.
VisualCOBOLrequiresa32-bitJavainstallation.
SoftwarerequirementsOracle'sJavaPlatform,EnterpriseEdition(JavaEE)Java7orJava8isrequiredtoexecuteCOBOLJVMcodeandfornativeCOBOLandJavainteroperability.
YoucandownloadOracle'sJavaEEfromOracle'swebsiteandinstallitanywhereonyourmachine.
Note:IfJava7isinstalledonyourmachine,toskipinstallingJava8,runtheSetupfilewiththeskipjre=1commandlineoption.
Thesetupfilealsoinstalls.
NETFrameworkv4.
5.
2andtheMicrosoftVisualC++2010and2012Redistributables.
SeetheJavaSupportConsiderationsfortheEclipseIDEintheKnownIssuesandRestrictionssectioninyourproducthelpforconsiderationsthatapplytousingtheEclipseIDEandJava.
Important:Thisreleaserequiresversion10000.
2.
990orlateroftheMicroFocusLicenseAdministrationtool.
Forlocalservers,youdonotneedtoinstallitseparately,asthesetupfileinstallsanewVisualCOBOLclientandanewlicensingserveronthesamemachine.
Ifyouhaveanetworkserver,youmustupdatethelicenseserverbeforeinstallingtheproductastheclientisnotabletocommunicatewithlicenseserversofversionsolderthan10000.
2.
660.
OnWindows,youcanchecktheversionofyourlicenseserverbyclickingHelp>AboutintheMicroFocusLicenseAdministrationtool.
TochecktheversionofthelicenseserveronUNIX,run/var/microfocuslicensing/bin/mfcesveror/var/microfocuslicensing/bin/cesadmintool.
sh.
YoucandownloadthenewversionofthelicenseserversoftwarefromtheMicroFocusSupportLineWebsite:http://supportline.
microfocus.
com.
AdditionalSoftwareRequirementsonWindowsToensurefullfunctionalityforsomeVisualCOBOLfeatures,youmightberequiredtoobtainandinstalladditionalthird-partysoftwareinadditiontotheprerequisitesoftwareinstalledautomaticallybytheVisualCOBOLsetupfile.
ClickheretoseethisinformationintheMicroFocusInfocenter.
ProductCo-ExistenceNote:ThefollowingappliestoWindowsonly.
VisualCOBOLandCOBOLServercannotcoexistonthesamemachine.
VisualCOBOLandEnterpriseDevelopercannotcoexistonthesamemachineregardlessofwhichIDE(VisualStudioorEclipse)youinstall.
Installation|31InstallationRestrictionsandRequirementsBeforestartingtheinstallationyoushouldconsiderthefollowing:VisualCOBOLandEnterpriseDevelopercannotcoexistonthesamemachine.
Youneedtobeloggedinwithauser-IDthathaswriteaccesstotheregistrystructureunderHKEY_LOCAL_MACHINE,HKEY_CLASSES_ROOT,andHKEY_CURRENT_USERsotheinstallationsoftwarecansettheenvironmentappropriately.
YoualsoneedtobeloggedonwithAdministratorprivileges.
Beforeinstallingthisproduct,makesurethatanyexistingMicroFocusDirectoryServer(MFDS)orCCITCP2Windowsservice(onWindows)oraprocess(onUNIX)fromanexistingproductisstoppedanduninstalled.
OnWindows,dothisasfollows:1.
StoptheMFDSandCCITCP2,usingeithertheWindowsServiceManagementConsoleGUI(services.
msc)orfromacommandlinepromptbytyping:netstopmf_ccitcp2OnlyoneinstanceoftheMFDSorCCITCP2servicecanrunonaWindowsmachine.
2.
UninstalltheMFDSorCCITCP2service.
ForMFDS,fromacommandlinepromptenter:mfds-uForCCITCP2:ccitcp2-uTorunanearlierversionofMFDSasaserviceafteryouhaveinstalledalaterversion:1.
StopanduninstalltheMFDSservice,asdescribedabove.
2.
Reinstalltheearlierversion,asfollows:a.
OpenaVisualCOBOLcommandprompt.
b.
Installtheservice.
Enterthefollowingcommand:mfds-ic.
Starttheservice.
Enterthefollowingcommand:netstartmf_ccitcp2Note:Thetwoversionsusedifferentpathsforenvironmentandregistryvalues,sothelistofconfiguredenterpriseserversmightbedifferentdependingonwhichversionhasbeenstarted,since,bydefault,differentMFDSdatarepositoriesareused.
MFDS5.
1andlaterareabletoimportoruseEnterpriseServerconfigurationdatageneratedbyearlierversionsofMFDS,but5.
0orearlierversionsofMFDSmightnotbeabletoreaddatageneratedbylaterversions.
ItispossibletorunMFDSfromacommandprompt("mfds")ratherthanasaservice,butbydefaultthe"mfcobol"portisused(86)andthiscanonlybeusedbyoneprocessatatimeOnUNIXSystemRequirementsforVisualCOBOLforEclipse(UNIX)HardwareRequirementsforVisualCOBOLforEclipseVisualCOBOLhasthefollowingrequirementsinadditiontotherequirementsofEclipse.
SeetheEclipsedocumentationfordetailsofitsrequirements.
Thediskspacerequirementsareapproximately:32|InstallationPlatformInstallertypeSetupfilesize(MB)Diskspacerequiredfortheinstallation(GB)Diskspacerequiredforrunningtheproduct(GB)SentinelRMSlicenseserver(MB)x86-64runningRedHatLinuxMicroFocusinstaller9233.
691.
8446x86-64runningSUSESLESMicroFocusinstaller9273.
711.
8546OperatingSystemsSupportedNote:Youcanproduceboth64-bitand32-bitapplicationson64-bitoperatingsystems.
Foralistofthesupportedoperatingsystems,checktheProductAvailabilitysectionontheMicroFocusSupportLineWebsite:http://supportline.
microfocus.
com/prodavail.
aspx.
SoftwareRequirementsEclipserequirementsVisualCOBOLonlysupportsthe32-bitEclipseIDEandrequiresa32-bitJavainstallation.
VisualCOBOLdoesnotsupportthe64-bitEclipse.
Youcan,however,usethe32-bitEclipsetocreateboth32-bitand64-bitapplications.
ThesetupfileinstallsVisualCOBOLandEclipse4.
4.
2.
Aftertheinstallation,youcaninstalltheVisualCOBOLplug-inintootherinstancesofEclipseavailableonthesamemachine.
Thesupportedversionsare4.
2,4.
3,4.
4,and4.
5forthe32-bitEclipseonly.
SeeInstallingVisualCOBOLintootherinstancesofEclipseforinstructions.
Note:IfyouareinstallingVisualCOBOLintoEclipse4.
5,youmustinstalltheEclipseTargetManagementpluginsintotheEclipseIDEforJavaEEDeveloperspackage(32-bit):1.
ClickHelp>InstallNewSoftwareinyourEclipse4.
5andaddanewrepositoryforthelocationhttp://download.
eclipse.
org/tm/updates/4.
0.
2.
ExpandRSE3.
8MainFeatures,checkRSETerminalsUI(Deprecated)andcompletetheinstallationoftheplugin.
OthersoftwarerequirementsBeforeinstallingthisproduct,youmusthavethefollowingsoftwareinstalledonyourcomputer:Theunziputilityisrequiredbythesetupfile.
Thepaxarchivingutilityisrequiredbythesetupfile.
PaxisdistributedwithmostUNIX/Linuxsystemsbut,ifitismissing,youmustinstallitseparately.
Toverifypaxisinstalled,runpax--helporpax--versionatthecommandline.
Requiredlibraries-the32-bitlibrarieslistedbelowarerequiredonboth32-bitandon64-bitOperatingSystemsforthisproducttoinstallandworkcorrectly.
Ifinstallingona64-bitOS,the32-bitlibrariesarenotinstalledbydefaultandmustbeinstalledbeforeyoustarttheinstallation.
Installation|33LibraryPlatformSUSE11SUSE12RedHat6.
xRedHat7glibc-locale-32bitXXgtk2(libgtk2,gtk2-tools-32-bit)XlibXcomposite1-32bitXlibgdk_pixbuf-2_0-0-32bitXgdk-pixbuf-query-loaders-32bitXlibjasper1-32bitXgtk2-x11(libgthread-2_0-0-32bit)XlibXtst6-32bitXglibc-*.
x86_64XXglibc-*.
i686XXlibgcc-*.
x86_64XXlibgcc-*.
i686XXlibstdc++-*.
x86_64XXlibstdc++-*.
i686XXgtk2-*.
x86_64XXgtk2-*.
i686XXgtk2-engines.
*.
i686Xgtk2-engines.
*.
s390Xgtk2-engines.
*.
x86_64XXlibXtst-*.
x86_64XXlibXtst-*.
i686XXlibcanberra-gtk2-*.
x86_64XXlibcanberra-gtk2-*.
i686XXlibgnome.
x86_64XXlibgnome.
i686XXPackageKit-gtk-module-*.
x86_64XX34|InstallationLibraryPlatformSUSE11SUSE12RedHat6.
xRedHat7PackageKit-gtk-module-*.
i686XPackageKit-gtk-module-*.
s390XPackageKit-gtk3-module-*.
i686XPackageKit-gtk3-module-*.
s390Xwebkitgtk.
x86_64Xwebkitgtk.
i686Xwebkitgtk3.
x86_64Xwebkitgtk3.
i686Xxterm(anyversion)XXgdb*XXXX*Additionallibrariesrequiredtousethecore_on_errorruntimevariable.
Thegdbpackages(fortheGNUProjectDebugger)canbeinstalledfromtheinstallmediaforyourOS.
**OperatingsystemlibrariesrequiredforPL/IsupportonbothSUSEandRedHat.
VisittheRedHatWebsiteformoreinformation.
Xterm,theterminalemulatorfortheXWindowSystem,ispartofyourUNIX/Linuxdistributionbutisnotinstalledbydefault.
UseyourUNIX/Linuxinstallationmediatoinstallit.
Oracle'sJavaPlatform,EnterpriseEdition(JavaEE)7orJava8isrequiredtoruntheEclipseIDE,toexecuteCOBOLJVMcodeandfornativeCOBOLandJavainteroperability.
ThesetupfileinstallsJava8u5132-bit.
YoucandownloadOracle'sJavaEEfromOracle'sWebsiteandinstallitanywhereonyourmachine.
Note:OnLinux,the32-bitversionofJavaisrequiredtoinstallanduseVisualCOBOLforEclipse.
Whenyoustarttheinstallation,ifthe64-bitversionofJavaisalreadyinstalledonyourLinuxmachine,youmightnotbeabletoinstallVisualCOBOL.
ThisisaknownissuewiththeOracleJavainstallersforLinuxwhichpreventyoufrominstallingboththe32-bitandthe64-bitversionsofJavaonthesamemachine.
Toworkaroundthisproblem:Downloadthe32-bitJavadistributioninacompressed.
tarformatfromtheOracleWebsite.
Untarthedistributionintoalocationdifferentfromtheoneusedforthe64-bitJavaversion.
Forexample,untarin/usr/local/java32andnotin/usr/local/java.
SetJAVA_HOMEandLD_LIBRARY_PATHtothe32-bitversionofJavasothatitisusedtoinstallandrunVisualCOBOL.
Beforeyoustarttheinstallation,youneedtosettheenvironmentasfollows:YouneedtosettheJAVA_HOMEenvironmentvariable.
Wheninstallingtheproduct,setthisvariabletoa32-bitJavainstallationortheinstallationterminates.
Forexample,executethefollowing:JAVA_HOME=java_install_dirwherejava_install_diristhepathtotheJAVAinstallationdirectorysuchas/usr/java/javan.
nYouneedtoadd$JAVA_HOME/bintoyoursystemPATHvariable.
Todothis,execute:exportPATH=$JAVA_HOME/bin:$PATHInstallation|35YouneedtosettheLANGenvironmentvariabletopickuplocalizedmessages.
TheLANGsettingsareEnglishandJapaneseonly.
Important:Thisreleaserequiresversion10000.
2.
990orlateroftheMicroFocusLicenseAdministrationtool.
Forlocalservers,youdonotneedtoinstallitseparately,asthesetupfileinstallsanewVisualCOBOLclientandanewlicensingserveronthesamemachine.
Ifyouhaveanetworkserver,youmustupdatethelicenseserverbeforeinstallingtheproductastheclientisnotabletocommunicatewithlicenseserversofversionsolderthan10000.
2.
660.
OnWindows,youcanchecktheversionofyourlicenseserverbyclickingHelp>AboutintheMicroFocusLicenseAdministrationtool.
TochecktheversionofthelicenseserveronUNIX,run/var/microfocuslicensing/bin/mfcesveror/var/microfocuslicensing/bin/cesadmintool.
sh.
YoucandownloadthenewversionofthelicenseserversoftwarefromtheMicroFocusSupportLineWebsite:http://supportline.
microfocus.
com.
AdditionalSoftwareRequirementsonLinuxandUNIXToensurefullfunctionalityforsomeVisualCOBOLfeatures,youmightberequiredtoobtainandinstalladditionalthird-partysoftwareinadditiontotheprerequisitesoftwareinstalledautomaticallybytheVisualCOBOLsetupfile.
ClickheretoseethisinformationontheMicroFocusInfocenter.
UNIXandLinuxInstallerIssuesInstallingonLinuxOnLinux,the32-bitversionofJavaisrequiredtoinstallanduseVisualCOBOLforEclipse.
Whenyoustarttheinstallation,ifthe64-bitversionofJavaisalreadyinstalledonyourLinuxmachine,youmightnotbeabletoinstallVisualCOBOL.
ThisisaknownissuewiththeOracleJavainstallersforLinuxwhichpreventyoufrominstallingboththe32-bitandthe64-bitversionsofJavaonthesamemachine.
Toworkaroundthisproblem:Downloadthe32-bitJavadistributioninacompressed.
tarformatfromtheOracleWebsite.
Untarthedistributionintoalocationdifferentfromtheoneusedforthe64-bitJavaversion.
Forexample,untarin/usr/local/java32andnotin/usr/local/java.
SetJAVA_HOMEandLD_LIBRARY_PATHtothe32-bitversionofJavasothatitisusedtoinstallandrunVisualCOBOL.
LicenseServerYouneedtoconfigurethecomputerhostnametoensurethelicenseserverwillstartproperly.
Toavoidperformanceissues,"localhost"andthecomputerhostnamemustnotbothbemappedtoIPaddress127.
0.
0.
1.
Youshouldonlymap"localhost"toIPaddress127.
0.
0.
1.
Thefollowingisanexampleofhowtospecifytheseentriescorrectlyintheetc/hostsfile:127.
0.
0.
1localhost.
localdomainlocalhostIPmachinelonghostnamemachineshorthostnamewhereIPistheuniqueIPaddressofthecomputerinxx.
xx.
xx.
xxformat.
BasicInstallationTheinstructionsinthissectionapplywhenyouareperformingabasicinstallationofthisproductforthefirsttime.
Ifyouareanadministrator,youcanperformabasicinstallationonalocalmachinebefore36|Installationperformingamoreadvancedinstallationwhenrollingouttheproducttodeveloperswithinyourorganization.
Forconsiderationswheninstallingthisproductasanupgrade,foradditionalinstallationoptionsornon-defaultinstallations,seeAdvancedInstallationTasksinyourproductHelp.
OnWindowsInstallingonWindowsNote:Thisversionoftheproductisafullinstall.
IfyouhaveanearlierversionofVisualCOBOLinstalledonyourmachine,checkInstallingasanUpgradebeforeyoustarttheinstallation-seeAdvancedInstallationTasks.
ThesearethestepstoinstallVisualCOBOL:1.
Runthevce_232.
exefileandfollowthewizardinstructionstocompletetheinstallation.
Bydefault,thisinstallsVisualCOBOLinthe%ProgramFiles(x86)%\MicroFocus\VisualCOBOLfolderandinstallsafullversionofEclipse4.
4.
2,withtheMicroFocuspluginsalreadyinstalled,intheC:\Users\Public\MicroFocus\ProductName\eclipsedirectory.
ThesetupfileinstallsanymissingprerequisitesoftwareaslistedinthetopicSoftwareRequirements.
Note:SeeAdvancedInstallationTasksforinformationaboutnon-defaultinstallationtasks.
Forexample,ifyouhaveJava7installedonyourmachineandyouwanttoskipinstallingJava8,runthesetupfilefromthecommandlinewiththeskipjre=1commandlineoption.
OnUNIXInstallingthesoftwareNote:MicroFocusofferstwotypesofinstallersonUNIXandLinux-aproprietaryMicroFocusinstallerforinstallingVisualCOBOLonUNIXandLinuxandastandardRPM(RPMPackageManager)installerforinstallingVisualCOBOLonLinux.
SeeyourproductHelpforinstructionsonhowtousetheRPMinstaller.
ThesearethestepstoinstallthisproductusingtheMicroFocusinstaller:1.
Giveexecutepermissionstothesetupfile:chmod+xsetup_visualcobol_deveclipse_2.
3_update2_platform2.
Runthesetupfilewithsuperuserpermissions:.
/setup_visualcobol_deveclipse_2.
3_update2_platformIfyoudon'trunthisassuperuser,youarepromptedtoenterthesuperuserpasswordduringtheinstall.
TheCOBOLenvironmentisinstalledbydefaultinto/opt/microfocus/VisualCOBOL,(COBDIR).
AfullversionofEclipse,withtheMicroFocuspluginsalreadyinstalled,ispresentinthe$COBDIR/eclipsedirectory.
Toinstallinadifferentlocationusethe-installlocation="Location"parametertospecifyanalternativedirectorylocation.
Forexample:.
/setup_visualcobol_deveclipse_2.
3_update2_platform-installlocation="fullpathofnewlocation"Installation|37Note:Youcanusevariablesorthetildesyntaxforthepathfor–installlocation.
Forexample,thefollowingexamplesareequivalent:-installlocation="/home/myid/installdir"-installlocation="~myid/installdir"-installlocation="~/installdir"-installlocation="$HOME/installdir"Youcanseedetailsaboutwhichadditionalparameterscanbepassedtotheinstallscriptifyouenterthe-helpoption.
Note:TheinstallationofthisproductcouldaffecttheSafeNetSentinellicensedcomponentsrunningonyourmachine.
Duringinstallationlicensingisshutdowntoallowfilestobeupdated.
Toensuretheprocessesrunningonyourmachinearenotaffected,youneedtousethe-skipsafenetoption,whichskipstheinstallationofSafeNet:.
/setup_visualcobol_deveclipse_2.
3_update2_platform-skipsafenetToprotecttheSafeNetSentinelinstallationfromaccidentalupdatingyoucancreateanemptyfilenamedSKIP_SAFENET_INSTALLin/var/microfocuslicensing/asfollows:touch/var/microfocuslicensing/SKIP_SAFENET_INSTALLWhilethefileispresent,theSafeNetinstallerdoesnotmakechangestotheinstallationorshutdowntherunninglicensedaemons.
Iflicensingneedstobeupdatedlater,removethefileandinstallSentinelRMSservermanually.
SettinguptheenvironmentWhenyouhaveinstalledtheproduct,youneedtosettheenvironmentasdescribedbelow.
1.
Tosetupyourproduct,execute:.
/opt/microfocus/VisualCOBOL/bin/cobsetenv2.
Toverifythatyourproductisinstalled,execute:cob-VImportant:Thesecommandssettheenvironmentonlyforthecurrentshell.
Youneedtoexecutethemforeachnewshellthatyoustart.
Toavoidhavingtoruncobsetenvforeveryshell,addthesecommandstotheshellinitializationfiles(suchasetc/profile,etc/bashrc).
NotethatcobsetenvisonlycompatiblewithPOSIX-likeshells,suchasbash,ksh,orXPG4sh.
ItisnotcompatiblewithC-shellorpre-XPG4Bourneshell.
StartingtheproductTostartEclipse:IfyouareusingaGUIinterface,double-clicktheproducticon(automaticallyinstalledonyourdesktop).
Note:Theinstallerautomaticallycreatesashortcuticonfortheproductonthedesktopfortheuserforwhichyourantheinstallscript.
Ifyouneedtocreatedesktopiconsforotherusers'desktopsonthesamemachine,oriftheiconwasnotcreatedonthedesktopfortherootuser,runthefollowingshellscriptastheuseryouneedtologinas:$COBDIR/bin/createdesktopicon.
shIfyouareusinganon-GUIinterface,suchasaterminalemulator,typethefollowingfromacommandprompt:eclipse38|InstallationAdvancedInstallationTasksThissectionincludesinstructionsabouthowtoperformanon-defaultinstallation,installthisproductasanupgrade,orabouthowtoinstalltheadditionalcomponents.
Theadvancedinstallationtasksinclude:InstallingasanUpgrade-includedintheseReleaseNotesCommandlineinstallationoptions-includedintheseReleaseNotesInstallingusinganRPMinstalleronLinux-availableintheproductHelpandintheMicroFocusInfocenterInstallingintootherinstancesofEclipse-availableintheproductHelpandintheMicroFocusInfocenterInstallingonMicrosoftTerminalServerandCitrix-availableintheproductHelpandintheMicroFocusInfocenterSeethisinformationintheMicroFocusInfocenter-forWindowsclickhereandforUNIXclickhere.
OnWindowsInstallingasanUpgradeInstallingthisreleaseasanupgradewillautomaticallyuninstallanyHotFixesoftheolderversionoftheproductyouhaveinstalledonyourmachine.
Beforeinstallingthisreleaseasanupgrade,ensureyoucreateaback-upofyourEnterpriseServerconfiguration.
Todothis,ontheEnterpriseServerAdministrationhomepage,clickExportandthenselectExportEnterpriseServerconfigurationandSecurityManagerdefinitions.
Thiscreatesabackupfolderinthec:\programdata\microfocus\EnterpriseDeveloper\MFDS.
YoucanrestoretheEnterpriseServerconfigurationafterinstallingthisrelease-clickImportontheEnterpriseServerAdministrationhomepage.
VisualCOBOLInstallationOptionsYoucaninstallMicroFocusproductssilentlybyspecifying/qatthecommandlineandusingcommandlineparameterstospecifytheinstallationdirectory(installfolder=path),userinformation,andwhichfeaturestoinstall.
Youmustexecutethecommandwithsuperuserpermissions.
Toseewhatparametersyoucanuse,executethefollowingfromthecommandline:install-file/helpwhereinstall-fileforthefollowingproductsisasfollows:VisualCOBOLvce_232.
exeSeetheExamplessectionfurtherinthistopicforexamplesofsomeoftheparametersyoucanuse.
DirectoryconsiderationsYoumusthavereadandwriteaccessforeverydirectoryaccessedduringtheinstallation.
YoucanoverridethedefaultinstallationfolderusingtheInstallFolderparameter.
InstallingcreatesagroupoflogfilesprefixedMicro_Focus_inthe%temp%folder,bydefault.
Tochangethelocationorname,usethe/logparameteronyourSetupcommandlineandspecifythepathandfilename,forexample:/logdrive:\path\LogFilenameInstallation|39InstallingsilentlyUsethe/qparametertoinstallsilently:start/waitinstall-file.
exe/q[parameters]ExamplesTosilentlyinstallVisualCOBOLintoadirectoryotherthanthedefault:start/waitvce_232.
exe/qInstallFolder=c:\DirectoryNameIfyouwanttosilentlyinstalltheEclipseIDEinalocationotherthanthedefault,execute:start/waitvce_232.
exe/qInstallFolder2=c:\EclipseInstallDirectoryToskipinstallingJREwheninstallingVisualCOBOL:start/waitvce_232.
exe/qskipjre=1OnUNIXInstallingasanupgradeThisreleaseworksconcurrentlywiththepreviousversionofVisualCOBOL,soyoudonotneedtouninstallit.
Therearetwooptionsforinstallingthelatestversioninthiscase:MovetheexistinginstallationtoadifferentlocationandinstallthelatestversiontothedefaultinstalllocationspecifiedbytheCOBDIRenvironmentvariable(/opt/microfocus/VisualCOBOL/eclipse,bydefault).
Thisensuresyoudonotneedtochangeyourenvironment.
Tomovetheexistingolderinstallationtoadifferentlocation:1.
Executethefollowingcommandasroot:mv/opt/microfocus/VisualCOBOL/eclipse/opt/microfocus/VisualCOBOL/eclipseversion2.
InstallthelatestversionasdescribedinthesectionInstalling.
Installthelatestversioninadifferentlocationandsettheenvironmenttopointtoit.
Todothis,runtheVisualCOBOLinstallerwiththe–installlocationoption:1.
Executethefollowingcommand:.
/InstallFile-installlocation="/opt/microfocus/VisualCOBOL/eclipse"Note:Youcanusevariablesorthetildesyntaxforthepathfor–installlocation.
Forexample,thefollowingexamplesareequivalent:-installlocation="/home/myid/installdir"-installlocation="~myid/installdir"-installlocation="~/installdir"-installlocation="$HOME/installdir"2.
Executecobsetenvtosettheenvironmentandpointtothenewinstalllocation:.
/opt/microfocus/VisualCOBOL/bin/cobsetenvNotethatcobsetenvisonlycompatiblewithPOSIX-likeshells,suchasbash,ksh,orXPG4sh.
ItisnotcompatiblewithC-shellorpre-XPG4Bourneshell.
40|InstallationInstallationOptionsInstallingintoadifferentlocationToinstallinadifferentlocationusethe-installlocation="Location"parametertospecifyanalternativedirectorylocation.
Forexample:.
/setup_visualcobol_deveclipse_2.
3_update2_platform-installlocation="fullpathofnewlocation"Note:Youcanusevariablesorthetildesyntaxforthepathfor–installlocation.
Forexample,thefollowingexamplesareequivalent:-installlocation="/home/myid/installdir"-installlocation="~myid/installdir"-installlocation="~/installdir"-installlocation="$HOME/installdir"Youcanseedetailsaboutwhichadditionalparameterscanbepassedtotheinstallscriptifyouenterthe-helpoption.
ConfiguringEnterpriseServerYoucanusethefollowingoptionstoconfiguretheEnterpriseServerinstallation:[-ESsysLog="location"][-ESadminID="UserID"][-CASrtDir="location"],where:-ESsysLogSpecifiesalocationinwhichthebuildwillcreatetheEnterpriseServerSystemlogfile-forexample,-ESsysLog="/home/esuser/logs".
Thedefaultlocationis/var/mfcobol/logs.
-ESadminIDSetstheEnterpriseServerSystemAdministratorProcessUserIDfromthecommandline-forexample,-ESadminID="esadm".
ThedefaultuserIDistheonethatrunstheinstaller.
-CASrtDirSpecifiesthelocationweretheEnterpriseServerrun-timesystemfilesareplaced-forexample,-CASrtDir="/home/esuser/casrt/es".
Thedefaultlocationis/var/mfcobol/es.
InstallingSilentlyYoucaninstallMicroFocusproductssilentlybyusingcommandlineparameterstospecifytheinstallationdirectory,userinformation,andwhichfeaturestoinstall.
Youmustexecutethecommandwithsuperuserpermissions.
fYoucanusethefollowingcommandlineargumentstoinstallsilentlyonUNIX/Linux:–silent-IacceptEULAForexample,execute:[asroot]setup_filename–silent-IacceptEULAAfterInstallingSeeChangesinBehaviororUsageinyourproductdocumentationandintheReleaseNotesforimportantinformationaboutchangesinthisreleasethatmightaffectexistingapplications.
ChecktheProductDocumentationsectionoftheMicroFocusSupportLineWebsiteandtheMicroFocusInfocenterforanyupdatestothedocumentationwhichmighthavebeenuploaded.
Installation|41OnWindowsConfiguringVisualCOBOLIfyouhaveusedEclipsefromthesameworkspacebefore,theEclipseperspectivesettingsarenotresetafterinstallinganyMicroFocusproduct.
Topickupanynewfeatures,youmustresettheperspectiveyouareworkingwithafterinstallation:1.
Opentheexistingworkspacewiththisproduct.
Youmayreceivesomewarningsorerrorswhichyoucanignore.
2.
MakesureyouareintheperspectiveyouneedtoresetbyclickingWindow>OpenPerspective>Other.
3.
FromtheOpenPerspectivedialogbox,clicktheperspectiveyouwanttoreset.
4.
ClickOK.
5.
ClickWindow>ResetPerspective.
6.
Whenprompted,clickYes.
7.
Reapplyanycustomizations.
InstallingXWindowsonWindowsSomefeaturesofVisualCOBOLforEclipseonWindowsrequireanXWindowsinstallation,henceMicroFocusViewNowXisprovidedwiththeproduct.
ToinstallViewNowX:1.
UsingWindowsExplorer,navigatetothefolderthatcontainstheViewNowXexecutable.
Bydefault,thisis%ProgramFiles(x86)%\MicroFocus\VisualCOBOL\ViewNowX.
2.
ExecuteViewNow_X_Server.
exeandthenvnx_HF_11327.
mspinthatfolder.
ViewNowXrequiresthatyourclientmachinehasMicrosoftVisualC++2008SP1RedistributablePackage(x86)installed.
Ifitismissingfromyourmachine,theViewNowXinstallationwillofferalinktodownloadthepackage.
RepairingonWindowsIfanyproductfiles,registrysettingsorshortcutsareaccidentallyremovedatanypoint,youcanperformarepairontheinstallationtoreplacethem.
TorepairyourinstallationonversionsofWindowsVistaorlater:1.
FromtheControlPanel,clickUninstallaprogramunderPrograms.
2.
Right-clickyourMicroFocusproductandselectRepair.
UninstallingWindowsTouninstalltheproduct,youcannotsimplydeleteitsfilesfromyourharddisk.
Touninstalltheproduct:1.
Loginwiththesameuser-IDasyouusedwhenyouinstalledtheproduct.
2.
ClickUninstallaprogramunderProgramsinControlPanel.
3.
SelecttheproductandclickRemoveorUninstallasappropriate.
Whenyouuninstall,theonlyfilesdeletedarethosethattheinstallationsoftwareinstalled.
Iftheproductdirectoryhasnotbeenremoved,deleteanyunwantedfilesandsubdirectorieswithinitusingWindowsExplorer.
42|InstallationImportant:TheinstallercreatesseparateinstallationsforMicroFocusVisualCOBOLandMicroFocusLicenseAdministration.
UninstallingonlyVisualCOBOLdoesnotautomaticallyuninstalltheMicroFocusLicenseAdministrationoranyoftheprerequisitesoftware.
TocompletelyremovetheproductyoumustuninstalltheMicroFocusLicenseAdministrationaswell.
Youcanoptionallyremovetheprerequisitesoftware.
Forinstructions,checkthedocumentationoftherespectivesoftwarevendor.
Tosilentlyuninstalltheproduct,youneedthesetupfileandyouneedtoexecutethefollowingatthecommandline:start/waitinstall-file.
exe/quiet/uninstallOnUNIXConfiguringVisualCOBOLIfyouhaveusedEclipsefromthesameworkspacebefore,theEclipseperspectivesettingsarenotresetafterinstallinganyMicroFocusproduct.
Topickupanynewfeatures,youmustresettheperspectiveyouareworkingwithafterinstallation:1.
Opentheexistingworkspacewiththisproduct.
Youmayreceivesomewarningsorerrorswhichyoucanignore.
2.
MakesureyouareintheperspectiveyouneedtoresetbyclickingWindow>OpenPerspective>Other.
3.
FromtheOpenPerspectivedialogbox,clicktheperspectiveyouwanttoreset.
4.
ClickOK.
5.
ClickWindow>ResetPerspective.
6.
Whenprompted,clickYes.
7.
Reapplyanycustomizations.
ConfiguringtheEnvironmentforDevelopingRDBMSApplicationsonUNIXNote:Ifyouareworkingwithremoteprojects,youneedtoconfiguretheenvironmentbeforeyoustarttheremoteserverprocess.
OnUNIX,ifyouareworkingwithlocalprojects,youneedtoconfiguretheenvironmentbeforeyoustartEclipse.
1.
EnsuretheCOBOLandthethird-partysoftwareenvironmentsareset.
2.
SetuptheRDBMSenvironment.
RefertoyourRDBMSvendordocumentationfordetails.
3.
SetCOBCPYasrequiredinorderfortheIDEtolocateanycopybooksthatareexternaltoyourproject.
4.
IfworkingwithPro*COBOL/CobsqlapplicationsyouneedtosetCOBOPT.
ThissetstheappropriatelinkeroptionsfortheplatformandtheCOBOLworkingmode:Todothis,executethefollowingatthecommandline:$COBDIR/src/oracle/set_cobopt_oracleCOBOPT=$PWD/cobopt.
oraexportCOBOPTRepairingIfafileintheinstallationoftheproductbecomescorrupt,orismissing,werecommendthatyoureinstalltheproduct.
Installation|43UninstallingNote:Beforeyouuninstalltheproduct,ensurethattheEnterpriseServerinstancesandtheMicroFocusDirectoryService(MFDS)arestopped.
Touninstallthisproduct:1.
ExecuteasroottheUninstall_VisualCOBOLEclipse2.
3.
shscriptinthe$COBDIR/bindirectory.
Note:TheinstallercreatesseparateinstallationsfortheproductandforMicroFocusLicenseAdministration.
UninstallingtheproductdoesnotautomaticallyuninstalltheMicroFocusLicenseAdministrationortheprerequisitesoftware.
TocompletelyremovetheproductyoumustuninstalltheMicroFocusLicenseAdministrationaswell.
TouninstallMicroFocusLicenseAdministration:1.
ExecuteasroottheUnInstallMFLicenseServer.
shscriptinthe/var/microfocuslicensing/bindirectory.
Thescriptdoesnotremovesomeofthefilesastheycontaincertainsystemsettingsorlicenses.
Youcanoptionallyremovetheprerequisitesoftware.
Forinstructions,checkthedocumentationoftherespectivesoftwarevendor.
44|InstallationLicensingInformationNote:WhenyouactivateVisualCOBOLPersonalEdition,youcanuseitforalimitedperiodof365days.
Afterthisperiod,youcaneitherregisteranewPersonalEditionlicensefor365daysoracquireavalidlicenseeitherfora30-daytrialorfulllicenseofVisualCOBOLinordertocontinueusingtheproduct.
Ifyouhavepurchasedlicensesforapreviousreleaseofthisproduct,thoselicenseswillalsoenableyoutousethisrelease.
PersonalEditionlicensingisonlyavailablewithVisualCOBOLforEclipseThelatestversionoftheSafeNetlicensingsoftwareisrequired.
SeetheSoftwareRequirementssectioninthisdocumentformoredetails.
YourentitlementforusingthisproductisgovernedbytheMicroFocusEndUserLicenseAgreementandbyyourproductorder.
Ifyouareunsureofwhatyourlicenseentitlementisorifyouwishtopurchaseadditionallicenses,contactyoursalesrepresentativeorMicroFocusSupportLine.
TobuyandactivateafullunlimitedlicenseTobuyalicenseforVisualCOBOL,contactyoursalesrepresentativeorMicroFocusSupportLine.
ForinstructionsonusingtheMicroFocusLicensingAdministrationTool,seeLicensingintheVisualCOBOLhelp.
TostartMicroFocusLicenseAdministrationWindowsFromtheWindowsTaskbarclickStart>AllPrograms>MicroFocusLicenseManager>LicenseAdministration.
Note:OnWindows8,Windows10,andWindowsServer2012,youusetheStartscreentoinvokeprograms.
UNIXLogonasroot,andfromacommandprompttype:/var/microfocuslicensing/bin/cesadmintool.
shInstallinglicensesIfyouhavealicensefileWindows1.
StartMicroFocusLicenseAdministration.
2.
ClicktheInstalltab.
LicensingInformation|453.
Dooneofthefollowing:ClickBrowsenexttotheLicensefilefieldandselectthelicensefile(whichhasanextensionof.
mflic).
DraganddropthelicensefilefromWindowsExplorertotheLicensefilefield.
Openthelicensefileinatexteditor,suchasNotepad,thencopyandpastethecontentsofthefileintotheboxbelowtheLicensefilefield.
4.
ClickInstallLicenses.
Alternatively,youcaninstallthelicensefilefromwithintheIDEasfollows:1.
StartVisualCOBOL.
2.
ClickHelp>MicroFocus>ProductLicensingtoopentheProductLicensingdialogbox.
3.
EnsureIhaveafullVisualCOBOLlicenseischecked.
4.
ClickBrowsenexttotheLicensefilefield.
5.
Selectthelicensefile(whichhasanextensionof.
mflic),andthenclickOpen.
6.
ClickFinishtoinstallthelicense.
UNIX1.
StarttheMicroFocusLicenseAdministrationtoolandselecttheManualLicenseInstallationoptionbyentering4.
2.
Enterthenameandlocationofthelicensefile.
IfyouhaveanauthorizationcodeAuthorizingyourproductwhenyouhaveanInternetconnectionThefollowingproceduredescribeshowtoauthorizeyourproductusingalocalornetworklicenseserver.
Thelicenseserverissetupautomaticallywhenyoufirstinstalltheproduct.
Windows1.
StartMicroFocusLicenseAdministration.
2.
ClicktheInstalltab.
3.
TypetheauthorizationcodeintheEnterauthorizationcodefield.
4.
ClickAuthorize.
Ifyouchangethenameofthemachinerunningyourlicenseserverafterithasgrantedlicenses,thelicensesstopworking.
UNIX1.
StartMicroFocusLicenseAdministration.
2.
SelecttheOnlineAuthorizationoptionbyentering1andpressingEnter.
3.
EnteryourauthorizationcodeattheAuthorizationCodepromptandthenpressEnter.
Authorizingyourproductwhenyoudon'thaveanInternetconnectionThismethodofauthorizationisrequiredifyourmachinedoesnothaveanInternetconnectionorifnormal(automatic)authorizationfails.
Windows1.
StartMicroFocusLicenseAdministration.
2.
ClickManualAuthorizationontheInstallpage.
46|LicensingInformation3.
MakeanoteofthecontentsoftheMachineIDfield.
Youwillneedthislater.
4.
Dooneofthefollowing:IfyourmachinehasanInternetconnection,clicktheSupportLineWeblinkintheManualAuthorizationInformationwindow.
IfyourmachinedoesnothaveanInternetconnection,makeanoteoftheWebaddressandtypeitintoaWebbrowseronamachinethathasanInternetconnection.
TheMicroFocusSupportLineManualproductauthorizationWebpageisdisplayed.
5.
TypetheauthorizationcodeintheAuthorizationCodefield.
Theauthorizationcodeisa16-characteralphanumericstringsuppliedwhenyoupurchasedyourproduct.
6.
TypetheMachineIDintheMachineIDfield.
7.
TypeyouremailaddressintheEmailAddressfield.
8.
ClickGenerate.
9.
Copythegeneratedlicensestring(orcopyitfromtheemail)andpasteitintotheboxundertheLicensefilefieldontheInstallpage.
10.
ClickInstallLicenses.
UNIXInordertoauthorizeyourproductyoumusthavethefollowing:Yourauthorizationcode(a16-characteralphanumericstring).
ThemachineID.
Togetthis,starttheMicroFocusLicenseAdministrationtoolandselecttheGetMachineIdoptionbyinputting6.
Makeanoteofthe"OldmachineID".
Ifyouhavepreviouslyreceivedthelicensesandputtheminatextfile,skiptostep6.
1.
OpentheMicroFocuslicenseactivationwebpagehttp://supportline.
microfocus.
com/activationinabrowser.
2.
EnteryourauthorizationcodeandoldmachineIDand,optionally,youremailaddressintheEmailAddressfield.
3.
ClickGenerate.
4.
Copythelicensesstringsfromthewebpageortheemailyoureceiveintoafile.
5.
Putthelicensefileontoyourtargetmachine.
6.
StarttheMicroFocusLicenseAdministrationtoolandselecttheManualLicenseInstallationoptionbyinputting4.
7.
Enterthenameandlocationofthelicensefile.
ToobtainmorelicensesIfyouareunsureofwhatyourlicenseentitlementisorifyouwishtopurchaseadditionallicensesforVisualCOBOL,contactyoursalesrepresentativeorMicroFocusSupportLine.
LicensingInformation|47UpdatesandSupportLineOurWebsitegivesup-to-datedetailsofcontactnumbersandaddresses.
FurtherInformationandProductSupportAdditionaltechnicalinformationoradviceisavailablefromseveralsources.
Theproductsupportpagescontainaconsiderableamountofadditionalinformation,suchas:TheProductUpdatessectionoftheMicroFocusSupportLineWebsite,whereyoucandownloadfixesanddocumentationupdates.
TheExamplesandUtilitiessectionoftheMicroFocusSupportLineWebsite,includingdemosandadditionalproductdocumentation.
TheSupportResourcessectionoftheMicroFocusSupportLineWebsite,thatincludestroubleshootingguidesandinformationabouthowtoraiseanincident.
Toconnect,enterhttp://www.
microfocus.
cominyourbrowsertogototheMicroFocushomepage,thenclickSupport.
Note:Someinformationmaybeavailableonlytocustomerswhohavemaintenanceagreements.
IfyouobtainedthisproductdirectlyfromMicroFocus,contactusasdescribedontheMicroFocusWebsite,www.
microfocus.
com.
Ifyouobtainedtheproductfromanothersource,suchasanauthorizeddistributor,contactthemforhelpfirst.
Iftheyareunabletohelp,contactus.
Also,visit:TheMicroFocusCommunityWebsite,whereyoucanbrowsetheKnowledgeBase,readarticlesandblogs,finddemonstrationprogramsandexamples,anddiscussthisproductwithotherusersandMicroFocusspecialists.
Seehttp://community.
microfocus.
com.
TheMicroFocusYouTubechannelforvideosrelatedtoyourproduct-seehttps://www.
youtube.
com/user/MicroFocusIntl.
InformationWeNeedHoweveryoucontactus,pleasetrytoincludetheinformationbelow,ifyouhaveit.
Themoreinformationyoucangive,thebetterMicroFocusSupportLinecanhelpyou.
Butifyoudon'tknowalltheanswers,oryouthinksomeareirrelevanttoyourproblem,pleasegivewhateverinformationyouhave.
Thenameandversionnumberofallproductsthatyouthinkmightbecausingaproblem.
Yourcomputermakeandmodel.
Youroperatingsystemversionnumberanddetailsofanynetworkingsoftwareyouareusing.
Theamountofmemoryinyourcomputer.
Therelevantpagereferenceorsectioninthedocumentation.
Yourserialnumber.
Tofindoutthesenumbers,lookinthesubjectlineandbodyofyourElectronicProductDeliveryNoticeemailthatyoureceivedfromMicroFocus.
OnWindows,ifyouarereportingaprotectionviolationyoumightbeaskedtoprovideadump(.
dmp)file.
ToproduceadumpfileyouusetheUnexpectedErrordialogboxthatisdisplayedwhenaprotectionviolationoccurs.
UnlessrequestedbyMicroFocusSupportLine,leavethedumpsettingasNormal(recommended),clickDump,thenspecifyalocationandnameforthedumpfile.
OncethedumpfilehasbeenwrittenyoucanemailittoMicroFocusSupportLine.
48|UpdatesandSupportLineAlternatively,youmightbeaskedtoprovidealogfilecreatedbytheConsolidatedTracingFacility(CTF)-atracinginfrastructurethatenablesyoutoquicklyandeasilyproducediagnosticinformationdetailingtheoperationofanumberofMicroFocussoftwarecomponents.
OnWindows,youcanusetheMicroFocusSupportLineSupportScanUtility,MFSupportInfo,tocreateeither:a.
logfilethatcontainsthedetailsaboutyourenvironment,MicroFocusSupportLineproducts,andsettings.
a.
ziparchivethatincludesthesameinformationasthe.
logfileplussomeproductconfigurationfilesfromc:\ProgramDataandtheproductinstallationlogfiles.
MFSupportInfo.
exeisstoredin\bin.
TorunMFSupportInfo:1.
Starta32-bitEnterpriseDevelopercommandprompt.
2.
EnterMFSupportinfoatthecommandprompttostarttheutility.
3.
Createa.
logfileora.
ziparchiveasfollows:a.
Tocreatea.
logfile,clickFile>Save.
Thispromptstosavethe.
logfile,MFSupportInfo_Log_MachineName_YYYY-MM-DD_HH-MM-SS.
log,inthe%temp%directory.
b.
Tocreatea.
ziparchive,clickTools>CreateZipPackage.
Thiscreatesa.
ziparchive,MFSupportInfo_Log_MachineName_YYYY-MM-DD_HH-MM-SS.
zip,inthe%temp%directory.
4.
SendthediagnosticinformationtoyourMicroFocusSupportLinerepresentative:ThefollowingrequiresanInternetconnectionandanEmailclient:a.
ClickTools>EmailLogtoSupportLinetoopentheEmailLogdialogbox.
b.
FillintherequiredfieldsandclickSend.
IfthemachineisnotconnectedtotheInternetoriftherearenoEmailclientsinstalled,copyeitherthe.
logfileorthe.
ziparchivetoamachinethatisconnectedtotheInternet.
UseyourEmailclienttoemailthefilestoMicroFocusSupportLineatsupportline@microfocus.
comtogetherwiththeSupportIncident(SI)number,ifavailable,andanyadditionaldetailsthatmightbeusefultodiagnosetheissuesthatyouareexperiencing.
OnUNIX,youcanusetheMicroFocusUNIXSupportScanUtility,mfsupport,tocreatealogfilethatcontainsthedetailsaboutyourenvironment,product,andsettings.
Themfsupportscriptisstoredin$COBDIR/bin.
Torunmfsupport:1.
StartaUNIXshell.
2.
SetCOBDIRtotheproductwithissues.
3.
Executemfsupportfromadirectorywhereyouhavewritepermissions.
Thiscreatesalogfile,mfpoll.
txt,inthatdirectory.
4.
Whenthescriptfinishes,sendthemfpoll.
txtfiletoyourMicroFocusSupportLinerepresentative.
Note:IfCOBDIRissettoalocationthatdoesnotcontainetc/cobver,thescriptoutputsthecontentsof/opt/microfocus/logs/MicroFocusProductRegistry.
datwhichkeepsalistoftheinstalledMicroFocusproducts.
UpdatesandSupportLine|49CreatingDebugFilesIfyouencounteranerrorwhencompilingaprogramthatrequiresyoutocontactMicroFocusSupportLine,yoursupportrepresentativemightrequestthatyouprovideadditionaldebugfiles(aswellassourceanddatafiles)tohelpusdeterminethecauseoftheproblem.
Ifso,theywilladviseyouhowtocreatethem.
50|UpdatesandSupportLineDisclaimerThissoftwareisprovided"asis"withoutwarrantyofanykind.
MicroFocusdisclaimsallwarranties,eitherexpressorimplied,includingthewarrantiesofmerchantabilityandfitnessforaparticularpurpose.
InnoeventshallMicroFocusoritssuppliersbeliableforanydamageswhatsoeverincludingdirect,indirect,incidental,consequential,lossofbusinessprofitsorspecialdamages,evenifMicroFocusoritssuppliershavebeenadvisedofthepossibilityofsuchdamages.
Somestatesdonotallowtheexclusionorlimitationofliabilityforconsequentialorincidentaldamagessotheforegoinglimitationmaynotapply.
MicroFocusisaregisteredtrademark.
CopyrightMicroFocus1984-2016.
Allrightsreserved.
Disclaimer|51