Model 204 installation: Difference between revisions

From m204wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
This page is [[under construction]].
==z/OS installation==
==z/OS installation==


This page is [[under construction]].
This section is [[under construction]].
 
===Downloading the object library in z/OS===
 
This section is [[under construction]].


<div id="zOS_link_onl "></div>
<div id="zOS_link_onl "></div>
===ONLINE link-edit JCL===
===Linking the Model 204 ONLINE load module===
<!--Warning: <div> above-->
<!--Warning: <div> above-->


This section is [[under construction]].
After [[#Downloading the object library in z/OS|downloading the object library]], one of the members of ROKOB204 is
named [[#JZLONLN|JZLONLN - the basic ONLINE link JCL]]. You can use this to link-edit the <var class="product">Model 204</var> online.
 
<p>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 <code>&lt;&lt;</code>.</p>
 
<p>Most of these 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.
 
<p>Only one modification is always required - whether the ONLINE is to use RSQL (for Connect*) or not:
<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 not</b> use RSQL, you must un-comment the INCLUDE ROKOB204(<b>LKNOSONL</b>) statement.
</ul>
 
<p>The other modification frequently needed is to use an
external authorizer such as RACF or ACF2.  If you do, you must:
<ul>
<li>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).
<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>
 
<p>
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.
</p>
 
<p>
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.
</p>
 
Finally, change the DSN of the SYSLMOD DD to the load module library you have allocated for it.
 
<blockquote class="note"><b>Notes:</b>                                                                                           
<ul>
<li>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.
<li>The object library has the authorization zap pre-applied, so you *do
not* need to get a new one from the web site.
<li>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.
</ul>
 
<div id="JZLONLN"></div>
===Basic JCL to link ONLINE===
<!--Warning: <div> above-->


{{Template:JZLONLN}}
{{Template:JZLONLN}}

Revision as of 13:37, 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 these 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 *************