advertisement
7.117 T{+/-} dev (Turn CCW tracing on or off)
7.117.1 Function
This command turns the CCW tracing for a certain device on (T+dev) or turns it off (T-dev). It is possible to trace several devices concurrently. To enable the tracing of more than one device the T+ command must be issued for each device. The traces can be turned off independently of each other.
function is that with CCW stepping the execution of every CCW has to be initiated by hitting ENTER on the Hercules console, whereas CCW tracing – once started – traces the instructions without interruption.
Please note that the tracing function will create an enormous amount of output in the Hercules log.
7.117.2 Syntax
Descriptive
T{+ | -} devaddr
Diagram
Êʬ¬¬ T ¬¬¬§¬¬¬ + ¬¬¬§¬¬¬
¬¬¬ - ¬¬¬¯ devaddr
¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
7.117.3 Parameter
devaddr
+
-
This is the address of the device for which the CCW tracing is to be turned on or off.
The plus sign turns on the CCW tracing for the given device. The plus sign must imme-diately follow the T command (without an intervening blank).
The minus sign turns off the CCW tracing for the given device. The minus sign must immediately follow the T command (without an intervening blank).
7.117.4 Examples
Example 1:
Turn on the CCW tracing for device 0148.
t+0148
HHCPN136I CCW tracing is now on for device 0148
0148:start i/o file[0] bufcur -1 cache[-1]
HHCCP048I 0148:CCW=02000000 60000018=>02000000 60000018 00000000 00000000 ....-...........
0148:HHCDA038I seeking to cyl 0 head 0
0148:read trk 0 (asynchronous)
Hercules Emulator V3.09 – User Reference Guide Page 358
0148:0 rdtrk 0
0148:0 rdtrk[0] 0 cache miss
0148:0 rdtrk[0] 0 buf 00DA4FA0 len 56832
0148:trk[0] read_trkimg
0148:file[0] l2[0,0] trk[0] read_l2ent 0x710
0148:file[0] read_l2 0 active -1 -1 -1
0148:l2[0,0] cache[0] miss
0148:file[0] fd[5] read, off 0x710 len 2048
0148:file[0] cache[0] l2[0] read offset 0x710
0148:file[0] l2[0,0] trk[0] read_l2ent 0xf10 3057 3057
0148:file[0] fd[5] read, off 0xf10 len 3057
0148:0 rdtrk[0] 0 complete buf 00DA4FA0:0100000000
0148:uncompress comp 1 len 3057 maxlen 56832 trk 0
0148:newbuf malloc 00DBCEC8 len 56832
0148:uncompress zlib newlen 6491 rc 0
0148:validating trk 0 len 6491 0000000000 0000000000000008
0148:read trk 0 uncompressed len 6491
0148:HHCDA041I read count orientation is index
0148:HHCDA043I cyl 0 head 0 record 0 kl 0 dl 8 of 0
0148:HHCDA043I cyl 0 head 0 record 1 kl 4 dl 24 of 0
0148:HHCDA045I read data 24 bytes
HHCCP075I 0148:Stat=0C00 Count=0000 =>00080000 8000015A 06004A98 60000060 .......!...q-..-
HHCCP048I 0148:CCW=06004A98 60000060=>00000000 00000000 00000000 00000000 ................
0148:HHCDA041I read count orientation is data
0148:HHCDA043I cyl 0 head 0 record 2 kl 4 dl 144 of 0
0148:HHCDA045I read data 144 bytes
.
.
.
0148:HHCDA041I read count orientation is count
0148:HHCDA043I cyl 0 head 0 record 1 kl 4 dl 24 of 0
HHCCP075I 0148:Stat=0C00 Count=0000
HHCCP048I 0148:CCW=08004AA0 00000000=>31004ABE 40000005 08004AA0 00000000 .... ...........
HHCCP048I 0148:CCW=31004ABE 40000005=>00000000 04000000 00000000 00000000 ................
0148:HHCDA041I read count orientation is count
0148:HHCDA043I cyl 0 head 0 record 2 kl 4 dl 144 of 0
HHCCP075I 0148:Stat=0C00 Count=0000
HHCCP048I 0148:CCW=08004AA0 00000000=>31004ABE 40000005 08004AA0 00000000 .... ...........
HHCCP048I 0148:CCW=31004ABE 40000005=>00000000 04000000 00000000 00000000 ................
0148:HHCDA041I read count orientation is count
0148:HHCDA043I cyl 0 head 0 record 3 kl 4 dl 80 of 0
HHCCP075I 0148:Stat=0C00 Count=0000
HHCCP048I 0148:CCW=08004AA0 00000000=>31004ABE 40000005 08004AA0 00000000 .... ...........
HHCCP048I 0148:CCW=31004ABE 40000005=>00000000 04000000 00000000 00000000 ................
0148:HHCDA041I read count orientation is count
0148:HHCDA043I cyl 0 head 0 record 4 kl 0 dl 6170 of 0
HHCCP075I 0148:Stat=4C00 Count=0000
HHCCP048I 0148:CCW=06000000 20002F55=>00080000 8000015A 06004A98 60000060 .......!...q-..-
0148:HHCDA045I read data 6170 bytes
HHCCP075I 0148:Stat=0C00 Count=173B =>00080000 800005EC 40404040 F0F04040 ........ 00
0148:end i/o bufcur 0 cache[0] waiters 0
Figure 179: T+ dev command
Hercules Emulator V3.09 – User Reference Guide Page 359
Example 2:
Turn off the CCW tracing for device 0148.
2007/06/30 14:21:05.156 00000FC4 t-0148
2007/06/30 14:21:05.156 00000FC4 HHCPN136I CCW tracing is now off for device 0148
Figure 180: T- dev command
Example 3:
Turn on the CCW tracing for several devices.
2007/06/30 14:23:15.246 00000FC4 t+0148
2007/06/30 14:23:15.246 00000FC4 HHCPN136I CCW tracing is now on for device 0148
2007/06/30 14:23:15.246 00000FC4 t+0561
2007/06/30 14:23:15.246 00000FC4 HHCPN136I CCW tracing is now on for device 0561
Figure 181: T+ dev command (several devices)
Hercules Emulator V3.09 – User Reference Guide Page 360
advertisement
* Your assessment is very important for improving the workof artificial intelligence, which forms the content of this project
advertisement
Table of contents
- 3 Contents
- 10 Figures
- 16 Tables
- 17 Preface
- 17 Edition information
- 17 What this book is about
- 17 Who should read this book
- 17 What you need to know to understand this book
- 17 How to use this book
- 17 Revision Notice
- 18 Readers Comments
- 18 Legal Advice
- 18 Trademarks
- 19 Acknowledgements
- 20 Related Publications
- 20 Hercules Emulator – General Information
- 20 Hercules Emulator – Installation Guide
- 20 Hercules Emulator – User Reference Guide
- 20 Hercules Emulator – Messages and Codes
- 20 Hercules Emulator – Reference Summary
- 21 Hercules Configuration File
- 21 The Configuration File
- 21 System Parameters
- 23 Device Definitions
- 24 Coding Rules
- 25 Record Format
- 26 Sample Configuration File
- 29 Symbol Substitution
- 30 Enhanced Symbol Substitution
- 32 System Parameter Descriptions
- 32 # or * (Comment lines)
- 33 ARCHMODE (Initial architecture mode)
- 34 ASN_AND_LX_REUSE / ALRF (ESAME ASN and LX REUSE feature)
- 35 AUTOMOUNT (Tape automount root directory)
- 37 AUTO_SCSI_MOUNT (Automatic SCSI tape mounts)
- 38 CCKD (Compressed CKD DASD options)
- 43 CNSLPORT (Telnet client port)
- 44 CODEPAGE (Codepage conversion table)
- 46 CONKPALV (Console and telnet clients keep-alive option)
- 48 CPUMODEL (CPU model)
- 49 CPUPRIO (CPU thread process priority)
- 50 CPUSERIAL (CPU serial number)
- 51 CPUVERID (CPU version code)
- 52 DEFSYM (Define symbol)
- 53 DEVPRIO (Device threads process priority)
- 54 DEVTMAX (Maximum number of device threads)
- 56 DIAG8CMD (DIAGNOSE 8 command setting)
- 58 ECPSVM (ECPS:VM support status (VM))
- 60 ENGINES (Processor engine type)
- 62 HERCLOGO (Hercules 3270 logo)
- 63 HERCPRIO (Hercules process priority)
- 64 HTTPPORT (HTTP server port)
- 66 HTTPROOT (HTTP server root directory)
- 67 IGNORE (Ignore subsequent INCLUDE errors)
- 68 INCLUDE (Include configuration file)
- 69 IODELAY (I/O interrupt wait time (LINUX))
- 70 LDMOD (Additional dynamic load modules)
- 71 LEGACYSENSEID (SENSE ID CCW (x'E4') feature)
- 72 LOADPARM (IPL parameter)
- 73 LOGOPT (Log options)
- 74 LPARNAME (LPAR name returned by DIAG x'204')
- 75 LPARNUM (LPAR identification number)
- 76 MAINSIZE (Main storage in MB)
- 77 MANUFACTURER (Manufacturer name returned by STSI instruction)
- 78 MAXCPU (Maximum number of CPUs)
- 80 MODEL (Model names returned by STSI instruction)
- 81 MODPATH (Dynamic load module path)
- 82 MOUNTED_TAPE_REINIT (Control tape initialization)
- 83 NUMCPU (Number of emulated CPUs)
- 84 NUMVEC (Number of vector facilities)
- 85 OSTAILOR (Intended operating system)
- 87 PANRATE (Panel refresh rate)
- 88 PANTITLE (Hercules console window title)
- 89 PGMPRDOS (LPP license setting)
- 90 PLANT (Plant name returned by STSI instruction)
- 91 SCLPROOT (SCLP base directory)
- 92 SHCMDOPT (Shell command option)
- 93 SHRDPORT (Shared device server port)
- 94 SYSEPOCH (Base date for TOD clock)
- 95 TIMERINT (Internal timer update interval)
- 96 TODDRAG (TOD clock drag factor)
- 97 TODPRIO (Timer thread process priority)
- 98 TRACEOPT (Instruction trace display option)
- 99 TZOFFSET (TOD clock offset from GMT)
- 100 XPNDSIZE (Expanded storage in MB)
- 101 YROFFSET (TOD clock offset from actual date)
- 102 Process and Thread Priorities
- 104 Device Definition Descriptions
- 104 Local non-SNA 3270 Devices
- 107 Integrated 3270 (SYSG) Console
- 110 Console Printer-Keyboard Devices
- 113 Integrated Console Printer-Keyboard Devices
- 114 Card Reader Devices
- 116 Card Punch Devices
- 118 Line Printer Devices
- 121 Emulated Tape Devices
- 135 Channel-to-Channel Adapters
- 142 FBA DASD Devices
- 144 CKD DASD Devices
- 148 Communication Lines (Preliminary 2703 BSC Support)
- 151 Hercules Console
- 151 Hercules Hardware Console
- 153 Web browser interface
- 154 Using the keyboard
- 156 Log formats
- 159 Hercules Console Commands (sorted alphabetically)
- 164 Hercules Console Commands (grouped by functionality)
- 170 Console Command Descriptions
- 170 !message (SCP priority message)
- 171 # or * (Log comment to syslog)
- 172 .reply (SCP command)
- 173 ? (List all commands / command specific help)
- 175 AEA (Display AEA absolute-effective-address tables)
- 176 AIA (List AIA absolute-instruction-address fields)
- 177 AR (Display access registers)
- 178 ARCHMODE (Set architecture mode)
- 180 ATTACH (Configure device)
- 182 AUTOMOUNT (Show or update allowable tape automount directories)
- 184 AUTO_SCSI_MOUNT (Automatic SCSI tape mounts)
- 186 B (Set breakpoint)
- 187 B+ (Set breakpoint)
- 188 B- (Delete breakpoint)
- 189 CACHE (Cache command)
- 191 CCKD (CCKD command)
- 197 CD (Change directory)
- 198 CF (Configure CPU online or offline)
- 200 CFALL (Configure all CPUs online or offline)
- 202 CLOCKS (Display TOD clock and CPU timer)
- 203 CMDTGT (Specify the command target)
- 205 CONKPALV (Display / alter console TCP/IP keep-alive settings)
- 207 CPU (Define target CPU for console displays and commands)
- 208 CR (Display or alter control registers)
- 210 CSCRIPT (Cancel a running script thread)
- 211 CTC (Enable / disable debug packet tracing)
- 214 DEFINE (Rename device)
- 215 DEFSYM (Define symbol)
- 217 DETACH (Remove device)
- 218 DEVINIT (Reinitialize device)
- 220 DEVLIST (List device or all devices)
- 222 DEVTMAX (Display or set maximum device threads)
- 224 DS (Display subchannel)
- 227 ECPSVM (ECPS:VM commands)
- 230 EXIT (Terminate the emulator)
- 232 EXT (Generate external interrupt)
- 233 F{+/-} (Mark frames usable or unusable)
- 234 FPC (Display floating point control register)
- 235 FPR (Display floating point registers)
- 237 G (Turn off instruction stepping and start CPU)
- 238 GPR (Display or alter general purpose registers)
- 240 HAO (Hercules Automatic Operator)
- 243 HELP (List all commands / command specific help)
- 245 HERC (Send Hercules command)
- 246 HERCLOGO (Read new logo file)
- 247 HST (History of commands)
- 249 I (Generate I/O attention interrupt for device)
- 250 IODELAY (Display or set I/O delay value)
- 252 IPENDING (Display pending interrupts)
- 254 IPL (IPL normal from device xxxx)
- 256 IPLC (IPL clear from device xxxx)
- 258 K (Display CCKD internal trace)
- 260 LDMOD (Load a module)
- 261 LOADCORE (Load a core image file)
- 262 LOADPARM (Set IPL parameter)
- 264 LOADTEXT (Load a text deck file)
- 265 LOG (Direct log output)
- 266 LOGOPT (Change log options)
- 267 LPARNAME (Display or set LPAR name)
- 268 LPARNUM (Display or set LPAR identification number)
- 270 LSDEP (List module dependencies)
- 271 LSMOD (List dynamic modules)
- 275 MESSAGE (Display message on console like VM)
- 276 MOUNTED_TAPE_REINIT (Control tape initialization)
- 278 MSG (Display message on console like VM)
- 279 MSGHLD (Display or set timeout of held messages)
- 281 MSGNOH (Display message on console like VM, but without header)
- 282 OSTAILOR (Specify intended operating system)
- 284 PANRATE (Display or set console refresh rate)
- 286 PGMTRACE (Trace program interrupts)
- 288 PR (Display prefix register)
- 289 PSCP (Send system control program priority message)
- 290 PSW (Display or alter program status word)
- 293 PTT (Set / display pthread trace)
- 297 PWD (Print working directory)
- 298 QD (Query DASD)
- 301 QUIET (Toggle automatic refresh of console display data)
- 302 QUIT (Terminate the emulator)
- 304 R (Display or alter real storage)
- 306 RESTART (Generate restart interrupt)
- 307 RESUME (Resume Hercules)
- 309 RMMOD (Delete a module)
- 310 S (Instruction stepping)
- 312 S+ (Instruction stepping on)
- 314 S- (Instruction stepping off)
- 315 S? (Instruction stepping query)
- 316 S{+/-} dev (Turn CCW stepping on or off)
- 319 SAVECORE (Save a core image to a file)
- 321 SCLPROOT (Set or display SCLP base directory)
- 323 SCP (Send system control program command)
- 324 SCRIPT (Run a sequence of commands contained in a file)
- 325 SCSIMOUNT (Automatic SCSI tape mounts)
- 327 SF+ (Create a new shadow file)
- 328 SF- (Remove a shadow file)
- 330 SFC (Compress a shadow file)
- 331 SFD (Display shadow file statistics)
- 332 SFK (Perform a chkdsk on the active shadow file)
- 335 SH (Shell command)
- 337 SHRD (SHRD command)
- 339 SIZEOF (Display size of structures)
- 340 SSD (Signal shutdown)
- 341 START (Start CPU or printer device)
- 342 STARTALL (Start all CPUs)
- 343 STOP (Stop CPU or printer device)
- 344 STOPALL (Stop all CPUs)
- 345 STORE (Store CPU status at absolute zero)
- 346 SUSPEND (Suspend Hercules)
- 348 SYNCIO (Display SYNCIO device statistics)
- 349 SYSCLEAR (Issue SYSTEM CLEAR RESET manual operation)
- 350 SYSRESET (Issue SYSTEM RESET manual operation)
- 351 T (Instruction trace)
- 352 T+ (Instruction trace on)
- 354 T- (Instruction trace off)
- 355 T? (Instruction trace query)
- 356 T{+/-} CKD (Turn CKD_KEY tracing on or off)
- 358 T{+/-} dev (Turn CCW tracing on or off)
- 361 TIMERINT (Display or set timers update interval)
- 363 TLB (Display TLB tables)
- 364 TODDRAG (Display or set TOD clock drag factor)
- 366 TRACEOPT (Instruction trace display options)
- 368 TT32 (Control / query CTCI-W32 functionality)
- 370 U (Disassemble storage)
- 372 UPTIME (Display Hercules Emulator uptime)
- 373 V (Display or alter virtual storage)
- 376 VERSION (Display version information)
- 377 Hercules Utilities
- 377 Overview
- 380 CCKDCDSK (CCKD DASD file integrity verification, recovery and repair utility)
- 382 CCKDCOMP (CCKD DASD file compression utility)
- 384 CCKDDIAG (CCKD DASD file diagnostics utility)
- 387 CCKDSWAP (CCKD DASD file swap-endian program)
- 388 CKD2CCKD (Copy CKD DASD file to CCKD DASD file)
- 389 CCKD2CKD (Copy CCKD DASD file to CKD DASD file)
- 390 DASDCAT (Display PDS datasets and members)
- 394 DASDCONV (DASD image file conversion program)
- 396 DASDCOPY (Copy DASD file to another DASD file)
- 398 DASDINIT (DASD image file creation)
- 401 DASDISUP (Fix XCTL tables in SVCLIB)
- 403 DASDLOAD (DASD loader program)
- 411 DASDLS (List datasets on a volume)
- 413 DASDPDSU (PDS unload utility)
- 415 DASDSEQ (Display sequential datasets)
- 417 HETGET (Extract files from an AWS or HET tape file)
- 419 HETINIT (Initialize an AWS or HET tape file)
- 421 HETMAP (Show information about a HET or AWS tape file)
- 426 HETUPD (Update and/or copy an AWS or HET tape file)
- 428 TAPECOPY (Copy a SCSI tape to or from an AWSTAPE disk file)
- 430 TAPEMAP (Show information about an AWS tape file)
- 432 TAPESPLT (Split an AWS tape file)
- 434 DMAP2HRC (P/390 DEVMAP conversion program)
- 435 FTAPE (SCSI Tape Test Utility)
- 443 HercPrt (Remote Hercules Printer Spooler)
- 460 PRTPUB (Mainframe print publishing program)
- 464 AWSSL (AWS virtual tape)
- 469 AWSUTIL (AWS format tape file generation utility)
- 471 RAWSTAPE (Reverse AWSTAPE utility)
- 472 VTTS (Virtual tape transportation system)
- 475 Shared Device Support
- 475 Basics
- 475 Caching
- 475 Compression
- 476 Usage of Shared Devices
- 478 Hercules 3270 Logo
- 478 Function
- 478 Orders
- 480 Variables
- 480 Sample
- 483 Starting the Hercules Emulator
- 483 Starting Hercules in Native Mode
- 484 Starting Hercules with the Windows GUI
- 485 Starting Hercules with the Hercules Studio
- 487 The Run-Commands File (hercules.rc)
- 487 Function
- 487 Run-Commands File Statements
- 489 Automating Hercules Startup
- 492 The “Hercules Automatic Operator” (HAO) Facility
- 492 HAO Introduction
- 492 Defining HAO Rules
- 492 Deleting HAO Rules
- 493 Substituting Substrings
- 493 Limitations
- 493 Examples
- 495 Submitting Jobs via the Socket Reader
- 495 Socket Reader Basics
- 496 Submitting Jobs from Windows
- 497 Submitting Jobs from Unix
- 499 Appendix A: Supported DASD Device Types
- 502 Appendix B. Configuration of Emulated CPUs
- 502 B.1 General Explanations and Rules
- 502 B.1 Examples
- 506 Appendix C. Syntax
- 506 C.1 Reading Syntax Descriptions
- 507 C.2 Reading Syntax Diagrams
- 509 C.3 Sample Syntax Description
- 510 C.4 Sample Syntax Diagram
- 512 Appendix D. Links