Template:JZJONLN: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Automatically generated page update)
(Automatically generated page update)
 
(8 intermediate revisions by the same user not shown)
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>//name   JOB jobCardParameters
<p class="code"><nowiki>//name     JOB jobCardParameters
//*
//*
//       JCLLIB ORDER=(downloadObjectLibDsn)           required    1 <<
//         JCLLIB ORDER=(hlq.M204V77.RKOBJLIB)         required    1 <<
//*
//*
//* For detailed explanations, see
//* For detailed explanations, see
Line 10: Line 10:
//* http://m204wiki.rocketsoftware.com/index.php/M204_inst_zOS#lkonln
//* http://m204wiki.rocketsoftware.com/index.php/M204_inst_zOS#lkonln
//*
//*
//LKONLN EXEC LKONLN,
//LKONLN EXEC LKM204P,
//      RKOBJ204=downloadObjectLibDsn,               required    2 <<
//      HLQ=,                                         required    2 <<
//      SYSLMOD=m204LoadLibDsn,                      required    3 <<
//      MQ=ibmMqLoadLibDsn,                          recommended 3 <<
//      MQ=ibmMqLoadLibDsn,                          recommended 4 <<
//      ACF2=acf2SecurityInterfaceLoadOrObjlibDsn    optional    4 <<
//      LOCALOBJ=locallyAssembledObjlibDsn            optional    5 <<
//      ACF2=acf2SecurityInterfaceLoadOrObjlibDsn    optional    6 <<
//*
//*
//* ------------------------------------------------------------------
//* ------------------------------------------------------------------
Line 23: Line 21:
//* submit the job with those changes.
//* submit the job with those changes.
//*
//*
//* There are two groups of changes; the DSNs above (lines 1-6) and
//* There are two groups of changes; those for DSNs (lines 1-4 above)
//* the SYSLIN input.  The SYSLIN changes are explained in the
//* and the SYSLIN input.  The SYSLIN changes are explained in the
//* comments after the SYSLIN DD *.  The DSNs are explained here.
//* comments after the SYSLIN DD *.  Lines 1-4 are explained here.
//*
//*
//* Lines 1-3 marked '<<' above MUST be edited and provided; lines 4-6
//* Lines 1-2 marked '<<' above MUST be edited and provided; lines 3-4
//* are optional; if they do not apply to your configuration, delete
//* are optional; if they do not apply to your configuration, delete
//* them.
//* them.
//*
//*
//* 1 & 2: Provide the DSN of the downloaded object library
//* 1: Change 'hlq' to the same value provided in (2) - the value
//*    inside parentheses will then be the DSN of the downloaded
//*    object library
//*
//*
//* 3: Provide the DSN of the Model 204 load library into which the
//* 2: Provide the high level qualifier(s) of all Model 204
//*    load module will be stored
//*    installation DSNs
//*
//*
//* It is recommended that you edit the MQ= paramter line as well:
//* It is recommended that you edit the MQ= paramter line as well:
//*
//*
//* 4. Provide the DSN system IBM MQ Series load library (and
//* 3. Provide the DSN system IBM MQ Series load library (and
//*    un-comment the INCLUDE MQ statement in the SYSLIN input).
//*    uncomment the INCLUDE MQ statement in the SYSLIN input).
//*
//*
//*    The MQ DSN is not required if you will never even trial the
//*    The MQ DSN is not required if you will never even trial the
Line 47: Line 47:
//*    load library.
//*    load library.
//*
//*
//* In addition, you may need to provide one or two additional DSNs
//* In addition, you might need to provide an additional DSN above:
//* above:
//*
//*
//* 5. Provide the DSN of your local object library if you have
//* 4. If you use ACF2 as an external authorizer for Model 204,
//*    assembled any local object files, e.g., RACFPARM, FUNU, ...
//*    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 have any locally assembled
//*    Delete this line if you do not use ACF2.  In that case (to
//*    object files.
//*    avoid a JCL error), remove the comma from the preceding line,
//*    whether it is HLQ= or MQ=.
//*
//*
//* 6. Provide the DSN of the system ACF2 load or object library from
//* ------------ End of description of symbolic parameters -----------
//*   Computer Associates, if you use ACF2 as an external authorizer
//*
//*   for Model 204 (you will also need to un-comment the INCLUDE
//* In addition, you might need to uncomment the BLOCKPRT DD:
//*    ACF2 statement in the SYSLIN input).
//*
//*
//*    Delete this line if you do not use ACF2.
//* 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).
//* ------------------------------------------------------------------
//*
//*
//* And of course, if you delete line 6 (ACF2=), you must remove the
//* (-- For Rocket Support only: filename=JZJONLN  7.7 2016/11/14 --)
//* comma from the final parameter (to avoid a JCL error), whether it
//* is SYSLMOD=, MQ=, or LOCALOBJ=.
//*
//*
//* ------------ End of description of symbolic parameters -----------
//*M204LINK.BLOCKPRT DD DISP=SHR,DSN=SYS1.AOSB0                    5 <<
//* ------------------------------------------------------------------
//*
//*
//M204LINK.SYSLIN DD *
//M204LINK.SYSLIN DD *
*
*
* Along with the symbolic parameter changes above, see lines marked
* Along with the symbolic parameter changes above, see lines marked
* '<<' below to determine which changes you must make, and submit the
* '<<' below, make necessary changes, and submit the resulting
* jobstream with your changes.
* 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 <<
* ---- Primary INCLUDE: with or without RSQL ---------     Required: A
* There are two basic choices for the Model 204 ONLINE load
* There are two basic choices for the Model 204 ONLINE load module -
* module - with RSQL (LKSQLONL) or without (LKNOSONL).  To choose,
* with RSQL (LKSQLONL) or without (LKNOSONL).  To choose, uncomment
* uncomment just one of the next 2 INCLUDEs for this load module:
* just one of the next 2 INCLUDEs for this load module:
*
*
* INCLUDE RKOBJ204(LKSQLONL) ONLINE with RSQL                     A <<
* INCLUDE RKOBJ204(LKSQLONL) ONLINE with RSQL         Uncomment this <<
* INCLUDE RKOBJ204(LKNOSONL) ONLINE without RSQL               or A <<
* INCLUDE RKOBJ204(LKNOSONL) ONLINE without RSQL     or this        <<
* -------- End of primary INCLUDE ------------------------------------
* -------- End of primary INCLUDE ------------------------------------
*
*
* ---- INCLUDE for Model 204 MQ interface --------- Recommended:   B <<
* ---- INCLUDE for Model 204 MQ interface ------------  Recommended: B
* If you uncomment the next line, EXEC LKONLN must have MQ=dsn:
* If you uncomment the next line, EXEC LKONLNP must have MQ=dsn:
* INCLUDE MQ(CSQBSTUB)                To allow use of MQ series   B <<
* INCLUDE MQ(CSQBSTUB)                To allow use of MQ series     <<
* -------- End of MQ/204 INCLUDE -------------------------------------
* -------- End of MQ/204 INCLUDE -------------------------------------
*
*
* -------- Security interfaces ----------------------- Optional:   C <<
* -------- Security interfaces ----------------------- Optional:     C
* Ignore from the above line thru and including the "end of security
* Ignore from the above line thru and including the "end of security
* interfaces" line if you do not use a security interface.
* interfaces" line if you do not use an external authorizer.
*
*
* If you use a security interface, un-comment the appropriate     C <<
* If you use an external authorizer, uncomment the appropriate
* line(s) for your interface:
* 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,RACFPARM)          RACF static RACFPARM <<
* INCLUDE RKOBJ204(RACFOS)                    *or* dynamic RACFPARM
* INCLUDE RKOBJ204(RACFOS)                    *or* dynamic RACFPARM <<
*
*
* INCLUDE RKOBJ204(ACF2,SBA2OS,ACF2PARM)     ACF2: static ACF2PARM
* INCLUDE ACF2($ACFGCVT,ACF$FGCB)            ACF2 always needs      <<
* INCLUDE RKOBJ204(ACF2,SBA2OS)               *or* dynamic ACF2PARM
* INCLUDE RKOBJ204(ACF2,ACF2PARM)             ACF2 static ACF2PARM <<
* INCLUDE ACF2($ACFGCVT,ACF$FGCB)            ACF2 always needs    D <<
* INCLUDE RKOBJ204(ACF2)                     *or* dynamic ACF2PARM <<
* Using ACF2 also requires that EXEC LKONLN have ACF2=dsn            <<
*
*
* INCLUDE RKOBJ204(TOPSOS,TOPSPARM)      Top Secret: static TOPSPARM
* INCLUDE RKOBJ204(TOPSOS,TOPSPARM)      Top Secret static TOPSPARM <<
* INCLUDE RKOBJ204(TOPSOS)                    *or*  dynamic TOPSPARM
* INCLUDE RKOBJ204(TOPSOS)                    *or*  dynamic TOPSPARM <<
* -------- End of security interfaces --------------------------------
* -------- 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
  ENTRY MAINTASK
  ALIAS BATCH204
  ALIAS BATCH204
ALIAS FUNLOAD(FUNLPGM)
  NAME ONLINE(R)
  NAME ONLINE(R)
/*
/*
</nowiki></p>
</nowiki></p>

Latest revision as of 21:29, 14 November 2016

//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) /*