OA41998: CORRECT VARIOUS PROBLEMS IN JES3 HJS7790

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Fix various problems in JES3 HJS7790.
  
  The projected closing code for this APAR is PER for release
  HJS7790.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of HJS7790.                        *
  ****************************************************************
  * PROBLEM DESCRIPTION: Various problems in HJS7790.            *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The following problems exist:
  
  1. MG18873 -
     JES3 may provide incorrect values for the following SSI80
     fields (IAZSSST):
     - STVBMLRC = Max LRECL of JCLIN stream
       JES3 returns a value of 0 for jobs which do not have SYSIN.
     - STJQOSS = Name of Subsystem which created this Job Queue
       Element
       JES3 always returns the string "JES3" for the JES3
       subsystem even when customers have started JES3 with a
       different subsystem name.
  
  
  2. MG18869 -
     - Customer has no choice in preventing duplicate TSO user
       logons.  The only way a customer may prevent duplicate
       logons is by performing actions described in chapter
       "Duplicate logons" in the TSO/E Customization manual.
       Problems may arise if those actions are not performed in
       advance of allowing duplicate TSO logons.
  
     - Networking messages MSGIAT9140, MSGIAT9141 and MSGIAT7090
       may not be routed to the user id instance that submitted a
       job into the NJE network.
  
     - If a keyword (e.g. DUPLOGON) is removed during *MODIFY
       CONFIG processing, the value for the keyword remains
       unchanged.
  

Problem conclusion

• Installation On (All processors)
               Order (Any)
  Activation   Order (Any)
               Type/JES3 restart (Hot,Local)
               Type/IPL (Rolling/DynLPA)
               CLPA (Yes)
  (See Apar II07968 for definitions)
  
  MG18873:
  
  Code in IATGRES was modified to return a minimum value of 80
  which is the required length for JCLIN.
  
  Code in IATSIES was modified to return the subsystem name of
  the JES3 subsystem to which the SSI80 request was submitted.
  
  
  MG18869:
  
  Code has been added to module IATINIC to process a new keyword -
  DUPLOGON - on the OPTIONS initialization statement.  The default
  value is set to NO which will prevent duplicate users from
  logging on.  This setting is compatible with how previous JES3
  releases handled duplicate logons.
  
  Code has been added to IATINIC to recognize when a parameter
  default was specified or omitted.  MSGIAT3302 is issued for any
  change, regardless of whether a keyword parameter was coded or
  omitted.  This change is applicable to all keywords that can be
  modified by the *MODIFY CONFIG command.
  
  Code has been changed in module IATGRJS to support the setting
  of DUPLOGON.  Additionally, code for routing of MSGIAT6108 has
  been modified to adhere to the following priorities:
  
  1. Send it to the system specified via ACMAIN on the MAIN JCL
     statement if the user is logged on there
  2. Send it to the system from which the job was submitted if
     the user is logged on there
  3. Send it to first (oldest) system where the user is logged on
  4. Issue the notification on the global.
  
  
  Code has been added to module IATCNNJ to route messages
  MSGIAT9140, MSGIAT9141 and MSGIAT7090 to the correct instance
  of a TSO user using a similar algorithm as IATGRJS.
  
  Macro IATYTVT was changed to add the DUPLOGON flag and module
  IATIPTVT to display the flag setting.  Module IATIQOPN was
  changed to display the DUPLOGON current setting via MSGIAT8646.
  
  DOCUMENTATION CHANGES:
  ======================
  
  These changes are listed here for reference purposes.  The
  updates will be made in the V2R1 level of the books.
  
  
  JES3 INITIALIZATION AND TUNING REFERENCE:
  
  "Table 4.  Initialization Statement Summary M thru Z."
   The DUPLOGON parameter will be added to the OPTIONS
   initialization statement with the following information:
   - Req or Opt = Opt
   - Parameter Defaults = NO
   - Start Type to Modify = W, C, HR
  
  "Table 6.  Defaults Taken When Parameters Values Are Not Valid"
   The DUPLOGON parameter will be added to the OPTIONS
   initialization statement with a Default of NO.
  
   "OPTIONS (JES3 Options)"
   The list under "Use the OPTIONS initialization statement to
   specify:" will be updated to include:
  
    o Whether you want to allow duplicate TSO/E logons across
      multiple systems in the JES3 complex.
  
  "Table 47. OPTIONS Summary"
   The "Statement Default" will be updated to include DUPLOGON=NO
   The "Restart or Command Modification" will be updated to
   include DUPLOGON.
  
  The syntax diagram will be updated to include DUPLOGON= with
  NO and YES as valid values.
  
  "Parameters" will be updated to include DUPLOGON:
   DUPLOGON=
     Indicates whether duplicate TSO/E logons across multiple
     systems in the JES3 complex are allowed.
  
   YES
     Specifies that a TSO/E logon for a specific userid may be
     active on each system in the JES3 complex.
  
   NO
     Specifies that only one instance of a TSO/E logon for a
     specific userid may be active in the JES3 complex.
  
     If you specify an invalid subparameter, JES3 uses the
     parameter default.
  
  
  JES3 MESSAGES:
  
  Update MSGIAT8646 to add DUPLOGON=xxx to the syntax diagram
  between DUPJOBNM=xx and WANTDUMP.
  
  APAR OA41998 prereq's (and sup's) for FMID HJS7790:
  Pre's: * NONE *
  

Temporary fix

• *** * TEMPORARY FIX MAY BE OBTAINED FROM DLL OR INFO/ACCESS ****
  ******************* OA41998  DECK AVAILABLE ********************
  

Comments

• ž**** AE14/03/07 FIX IN ERROR. SEE APAR OA44693  FOR DESCRIPTION
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UA69062

Modules/Macros

• IATCNNJ  IATGRES  IATGRJS  IATINIC  IATIPTVT
  IATIQOPN IATSIES  IATSIJS  IATYTVT
  

Fix information

• Fixed component name

  JES3

• Fixed component ID

  5752SC1BA

Applicable component levels

• R790 PSY UA69062

     UP13/05/24 P F305

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.