Model 204 installation: Difference between revisions
| Line 20: | Line 20: | ||
</p> | </p> | ||
< | <ol> | ||
Only one modification is <b>always required</b> - whether the ONLINE is to use RSQL (for Connect*) or not: | <li>Only one modification is <b>always required</b> - 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> | ||
< | <li>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 or | <li>Prepare the appropriate xxxPARM object file (e.g., RACFPARM or | ||
| Line 43: | Line 42: | ||
</ul> | </ul> | ||
< | <li>If you have other programs which you assemble for your Model 204 ONLINE | ||
If you have other programs which you assemble for your Model 204 ONLINE | |||
module, for example, FUNU, they should be assembled into your local | module, for example, FUNU, they should be assembled into your local | ||
object library (creating one - with the same DCB attributes as ROKOB204 | object library (creating one - with the same DCB attributes as ROKOB204 | ||
| Line 50: | Line 48: | ||
xxxxPARM object file). You do *not* need to add additional INCLUDE | xxxxPARM object file). You do *not* need to add additional INCLUDE | ||
statements for FUNU or other locally assembled object files - they are | statements for FUNU or other locally assembled object files - they are | ||
already present in the include streams from ROKOB204. | already present in the include streams from ROKOB204. | ||
< | <li>Hence, there are two choices for the ROKOB204 DD statement: | ||
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 | ||
| Line 61: | Line 57: | ||
DD - your ROKOB204 library. | DD - your ROKOB204 library. | ||
</ul> | </ul> | ||
Finally, change the DSN of the SYSLMOD DD to the load module library you have allocated for it. | <li>Finally, change the DSN of the SYSLMOD DD to the load module library you have allocated for it. | ||
</ol> | |||
<blockquote class="note"><b>Notes:</b> | <blockquote class="note"><b>Notes:</b> | ||
Revision as of 13:48, 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.
- Only one modification is always required - whether the ONLINE is to use RSQL (for Connect*) or not:
- To link an ONLINE which does use RSQL, you must un-comment the INCLUDE ROKOB204(LKSQLONL) statement.
- To link an ONLINE which does not use RSQL, you must un-comment the INCLUDE ROKOB204(LKNOSONL) statement.
- The other modification frequently needed is to use an external authorizer such as RACF or ACF2. If you do, you must:
- Prepare the appropriate xxxPARM object file (e.g., RACFPARM or ACF2PARM), 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).
- In the SYSLIN DD *, un-comment the appropriate INCLUDE statement(s) for your external authorizer.
Note: 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.
- 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.
- Hence, there are two choices for the ROKOB204 DD statement:
- If you have a local object library, fill that in for the first concatenation, and fill in the ROKOB204 DSN for the second concatenation.
- If you do not have a local object library, there is only one dataset for the ROKOB204 DD - your ROKOB204 library.
- Finally, change the DSN of the SYSLMOD DD to the load module library you have allocated for it.
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 *************