IBM IBM Sterling Connect:Direct for Windows 4.8 ii IBM Sterling Connect:Direct for Windows 4.8 Contents Chapter 1. Connect:Direct for Microsoft Customize Sterling Connect:Direct for Microsoft Windows Release Notes........ 1 Windows Configuration Information ..... 38 Requirements .............. 1 Run a Silent Installation ......... 38 Features and Enhancements ......... 3 Perform an Unattended Uninstallation .... 39 Special Considerations ........... 4 Known Restrictions ............ 4 Chapter 3. System Guide ....... 41 Restrictions for Connect:Direct for Microsoft Configure the Local Node ......... 41 Windows .............. 4 Configuring the Sterling Connect:Direct Local Restrictions for Related Software....... 6 Node ............... 41 Installation Notes ............. 7 Adding or Modifying a Local Node Definition . 41 Installation Notes for Sterling Connect:Direct Adding a User ............ 42 Requester .............. 7 Modifying a User ID .......... 42 Installation Notes for Connect:Direct File Agent . 7 Deleting a User ............ 43 Sterling Connect:Direct Secure Plus for Microsoft Attaching to a Local Node ........ 43 Windows .............. 8 About Local Functional Authorities ..... 43 Upgrading Guidelines ........... 8 Define Remote User Proxies ........ 50 Upgrading Guidelines for Connect:Direct for Creating or Modifying a Remote User Proxy .. 51 Microsoft Windows ........... 8 Deleting a Remote User Proxy ....... 52 Upgrading Guidelines for Related Software ... 9 Define and Manage the Sterling Connect:Direct Network ............... 52 Chapter 2. Getting Started Guide ... 11 Define and Manage the Sterling Connect:Direct Prepare for the Installation of IBM Sterling Network .............. 52 Connect:Direct for Microsoft Windows ..... 11 About Defining the Network Map ...... 53 Requirements for Copying Files To and From Define Remote Node Information ...... 53 Network Servers............ 11 Creating or Modifying a Remote Node Definition 54 Configure Microsoft Windows User Privileges .. 11 Creating or Modifying a Communications Path Customize a Sterling Connect:Direct Logon Definition .............. 60 Account .............. 12 Defining a New Mode for a Communications Configure TCP/IP Connectivity ...... 13 Path ................ 62 Sterling Connect:Direct for Microsoft Windows Deleting a Network Map Entry ....... 64 Installation Worksheet .......... 13 Validating a Network Map Entry ...... 64 Install and Configure Database Software.... 14 Viewing a Network Map as Text ...... 64 Automate the Sterling Connect:Direct for Applying a Network Map ........ 64 Microsoft Windows Installation....... 15 Printing and Viewing Node and Network Map Sample Sterling Connect:Direct for z/OS Definitions.............. 65 Network Map Entries .......... 15 View the Sample Configuration Files ..... 65 XCA Token Ring: Switched Net Definitions ... 16 Customizing Configuration Files ...... 66 XCA Token Ring: Independent LU Definition .. 16 Adding an Encrypted Password for a User Proxy 66 XCA Token Ring: Major Node Definition ... 18 Validating Configuration Files for Use with Sample Sterling Connect:Direct APPLDEF ... 18 Sterling Connect:Direct ......... 67 Sample Sterling Connect:Direct MODEENTS Applying Updated Configuration Information .. 67 (Mode Definitions) ........... 18 Stop Sterling Connect:Direct for Microsoft Windows 68 Sample VTAM Start Options (ATCSTRxx) ... 19 Stopping Sterling Connect:Direct for Microsoft z/OS Network Map Example for VTAM.... 20 Windows .............. 68 Microsoft Windows Network Map Example .. 20 Stopping Connect:Direct for Microsoft Windows Installing in a Windows clustered environment .. 21 from Sterling Connect:Direct Requester .... 68 Install Sterling Connect:Direct for Microsoft Stopping Connect:Direct for Microsoft Windows Windows ............... 21 Using the Services Facility ........ 69 Installation Overview .......... 21 Stopping Connect:Direct for Microsoft Windows Automate Installation ........... 33 Using the CLI ............ 69 About Silent Installations ......... 33 Stopping Connect:Direct for Microsoft Windows Customize Initialization Information for a Silent from the Admin Tool Utility ........ 69 Installation ............. 34 Create a Process ............. 70 CD_SRVR.INI Parameter Values ...... 34 About Processes ............ 70 Establishing Preferences ......... 70 iii Creating a Process ........... 73 Configuring a Sterling Connect:Direct Sterling Commands and Statements ........ 74 Connect:Direct Server.......... 112 Process or Command Options ....... 80 Work with Active Directory........ 116 Setting Security Options ......... 80 Adding an Active Directory Entry ..... 116 Setting Control Functions for a Command or Deleting an Active Directory Entry ..... 116 Process ............... 81 Creating an Active Directory Report ..... 117 Assigning Values to Symbolic Variables .... 82 Troubleshoot Sterling Connect:Direct ..... 117 Specifying Accounting Data ........ 83 Diagnose a Server Problem Using Traces ... 117 Add Comments ............ 84 Defining a Trace ........... 117 Validating Process Content ........ 84 Stopping a Trace ........... 118 Saving a Process............ 85 Trace Startup Parameters ........ 119 Copying a Process ........... 85 Recover from a Problem ......... 121 Changing a Submitted Process ....... 85 Process Step Restart .......... 121 Manage Processes Using a Work List ..... 85 Automatic Session Retry......... 121 Manage Processes ............ 89 Checkpoint/Restart .......... 122 SMTP Notification ........... 89 Restart During Run Task Operations .... 122 Manage Processes ........... 89 Troubleshoot Sterling Connect:Direct Problems 123 Understanding the TCQ ......... 90 Worksheets .............. 123 TCQ Logical Queues .......... 90 Network Map Communications Mode Object View Processes in the TCQ ........ 93 Worksheet ............. 123 Creating a Process Monitor ........ 93 Network Map Communications Path Object Monitoring Processes Based on Selection Criteria 93 Worksheet ............. 124 Opening a Process Monitor File ...... 95 Network Map Remote Node Object Worksheet 125 Saving a Process Monitor ......... 95 User Functional Authorization Worksheet ... 126 The Process Monitor Output........ 95 Remote User Proxy Worksheet....... 127 Using the Output Display ........ 97 Change Sterling Connect:Direct Settings .... 128 Notification ............. 97 Change Sterling Connect:Direct for Microsoft NT Broadcast ............. 97 Windows Settings ........... 128 Changing Process Notification ....... 98 Sample Initialization Parameters Format ... 129 View Process Statistics .......... 98 Changing Initialization Parameters ..... 131 The Statistics Monitor Window ....... 99 Specify an IP Address .......... 145 Delete Statistics Records ......... 100 Specify IP Addresses, Host Names, and Ports 145 Control Statistics File Content ....... 100 Submit a Process Using the Command Line Creating a Statistics Report ........ 100 Interface ............... 148 Selecting Statistics Based on Process Name or Submit Processes Using the CLI Command .. 148 Number .............. 101 Creating a Configuration File to Connect to a Statistics Report Output ......... 103 Server ............... 149 Understand the Microsoft Windows Event Invoke the CLI ............ 149 Logging Facility ........... 104 Terminating the CLI .......... 150 Control Event Log Content ........ 105 CLI Commands ........... 150 Filter the Event Log .......... 105 Command Syntax ........... 151 Viewing Messages ........... 106 Piping Conventions .......... 151 Send Messages to an SNMP Management Submit Process Command ........ 152 System .............. 106 Change Process Command ........ 156 Identify the Trap Variables ........ 107 Delete Process Command ........ 157 Initialization Events .......... 108 Select Process Command ........ 159 Shutdown Events ........... 108 Select Message Command ........ 162 API Events ............. 108 Select Statistics Command ........ 162 Execution Events ........... 109 Traceoff Command .......... 171 Miscellaneous Events .......... 109 Traceon Command .......... 172 Use the Activity Log .......... 110 Help Command ........... 174 Opening an Activity Log ........ 110 Stop Sterling Connect:Direct ....... 175 Saving an Activity Log ......... 110 Modify Translation Tables ......... 176 Type Events ............. 110 Translation Tables ........... 176 Manage a Sterling Connect:Direct Server .... 111 Modify a Translation Table Using Sterling Manage a Sterling Connect:Direct Server ... 111 Connect:Direct Requester ........ 176 Starting the Admin Tool Utility ...... 111 Edit Connection Settings ......... 177 About the Toolbar ........... 111 About the Client Connection Utility ..... 177 Starting and Stopping a Sterling Connect:Direct Start the Client Connection Utility ..... 177 Server ............... 111 Add a Node............. 178 Deleting a Node ........... 178 iv IBM Sterling Connect:Direct for Windows 4.8 Adding a User with Client Connection Utility 178 Configure Sterling Connect:Direct Secure Plus Deleting a User with the Client Connection Remote Node Record.......... 217 Utility ............... 179 Validate the Configuration ........ 220 Updating a Node or User ........ 179 Enable or Disable External Authentication for a Defining a Default Node or User ...... 180 Remote Node ............ 220 Importing Registry Settings........ 180 Configure External Authentication in the Exporting Registry Settings........ 180 .SEAServer Record .......... 221 Printing Registry Settings ........ 181 Automate Setup Using