PI94090: ALLOW LU6.1 SESSIONS ONLY IF APPLID IS LISTED IN A TABLE.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Allow LU6.1 sessions only if APPLID is listed in a table.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IBM IMS Extended Terminal Option Support *
  *                 for z/OS Version 3 Release 2 (FMID=H1J4320)  *
  *                 users.                                       *
  ****************************************************************
  * PROBLEM DESCRIPTION: New function to restrict LU 6.1 session *
  *                      to be connected by specifying list of   *
  *                      allowed LUNames.                        *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This enhancement is being implemented as a result of RFE ID
  111291.
  You can activate the new function either by IMS ETO Support user
  interface panel or batch utility.
  

Problem conclusion

Temporary fix

Comments

• To activate the new function in IMS ETO Support user interface
  panel, follow the instructions below:
  1. Specify Y to the new LU DEFINITION REQUIRED option on the
     DEVICE OPTIONS LU 6.1 (ISC) panel
  2. Display new LU 61 (ISC) MEMBER LIST panel by selecting
     4 - LU 6.1 (ISC) on the LU NAME SPECIFIC OPTIONS panel.
  3. Enter allowed LU 6.1 member names on the LU61 (ISC) MEMBER
     LIST panel.
  4. (Optional) Enter a logon descriptor for each LU 6.1 member
     selected on the LU61 (ISC) MEMBER LIST panel.
  
  To activate the new function in IMS ETO Support batch utility,
  follow the instructions below:
  1. Specify the new LUDEFREQ=YES parameter on Z6 (default for
     LU 6.1 devices) control statement.
  2. Specify allowed LU 6.1 type node names on the new Z7
     (LU 6.1 LUName record) control statements.
  3. (Optional) Specify a logon descriptor by LDEST= parameter
     on the Z7 control statement.
  
  ========================
  = Documentation Change =
  ========================
  IBM IMS Extended Terminal Option Support for z/OS Version 3
  Release 2, User's Guide and Reference (SC19-3982-02) should be
  changed as follows:
  ================================================================
  > Batch utility
  >> Updating the options data set (batch update utility)
  >>> Control statement syntax for batch update utility
  * The following line is added to Figure 1.
  
  ----------------------------------------------------------------
  :
      Z1 (default SLU1 console device)
       Z3 (default for SLUP/3600/FINANCE device)
       Z6 (default for LU 6.1 devices)
  |    Z7 (for LU 6.1 LUName)
       ZM (DFS3649 error messages)
  :
  ================================================================
  >>> Control statement syntax for batch update utility
  >>>> Z6 - Default device control statements for LU 6.1
  * The following page is added after Z3 - Default device
    control statements for SLUP/3600/FINANCE:
  ----------------------------------------------------------------
  Z6 - Default device control statements for LU 6.1
  This reference topic describes how to add, modify, or delete the
  default device record for LU 6.1 devices.
  ---------------------------------------------------
  Adding the default device record for LU 6.1 devices
  ---------------------------------------------------
  The control statement for adding the default device record for
  LU 6.1 devices is:
  +--------------------------------------------------------------+
  | Z6 <keyword-parameters>                                      |
  +--------------------------------------------------------------+
  Example:
   The following control statement changes the default ASOT value
   for LU 6.1 devices:
  +--------------------------------------------------------------+
  | Z6 ASOT=90                                                   |
  +--------------------------------------------------------------+
  The following keyword parameters can be specified:
  ASOT=
    This represents the automatic signoff time.
    The numeric value must be 0,or within the range of 10-1440.
  ALOT=
    This represents the automatic logoff time.
    The numeric value must be 0, or 10-1440.
  LOGON=
    Specify one of these options:
    o LOGON=ETOS (to use IMS ETO Support process)
    o LOGON=DFSLGNX1 (to use DFSLGNX1 user exit)
    o LOGON=AUTO (to use IMS ETO Support auto signon feature)
  MSGDEL=
    Represents the messages that are discarded by IMS for the
    specified terminal. The options are:
    o MSGDEL=SYSINFO
    o MSGDEL=NOTERM
    o MSGDEL=NONIOPCB
  LUDEFREQ=
    Specifies whether a LU name record must be defined for a
    logon to be successful.
    YES
      The IMS ETO Support LU name table is searched at logon
      time. The logon fails if there is not a matching entry
      in the table.
    NO
      Logon continues even if there is not a matching entry
      in the LU name table.
  RESP=
    This represents the terminal response option. Valid
    specifications are:
    o RESP=NORESP
    o RESP=FORCRESP
    o RESP=TRANRESP
  SECURITY=
    Specify the name of the Security Group assigned to these
    devices. This option is used only if IMS ETO Support
    Security Table Lookup option is selected.
  SGNUSREC=
    Specifies whether a user ID record must be defined for a
    signon to be successful.
    SGNUSREC=YES
      The IMS ETO Support user ID table is searched at signon
      time. The signon fails if there is not a matching entry
      in the table.
    SGNUSREC=NO
      Signon continues even if there is not a matching entry
      in the user ID table.
  --------------------------------
  Deleting a default device record
  --------------------------------
  The control statement format for deleting the default device
  record for LU 6.1 devices is:
  +--------------------------------------------------------------+
  | Z6 DELETE                                                    |
  +--------------------------------------------------------------+
  ================================================================
  >>> Control statement syntax for batch update utility
  >>>> Z7 - LU 6.1 LUName recoed control statements
  * The following page is added after Z6 - Default device control
    statements for LU 6.1:
  ----------------------------------------------------------------
  Z7 - LU 6.1 LUName recoed control statements
  This reference topic describes how to add, modify, or delete an
  LU 6.1 LUName record.
  ------------------------------
  Adding an LU 6.1 LUName record
  ------------------------------
  The control statement for adding an LU 6.1 LUName record is:
  +--------------------------------------------------------------+
  | Z7 <node> <keyword-parameters>                               |
  +--------------------------------------------------------------+
  Example:
  +--------------------------------------------------------------+
  | Z7 IMS0                or                                    |
  | Z7 IMS0 LDESC=DFSLU61                                        |
  +--------------------------------------------------------------+
  <node>
    Specifies the LU 6.1 type node name. The node name must be 1-8
    uppercase alphanumeric characters.
    Character 1 must be alphabetic or national (@#$).
    You can use wildcards if you don't want to use specific
    LUNAMEs. Wildcards include:
    o Percent sign (%) - represents a one-to-one relationship with
      character positions in your LUNAMEs.
    For example, L1%%% captures those members beginning with L1
    followed by any three characters.
    o Question mark (?) - represents a one-to-one relationship
      with numeric positions in your LUNAMEs.
    For example, L1??? captures those members beginning with L1
    followed by three numeric digits.
    o Asterisk (*) - represents any characters (from zero to many)
      in the LUNAME.
    For example, L1* captures all members starting with L1.
    Note: An asterisk must be the last character in the name.
    When adding an LU 6.1 LUName record, you can specify the
    following keyword parameter (in addition to the function and
    node parameters):
  
  LDESC=
    Specifies the logon descriptor. The descriptor must be 1-8
    alphanumeric characters. Character 1 must be alphabetic or
    national (@#$).
    When IZTFAIL is specified as the Logon Descriptor, IMS ETO
    Support will reject the logon attempt.
  ------------------------
  Deleting a LU 6.1 LUName
  ------------------------
  The control statement format for deleting an LU 6.1 LUName is:
  +--------------------------------------------------------------+
  | Z7 <node> DELETE                                             |
  +--------------------------------------------------------------+
  Example:
    The following control statement deletes ab LU 6.1 LUName:
  +--------------------------------------------------------------+
  | Z7 IMS0 DELETE                                               |
  +--------------------------------------------------------------+
  ================================================================
  > Troubleshooting
  >> Runtime messages (IZT)
  * The following message is added:
  
  | IZT3122E INVALID VALUE SPECIFIED FOR "LU DEFINITION REQUIRED"
  | Explanation: You have specified an invalid value in the
  |              "LU DEFINITION REQUIRED" field.
  | System action: No processing is attempted.
  | User response: Enter a valid option in the
  |                "LU DEFINITION REQUIRED" field and try the
  |                operation again.
  | Module: IZTDUPD0
  

APAR Information

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

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

  UI55384

Modules/Macros

•    IZTAPPC0 IZTAPPC9 IZTDLST0 IZTDUPD0 IZTINTXL
  IZTLGNXD IZTLGNXE IZTLGNXF IZTLIST  IZTLKUP0 IZTLOAD1 IZTLOAD2
  IZTNLST0 IZTNUPD0 IZTRAN   IZTUD1U0
  

Fix information

• Fixed component name

  IMS ETO SUPPORT

• Fixed component ID

  5655E1200

Applicable component levels

• R320 PSY UI55384

     UP18/04/25 P F804

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.