Validation with Pinnacle 21 Community CLI

How to use Pinnacle 21 Community CLI

The CLI (command line interface) can be used to run validations with Pinnacle 21 Community instead of using the GUI (graphical user interface). To use the CLI, you must have already installed Pinnacle 21 Community. The CLI requires Java 8 and newer versions of Java are not supported.

If you don't have Java installed on your Windows PC, you can use Java 8 that comes pre-packaged with Community. Add the following path to your PATH system variable:

• Community installed per-user: C:\Users\{username}\AppData\Local\Programs\Pinnacle 21 Community\resources\app.asar.unpacked\components\java64\bin
• Community installed system-wide: C:\Program Files (x86)\Pinnacle 21 Community\resources\app.asar.unpacked\components\java64\bin

To get started using the CLI copy the CLI jar located at the path below and paste it to Documents\Pinnacle 21 Community

Windows:

• Community installed per-user: C:\Users\{username}\AppData\Local\Programs\Pinnacle 21 Community\resources\app.asar.unpacked\components\lib
• Community installed system-wide: C:\Program Files (x86)\Pinnacle 21 Community\resources\app.asar.unpacked\components\lib

Mac: Applications⁩/⁨Pinnacle 21 Community⁩/Contents⁩/Resources⁩/⁨app.asar.unpacked⁩/components⁩/⁨lib⁩

After you copy the CLI jar to your Documents\Pinnacle 21 Community folder, open the command line window and and set your working directory to Documents\Pinnacle 21 Community.  After that, you can use the below examples to get started!  More examples are available in How to Automate Validation with Pinnacle 21 Command Line Interface and SAS®.

SDTM Example Validation

java -jar p21-client-1.0.0.jar
--engine.version="FDA 1903.1"
--standard=sdtm
--standard.version=3.2
--source.sdtm="C:\path\to\xpt\sdtm\data"
--source.define="C:\path\to\sdtm\define.xml"
--cdisc.ct.sdtm.version=2018-12-21
--meddra.version=19.0
--snomed.version=2016-09-01
--unii.version=2018-10-25
--ndf-rt.version=2018-02-05
--report="C:\path\to\validation\report.xlsx"

ADaM Example Validation

java -jar p21-client-1.0.0.jar
--engine.version="FDA 1903.1"
--standard=adam
--standard.version=1.1
--source.sdtm="C:\path\to\xpt\sdtm\data"
--source.adam="C:\path\to\xpt\adam\data"
--source.define="C:\path\to\adam\define.xml"
--cdisc.ct.sdtm.version=2017-12-22
--cdisc.ct.adam.version=2017-12-22
--meddra.version=19.0
--report="C:\path\to\validation\report.xlsx"

Define.XML Example Validation

java -jar p21-client-1.0.0.jar
--engine.version="FDA 1903.1"
--standard=sdtm
--standard.version=3.2
--source.define="C:\path\to\sdtm\define.xml"
--cdisc.ct.sdtm.version=2017-12-22
--report="C:\path\to\validation\report.xlsx"

For any additional questions, please post on the P21 Community Forum. If you are an Enterprise client, please contact your CSM or email success@pinnacle21.com