Documentation is incomplete on how to build with zoslib

[MikeFultonDev]

I wasn't able to compile using the options specified for C. I haven't whittled it to the minimum but found that:

-fzos-le-char-mode=ascii -D_XOPEN_SOURCE=600 -D_ALL_SOURCE -D_OPEN_SYS_FILE_EXT=1 -D_AE_BIMODAL=1 -D_ENHANCED_ASCII_EXT=0xFFFFFFFF  -DZOSLIB_OVERRIDE_CLIB=1 -DZOSLIB_OVERRIDE_CLIB_GETENV=1

worked.
Without at least some of those additional options, the header files spit out numerous errors.

@IgorTodorovskiIBM fyi

[MikeFultonDev]

It also isn't clear how to link... I tried:

clang -L "${ZOSLIB_ROOT}/lib" -lzoslib $TC.o -o $TC

as well as the same with clang++ and both result in a bunch of unresolved refs to C++ functions. Presumably this is because my 'main' is C but it's pulling in C++ code from the archive but I'm not sure how to tell clang/clang++ what to do

@IgorTodorovskiIBM fyi

[MikeFultonDev]

First unresolved ref:

./build
 IEW2456E 9207 SYMBOL
          _ZNSt3__16_ASCII15basic_streambufIcNS0_11char_traitsIcEEE6xsputnEPKcl
          UNRESOLVED.  MEMBER COULD NOT BE INCLUDED FROM THE DESIGNATED CALL
          LIBRARY.
 IEW2456E 9207 SYMBOL
          _ZNSt3__16_ASCII15basic_streambufIcNS0_11char_traitsIcEEE5uflowEv
          UNRESOLVED.  MEMBER COULD NOT BE INCLUDED FROM THE DESIGNATED CALL
          LIBRARY.

[MikeFultonDev]

Found a solution after digging through z/os open tools. It appears I also need -lzoslib-supp (not sure if the celquopt.s.o is required).

clang++ -fzos-le-char-mode=ascii -L "${ZOSLIB_ROOT}/lib" "${ZOSLIB_ROOT}/lib/celquopt.s.o" -lzoslib-supp -lzoslib driver.o $TC.o -o $TC

[MikeFultonDev]

@IgorTodorovskiIBM and @perry-ca : Please confirm/deny the following:

• the zoslib code is a C++ object (either .so or .a).
  • as such, the current clang++ 'bind' step doesn't pull in the required C++ code ,and so zoslib-supp is required.
• the celquopt.so provides the necessary 'initialization code' for a C application to work correctly
• The example should be changed to include the celquopt.s.o and the zoslib-supp archive if doing a static bind

If that's correct, I can take a crack at fixing the C part of the documentation in the readme.