IBM Support

Updates to IMS ETO Support V3.2 User's Guide

Product Documentation


Abstract

Updates that apply to IMS ETO Suport V3.2 User's Guide (SC19-3982-02).

Content

The most recent updates appear at the top of the list.


Update 5
Date of change: May 2021
Change description: Documentation changes for APAR PH22311.  In this enhancement, IMS ETO Support provides a new option that enables you to remap the destination LTERM names of IMS messages to different names.
Topics: Changes apply to multiple topics.

====================================
Topic: IMS ETO Support overview  > IMS ETO Support overview  > What does IMS ETO Support do?

A new entry has been added to the list of IMS ETO Support features and benefits.
 

IMS ETO Support features and benefits

...

The following IMS ETO Support features and benefits allow you to:

  • ...
  • Perform transaction/LTERM and transaction/password authorization previously provided by the IMS Security Maintenance Utility (SMU)
  • Of all messages that are sent by IMS, remap the destination LTERM names of the messages addressed to certain printer LTERMs 

====================================
Topic: Configuring IMS ETO Support  > Configuring IMS ETO Support  > IMS ETO Support configuration overview

The two formulas for calculating E/CSA usage have been changed, as follows:
 

The following example shows the two formulas for calculating: E/CSA usage:

Formula for 0 or 1 LTERMs:
E/CSA = ((x * 144) + (y * 100) + (z * 240) + 4096) 

Formula for 2 to 8 LTERMs:
E/CSA = ((x * 144) + (y * 100) + (z * 240) + (x * 128) + (y * 128) + 4096) 

====================================
Topic: Configuring IMS ETO Support  > Choosing IMS ETO Support options  > Processing options

A new subtopic named "Remapping printer LTERM names" has been added, as follows:
 

Remapping printer LTERM names

IMS ETO Support provides the REPLACEMENT STRING option for each printer LTERM entry. By using this option, you can enable IMS ETO Support to intercept DL/I calls to IMS and to redirect only the messages for certain LTERMs to different LTERMs. To avoid degrading the performance, this function is enabled at IMS startup only if a value is specified in the REPLACEMENT STRING field for one or more printer LTERM entries.

If this function is enabled at IMS startup, message IZT1017I is issued in the IMS control region. If none of the printer LTERM entries has a value specified for the REPLACEMENT STRING field, this function is disabled at IMS startup. If this function is disabled at IMS startup, message IZT1017I is not issued in the IMS control region. In this case, messages are not redirected even if you specify a REPLACEMENT STRING value while IMS is running.

As the mask character for REPLACEMENT STRING, you can use the exclamation point ( ! - X'5A'). If mask characters are included in the REPLACEMENT STRING value, the values of the corresponding bytes in the original LTERM name will be used in the remapped LTERM name. For example, if the REPLACEMENT STRING value of "PRT!!!" is specified for LTERM "TRM001", messages originally addressed to TRM001 will be remapped to PRT001. If no mask characters are included, the REPLACEMENT STRING value will be used as the remapped LTERM name.

When IMS ETO Support searches the printer LTERM table during unknown destination processing, the remapped LTERM name is used for a printer LTERM entry for which a REPLACEMENT STRING value was specified; the original LTERM name is not searched for.

If you do not want to replace the name of a printer LTERM entry, you do not need to specify any REPLACEMENT STRING value. 

There is no point in specifying the same value as the original LTERM name or the exclamation point ( ! - X'5A') for all digits.

The following cases might result in an unexpected result because IMS ETO Support cannot determine which printer LTERM entry value to use during printer LTERM creation:

  • If the remapped printer LTERM name overlaps with another printer LTERM entry name
  • If the remapped printer LTERM name overlaps with another remapped printer LTERM name

====================================
Topic: Using IMS ETO Support  > Customizing options  > Adding, changing, deleting LTERM names

Figure "Dynamic LTERM Update panel" and its description have been updated with a new REPLACEMENT STRING parameter.
 

Figure 2. Dynamic LTERM Update panel

IZTRAN                        IMS ETO-SUPPORT                   IMSID:   IMSJ
COMMAND ===>                 VERSION - 03.02.00                 RELEASE: 15.1.0
                              LTERM NAME UPDATE
 
LTERM  ===> LTERM01      (REQUIRED)     REPLACEMENT STRING  ===> LTERM01A
 
---- ENTER ----
  USER EXIT OPTION
     USER DFSINSX1 ===> N    (Y/N, DEFAULT = N)
 
----- OR ------
  PRINTER DATA                                   MSGDEL OPTIONS
     NODE NAME  ===> NODE001                     2   1 - SYSINFO
     LOGMODE    ===>                                 2 - NOTERM
     LOGON DESC ===> DFSSLU1P                        3 - NONIOPCB
     ASOT       ===> 1440      (BLANKS, 0000, 0010-1440)
     SKIP AUTO-LOGON  ===> N   (Y/N, DEFAULT = N)
 
----- OR ------
  RCNT DATA
     MSNAME  ===>

...

REPLACEMENT STRING
Specifies the replacement string for the destination LTERM name. This field is used for remapping the destination LTERM name when messages are sent to IMS.

The value must be 1- 8 uppercase alphanumeric characters (0 - 9, A - Z) or national characters (@#$).

You can use the exclamation point (! - X'5A') as the mask character. If mask characters are used, the corresponding bytes in the original LTERM name will be used in the remapped LTERM name.

====================================
Topic: Using IMS ETO Support  > Test facilities: Translation table lookup  > LTERM lookup

Figure "LTERM Lookup panel" and its description have been updated with new parameters: REPLACEMENT STRING and RESULT LTERM.
 

IZTRAN                        IMS ETO-SUPPORT                   IMSID:   IMS0
COMMAND ===>                 VERSION - 03.02.00                 RELEASE: 15.1.0
                                LTERM LOOKUP
LTERM   ===>                 REPLACEMENT STRING   ===>
                             RESULT LTERM         ===>
SEARCH  ===>      1 - SEARCH OPTIONS DATA SET
                  2 - SEARCH E/CSA TABLE
  TABLE ENTRY      ===>
  TABLE TYPE       ===>
  RESULT USER      ===>
  LTERM MASK       ===>
  RCNT NAME        ===>
 
                   ----------  AUTOLOGON DATA  ----------
  - (PRINTER TABLE ONLY)                  - (LU 6.1 USERID TABLE ONLY)
  USER DFSINSX1    ===>                   NODE NAME        ===>
  NODE MASK        ===>                   LOGON DESC       ===>
  RESULT NODE      ===>                   REMOTE ID        ===>
  LOGMODE          ===>                   LOGMODE          ===>
  LOGON DESC       ===>
  ASOT             ===>
  MSGDEL           ===>
  SKIP AUTO-LOGON  ===>

...

If a matching LTERM is found, the remaining fields of the screen are populated with any defined options. The data contained in the remaining fields is as follows:

REPLACEMENT STRING
The value used for remapping outbound messages. 

RESULT LTERM
When a message is sent to IMS, IMS ETO Support remaps the destination LTERM name to this name by using the value specified in REPLACEMENT STRING.
If mask characters are used in REPLACEMENT STRING, IMS ETO Support merges the original LTERM name with the REPLACEMENT STRING value to build the resulting name. If no mask characters are used, the new name is built from the REPLACEMENT STRING value. 

TABLE ENTRY
Name of the member that had a matching LTERM or mask character.

...

====================================
Topic: Batch utility  > Updating the options data set (batch update utility)  > Control statement syntax for batch update utility  > ZP - LTERM record control statements

A new parameter, REPLSTR, has been added under subtopic "Adding an LTERM defined as a printer."  

REPLSTR=

The value used for remapping outbound messages. When a message is sent to IMS, IMS ETO Support remaps the destination LTERM name to this name by using the value specified in REPLACEMENT STRING.

If mask characters are used in REPLACEMENT STRING, IMS ETO Support merges the original LTERM name with the REPLACEMENT STRING value to build the resulting name. If no mask characters are used, the new name is built from the REPLACEMENT STRING value. 

====================================
Topic: Troubleshooting  > Runtime messages (IZT)

New messages, IZT1016E , IZT1017I , and IZT4430I, have been added:
 

IZT1016E LOCATE FAILED FOR IZTDLA30, ETO-SUPPORT IS DEACTIVATED

Explanation
During IMS restart, IMS ETO Support was unable to locate module IZTDLA30 in the IMS control region STEPLIB concatenation. IMS ETO Support does not function if this error is encountered.

System action
IMS restart continues, but IMS ETO Support is deactivated.

User response
Make sure the IMS ETO Support modules are installed properly in the IMS control region STEPLIB library.

Module
DFSINTX0

----------

IZT1017I PRINTER LTERM NAME REPLACEMENT OPTION HAS BEEN ENABLED

Explanation
The printer LTERM name replacement option has been enabled.

System action
None.

User response
None. This message is informational.  

Module
DFSINTX0

----------

IZT4430I REPLACEMENT STRING CONTAINS AN INVALID CHARACTER  

Explanation
One or more invalid characters are included in the REPLACEMENT STRING value.

System action
No processing is attempted.

User response
Enter valid characters for the REPLACEMENT STRING field, and try again.  

Module
IZTLUPD0


Update 4
Date of change: December 2019
Change description: Documentation changes for APAR PH11903
Topics: Changes apply to multiple topics.

====================================

Topic: Configuring IMS ETO Support > Choosing IMS ETO Support options > Configuring IMS ETO Support 

A new subtopic, "Generating IMS ETO Support signon panels," has been added between the current Step 4 and Step 5 under this topic as a new Step 5 procedure. The step numbers of subsequent subtopics have changed as follows:

Step 1: Adding control statements to your IMS definitions
Step 2: Generating the DBD
Step 3: Generating the PSB
Step 4: Generating the ACB

Step 5: Generating IMS ETO Support signon panels 
Step 6: Creating dynamic allocation member for options data set
Step 7: Defining and initializing the options data set
Step 8: Implementing the IMS ETO Support partner product user exit
Step 9: Preparing OTMA connections for IMS ETO Support
Step 10. Restarting IMS
Step 11. Performing IMS online refresh setup (APPC)

 
 

Step 5. Generating IMS ETO Support signon panels

This topic explains how to generate IMS ETO Support signon panels by using a sample JCL and MFS sources.
This setup is required to use IMS ETO Support signon panels.
Members IZTSIGNO and IZTSIGNP of SIZTDATA contain the MFS sources.

 

JCL data set reference

Use the following sample JCL to generate IMS ETO Support signon panels from members IZTSIGNO and IZTSIGNP of SIZTDATA and to store them in the staging data set of the IMS format library.

Except for the JOB statement, which you can change to meet your requirements, change only the following three lines:

  //  SET HLQ=IZT
  //  SET IZTDATA=qual1.qual2.SIZTDATA
  //  SET PROCLIB=IMS.PROCLIB  

IZT
This value is the high level qualifier (HLQ) of the data set SIZTDATA.

qual1.qual2.SIZTDATA
This value specifies other qualifiers of the data set SIZTDATA. This The example supposes that the data set name of SIZTDATA is 'IZT.qual1.qual2.SIZTDATA'.

IMS.PROCLIB
This value is the procedure library of the IMS that contains the MFSUTL procedure.

 

Example JCL

The following example shows the JCL that you can use to generate IMS ETO Support signon panels by using the MFSUTL procedure.

//BUILDMFS JOB MSGCLASS=A,REGION=0K,NOTIFY=&SYSUID
//*
//  SET HLQ=IZT
//  SET IZTDATA=qual1.qual2.SIZTDATA
//  SET PROCLIB=IMS.PROCLIB
//*
// JCLLIB ORDER=(&PROCLIB)
//GENSIGNO EXEC MFSUTL,SNODE=&HLQ,SOR=&IZTDATA,MBR='IZTSIGNO'
//GENSIGNP EXEC MFSUTL,SNODE=&HLQ,SOR=&IZTDATA,MBR='IZTSIGNP'

====================================

Topic: Configuring IMS ETO Support > Choosing IMS ETO Support options > Logon and signon options > Signon process options > SLU2/3270 devices

This topic has been updated as follows:

ETO SUPPORT
Use one of the two types of IMS ETO Support signon panels. By specifying the PASSSIZE suboption, you can choose whether to use the IMS ETO Support password signon panel (uses /SIGN ON command; maximum password length is 8) or the IMS ETO Support passphrase signon panel (uses /SIGN PASSPHRASE command; maximum password length is 100).

If the PASSSIZE suboption is not specified, the MFSPPDEF parameter of the DFSDCxxx PROCLIB member determines which panel to use.

The MFS source code for the IMS ETO Support password signon panel is IZTSIGNO, and the MFS source code for the IMS ETO Support passphrase signon panel is IZTSIGNP.

====================================

Topic: Using IMS ETO Support > Customizing options > Setting global options > Setting global signon options

This topic has been updated as follows:
Figure 1. Global Signon Options panel (Figure 11 in PDF)
 
IZTRAN                        IMS ETO-SUPPORT                   IMSID:   IMS0
COMMAND ===>                 VERSION - 03.02.00                 RELEASE: 14.1.0
                           GLOBAL SIGNON OPTIONS
 
 
LOGON PROCESS           DFS3649                   DFS3650
1   1 - ETO-SUPPORT     1   1 - IMS DEFAULT       1   1 - IMS DEFAULT
    2 - USER DFSLGNX1       2 - DFS2002 MESSAGE       2 - DFS058 MESSAGE
    3 - AUTO SIGNON         3 - ETO-SUPPORT *         3 - BLANK SCREEN
                            4 - USER DFSGMSG1         4 - USER DFSGMSG1
LTERM/USER NAMING OPTIONS:  5 - USER MOD              5 - USER MOD
2   1 - IMS DEFAULT          * _:MFSPPDEF             6 - DFS2002 MESSAGE
    2 - NODE=USER=LTERM        W:PASSWORD
    3 - USERID FROM TABLE      P:PASSPHRASE
    4 - SUFFIXED USERID       IDLE NODE TIMEOUT:  (BLANKS, 0000, 0010-1440)
    5 - USER DFSSGNX1              ASOT 0000
    6 - APPEND "@" TO USERID       ALOT 0015
 

Global signon options reference

DFS3649 options

1 - IMS DEFAULT

Use this option to receive the standard DFS3649A message.

2 - DFS2002 MESSAGE

Use this option to receive message DFS2002.

3 - ETO SUPPORT

Use this option to receive the IMS ETO Support standard signon panel.
PASSSIZE

This suboption is located on the right side of '3 - ETO-SUPPORT *'. Use this suboption to specify which panel to receive when signing on.

P

Use this option to receive the IMS ETO Support passphrase signon panel. Member IZTSIGNP in SIZTDATA contains the MFS source for this option.

W

Use this option to receive the IMS ETO Support password signon panel. Member IZTSIGNO in SIZTDATA contains the MFS source for this option.

If this suboption is not specified, the signon panel is determined by the MFSPPDEF parameter of the DFSDCxxx PROCLIB member.

MFSPPDEF=Y: IMS ETO Support passphrase signon panel is to be used
MFSPPDEF=N: IMS ETO Support password signon panel is to be used

====================================

Topic: Using IMS ETO Support > Customizing options > Setting device-specific options > Device options for the SLU2/3270 device (panel 1 of 2)

This topic has been updated as follows:
Figure 1. Device Options for SLU2/3270 panel (Figure 19 in PDF)
IZTRAN                        IMS ETO-SUPPORT                   IMSID:   IMS0
COMMAND ===>                 VERSION - 03.02.00                 RELEASE: 14.1.0
                   DEVICE OPTIONS FOR SLU2/3270 (1 OF 2)
 
 
LOGON PROCESS           DFS3649                   DFS3650
1   1 - ETO-SUPPORT     1   1 - IMS DEFAULT       1   1 - IMS DEFAULT
    2 - USER DFSLGNX1       2 - DFS2002 MESSAGE       2 - DFS058 MESSAGE
    3 - AUTO SIGNON         3 - ETO-SUPPORT *         3 - BLANK SCREEN
                            4 - USER DFSGMSG1         4 - USER DFSGMSG1
                            5 - USER MOD              5 - USER MOD
LTERM/USER NAMING OPTIONS:   * _:MFSPPDEF             6 - DFS2002 MESSAGE
1   1 - IMS DEFAULT            W:PASSWORD             7 - TRX NAME
    2 - NODE=USER=LTERM        P:PASSPHRASE
    3 - USERID FROM TABLE     IDLE NODE TIMEOUT:  (BLANKS, 0000, 0010-1440)
    4 - SUFFIXED USERID            ASOT 0015
    5 - USER DFSSGNX1              ALOT 0010
    6 - APPEND "@" TO USERID
 
RESPONSE OPTIONS:       MSGDEL OPTIONS:
1   1 - NORESP          1   1 - SYSINFO          DEVICE MODEL     MOD2
    2 - FORCRESP            2 - NOTERM           SECURITY PROFILE SECSLU2
    3 - TRANRESP            3 - NONIOPCB

SLU2/3270 device options reference

DFS3649

1 - IMS DEFAULT

Use this option to receive the standard DFS3649A message.

2 - DFS2002 MESSAGE

Use this option to receive message DFS2002.

3 - ETO-SUPPORT

Use this option to receive the IMS ETO Support standard signon panel.

PASSSIZE

This suboption is located on the right side of '3 - ETO-SUPPORT *'.  Use this suboption to specify which panel to receive when signing on.

P

Use this option to receive the IMS ETO Support passphrase signon panel. Member IZTSIGNP in SIZTDATA contains the MFS source for this option.

W

Use this option to receive the IMS ETO Support password signon panel. Member IZTSIGNO in SIZTDATA contains the MFS source for this option.

If this suboption is not specified, the signon panel is determined by the MFSPPDEF parameter of the DFSDCxxx PROCLIB member.

MFSPPDEF=Y: IMS ETO Support passphrase signon panel is to be used

MFSPPDEF=N: IMS ETO Support password signon panel is to be used

====================================

Topic: Using IMS ETO Support > Customizing options > Setting LUNAME-specific options > Setting LUNAME options for the SLU2/3270 device

This topic has been updated as follows:
Figure 2. LUNAME Options for SLU2/3270 panel (Figure 28 in PDF)
IZTRAN                        IMS ETO-SUPPORT                   IMSID:   IMS0
COMMAND ===>                 VERSION - 03.02.00                 RELEASE: 14.1.0
LUNAME  ===> SC0TCP02   LUNAME OPTIONS FOR SLU2/3270
 
LOGON PROCESS           DFS3649                   DFS3650
1   1 - ETO-SUPPORT       1   1 - IMS DEFAULT       1   1 - IMS DEFAULT
    2 - USER DFSLGNX1         2 - DFS2002 MESSAGE       2 - DFS058 MESSAGE
    3 - AUTO SIGNON           3 - ETO-SUPPORT *         3 - BLANK SCREEN
    4 - USERID                4 - USER DFSGMSG1         4 - USER DFSGMSG1
    5 - RACF USERID           5 - USER MOD              5 - USER MOD
LTERM/USER NAMING OPTIONS:     * _:MFSPPDEF             6 - DFS2002 MESSAGE
1   1 - IMS DEFAULT              W:PASSWORD             7 - TRX NAME
    2 - NODE=USER=LTERM          P:PASSPHRASE
    3 - USERID FROM TABLE    IDLE NODE TIMEOUT:  WTO AUTO SIGNON   Y   (Y/N)
    4 - SUFFIXED USERID           (0, 10-1440)   BYPASS DEQUEUE   N   (Y/N)
    5 - USER DFSSGNX1             ASOT 0060      LOGON DESCRIPTOR
    6 - APPEND "@" TO USERID      ALOT 0010      DEVICE MODEL
                                                 SECURITY PROFILE
RESPONSE OPTIONS:    MSGDEL OPTIONS:
1   1 - NORESP       1   1 - SYSINFO       =======  USER/LTERMS  ========
    2 - FORCRESP         2 - NOTERM
    3 - TRANRESP         3 - NONIOPCB

DFS3649

1 - IMS DEFAULT

Use this option to receive the standard DFS3649A message.

2 - DFS2002 MESSAGE

Use this option to receive message DFS2002.

3 - ETO-SUPPORT

Use this option to receive the IMS ETO Support standard signon panel.

PASSSIZE

This suboption is located on the right side of '3 - ETO-SUPPORT *'. Use this suboption to specify which panel to receive when signing on.

P

Use this option to receive the IMS ETO Support passphrase signon panel. Member IZTSIGNP in SIZTDATA contains the MFS source for this option.

W

Use this option to receive the IMS ETO Support password signon panel. Member IZTSIGNO in SIZTDATA contains the MFS source for this option.

If this suboption is not specified, the signon panel is determined by the MFSPPDEF parameter of the DFSDCxxx PROCLIB member.  

MFSPPDEF=Y: IMS ETO Support passphrase signon panel is to be used

MFSPPDEF=N: IMS ETO Support password signon panel is to be used

====================================

Topic: Batch utility > Updating the options data set (batch update utility) > Control statement syntax for batch update utility > ZN - LUNAME record control statements

This topic has been updated as follows:
DFS3649=
The following options can be specified for the signon screen:
  • DFS3649=IMS (for the IMS default)
  • DFS3649=DFS2002 (to get message DFS2002)
  • DFS3649=ETOS (to use the IMS ETO Support logon)
    If DFS3649=ETOS is specified, you can also use the PASSSIZE= parameter to specify whether to use the IMS ETO Support password logon or the passphrase logon.
  • DFS3649=DFSGMSG1 (for the user DFSGMSG1 greetings exit)
  • DFS3649=MOD (for the user-specified MFS mod name)
    If DFS3649=MOD is specified, you must also specify MOD3649=<modname>.
PASSSIZE=
You can specify one of the following options if DFS3649=ETOS is also specified.
  • PASSSIZE=P (to use ETO Support passphrase signon panel)
  • PASSSIZE=W (to use ETO Support password signon panel)
  • PASSSIZE=  (to specify that the signon panel is to be determined by the MFSPPDEF parameter of the DFSDCxxx PROCLIB member).
    • MFSPPDEF=Y (to use ETO Support passphrase signon panel)
    • MFSPPDEF=N (to use ETO Support password signon panel)
If this parameter is not specified and DFS3649=ETOS, the default is PASSSIZE=.
====================================

Topic: Batch utility > Updating the options data set (batch update utility) > Control statement syntax for batch update utility > ZG - Global options control statements (dynamic refresh)

This topic has been updated as follows:

DFS3649=
Specify one of the following options for processing the DFS3649 signon screen:
  • DFS3649=IMS (for the IMS default screen)
  • DFS3649=DFS2002 (to get message DFS2002)
  • DFS3649=ETOS (to get IMS ETO Support provided signon screen)
    If DFS3649=ETOS is specified, you can also use the PASSSIZE= parameter to specify whether to use the IMS ETO Support password logon or the passphrase logon.
  • DFS3649=DFSGMSG1 (for user DFSGMSG1 greetings exit)
  • DFS3649=MOD (for user supplied MFS mod name)
If DFS3649=MOD is specified, the MOD3649=<modname> parameter must also be supplied.

PASSSIZE=
You can specify one of the following options if DFS3649=ETOS is also specified.
  • PASSSIZE=P (to use ETO Support passphrase signon panel)
  • PASSSIZE=W (to use ETO Support password signon panel)
  • PASSSIZE=  (to specify that the signon panel is to be determined by the MFSPPDEF parameter of the DFSDCxxx PROCLIB member).
    • MFSPPDEF=Y (to use ETO Support passphrase signon panel)
    • MFSPPDEF=N (to use ETO Support password signon panel)
If this parameter is not specified and DFS3649=ETOS, the default is PASSSIZE=.

====================================

Topic: Batch utility > Updating the options data set (batch update utility) > Control statement syntax for batch update utility > ZD - Default device control statements (SLU2 / 3270)

This topic has been updated as follows:
DFS3649=
Specify one of the following options for processing the DFS3649 signon screen:
  • DFS3649=IMS (for the IMS default screen)
  • DFS3649=DFS2002 (to get message DFS2002)
  • DFS3649=ETOS (to get IMS ETO Support provided signon screen)
    If DFS3649=ETOS is specified, you can also use the PASSSIZE= parameter to specify whether to use the IMS ETO Support password logon or the passphrase logon.
  • DFS3649=DFSGMSG1 (for user DFSGMSG1 greetings exit)
  • DFS3649=MOD (for user-supplied MFS mod name)
If DFS3649=MOD is specified, the MOD3649=<modname> parameter must also be supplied.
PASSSIZE=
You can specify one of the following options if DFS3649=ETOS is also specified.
  • PASSSIZE=P (to use ETO Support passphrase signon panel)
  • PASSSIZE=W (to use ETO Support password signon panel)
  • PASSSIZE=  (to specify that the signon panel is to be determined by the MFSPPDEF parameter of the DFSDCxxx PROCLIB member).
    • MFSPPDEF=Y (to use ETO Support passphrase signon panel)
    • MFSPPDEF=N (to use ETO Support password signon panel)
If this parameter is not specified and DFS3649=ETOS, the default is PASSSIZE=.

====================================

Topic: Troubleshooting > Runtime messages (IZT)

The following messages have been added:

PASSSIZE NOT ALLOWED UNLESS DFS3649 PROCESS 3 SPECIFIED
Explanation: A DFS3649 ETOS PASSSIZE option was specified, but a selection other than 3 was entered for DFS3649.
System action: No processing is attempted.
User response: Either select option 3 for DFS3649, or remove the DFS3649 ETOS PASSSIZE option.
Module: IZTGUPD0

 

IZT3167I - PASSSIZE NOT ALLOWED UNLESS DFS3649 PROCESS 3 SPECIFIED
Explanation: A DFS3649 ETOS PASSSIZE option was specified, but a selection other than 3 was entered for DFS3649.
System action: No processing is attempted.
User response: Either select option 3 for DFS3649, or remove the DFS3649 ETOS PASSSIZE option.
Module: IZTDUPD0

 

IZT4667I - PASSSIZE NOT ALLOWED UNLESS DFS3649 PROCESS 3 SPECIFIED
Explanation: A DFS3649 ETOS PASSSIZE option was specified, but a selection other than 3 was entered for DFS3649.
System action: No processing is attempted.
User response: Either select option 3 for DFS3649, or remove the DFS3649 ETOS PASSSIZE option.
Module: IZTNUPD0

 

IZT3368I - INVALID OPTION SELECTED FOR DFS3649 PASSSIZE FIELD
Explanation: The specified DFS3649 ETOS PASSSIZE option is invalid.
System action: No processing is attempted.
User response: Select one of the listed options, and try again.
Module: IZTGUPD0

 

IZT3168I - INVALID OPTION SELECTED FOR DFS3649 PASSSIZE FIELD
Explanation: The specified DFS3649 ETOS PASSSIZE option is invalid.
System action: No processing is attempted.
User response: Select one of the listed options, and try again.
Module: IZTDUPD0

 

IZT4668I - INVALID OPTION SELECTED FOR DFS3649 PASSSIZE FIELD
Explanation: The specified DFS3649 ETOS PASSSIZE option is invalid.
System action: No processing is attempted.
User response: Select one of the listed options, and try again.
Module: IZTNUPD0

 

IZT8201E ** PASSSIZE NOT ALLOWED UNLESS DFS3649=ETOS SPECIFIED
Explanation: The PASSSIZE= parameter was specified, but DFS3649=ETOS was not specified.
System action: The control statement is ignored.
User response: Correct the control statement by taking one of the following actions:

  • Add DFS3649=ETOS to the control statement.
  • Remove PASSSIZE= parameter from the control statement.

Module: IZTUD1U0

 

Update 3

Date of change: Nov 2018

Change description: Documentation changes by APAR PH00106. This APAR modifies the program to load and use a user-supplied DFSCTRN1 instead of DFSCTRN0.

Topics: Changes apply to multiple topics.

====================================

Topic:  IMS ETO Support overview > IMS ETO Support overview > Managing the IMS ETO environment > IMS ETO Support user exits

This topic has been updated as follows:

IMS ETO Support's initialization exit attempts to load the following user exits at IMS startup:

  • DFSINTX1 (Initialization user exit)
  • DFSGMSG1 (Greetings Messages user exit)
  • DFSCCMD1 (Command Authorization user exit)
  • DFSINSX1 (Output Creation user exit)
  • DFSSGFX1 (Signoff user exit)
  • DFSSGNX1 (Signon user exit)
  • DFSSGNX2 (Signon user exit - always called)
  • DFSLGNX1 (Logon user exit)
  • DFSLGNX2 (Logon user exit - always called, unless other logon user exits - DFSLGNX0 or DFSLGNX1 - reject the logon)
  • DFSINSX2 (Output creation exit - called when exit DFSINSX0 ends with a return code zero):
  • DFSCTRN1 (Transaction Authorization user exit)
====================================

Topic: Configuring IMS ETO Support > Choosing IMS ETO Support options > Security options > IMS ETO Support Enhanced Transaction Verification

This following topic has been updated as follows:

The ETV methods are optional and can be used in addition to, or in place of, IMS RACF or IMS SMU security. Only one form of ETV can be used at a time.

Both forms of ETV checking (RACF or IMS ETO Support Matrix) use the IMS Transaction Authorization Exit (DFSCTRN0) to perform the validation.

However, ETV cannot be used If there is an existing user version of DFSCTRN0. To use a user version of DFSCTRN0 along with ETV processing, you must rename the user version of DFSCTRN0 to DFSCTRN1.

For example:

  • At IMS startup, IMS ETO Support sets an intercept for its version of the DFSCTRN0 exit, and saves the address of any user DFSCTRN1 exit.
  • If the IMS ETO Support version of DFSCTRN0 denies access to the transaction, DFSCTRN1 is not invoked.
  • If IMS ETO Support determines access is allowed, DFSCTRN1 is called and all parameter input is the same as if IMS ETO Support was never called.
...

Authorization is performed at initial transaction arrival and for IMS CHNG calls:

  • If multiple LTERMs are assigned to a NODE/USER, IMS ETO Support will perform authorization at initial transaction arrival using the first LTERM that is not either STOPPED or LOCKED.
  • ETV does not process transactions from APPC or OTMA devices.
  • If IMS rejects transaction authorization, the IMS ETO Support DFSCTRN0 exit does not get control.
  • If the IMS ETO Support DFSCTRN0 exit rejects transaction authorization, DFSCTRN1 does not get control.

Update 2
Date of change: May 2018
Change description: Documentation changes by APAR PI94090. This APAR enables users to restrict LU 6.1 sessions to be connected by specifying a list of allowable LU names.
Topics: Changes apply to multiple topics.

====================================

Topic: Configuring IMS ETO Support > Choosing IMS ETO Support options > Logon and signon options > Considerations for LU 6.1 (ISC) sessions

A new section, "LU 6.1 (ISC) LUNAME entries," has been added before the "LU 6.1 (ISC) user ID entries" section, as follows:



LU 6.1 (ISC) LUNAME entries
IMS ETO Support provides an option that ensures that remote systems can use only desired LUNAMEs for signon. This option is called LU DEFINITION REQUIRED. If this option is active, an LU 6.1 (ISC) LUNAME record must be defined in the options data set for every LUNAME that is allowed for LU 6.1 (ISC) sessions.

====================================

Topic: Using IMS ETO Support > Customizing options > Setting device -specific options > Device options for LU 6.1 (ISC)

A new option, LU DEFINITION REQUIRED, has been added to the Device Options LU 6.1 (ISC) panel.

Figure 1. Device Options LU 6.1 (ISC) panel






...

LU 6.1 (ISC) options reference

LOGON PROCESS
...

USER REC REQUIRED FOR SIGNON
Use this option if you want to ensure only desired user IDs are used to start LU 6.1 (ISC) sessions. If this option is set to Y, any USER specified on the /OPNDST command must have an LU 6.1 (ISC) user ID table entry.

LU DEFINITION REQUIRED
Use this option if you want to ensure that only desired LUNAMEs are allowed to start LU 6.1 (ISC) sessions. If this option is set to Y, every node that is specified on the /OPNDST command must have an associated LU 6.1 (ISC) LUNAME table entry.
====================================
Topic: Using IMS ETO Support > Customizing options > Setting LUNAME-specific options

A new device type, LU6.1 (ISC), has been added to the LUNAME Specific Options panel.

Figure 1. LUNAME Specific Options panel



====================================
Topic: Using IMS ETO Support > Customizing options > Setting LUNAME-specific options

The following new section has been added after "Setting LUNAME options for the SLUP/3600/FINANCE device."


Setting LUNAME options for the LU 6.1 device
This topic describes setting LUNAME options for LU 6.1 devices.

Viewing the LU 6.1 device member list
The LU 6.1 Member List panel is displayed if you choose option 4 on the LUNAME Specific Options panel.

Figure 1. LU61 (ISC) Member List panel


This panel displays a list of the LU 6.1 members, if any.
If the LU DEFINITION REQUIRED option is active, only the listed LUNAMEs are allowed to start LU 6.1 (ISC) sessions.
To add an LUNAME, type A on the command line and press Enter.
To update a listed LUNAME entry, tab to the desired name and type S or E next to the name; then press Enter.

Note:
If the name you want does not appear on the list, you can press PF8 or type F on the command line and press Enter to view the next screen of member names.
Or, you can type the first few characters or the entire name on the START command line to scroll through the list.
You can also press PF7 or type B on the command line and press Enter to scroll backwards.
Setting options for the LU 6.1 device
The LUNAME Options for LU 6.1 (ISC) panel is displayed after you select the appropriate option on the LU61 (ISC) Member List panel.
Figure 2. LUNAME Options for LU 6.1 (ISC) panel
LUNAME (command line)
Enter the LUNAME when adding an LU member.
You can use wildcards if you do not want to use specific LUNAMEs. Wildcards include:
  • 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.
  • 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.
  • 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.
LOGON DESCRIPTOR
Specify the 1- to 8-character alphanumeric logon descriptor name. The first character must be alphabetic or national (@#$). If IZTFAIL is specified as the logon descriptor, IMS ETO Support will reject the logon attempt.
====================================
Topic: Using IMS ETO Support >Test facilities: Translation table lookup > LU 6.1 translation lookup

A new column named LUNAME has been added under the ENTRY TYPE field in the LU 6.1 Translation Lookup panel.

Figure 1. LU 6.1 Translation Lookup panel
====================================
Topic: Batch utility > Updating the options data set (batch update utility) > Control statement syntax for batch update utility

A new function parameter, Z7, has been added to the control statement syntax for batch update utility functions:

Figure 1. Control statement syntax for batch update utility functions
  ...
  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)
  ...
====================================
Topic: Batch utility > Updating the options data set (batch update utility) > Control statement syntax for batch update utility

The following new section has been 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 format 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=
Specifies the automatic signoff time.
The numeric value must be 0, or within the range of 10-1440.
ALOT=
Specifies the automatic logoff time.
The numeric value must be 0, or within the range of 10-1440.
LOGON=
Specifies one of these options:
  • LOGON=ETOS (to use the IMS ETO Support process)
  • LOGON=DFSLGNX1 (to use the DFSLGNX1 user exit)
  • LOGON=AUTO (to use the IMS ETO Support auto signon feature)
LUDEFREQ=
Specifies whether an 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 no matching entry in the table.
NO
Logon continues even if there is no matching entry in the LU name table.
MSGDEL=
Specifies the messages that are discarded by IMS for the specified terminal. The options are:
  • MSGDEL=SYSINFO
  • MSGDEL=NOTERM
  • MSGDEL=NONIOPCB
RESP=
Specifies the terminal response option. Valid specifications are:
  • RESP=NORESP
  • RESP=FORCRESP
  • RESP=TRANRESP
SECURITY=
Specifies the name of the security group assigned to these devices.
This option is used only if the 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.

YES
The IMS ETO Support user ID table is searched at signon time.
The signon fails if there is no matching entry in the table.
NO
Signon continues even if there is no 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

====================================
Topic: Batch utility > Updating the options data set (batch update utility) > Control statement syntax for batch update utility
The following new section follows "Z6 - Default device control statements for LU 6.1."

 
Z7 - LU 6.1 LUName record 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 format for adding an LU 6.1 LUName record is:
 
Z7 <node> <keyword-parameters>

Examples:
Z7 IMS0 LDESC=DFSLU61         
 
Z7 IMS0                       

<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 do not want to use specific LUNAMEs. Wildcards include:
  • 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.
  • 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.
  • 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 (@#$).
If IZTFAIL is specified as the logon descriptor, IMS ETO Support will reject the logon attempt.
Deleting an LU 6.1 LUName record
The control statement format for deleting an LU 6.1 LUName record is:
 
Z7 <node> DELETE 

Example:
The following control statement deletes an LU 6.1 LUName record:
 
Z7 IMS0 DELETE   
====================================
The description of LU61 PARM statement has been updated as follows:
PARM statement syntax and entry values
...

LU61
Use this value to create batch update utility control cards for LU 6.1 (ISC) device, LUNAME, and user ID table entries.
====================================
Topic: Troubleshooting > Runtime messages (IZT)

The following message has been added:


IZT3122E INVALID VALUE SPECIFIED FOR "LU DEFINITION REQUIRED"

Explanation: You have specified an invalid value for 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


Update 1
Date of change: May 2017

Change description: Documentation changes by APAR PI71728.
Topics: Chapter 6 - Customizing options
Setting LUNAME-specific options
Setting LUNAME options for the SLU2/3270 device
Setting options for the SLU2/3270 device
Addition of LOGON PROCESS option #5
5 – RACF USERID

Chapter 5. Choosing IMS ETO Support options
Logon and signon options
Logon process options
RACF USERID

Chap 10 ZN - LUNAME record control statements
LOGON=USRACF

RACF USERID
Use this option to perform an automatic RACF signon using the user ID
specified in option 4 USERID.
You must enter the TSO user ID value in the entry field for option 4 (USERID).
An online or batch refresh is required after the change is made to activate the
change dynamically.
Note: IMS ETO Support first matches the LUNAME at the signon with a
specific LUNAME in the "LUNAME OPTIONS for SLU2/3270" table before it
attempts to match any wild card.
Restriction: If users are enabled to signon to IMS multiple times (from
multiple terminals) with the same userid, it is best practice to use IMS ETO Support
logon and naming options that do not create naming collision errors. For example,
when using USERID or RACF USERID for the logon process, do not use IMS
DEFAULT as the LTERM/USER NAMING OPTION. Instead, use
NODE=LTERM=USER as the LTERM/USER NAMING OPTION.

ZN - LUNAME record control statements
LOGON=USRACF (to use auto signon and RACF with a user ID
specified with the USERID= option)
An online or batch refresh is required after the change is made to
activate the change dynamically.
Example:
ZN SI3TCP30 LOGON=USRACF USERID=userid
Note: IMS ETO Support first matches the LUNAME at the signon with a
specific LUNAME in the "LUNAME OPTIONS for SLU2/3270" table
before it attempts to match any wild card.

====================================
Change description: Documentation changes.
Topics: Update to Chapter 6 - Customizing options
(updated panel) Miscellaneous Menu
(new topic) Specifying return codes for transactions using BSEX user exit
(new topic) Specifying return codes for PSBs using BSEX user exit

Miscellaneous Menu


Specifying return codes for transactions using BSEX user exit
Use this panel to specify return code values for IMS transactions using the Build
Security Environment user exit (BSEX).

You can use the Build Security Environment user exit (BSEX) to tell IMS whether
to build the RACF or equivalent security environment in an IMS dependent region
for an application that has not received its input message from OTMA or from an
LU 6.2 device.

You can also use this user exit to request that IMS bypass some part of the security
processing in the dependent region when one of the following events occurs for a
message that did not originate from an OTMA or LU6.2 device:
- CHNG call.
- AUTH call.
- Deferred conversational program switch on the local system (when the system
where the inputting terminal is active).

Security authorization for the deferred conversational program switch occurs
only on the local system.

The following panel is displayed when you choose option 6 from the
Miscellaneous Menu.


This panel displays return codes for IMS transactions, if any exist.

To add a new transaction and return code specification, type A on the command
line and press Enter.

To update a listed entry, tab to the desired entry, type S or E next to the name, and
press Enter.

For valid return code values, refer to the Transaction Manager exit routines
information (Build Security Environment user exit (BSEX)) in the IMS Reference
Information section of the IMS user documentation.

Note: If the name you want does not appear in the list, you can press PF8 or type
F on the command line and press Enter to view the next screen of entry names.
You can also type the first few characters or the entire name on the START
command line to scroll through the list.

Specifying return codes for PSBs using BSEX user exit
Use this panel to specify return code values for PSBs using the Build Security
Environment user exit (BSEX).

You can use the Build Security Environment user exit (BSEX) to tell IMS whether
to build the RACF or equivalent security environment in an IMS dependent region
for an application that has not received its input message from OTMA or from an
LU 6.2 device.

You can also use this user exit to request that IMS bypass some part of the security
processing in the dependent region when one of the following events occurs for a
message that did not originate from an OTMA or LU6.2 device:
- CHNG call.
- AUTH call.
- Deferred conversational program switch on the local system (when the system
where the inputting terminal is active).
Security authorization for the deferred conversational program switch occurs
only on the local system.

The following panel is displayed when you choose option 7 from the
Miscellaneous Menu.


This panel displays return codes for PSBs, if any exist.

To add a new PSB and return code specification, type A on the command line and
press Enter.

To update a listed entry, tab to the desired entry, type S or E next to the name, and
press Enter.

For valid return code values, refer to the Transaction Manager exit routines
information (Build Security Environment user exit (BSEX)) in the IMS Reference
Information section of the IMS user documentation.

Note: If the name you want does not appear in the list, you can press PF8 or type
F on the command line and press Enter to view the next screen of entry names.
You can also type the first few characters or the entire name on the START
command line to scroll through the list.

====================================
Change description: Documentation changes from PMR50702
Topics: Options obsolete as of IMS V13
Chapter 9. Reloading IMS exits

Options obsolete as of IMS V13
Options B - DFSYPRX0 and D - DFSNDMX0 are obsolete as of IMS version 13.
If you are using IMS version 13, you can load the DFSYPRX0 and DFSNDMX0
user exits by specifying them in the USER_EXITS section of the IMS DFSDFxxx
member. This member belongs to the IMS PROCLIB data set.
The exit type to be specified is OTMAYPRX (OTMA Destination Resolution user
exit).
The name of the exit for IMS V13 is IZTYPRXD. The naming convention for the
exit uses the position of the name to designate IMS version compatibility (for
example, D for V13, E for V14).
The USER_EXITS section of the DFSDFxxx member specifies the user exits to be
called. The section must begin with the header <SECTION=USER_EXITS>. Refer to the
following IMS V13 documentation:
USER_EXITS section of the DFSDFxxx member

Publication Number

SC19-3982-02

[{"Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSAVHW","label":"IMS Extended Terminal Option Support for z\/OS"},"ARM Category":[{"code":"a8m0z0000000CgKAAU","label":"IMS Extended Terminal Option Support for z\/OS"}],"Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"3.2.0"}]

Document Information

Modified date:
24 May 2021

UID

swg27049936