Enabling the z/OS User Authentication feature for IBM AD Build Client

• For the IBM AD V6.0.1 release, only a standard of 8 character mixed case password is supported. Password phrases are not supported.
• The username and password are volatile and they are kept in the memory for the running instances of IBM AD Build Client and IBM AD Build Configuration.
• If you close IBM AD Build Client and later you want to perform any mainframe-related operation it will be necessary to reenter the username and password. Closing the application is considered a reset process for the z/OS credentials. It shall be used in case of wrong or modification of the z/OS credentials.
• In case that a project has multiple z/OS mainframe instances available, the username and password is requested for each of the z/OS mainframe instance that is used in the related-mainframe operation and only once per IBM AD Build Client instance.
  Note: If other projects have the same z/OS mainframe instance attached and the z/OS mainframe instance was already prompted in a project, it will not be subsequently prompted for other projects that are on the same z/OS mainframe instance.
• If a mainframe-related operation is started on a selection of multiple z/OS mainframe instances and if you cancel entering the username and password for one of the z/OS mainframe instances, the whole operation will be aborted.

1. Go to <IBM ADDI Installation Folder>\IBM Application Discovery Build Client\Bin\Release\Samples and copy the zOS-Data.ini configuration file in the <IBM ADDI Installation Folder>\IBM Application Discovery Build Client\Bin\Release folder.
2. Open the zOS-Data.ini configuration file by using a text editor and enter the desired values for the parameters that are detailed below. By default, the zOS-Data.ini configuration file has the following format:

   [MVS1]
   use_cred=Y/N
   
   [MVS2]
   use_cred=Y/N

   Where:

   • [MVS1] and [MVS2] are the names of the z/OS mainframe instances that are present in IBM Application Discovery Build Configuration > zOS Tab.
     Important: The square brackets need to be preserved and between them, the actual name of the z/OS mainframe instance needs to be added with no spaces nor tabs between the brackets.
   • use_cred is an attribute that expects the Y or N values. This attribute decides whether the mentioned z/OS mainframe instance is prompted for the username and password or not.
     Note: The attribute value is not case-sensitive.
   Important: In case that a z/OS mainframe instance is not present in the configuration file, or it is present but the attribute value is set to N, for the related z/OS mainframe instance, the Please enter the zOS User/Password in order to acces the zOS Access Point message will not be prompted when performing mainframe-related operations in IBM AD Build Client.
3. Save and close the zOS-Data.ini configuration file.

[zOS_A]
use_cred=Y

[zOS_C]
use_cred=y

[zOS_D]
use_cred=N

• zOS_A, zOS_B, zOS_C and zOS_D are the names of the z/OS mainframe instances.
• The feature is available only for zOS_A and zOS_C.

1. Add Files from Mainframe

   1. In IBM® Application Discovery Build Client, open an already existing project, right-click on a virtual folder, and select Add Files from Mainframe.
   2. The Please enter the zOS User/Password in order to acces the zOS Access Point message is prompted when performing the Add Files from Mainframe operation.
   3. Enter the username and password for the related z/OS mainframe instance. For more information, see z/OS Username and Password Guidelines.
   4. Perform all the necessary actions related to the Add Files from Mainframe operation. For more information, see Adding Files From Mainframe Library.
2. Update Modified Mainframe Members

   Note: The Synchronize Mainframe Members feature must not be activated to have the Update Modified Mainframe Members option available. For more information, see Synchronizing Mainframe Members.
   1. In IBM® Application Discovery Build Client, open an already existing project, right-click on a virtual folder, and select Update Modified Mainframe Members.
   2. The Please enter the zOS User/Password in order to acces the zOS Access Point message is prompted when performing the Update Modified Mainframe Members operation.
   3. Enter the username and password for the related z/OS mainframe instance. For more information, see z/OS Username and Password Guidelines.
   4. Perform all the necessary actions related to the Update Modified Mainframe Members operation. For more information, see Updating Projects.
3. Synchronize members

   Note: The Synchronize Mainframe Members feature must be activated to have the Synchronize members option available. For more information, see Synchronizing Mainframe Members.
   1. In IBM® Application Discovery Build Client, open an already existing project, right-click on the project, and select Synchronize members.
   2. The Please enter the zOS User/Password in order to acces the zOS Access Point message is prompted when performing the Synchronize members operation.
   3. Enter the username and password for the related z/OS mainframe instance. For more information, see z/OS Username and Password Guidelines.
   4. Perform all the necessary actions related to the Synchronize members operation. For more information, see Synchronizing Mainframe Members.