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 |
rsed.envvars updates for SCLM Developer Toolkit 3
REXEC port style='color:windowtext;display:none;t 5
Rational Application Developer for WebSphere Software Build Utility. 6
SCLM Developer Toolkit sample members. 7
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) APAR OA24882 (enhance TSO/ISPF Client Gateway support) |
"Appendix A, Security considerations" on page 21 of the Host Configuration Quick Start should also list the following connection security information.
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.
"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.
"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
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 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.
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:
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.
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
"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.
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.
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.
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.
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