Skip to content

zowe/zowe-client-java-sdk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

This program and the accompanying materials are made available under the terms of the Eclipse Public License v2.0 which accompanies this distribution, and is available at https://www.eclipse.org/legal/epl-v20.html

SPDX-License-Identifier: EPL-2.0

Copyright Contributors to the Zowe Project.

Zowe Java Client SDK

zowe org_video_outro_gif_accessibility

Maven Central javadoc

This project is a subproject of Zowe, focusing on modernizing mainframe experience. Zowe is a project hosted by the Open Mainframe Project, a Linux Foundation project.

The Java SDK lets you leverage the underlying z/OSMF REST APIs on a z/OS system to build client applications and scripts that interface with your z/OS instance seamlessly.

For instance, one API package provides the ability to upload and download z/OS data sets. You can leverage that package to rapidly build a client application that interacts with data sets.

The Java SDK joins an existing community of other language-specific SDKs. It provides the Java community similar capabilities based on the NodeJS SDK.

This SDK may differ from some others with the JobMonitor class adding prebuilt functionality for automation tasks.

Issues worked on documenting main feature set provided can be viewed within the following MVP issues:
#1 #2 #3

Prebuilt API services located in the following packages/classes:

zowe.client.sdk.zosconsole.method

IssueConsole

zowe.client.sdk.zosfiles.dsn.methods

DsnCopy
DsnCreate
DsnDelete
DsnGet
DsnList
DsnRename
DsnWrite

zowe.client.sdk.zosfiles.uss.methods

UssChangeMode
UssChangeOwner
UssChangeTag
UssCopy
UssCreate
UssDelete
UssExtAttrs
UssGet
UssGetAcl
UssList
UssMount
UssSetAcl
UssWrite

zowe.client.sdk.zosjobs.methods

JobCancel
JobDelete
JobGet
JobMonitor
JobSubmit

zowe.client.sdk.zoslogs.method

ZosLog  

zowe.client.sdk.zosmfinfo.methods

ZosmfStatus
ZosmfSystems 

zowe.client.sdk.zostso.method

IssueTso    

zowe.client.sdk.zosuss.method

IssueUss   

TeamConfig Package

The TeamConfig package provides API methods to retrieve a profile section from Zowe Global Team Configuration with keytar information to help perform connection processing without hard coding username and password. Keytar represents credentials stored securely on your computer when performing the Zowe global initialize command which prompts you for username and password.

TeamConfig class only supports Zowe Global Team Configuration provided by Zowe V2.

If you have Zowe CLI on your system with Global Team Configuration initialized, you can use TeamConfig API methods to retrieve a profile type which will include the secure username and password information stored in our OS credential store manager.

You can use this information to create a dynamic ZosConnection object to perform zosmf authentication for the all the other packages. This avoids the need to hard code values.

See following package/class:

zowe.client.sdk.teamconfig

TeamConfig

Http Rest Processing

SDK release version 2 and above uses Unirest for Java for Http functionality.

Unirest's library provides the ability to retrieve IBM z/OSMF JSON error document.

For example, the following http GET request will result in a HTTP 500 error:

https://xxxxxxx.xxxxx.net:xxxx/zosmf/restfiles/ds?

and the JSON error report document body response is:

{"rc":4,"reason":13,"category":1,"message":"query parm dslevel= or volser= must be specified"} 

Requirements

Maven  
Compatible with all Java versions 11 and above.
z/OSMF installed on your backend z/OS instance.  

Code Samples

Samples

Demo App

ZosShell

Examples

See the following GITHUB Zowe-Java-SDK location for code examples and applications.

In the project, you will find code examples located in each package's README.MD file. See:

teamconfig
zosconsole
zosfiles-dsn
zosfiles-uss
zosjobs
zoslogs
zosinfo
zostso
zosuss

Build

Java 11 and above is required to compile JAR file. Maven is required to build JAR file.

The following maven command at the root prompt of the project will produce zowe-client-java-sdk.jar in the target directory:

mvn clean package  

Logger

For logging, you will need to implement SLF4J binding and logging framework dependencies.

The SDK does not provide SLF4J or any logging dependency included in its FATJAR.

Documentation

https://javadoc.io/doc/org.zowe.client.java.sdk/zowe-client-java-sdk/latest/index.html

Maven Central Publication

https://mvnrepository.com/artifact/org.zowe.client.java.sdk/zowe-client-java-sdk

Install Java SDK from an online registry

To install this library in your project, use a build tool such as Maven, Gradle or Ant. Use the following link to get the necessary artifact:

https://mvnrepository.com/artifact/org.zowe.client.java.sdk/zowe-client-java-sdk

For a Maven project add the SDK as a dependency by updating your pom.xml as follows:

<dependency>
    <groupId>org.zowe.client.java.sdk</groupId>
    <artifactId>zowe-client-java-sdk</artifactId>
    <version>2.2.1</version>
</dependency>

For a Gradle project add the SDK as a dependency by updating your build.gradle as follows:

implementation group: 'org.zowe.client.java.sdk', name: 'zowe-client-java-sdk', version: '2.2.1'  

About

Zowe Client Java SDK

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages