Model 204 installation: Difference between revisions
| Line 20: | Line 20: | ||
</p> | </p> | ||
< | <table class="thJustBold"> | ||
< | <tr><th>1</th><td>Only one modification is <b>always required</b>, based on whether the ONLINE is to use RSQL (for Connect*) or not: | ||
<ul> | <ul> | ||
<li>To link an ONLINE which <b>does</b> use RSQL, you must un-comment the INCLUDE ROKOB204(<b>LKSQLONL</b>) statement. | <li>To link an ONLINE which <b>does</b> use RSQL, you must un-comment the INCLUDE ROKOB204(<b>LKSQLONL</b>) statement. | ||
<li>To link an ONLINE which <b>does not</b> use RSQL, you must un-comment the INCLUDE ROKOB204(<b>LKNOSONL</b>) statement. | <li>To link an ONLINE which <b>does not</b> use RSQL, you must un-comment the INCLUDE ROKOB204(<b>LKNOSONL</b>) statement. | ||
</ul> | </ul> | ||
</td></tr> | |||
< | <tr><th>2</th><td>The other modification frequently needed is to use an external authorizer such as RACF or ACF2. If you do, you must: | ||
<ul> | <ul> | ||
<li>Prepare the appropriate xxxPARM object file (e.g., RACFPARM | <li>Prepare the appropriate xxxPARM object file (e.g., RACFPARM orACF2PARM), adding that to a *different* object library (with the same | ||
DCB attributes as ROKOB204). We refer to this as your local object libary (it will also be used for other assemble output, such as your FUNU). | |||
DCB attributes as ROKOB204). We refer to this as your local object | <li>In the SYSLIN DD *, un-comment the appropriate INCLUDE statement(s) for your external authorizer. <p class="note"><b>Note:</b> If you use ACF2, there are two INCLUDE statements to be un-commented; one refers to your system ACF2 library. You must un-comment the ACF2 DD as well, and fill in the DSN for that library.</p> | ||
libary (it will also be used for other assemble output, such as your | |||
FUNU). | |||
<li>In the SYSLIN DD *, un-comment the appropriate INCLUDE statement(s) for your external authorizer. | |||
<p class="note"><b>Note:</b> | |||
If you use ACF2, there are two INCLUDE statements to be | |||
un-commented; one refers to your system ACF2 library. You must | |||
un-comment the ACF2 DD as well, and fill in the DSN for that library. | |||
</p> | |||
</ul> | </ul> | ||
</td></tr> | |||
< | <tr><th>3</th><td>If you have other programs which you assemble for your Model 204 ONLINE module, for example, FUNU, they should be assembled into your local object library (creating one - with the same DCB attributes as ROKOB204 - if you have not already created one for the external authorizer xxxxPARM object file). You do *not* need to add additional INCLUDE statements for FUNU or other locally assembled object files - they are already present in the include streams from ROKOB204. | ||
module, for example, FUNU, they should be assembled into your local | </td></tr> | ||
object library (creating one - with the same DCB attributes as ROKOB204 | |||
- if you have not already created one for the external authorizer | |||
xxxxPARM object file). You do *not* need to add additional INCLUDE | |||
statements for FUNU or other locally assembled object files - they are | |||
already present in the include streams from ROKOB204. | |||
< | <tr><th>4</th><td>Hence, there are two choices for the ROKOB204 DD statement: | ||
<ul> | <ul> | ||
<li>If you have a local object library, fill that in for the first concatenation, and | <li>If you have a local object library, fill that in for the first concatenation, and fill in the ROKOB204 DSN for the second concatenation. | ||
fill in the ROKOB204 DSN for the second concatenation. | <li>If you do not have a local object library, there is only one dataset for the ROKOB204 DD - your ROKOB204 library. | ||
<li>If you do not have a local object library, there is only one dataset for the ROKOB204 | |||
DD - your ROKOB204 library. | |||
</ul> | </ul> | ||
</td></tr> | |||
< | <tr><th>5</th><td>Finally, change the DSN of the SYSLMOD DD to the load module library you have allocated for it. | ||
</td></tr> | |||
</ | </table> | ||
The modified JCL is now ready to run. | |||
<blockquote class="note"><b>Notes:</b> | <blockquote class="note"><b>Notes:</b> | ||
Revision as of 13:58, 7 August 2014
This page is under construction.
z/OS installation
This section is under construction.
Downloading the object library in z/OS
This section is under construction.
Linking the Model 204 ONLINE load module
After downloading the object library, one of the members of ROKOB204 is
named JZLONLN - the basic ONLINE link JCL. You can use this to link-edit the Model 204 online. It contains a number of choices which you can make to modify this basic JCL; each choice is indicated in the JCL by a line which ends with <<.
Most of the choices are "optional", in the sense that a working ONLINE does not require the indicated modification, although, for many customers' environments, a modification will be needed, for example, to select an external authorizer.
| 1 | Only one modification is always required, based on whether the ONLINE is to use RSQL (for Connect*) or not:
|
|---|---|
| 2 | The other modification frequently needed is to use an external authorizer such as RACF or ACF2. If you do, you must:
|
| 3 | If you have other programs which you assemble for your Model 204 ONLINE module, for example, FUNU, they should be assembled into your local object library (creating one - with the same DCB attributes as ROKOB204 - if you have not already created one for the external authorizer xxxxPARM object file). You do *not* need to add additional INCLUDE statements for FUNU or other locally assembled object files - they are already present in the include streams from ROKOB204. |
| 4 | Hence, there are two choices for the ROKOB204 DD statement:
|
| 5 | Finally, change the DSN of the SYSLMOD DD to the load module library you have allocated for it. |
The modified JCL is now ready to run.
Notes:
- There is not a separate link step for BATCH204. It is not maintained as a separate module; the same module as ONLINE is used, with a BATCH204 alias.
- The object library has the authorization zap pre-applied, so you *do not* need to get a new one from the web site.
- It also has the maintenance zaps (as of the time the stream was prepared) pre-applied, so you *do not* need to apply any maintenance.
Basic JCL to link ONLINE
//LKM204P PROC HLQ=, High level qualifier(s) of install DSNs // MQ=NULLFILE, IBM MQ series load library // ACF2=NULLFILE ACF2 security interface load/objlib //* //* ******* z/OS JCL PROC to link edit into Model 204 loadlib ****** //* //* ****************************************************************** //* ** Do not copy nor edit this PROC. It is invoked by a ** //* ** jobstream member (such as LKONLNJ, LKIFAM1, etc.) for the ** //* ** particular load module you are linking. You should copy the ** //* ** jobstream member from the downloaded object library and then ** //* ** edit in a local TSO library. The jobstream contains ** //* ** instructions to modify and submit that jobstream. ** //* ****************************************************************** //* //* The first symbolic parameter (HLQ=) is required. //* //* The other two depend on the jobstream being used to invoke this //* PROC, and on your Model 204 configuration. //* //* Detailed explanations are also available for the load module //* you are linking at //* //* http://m204wiki.rocketsoftware.com/index.php/M204_inst_zOS //* //M204LINK EXEC PGM=IEWL,REGION=0M, // PARM='SIZE=(2048K,200K),LIST,LET,NCAL,MAP,AC=1,RMODE=ANY' //SYSPRINT DD SYSOUT=* //* //RKOBJ204 DD DISP=SHR,DSN=&HLQ..M204V75.LOCAL.OBJLIB, // DCB=BLKSIZE=32720 // DD DISP=SHR,DSN=&HLQ..M204V75.RKOBJLIB Downloaded obj lib //* //SYSLMOD DD DISP=SHR,DSN=&HLQ..M204V75.LOADLIB Model 204 modules //* //MQ DD DISP=SHR,DSN=&MQ IBM MQ series load library //* //ACF2 DD DISP=SHR,DSN=&ACF2 ACF2 system load/object library //* // PEND ************** End of LKM204P PROC *************