1PLAYBACK(1)                 General Commands Manual                PLAYBACK(1)
2
3
4

NAME

6       playback - IBM x3270 trace file playback tool
7

SYNOPSIS

9       playback [ -b ] [ -w ] [ -p port ] trace_file
10

DESCRIPTION

12       playback opens a trace file (presumably created by the x3270 Trace Data
13       Stream facility) and plays the host data it contains back over a socket
14       to processes that connect to it.  It also displays the data produced by
15       the process in response.
16
17       It runs in one of two modes, bidirectional and interactive.   In  bidi‐
18       rectional  mode,  selected  by the -b option, playback verfies that the
19       emulator connected to it sends the correct stream of bytes in  response
20       to the host stream.  This is useful for automated testing.
21
22       Otherwise,  playback is used interactively.  The -w command-line option
23       prevents processing interactive commands until a process connects; oth‐
24       erwise  commands  are processed immediately.  Keyboard commands control
25       the flow of data from the file to the socket.  These commands are:
26
27       s      Send one line of data.
28
29       r      Send one record of data (send data until the TELNET EOR sequence
30              is reached).
31
32       m      Send  data  util a mark (a line beginning with $) is encountered
33              in the file.
34
35       e      Send the rest of the data in the file.
36
37       t      Send a TELNET DO TIMING MARK sequence.
38
39       c      Echo the command to stdout as a comment.
40
41       d      Disconnect the current socket and wait for another connection.
42
43       q      Exit playback.
44

EXIT STATUS

46       0      Success.
47
48       1      Set-up failure.
49
50       2      Run-time failure, such as mismatched data.
51

EXAMPLES

53       Suppose you wanted to interactively  play  back  a  trace  file  called
54       /tmp/x3trc.12345.  In one window, run:
55
56            playback /tmp/x3trc.12345
57
58       In another window, start x3270 with the command:
59
60            x3270 localhost:4001
61
62       playback will announce the connection.
63
64       Thereafter, the s and r commands will send data from the file to x3270.
65
66       To  automate  a  unit  test  to verify that x3270 produces a known data
67       stream, run:
68
69            playback -b /tmp/x3trc.12345
70
71       In another window, start x3270 as above.  playback will exit with  sta‐
72       tus 0 if the byte stream matches, and status 2 if it does not.
73

SEE ALSO

75       x3270(1)
76
77
78
79                               30 December 2021                    PLAYBACK(1)
Impressum