Export the CICS® Application
project, the Application Binding project, and the associated CICS bundles to z/OS® UNIX,
and create an application definition in the CICSPlex® SM data repository.
About this task
When you export the CICS Application
project, the CICS Explorer® also
exports the Application Binding project and the CICS bundles associated with the application
bundle and application binding. The files for the application are
exported to the home directory for the platform on zFS. Any CICS bundles that are already deployed to the platform home directory and installed in the CICSplex at the correct version are not included in the export.
The home directory defaults to
/var/cicsts/cicsplex_name/platform_name,
or is the alternative home directory name that you specified when
you set up the platform. In the home directory, the following directories
hold the different project resources:
- applications holds the application bundles
exported from CICS Explorer.
- bindings holds the application bindings exported
from CICS Explorer.
- bundles holds the CICS bundles exported from CICS Explorer. These might be used
in applications, or as part of the platform.
The application definition, which is an APPLDEF resource
definition, identifies the location of the application bundle in the
platform home directory on zFS, and identifies the target platform
for the application.
Procedure
- In the CICS Cloud
perspective, in the Project Explorer view, right-click your Application
project or Application Binding project, and click Export
Application Project to z/OS UNIX File System or Export
Application Binding Project to z/OS UNIX File System.
Alternatively, click the link in the Actions list
in the application editor or the application binding editor to export
the application.
- If you started the export process from the application
binding project, select the name of the application that you are exporting,
and click Next.
- Select the CICS SM connection to the target CICSplex using the dropdown box.
- Select the application binding for the application that
you are exporting.
The box is prefilled with the current
selection.
- Optional: If you want to replace
variables in CICS bundles associated
with the application and application binding, select the Resolve
variables using properties file check box. For a CICS bundle that is part of an
application, values can also be specified in a variables.properties file
in the application binding root folder, and take precedence.
- To create an application definition after the export finishes,
check the box.
If you are already connected
to z/OS with the appropriate z/OS connection for the export,
and none of the CICS bundles
in the application project or application binding project are already
installed in the CICSplex, you can now click Finish to
carry out the export. Otherwise, click Next.
- If you clicked Next, select or verify
the z/OS connection that you
want to use for the export.
When you make a selection the
connection is established.
If none of the CICS bundles in the platform project
are already installed in the CICSplex, you can now click Finish to
carry out the export. Otherwise, click Next.
- If any of the CICS bundles
that you specified in the application project or application binding
project are already deployed to the platform home directory and installed
in the CICSplex at the correct version, the wizard displays an additional
page. The page shows the CICS bundles
that are already installed, and the platform or application that installed
them. These CICS bundles will
not be included in the export, but your application can use the CICS bundles that are already installed.
If you want to check on any of these CICS bundles
or make any changes to the environment before carrying out the export,
click Cancel. If the arrangement is correct,
click Finish to carry out the export.
The application bundle, application binding, and associated CICS bundles are exported to the
home directory of the installed target platform.
- If you checked the box in the application export wizard,
the New Application Definition wizard now opens automatically. To
create your application definition at another time, open the CICS Cloud perspective. In the
Cloud Explorer view, right-click and select to open
the New Application Definition wizard.
Tip: You
can also access this wizard from the CICS SM
perspective. Right-click the CICSplex you want to work with and click New . Expand the CICS
Definitions folder and click Application Definition.
- In the New Application Definition wizard, enter a name
for the application definition in the Name field.
The value you enter will be the name of the APPLDEF resource definition
in the data repository.
The CICSplex field
is automatically populated with the name of the CICSplex you are working
with.
- In the Platform Definition field,
select the name of the platform where you want to install the application.
- Enter a description for the application, and supply a version
number that matches the version number that you specified for the
application project, such as 1.0.0 for the
original version.
- Verify that the Application Directory and Binding
Directory fields contain the names of the subdirectories
of the platform home directory where the application project and application
binding project were exported.
Enter the name of an alternative
directory if necessary. To browse for an alternative directory, choose
an active connection to zFS in the z/OS connection field.
- Click Finish to create the application
definition in the data repository of the CMAS.
You can
edit the application definition before it is installed, but you cannot
edit it after it is installed. Double-click the application definition
in the Cloud Explorer view to edit it.
What to do next
Install the application definition to dynamically create
the resources from the bundles across the region types in the platform.