IBMR RationalR Developer for System zTM - Host Configuration Release Notes

 

The following annotations must be made to the host configuration documentation. Abbreviated names are used for these publications for easy reference. Use the following table to match an abbreviated name to a publication:

 

Publication title

Order number

Abbreviation

Program Directory for IBMR RationalR Developer for System zTM

GI11-8298

Program Directory

Rational Developer for System z Prerequisites

SC23-7659

Prerequisite Guide

Rational Developer for System z Host Planning Guide

GI11-8296

Host Planning Guide

Rational Developer for System z Host Configuration Quick Start

GI11-9201

Host Configuration Quick Start

Rational Developer for System z Host Configuration Guide

SC23-7658

Host Configuration Guide

SCLM Developer Toolkit Administrator's Guide

SC23-9801

SCLMDT Administrator's Guide

 

 

Additional prerequisites. 1

Security considerations. 2

Migration considerations. 2

Requisite resources. 3

Symbolic links. 3

rsed.envvars updates for SCLM Developer Toolkit 3

Install and customize Ant 3

File Manager integration. 4

REXEC port style='color:windowtext;display:none;t 5

Client checklist 5

Operator commands. 5

Setting up SSL. 6

Rational Application Developer for WebSphere Software Build Utility. 6

SCLM Developer Toolkit sample members. 7

 

Additional prerequisites

The prerequisites for ISPF on page 5 of the Prerequisite Guide and on page 9 of the Host Planning Guide should be updated to show the following table

 

Program Number

Product Name

PTFs or Service Levels Required

5694-A01

ISPF (z/OSR v 1.10)

APAR OA24881 (enhance TSO/ISPF Client Gateway support)

5694-A01

ISPF (z/OS v 1.9)

APAR OA24403 (add TSO/ISPF Client Gateway support)

APAR OA24882 (enhance TSO/ISPF Client Gateway support)

5694-A01

ISPF (z/OS v 1.8)

APAR OA20345 (nested command output and enhance BUILD)
  PTF UA33575
APAR OA20449 (add NESTMACS support)
  PTF UA34052
APAR OA24403 (add TSO/ISPF Client Gateway support)

APAR OA24882 (enhance TSO/ISPF Client Gateway support)

 

Security considerations

"Appendix A, Security considerations" on page 21 of the Host Configuration Quick Start should also list the following connection security information.

Connection security

Different levels of communication security are supported by the Remote Systems Explorer (RSE) server. The RSE server controls all communication between the client and Developer for System z services.

 

Migration considerations

"Appendix B, Migration considerations" on page 25 of the Host Configuration Quick Start and "Migration considerations" on page 1 and "Migrate from version 7.1 to version 7.5" on page 143 of the Host Configuration Guide should include the following migration notes.

 

 

Requisite resources

"Table 1. Required resources" and "Table 2. Optional resources" on page 3 of the Host Configuration Guide have faulty links in the Information column for some of the items. The correct links are documented below.

 

Table 1. Required resources

Resource: port for client-host communication

Information: "PROCLIB changes" on page 13

 

Table 2. Optional resources

Resource: LINKLIST data set

Information: "Chapter 5. (Optional) SCLM Developer Toolkit" on page 43

 

Symbolic links

A sample command in "Customization setup" on page 9 of the Host Configuration Guide is formatted incorrectly. The correct formatting of the commands in Note 2 should be:

 

 

rsed.envvars updates for SCLM Developer Toolkit

"rsed.envvars updates for SCLMDT" on page 45 of the Host Configuration Guide erroneously lists rsed.envvars directives to support older SCLMDT clients. No changes must be made to rsed.envvars to support these older clients.

 

Install and customize Ant

The location of the ASCII to EBCDIC conversion script, BWBTRANT, has changed, resulting in an update to the instructions in "(Optional) Install and customize Ant" on page 46 of the Host Configuration Guide.

Follow the steps below to implement Ant on z/OSR, and to define it to Developer for System z:

Note: Execute this script only once. Multiple runs will corrupt your Ant install.

- JAVA_HOME is required to point to the java home directory, for example:

JAVA_HOME=/usr/lpp/java/IBM/J5.0

- ANT_HOME is required to point to the Ant home directory, for example:

ANT_HOME=/usr/lpp/Ant/apache-ant-1.7.1

For example:

 

File Manager integration

A note in "(Optional) File Manager integration" on page 56 of the Host Configuration Guide mentions that the FMI will fall back to using the batch interface if the connection with the FM listener fails. This is incorrect. The client will receive an error message upon connection failure and the requested action is aborted.

 

REXEC port

The sample file contents in "REXEC (or SSH) set up" on page 59 of the Host Configuration Guide is formatted incorrectly. The correct formatting of this section should be the following.

 

A common port used by REXEC is 512. To verify this, you can check /etc/inetd.conf and /etc/services to find the port number used.

exec     stream tcp nowait OMVSKERN /usr/sbin/orexecd rexecd -LV

exec            512/tcp            #REXEC    Command Server

 

Client checklist

"Table 14. Client checklist - optional parts" on page 77 of the Host Configuration Guide has faulty information links for some of the items. The correct links are documented below.

 

 

Operator commands

Some wire diagrams describing the operator commands in "Appendix B. Operator commands" on page 79 and page 80 of the Host Configuration Guide are formatted incorrectly. The correct formatting should be the following.

 

RSE daemon

RSE Daemon connand structure

RSE daemon

RSE Daemon connand structure

 

Setting up SSL

The RSE daemon log location mentioned at the end of "Appendix J. Setting up SSL" on page 164 of the Host Configuration Guide is incorrect. The paragraph should say the following.

 

If SSL communication fails, the client will return an error message. More information is available in the different server and user log files, as described in "RSE daemon logging" on page 86 and "RSE user logging" on page 86.

 

Rational Application Developer for WebSphereR Software Build Utility

The "Rational Application Developer for WebSphereR Software Build Utility" is erroneously referenced in the SCLMDT Administrator's Guide as AST. All these references are located in "Appendix D. AST build process" on pages 89 to 111.

 

The first paragraph of "AST installation notes" on page 90 of the SCLMDT Administrator's Guide has incorrect installation instruction for the Build Utility, and should say the following.

 

Rational Application Developer for WebSphere Software Build Utility is delivered as part of Rational Application Developer (RAD). RAD must be ordered, installed and configured separately. The installation and customization of this product is not described in this manual.

Refer to the documentation delivered with RAD for installation and customization instructions for the Build Utility function.

 

SCLM Developer Toolkit sample members

The following list of FEK.SFEKSAMV sample members are not documented in the Host Configuration Guide or the SCLMDT Administrator Guide.

 

-         BWBC9DTJ    Cloud 9 to SCLM DT conversion sample.

-         BWBDEPJ1     Sample to update SQLJ .ser files within a JAR at deployment time using db2sqljcustomize.

-         BWBDEPJ2     Sample for db2sqljcustomize where the property longname will copy the specified JAR from the indicated group and type locations in SCLM to the destination directory specified by 'dest'.

-         BWBDEPJ3     This sample routine will customize the .ser files contained within selected JAR files for deployment using db2sqljcustomize.

-         BWBTRANX  Sample SCLM build translator for SYSXML build error messaging for COBOL.

The following list of /usr/lpp/rdz/samples sample members are not documented in the Host Configuration Guide or the SCLMDT Administrator Guide.

 

-         bwbsqld.rex     Sample ANT XML SQLJ JAVA build script