OpenTP1 Version 7

Tester and UAP Trace User's Guide

3000-3-D57-20(E)


Contents

Notices
Summary of amendments
Preface

Part 1: Overview of Testers and UAP Traces

1. Overview
1.1 Testers and UAP traces
1.2 Overview of testers
1.2.1 Online testers
1.2.2 Offline tester (TP1/Offline Tester)
1.3 Overview of UAP traces

Part 2: Online Tester (TP1/Online Tester)

2. Facilities
2.1 Facilities of the online tester
2.2 Simulating a client UAP
2.2.1 Simulating a client UAP with an RPC interface
2.2.2 Simulating a client UAP with an XATMI interface
2.3 Simulating a server UAP
2.3.1 Simulating a server UAP with an RPC interface
2.3.2 Simulating a server UAP with an XATMI interface
2.4 Simulating the MCF
2.4.1 MCF simulation functions
2.4.2 Simulating message send/receive
2.4.3 Simulating continuous inquiry responses
2.4.4 Simulating application program startup requests
2.4.5 Simulating synchronous point processing
2.5 Disabling resource updating
2.6 Simulating operating commands
2.7 Creating and outputting tester files
2.7.1 Creating tester files
2.7.2 Editing and outputting tester files
2.8 Collecting test information
2.8.1 Collecting UAP trace information
2.8.2 Merging, editing, and outputting UAP trace information
2.8.3 Editing send messages
2.9 Interlocking the debugger

3. Setting the Test Environment
3.1 System definitions for the online tester
3.1.1 System service configuration definition
3.1.2 Tester service definition
3.1.3 Tester service definition (command format)
3.1.4 User service definition
3.1.5 Setting the typed buffer
3.1.6 Setting send/receive procedures
3.2 Setting environment variables
3.3 User-created files
3.3.1 Service request data files
3.3.2 Service response data files
3.3.3 XATMI receive data file
3.3.4 MCF receive message files
3.3.5 Operating command result data file
3.4 Creating files
3.4.1 Test directory
3.4.2 Test data definition file
3.4.3 Files created by the online tester

4. Test Execution
4.1 Creating UAPs
4.2 Service requests to an SPP
4.2.1 Client UAP simulator
4.2.2 Server UAP simulator
4.3 Service requests to an MHP
4.4 Creating tester files
4.4.1 Creating tester files using the test data definition file
4.4.2 Creating tester files using operating command output data
4.5 Editing test information
4.5.1 Displaying test status
4.5.2 Collecting UAP trace information
4.5.3 Merging and outputting UAP trace information
4.5.4 UAP traces for MCF simulation functions
4.5.5 Editing and outputting send messages
4.5.6 Checking UAP response data
4.5.7 Checking UAP send data

5. Operating Commands
5.1 Operating commands for running tests
5.1.1 utodbgstop (termination of a UAP interlocked with the debugger)
5.1.2 utodebug (activation of a UAP interlocked with the debugger)
5.1.3 utofilcre (tester file creation)
5.1.4 utofilout (edited output of the tester file content)
5.1.5 utols (test status display)
5.1.6 utomhpsvc (service requests to an MHP)
5.1.7 utomsgout (edited output of send messages)
5.1.8 utosppsvc (service requests to an RPC interface SPP)
5.1.9 utotrcmrg (merger of UAP trace information)
5.1.10 utotrcout (edited output of UAP trace information)
5.1.11 utoxsppsvc (service requests to an XATMI interface SPP)

6. Error Recovery
6.1 Handling online tester errors
6.1.1 Error conditions and causes
6.1.2 Online tester errors
6.1.3 File errors
6.1.4 UAP errors

Part 3: Online Tester (TP1/Message Control/Tester)

7. Facilities
7.1 MHP testing
7.1.1 Disabling updating of non-MCF resources
7.1.2 Invalidating send messages
7.1.3 Invalidating application startup messages
7.1.4 Suppressing error events
7.1.5 Suppressing MHP automatic shutdown
7.2 Collecting test information
7.2.1 Collecting UAP trace information

8. Test Execution
8.1 Starting and ending a test
8.1.1 Starting a test and setting the test environment
8.1.2 Ending a test
8.2 Duplicate test mode specifications
8.3 Inheriting test mode information
8.4 Editing test information
8.4.1 Displaying test mode information
8.4.2 Collecting UAP trace information
8.4.3 Merging and outputting UAP trace information

9. Operating Commands
9.1 Operating commands for running tests
9.1.1 mcfutfst (MCF online tester use declaration)
9.1.2 mcflsutf (display of MCF online tester status)
9.2 Operating commands for testing a logical terminal
9.2.1 mcftulsle (display of test mode information for a logical terminal)
9.2.2 mcftules (start of a logical terminal test)
9.2.3 mcftulee (termination of a logical terminal test)
9.3 Operating commands for testing an application
9.3.1 mcfaulsap (display of test mode information for an application)
9.3.2 mcfauaps (start of an application test)
9.3.3 mcfauape (termination of an application test)
9.4 Operating commands for testing a service group
9.4.1 mcftulssg (display of test mode information for a service group)
9.4.2 mcftusgs (start of a service group test)
9.4.3 mcftusge (termination of a service group test)

Part 4: Offline Tester

10. Facilities
10.1 Facilities of the offline tester
10.2 Simulating a client UAP
10.2.1 Simulating a client UAP with an RPC interface
10.2.2 Simulating a client UAP with an XATMI interface
10.2.3 Simulating a client UAP with a TxRPC interface
10.3 Simulating a server UAP
10.3.1 Simulating a server UAP with an RPC interface
10.3.2 Simulating a server UAP with an XATMI interface
10.3.3 Simulating a server UAP with a TxRPC interface
10.4 Simulating the MCF
10.5 Simulating file services
10.5.1 Simulating the DAM service
10.5.2 Simulating the TAM service
10.6 Simulating OpenTP1 functions
10.7 Simulating operating commands
10.8 Creating tester files
10.9 Continuous command execution
10.10 Debugger connection
10.11 Collecting test information
10.11.1 Collecting offline tester trace information

11. Setting the Test Environment
11.1 System definitions for the offline tester
11.1.1 Offline tester environment definition
11.1.2 User service definition
11.1.3 Setting function return values
11.1.4 Setting continuous execution commands
11.1.5 Creating stubs
11.2 User-created files
11.2.1 Service request data files
11.2.2 Service response data files
11.2.3 XATMI receive data file
11.2.4 MCF receive message files
11.2.5 DAM file
11.2.6 TAM file
11.2.7 Operating command result data file
11.3 Creating files
11.3.1 Test data definition file
11.3.2 Files created by the offline tester

12. Test Execution
12.1 Creating UAPs
12.1.1 Creating UAP execution format programs
12.2 Starting and ending an offline test
12.3 Activating and terminating UAPs
12.4 Service requests
12.5 Creating tester files
12.6 Continuous command execution
12.7 Debugger connection
12.8 Editing offline tester trace information
12.9 Notes on running tests
12.9.1 Notes on the offline tester
12.9.2 Notes on files
12.9.3 Notes on UAPs

13. Operating Commands
13.1 Operating commands for running tests
13.1.1 utfdamcre (creation of offline tester DAM file)
13.1.2 utffilcre (tester file creation)
13.1.3 utfstart (offline tester startup)
13.1.4 utftamcre (creation of offline tester TAM files)
13.1.5 utftrcpic (retrieval of offline tester trace information)
13.2 Subcommands for running tests
13.2.1 call (service request)
13.2.2 cmdauto (continuous command execution)
13.2.3 end (offline tester termination)
13.2.4 ps (test status display)
13.2.5 read (input of tester file name to offline tester)
13.2.6 start (service group activation)
13.2.7 stop (service group termination)
13.2.8 write (input of tester file name to offline tester)

14. Simulation Functions
14.1 List of simulation functions and processing
14.2 List of return values for simulation functions
14.3 List of functions not supported by the simulation feature

Part 5: UAP Traces

15. How to Use UAP Traces
15.1 Collecting UAP traces
15.1.1 UAP trace collection units
15.1.2 Trace area definition
15.1.3 Information to collect
15.2 Editing and outputting UAP traces
15.2.1 UAP trace output units
15.2.2 UAP trace output methods
15.2.3 uatdump (edited output of UAP trace)
15.2.4 UAP trace output format

Index