Connecting AF/Operator and AF/Remote Using TCP/IP

60 Pages·2002·0.53 MB·English

Connecting AF/OPERATOR and
AF/REMOTE Using TCP/IP
®
AF/OPERATOR V340
®
AF/REMOTE on Windows NT V100
GC32-9146-00
September 2002

Candle Corporation
201 North Douglas Street
El Segundo, California 90245
Registered trademarks and service marks of Candle Corporation: AF/OPERATOR, AF/PERFORMER, AF/REMOTE, Availability Command Center,
Candle, Candle Command Center, Candle Direct logo, Candle Electronic Customer Support, Candle logo, Candle Management Server, Candle Management
Workstation, CandleNet Portal, Candle Technologies, CL/CONFERENCE, CL/SUPERSESSION, CommandWatch, CandleNet Command Center, CT, CT/Data
Server, CT/DS, DELTAMON, eBA, eBA*ServiceMonitor, eBA*ServiceNetwork, eBusiness Assurance, eBusiness Institute, ETEWatch, IntelliWatch, IntelliWatch
Pinnacle, MQSecure, MQView, OMEGACENTER, OMEGAMON, OMEGAMON/e, OMEGAMONII, OMEGAMON Monitoring Agent, OMEGAVIEW,
OMEGAVIEWII, PQEdit, Solutions for Networked Applications, Solutions for Networked Businesses, and Transplex.
Trademarks and service marks of Candle Corporation: Alert Adapter, Alert Adapter Plus, Alert Emitter, AMS, Amsys, AutoBridge, AUTOMATED
FACILITIES, Availability Management Systems, Candle Alert, Candle Business Partner Logo, Candle Command Center/SentinelManager, Candle
CommandPro, Candle CIRCUIT, Candle eDelivery, CandleLight, CandleNet, CandleNet 2000, CandleNet eBP, CandleNet eBP Access, CandleNet eBP
Administrator, CandleNet eBP Broker Access, CandleNet eBP Configuration, CandleNet eBP Connector, CandleNet eBP File Transfer, CandleNet eBP Host
Connect, CandleNet eBP Object Access, CandleNet eBP Object Browser, CandleNet eBP Secure Access, CandleNet eBP Service Directory, CandleNet eBP
Universal Connector, CandleNet eBP Workflow Access, CandleNet eBusiness Assurance, CandleNet eBusiness Exchange, CandleNet eBusiness Platform,
CandleNet eBusiness Platform Administrator, CandleNet eBusiness Platform Connector, CandleNet eBusiness Platform Connectors, CandleNet eBusiness
Platform Powered by Roma Technology, CandleNet eBusiness Platform Service Directory, CCC, CCP, CEBA, CECS, CICAT, CL/ENGINE, CL/GATEWAY,
CL/TECHNOLOGY, CMS, CMW, Command & Control, Connect-Notes, Connect-Two, CSA ANALYZER, CT/ALS, CT/Application Logic Services, CT/DCS,
CT/Distributed Computing Services, CT/Engine, CT/Implementation Services, CT/IX, CT/Workbench, CT/Workstation Server, CT/WS, !DB Logo, !DB/DASD,
!DB/EXPLAIN, !DB/MIGRATOR, !DB/QUICKCHANGE, !DB/QUICKCOMPARE, !DB/SMU, !DB/Tools, !DB/WORKBENCH, Design Network, DEXAN, e2e,
eBAA, eBAAuditor, eBAN, eBANetwork, eBAAPractice, eBP, eBusiness Assurance Network, eBusiness at the speed of light, eBusiness at the speed of light logo,
eBusiness Exchange, eBusiness Institute, eBX, End-to-End, ENTERPRISE, Enterprise Candle Command Center, Enterprise Candle Management Workstation,
Enterprise Reporter Plus, EPILOG, ER+, ERPNet, ESRA, ETEWatch Customizer, HostBridge, InterFlow, Candle InterFlow, Lava Console, MessageMate,
Messaging Mastered, Millennium Management Blueprint, MMNA, MQADMIN, MQEdit, MQEXPERT, MQMON, NBX, NetGlue, NetGlue Extra, NetMirror,
NetScheduler, OMA, OMC Gateway, OMC Status Manager, OMEGACENTER Bridge, OMEGACENTER Gateway, OMEGACENTER Status Manager,
OMEGAMON Management Center, OSM, PC COMPANION, Performance Pac, PowerQ, PQConfiguration, PQScope, Response Time Network, Roma, Roma
Application Manager, Roma Broker, Roma BSP, Roma Connector, Roma Developer, Roma FS/A, Roma FS/Access, RomaNet, Roma Network, Roma Object
Access, Roma Secure, Roma WF/Access, Roma Workflow Access, RTA, RTN, SentinelManager, Somerset, Somerset Systems, Status Monitor, The Millennium
Alliance, The Millennium Alliance logo, The Millennium Management Network Alliance, TMA2000, Tracer, Unified Directory Services, Volcano and ZCopy.
Trademarks and registered trademarks of other companies: AIX, DB2, MQSeries and WebSphere are registered trademarks of International Business
Machines Corporation. SAP is a registered trademark and R/3 is a trademark of SAP AG. UNIX is a registered trademark in the U.S. and other countries,
licensed exclusively through X/Open Company Ltd. HP-UX is a trademark of Hewlett-Packard Company. SunOS is a trademark of Sun Microsystems, Inc. All
other company and product names used herein are trademarks or registered trademarks of their respective companies.
Copyright © August 2002, Candle Corporation, a California corporation. All rights reserved. International rights secured.
Threaded Environment for AS/400, Patent No. 5,504,898; Data Server with Data Probes Employing Predicate Tests in Rule Statements (Event Driven
Sampling), Patent No. 5,615,359; MVS/ESA Message Transport System Using the XCF Coupling Facility, Patent No. 5,754,856; Intelligent Remote Agent for
Computer Performance Monitoring, Patent No. 5,781,703; Data Server with Event Driven Sampling, Patent No. 5,809,238; Threaded Environment for
Computer Systems Without Native Threading Support, Patent No. 5,835,763; Object Procedure Messaging Facility, Patent No. 5,848,234; End-to-End
Response Time Measurement for Computer Programs, Patent No. 5,991,705; Communications on a Network, Patent Pending; Improved Message Queuing
Based Network Computing Architecture, Patent Pending; User Interface for System Management Applications, Patent Pending.
NOTICE: This documentation is provided with RESTRICTED RIGHTS. Use, duplication, or disclosure by the Government is subject to restrictions set forth in
the applicable license agreement and/or the applicable government rights clause.
This documentation contains confidential, proprietary information of Candle Corporation that is licensed for your internal use only. Any unauthorized use,

duplication, or disclosure is unlawful.
2 Connecting AF/OPERATOR and AF/REMOTE Using TCP/IP
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5
Documentation Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
Documentation Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
Other Books You May Want to Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
What’s New in AF/OPERATOR Version 340. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
Chapter 1. Common Causes of Connectivity Problems . . . . . . . . . . . . . . . . . . . . . . . . . . .15
What Problems Can Occur and What Can Be Done About Them. . . . . . . . . . . . . . . . .16
Identifying the Players. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
Chapter 2. Performing AF/OPERATOR Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
AF/OPERATOR Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
Example Host REXX EXEC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
Chapter 3. Performing AF/REMOTE Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
AF/REMOTE Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26
Sample AF/REMOTE REXX Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30
Chapter 4. Process Diagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
Communications Start. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
Link Define. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33
Link Start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
Communic ations Send/Receive. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
Chapter 5. Testing and Debugging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
Diagnosing Problems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38
Appendix A. AF Products TCP/IP Checklist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
Appendix B. Output of the Sample EXECs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45
Appendix C. Guide to Candle Customer Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49
Base Maintenance Plan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50
Enhanced Support Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54
Customer Support Contact Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59
Contents 3
4 Connecting AF/OPERATOR and AF/REMOTE Using TCP/IP
Preface
P
About this document
Experience has shown that many customers encounter problems when
moving to TCP/IP for their peer-to-peer communications between
AF/OPERATOR and AF/REMOTE. Many of these problems are resolved as
configuration or environmental issues rather than coding or documentation
problems in the AF products. In this manual, we will identify some of the
common configuration and environmental issues and provide guidance in
resolving them.
This manual provides the details necessary to assist you in connecting
AF/OPERATOR and AF/REMOTE using TCP/IP. It contains a description of
some common problems you may encounter when attempting to define the
connection, and provides the steps required to implement the connection.
The manual provides a checklist you can use to ensure you are implementing
the connection correctly, as well as examples you can review and copy.
The manual includes scripts for connecting AF/OPERATOR to AF/REMOTE,
sending a message to execute a script, and retrieving a response. Appendix B,
“Output of the Sample EXECs” on page 45, includes the sample output from
both A F/OPERATOR and AF/REMOTE for the sample scripts’ execution.
Preface 5
Documentation Conventions
Documentation Conventions
Introduction
Candle documentation adheres to accepted typographical conventions for
command syntax. Conventions specific to Candle documentation are
discussed in the following sections.
Panels and figures
The panels and figures in this document are representations. Actual product
panels may differ.
Required blanks
The slashed-b (b) character in examples represents a required blank. The
following example illustrates the location of two required blanks.
beBA*ServiceMonitorb0990221161551000
Revision bars
Revision bars (|) may appear in the left margin to identify new or updated
material.
Variables and literals
In examples of command syntax, uppercase letters are actual values (literals)
that the user should type; lowercase letters are used for variables that
represent data supplied by the user. Default values are underscored.
LO GON APPLID (cccccccc)
In the above example, you type LOGON APPLID followed by an application
identifier (represented by cccccccc) within parentheses.
Note: In ordinary text, variable names appear in italics.
6 Connecting AF/OPERATOR and AF/REMOTE Using TCP/IP
Documentation Conventions
Symbols
The following symbols may appear in command syntax:
Table 1. Symbols in Command Syntax
Symbol Usage
| The “or” symbol is used to denote a choice. Either the argument
on the left or the argument on the right may be used. Example:
YES | NO
In this example, YES or NO may be specified.
[ ] Denotes optional arguments. Those arguments not enclosed in
square brackets are required. Example:
APPLDEST DEST [ALTDEST]
In this example, DEST is a required argument and ALTDEST is
optional.
{ } Some documents use braces to denote required arguments, or to
group arguments for clarity. Example:
COMPARE {workload} -
REPORT={SUMMARY | HISTOGRAM}
The workload variable is required. The REPORT keyword must be
specified with a value of SUMMARY or HISTOGRAM.
_ Default values are underscored. Example:
COPY infile outfile - [COMPRESS={YES | NO}]
In this example, the COMPRESS keyword is optional. If specified,
the only valid values are YES or NO. If omitted, the default is YES.

Preface 7
Documentation Set
Documentation Set
Introduction
Candle provides a complete set of documentation for AF/OPERATOR and
AF/REMOTE. Each manual in these documentation sets contains a specific
type of information to help you use the products.
AF/OPERATOR Library
These books comprise Candle’s AF/OPERATOR Version 340 library:
n AF/OPERATOR Configuration and Customization Guide
n AF/OPERATOR User’s Guide
n AF/OPERATOR Command Reference Manual
n AF/OPERATOR User Interface Guide
n AF/OPERATOR OMEGAMON II for SMS Data Interface
n AF/OPERATOR Message Manager
n AF/OPERATOR Started Task Manager
n AF/OPERATOR: Using the Subsystem Logging Facility
n Connecting AF/OPERATOR and AF/REMOTE Using TCP/IP
n Candle Product Messages Manual
AF/REMOTE on Windows NT Library
n AF/REMOTE on Windows NT V100 User’s Guide

8 Connecting AF/OPERATOR and AF/REMOTE Using TCP/IP
Other Books You May Want to Reference
Other Books You May Want to Reference
IBM documentation
OS/390 IBM Communications Server IP User’s Guide Version 2 Release 10,
IBM Document Number GC31-8514
IBM Communications Server for OS/390 IP Configuration Guide Version 2
Release 10, IBM document number SC31-8725
Other documentation
DNS and BIND, Paul Albitz and Cricket Liu, O’Reilly and Associates.
TCP/IP Network Administration, Craig Hunt, O’Reilly and Associates

Preface 9
Other Books You May Want to Reference

10 Connecting AF/OPERATOR and AF/REMOTE Using TCP/IP