resolvelockinfo

MicroFocusVisualCOBOL2.
2forEclipseReleaseNotesMicroFocusTheLawn22-30OldBathRoadNewbury,BerkshireRG141QNUKhttp://www.
microfocus.
comCopyrightMicroFocus2009-2013.
Allrightsreserved.
MICROFOCUS,theMicroFocuslogoandVisualCOBOLaretrademarksorregisteredtrademarksofMicroFocusIPDevelopmentLimitedoritssubsidiariesoraffiliatedcompaniesintheUnitedStates,UnitedKingdomandothercountries.
Allothermarksarethepropertyoftheirrespectiveowners.
2013-10-22iiContentsMicroFocusVisualCOBOL2.
2forEclipseReleaseNotes4Installation5InstallingVisualCOBOLonWindows5SystemRequirementsforVisualCOBOLforEclipse(Windows)5InstallingVisualCOBOLforEclipse(Windows)6InstallingVisualCOBOLonUNIX12SystemRequirementsforVisualCOBOLforEclipse(UNIX)12InstallingVisualCOBOLforEclipse(UNIX)14LicensingInformation20ToactivateVisualCOBOLPersonalEdition20Torequestandactivatea30-daytriallicenseforVisualCOBOL21Tobuyandactivateafullunlimitedlicense21TostartMicroFocusLicenseAdministration22Installinglicenses22Ifyouhavealicensefile22Ifyouhaveanauthorizationcode23NewFeaturesinVisualCOBOL2.
225ACUCOBOL-GTCompatibility25COBOLSourceInformation(CSI)25CompilerDirectives25ConsolidatedTracingFacility26EnhancedACCEPTandDISPLAYStatements27FileHandling27InterfaceMappingToolkit27ManagedCOBOL27ProblemsView28SupportforSOA29XMLExtensions29KnownIssues30SignificantChangesinBehaviororUsage32ResolvedIssues35UpdatesandSupportLine52FurtherInformationandProductSupport52InformationWeNeed52CreatingDebugFiles53Disclaimer54Contents|3MicroFocusVisualCOBOL2.
2forEclipseReleaseNotesThesereleasenotescontaininformationthatmightnotappearintheHelp.
Readthemintheirentiretybeforeyouinstalltheproduct.
Note:ThisdocumentcontainsanumberoflinkstoexternalWebsites.
MicroFocuscannotberesponsibleforthecontentsoftheWebsiteorforthecontentsofanysitetowhichitmightlink.
Websitesbytheirnaturecanchangeveryrapidlyandalthoughwetrytokeepourlinksup-to-date,wecannotguaranteethattheywillalwaysworkasexpected.
Note:VisualCOBOLnowincludessupportforcreatingWebserviceandEnterpriseJavaBeanapplicationsusingtheInterfaceMappingToolkit(IMTK)inconjunctionwithEnterpriseServer.
IfyouareupgradingtothisreleasefromanearlierversionofVisualCOBOL,youmayneedtoapplyforanewauthorizationcodeinordertoaccessthefunctionality-pleasecontactMicroFocusSupportLinetoreceiveanupdatedauthorizationcode.
NotethattheVisualCOBOLPersonalEditionlicensedoesnotsupporttheIMTKfunctionality.
Important:ApplicationexecutablesthatwerecompiledusingearlierMicroFocusproductsmustberecompiledfromthesourcesusingVisualCOBOL.
4|MicroFocusVisualCOBOL2.
2forEclipseReleaseNotesInstallationInstallingVisualCOBOLonWindowsSystemRequirementsforVisualCOBOLforEclipse(Windows)HardwareRequirementsVisualCOBOLhasthefollowingrequirementsinadditiontotherequirementsofEclipse.
SeetheEclipsedocumentationfordetailsofitsrequirements.
ThediskspacerequirementsforWindowsare:PlatformVisualCOBOLSentinelRMSLicenseManagerx86Windowsplatforms1.
05GB35MBx64Windowsplatforms1.
2GB35MBNote:Thisincludesthespaceneededtocacheinformationlocallysothatyoucanmodifytheinstallationwithouttheoriginalsourcemedia.
OperatingSystemsSupportedNote:Youcanproduce64-bitand32-bitapplicationson64-bitoperatingsystems.
Foralistofthesupportedoperatingsystems,checktheProductAvailabilitysectionontheMicroFocusSupportLineWebsite:http://supportline.
microfocus.
com/prodavail.
aspx.
SoftwarerequirementsNote:Thesetupfilewillcheckyourmachineforwhethertheprerequisitesoftwareisinstalledandwillinstallanymissingprerequisitesandtheproductcomponents.
Important:Thisreleaserequiresversion10000.
2.
990orlateroftheMicroFocuslicensingsoftware.
Forlocalservers,youdonotneedtoinstallitseparately,asthesetupfileinstallsanewVisualCOBOLclientandanewlicensingserveronthesamemachine.
Ifyouhaveanetworkserver,youmustupdatethelicenseserverbeforeinstallingtheproductastheclientisnotabletocommunicatewithlicenseserversofversionsolderthan10000.
2.
660.
OnWindows,youcanchecktheversionofyourlicenseserverbyclickingHelp>AboutintheMicroFocusLicensingSystemAdministrationtool.
TochecktheversionofthelicenseserveronUNIX,run/var/microfocuslicensing/bin/mfcesveror/var/microfocuslicensing/bin/cesadmintool.
sh.
YoucandownloadthenewversionofthelicenseserversoftwarefromtheMicroFocusSupportLineWebsite:http://supportline.
microfocus.
com.
Installation|5AdditionalSoftwareRequirementsToensurefullfunctionalityforsomeVisualCOBOLfeatures,youmightberequiredtoobtainandinstalladditionalthird-partysoftwareinadditiontotheprerequisitesoftwareinstalledautomaticallybytheVisualCOBOLsetupfile.
Thefollowinginformationspecifiesthethird-partysoftwarerequiredforeachfeature.
XMLExtensionsXMLExtensionshasthesamerequirementsasVisualCOBOL.
Both32-bitand64-bitversionsareavailable.
SeetheVisualCOBOLXMLExtensionsUser'sGuide,availablefromtheVisualCOBOLproductdocumentationsectionoftheSupportLinewebsite,formoredetails.
Additionally,XMLExtensionsmaybeusedinconjunctionwithTerminalServer.
ApplicationserversupportforJVMCOBOLRestriction:ThistopicappliesonlywhentheEnterpriseServerfeatureisenabled.
ThefollowingapplicationserversaresupportedusingthefollowingJDKs:ApplicationServersJDKversionContainerssupportversionTomcat7.
0.
391.
6.
027Servlets2.
5JBoss6.
11.
6.
027Servlets2.
5WebLogic12.
1.
11.
6.
027Servlets2.
5WebLogic12.
1.
1onAIX6.
11.
6.
0SR10FP1Servlets2.
5WebSphere8.
51.
6.
027Servlets2.
5WebSphere8.
5onAIX6.
11.
6.
0SR10FP1Servlets2.
5TheavailabilityofresourceadaptersfortheseapplicationserversdiffersbetweenUNIXplatforms.
Thefollowingtableindicateswheresupportisavailableforeachplatform:PlatformTomcat7.
0.
39JBoss6.
1WebLogic12.
1.
1WebSphere8.
5RedHatEL532-bitand64-bit32-bitand64-bit32-bitand64-bit32-bitand64-bitSolarisonSPARC32bit32-bit32-bit32-bitHP/UX11.
31onIntelIA6464bit64bitAIX6.
132-bitand64-bit32-bitand64-bitSUSE1132-bitand64-bitEclipseIDEdevelopmentissupportedforRedHatandWindowsplatformsonly.
InstallingVisualCOBOLforEclipse(Windows)DownloadingtheProduct1.
UsethedownloadlinksinyourElectronicProductDeliveryemail.
FormoreinformationfollowthelinksfortheinstallationinstructionsandtheEndUserLicenseAgreement.
6|InstallationProductCo-ExistenceVisualCOBOLandCOBOLServercannotcoexistonthesamemachine.
VisualCOBOLandEnterpriseDevelopercannotcoexistonthesamemachineregardlessofwhichIDE(VisualStudioorEclipse)youinstall.
COBOLServercomesinthefollowingversions:COBOLServer2010,whichisthedeploymentserverforapplicationsbuiltusingVisualCOBOLforVisualStudio2010andVisualCOBOLforEclipse.
COBOLServer2012,whichisthedeploymentserverforapplicationsbuiltusingVisualCOBOLforVisualStudio2012.
YoucanonlydeployapplicationstotheversionofCOBOLServerfromtheassociateddevelopmentproductyouusedtobuildtheapplications.
Forexample,ifyoubuiltyourapplicationusingVisualCOBOLforVisualStudio2012youmustdeploythetargetfilestoCOBOLServer2012.
InstallingThesearethestepstoinstallthisproduct:1.
Runthevce_22.
exefileandfollowthewizardinstructionstocompletetheinstallation.
AfullversionofEclipse,withtheMicroFocuspluginsalreadyinstalled,willbepresentintheC:\Users\Public\MicroFocus\ProductName\eclipsedirectory.
OnolderversionsofWindows,Eclipsemightbeinstalledinadifferentfolder,suchasforWindowsXP,in%ProgramFiles(x86)%\MicroFocus\VisualCOBOL\eclipse.
Note:IfyouareinstallingontoamachinethathasanexistingMicroFocusproductthatusesanolderSentinelRMSLicenseManager,youmightbepromptedtoremoveitandinstalltheMicroFocusLicenseAdministration.
BydoingthisyoumaintaintheexistingSentinelRMSlicensefileswhileaddingtheMicroFocusLicenseAdministration.
IfyouareunsureaboutexistinglicensesonyourcomputerorremovingtheSentinelRMSLicenseManager,consultyourSystemAdministrator.
Ifyouwanttoproceed,removeSentinelRMSLicenseManagerbyusingAddorRemovePrograms(WindowsXP)orProgramandFeatures(WindowsVistaorlater),andreruntheinstallationfile.
Triallicensescannotbeusedwithremotedesktopservices.
Ifyouwanttouseyourproductinthisway,pleasecontactMicroFocusSupportLinetoobtainarelevantlicense.
Werecommendthatyouinstallanyupdatesforthe.
NETFrameworkthatareavailableattheMicrosoftDownloadsite.
IfyouinstallJDKyoumightbepromptedtoinstallthelatestupdate.
ThelatestupdateisnotrequiredforusewithVisualCOBOLbutyoucaninstallitifyouwish.
InstallingSilentlyYoucaninstallMicroFocusproductssilentlybyusingcommandlineparameterstospecifytheinstallationdirectory,userinformation,andwhichfeaturestoinstall.
Toinstallsilentlyusethefollowingcommand:start/waitinstall-file.
exe/q[parameters]whereinstall-fileforthefollowingproductsisasfollows:VisualCOBOLvce_22.
exeToseewhatparametersyoucanuse,executethefollowingfromthecommandline:install-file/helpInstallation|7Aftertheinstallationiscompleteyoucaninstallthelicensesilentlybyexecutingthefollowingcommands:IfyouhaveaccesstotheInternetandanauthorizationcodeFor32-bitWindowsenvironments:start/wait"""C:\ProgramFiles\CommonFiles\SafeNetSentinel\SentinelRMSLicenseManager\WinNT\cesadmintool"-termactivateAuthorizationCodeFor64-bitWindowsenvironments:start/wait"""C:\ProgramFiles(x86)\CommonFiles\SafeNetSentinel\SentinelRMSLicenseManager\WinNT\cesadmintool"-termactivateAuthorizationCodeIfyoudon'thaveaccesstotheInternetbutdohavealicensestringFor32-bitWindowsenvironments:start/wait"""C:\ProgramFiles\CommonFiles\SafeNetSentinel\SentinelRMSLicenseManager\WinNT\cesadmintool"-terminstall-fFileNameFor64-bitWindowsenvironments:start/wait"""C:\ProgramFiles(x86)\CommonFiles\SafeNetSentinel\SentinelRMSLicenseManager\WinNT\cesadmintool"-terminstall-fFileNamewhereFileNameisatextfilecontainingallthelicensestringstobeused.
DirectoryconsiderationsYoumusthavereadandwriteaccessforeverydirectoryaccessedduringtheinstallation.
YoucanoverridethedefaultinstallationfolderusingtheINSTALLDIRparameter:Ifapathinadefinitioncontainsspaces,thenthepathmustbeprecededbyabackslashanddoublequotationmark(\").
Forexample:INSTALLDIR=pathINSTALLDIR=\"c:\MyProduct\"INSTALLDIR=\"c:\ProgramFiles\MicroFocus\MyProduct\"Installingcreatesalogfilein%temp%\LogFilenamebydefault.
Tochangethelocationorname,usethe/logparameteronyourSetupcommandlineandspecifythepathandfilename,forexample:Thedefaultnamesforthelogfilesareasfollows:Micro_Focus_Visual_COBOL_for_IDE_date.
logfortheVisualCOBOLwrapperMicro_Focus_Visual_COBOL_for_IDE_date.
logforVisualCOBOL,whereis"86"for32-bitsystemsand"64"for64-bitsystemslmsetup_install_log.
txtforMicroFocusLicenseAdministrationThelogfilenameandfoldernamecannotcontainspacesThelogfilefoldermustexistbeforebeginningthesilentinstallExamplesTosilentlyinstallVisualCOBOLintoadirectoryotherthanthedefault:start/waitvce_22.
exe/qInstallFolder=c:\DirectoryNameInstallingintodifferentEclipsepackagesMicroFocusVisualCOBOLusesEclipse3.
8,butitwillalsoworkwithEclipse3.
7.
IfyouwanttouseVisualCOBOLinEclipsepackagesbasedonversion3.
7,youmustalsoinstalltheVisualCOBOLupdatesite,8|InstallationandtheRSEandAspectJplugins.
ThefollowingsectionsshowhowtoinstallintoEclipse3.
8andintoEclipse3.
7.
Important:WerecommendyoubackupallexistingEclipseconfigurationfilesfirst.
InstallingintoEclipse3.
81.
InstallVisualCOBOL.
2.
CopytherequiredVisualCOBOLresourcestoyourexistingEclipseasfollows:a.
Extractthecontentsofthefollowing.
zipfilesin%ProgramFiles(x86)%\MicroFocus\VisualCOBOL\eclipse\installer(Windows)or/opt/microfocus//eclipse(UNIX)toatemporaryfolder:ajdt_2.
2.
2_for_eclipse_4.
2.
zipRSE-runtime-3.
3.
zipdtp_1.
10.
2.
zipemf-runtime-2.
8.
3.
zipemf-transaction-runtime-1.
6.
0M7.
zipemf-validation-runtime-1.
6.
0M7.
zipGEF-runtime-3.
8.
2.
ziporg.
eclipse.
graphiti.
site_0.
9.
2.
201302110913.
zipwtp4x-R-3.
4.
2-20130208151217.
zipxsd-runtime-2.
8.
3.
zipb.
Copytheextractedfoldersto\eclipse\dropins(Windows)or/eclipse/dropins(UNIX).
c.
Renameeachofthefolders:Fromajdt_2.
2.
2_for_eclipse_4.
2toAJDTUpdateSiteFromRSE-runtime-3.
3toRSEUpdateSiteFromEDUpdateSitetoCOBOLUpdateSiteFromdtp_1.
10.
2/eclipsetoDTPUpdateSiteFromemf-runtime-2.
8.
3/eclipsetoEMFUpdateSiteFromemf-transaction-runtime-1.
6.
0M7/eclipsetoEMFTransactionUpdateSiteFromemf-validation-runtime-1.
6.
0M7.
eclipsetoEMFValidationUpdateSiteFromGEF-runtime-3.
8.
2/eclipsetoGEFUpdateSiteFromorg.
eclipse.
graphiti.
site_0.
9.
2.
201302110913/eclipsetoGraphitiUpdateSiteFromwtp4x-R-3.
4.
2-20130208151217/eclipsetoWTPUpdateSiteFromxsd-runtime-2.
8.
3.
ziptoXSDUpdateSited.
Edittheeclipse.
inifilein\eclipse(Windows)or/eclipse(UNIX):AddDosgi.
framework.
extensions=reference:file:.
.
/dropins/AJDTUpdateSite/plugins/org.
eclipse.
equinox.
weaving.
hook_1.
0.
200.
I20130127-2000.
jarasapropertyattheendofthefileAddDosgi.
bundles=reference:file:.
.
/dropins/AJDTUpdateSite/plugins/org.
eclipse.
equinox.
weaving.
aspectj_1.
0.
200.
I20130127-2000.
jar@2:start,reference:file:.
.
/plugins/org.
eclipse.
equinox.
simpleconfigurator_1.
0.
301.
v20120914-163612.
jar@1asapropertyattheendofthefile.
Installation|9Note:Thereisaneclipse.
iniinthe%ProgramFiles(x86)%\MicroFocus\VisualCOBOL(Windows)or$COBDIR(UNIX)folderbutitmightconflictwiththeexistingeclipse.
iniinyourexistinginstallation.
Youneedtodecidewhichpiecesarerelevant.
3.
RestartEclipseatthecommandlinewiththe-cleanoption.
InstallingintoEclipse3.
71.
InstallVisualCOBOL.
2.
CopytherequiredVisualCOBOLresourcestoyourexistingEclipseasfollows:1.
Fromthehttp://www.
eclipse.
orgwebsite,locatethefollowingpackagesfromtheprojectdownloadarchive:ajdt_2.
1.
3_for_eclipse_3.
7.
zipRSE-runtime-3.
3.
zip2.
Copytheextractedfoldersto\eclipse\dropins(Windows)or/eclipse/dropins(UNIX).
3.
Copy%ProgramFiles(x86)%\MicroFocus\VisualCOBOL\UpdateSite(Windows)or$COBDIRUpdateSite(Windows)orto\eclipse\dropins\COBOL\UpdateSite(Windows)or/eclipse/dropins/COBOL/UpdateSite(UNIX).
4.
Renameeachofthefolders:Fromajdt_2.
1.
3_for_eclipse_3.
7toAJDTUpdateSiteFromRSE-runtime-3.
3toRSEUpdateSite5.
Movethethecontentsofthe\eclipse\dropins\RSEUpdateSite\eclipse(Windows)or/eclipse/dropins/RSEUpdateSite/eclipse(UNIX)folderupalevel(thatis,to\eclipse\dropins\RSEUpdateSite(Windows)or/eclipse/dropins/RSEUpdateSite(UNIX))anddeletetheemptyfolder.
6.
Youmightneedtoedittheeclipse.
inifilein\eclipse(Windows)or/eclipse(UNIX):Add-Dosgi.
framework.
extensions=reference:file:.
.
/dropins/AJDTUpdateSite/plugins/org.
eclipse.
equinox.
weaving.
hook_1.
0.
100.
HEAD.
jarasapropertyattheendofthefileAdd-Dosgi.
bundles=reference:file:.
.
/dropins/AJDTUpdateSite/plugins/org.
eclipse.
equinox.
weaving.
aspectj_1.
0.
1.
HEAD.
jar@2:start,reference:file:.
.
/plugins/org.
eclipse.
equinox.
simpleconfigurator_1.
0.
200.
v20110502-1955.
jar@1:startasapropertyattheendofthefile3.
RestartEclipseatthecommandlinewiththe-cleanoption.
AfterInstallingIfyouhaveusedEclipsefromthesameworkspacebefore,theEclipseperspectivesettingsarenotresetafterinstallinganyMicroFocusproduct.
Topickupanynewfeatures,youmustresettheCOBOLperspectiveafterinstallation:1.
Opentheexistingworkspacewiththisproduct.
Youmayreceivesomewarningsorerrorswhichyoucanignore.
10|Installation2.
MakesureyouareintheCOBOLperspectivebyclickingWindow>OpenPerspective>COBOL.
3.
ClickWindow>ResetPerspective.
4.
ClickOK.
5.
Reapplyanycustomizations.
Note:ForapplicationscreatedwithearlierMicroFocusproducts,notethefollowing:ExistingApplicationsApplicationexecutablesthatwerecompiledusingearlierMicroFocusproductsmustberecompiledfromthesourcesusingVisualCOBOL.
InstallingXWindowsonWindowsSomefeaturesofVisualCOBOLforEclipseonWindowsrequireanXWindowsinstallation,henceMicroFocusViewNowXisprovidedwiththeproduct.
Toinstall,runthefileViewNow_X_Server.
exeinyourVisualCOBOLinstallation.
Bydefaultthiswillbeinthe%ProgramFiles(x86)%\MicroFocus\VisualCOBOL\ViewNowXfolder.
ViewNowXrequiresthatyourclientmachinehasMicrosoftVisualC++2008SP1RedistributablePackage(x86)installed.
Ifitismissingfromyourmachine,theViewNowXinstallationwillofferalinktodownloadthepackage.
RepairingIfanyproductfiles,registrysettingsorshortcutsareaccidentallyremovedatanypoint,youcanperformarepairontheinstallationtoreplacethem.
TorepairyourinstallationonversionsofWindowsVistaorlater:1.
FromtheControlPanel,clickUninstallaprogramunderPrograms.
2.
Right-clickyourMicroFocusproductandselectRepair.
TorepairyourinstallationonolderversionsofWindows,suchasWindowsXP:1.
ClickStartMenu>ControlPanel>Add/RemovePrograms.
2.
ClickyourMicroFocusproductinthelistofinstalledprograms.
3.
ClickClickhereforsupportinformation.
4.
ClickRepair.
UninstallingWindowsTouninstalltheproduct,youcannotsimplydeleteitsfilesfromyourharddisk.
Touninstalltheproduct:1.
Loginwiththesameuser-IDasyouusedwhenyouinstalledtheproduct.
2.
ClickUninstallaprogramunderPrograms(orAdd/RemoveProgramsonolderversionsofWindows)inControlPanel.
3.
OnolderversionsofWindowssuchasWindowsXP,ensurethatShowUpdates(atthetopoftheAddorRemoveProgramsdialog)ischecked,sothatanyhotfixesorWrapPacksarelisted.
4.
SelecttheproductandclickRemoveorUninstallasappropriate.
Whenyouuninstall,theonlyfilesdeletedarethosethattheinstallationsoftwareinstalled.
Iftheproductdirectoryhasnotbeenremoved,deleteanyunwantedfilesandsubdirectorieswithinitusingWindowsExplorer.
Important:TheinstallercreatesseparateinstallationsforMicroFocusVisualCOBOLandMicroFocusLicenseAdministration.
UninstallingonlyVisualCOBOLdoesnotautomaticallyuninstalltheMicroFocusLicenseAdministrationoranyoftheprerequisitesoftware.
TocompletelyremovetheproductyoumustuninstalltheMicroFocusLicenseAdministrationaswell.
Installation|11Youcanoptionallyremovetheprerequisitesoftware.
Forinstructions,checkthedocumentationoftherespectivesoftwarevendor.
UNIXNote:Beforeyouuninstalltheproduct,ensurethattheEnterpriseServerinstancesandtheMicroFocusDirectoryService(MFDS)arestopped.
Touninstallthisproduct:1.
ExecuteasroottheUninstall_VisualCOBOL2.
2.
shscriptinthe$COBDIR/bindirectory.
Note:TheinstallercreatesseparateinstallationsfortheproductandforMicroFocusLicenseAdministration.
UninstallingtheproductdoesnotautomaticallyuninstalltheMicroFocusLicenseAdministrationortheprerequisitesoftware.
TocompletelyremovetheproductyoumustuninstalltheMicroFocusLicenseAdministrationaswell.
TouninstallMicroFocusLicenseAdministration:1.
ExecuteasroottheUnInstallMFLicenseServer.
shscriptinthe/var/microfocuslicensing/bindirectory.
Thescriptdoesnotremovesomeofthefilesastheycontaincertainsystemsettingsorlicenses.
Youcanoptionallyremovetheprerequisitesoftware.
Forinstructions,checkthedocumentationoftherespectivesoftwarevendor.
InstallingVisualCOBOLonUNIXSystemRequirementsforVisualCOBOLforEclipse(UNIX)HardwareRequirementsVisualCOBOLhasthefollowingrequirementsinadditiontotherequirementsofEclipse.
SeetheEclipsedocumentationfordetailsofitsrequirements.
Thediskspacerequirementsareapproximately:PlatformVisualCOBOLSentinelRMSlicenseserverx86-64runningRedHatLinux664MB33MBx86-64runningSuSESLES666MB33MBNote:Theinstallationrequiresextradiskspacethatequalsthesizeoftheproductyouinstall.
OperatingSystemsSupportedNote:Youcanproduce64-bitand32-bitapplicationson64-bitoperatingsystems.
Foralistofthesupportedoperatingsystems,checktheProductAvailabilitysectionontheMicroFocusSupportLineWebsite:http://supportline.
microfocus.
com/prodavail.
aspx.
SoftwareRequirementsBeforeinstallingthisproduct,youmusthavethefollowingsoftwareinstalledonyourcomputer:12|InstallationTheKornshellisrequiredforthelicensingdaemon.
Aftertheinstallation,ifthelicensingdaemondoesnotstart,checkandensuretheKornshellisinstalledandthenrunthe/var/microfocuslicensing/bin/startmfcesd.
shscripttostartthedaemon.
Thepaxarchivingutilityisrequiredbythesetupfile.
PaxisdistributedwithmostUNIX/Linuxsystemsbut,ifitismissing,youmustinstallitseparately.
Toverifypaxisinstalled,runpax--helporpax--versionatthecommandline.
OnRedHat6.
x,youmusthavethefollowingoperatingsystemlibrariesinstalled:AllVisualCOBOLproductsglibc-*.
x86_64glibc-*.
i686libgcc-*.
x86_64libgcc-*.
i686AdditionallibrariesforVisualCOBOLforEclipsePackageKit-gtk-module-*.
x86_64PackageKit-gtk-module-*.
i686gtk2-*.
x86_64gtk2-*.
i686gtk2-engines.
*.
x86_64gtk2-engines.
*.
i686libXtst-*.
x86_64libXtst-*.
i686libcanberra-gtk2-*.
x86_64libcanberra-gtk2-*.
i686webkitgtk.
x86_64webkitgtk.
i686xterm(anyversion)libgnome.
x86_64libgnome.
i686AdditionallibrariesforMicroFocusVisualCOBOLDevelopmentHubglibc-devel-*.
x86_64glibc-devel-*.
i686VisittheRedHatWebsiteformoreinformation.
Xterm,theterminalemulatorfortheXWindowSystem,ispartofyourUNIX/Linuxdistributionbutisnotinstalledbydefault.
UseyourUNIX/Linuxinstallationmediatoinstallit.
Important:Thisreleaserequiresversion10000.
2.
990orlateroftheMicroFocuslicensingsoftware.
Forlocalservers,youdonotneedtoinstallitseparately,asthesetupfileinstallsanewVisualCOBOLclientandanewlicensingserveronthesamemachine.
Ifyouhaveanetworkserver,youmustupdatethelicenseserverbeforeinstallingtheproductastheclientisnotabletocommunicatewithlicenseserversofversionsolderthan10000.
2.
660.
OnWindows,youcanchecktheversionofyourlicenseserverbyclickingHelp>AboutintheMicroFocusLicensingSystemAdministrationtool.
TochecktheversionofthelicenseserveronUNIX,run/var/microfocuslicensing/bin/mfcesveror/var/microfocuslicensing/bin/cesadmintool.
sh.
YoucandownloadthenewversionofthelicenseserversoftwarefromtheMicroFocusSupportLineWebsite:http://supportline.
microfocus.
com.
Beforeyoustarttheinstallation,youneedtosettheenvironmentasfollows:Installation|13YouneedtosettheJAVA_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:$PATHYouneedtosettheLANGenvironmentvariabletopickuplocalizedmessages.
TheLANGsettingsareEnglishandJapaneseonly.
InstallingVisualCOBOLforEclipse(UNIX)DownloadingtheProduct1.
UsethedownloadlinksinyourElectronicProductDeliveryemail.
FormoreinformationfollowthelinksfortheinstallationinstructionsandtheEndUserLicenseAgreement.
InstallingThesearethestepstoinstallthisproduct:1.
Giveexecutepermissionstothesetupfile:chmod+xsetup_visualcobol_deveclipse_2.
2_platform2.
Runthesetupfilewithsuperuserpermissions:.
/setup_visualcobol_deveclipse_2.
2_platformIfyoudon'trunthisassuperuser,youarepromptedtoenterthesuperuserpasswordduringtheinstall.
TheCOBOLenvironmentisinstalledbydefaultinto/opt/microfocus/product-name,(COBDIR).
AfullversionofEclipse,withtheMicroFocuspluginsalreadyinstalled,ispresentinthe$COBDIR/eclipsedirectory.
Toinstallinadifferentlocationusethe-installlocation="Location"parametertospecifyanalternativedirectorylocation.
Forexample:.
/setup_visualcobol_deveclipse_2.
2_platform-installlocation="fullpathofnewlocation"Youcanseedetailsaboutwhichadditionalparameterscanbepassedtotheinstallscriptifyouenterthe-helpoption.
Note:TheinstallationofthisproductcouldaffecttheSafeNetSentinellicensedcomponentsrunningonyourmachine.
Duringinstallationlicensingisshutdowntoallowfilestobeupdated.
Toensuretheprocessesrunningonyourmachinearenotaffected,youneedtousethe-skipsafenetoption,whichskipstheinstallationofSafeNet:.
/setup_visualcobol_deveclipse_2.
2_platform-skipsafenetToprotecttheSafeNetSentinelinstallationfromaccidentalupdatingyoucancreateanemptyfilenamedSKIP_SAFENET_INSTALLin/var/microfocuslicensing/asfollows:touch/var/microfocuslicensing/SKIP_SAFENET_INSTALLWhilethefileispresent,theSafeNetinstallerdoesnotmakechangestotheinstallationorshutdowntherunninglicensedaemons.
Iflicensingneedstobeupdatedlater,removethefileandinstallSentinelRMSservermanually.
Whenyouhaveinstalledtheproduct,youneedtosettheenvironmentasdescribedbelow.
14|Installation1.
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.
StarttheProductTostartEclipse:1.
Double-clicktheproducticon(automaticallyinstalledonyourdesktop).
Note:Theinstallerautomaticallycreatesashortcuticonfortheproductonthedesktopfortheuserforwhichyourantheinstallscript.
Ifyouneedtocreatedesktopiconsforotherusers'desktopsonthesamemachine,oriftheiconwasnotcreatedonthedesktopfortherootuser,runthefollowingshellscriptastheuseryouneedtologinas:$COBDIR/bin/createdesktopicon.
shInstallingthesoftware1.
Giveexecutepermissionstothesetupfile:chmod+xsetup_visualcobol_deveclipse_2.
2_platform2.
Runthesetupfilewithsuperuserpermissions:.
/setup_visualcobol_deveclipse_2.
2_platformIfyoudon'trunthisassuperuser,youarepromptedtoenterthesuperuserpasswordduringtheinstall.
TheCOBOLenvironmentisinstalledbydefaultinto/opt/microfocus/product-name,(COBDIR).
AfullversionofEclipse,withtheMicroFocuspluginsalreadyinstalled,ispresentinthe$COBDIR/eclipsedirectory.
Toinstallinadifferentlocationusethe-installlocation="Location"parametertospecifyanalternativedirectorylocation.
Forexample:.
/setup_visualcobol_deveclipse_2.
2_platform-installlocation="fullpathofnewlocation"Note:Youcanusevariablesorthetildesyntaxforthepathfor–installlocation.
Forexample,thefollowingexamplesareequivalent:-installlocation="/home/myid/installdir"-installlocation="~myid/installdir"-installlocation="~/installdir"-installlocation="$HOME/installdir"Youcanseedetailsaboutwhichadditionalparameterscanbepassedtotheinstallscriptifyouenterthe-helpoption.
Note:TheinstallationofthisproductcouldaffecttheSafeNetSentinellicensedcomponentsrunningonyourmachine.
Duringinstallationlicensingisshutdowntoallowfilestobeupdated.
ToInstallation|15ensuretheprocessesrunningonyourmachinearenotaffected,youneedtousethe-skipsafenetoption,whichskipstheinstallationofSafeNet:.
/setup_visualcobol_deveclipse_2.
2_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:eclipseInstallingasanupgradeThisreleaseworksconcurrentlywiththepreviousversionofVisualCOBOL,soyoudonotneedtouninstallit.
Therearetwooptionsforinstallingthelatestversioninthiscase:MovetheexistinginstallationtoadifferentlocationandinstallthelatestversiontothedefaultinstalllocationspecifiedbytheCOBDIRenvironmentvariable(/opt/microfocus/VisualCOBOL,bydefault).
Thisensuresyoudonotneedtochangeyourenvironment.
Tomovetheexistingolderinstallationtoadifferentlocation:1.
Executethefollowingcommandasroot:mv/opt/microfocus/VisualCOBOL/opt/microfocus/VisualCOBOLversion2.
InstallthelatestversionasdescribedinthesectionInstalling.
Installthelatestversioninadifferentlocationandsettheenvironmenttopointtoit.
Todothis,runtheVisualCOBOLinstallerwiththe–installlocationoption:16|Installation1.
Executethefollowingcommand:.
/InstallFile-installlocation="/opt/microfocus/VisualCOBOL"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.
InstallingintodifferentEclipsepackagesMicroFocusVisualCOBOLusesEclipse3.
8,butitwillalsoworkwithEclipse3.
7.
IfyouwanttouseVisualCOBOLinEclipsepackagesbasedonversion3.
7,youmustalsoinstalltheVisualCOBOLupdatesite,andtheRSEandAspectJplugins.
ThefollowingsectionsshowhowtoinstallintoEclipse3.
8andintoEclipse3.
7.
Important:WerecommendyoubackupallexistingEclipseconfigurationfilesfirst.
1.
InstallVisualCOBOLasdirectedabove.
2.
CopytherequiredVisualCOBOLresourcestoyourexistingEclipseasfollows:ForUNIXenvironments1.
Extractthecontentsofthefollowing.
zipfilesin/opt/microfocus/VisualCOBOL/eclipsetoatemporaryfolder:ajdt_2.
1.
3_for_eclipse_3.
7.
zipRSE-runtime-3.
3.
zipUpdateSite.
zip2.
Copytheextractedfoldersto/eclipse/dropins.
3.
Renameeachofthefolders:Fromajdt_2.
1.
3_for_eclipse_3.
7toAspectJUpdateSiteFromRSE-runtime-3.
3toRSEUpdateSiteFromUpdateSitetoCOBOLUpdateSite4.
Movethethecontentsofthe/eclipse/dropins/RSEUpdateSite/eclipsefolderupalevel(thatis,to/eclipse/dropins/RSEUpdateSite)anddeletetheemptyfolder.
5.
Copytheeclipse.
inifilein/opt/microfocus/VisualCOBOL/eclipse/eclipseto/eclipse,overwritingtheexistingfile.
6.
Ifnecessary,editeclipse.
inisothatthe-vmparameterissettotherequisiteJavafolder.
3.
RestartEclipse.
UNIXInstallerIssuesLicensingDaemonIftheKornshellisnotinstalledonyourmachinewhenyouruntheinstaller,thelicensingdaemonwillnotbestarted.
Toresolvethisafteryouinstalltheproduct,installInstallation|17theKornshellandthenrunthe/var/microfocuslicensing/bin/startmfcesd.
shscripttostartthedaemon.
LicenseInfrastructureInstallerOnsomeSolarisplatforms,youcanreceivethefollowingerrormessagewhenSafeNetlicenseserverneedstobeinstalledorupgradedonyourmachine:tar:/safenet.
tar:NosuchfileordirectoryToresolvethisissue,waitfortheinstallationtocompleteandthenperformthefollowing:1.
NavigatetothesafenetdirectoryintheCOBDIRlocation.
2.
Withsuperuserpermissionsexecute:.
/MFLicenseServerInstall.
shLicenseServerYouneedtoconfigurethecomputerhostnametoensurethelicenseserverwillstartproperly.
Toavoidperformanceissues,"localhost"andthecomputerhostnamemustnotbothbemappedtoIPaddress127.
0.
0.
1.
Youshouldonlymap"localhost"toIPaddress127.
0.
0.
1.
Thefollowingisanexampleofhowtospecifytheseentriescorrectlyintheetc/hostsfile:127.
0.
0.
1localhost.
localdomainlocalhostIPmachinelonghostnamemachineshorthostnamewhereIPistheuniqueIPaddressofthecomputerinxx.
xx.
xx.
xxformat.
InstallingsilentlyYoucaninstallMicroFocusproductssilentlybyusingcommandlineparameterstospecifytheinstallationdirectory,userinformation,andwhichfeaturestoinstall.
YoucanusethefollowingcommandlineargumentstoinstallsilentlyonUNIX/Linux:–silent-IacceptEULAForexample,execute:setup_filename–silent-IacceptEULAAftertheinstallationiscompleteyoucaninstallthelicensesilentlybyexecutingthefollowingcommands:IfyouhaveaccesstotheInternetandanauthorizationcodeRunthefollowingasroot:cd/var/microfocuslicensing/bin.
/cesadmintool.
sh-authorizeAuthorizationCodeIfyoudon'thaveaccesstotheInternetbutdohavealicensestringRunthefollowingasroot:cd/var/microfocuslicensing/bin.
/cesadmintool.
sh-fFileNamewhereFileNameisatextfilecontainingallthelicensestringstobeused.
AfterInstallingIfyouhaveusedEclipsefromthesameworkspacebefore,theEclipseperspectivesettingsarenotresetafterinstallinganyMicroFocusproduct.
Topickupanynewfeatures,youmustresettheCOBOLperspectiveafterinstallation:1.
Opentheexistingworkspacewiththisproduct.
Youmayreceivesomewarningsorerrorswhichyoucanignore.
18|Installation2.
MakesureyouareintheCOBOLperspectivebyclickingWindow>OpenPerspective>COBOL.
3.
ClickWindow>ResetPerspective.
4.
ClickOK.
5.
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.
UninstallingNote:Beforeyouuninstalltheproduct,ensurethattheEnterpriseServerinstancesandtheMicroFocusDirectoryService(MFDS)arestopped.
Touninstallthisproduct:1.
ExecuteasroottheUninstall_VisualCOBOL2.
2.
shscriptinthe$COBDIR/bindirectory.
Note:TheinstallercreatesseparateinstallationsfortheproductandforMicroFocusLicenseAdministration.
UninstallingtheproductdoesnotautomaticallyuninstalltheMicroFocusLicenseAdministrationortheprerequisitesoftware.
TocompletelyremovetheproductyoumustuninstalltheMicroFocusLicenseAdministrationaswell.
TouninstallMicroFocusLicenseAdministration:1.
ExecuteasroottheUnInstallMFLicenseServer.
shscriptinthe/var/microfocuslicensing/bindirectory.
Thescriptdoesnotremovesomeofthefilesastheycontaincertainsystemsettingsorlicenses.
Youcanoptionallyremovetheprerequisitesoftware.
Forinstructions,checkthedocumentationoftherespectivesoftwarevendor.
Installation|19LicensingInformationNote:ThisreleaseusestheauthorizationcodefortheVisualCOBOL2.
0release.
ThelatestversionoftheSafeNetlicensingsoftwareisrequired.
SeeSoftwareRequirementsinthisdocumentformoredetails.
Ifyouareunsureaboutwhatyourlicensingpolicyisorwhatsortoflicenseyourequire,consultyourSystemAdministratororMicroFocusSupportLinetoobtainavalidlicense.
ToactivateVisualCOBOLPersonalEditionNote:HavingactivatedVisualCOBOLPersonalEdition,youcanuseitforalimitedperiodof365days.
Afterthisperiodyouwillneedtoenteranauthorizationcodeinordertocontinueusingit,eitherfora30-daytrialorfulllicenseofVisualCOBOL.
1.
StartVisualCOBOL.
IfyouhavenotinstalledalicenseforVisualCOBOL,startingtheIDEforthefirsttimeafteryouinstalltheproductopenstheMicroFocusVisualCOBOLProductLicensingdialogbox.
Ifyoucancelthisdialogbox,youcaninvokeitagainfromHelp>MicroFocus>ProductLicensing.
2.
ClickIwanttoactivatethefreeproduct.
3.
EnsurethattheemailaddressusedtoregistertheproductisintheEmailaddresstextentryfield.
Ifyouhaven'tregisteredyouremailaddressyet,clickregistrationpageandfollowtheinstructionsonthatpage.
4.
Selectoneofthefollowingoptions:AutomaticUsethisifyouhaveInternetaccess.
1.
ClickFinishtoactivateyourcopyofVisualCOBOLPersonalEdition.
ManualUsethisifyouarenotconnectedtotheInternet.
1.
ClickNextandthenclickSendemail.
ThisopensyourdefaultemailclientandcreatesanewemailfilledinwiththedetailstoemailtoMicroFocusaboutactivatingyourcopyofthefreePersonalEditionproduct.
2.
Sendtheemail.
3.
Ifthereisnomailclientinstalledonyourmachine,copytheemailaddress,thesubjectandtheexactcontentsfromtheEmaildetailsfieldsandpastethemintoanemailtosenttoMicroFocususingamailclientofyourchoice.
Donotmodifyoraddtothetext.
Youwillreceivearesponseemailwithinformationwithdetailsaboutyourauthorizationrequest.
4.
PastethebodytextoftheresponseemailintothetextentryfieldoftheManualActivationdialogbox.
5.
ClickFinish.
Youshouldreceiveamessagethattheactivationhasbeensuccessful.
6.
RestartEclipsetocompletetheactivationprocess.
20|LicensingInformationTorequestandactivatea30-daytriallicenseforVisualCOBOL1.
IntheIDE,clickHelp>MicroFocus>ProductLicensing.
ThisopenstheMicroFocusVisualCOBOLProductLicensingdialogbox.
2.
TypeyouremailaddressintheEmailaddresstextentryfield.
Youneedtousethesameemailaddressyouusedfortheregistration.
3.
Selectoneofthefollowingoptions:AutomaticUsethisifyouhaveInternetaccess.
1.
ClickFinishtoactivatethetriallicenseforVisualCOBOL.
Important:AfterclickingFinish,ifyouclicktheCancelbuttonintheprogressdialogboxtostoptheactivationprocess,thetriallicensemighthaveregisteredonMicroFocusserversbutnotyetberegisteredonyourmachine.
Ifyourequestatrialagainthenyoucangetamessagesayingthatatriallicensehasalreadybeenused.
Ifthishappens,youshouldcontactaMicroFocusSalesrepresentativetoobtainanewlicense.
YoucandothisbysendinganemailtoVCBuyNow@microfocus.
com,orselectingHelp>MicroFocus>BuyNowandusingthecontactoptionsinthedialogbox.
ManualUsethisifyouarenotconnectedtotheInternet.
1.
ClickNextandthenclickSendemail.
ThisopensyourdefaultemailclientandcreatesanewemailfilledinwiththedetailstoemailtoMicroFocusaboutactivatingyourtrialofVisualCOBOL.
2.
Sendtheemail.
3.
Ifthereisnoemailclientinstalledonyourmachine,copytheemailaddress,thesubjectandtheexactcontentsfromtheEmaildetailsfieldsandpastethemintoanemailtosendtoMicroFocususingamailclientofyourchoice.
Donotmodifyoraddthetext.
Youwillreceivearesponseemailwithinformationwithdetailsaboutyourauthorizationrequest.
4.
PastethecontentsoftheresponseemailintothetextentryfieldoftheManualActivationdialogbox.
5.
ClickFinish.
Youreceiveamessagethattheactivationhasbeensuccessful.
6.
RestartEclipsetocompletetheactivationprocess.
Afteractivation,youcanseehowmanydaysyourtriallicensehasremainingbyselectingHelp>MicroFocus>ProductLicensing,orbyusingMicroFocusLicenseAdministration.
TobuyandactivateafullunlimitedlicenseNote:YoucanonlyactivateafulllicensefromtheIDEifyouhaven'tyetactivatedPersonalEdition.
ToactivateafullversionatanyothertimeyoumustusetheMicroFocusLicenseAdministrationtool.
ForinstructionsonusingtheMicroFocusLicensingAdministrationTool,seeLicensingintheVisualCOBOLhelp.
LicensingInformation|211.
IntheIDE,clickHelp>MicroFocus>ProductLicensing>BuyNow.
ThisopenstheMicroFocusBuyNowdialogbox.
2.
EnsurethattheemailaddressyouusedtoregistertheproductisintheEmailaddresstextentryfield.
3.
ClickSendemail.
ThisopensyourdefaultmailclientandcreatesanewemailfilledinwiththedetailstocontactMicroFocus.
Sendtheemail.
Ifthereisnomailclientinstalledonyourmachine,youwillbepresentedwithatemplatethatincludestheemailaddressandsubjectlineforanemailtosendtoMicroFocususingamailclientofyourchoice.
YouwillbecontactedbyaMicroFocusSalesrepresentative.
TostartMicroFocusLicenseAdministrationWindowsFromtheWindowsTaskbarclickStart>AllPrograms>MicroFocusLicenseManager>LicenseAdministration.
Note:OnWindows8andWindowsServer2012,youusetheStartscreentoinvokeprograms.
UNIXLogonasroot,andfromacommandprompttype:/var/microfocuslicensing/bin/cesadmintool.
shInstallinglicensesIfyouhavealicensefileWindows1.
StartMicroFocusLicenseAdministration.
2.
ClicktheInstalltab.
3.
Dooneofthefollowing:ClickBrowsenexttotheLicensefilefieldandselectthelicensefile(whichhasanextensionof.
mflic).
DraganddropthelicensefilefromWindowsExplorertotheLicensefilefield.
Openthelicensefileinatexteditor,suchasNotepad,thencopyandpastethecontentsofthefileintotheboxbelowtheLicensefilefield.
4.
ClickInstallLicenses.
UNIX1.
StarttheMicroFocusLicenseAdministrationtoolandselecttheManualLicenseInstallationoptionbyentering4.
2.
Enterthenameandlocationofthelicensefile.
22|LicensingInformationIfyouhaveanauthorizationcodeAuthorizingyourproductwhenyouhaveanInternetconnectionNote:Thistopiconlyappliesifyouhaveanauthorizationcode.
Thefollowingproceduredescribeshowtoauthorizeyourproductusingalocalornetworklicenseserver.
Thelicenseserverissetupautomaticallywhenyoufirstinstalltheproduct.
Windows1.
StartMicroFocusLicenseAdministration.
2.
ClicktheInstalltab.
3.
TypetheauthorizationcodeintheEnterauthorizationcodefield.
4.
ClickAuthorize.
Ifyouchangethenameofthemachinerunningyourlicenseserverafterithasgrantedlicenses,thelicensesstopworking.
UNIX1.
StartMicroFocusLicenseAdministration.
2.
SelecttheOnlineAuthorizationoptionbyentering1andpressingEnter.
3.
EnteryourauthorizationcodeattheAuthorizationCodepromptandthenpressEnterAuthorizingyourproductwhenyoudon'thaveanInternetconnectionNote:Thistopiconlyappliesifyouhaveanauthorizationcode.
ThismethodofauthorizationisrequiredifyourmachinedoesnothaveanInternetconnectionorifnormal(automatic)authorizationfails.
Windows1.
StartMicroFocusLicenseAdministration.
2.
ClickManualAuthorizationontheInstallpage.
3.
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.
LicensingInformation|23UNIXInordertoauthorizeyourproductyoumusthavethefollowing: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.
24|LicensingInformationNewFeaturesinVisualCOBOL2.
2ACUCOBOL-GTCompatibilityThefollowingsupporthasbeenaddedtoVisualCOBOLinthisrelease:AccessingdatafilesthroughAcuServerYoucannowaccessyourACUCOBOL-GTdatafiles,bothsequentialandVisionfiles,throughAcuServer.
StandardlibraryroutinesSupportforthefollowinglibraryroutineshasbeenadded:C$GETPIDC$JUSTIFYC$LIST-DIRECTORYC$LOCKPIDC$REGEXPC$RUNC$SLEEPC$SYSTEMC$TOLOWERC$TOUPPERI$IOUsingVisionfileswithMicroFocusDataFileToolsYoucannowusesomeoftheDataFileToolsfunctionalitywithVisionfiles.
Youcan:ConvertVisionfilestoMicroFocusformatusingtheDataFileConverterandtheDFCONVcommandlineutility.
EditVisionfilesusingtheDataFileEditor.
Note:TheDataFileConverterandDFCONVcommandlineutilityoptionsareonlyavailableifyouhaveinstalledthefreeDataToolsAddPack;formoreinformation,seeDataTools.
COBOLSourceInformation(CSI)COBOLSourceInformation(CSI)providesaquickandeasywayofprovidingyouwithinformationaboutyourprogramwhenyouareworkingonit.
YouenteraqueryintheQuickBrowsedialogboxandCSIreturnstheresultsofthequeryintheSearchview.
CompilerDirectivesThefollowingCompilerdirectivesarenew:ACU-UNDERSCOREThisdirectivetreatsunderscoresinCOBOLwordsashyphens.
NewFeaturesinVisualCOBOL2.
2|25ILSHOWPERFORMOVERLAPThismanagedCOBOL-onlydirectivegeneratesawarningwhenanoverlappingPERFORMrangeisdetectedintheprogram.
ILEXPONENTIATIONThismanagedCOBOL-onlydirectiveenablesyoutooptimizeexponentialarithmeticoperationsbyspecifyingthecalculationmethodused.
EXITPROGRAMThisdirectivedetermineshowtheEXITPROGRAMstatementisexecuted.
ThefollowingCompilerdirectiveshavechanged:CHANGE-MESSAGEThescopeofthisdirectivehasbeenwidenedtoallowyoutochangetheseverityofdifferenttypesoferrormessages,notjustsyntaxcheckingmessages.
DIALECT"RM"DIALECT"RM"nowsetsPERFORM-TYPE"RM".
IfyourecompileanapplicationthatusesDIALECT"RM",thebehaviormaychangefornestedPERFORMstatements.
Ifthatisthecase,explicitlysetPERFORM-TYPE"MF"afterDIALECT"RM"tocontinuewiththepreviousbehavior.
HIDE-MESSAGEThescopeofthisdirectivehasbeenwidenedtoallowyoutohidedifferenttypesoferrormessages,notjustsyntaxcheckingmessages.
PRESERVECASEThisdirectivenowdefaultstoPRESERVECASEwhencompilingnativeCOBOL;managedCOBOLcompilationalreadydefaultstoPRESERVECASE.
Thisresultsinexternallyvisibleidentifierspreservingtheircaseinsteadofbeingconvertedtouppercase.
ConsolidatedTracingFacilityThefollowingchangeshavebeenmadetotheConsolidatedTracingFacility(CTF):CTFforJVMCOBOLapplicationsCTFtracingisnowsupportedinJVMCOBOLapplications.
NewemittersAnewemitter,JAVALOGGER,isavailableforJVMCOBOLwebapplications.
ThisemitterpassesdetailstotheJavaloggingAPIthatisavailablethroughyourwebserver.
UsethisemitterifyouareunabletoconfiguretheTEXTFILEorBINFILEemittersduetowebserverpermissionrestrictions.
NewpropertiesandvariablesforexistingemittersThefollowingsupporthasbeenaddedtoexistingemitters.
PropertiesThefollowingpropertyhasbeenaddedtotheBINFILEemitter:PropertyDescriptionRunUnitIDControlswhethertheRunUnitinformationisincludedinthetrace.
VariablesFournewpseudo-variablesfortheFILEpropertyhavebeenaddedtotheBINFILEandTEXTFILEemitters:26|NewFeaturesinVisualCOBOL2.
2pseudo-variableDescription$(PLATFORM)Aplatformspecificconstant,usefulwhentworun-timesystemsareinthesameprocess,andyourequireseparatetracefiles$(RUNUNIT)AuniquenumberthatrepresentsthemanagedRunUnitID$(RUNUNIT_SESSIONNAME)ThesessionnamepassedtothemanagedRunUnit$(RUNUNIT_GUID)ThegloballyuniqueidentifierassociatedwiththemanagedRunUnitEnhancedACCEPTandDISPLAYStatementsTwooftheexistingEnhancedACCEPTandDISPLAYsettingsavailablethroughAdishaveadditionalvalues,whichareaimedatRM/COBOLusersmigratingtheirsourcecodetoVisualCOBOL.
Thenewvaluesare:EmulationofRM/COBOL-85styledataentryfornumericdataentryonACCEPTstatements.
EmulationofanRM/COBOLbackspaceinfreeformatfieldswheninreplacementeditingmode,inthatdeletedcharactersareremovedandcharacterstotherightareshiftedleft,thesameaswhenininsertioneditingmode.
Formoreinformationonhowtosetthesevalues,refertoConfiguringEnhancedACCEPTandDISPLAYFileHandlingNewfeaturesinclude:ConvertingandeditingVisionandRM/COBOLindexeddatafilesusingtheDataFiletoolsisnowsupported.
Accesstodatafiles(eithersequentialorindexed)throughAcuServerisnowsupported.
AccesstoVisionandRM/COBOLindexeddatafilesthroughEnterpriseServerisnowsupported.
InterfaceMappingToolkitRestriction:ThistopicappliesonlywhentheEnterpriseServerfeatureisenabled.
VisualCOBOLnowsupportsthecreationanddeploymentofCOBOLprogram-basedservicesusingtheInterfaceMappingToolkit(IMTK).
ManagedCOBOLDocumentationAguidethatprovidesabasicintroductiontoObject-OrientedProgramming(OOP)forCOBOLdevelopers,AnIntroductiontoObject-OrientedProgrammingforCOBOLDevelopers,withexamplesisnowavailablefromtheProductDocumentationsectionontheMicroFocusSupportLineWebsite-clickheretodownloadit.
NewFeaturesinVisualCOBOL2.
2|27NamedandoptionalparametersTwonewtypesofparameterhavebeenintroducedforuseduringmethodinvocation:NamedparametersAspartoftheinvocationexpression,youcandefineavalueforaparameternamedinthemethoddefinition.
Thenamedargumentmustbespecifiedafteranypositionalarguments,andmustnotcorrespondtoanyofthoseprecedingarguments.
OptionalparametersOptionalparametersareparametersdefinedwithadefaultvalueintheproceduredivisionheaderoftheinvokedmethod.
Ifnoneoftheargumentspassedinduringinvocationcorrespondtothisparameter,thedefaultvalueisusedinthemethod;ifanargumentdoescorrespond,thevaluethatwaspassedinisused.
DelegatesandeventsAnumberofnewfeatureshavebeenaddedthatrelatetodelegatesandevents:Note:SomeofthesefeatureswerealsoavailableinpreviousversionsofVisualCOBOL.
TheATTACHandDETACHstatementsUsethesestatementstoattachordetachadelegate,methodgrouporananonymousmethodtoorfromanevent.
TheRUNstatementUsethisstatementtoinvokeadelegateonceithasbeencreated.
CombiningdelegatesUsethe'+'operatortoaddamethodgroup,anonymousmethodoranotherdelegatetoadelegate,andusethe'-'operatortoremoveamethodoranotherdelegatefromadelegate.
MethodgroupsconversionsUsetheMETHODkeywordtospecifyacompatiblemethodfromamethodgroup,andconvertittoadelegate.
ProblemsViewTheProblemsviewnowhasa'Program'columnthatdisplaysthenameoftheprograminwhichtheproblemoccurred.
Clickthiscolumnheadingtosorttheerrorsbyprogram.
Ifthecolumnisnotpresentintheviewbydefault,youcanadditthroughtheConfigureColumnsdialogboxintheViewMenu.
28|NewFeaturesinVisualCOBOL2.
2SupportforSOARestriction:ThistopicappliesonlywhentheEnterpriseServerfeatureisenabled.
VisualCOBOLnowincludessupportforcreatingWebserviceandEnterpriseJavaBeanapplicationsusingtheInterfaceMappingToolkit(IMTK)inconjunctionwithEnterpriseServer.
IfyouareupgradingtothisreleasefromanearlierversionofVisualCOBOL,youmayneedtoapplyforanewauthorizationcodeinordertoaccessthefunctionality-pleasecontactMicroFocusSupportLinetoreceiveanupdatedauthorizationcode.
NotethattheVisualCOBOLPersonalEditionlicensedoesnotsupporttheIMTKfunctionality.
XMLExtensionsYoucannowuseXMLExtensionsinyourmanagedCOBOLprojects.
UseXMLExtensionstoimportandexportXMLdocumentstoandfromCOBOLworkingstorage.
Specifically,XMLExtensionsallowsdatatobeimportedfromanXMLdocumentbyconvertingdataelements(asnecessary)andstoringtheresultsintoamatchingCOBOLdatastructure.
Similarly,dataisexportedfromaCOBOLdatastructurebyconvertingtheCOBOLdataelements(asnecessary)andstoringtheresultsinanXMLdocument.
WhileimportingorexportingdatatoorfromXMLdocuments,youcanapplyXSLTtransformstothedatabyusingXSLTstylesheets.
Formoreinformation,refertotheXMLExtensionsUser'sGuide,availablefromtheproductdocumentationsectionoftheSupportLinewebsite(http://SupportLine.
MicroFocus.
com/ProductDoc.
aspx)NewFeaturesinVisualCOBOL2.
2|29KnownIssuesRefertotheKnownErrorsandRestrictionstopicintheProductInformationsectionofyourproductHelp.
Inaddition,notethefollowing:AcuCOBOLFileHandlerWhenusinganinterfaceofACUFHotherthanMSSQL,youmayexperienceafileoperationdelaywhentheinterfacefailstoconnecttoadatabase.
Thisfailedconnectionalsoresultsinamemoryleak.
SettheenvironmentvariableMSSQL_DETACHto1toavoidbothissues.
COBOLWatchpointsThedebuggerignoresaCOBOLwatchpointthatishitifthereisnostatementfollowingthestatementthatmodifiesthedataonwhichthatwatchpointisset.
CompilerWhenrunningwithJava1.
7,ifyourclasscontainsastaticmethodcalled'main'withasinglestringarrayparameter,inorderforthisclasstobeexecutablefromthecommandlinethatmainmethodshouldnothaveareturningitem.
DebuggingThereisanissuewith"Waitforattachment"whenyouuseVisualCOBOLforEclipsetodebugapplicationsthatrunonsomeUNIX/Linuxplatforms.
Eclipseconnectstothedebuggerontheremotemachine,butmightnotattachtotheprocesstodebugthecode.
Toworkaroundthisissue,ensurethatontheremotemachinetheTMPDIRenvironmentvariableisunsetorhasthesamevalueforbothMicroFocusVisualCOBOLDevelopmentHubserverandfortherunningprocessyouwishtodebug.
TheMicroFocusVisualCOBOLDevelopmentHubserveristheserverwhichyoustartedeitherdirectlywiththe$COBDIR/remotedev/startrdoserverscriptorindirectlyusingthedaemonwhichisstartedwiththe$COBDIR/remotedev/startrdodaemonscript.
TocheckthevariableusedbytheMicroFocusVisualCOBOLDevelopmentHubserver:1.
OpenRemoteSystemsviewinEclipseontheWindowsmachine.
2.
Right-clicktheShellselementoftheserverconnectiontobetestedandclickLaunchShell.
3.
IntheRemoteShellview,typeecho$TMPDIRintheCommandfield,andpressEnter.
ThevalueoftheTMPDIRenvironmentvariableisshown-ensureitisthesameastheoneusedbytheprocesstobedebugged.
Note:ThevalueofTMPDIRusedbytheDevelopmentHubservercannotbechangedintheremoteshellandmustbesetbeforeyoustartthedaemonorserver.
DatabaseAccessIfyouhavearemoteCOBOLprojectunderEclipsethatusesDB2ECMinVisualCOBOLorHCOforDB2LUWinEnterpriseDeveloperandtheDB2softwareisnotinstalledontheclientmachinewhereyouareusingtheEclipseIDE,youreceivebackgroundparsingerrorsinyourapplication.
Toresolvetheissue,youcandoeitheroneofthefollowing:DisablebackgroundparsingWindow>Preferences>MicroFocus>COBOL>EditoranddisablingthecheckboxforBackgroundparsing.
30|KnownIssuesInstalltheIBMDB2client-sidesoftwareonthemachineonwhichyouarerunningEclipse.
GototheIBMSupportHomeandlocatethepageentitled"IBMDownloadFixPacksforIBMDataServerClientPackages".
EnterpriseServerTheHistoricalStatisticsFacilitymaygenerateincorrectrecordsforSSTM-enabledenterpriseservers.
ICETOOLEmulationICETOOLemulationformanagedcodeisnotavailableinthisrelease.
InstallationOnUNIX,checkUNIXInstallerIssuesbeforeyoustarttheinstallation.
IfyouareusingthelatestversionofJava1.
7onLinux,youmightreceivesomewarningswhenyoustartthisproduct.
Toresolvetheissue,itisrecommendedthatyouinstallanearlierversionofJava1.
7andsetJAVA_HOMEtothat.
ResourceAdaptersTryingtodeploythelocalresourceadaptormfcobol-localtx.
rartoWebLogicmayfailwithaClassCastException.
Toworkaroundthisissue,youneedtodeploymfcobol-xa.
rarfirst,thenneedtoundeploythisfileanddeploythelocalone,mfcobol-localtx.
rar.
IfthereareissuesdeployingusingtheWebLogicGUI,youcanusethecommandline.
Ifthereareissueswiththisaswell,tryreducingthelengthofthecommand(forexample,bymovingthefiletoalocationwithashorterpath).
KnownIssues|31SignificantChangesinBehaviororUsageThissectiondescribessignificantchangesinbehaviororusage.
Thesechangescouldpotentiallyaffectthebehaviorofexistingapplicationsorimpactthewaythetoolsareused.
ThenumbersthatfolloweachissuearetheSupportIncidentNumbersfollowedbytheReportedProblemIncident(RPI)number(inparentheses).
CCISessionLayerCodeCompilerEclipseIDEMFDirectoryServerMFServerAdministrator(GUI)MFBSIMTO-IMSOtherMTO-JCLMVSMTO-JCLSystemCatalogOpenPL/ICompilerOpenPL/IDebuggerOpenPL/IRTSRequestHandlerCCISessionLayerCodeBacktothelistAnewoption,use_global_namespace,isavailableforthecci.
inifileintheWindows%SystemRoot%folder.
Ifuse_global_namespaceisset,alltheccisharedmemoryobjectsarecreatedinasystem-wideaddressspace,andtheapplicationshostedbydifferentusers,includingsystemservices,cancommunicate.
Tousethisfacility,editthecci.
inifileandensureuse_global_namespaceissetto"yes".
[ccismem-base]#Allowinteractionbetweenusersona#singlesystem.
Usingthisoptionreducessecurityas#alluserswillhaveaccesstothesamenamespace.
use_global_namespace=yesIfthevalueofthisoptionisanythingotherthan"yes",oriftheoptionismissing,nochangeismadetotheexistingbehavior.
2195519(1062800)CompilerBacktothelistThedefaultfortheNSYMBOLdirectiveunderDIALECT(ENTCOBOL)hasbeenchangedtoNSYMBOL(NATIONAL)toemulatetheequivalentIBMdefault.
2657471(1090355)ToimproveRM/COBOLandACUCOBOLcompatibility,theSIGNclauseatagrouplevelisnolongerappliedtonon-DISPLAYusagesignednumericdataitemswithinthegroup,justasitisnotappliedtounsignednumericdataitemsandnon-numericdataitemswithinthegroup.
2549904(1082171)Previously,eventhoughnocodewasgenerated,theCompilerallowedtheONEXCEPTIONandNOTONEXCEPTIONphrasesintheDISPLAYstatementinformatsthatdonotallowthesephrases.
Asaresult,iftheDISPLAYstatementwasintheONEXCEPTIONphraseofanotherstatement,theNOTONEXCEPTIONphrasewouldbindincorrectlywiththeDISPLAYstatementinsteadofwiththeintendedcontainingstatement-forexample,ACCEPTorCALL.
32|SignificantChangesinBehaviororUsageEclipseIDEBacktothelistTheProblemsviewnowhasa'Program'columnthatdisplaysthenameoftheprograminwhichtheproblemoccurred.
Ifthecolumnisnotpresentintheviewbydefault,itcanbeaddedthroughtheConfigureColumnsdialogboxintheViewMenu.
2608496(1088530)TheoutlineoftherulerintheCOBOLeditornowchangesonmodelChangeddependingonthecurrentsourceformat.
2488419(1077143)DeletingaWebserviceoraJavainterfacemappingnowdeletesthefilesrelatingtoitfromthereposdirectoryand,ifitisemptyafterthefileshavebeendeleted,willremovethereposdirectoryitself.
TheIDEnowperformsanautomaticdirectivedeterminationwhenfilesareaddedtoaproject.
Youcanalsouseacommandtoperformdirectivedeterminationoftheprojectmanually.
MFDirectoryServerBacktothelistThemfdscommandlineoptionforexportingregisteredEnterpriseServerdefinitionstoanXMLfilenowsupportsthe"*"option.
Thisexportsallregisteredserversratherthanaspecifiedserver.
MultipleserverdefinitionsarenowexportedintothetargetdirectoryandsavedintoafilewiththedefaultnameALLSERVERS.
xml.
TheimportoptionnowalsosupportstheimportofmultipleserverdefinitionsfromasingleXMLfile.
2641890(1088838)mdumpnowsupportsanewoption,-e,tohelpyouquerytheSecurityManagerconfigurationdetails.
Thepossiblevaluesoftheoptionare:"1"-showssecurityconfigurationthatappliestoanyreturnedenterpriseservers;"2"-showssecurityconfigurationforMFDSandthedefaultEnterpriseServersecurityconfiguration.
ThisrequiresMFDSversion1.
15.
00orhigher;"3"-returnsthepropertiesofallconfiguredexternalSecurityManagers.
2487164(1081693)MFServerAdministrator(GUI)BacktothelistWhenaddingausertoanexternalsecuritymanager,youcannowincludeapasswordexpirytimeintheAdvancedConfigurationsectionoftheAddNewUserwizardinEnterpriseServerAdministration.
Thefieldvalueisspecifiedusinggeneralizedtimeformat(YYYYMMDDHHMMSS.
0Z),andcanbeusedbytheMLDAPESMforcalculatingwhetherauser'spasswordhasexpiredandrequiresupdating.
Thisvaluemayonlybespecifiedusingthispagewhenaddingauser.
Youneedtouseanexternaldirectoryservicesconfigurationtooltoeditit.
2562118(1083203)RequestHandlerBacktothelistAproblemthatcausedBIStocreatelogfilesinadirectorynamedC:\ProgramData\AcuCorp\BIS\LogFileswasfixed.
BISnolongercreateslogfilesunlessspecifiedandtheBISloggingserviceisnowdisabledbydefault.
Toenableit,youneedtousethefollowingglobalenvironmentvariable:BIS_LOG=[OFF|ON|]Wherethevaluesare:OFF-disableslogging(thesameasifBIS_LOGisnotspecifiedorisleftblank)ON-enableslogginganddirectsthelogfilesintothedefaultlocation,whichmustnotberead-only.
SignificantChangesinBehaviororUsage|33-enableslogginganddirectsthelogfilesintothespecifieddirectory.
TheusermustensurethattheBISrequesthandlerhaswriterightsforthisdirectory.
Thedirectorymustbeanabsolutepathornetworkpath.
Ifthespecifieddirectorydoesnotexist,BISwillattempttocreateit.
Thecontainingdirectorymustexist.
TheBIS_LOGvariableisonlyexaminedwhentheBISapplicationpoolisstartedorrecycled.
AftersettingorchangingBIS_LOG,IISmustberestartedinorderforthevariabletotakeeffect.
34|SignificantChangesinBehaviororUsageResolvedIssuesThenumbersthatfolloweachissuearetheSupportIncidentNumbersfollowedbytheReportedProblemIncident(RPI)number(inparentheses).
AdisAnimator(Characterversion)CAS(COBOLAppServer)GeneralCASSecurityCASXASwitchmodulesCCITCP/IPCompilerCob/Cbllink/Cblnames(32-bitPC)DataToolsConverterDataToolsEditorDataToolsLayoutsDocumentationEclipse-DebugEclipseIDEFileHandling-ExternalFileHandlerFileHandling-FileshareIDEDebuggingJVM-CompilerJVM-RTSMFCommonClientMFCommunicationsServerMFDirectoryServerMVSREXXEmulationNCGRTSSamplesBrowserSetupIssuesSetupIssues(UNIX)SQL:DB2ECMSQL:OpenESQLVisionFileSystemXMLExtensionsXMLsyntaxsupportruntimeAdisBacktothelistStatementsoftype"DISPLAYSPACESATLINE.
.
.
POSITION.
.
.
SIZE.
.
.
"nowonlyclearthescreenatthespecifiedcoordinatesandforthespecifiedsize.
2644054(1089103)TheCompilerandADISnowsupportRM/COBOLACCEPTandDISPLAYbehavior,includingwhentheCompilerDIALECT(RM)directiveandtheRM2VCOBconfigurationinADISCTRLarebothused.
2616898(1088510)ResolvedIssues|35Animator(Characterversion)BacktothelistAnimatornowdisplaysthecorrectprogramnameonthestatusbar.
2475333(1076125)AnerrormessageisnowdisplayedifthereisaproblemaccessingtheterminalwhenanimatingusingCharacterAnimator.
2050690(1050314)CAS(COBOLAppServer)GeneralBacktothelistcasgatenolongercrasheswhenitreceivesashutdownrequestfromMFCS.
2657261(1090327)WhenanMFCSprocessterminatedwhileitwasprocessinganEZASOKETfunctionforanapplication,theSEPremainedinawaitingstateindefinitely.
RecoveryprocessingnowdispatchestheSEPwithaTERMAPI.
2653313(1090061)EZASOKETapplicationsarenowtiedtoasinglecommsprocessforthelifeofatask.
Previously,intheeventofterminationofacommsprocess(iftheprocesswasnotbeingusedbyanactiveEZASOKETapplication),recoverywouldcauseanyactiveEZASOKETapplicationstodispatchthenewcommsprocessonthenextEZASOKETcall(whichwouldthenfail)ratherthantheoneitwasalreadyusing.
2653313(1090060)WhenanenterpriseserverwasprocessingaverylargenumberofJCLjobsforthesameclass,ajobcouldbelockedfordispatchinSYSZJOBDforever.
2617413(1088420)TheEZsocketsSELECTandSELECTEXAPIsnowduplicatemainframebehaviorinignoringmaskbitsthatdonotcorrespondtoallocateddescriptors.
Thismeans,forexample,thatSELECTcanbepassedasamasksetto-1(allbitsset)torefertoanysocketstheapplicationhasopen.
2609555(1087715)Aproblemwithsubmittingjobswhen"LocalESSecurityenabled"ischeckedformfuserontheUserspageinESMAChasbeenresolved.
2605873(1087287)Jobsactiveduringshutdownaremovedbacktotheinputqueuewhentheserverrestarts.
2588701(1085584)Previously,whenretrievingthespoolinformation,thetextofsomeerrormessageshasbeentruncated.
2582713(1085017)LogginghasbeenaddedfortheresourcemanagerstofacilitaterecoveryfromfailuresthatleavetheresourcemanagerssuchasDB2andMQwithin-doubttransactions.
Youonlyneedtologiftheresourcemanagerswitchmodulesareconfiguredtorespondtoxa_recover()calls.
Loggingmayaffecttheperformancesoyoucandisableitasfollows-edittheserverfromtheEnterpriseServerAdministration,clicktheGeneraltabandtypethefollowingintheConfigurationInformationtextbox:[ES-Environment]ES_XA_LOG_SUPPRESS=Y2582570(1085539)IfyoudefineanXAresourcedefinitioninMFDSforMQSeries,youmustdeselectIBMMQintheSITdefinitioninESMAC,otherwiseyouwillgeta-5errorwhentheXASwitchisused.
CASSecurityBacktothelist36|ResolvedIssuesA"redundant"or"high-availability"modeisnowavailableintheEnterpriseServerExternalSecurityFacility.
ItenablesyoutoconfiguremultipleequivalentSecurityManagersandletprocessingcontinueaslongasatleastoneSecurityManagerisavailable.
Toenablethisfeature,addthefollowingtotheconfigurationtextareaforthesecurityconfiguration(eitherinthedefaultEnterpriseServerSecurity,theMFDSSecurity,orontheSecuritytabforaspecificenterpriseserver):[Operation]redundant=yes2646298(1089343)Previously,whenusingIMSwithLDAP-basedsecurity,thesystemcouldsometimesstopprocessingrequestsforfourminutes,andthenissueaseriesofmessagesintheconsolelogtoindicatethatthreadshadtimedoutwaitingforathreadlock.
Thesystemwouldthengenerallyrecoverandstartprocessingagain.
2640581(1089108)ThefixforthisRPIaddressesthefollowingspecificsituations:1.
InstallationwithanESMthatisnotcasesensitiveforuserIDs(forexample-whensysad,SYSAD,SysAdandothercasecombinationsareallrecognizedbytheESMasthesameuser).
2.
InstallationswherealluserIDsareofathesamecase-eitheruppercaseorlowercase.
3.
InstallationswheretheuserIDsareofmixedcaseandyouwouldliketosuppressanyadditionalESMauthorizationattemptsforkeyingerrors.
4.
OnlyESM-backedsecurityisaffected.
Youcannowusetheenvironmentvariable"ES_ESM_IDPW_CASE=xy"where"x"=user;IDcaseand"y"=Passwordcase.
Thevaluesfor"x"and"y"are:U=AlwaysuppercaseL=AlwayslowercaseM=MixedcaseandcasesensitiveWhenthisenvironmentvariableisset,EnterpriseServerwillonlymakeoneattempttoidentifyauserpresentingtheuserIDandpasswordasis(M),foldedtouppercase(U)orfoldedtolowercase(L).
Ifthisenvironmentvariableisnotset,thelegacyEnterpriseServerbehaviorwillbeused.
ForthelegacybehaviorforCICS,theUserIDandthepasswordareusedassuppliedpossiblyfilteredbytheuppercasetranslationconfigurationofthesign-ontransaction.
ForthelegacybehaviorforESMACandIMSyouhavethefollowingsequence-first,theuserIDandpasswordareusedassupplied.
Iftheauthenticationfails,theUserIDisfoldedtouppercaseandusedagain.
Ifthisfailsaswell,boththeuserIDandthepasswordarefoldedtouppercaseandtheused.
2640427(1088819)ForEnterpriseServerExternalSecurity,theMLDAPESMModulenowsupportsretryingtheconnectiontotheLDAPserverifitfailstoconnect.
Thisprovidessomefaulttoleranceiftheserverisnotimmediatelyreachable.
SeetheMLDAPESMModuledocumentationformoreinformation.
2619088(1088485)WhenusinganExternalSecurityManager(ESM),anIMSprinternolongerpassesauthorizationincorrectlywhenitisunknowntotheESM.
2617526(1088978)WhentheLDAP-basedsecurityhasalongtimeout(overfourminutes)configuredforLDAPoperations,theESFManagernowincreasesthetimeoutforthreadlocksaccordinglysothreadlocksdonotexpireprematurelywhiletheMLDAPESMModuleiswaitingforaslowLDAPserver.
InEnterpriseServer'sExternalSecurityFacility,theMLDAPESMModulenormallyattemptstosetauser'sfailed-logincountandlast-login-timeiftheuserclassincludestheassociatedLDAPattributes(microfocus-MFDS-User-LoginAttemptsand-LastLoginTime).
YoucannowdisablethisfromtheSecurityManagerconfiguration.
SeethedocumentationfortheMLDAPESMModuleformoreinformation.
Thecas-to-adutility,whichisusedwheninitiallyconfiguringLDAP-basedsecurityforEnterpriseServer,nowpicksupthecorrectpathforthedefaultlocationoftheCICSresourcedefinitionfile(dfhdrdat).
ResolvedIssues|37CASXASwitchmodulesBacktothelistIfaROLLBACKisalreadyinoperationwhenanXAROLLBACKisrequested,EnterpriseServerseestherollbackasbeingsuccessful.
2653121(1089931)TheXDBXAswitchmodulewasupdatedtoaddamissingvariabledefinitionwhichpreventedcompilation.
2638370(1088599)CCITCP/IPBacktothelistCCITCPnowsupportsmorethan4000clientsperserverprocessonUNIXsystems.
CCITCP'smemoryconsumptionwithlargenumbersofclientsshouldalsobereduced,comparedwithpreviousreleases.
2589460(1089134)CCIhasbeenextendedtoallowtheusertotunethecontentandlocationoffirstfailureerrormessagesproducedbyCCI.
Thisiscontrolledbytheerrlog_pathoptioninthecci.
iniconfigurationfile.
2083845(1053206)CompilerBacktothelistProgramswithdatanamescontainingcertainDBCScharactersnowcompileasexpected.
Previously,theywouldincorrectlyreporterrormessage"COBCH0005User-namenotunique.
".
2663436(1090882)VALUEclausesonTHREAD-LOCALdataitemsarenowalwayscorrectlyinitializedonaperthreadbasis.
2659874(1090647)DebuggingwithExpressionviewexpandedtoshowmanyqualificationlevelsofadatarecordnolongercausestheIDEtocrash.
2659532(1090682)AMOVEofanumericliteraltoaJUSTIFIEDRIGHTdataitemnowexecutesasexpected.
2658757(1090641)TheMOVELENCHECKdirectivenowalsoincludescheckingwhenthesourceitemisanalphanumericliteral.
2656595(1090311)WhencompilingwithDIALECT"ACU",acomparisonbetweenanumericitemandthefigurativeconstantNULLnowworksasexpected.
2653033(1089923)Comp-1dataitemsarenowprocessedcorrectlyunderDIALECT"RM".
Previously,theyweretreatedasbinaryfloatingpointitems.
2652327(1089892)PreprocessorsnowworkasexpectedwiththeDIALECT"ACU"compileroption.
2649324(1089577)TheDIALECT(RM)directivenowsetsPERFORM-TYPE(RM).
2647147(1089366)38|ResolvedIssuesLargeEXECstatementscontainingDBCScharactersnowcompilewithouterror.
2645584(1089204)ListfileoutputwiththeDATAMAPdirectiveisnowshowncorrectlyforSJISdatanames.
2643308(1088962)TheDBCShyphencharacterx"817C"isnowtreatedasoccupyingthecorrectnumberofcolumnpositions,andsopreventsspuriouscompileerrorsforcommentsinAreaC.
2642431(1088863)ProgramsusingACUCOBOL-GTindexnamesnowexecuteasexpected.
2641124(1088755)AVALUEclauseonanationaldataitemthatspecifiesafigurativeconstantnowworksasexpected.
2640826(1088820)An"outofmemory"errorwhencompilingACUCOBOL-GTprogramswithbothCOPYREPLACINGandREPLACEstatementshasbeenfixed.
2640304(1088671)$DISPLAYofSJIScharactersnowworksasexpected.
2640050(1088644)TabcharactersonthesamelineasDBCScharactersnolongercausemarginissues.
2638792(1088607)ThemaximumnumberofextensionssupportedbytheCOPYEXTdirectivehasbeenincreasedto25.
2618274(1088353)LiteralsassignedtoDBCSdataitemsarenowcheckedforvalidcontent.
2618240(1088339)WhenrunningunderRM/COBOLorACUCOBOL-GTemulation,appropriatedeclarativesarenowexecutedforanunsuccessfulDELETEFILEoperation.
2616717(1088313)TheemulationofRM/COBOLhasbeenimprovedregardingthedefaultencodingofnumericstypes.
2607368(1088045)Preprocessor-generatederrormessagesnowappearcorrectlyintheEclipseIDE.
2603384(1087029)Theerrormessageforwhenspecialregisternamesareusedasdata-nameshasbeenimproved.
2599694(1086646)Aqualifiedreferencetoaparagraphinanothersectionfollowedbyanunqualifiedreferencetothesameparagraphnowcompileswithouterror.
2598461(1086498)Displaystatementsarenowdisplayedcorrectlywhenusingthewindow1preprocessor.
2591903(1085826)Asyntaxerrorisnowproducedifyouattempttouseadataitemwithmorethan18numericpositionsinextendedACCEPT/DISPLAYsyntax.
2590649(1085688)TheCOPYstatementnolongerrequiresKatakanacharactersinacopybook'snametobeenclosedinquotationmarksinorderforthecopybooktobefound.
2582689(1085009)Withregardstofilehandling,theDIALECT(RM)compilerdirectivenowbetteremulatesthedefaultbehaviorofthelatestRM/COBOLproduct.
2582096(1084955)ResolvedIssues|39AnerrorwithEXTERNALfileswherethefdnameisthesameasthenameofanOSfunction(e.
g.
sinorstrcpy),whichcausedanrtserror114,hasbeenfixed.
2492339(1077479)AnerrorinADDstatementswithmultipletargets,whereoneofthetargetshasasubscriptedsubscript,hasbeenfixed.
2189318(1062255)Errormessages'RTS226Externalfiledefinitioninconsistent'and'RTS227Externaldatadefinitioninconsistent(Fatal)'havebeenenhancedtogiveadditionalinformation.
2188868(1062214)ParsingandconsistencycheckingoftheFOREGROUND-COLORattributeinDISPLAYstatementshasbeenimproved.
TheCompilernolongercrasheswhenprocessingtheUSECompilerdirectiveandthespecifieddirectivefiledoesnotexist.
UnderaShift-JISlocale,youcannowsuccessfullycompileaprogramcontainingtildecharacters.
EXECstatementsarenowsubjecttotheactionofREPLACEstatements(INCLUDEnamesexcepted).
AnINSPECTstatementwithboth'TALLYING.
.
FORTRAILING.
.
'and'REPLACINGTRAILING.
.
'syntaxnowcompilessuccessfullyandexecutesasexpected.
TheCHANGE-MESSAGEandHIDE-MESSAGEdirectiveshavebeenenhancedtoallownon-severeSQLandCICSerrorstobeconfigured(theirseveritychangedorcompletelysuppressed).
Thiscanbeachievedusingtheerrormessage's2-charactersub-componentprefix;forexample,CHANGE-MESSAGE(ES1000N).
Ifnoprefixisspecified,CHisassumed.
YounowreceiveawarningwhenyouuseaTYPEDEF-NAMEasaparameterforthePROCEDUREDIVISIONheaderofanENTRYstatement,exceptforexternalprogramsorprogramprototypeswherethissyntaxislegal.
TheCompilernolongercrasheswithanRTS114errorafterfindingmultipleReportWritersyntaxerrors.
Aerrorprocessingabitwiselogicalexpressionthathasasubscriptedoperandwherethesubscriptisanarithmeticexpressionhasbeenfixed.
Cob/Cbllink/Cblnames(32-bitPC)BacktothelistCBLLINKnolongergivesanerrorwhenanobjectfileisspecifiedinafullyqualifiedpathcontainingadot.
2605052(1087384)DataToolsConverterBacktothelistDFCONVnolongerfailsonnon-IntelbyteorderprocessorswhentheconversionusesanSTRfile.
2658596(1090476)ConvertingaMainframe-Report-ANSIfiletoaPC-PrintfilewherethefilebeginswithaformfeednolongerresultsinalinefeedbeinginsertedinthePC-Printfilebeforetheformfeed.
2652812(1089911)TheDataFileConverternolongerfailswithDFC661Errorduringconversionwhenexecutedin64-bitmode.
2649118(1089569)dfconvnolongerfailswith"DFC161Errorduringconversion"iftheprofilefileextension(.
PRO)isnotinuppercaseonUNIXandLinuxplatforms.
2642112(1088846)40|ResolvedIssuesDataToolsEditorBacktothelistTheDataFileToolseditornolongercrasheswheninsertingarecordafterthelastrecordofthefile.
2655432(1090160)TheDataFileToolseditornolongercorruptsaPIC9dataitemwhenthefieldiseditedfromwithintherecordlayoutview.
2655011(1090143)DataToolsLayoutsBacktothelistSettingaconditionvalueforaPIC9dataitemnolongerdisplaysacorruptvalue.
2612439(1087833)SettingaconditionvalueforaPIC9dataitemnolongerdisplaysacorruptvalue.
2612152(1087782)DocumentationBacktothelistThedocumentationwasnotclearabouttherangeofacceptablevaluesofEX_XA__NB_RETRIESortheconsequentsystembehaviours.
Thishasbeencorrected.
2593300(1085893)Thedocumentationhasbeenamendedtoalertusersthatundercertainconditions,adynamicbindingerrorispossible2553077(1082557)Younolongerneeda64-bitenterpriseserverinordertocommunicatewithMicrosoftBizTalkHostIntegrationServerona64-bitmachine.
2614060(1087978)ThedocumentationhasbeenupdatedsothatthehelppagemoreaccuratelyreflectstheESMACscreen.
2611733(1087753)TheproductdocumentationnowincludesinformationabouttheES_JESYSMSG_OUTPUTenvironmentvariable.
2604533(1087004)Thedocumentationhasbeenupdatedtoclarifytheeffectofescapecharactersonpathnames.
2594224(1086013)TheCPMTtransactionnolongersupportstheCEDForNOCEDFfunctions.
2527592(1089531)ThedocumentationhasbeenupdatedtoremovereferencestoERRORLEVELinUNIXenvironments.
2610423(1087575)ThedocumentationhasbeenupdatedtoprovidemoreinformationabouttheMFJAMSLISTCATcommand.
WheninvokingMFSORTfromthecommandline,themaximumlengthofthecommandis1024characters.
Charactersafterthislimitareignored,andifthistruncationcausesaninvalid/incompletecommand,anerrorisproduced.
ResolvedIssues|41Eclipse-DebugBacktothelistTheprocessbeingdebuggedwillnolongerhangwhenthereisanerrorintheJCLcodeafteraStopDebuggingrequest.
2651928(1089990)ThecontentsoftheCOBPATHenvironmentvariablearenowpickedupcorrectlywhendebugging.
2641660(1089106)EclipsenolongerexitswithaRun-TimeSystemerror153duringremotedebugging.
2616122(1088263)OnWindows,JITdebuggingnolongerfailstoattachtotheprocessbeingdebugged.
2614145(1088667)DebuggingmultipleprogramswhilethereareitemsintheExpressionViewnolongerresultsintheEclipseIDEclosingwhentheprogramchanges.
(595485)ThevalueofvariablesshownbythedebuggerwastruncatedbyLOW-VALUEcharacters.
ItisnowpossibletomodifyvariablescontainingLOW-VALUESonlyintheHexmodeoftheChangeValuedialog.
(595390)EclipseIDEBacktothelistTheitemsinCOBOLExplorerarenoworderedusingthewholefilenameratherthanusingthesuffixandthentherestofthename.
2653659(1089996)TryingtoopenaCOBOLfilefromtheCVSRepositoriesviewresultedinthetreeviewdisplaybecomingcorruptedandtheeditorwasnotdisplayed.
2652853(1090200)TheCOBOLCopyviewnolongershowscorruptedtextwhenthereplacementtextwasshorterthanthetextitreplaced.
2652219(1089888)FilelevelSQLsettingscannowoverrideprojectlevelSQLsettings.
2647596(1089619)YoucannowstartdebuggingafterchoosingadifferentprogramnameorlauncherinaRemoteCOBOLApplicationdebugconfiguration.
2647181(1089402)Theerrormarkersinthecurrentprojectarenowcorrectlyremovedwhenallerrorsinprojectsuponwhichthecurrentprojectdependsarefixed.
2646469(1089305)listfilesgeneratedfortheIMSfilesinyourprojectarenowproducedinsubfoldersoftheListingdirectoryoftheproject.
2640473(1088709)Double-clickinganerrorintheProblemsviewinEclipsenowopensthecorrectfile.
2610500(1088142)Typing'*'incolumn1intheeditorforapplicationsthatuseamainframedialectnolongercommentsouttheline.
2608522(1087593)42|ResolvedIssuesTheperformanceofthebackgroundsyntaxcheckinghasbeenimprovedsoitdoesnotslowdownthedebugger.
2606836(1087240)BackgroundparsingofprogramsinremoteprojectswouldsometimesfailtocompleteifaCOBOLEditorwindowwasopenwhenEclipsewasstarted.
2605902(1087319)The.
cobolBuildfilenowincludespropertiestocontrolthefailsonerror.
Fromthecommandline,youcansetthevalueofthesepropertiestotrueinordertomakeAntabortthebuildatthefirsterror.
Usethegeneralproperty"failOnError"ifyouneedtoabortonerrorsinanyfiletypes-COBOL,cobollink,lbr,bms,ims.
Thefollowingpropertiescontrolfailingonerrorinthespecificfiletypes:cobolFailOnError,cobollinkFailOnError,lbrFailOnError,bmsFailOnError,imsFailonError.
NotethatlbrscannotbecreatedthroughEnterpriseDeveloperbutonlyusingVisualCOBOL.
2587325(1085781)COBOLCopyviewnolongershowscorruptedtextiftherewereREPLACEstatementsthatintroducedadditionalsourcelines.
2586983(1085408)PreviouslyconfiguredremoteconnectiondetailsarenowpreservedwhenyourestartEclipse.
2575926(1085613)Theremotedevscriptsnowallowyoutohaveadefaultshellof/bin/csh.
2571165(1088947)FileHandling-ExternalFileHandlerBacktothelistForSORTIN,alldatasetsinaconcatenationmustusethesameRECFM-eitherallfixed-lengthorallvariable-length.
Also,ifusingfixed-lengthrecords,LRECLmustbesetthesameforalldatasets.
2654517(1090095)ACOMMITFLUSHnolongercausesfilecorruption.
Previously,corruptionwaspossiblewithCOMMITFLUSHonwhenaprocess,havingdoneonlyarewritethatchangesnon-keydata,iscommittedafteranotherprocesshasalteredthefilessize.
2652378(1090281)TheRMRECOVER1utilityisnowdistributedwithVisualCOBOLincaseRMindexedfilesneedtoberecoveredorrebuilt.
2650917(1090175)SupporthasbeenaddedfortheASSIGNTOPRINTsyntaxwhenaccessingRM/COBOLdatafiles.
Specifically,BEFOREADVANCING,AFTERADVANCING,BEFOREADVANCINGPAGE,andAFTERADVANCINGPAGEnowworkcorrectlyandproducethesameprintfilecontentsastheydoinRM/COBOL.
2649809(1089792)TheRM/COBOLconfigurationoptionRMFM_RUN_INDEX_FILES_DEFAULT_FILE_VERSION_NUMBER2nowcorrectlycreatesaversion2RM/COBOLindexedfile.
2649414(1089679)ASORTactionnolongerfailsduetoanillegalfilenamewhentheSORTTEMPfileisspecifiedtobeanRMfileusingEXTFH.
CFG.
2648865(1090292)FilenamescontainingembeddedspacesnowworkcorrectlyinXMLExtensions.
2648306(1089486)ResolvedIssues|43Thecorrectfilestatus"23"isnowstoredinthefilestatusdataitem,whichwillcausetheproperINVALIDKEYconditionactionforREWRITERANDOMorDELETERANDOMI/OoperationsonanRM/COBOLdatafile.
2648182(1089461)AWRITEorREWRITEoperationonafixedrecordlengthRM/COBOLorACUCOBOL-GTfilenolongergeneratesanerroneous44errorafteraREADofashortrecord.
2647143(1089369)DELETEandREWRITEoperationsonanRM/COBOLindexedfilewithDYNAMICaccessandwheretheprimekeyallowsduplicatesnowworkcorrectly,meaningthatthebehaviormatchesRM/COBOL,wheretheoperationbehaveslikesequentialaccessanddeletesorrewritesthecurrentrecord.
2646274(1089289)WhenopeninganRM/COBOLdatafileforinput,aREADWITHLOCKafteraREADWITHNOLOCKnolongerreturnsanerroneous99(recordlocked)error.
ThismatchesRM/COBOLbehaviorforafileopenedintheinputmode.
2644830(1089726)WhenaccessingRM/COBOLdatafiles,afilestatusof04iscorrectlyreturnedwhereappropriate.
2616717(1088310)WhenaccessingRM/COBOLdatafilesorcallingC$RERR,filestatuses'44,03','44,04',and'44,07'arecorrectlyreturnedwhereappropriate.
2616717(1088465)WhenaccessingRM/COBOLdatafilesorcallingC$RERR,filestatus'47,01'iscorrectlyreturnedwhereappropriate.
2616717(1088467)WhenaccessingRM/COBOLdatafilesorcallingC$RERR,filestatus'48,01'iscorrectlyreturnedwhereappropriate.
2616717(1088468)WhenaccessingRM/COBOLdatafilesorcallingC$RERR,filestatuses'93,02'and'90,05'arecorrectlyreturnedwhereappropriate.
2616717(1088469)Afilestatusof90,05isnowcorrectlydisplayedas90.
2616717(1088449)C$RERRnowreportsameaningful30,22,nnnnnerror,wherennnnnistheMicroFocusextendedstatus,whentheFileHandlerdiagnosesanoperationerroronanRM/COBOLdatafile.
2616717(1088470)FileHandlernowconvertsthecharsetofallinstreamdatainaconcatenateddatasettothatofthecallingprogram.
2606382(1087212)ThefilelockingforVBfileswithDISP=SHRhasbeenremoved.
Itisnowtheuser'sresponsibilitytoensurethatotherusersdonotupdatethefileatthesametime.
2605857(1087302)EXTFHconfigurationoptionsspecifiedundertheFOLDERtagnowworkcorrectlywithUNIXfileswhentheyarespecifiedwithanabsolutepathintheSELECTstatementofaCOBOLprogram.
2594733(1086089)ConcatenatingmultipleSYSINDDstatementsnowworkscorrectly.
2590465(1085905)Filecorruptionnolongeroccurswhenyoumaketworewritesofarecordinthesametransaction,wherethefirstrewritechangesanalternatekeyandthesecondrewritechangesitbackagain.
44|ResolvedIssues2576793(1084780)CTFtracingnolongerdefaultstoshowingCTFhandlesaserrors.
CTFtracingforhandlesnowonlyappearsforDEBUGandERRORlevels.
2566161(1083551)IftheDDnameismissingfromJCL,thevalueofCOBDATAisnotusedtosearchforafile.
2559292(1084935)Therebuildhelpmessagefilehasbeenupdatedtocorrectatypo.
FilesharenowsupportstheACUandRMfileformats.
FileHandling-FileshareBacktothelistSORTnolongerabendsiftheSORTINfileisaFilesharefile.
2653753(1090002)Acommit-preparenowreturnsnon-zeroerrorcodeiftheFileshareserverisnotrunning.
2637773(1088492)IftheFileshareservercrashesbeforeacommitorarollbackinthetwo-phasecommit,thetransactionsbeforeacommit-preparearenowcommittedwhilerecoveringthefile.
2637773(1088493)Byte-streamroutinescalledfromFileshareclientsnowworkcorrectlywitha64-bitFileshareserver.
2607314(1088601)IDEDebuggingBacktothelistIfyousetthedebug_on_errortunableto1,thenthedebuggerwillnowattachforallRTSerrors.
JVM-CompilerBacktothelistPreviously,aprogramusingaMAXORMINfunctionwithanALLparameterwasgeneratingbadcodewhencompiledforJVM.
2647112(1089359)Previously,youcouldreceivesomewarningsforcallstotheRMlibraryroutineC$GetEnv.
2601487(1086710)WhencompilingJVMCOBOL,ifthePERFORMTYPEdirectiveisnotsettothedefaultvalueofmf,verylargeprogramssometimesdonotcompile.
Insuchcases,'COBCH1633-Proceduredivisiontoolargeorcomplex-tryusingperformtype(mf)'isdisplayed.
Compilingwithperformtype(mf)normallyfixestheproblem.
2581224(1084860)InWindowsenvironments,ifaCOPYstatementspecifiedafilenamethatwasnotinquotationmarks,ordidnotincludethefullextension,thensettingabreakpointinthatcopyfilewasnotalwayssuccessful.
2577765(1084637)Copystatementsthatreferenceafilewhosepathcontainsspacesnolongercauseerrors.
2577765(1086750)Previously,theJVMCompilerdidnotrecognizeCOBOLstaticinnerclasses(thatis-nestedclasseswithoutaSHARINGPARENT,ornestedclassesproducedusingILSMARTNEST).
ResolvedIssues|45JVM-RTSBacktothelistWhenusingJVMCOBOLwithApacheTomcat,younolongerseewarningmessagesfromtheorg.
apache.
catalina.
loader.
WebappClassLoadercheckThreadLocalMapForLeaksclassrelatingtoclassesinthepackagecom.
microfocus.
cobolandbelow.
2612595(1088144)WhencreatingadebugconfigurationforaJVMCOBOLapplication,superfluousclassesarenolongerlistedonsearchingforaMainclass.
Previously,whenathreadcalledasubprogramwiththread-localstorageitmighthaveintermittentlygotresetwhencreatingmanythreadsquickly.
MFCommonClientBacktothelistAproblemwiththeMicroFocusCommonClientnotsupporting64-bitCOBOLprogramsonUNIXandLinuxhasbeenfixed.
ThisenablesECIfunctionalityfor64-bitCOBOLprograms,andmaycorrectissueswithcertainotherfeaturessuchasWebServicesclients.
2642116(1088854)Whentherearemultipledirectoriesconfiguredinmf-client.
dat,theservicedeploymenttools(suchasimtkmake)andtheIDEfeaturesnowcorrectlyscanalldirectoriesfordeploymentdestinationsandnotonlythefirstone.
MFCommunicationsServerBacktothelistInEZASOKET/EZACICALapplications,the"reserved"portionofthesocket-addressinformationreturnedbyAPIcalls(suchasGETSOCKADDRandGETPEERADDR)isnowsettolow-values,forimprovedmainframecompatibility.
2659699(1090549)Younolongerreceivearun-timesystemerrorwhenaninvalidIMSConnectmessageisreceivedwithamissingend-of-messageindicator.
2649746(1089727)AproblemcausingIMSConnectconversationstoanenterpriseservertohanghasbeenresolved.
2645771(1089247)ForSSL-enabledlistenersinEnterpriseServer,MFCSnowofferstheoptionofsettingSSLkeyfilepassphrasesusingauserexitmodule.
Forinstructionsandasamplemodule,contactMicroFocusSupportLine.
2641670(1088950)IntermittentfailuresintheCICSWebInterfaceserversthatsendchunkedresponseshavebeenfixed.
TheSO_LINGERsocketoptioninCICSsockets(EZASOKET/EZACICAL)nowworkscorrectly.
MFDirectoryServerBacktothelistIntheEnterpriseServerAdministrationHTMLGUI,clicking"UpdateAll"ontheSecurityManagerListpagewhileanenterpriseserverinstanceusingexternalsecuritywasstartedwouldcausetheMFDSprocesstoterminate.
2654069(1090069)TheMFDSXMLimportcommandlineoptioncorrectlysetsthevalueofthelistener'sSSLclientauthenticationoptiononimport.
46|ResolvedIssues2653699(1090115)TheMFDScommandlineoptionstoexportorimportserverconfigurationdatawhenusinganexternalSecurityManagernowworkcorrectly.
2652779(1089981)IfthecustomconfigurationtextforanEnterpriseServerinstancewaslargerthan4Kandthe"CreateXMLrepositorycopy"repositoryoptionwasselectedor,iftheserverconfigurationwasexportedinXMLformat,theMFDSprocesscouldterminate.
2650330(1089683)TheMFDS-xand-gcommandlineoptionsforcreatingandimportingEnterpriseServerinstanceconfigurationinXMLformatcannowberunagainstanMFDSprocessrunningonaspecificTCPaddressandportbyusingtheCCITCP2andCCITCP2_PORTenvironmentvariables.
2646427(1089303)ThecorrectdetailsforEnterpriseServer"MSSInter-SystemCommunication"conversationtypelistenerscannowbeexportedandimportedusingtheMFDSXMLexport/importfeature.
2644237(1089091)The"Directories"linkintheEnterpriseServerAdministrationGUIdidnotfunctioncorrectlybasedontheconfiguredSecurityManagerpermissionsforaloggedonuser.
2583624(1085073)Whenyouusecasstartfromthecommandlinetostartanenterpriseserverinstancethatappearsas"NotResponding"intheEnterpriseServerAdministration,thestatuslogforthatserverisnowclearedwhentheserverreaches"Started"state.
2570318(1086170)MVSREXXEmulationBacktothelistTheREXXenginepreviouslyassumedthatallhexadecimalstringsrepresentedEBCDICcharacters.
ThisresultedintheX2Cbuilt-infunctionproducinganincorrectresultwhenahexadecimalstringrepresentingANSIdatawasused.
TheMFREXX_CHARSETenvironmentvariablecannowbeusedtoindicatewhethertheREXXengineshoulduseEBCDICorANSIwhenworkingwithhexadecimalstringsorperformingstringcomparisons.
2647920(1089596)TraceoptionssetinaparentprocedurearenowpropagatedtoaCALLedinternalprocedure.
2612317(1087818)ExecsresidingintemporarydatasetsallocatedtoSYSEXECorSYSPROCnolongersometimesfailtoload.
2579785(1086478)TheLASTPOSfunctionnolongerreturnsanincorrectresultifthe'start'parametervalueexceedsthelengthofthe'haystack'parameter.
NCGBacktothelistYounolongerreceiveanRTS114errorwhensteppingEXECSQLstatementsindebugmode.
2611568(1088003)Abugin"display.
.
.
uponenvironment-name"withthe[NOT]ONEXCEPTIONclausehasbeenfixed.
Abugthataffectedqueryinglinkageitemsinaprogramthathasparametersinworking-storagehasbeenfixed.
ResolvedIssues|47RTSBacktothelistUsingtheCBL_EXEC_RUN_UNITlibraryroutinetorepeatedlyexecutenon-COBOLprocessesnolongercausesa'COBRT105MemoryAllocationError'errortobeproduced.
2651531(1090239)ThelibraryroutineC$OSLockInfonowworkscorrectlywhenusedinaprogramcompiledwiththeDIALECT(RM)directive.
2643661(1089044)TheRANDOMintrinsicfunction,whencompiledinaprogramusingtheHOSTNUMMOVEdirective,nolongerproducesaruntimeerroriftheargumentisaliteraloranumericexpression.
2596268(1086174)DynamicmemoryallocationsusingtheCBL_ALLOC_MEMcallarenolongerlimitedto2Gbon64-bitprocesses.
2513886(1079960)OnWindows,ifanerroroccurswhencreatingacoredumpfile,thenamessageboxisnolongerdisplayedforcore_on_errorsettingsgreaterthan127.
2509666(1079870)ReadingfromSTDINhasbeenenhancedwhenSTDINisbeingredirectedfromafileorfromapipelineonUNIX.
Itnowautomaticallyreflectsthefiletypewithouttheneedforyoutouseanyruntimetunables.
Therecordsizelinesequentialfilesreturnisnowthesizeofthedatathatisactuallyread.
ThefullrecordsizeisnowreadforrecordsequentialfilesorwhenyouuseCBL_READ_FILE.
2468412(1075670)Whenusingthektermterminalemulator,anynewterminalWindowscreatedbyCOBOLwillnowbekterm,inpreferencetoxterm.
Bydefault,itwilluseShiftJiskanjimodeand16pointfontsbutthesecanbeoverriddenbysettingtheCOBTERMOPTSenvironmentvariable.
Forexample,touseEUCkanjimodeand14pointfonts,use:exportCOBTERMOPTS="-fna14-fkk14-kmeuc"SamplesBrowserBacktothelistEnterpriseDevelopernowincludessamplesfortheACU/RMconversionutilityandforXMLExtensionsandXcentrisity.
2600450(1086612)SetupIssuesBacktothelistTheStartandStopscriptsformfcesdandlservhavebeenimprovedforhandlingthepossiblestatesthatservicesandsystemfilesmaybein.
2657001(1090384)SetupIssues(UNIX)Backtotheliststartmfcesd.
shhasbeenupdatedandnolongerincludes/tmp/mfcesclient*whichitstartsup.
foriin`ls/tmp/mfcesclient*2>/dev/null`dorm-rf$idoneIfnofilesarepresent,removecommandisskipped.
2657021(1090386)48|ResolvedIssuesSQL:DB2ECMBacktothelistArequiredfilefortheDB2(GEN-SQLCA)directivewasmissing,causingthedirectivetoworkimproperly.
2659056(1090501)TheDB2pre-compilernowsavesorrestorestheRETURN-CODEspecialregistersoexecutingEXECSQLstatementsnolongeraffectsthatregister.
2655173(1090353)Previously,theDB2preprocessorsometimesincorrectlydefinedthenumberofhostvariablestouseforasingletonSELECTwhenagrouphostvariablewasredefinedusingFILLER.
2613602(1088069)Previously,theDB2preprocessorwouldnotgeneratecallstoasystemprogramunlessitwaslinkedin.
2611937(1087736)Previously,theDB2preprocessormightincorrectlyflagindicatorarraysasinvalid.
2546456(1088155)SQL:HCOforSQLServerBacktothelistPreviously,theSPDGeneratortoolcouldgenerateinvalidCOBOLparameternamesifnoparameternamewaspecifiedandtheparametertypewasDECIMAL.
2664672(1091009)SomethreadsafetyissuesthatoccurredinSQLrun-timeallocationunderloadhavebeenresolved.
2658581(1090459)Theperformanceofforward-only,read-onlycursorsinSQLCLRstoredprocedureshasbeenimprovedandanewCompilerdirective,SQL(OPTION=OPTIMIZESPCURSORS),hasbeenaddedtoprovideadditionalcontrol.
2644905(1089182)WhenSQL(DETECTDATE)isusedwithSQL(DIALECT=MAINFRAME),andthemainframetimeformatisISO,thesecondcomponentofthetimevaluemustbepresent.
Thisistoavoidambiguityandunwantedconversionofsimplenumericcharacterstrings.
2641203(1090111)UnderHCOSS,SQLerrormessagesreturnedfromcallstoDSNTIARdidnotalwaysgettranslatedtoEBCDICwhenexecutingtheapplicationinthatmode.
2615782(1088148)Therearenewdirectives,SQL(OPTION=SQCLRTRANS)andSQL(OPTION=SPCOMMITONRETURN),thatresolvesomeissueswithstoredproceduresthatexpectCOMMITandROLLBACKtobehavethesameasmainframeDB2.
2611786(1087718)YoucannowuseDISPLAYstatementswithCOBOLstoredproceduresfordiagnosticsinthesamewayaswithapplications,whenyousettheSQL(OPTION=SPDISPLAY)directive.
2598617(1086941)Previously,afteraFETCHNEXTROWSETstatement,thenumberofrowsreturnedwasincorrectlyreportedinSQLERRD(3).
DynamicSQLstatementsexecutedbyEXECSQLEXECUTEIMMEDIATEarenowcorrectlyconvertedtoT-SQLwhentheSQL(DIALECT=MAINFRAME)directiveisset.
ResolvedIssues|49SQL:OpenESQLBacktothelistPreviously,theOpenESQLruntimedidnotworkcorrectlywiththeunixODBC2.
3.
1andlaterODBCDriverManagersonAIXplatforms.
2658290(1090583)Usingajava.
math.
BigDecimalhostvariableasaninputparametertoSQLstatementscausedanORA-17041error.
2652362(1089847)Previously,whenusingOpenESQLforADO.
NET,anSQL-CODEerroroccuredwhenaquerytimeoutwassetfromahostvariable.
2650030(1089675)Previously,OpenESQLthrewanexceptionwhileattemptingtosetadefaultJDBClogintimeoutatconnecttime.
2647801(1089421)WhenusingtheProgressOracleODBCdriver,theOpenESQLruntimeincorrectlyreportedafailureforasuccessfulINSERTwhenasuccessfulINSERTwasfollowedbyafailingINSERT.
2646958(1089336)OpenESQLnowacceptsEXECSQLDECLARExSTATEMENTEND-EXECstatements,wherexisadynamicSQLstatementname.
ThisstatementhasnoeffectbutisacceptedforcompatibilitywithotherESQLSQLdialects.
2643884(1089076)WhenusingSQLNativeClientorSQLServerNativeClientODBCdrivers,thePICN(xx)USAGENATIONALhostvariablecausedanerrorwhenusedwiththeNVARCHAR(MAX)SQLServerdatatype.
2601192(1087619)WhenexecutingcodecompiledfortheJVM,iftherun-timesystemencountersaduplicatesymbol,itnowreportsanRTS119error,"thesymbolisnotunique".
2598694(1086469)Previously,theprecompilerincorrectlyresetruntimeinformationinlargeObject-OrientedapplicationsthathadSQLstatementsacrossmultiplemethodswhichresultedinincorrectSQLruntimeerrors.
2597319(1086681)WhencompilingOracleapplicationsandusingSQL(CHECK),errorswerereportedforSELECTstatementsonly.
Thishasbeencorrectedtoreporterrorsforallstatements.
2566933(1083631)YounolongerreceiveaninternalbuffererrormessagewhencompilingOpenESQLapplicationsunderanMBCSUTF8locale.
EXECSQLDESCRIBEorPREPAREINTOnowreturnthecorrectsqltypeforVARCHARcolumnswhentheSQL(OPTION=DESCRIBEVARCHAR)directiveisused.
TheSQL(DATE)andSQL(TIME)directivesnowapplytodateandtimehostvariablesthataredeclaredwithSQLTYPEaswellaswithPICX.
VisionFileSystemBacktothelistRMFMnowcorrectlygenerates04,05(and04,06)statusesandthefilestatusvariablecontains04.
XMLExtensionsBacktothelist50|ResolvedIssuesAcompilererrorwhenprocessingXMLextensionswithdialect(rm)sethasbeenfixed.
2589841(1085641)Previously,innativecode,XMLExtensionstreatednegativeliterals(suchasinthevalueofaname/valuepairforXMLSETXSL-PARAMETERS)specifiedasparametersinnativecodeasalargepositiveliteral.
Itnowcorrectlytreatsthemasnegativeliterals.
XMLsyntaxsupportruntimeBacktothelistBlockcommentsinXMLinstancedocumentsnolongercausea201parsingerror.
2618943(1088554)TheXMLpreprocessornowgeneratescorrectoutputfortheCOUNTINclause.
2596137(1086285)ResolvedIssues|51UpdatesandSupportLineOurWebsitegivesup-to-datedetailsofcontactnumbersandaddresses.
FurtherInformationandProductSupportAdditionaltechnicalinformationoradviceisavailablefromseveralsources.
Theproductsupportpagescontainaconsiderableamountofadditionalinformation,suchas:TheWebSyncservice,whereyoucandownloadfixesanddocumentationupdates.
TheKnowledgeBase,alargecollectionofproducttipsandworkarounds.
ExamplesandUtilities,includingdemosandadditionalproductdocumentation.
Toconnect,enterhttp://www.
microfocus.
cominyourbrowsertogototheMicroFocushomepage.
Note:Someinformationmaybeavailableonlytocustomerswhohavemaintenanceagreements.
IfyouobtainedthisproductdirectlyfromMicroFocus,contactusasdescribedontheMicroFocusWebsite,www.
microfocus.
com.
Ifyouobtainedtheproductfromanothersource,suchasanauthorizeddistributor,contactthemforhelpfirst.
Iftheyareunabletohelp,contactus.
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.
Alternatively,youmightbeaskedtoprovidealogfilecreatedbytheConsolidatedTracingFacility(CTF)-atracinginfrastructurethatenablesyoutoquicklyandeasilyproducediagnosticinformationdetailingtheoperationofanumberofMicroFocussoftwarecomponents.
OnUNIX,youcanusetheMicroFocusUNIXSupportScanUtility,mfsupport,tocreatealogfilethatcontainsthedetailsaboutyourenvironment,product,andsettings.
Themfsupportscriptisstoredin$COBDIR/bin.
Torunmfsupport:1.
StartaUNIXshell.
52|UpdatesandSupportLine2.
SetCOBDIRtotheproductwithissues.
3.
Executemfsupportfromadirectorywhereyouhavewritepermissions.
Thiscreatesalogfile,mfpoll.
txt,inthatdirectory.
4.
Whenthescriptfinishes,sendthemfpoll.
txtfiletoyourMicroFocusSupportLinerepresentative.
Note:IfCOBDIRissettoalocationthatdoesnotcontainetc/cobver,thescriptoutputsthecontentsof/opt/microfocus/logs/MicroFocusProductRegistry.
datwhichkeepsalistoftheinstalledMicroFocusproducts.
CreatingDebugFilesIfyouencounteranerrorwhencompilingaprogramthatrequiresyoutocontactMicroFocusSupportLine,yoursupportrepresentativemightrequestthatyouprovideadditionaldebugfiles(aswellassourceanddatafiles)tohelpusdeterminethecauseoftheproblem.
Ifso,theywilladviseyouhowtocreatethem.
UpdatesandSupportLine|53DisclaimerThissoftwareisprovided"asis"withoutwarrantyofanykind.
MicroFocusdisclaimsallwarranties,eitherexpressorimplied,includingthewarrantiesofmerchantabilityandfitnessforaparticularpurpose.
InnoeventshallMicroFocusoritssuppliersbeliableforanydamageswhatsoeverincludingdirect,indirect,incidental,consequential,lossofbusinessprofitsorspecialdamages,evenifMicroFocusoritssuppliershavebeenadvisedofthepossibilityofsuchdamages.
Somestatesdonotallowtheexclusionorlimitationofliabilityforconsequentialorincidentaldamagessotheforegoinglimitationmaynotapply.
MicroFocusisaregisteredtrademark.
CopyrightMicroFocus1984-2013.
Allrightsreserved.
54|Disclaimer