---
updatedAt: 2025-06-03T20:39:35.000Z
agentTools:
  projectIndex: https://docs.ol-hub.com/llms.txt
---

# IMS-COBOL

## CLI Commands

### ol test connection

```Text Windows
[module folder]> ol test connection --host http://192.86.32.238 --port 13200 --group-name GROUP1 --data-store-name IVP1 --ssl-properties.encryption-type WEAK --ssl-properties.key-store-fileName [path/file_name] --ssl-properties.trust-store-file-name [path/file_name] --ssl-properties.key-store-password [password_text] --ssl-properties.trust-store-password [password_text] --transaction-properties.commit-mode SEND_AND_COMMIT --ssl-properties.is-ssl-enabled false --commit-mode SEND_AND_COMMIT --code-page CP037 --username demo --password 1234
```
```Text macOS
[module folder]$ ol test connection --host http://192.86.32.238 --port 13200 --group-name GROUP1 --data-store-name IVP1 --ssl-properties.encryption-type WEAK --ssl-properties.key-store-fileName [path/file_name] --ssl-properties.trust-store-file-name [path/file_name] --ssl-properties.key-store-password [password_text] --ssl-properties.trust-store-password [password_text] --transaction-properties.commit-mode SEND_AND_COMMIT --ssl-properties.is-ssl-enabled false --commit-mode SEND_AND_COMMIT --code-page CP037 --username demo --password 1234
```

![](https://files.readme.io/ccde421-return.png)  [Return to tutorial](https://ol-hub.readme.io/reference/onboarding-cli#step-5-test-the-data-source-connection-details)

### ol add

#### - You only have a local COBOL source file

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

```Text Windows
[module-name]> ol add --source-path ./[asset-path]/[asset-source-file.cbl]
```
```Text macOS
[module folder]$ ol test-connection --host http://192.86.32.238 --port 13200 --group-name GROUP1 --data-store-name IVP1 --ssl-properties.encryption-type WEAK --ssl-properties.key-store-fileName [path/file_name] --ssl-properties.trust-store-file-name [path/file_name] --ssl-properties.key-store-password [password_text] --ssl-properties.trust-store-password [password_text] --transaction-properties.commit-mode SEND_AND_COMMIT --ssl-properties.is-ssl-enabled false --commit-mode SEND_AND_COMMIT --code-page CP037 --username demo --password 1234
```

![](https://files.readme.io/ccde421-return.png)  [Return to tutorial](https://ol-hub.readme.io/reference/onboarding-cli#step-6-add-an-asset-to-your-module)

#### - 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.

```Text Windows
[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
```
```Text macOS
[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
```

![](https://files.readme.io/ccde421-return.png)  [Return to tutorial](https://ol-hub.readme.io/reference/onboarding-cli#step-6-add-an-asset-to-your-module)

#### - 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.

```Text Windows
[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
```
```Text macOS
[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
```

![](https://files.readme.io/ccde421-return.png)  [Return to tutorial](https://ol-hub.readme.io/reference/onboarding-cli#step-6-add-an-asset-to-your-module)

#### - 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:

1. Generate from the superclass an asset type entity using an **--entity** flagged **ol add** command.
   ```Text Windows
   [module-name]> ol add --source-path header.cpy --entity
   ```
   ```Text macOS
   [module-name]$ ol add --source-path header.cpy --entity
   ```
2. Incorporate the generated entity into the asset using the **--input-super-class** and **--output-super-class** options.
   ```Text Windows
   [module-name]> ol add --input fininq2.cpy --output fininq2.cpy --input-super-class header --output-super-class header --program-path FININQ2
   ```
   ```Text macOS
   [module-name]$ ol add --input fininq2.cpy --output fininq2.cpy --input-super-class header --output-super-class header --program-path FININQ2
   ```