README.md

OSSILE

Welcome to the OSSILE project. This project is to serve two purposes:

1. This project is to provide, via the open source community, a wide set of utilities for IBM i. They will get built into the OSSILE library.
2. This project is to provide working examples of various things in ILE languages (RPG, C, C++)

Currently included in OSSILE

• Useful UDTF's originally sourced from https://bitbucket.org/christianjorgensen/

  Documentation:

  • CARTRIDGE_INFO
  • HISTORY_LOG_INFO
  • IMAGE_CATALOG_DETAILS
  • MACHINE_ATTRIBUTES

• CRTFRMSTMF originally sourced from https://bitbucket.org/BrianGarland/

  Documentation:

  • CRTFRMSTMF

• GETIPTF, originally sourced from http://bryandietz.us/getiptf.html

  Documentation:

  • GETIPTF

• C program samples originally sourced from ChrisHird/OSSILE

  • BACKUP Program to run backups using BACKUP options and Image Catalogs and copy to remote file server.
  • CHKRCVRDLT Program to clean up receivers based on days since detatched.
  • CHKOSLVL Program to display the current OS level.
  • DSPCSTINF Program to display the constraints attached to a file.
  • DSPTRGINF Program to display the triggers attached to a file.
  • JOBLIST Program to display the currently active jobs and some of their attributes.
  • LSTDBRTST Program to display the database relationships for a file.
  • RTVJRNOBJ Program to display the objects currently journalled to a journal.
  • RTVDIRSZ Program to log the content and sizes of a directory plus calculate the total size.
  • SRVPGMCHK Program to check the signatures of a service program and a program to ensure the program can call the Service program.
  • SYSINFO Program to retrieve and display system status.

  Documentation

  • BACKUP
  • CHKRCVRDLT
  • CHKOSLVL
  • DSPCSTINF
  • DSPTRGINF
  • JOBLIST
  • LSTDBRTST
  • RTVJRNOBJ
  • RTVDIRSZ
  • SRVPGMCHK
  • SYSINFO

• sha256, originally sourced from https://github.com/miguel-r-s/SHA-256 a re-implementation of SHA256 in C. Documentation:

  • README

Installing OSSILE on your IBM i

1. Download https://github.com/OSSILE/OSSILE/archive/master.zip and place it in IFS
2. Install 5733OPS PTF SI61064 (or latest supercede)
3. From a PASE-capable shell (ssh client, QP2term, etc), run:

• /QOpenSys/QIBM/ProdData/OPS/tools/bin/unzip OSSILE-master.zip
• cd OSSILE-master/main && chmod +x ./setup && ./setup To exclude an item from building, remove it from buildlist.txt or comment it out with a preceding '#'

Installing via Relic Package Manager

Each directory in /main/ is a seperate item, each are installable seperatly with Relic. The base command is RELICGET PLOC('https://github.com/OSSILE/OSSILE/archive/master.zip') PDIR('OSSILE-master/main/<ITEM>') PNAME(OSSILE), where <ITEM> is one of those directories. For example:

• PDIR('OSSILE-master/main/crtfrmstmf')
• PDIR('OSSILE-master/main/udtf_image_catalog_details')

OSSILE directory structure

These are the main directories within OSSILE:

main/

This directory houses complete, buildable code. Each subdirectory represents a separate buildable item.

c_examples/

This directory houses examples of how to accomplish various tasks in ILE C. They do not need to be working, compilable examples (though that is preferred).

clle_examples/

This directory houses examples of how to accomplish various tasks in ILE CL. They do not need to be working, compilable examples (though that is preferred).

rpg_examples/

This directory houses examples of how to accomplish various tasks in ILE RPG. They do not need to be working, compilable examples (though that is preferred).

sql_examples/

This directory houses examples of how to accomplish various tasks using SQL scripts.

Contributing

See CONTRIBUTING.md