convert Yips wiki pages to sphinx docs

[jimoibm]

@kadler,
I have the draft done for the conversion for issue #19 .

[kadler]

Conversion looks good, but currently doesn't build. Please fix.

[jimoibm]

@kadler How can I get a account to login the Jekins?

[kadler]

I've added you

[jimoibm]

@kadler It seems make -j4 caused the failure. RUNSQLSTM started before CRTSRVPGM and could not get the lock which resulted in

SQL7909 10 1 Position 1 IPLUG4K was created, changed, or dropped, but object not modified.

10 level severity errors found in source

I tried on my 7.4 box with make -j4. I could get SQL7909 but it didn't fail my make right after the sql errors. Do you have any ideas? Can we don't use the parallel make?

[kadler]

Aha! The xmlstoredp.sqlinst will result in the generic sqlinst rule running, but it has no dependency on xmlstoredp.srvpgm. Unfortunately, I don't think that we can create another rule that defines the prereq for the srvpgm and have make keep using the generic rule (from what I can tell, make will ignore the generic rule in that case ☹️). Since we only have one SQL script, we could update the existing generic rule to require a matching srvpgm, eg.

-%.sqlinst: src/%.sql
+%.sqlinst: src/%.sql %.srvpgm
 	system -q "RUNSQLSTM SRCSTMF('$<')" && touch $@

[jimoibm]

@kadler The dependency you suggested looks working. But now I got this error:

> bash-4.4$ make -j4 build-procedure
> (system -q 'CHKOBJ XMLSERVICE *LIB' || system -q 'CRTLIB XMLSERVICE') && touch XMLSERVICE.lib
> system "CRTSQLRPGI OBJ(XMLSERVICE/xmlstoredp) SRCSTMF('src/xmlstoredp.sqlrpgle') OBJTYPE(*MODULE) REPLACE(*YES) RPGPPOPT(*LVL2) COMPILEOPT('INCDIR(''src/'') TGTCCSID(37)')" > xmlstoredp.log 2> xmlstoredp.msg && rm xmlstoredp.log xmlstoredp.msg || touch xmlstoredp.failed
> system "CRTRPGMOD MODULE(XMLSERVICE/plugconf) SRCSTMF('src/plugconf.rpgle') DBGVIEW(*ALL) REPLACE(*YES) TGTCCSID(37)" > plugconf.log 2> plugconf.msg && rm plugconf.log plugconf.msg || touch plugconf.failed
> system "CRTRPGMOD MODULE(XMLSERVICE/plugbug) SRCSTMF('src/plugbug.rpgle') DBGVIEW(*ALL) REPLACE(*YES) TGTCCSID(37)" > plugbug.log 2> plugbug.msg && rm plugbug.log plugbug.msg || touch plugbug.failed
> test ! -e plugconf.msg || cat plugconf.msg
> system "CRTRPGMOD MODULE(XMLSERVICE/plugipc) SRCSTMF('src/plugipc.rpgle') DBGVIEW(*ALL) REPLACE(*YES) TGTCCSID(37)" > plugipc.log 2> plugipc.msg && rm plugipc.log plugipc.msg || touch plugipc.failed
> RNS9313: Library XMLSERVICE cannot be found.
> RNS9309: Compilation failed. Module PLUGCONF not created in library XMLSERVICE.

Looks like %.lib was not done and then the other dependencies started executing. build-main, build-cgi... all have this problem on my box today. Does system crtlib command run in a child process and cause make not wait?

[kadler]

Looks like all the build rules need to have a dependency on the library just like this one: https://github.com/IBM/xmlservice/blob/master/Makefile.in#L117

[jimoibm]

I tried adding dependency of creating library ahead, but it didn't work. I saw CRTLIB was ran ahead, but the following CRTMOD just failed with no library found. So I guessed make didn't wait for CRLIB done.
Not like svrpgm and sqlint dependency worked.

[jimoibm]

The .lib dependency seems not working. I tried your Makefile.in also got this:

bash-4.4$ make -j4 build-cgi
(system -q 'CHKOBJ XMLSERVICE *LIB' || system -q 'CRTLIB XMLSERVICE') && touch XMLSERVICE.lib
system "CRTRPGMOD MODULE(XMLSERVICE/xmlcgi) SRCSTMF('src/xmlcgi.rpgle') DBGVIEW(*ALL) REPLACE(*YES) TGTCCSID(37)" > xmlcgi.log 2> xmlcgi.msg && rm xmlcgi.log xmlcgi.msg || touch xmlcgi.failed
system "CRTRPGMOD MODULE(XMLSERVICE/plugconf) SRCSTMF('src/plugconf.rpgle') DBGVIEW(*ALL) REPLACE(*YES) TGTCCSID(37)" > plugconf.log 2> plugconf.msg && rm plugconf.log plugconf.msg || touch plugconf.failed
system "CRTRPGMOD MODULE(XMLSERVICE/plugbug) SRCSTMF('src/plugbug.rpgle') DBGVIEW(*ALL) REPLACE(*YES) TGTCCSID(37)" > plugbug.log 2> plugbug.msg && rm plugbug.log plugbug.msg || touch plugbug.failed
test ! -e xmlcgi.msg || cat xmlcgi.msg
test ! -e plugconf.msg || cat plugconf.msg
RNS9313: Library XMLSERVICE cannot be found.
RNS9309: Compilation failed. Module XMLCGI not created in library XMLSERVICE.
test ! -e xmlcgi.log || ./parse.sh xmlcgi.log
RNS9313: Library XMLSERVICE cannot be found.