Model 204 ONLINE link job stream for z/OS

From m204wiki
Revision as of 23:39, 19 November 2014 by Admin (talk | contribs) (Admin moved page Model 204 link job stream for z/OS to Model 204 ONLINE link job stream for z/OS without leaving a redirect: clarity and consistency with titles of similar page)
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) /*