27 releases (12 breaking)

0.13.4 Nov 2, 2024
0.12.1 Apr 6, 2024
0.12.0 Mar 24, 2024
0.1.5 Dec 18, 2023

#164 in Authentication

MIT/Apache

320KB
9K SLoC

z_osmf

The VERY work in progress Rust z/OSMFTM [^1] Client.

Examples

List your datasets:

#[tokio::main]
async fn main() -> z_osmf::Result<()> {
    let client = reqwest::Client::new();
    let base_url = "https://mainframe.my-company.com";

    let zosmf = z_osmf::ZOsmf::new(client, base_url);
    zosmf.login("USERNAME", "PASSWORD").await?;

    let my_datasets = zosmf
        .datasets()
        .list("USERNAME")
        .build()
        .await?;

    for dataset in my_datasets.items().iter() {
        println!("{}", dataset.name());
    }

    Ok(())
}

List the files in your home directory:

#[tokio::main]
async fn main() -> z_osmf::Result<()> {
    let client = reqwest::Client::new();
    let base_url = "https://mainframe.my-company.com";

    let zosmf = z_osmf::ZOsmf::new(client, base_url);
    zosmf.login("USERNAME", "PASSWORD").await?;

    let my_files = zosmf
        .files()
        .list("/u/username")
        .build()
        .await?;

    for file in my_files.items().iter() {
        println!("{}", file.name());
    }

    Ok(())
}

List all active jobs:

#[tokio::main]
async fn main() -> z_osmf::Result<()> {
    let client = reqwest::Client::new();
    let base_url = "https://mainframe.my-company.com";

    let zosmf = z_osmf::ZOsmf::new(client, base_url);
    zosmf.login("USERNAME", "PASSWORD").await?;

    let active_jobs = zosmf
        .jobs()
        .list()
        .owner("*")
        .active_only(true)
        .build()
        .await?;

    for job in active_jobs.items().iter() {
        println!("{}", job.name());
    }

    Ok(())
}

[^1]: z/OSMFTM, z/OSTM, and the lowercase letter zTM (probably) are trademarks owned by International Business Machines Corporation ("IBM"). This crate is not approved, endorsed, acknowledged, or even tolerated by IBM. (Please don't sue me, Big Blue)

Dependencies

~8–19MB
~249K SLoC