Template:JZLONLN: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Automatically generated page update)
(Automatically generated page update)
Line 2: Line 2:
** automatically replaced ** -- any manual edits will be lost.
** automatically replaced ** -- any manual edits will be lost.
You've been warned.-->
You've been warned.-->
<p class="code"><nowiki>//* ***** JZLONLN  - basic z/OS JCL to link edit Model 204 ONLINE *****
<p class="code"><nowiki>//LKONLN  PROC RKOBJ204=,      Downloaded Model 204 object library
//           SYSLMOD=,          Library to store ONLINE load module
//          MQ=NULLFILE,        IBM MQ series load library
//          LOCALOBJ=&&NULPDS,  Local obj modules: RACFPARM, FUNU, ..
//          ACF2=NULLFILE      ACF2 security interface load/objlib
//*
//*
//*                 See all lines marked '<<<<'.
//* *********  z/OS JCL PROC to link edit Model 204 ONLINE  ********
//*
//* ******************************************************************
//* ** Do not copy nor edit this PROC.  It is invoked by member    **
//* ** LKONLN2, which you should copy from the downloaded object    **
//* ** library and then edit in a local TSO library.                **
//* ******************************************************************
//*
//* The first two symbolic parameters (RKOBJ204= and SYSLMOD=) are
//* required.  The other three depend on your ONLINE configuration.
//*
//* To invoke this PROC, copy the LKONLN2 member of the downloaded
//* object file into a local TSO library; it contains instructions
//* to modify and submit that jobstream.
//*
//*
//* For detailed explanations, see
//* For detailed explanations, see
Line 10: Line 27:
//* http://m204wiki.rocketsoftware.com/index.php/M204_inst_zOS#lkonln
//* http://m204wiki.rocketsoftware.com/index.php/M204_inst_zOS#lkonln
//*
//*
//M204LINK EXEC PGM=IEWL,REGION=0M,
//* ------------------------------------------------------------------
//         PARM='SIZE=(2048K,200K),LIST,LET,NCAL,MAP,AC=1,RMODE=ANY'
//* Note:  If you assembled local object files (RACFPARM, ACF2PARM,
//SYSPRINT DD SYSOUT=*
//*        FUNU, etc.), they are stored in your local object library,
//*        (specified by the LOCALOBJ= symbolic parameter)
//*
//*
//* -----------------------------------------------------------------
//*  Keep the local and downloaded object libraries separate:
//* - If you prepared local object files (RACFPARM, ACF2PARM, FUNU,
//*  etc.), they are stored in your local object library - the first
//*  ROKOB204 DD statement below, with the downloaded object library
//*  concatenated next; they must have the same DCB attributes.  Keep
//*  the local and downloaded object libraries separate:
//*
//*
//*  - Do not store local object files in the downloaded object
//*  - Do not store local object files in the downloaded object
Line 26: Line 39:
//*    library.
//*    library.
//*
//*
//* - If you do not have local object files, ROKOB204 DD is the
//* ******************************************************************
//*   downloaded object library; delete the second concatenation.
//* First step - allocate empty PDS as LOCALOBJ placeholder:
//*
//*
//ROKOB204 DD DISP=SHR,DSN=>>Local or downloaded object library <<<<<<<
//ALLOCNUL EXEC PGM=IEFBR14
//        DD DISP=SHR,DSN=>>Downloaded object library          <<<<<<<
//NULLPDS  DD DISP=(,PASS),UNIT=SYSDA,SPACE=(TRK,(2,1,1)),
//* -----------------------------------------------------------------
//            DCB=(DSORG=PO,RECFM=FB,LRECL=80,BLKSIZE=32720),
//            DSN=&&NULPDS
//* ******************************************************************
//* Second step - link ONLINE:
//*
//M204LINK EXEC PGM=IEWL,REGION=0M,
//        PARM='SIZE=(2048K,200K),LIST,LET,NCAL,MAP,AC=1,RMODE=ANY'
//SYSPRINT DD SYSOUT=*
//*
//*
//SYSLMOD  DD DISP=SHR,DSN=>>Loadlib for new Model 204 modules <<<<<<<
//RKOBJ204 DD DISP=SHR,DSN=&LOCALOBJ, Empty PDS if no local object
//            DCB=BLKSIZE=32720
//        DD DISP=SHR,DSN=&RKOBJ204 Downloaded M204 object library
//*
//*
//* -----------------------------------------------------------------
//SYSLMOD  DD DISP=SHR,DSN=&SYSLMOD  Loadlib for new Model 204 modules
//* If using the ACF2 security interface, add DSN & uncomment the DD:
//*
//*
//*ACF2    DD DISP=SHR,DSN=>>ACF2 library, or delete this line  <<<<<<<
//MQ      DD DISP=SHR,DSN=&MQ      IBM MQ series load library
//* -----------------------------------------------------------------
//* If have an MQ series load libary, uncomment this DD with correct
//* DSN.  This makes MQ series usable in the online, either if
//* already authorized, or to trial without requiring re-linking:
//*
//*
//*MQOLIB  DD DISP=SHR,DSN=MQSERIES.SCSQLOAD                  <<<<<<<
//ACF2    DD DISP=SHR,DSN=&ACF2    ACF2 system load/object library
//*
//*
//* -----------------------------------------------------------------
//         PEND  **************  End of LKONLN PROC  **************
//SYSLIN DD *
*
* There are two basic choices for the Model 204 ONLINE load
* module - with RSQL (LKSQLONL) or without (LKNOSONL).
*
* Uncomment one of the following 2 INCLUDEs for this load module: <<<<<
*
* INCLUDE ROKOB204(LKSQLONL) ONLINE with RSQL
* INCLUDE ROKOB204(LKNOSONL) ONLINE without RSQL
*
* >> ----- Security interfaces --------------------------------------
* Ignore from the above line thru and including the "end of security
* interfaces" line if you do not use a security interface.
*
* If you do use a security interface, un-comment the appropriate  <<<<<
* line(s) for your interface:
*
* INCLUDE ROKOB204(RACFOS,RACFPARM)        >> RACF: static RACFPARM
* INCLUDE ROKOB204(RACFOS)                >> *or* dynamic RACFPARM
*
* INCLUDE ROKOB204(ACF2,SBA2OS,ACF2PARM)  >> ACF2: static ACF2PARM
* INCLUDE ROKOB204(ACF2,SBA2OS)            >> *or* dynamic ACF2PARM
* INCLUDE ACF2($ACFGCVT,ACF$FGCB)          >> ACF2 always needs this
*
* INCLUDE ROKOB204(TOPSOS,TOPSPARM)   >> Top Secret: static TOPSPARM
* INCLUDE ROKOB204(TOPSOS)            >>      *or*  dynamic TOPSPARM
*
* >> ----- End of security interfaces -------------------------------
*
* >> ----- If you uncommented MQOLIB DD, uncomment next line: -------
* INCLUDE MQOLIB(CSQBSTUB)          >> If use or may trial MQ series <<
* >> ----- End of MQ/204 INCLUDE ------------------------------------
*
ENTRY MAINTASK
ALIAS BATCH204
NAME ONLINE(R)
/*
//* ******** End of JZLONLN  ********
</nowiki></p>
</nowiki></p>

Revision as of 19:44, 16 September 2014

//LKONLN PROC RKOBJ204=, Downloaded Model 204 object library // SYSLMOD=, Library to store ONLINE load module // MQ=NULLFILE, IBM MQ series load library // LOCALOBJ=&&NULPDS, Local obj modules: RACFPARM, FUNU, .. // ACF2=NULLFILE ACF2 security interface load/objlib //* //* ********* z/OS JCL PROC to link edit Model 204 ONLINE ******** //* //* ****************************************************************** //* ** Do not copy nor edit this PROC. It is invoked by member ** //* ** LKONLN2, which you should copy from the downloaded object ** //* ** library and then edit in a local TSO library. ** //* ****************************************************************** //* //* The first two symbolic parameters (RKOBJ204= and SYSLMOD=) are //* required. The other three depend on your ONLINE configuration. //* //* To invoke this PROC, copy the LKONLN2 member of the downloaded //* object file into a local TSO library; it contains instructions //* to modify and submit that jobstream. //* //* For detailed explanations, see //* //* http://m204wiki.rocketsoftware.com/index.php/M204_inst_zOS#lkonln //* //* ------------------------------------------------------------------ //* Note: If you assembled local object files (RACFPARM, ACF2PARM, //* FUNU, etc.), they are stored in your local object library, //* (specified by the LOCALOBJ= symbolic parameter) //* //* Keep the local and downloaded object libraries separate: //* //* - Do not store local object files in the downloaded object //* library. //* - Do not mix any downloaded object files in the local object //* library. //* //* ****************************************************************** //* First step - allocate empty PDS as LOCALOBJ placeholder: //* //ALLOCNUL EXEC PGM=IEFBR14 //NULLPDS DD DISP=(,PASS),UNIT=SYSDA,SPACE=(TRK,(2,1,1)), // DCB=(DSORG=PO,RECFM=FB,LRECL=80,BLKSIZE=32720), // DSN=&&NULPDS //* ****************************************************************** //* Second step - link ONLINE: //* //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=&LOCALOBJ, Empty PDS if no local object // DCB=BLKSIZE=32720 // DD DISP=SHR,DSN=&RKOBJ204 Downloaded M204 object library //* //SYSLMOD DD DISP=SHR,DSN=&SYSLMOD Loadlib for new 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 LKONLN PROC **************