IMS-PL/1 Connector

CLI Commands

ol test connection

[module folder]> ol test connection --base-package [base_package_name] --input-field-pattern M1* --output-field-pattern M2* --output-offset 0 --data-store-name IVP1 --group-name GROUP1 --username demo --password [password_text] --code-page 37 --transaction-properties.commit-mode SEND_AND_COMMIT --transaction-properties.user-message-exit-identifier HWSSMPL1 --transaction-properties.transaction-timeout 5000 --ssl-properties.is-ssl-enabled false --ssl-properties.ssl-encyption-type WEAK --ssl-properties.key-store-file-name [path/file_name] --ssl-properties.key-store-password 12345 --ssl-properties.trust-store-file-name [path/file_name] --ssl-properties.trust-store-password 12345
[module folder]$ ol test connection --base-package [base_package_name] --input-field-pattern M1* --output-field-pattern M2* --output-offset 0 --data-store-name IVP1 --group-name GROUP1 --username demo --password [password_text] --code-page 37 --transaction-properties.commit-mode SEND_AND_COMMIT --transaction-properties.user-message-exit-identifier HWSSMPL1 --transaction-properties.transaction-timeout 5000 --ssl-properties.is-ssl-enabled false --ssl-properties.ssl-encyption-type WEAK --ssl-properties.key-store-file-name [path/file_name] --ssl-properties.key-store-password 12345 --ssl-properties.trust-store-file-name [path/file_name] --ssl-properties.trust-store-password 12345

ol add

[module folder]> ol add --host 192.86.32.238 --port 13200 --program-path /QSYS.LIB/RMR2L1.LIB/FULLDETAIL.PGM --asset-name credit-account --source-path ../FULLDETAIL.pli
[module folder]$ ol add --host 192.86.32.238 --port 13200 --program-path /QSYS.LIB/RMR2L1.LIB/FULLDETAIL.PGM --asset-name credit-account --source-path ../FULLDETAIL.pli

Properties

--host (required)

The IMS-PL/1 host IP address

--host 192.86.32.238

--port (required)

The data source port

--port 13200

--program-path

Path to the business operation on the remote IMS-PL/1 machine. The path is used:

  • in design-time by the CLI ol test asset command to access the business operation on the remote machine.
  • in run-time by the production application to communicate with the business operation on the remote machine.
--program-path /QSYS.LIB/RMR2L1.LIB/FULLDETAIL.PGM

--asset-name

The asset name defaults to the program path. Pass a value to --asset-name only when it is different from the program path.

--asset-name credit-account

--source-path

The path to a local PL/1 file. The path is used by the CLI ol addcommand to access the file and parse it to extract its metadata. The property is not required if the input, the output and the program-path properties are populated.

--source-path ../FULLDETAIL.pli

--base-package

The package of the generated asset

--base-package [some_value]

--input-field-pattern

Regular expression to parse input fields

--input-field-pattern M1*

--output-field-pattern

Regular expression to parse output fields

--output-field-pattern M2*

--output-offset

Output offset in case llzz and trancode return in the response

--output-offset 0

--data-store-name

The data store name

--data-store-name IVP1

--group-name

The RACF username group

--group-name GROUP1

--username

The RACF username login credential for the data source

--username demo

--password

The password to the remote machine

--password 12345

--code-page

The IMS-PL/1 code page

--code-page 37

--transaction-properties.commit-mode

The commit mode [SEND_AND_COMMIT | COMMIT_AND_SEND]

--transaction-properties.commit-mode SEND_AND_COMMIT

--transaction-properties.user-message-exit-identifier

The user message as an identifier to exit from the transaction

--transaction-properties.user-message-exit-identifier HWSSMPL1

--transaction-properties.transaction-timeout

The transaction timeout

--transaction-properties.transaction-timeout 5000

--ssl-properties.is-ssl-enabled

Enabled-true when the connection is SSL

--ssl-properties.is-ssl-enabled false

--ssl-properties.encryption-type

The SSL type [WEAK | STRONG | NONE]

--ssl-properties.ssl-encyption-type WEAK

--ssl-properties.key-store-file-name

The key-store path and file name

--ssl-properties.key-store-file-name [path/file_name]

--ssl-properties.key-store-password

The key store password

--ssl-properties.key-store-password 12345

--ssl-properties.trust-store-file-name

The trust store file name

--ssl-properties.trust-store-file-name [path/file_name]

--ssl-properties.trust-store-password

The trust store password

--ssl-properties.trust-store-password 12345