Exporting a CICS bundle project to your local file system
If you do not have authorization to deploy a bundle directly to a z/OS® file system, or you want to back up your bundle source code, you can export the bundle project to your local file system.
Before you begin
To export the bundle to a z/OS
UNIX file system, you must ensure that your zFS file
permissions are set so that bundles exported from CICS Explorer® can be written to the target directory on zFS.
- Set the file mode creation mask for the z/OS FTP daemon to ensure that the owner has write permissions. To configure this, use the UMASK statement in the FTP.DATA configuration file.
- Optionally, if you are also using UNIX System Services (USS) access control list (ACL) entries to control security, ensure that the default ACLs are inherited from the directory in zFS.
If your CICS® bundle
includes an OSGi Application Project (EBA), you need the WebSphere® Developer Tools (WDT), or its more recent version, the Liberty Developer Tools
(LDT), to develop and build the project.
- If you use CICS Explorer for Aqua 3.2, you must install the IBM® CICS SDK for Enterprise Java™ (Liberty) and WebSphere Developer Tools, which includes WDT by default.
- If you use CICS Explorer on Eclipse Marketplace, you must install LDT separately in addition to the IBM CICS SDK for Enterprise Java (Liberty).
- If you use CICS Explorer for Aqua 3.3, IBM CICS SDK for Enterprise Java (Liberty) does not support WDT any more. Use an alternative solution as suggested in Consideration for OSGi applications when installing CICS Explorer.
- Alternatively, you can export the bundle without building it by adding the built project to the root of your CICS bundle directly.
About this task
Exporting a CICS bundle project to your local file system exports the bundle source code and files in an archive file. You can add the project into a source code repository or share the project with another user who can import the project into CICS Explorer.
Do not deploy the bundle project source to the z/OS UNIX file system from outside CICS Explorer because the tool packages the project for deployment and handles the file encoding for you.
Procedure
- In the Project Explorer view, right-click your CICS Bundle project and select Export.
The Export dialog opens.
- In the Export window, expand General, click Archive File, and then click Next.
- Ensure that all the files in the project are selected. Enter a file name in the To archive file field. Ensure that Save in zip format is selected.
- Click Finish.
Results
What to do next
Back up the bundle project or share it with another user.
If you have Java installed on your z/OS file system, you can use the following command to uncompress the file
into the current directory:
jar -xvf zipfile