Prerequisites

Because of CICS topology the OpenLegacy connector requires an adapter to be installed on the CICS server. The adapter is a CICS program that receives the connector program activation requests and returns the results.

The connection between the connector and the adaptor can be secured using standard SSL communication supported on the HTTP Service CICS resource.

To install the connector contact OpenLegacy at support@openlegacy.com.

Return to tutorial

CLI Commands

ol test connection

[module folder]> ol test connection --host as400.openlegacy.com --code-page 37 --user demo --password 1234

[module folder]$ ol test connection --host as400.openlegacy.com --code-page 37 --user demo --password 1234

Return to tutorial

ol add

- You only have a local COBOL source file

In this case the --source-path option is required.

[module-name]> ol add --source-path ./[asset-path]/[asset-source-file.cbl]

[module-name]$ ol add --source-path ./[asset-path]/[asset-source-file.cbl]

Return to tutorial

- You only have local copybooks files

In this case use the --program-path option to pass the location of the program on the remote CICS-COBOL host the --input and --output options to pass the local copybooks files path. If you want the name of the asset to be different than the --program-path value you can set the value of the --asset-name property to the new name.

[module-name]> ol add --program-path /QSYS.LIB/RMR2L1.LIB/FULLDETAIL.PGM --asset-name credit_accounts --input ../files/a/SAMPCPY1.cpy --input ../files/b/SAMPCPY2.cpy --output ../files/a/SAMPCPY1.cpy --output ../files/b/SAMPCPY2.cpy

[module-name]$ ol add --program-path /QSYS.LIB/RMR2L1.LIB/FULLDETAIL.PGM --asset-name credit_accounts --input ../files/a/SAMPCPY1.cpy --input ../files/b/SAMPCPY2.cpy --output ../files/a/SAMPCPY1.cpy --output ../files/b/SAMPCPY2.cpy

Return to tutorial

- You have a local COBOL source file and local copybook files

In this case use the --source-path option to pass the COBOL source file path and the --input and --output options to pass the local copybooks files path.

[module-name]> ol add --source-path ./[asset-path]/[asset-source-file.cbl] --input ../files/a/SAMPCPY1.cpy --input ../files/b/SAMPCPY2.cpy --output ../files/a/SAMPCPY1.cpy --output ../files/b/SAMPCPY2.cpy

[module-name]$ ol add --source-path ./[asset-path]/[asset-source-file.cbl] --input ../files/a/SAMPCPY1.cpy --input ../files/b/SAMPCPY2.cpy --output ../files/a/SAMPCPY1.cpy --output ../files/b/SAMPCPY2.cpy

Return to tutorial

- You have a copybook superclass

When your copybook data sources include a copybook superclass perform the following two steps to add it to the asset:

Generate from the superclass an asset type entity using an --entity flagged ol add command.

[module-name]> ol add --source-path header.cpy --entity

[module-name]$ ol add --source-path header.cpy --entity

Incorporate the generated entity into the asset using the --input-super-class and --output-super-class options.

[module-name]> ol add --input fininq2.cpy --output fininq2.cpy --input-super-class header --output-super-class header --program-path FININQ2

[module-name]$ ol add --input fininq2.cpy --output fininq2.cpy --input-super-class header --output-super-class header --program-path FININQ2

Return to tutorial