Guides you through the steps required to create an
Enterprise Developer project, import the MFDEMO IMS application files into the project, set the project properties, build the application, and perform additional required steps to enable the application to run in
Enterprise Server.
Create the IMSSupport project
- Open a Visual Studio command prompt and enter:
devenv
This starts Visual Studio. If you are prompted to select an initial action, click
Continue without code.
- In Visual Studio, click
.
- In the
Create a new project dialog box, select
COBOL from the
Language drop-down list.
- In the center pane, select
Mainframe Subsystem Application.
- Click
Next.
- In the name field, type the name of the project:
IMSSupport.
- Specify your working directory,
c:\tutorials\IMS, in the
Location field.
- Check
Place solution and project in the same directory.
- Click
Create.
In
Enterprise Developer, this creates a solution named
IMSSupport that contains one project, also named
IMSSupport.
Add demonstration application files
- In the
Solution Explorer, right-click the project and then use
Add > New Folder to add each of these subfolders to the project:
- cbl
- dbd
- mfs
- psb
- loadlib
- system
This adds the project subfolders to the
Solution Explorer, and creates project subdirectories on disk.
Use the following table to help you determine which demonstration files to add to which subfolder.
Subfolder name
|
Files to add
|
Comments
|
cbl
|
DEMO001T.CBL
RGHTJUST.CBL
|
|
dbd
|
DEMO03DD.DBD
|
|
loadlib
|
TRANCODE.TXT
DEMO03DD.DBU
|
Contains data files and eventually the executables required at run time.
|
mfs
|
DEMO90.MFS
DEMO91.MFS
DEMO92.MFS
|
|
psb
|
DEMO001T.PSB
|
|
system
|
None
|
Eventually contains system files such as the resource definitions file,
dfhdrdat
|
- In the
Solution Explorer, right-click a subfolder of your project and select
Add > Existing Item.
- Browse to the
%PUBLIC%\Documents\Micro Focus\Enterprise Developer\Samples\Mainframe\IMS\Classic\IVP directory.
- Optionally set the
Objects of type filter to show only the type of files you want to add.
- Select the appropriate files; then click
Add.
- Repeat steps
2 through
5 to add all appropriate demo files.
This adds the files to the project and creates copies of the files in the respective subdirectories of your project.
Set project properties
- In the
Solution Explorer, double-click your project's
Properties folder.
The
Properties page lists a series of tabs on the left side.
- On the
COBOL tab, set
Configuration to
Active (Debug).
- Ensure that
Platform target is set to
Active (x64).
- Set
COBOL dialect to
Enterprise COBOL for z/OS.
- Set the
Character set to
ASCII.
- Set
Source Format to
Fixed.
- Check
Compile for debugging.
- In the
Output path field, type the path to the
loadlib subfolder of your project. Because the current directory is the project directory, this can be expressed as
.\loadlib.
- On the
IMS tab, type
.\loadlib into the
Generated file path,
MFS output path, and
Database path fields.
This directs the output for all generated IMS files into the
loadlib project directory.
- In the
DBD Build Settings section, check
Generate Map for DBD.
- On the
Debug tab, select
IMS from the
Launch drop-down list.
- Click
File > Save All to save the changes in the project properties.
Build the project
- In the
Solution Explorer, right-click the project; then select
Build from the context menu.
- Check your project directory to see the different executables and other files produced by the build such as those in the
project's
loadlib directory. For example:
- DBDGEN2.DAT
- DBDGEN2F.DAT
- PSBGEN3.DAT
- DEMO001T.ACB
- DEMO03DD.ACB
- The MFS files generation creates some
.mid,
.mod,
.dif and
.dof files. These files contain system configuration data. You should move them only if you know how to configure your enterprise
server.
- Building the DBD and the PSB files produces respectively
dbdgen2.dat,
dbdgen2f.dat,
psbgen3.dat as well as some
.acb files.
Start the
HACloud session
Ensure that the
Micro Focus
HACloud service property is set to start up automatically. For instructions on how to do so, see
Starting the HACloud Session Server.
To start the
HACloud session server on Windows:
- Ensure that the installed Java is added to the PATH environment variable.
- Start the
Enterprise Server region that runs the application you want to connect to.
- Start either the 32-bit or 64-bit
Enterprise Developer command prompt or
Enterprise Server command prompt - this must match the working mode, 32 or 64-bit, of the JRE you have installed.
- Type
startsessionserver at the command prompt, and press
Enter.
Check the console for the messages that the
Micro Focus
HACloud Session Server has started.