Model 204 ONLINE link job stream for z/OS

From m204wiki
Revision as of 16:59, 23 April 2018 by JAL (talk | contribs) (add category)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

The LKONLNJ job stream is used to link the Model 204 ONLINE load module during installation on IBM z/OS.

See the comments in the code below for instructions on editing LKONLNJ.

//name JOB jobCardParameters //* // JCLLIB ORDER=(hlq.M204V77.RKOBJLIB) required 1 << //* //* For detailed explanations, see //* //* http://m204wiki.rocketsoftware.com/index.php/M204_inst_zOS#lkonln //* //LKONLN EXEC LKM204P, // HLQ=, required 2 << // MQ=ibmMqLoadLibDsn, recommended 3 << // ACF2=acf2SecurityInterfaceLoadOrObjlibDsn optional 4 << //* //* ------------------------------------------------------------------ //* This jobstream is used to link edit the Model 204 ONLINE load //* module. Copy it into a local TSO library, where you will examine //* lines marked '<<' to determine which changes you must make, and //* submit the job with those changes. //* //* There are two groups of changes; those for DSNs (lines 1-4 above) //* and the SYSLIN input. The SYSLIN changes are explained in the //* comments after the SYSLIN DD *. Lines 1-4 are explained here. //* //* Lines 1-2 marked '<<' above MUST be edited and provided; lines 3-4 //* are optional; if they do not apply to your configuration, delete //* them. //* //* 1: Change 'hlq' to the same value provided in (2) - the value //* inside parentheses will then be the DSN of the downloaded //* object library //* //* 2: Provide the high level qualifier(s) of all Model 204 //* installation DSNs //* //* It is recommended that you edit the MQ= paramter line as well: //* //* 3. Provide the DSN system IBM MQ Series load library (and //* uncomment the INCLUDE MQ statement in the SYSLIN input). //* //* The MQ DSN is not required if you will never even trial the //* Model 204 MQ interface. //* //* Delete this line if you are not providing the DSN of the MQ //* load library. //* //* In addition, you might need to provide an additional DSN above: //* //* 4. If you use ACF2 as an external authorizer for Model 204, //* provide the DSN of the system ACF2 load or object library from //* Computer Associates (you will also need to uncomment the //* INCLUDE ACF2 statement in the SYSLIN input). //* //* Delete this line if you do not use ACF2. In that case (to //* avoid a JCL error), remove the comma from the preceding line, //* whether it is HLQ= or MQ=. //* //* ------------ End of description of symbolic parameters ----------- //* //* In addition, you might need to uncomment the BLOCKPRT DD: //* //* 5. If you use block banner separator pages, uncomment the BLOCKPRT //* DD statement and provide the proper DSN (on many systems, this //* is SYS1.AOSB0). //* ------------------------------------------------------------------ //* //* (-- For Rocket Support only: filename=JZJONLN 7.7 2016/11/14 --) //* //*M204LINK.BLOCKPRT DD DISP=SHR,DSN=SYS1.AOSB0 5 << //* //M204LINK.SYSLIN DD * * * Along with the symbolic parameter changes above, see lines marked * '<<' below, make necessary changes, and submit the resulting * jobstream. At the right side of the first line of each section is * a letter followed by some instructions; the letter is used on an * installation wiki page. * * ---- Primary INCLUDE: with or without RSQL --------- Required: A * There are two basic choices for the Model 204 ONLINE load module - * with RSQL (LKSQLONL) or without (LKNOSONL). To choose, uncomment * just one of the next 2 INCLUDEs for this load module: * * INCLUDE RKOBJ204(LKSQLONL) ONLINE with RSQL Uncomment this << * INCLUDE RKOBJ204(LKNOSONL) ONLINE without RSQL or this << * -------- End of primary INCLUDE ------------------------------------ * * ---- INCLUDE for Model 204 MQ interface ------------ Recommended: B * If you uncomment the next line, EXEC LKONLNP must have MQ=dsn: * INCLUDE MQ(CSQBSTUB) To allow use of MQ series << * -------- End of MQ/204 INCLUDE ------------------------------------- * * -------- Security interfaces ----------------------- Optional: C * Ignore from the above line thru and including the "end of security * interfaces" line if you do not use an external authorizer. * * If you use an external authorizer, uncomment the appropriate * line(s) for your interface (if you use ACF2, you will uncomment the * INCLUDE ACF2 line as well as one of the INCLUDE RKOBJ204 lines): * * INCLUDE RKOBJ204(RACFOS,RACFPARM) RACF static RACFPARM << * INCLUDE RKOBJ204(RACFOS) *or* dynamic RACFPARM << * * INCLUDE ACF2($ACFGCVT,ACF$FGCB) ACF2 always needs << * INCLUDE RKOBJ204(ACF2,ACF2PARM) ACF2 static ACF2PARM << * INCLUDE RKOBJ204(ACF2) *or* dynamic ACF2PARM << * * INCLUDE RKOBJ204(TOPSOS,TOPSPARM) Top Secret static TOPSPARM << * INCLUDE RKOBJ204(TOPSOS) *or* dynamic TOPSPARM << * -------- End of security interfaces -------------------------------- * * -------- Block banner separator pages -------------- Optional: D * Ignore from the above line thru and including the "end of block * banner" line if you do not use block banner separator pages. * * If you use block banner separator pages, uncomment the following * INCLUDE statement as well as the corresponding BLOCKPRT DD * statement just before the SYSLIN DD statement above: * * INCLUDE BLOCKPRT(IEFSD095) For block banner separator pages << * -------- End of block banner separator pages ----------------------- * ENTRY MAINTASK ALIAS BATCH204 ALIAS FUNLOAD(FUNLPGM) NAME ONLINE(R) /*