CP Command Reference for General Users (Rel 6 PLC 17 Apr81) Page 165 (177 of 213)

TRACE T.R!£!!I§: I!l§:tI.!!£:tiQTI: · .. VVVVVI7 SSM xxxxxxxx ss (normal SSM) · .. · .. vvvvvv Ss"'! xxxxxxxx ss tttttt (switch to/from translate mode) · .. · .. vvvvV'J' xxxxxxxx ns (normal STOSM) · .. VVVVVI7 xxxxxxxx ns tttttt (switch to translate mode) · .. · .. VVVVVI7 STNSM xxxxxxxx ns (normal STNSM) · .. vvvvvv xxxxxxxx ns tttttt (switch from translate mode) · .. · .. VVVVV'I LPSW xxxxxxxx tttttttt tttttttt (WAIT bit on) · .. · .. VVVVVI7 LPSW xxxxxxxx ==> tttttttt tttttttt (WAIT bit not on) · .. · .. vvvvvv mnem xxxxxxxx (all others) · .. VVVVVV Er xxxxxxxx zz vvvvvv mnem xxxx xxxxxxxx
For an instruction, where zz (see preceding explanation of symbols) is nonzero, the mnemonic for the executed instruction is given
as if the zz byte had been put into the instruction with an OR operation.
vvvvvv mnem xxxxxxxx xxxx VVVVVV mnem xxxxxxxx ==> tttttt
*** vvvvvv int code ==> tttttt ILQ (First line qiven only if "CSW" was specified) : CSW V vadd xxxxxxxx xxxxxxxx R radd YYYYYYYY Y11YY11Y *** vvvvvv lID vadd ==) tttttt CSW xxxx (A 11 option selected)
Entry for from' instruction
vvvvvv mnem xxxxxxxx tttttt Entry for 'branch to' instruction
==> vvvvvv mnem xxxxxxxxxxxx
section 5. Format of CP Commands 165

TRANSFER Use the TRANSFER command to direct your input file to a specified reader
or to re=laim virtual reader files that you spooled to another user. format of the TRANSFER command is:
r
TRANsfer {
SPOOlid} [ To] user i d l CLass c
ALL l From L
spoolid is the input file to be directed to or retrieved from the
named userid. CLASS is the class of input files that are to be transferred. is a one-character alphameric field with values from A
and from 0 to 9.
The c
to Z
ALL that all input spool files are to be transferred. [TO 1 userid FROM is the user to whom the files are to be directed. If the
optional keyword TO is omitted, the userid may not be TO or T.
The file is deleted from your reader if you use this option. {
IISeL id}
ALL
is the user from whom input spool files are to be reclaimed.
ALL may be specified to reclaim input spool files that were
originated by your virtual machine from all users.
The TRANSFER =ommand does not transfer any active spool files. PDR FILE spoolid TRANSFERRED {TO } userid FROM spoolia TO IIser-i:'i is the spool file identification number of the file
that is spooled. The number does not change.
is the response to the user who transferred the file
verifyinq that userid is the recipient of the file. 166 IBM VM/370 CP Command Reference for General Users

Previous Page Next Page

Extracted Text (may have errors)

TRACE The symbols are used in the responses received from TRACE: vvvvvv tttttt
rrrrrr
xxxxxxxx yyyyyyyy ss ns zz
zzzzzzzz
type
V vajd R rajd mnem
int
code
CC n
IDAL
***
==> SEEK TRACE STARTED !1gg!li!lg virtual storage address
virtual transfer address or new PSW address
real storage address
virtual instruction, channel command word, :SW status
real instruction, CCW arqument byte (SSM-byte) for SSM instruction
new system mask after execution of STJSM/STNSM low order byte of R1 register in an execute instruction
(not shown if R1 register is reqister 0) referenced data
virtual device name (DASD, TAPE, LINE, CONS, RDR, PFT, PUN, GRAF, DEV)
virtual device address
real device address
mnemonic for instruction
interruption type (SVC, PROG, EXT, I/O)
interruption code number (in hexadecimal)
condition-code number (0, 1, 2, or 3)
Indirect data address list
virtual machine interrupt
privileged operations
transfer of control
read/write position on DASD device
This response is issued when tracing is initiated. TRACE ENDED
This response is issued when tracing is suspended. riO vvvvvv TCP xxxxxxxx type vadd CC n I/O vvvvvv mnem xxxxxxxx type vadd CC n t1pe radd CSW xxxx liD vvvvvv mnem xxxxxxxx type vadd CC n type radd CSW xxxx CAW vvvvvvvv CCW vvvvvv xxxxxxxx xxxxxxxx rrrrrr YYYYY11Y Y1YYYYY1 CCW IDAL vvvvvvvv vvvvvvvv IDAL OOrrrrrr OOrrrrrr CCW SEEK xxxxxxxx xxxxxx SEEK 1Y1YYYY1 11YY The IDAL SEEK line is included only if applicable. The virtual IDAL
is not printed if the real CCW operation code does not match the real
CCW.
164 IBM CP Command Reference for General Users

TRACE T.R!£!!I§: I!l§:tI.!!£:tiQTI: · .. VVVVVI7 SSM xxxxxxxx ss (normal SSM) · .. · .. vvvvvv Ss"'! xxxxxxxx ss tttttt (switch to/from translate mode) · .. · .. vvvvV'J' xxxxxxxx ns (normal STOSM) · .. VVVVVI7 xxxxxxxx ns tttttt (switch to translate mode) · .. · .. VVVVVI7 STNSM xxxxxxxx ns (normal STNSM) · .. vvvvvv xxxxxxxx ns tttttt (switch from translate mode) · .. · .. VVVVV'I LPSW xxxxxxxx tttttttt tttttttt (WAIT bit on) · .. · .. VVVVVI7 LPSW xxxxxxxx ==> tttttttt tttttttt (WAIT bit not on) · .. · .. vvvvvv mnem xxxxxxxx (all others) · .. VVVVVV Er xxxxxxxx zz vvvvvv mnem xxxx xxxxxxxx
For an instruction, where zz (see preceding explanation of symbols) is nonzero, the mnemonic for the executed instruction is given
as if the zz byte had been put into the instruction with an OR operation.
vvvvvv mnem xxxxxxxx xxxx VVVVVV mnem xxxxxxxx ==> tttttt
*** vvvvvv int code ==> tttttt ILQ (First line qiven only if "CSW" was specified) : CSW V vadd xxxxxxxx xxxxxxxx R radd YYYYYYYY Y11YY11Y *** vvvvvv lID vadd ==) tttttt CSW xxxx (A 11 option selected)
Entry for from' instruction
vvvvvv mnem xxxxxxxx tttttt Entry for 'branch to' instruction
==> vvvvvv mnem xxxxxxxxxxxx
section 5. Format of CP Commands 165

Help

TRACE To resume operation of the virtual machine, the BEGIN command must
be entered. If the RUN operand is specified, the virtual machine is
not.stopped after each output message.
4. If trace output is beinq recorded on a virtual spooled printer, a CLOSE command must be issued to that printer output to be printed on the real printer.
., ... • u 5. Successful branches to the next sequential instruction and
branch-to-self instructions are not-detected by TRACE.
6. RUN and RORUN can be specified in different TRACE commands with no
conflict as lonq as the functions being traced are different.
7. Instructions that modify or examine the first two bytes of the next
sequential instruction cause erroneous processing for BR&NCH and INSTRUCT tracinq.
8. When tracing on a virtual machine with only one printer, the trace
data is intermixed with other data sent to the virtual printer. To
separate trace information from other data, define another printer
with a lower virtual address than the previously defined printer. For example, on a system with OOE defined as the only printer,
define a second printer as OOB. The regular output goes to OOE and
the trace output goes to OOB. 9. If the BRANCH, INSTRUCT, or ALL activities are being traced by a virtual machine using a shared system, the user receives a warning
message and the virtual machine is unshared from (given a private
copy of) the named system. Other users of the segment continue to
operate with an unchanged copy of that segment. 10. 110 for virtual channel-to-channel adapters, with both
ends connected to the same virtual machine, cannot be traced. 11. Use the TRACE command to trace specified virtual machine activity
and to record the results at the terminal, at a virtual printer, or
at both. This command is useful in debugging programs because it allows you to trace only the information that pertains to a
particular problem.
12. If your virtual machine is doing I/O that results in
program-controlled interruptions (PCls), and you are tracing I/O or CSW activity, some of the PCls may not be traced. This situation
arises when the system is extending its free storage area and the
additional demand on available free storage could cause a system
abend.
13. The PA1 key on a 3270 display terminal shOUld not be pressed with trace all run active while the display screen indicates status as a subsequent CP command entered from the console may result in interleaved output.
section 5. Format of CP Commands 163

TRACE The symbols are used in the responses received from TRACE: vvvvvv tttttt
rrrrrr
xxxxxxxx yyyyyyyy ss ns zz
zzzzzzzz
type
V vajd R rajd mnem
int
code
CC n
IDAL
***
==> SEEK TRACE STARTED !1gg!li!lg virtual storage address
virtual transfer address or new PSW address
real storage address
virtual instruction, channel command word, :SW status
real instruction, CCW arqument byte (SSM-byte) for SSM instruction
new system mask after execution of STJSM/STNSM low order byte of R1 register in an execute instruction
(not shown if R1 register is reqister 0) referenced data
virtual device name (DASD, TAPE, LINE, CONS, RDR, PFT, PUN, GRAF, DEV)
virtual device address
real device address
mnemonic for instruction
interruption type (SVC, PROG, EXT, I/O)
interruption code number (in hexadecimal)
condition-code number (0, 1, 2, or 3)
Indirect data address list
virtual machine interrupt
privileged operations
transfer of control
read/write position on DASD device
This response is issued when tracing is initiated. TRACE ENDED
This response is issued when tracing is suspended. riO vvvvvv TCP xxxxxxxx type vadd CC n I/O vvvvvv mnem xxxxxxxx type vadd CC n t1pe radd CSW xxxx liD vvvvvv mnem xxxxxxxx type vadd CC n type radd CSW xxxx CAW vvvvvvvv CCW vvvvvv xxxxxxxx xxxxxxxx rrrrrr YYYYY11Y Y1YYYYY1 CCW IDAL vvvvvvvv vvvvvvvv IDAL OOrrrrrr OOrrrrrr CCW SEEK xxxxxxxx xxxxxx SEEK 1Y1YYYY1 11YY The IDAL SEEK line is included only if applicable. The virtual IDAL
is not printed if the real CCW operation code does not match the real
CCW.
164 IBM CP Command Reference for General Users

Previous Page Next Page

Extracted Text (may have errors)

ALL traces all instructions, interrupts, successful branches,
privileqe instructions, and virtual machine I/O operations. CSW provides contents of virtual and real channel status words at I/O interrupt.
END terminates all tracinq activity and prints a termination messacre. PRINTER directs tracinq output to PRINTER is specified, RUN is NORUN can be specified.
a virtual spooled printer. If
assumed; however neither RUN nor directs tracing output to the terminal (virtual machine
console). BOTH directs tracing output to both a virtual spooled printer and
the terminal. OFF halts tracing of the specified activities on both the printer
and terminal. RUN stops proqram execution after the trace output to the terminal
and enters the CP command environment. If a Diagnose code X'OOS' is being traced, NORUN has no
effect and program execution does not stop.
continues the program execution after
terminal has completed and does not
environment.
the trace output to the
enter the:P command
1. If vour virtual machine has the virtual=real option and NOTRANS set
on, CP forces CCW translation while tracing either SIO or :CW. When tracing is terminated with the TRACE END command, CCW translation is bypassed again.
2. If hardware assist is enabled on your virtual machine, CP
turns it off while tracing SVC, PRIV, BRANCH, INSTRU:T, or ALL If virtual interval timer support is available on your
processor and is active (that is, SET ASSIST TMR is in effect), CP
turns the timer support off while tracing external interrupts.
After the tracing is terminated with the TRACE END command, CP
turns hardware assist on again.
3. If trace output is beinq recorded at the terminal, the virtual machine stops execution and CP command mode is entered after each
output messaqe. This simulates the instruction step function.
However, all processing associated with "the event being traced is
completej and, therefore, execution may have stopped after an
instruction has executed and the PSW has been updated.
For example, a privileged instruction traced with the PRIV operand stops after the privileged instruction executes, whereas the same
instruction traced with the ALL operand stops before the
instruction executes.
To determine whether the traced instruction has executed, display
the virtual machine PSW. 162 IBM VM/370 CO Command Reference for General Users

TRACE To resume operation of the virtual machine, the BEGIN command must
be entered. If the RUN operand is specified, the virtual machine is
not.stopped after each output message.
4. If trace output is beinq recorded on a virtual spooled printer, a CLOSE command must be issued to that printer output to be printed on the real printer.
., ... • u 5. Successful branches to the next sequential instruction and
branch-to-self instructions are not-detected by TRACE.
6. RUN and RORUN can be specified in different TRACE commands with no
conflict as lonq as the functions being traced are different.
7. Instructions that modify or examine the first two bytes of the next
sequential instruction cause erroneous processing for BR&NCH and INSTRUCT tracinq.
8. When tracing on a virtual machine with only one printer, the trace
data is intermixed with other data sent to the virtual printer. To
separate trace information from other data, define another printer
with a lower virtual address than the previously defined printer. For example, on a system with OOE defined as the only printer,
define a second printer as OOB. The regular output goes to OOE and
the trace output goes to OOB. 9. If the BRANCH, INSTRUCT, or ALL activities are being traced by a virtual machine using a shared system, the user receives a warning
message and the virtual machine is unshared from (given a private
copy of) the named system. Other users of the segment continue to
operate with an unchanged copy of that segment. 10. 110 for virtual channel-to-channel adapters, with both
ends connected to the same virtual machine, cannot be traced. 11. Use the TRACE command to trace specified virtual machine activity
and to record the results at the terminal, at a virtual printer, or
at both. This command is useful in debugging programs because it allows you to trace only the information that pertains to a
particular problem.
12. If your virtual machine is doing I/O that results in
program-controlled interruptions (PCls), and you are tracing I/O or CSW activity, some of the PCls may not be traced. This situation
arises when the system is extending its free storage area and the
additional demand on available free storage could cause a system
abend.
13. The PA1 key on a 3270 display terminal shOUld not be pressed with trace all run active while the display screen indicates status as a subsequent CP command entered from the console may result in interleaved output.
section 5. Format of CP Commands 163

FROM user id FROM uS9rid is the response
transferred file
sender.
to the user who
indicating that
TRANSFER
receives
userid is
the
the
is also the response to a
transferred file and userid is
the file was reclaimed.
user who reclaims a
the user from whom FILES TRANSFERRED is also a response you receive when you issue the TRANSFER command.
It is not displayed if you issued the CP SET IMSG OFF command line. Section 5. Format of CP Commands 167

VMDUMP
The VMDUMP command, when used with the VM/lnteractive Problem Control
system Extension (VM/IPCS Extension) program product, dumps storage for
quest virtual machines (that is, the virtual that VM/370 creates
for the virtual machine user). See Usage Note 5. The VM/IPCS Extension
debugs errors, as well as stores and maintains error information about
the virtual machine. The VM/IPCS Extension displays this information at
the user's terminal. VMDUMP provides the VM/IPCS Extension with header
information to identify the owner of the dump; it also maintains dump
information, writes the dump to a spool file, and formats the dump. In
addition to saving the storage contents of the virtual machine, the VMDUMP command also dumps: • virtual program status word (PSW) • General registers • Floating point registers • Control reqisters • storaqe protection keys • Virtual machine type identification • Timer values also provides the user with the ability to send dumps to other
users.
The VMDUMP command, when issued without the Extension
installed, only writes an unformatted dump to a spool file. It does not
format the dump without the VM/IPCS Extension. However, a user may
write routines that perform this function. For more information on the Extension, refer to VML11Q [§g£!§ s!g Bgfgrggf§, Order No. SC34-2019. Except for the *dumpid operand, the user can specify the operands of
the VMDUMP command in any order. The *dumpid operand must be the last
operand specified on the command line.
168 IBM VM/370 CP Command Reference for General Users

Previous Page Next Page

Extracted Text (may have errors)

TRANSFER Use the TRANSFER command to direct your input file to a specified reader
or to re=laim virtual reader files that you spooled to another user. format of the TRANSFER command is:
r
TRANsfer {
SPOOlid} [ To] user i d l CLass c
ALL l From L
spoolid is the input file to be directed to or retrieved from the
named userid. CLASS is the class of input files that are to be transferred. is a one-character alphameric field with values from A
and from 0 to 9.
The c
to Z
ALL that all input spool files are to be transferred. [TO 1 userid FROM is the user to whom the files are to be directed. If the
optional keyword TO is omitted, the userid may not be TO or T.
The file is deleted from your reader if you use this option. {
IISeL id}
ALL
is the user from whom input spool files are to be reclaimed.
ALL may be specified to reclaim input spool files that were
originated by your virtual machine from all users.
The TRANSFER =ommand does not transfer any active spool files. PDR FILE spoolid TRANSFERRED {TO } userid FROM spoolia TO IIser-i:'i is the spool file identification number of the file
that is spooled. The number does not change.
is the response to the user who transferred the file
verifyinq that userid is the recipient of the file. 166 IBM VM/370 CP Command Reference for General Users

FROM user id FROM uS9rid is the response
transferred file
sender.
to the user who
indicating that
TRANSFER
receives
userid is
the
the
is also the response to a
transferred file and userid is
the file was reclaimed.
user who reclaims a
the user from whom FILES TRANSFERRED is also a response you receive when you issue the TRANSFER command.
It is not displayed if you issued the CP SET IMSG OFF command line. Section 5. Format of CP Commands 167

Page 3Section 1. The VM/370 Command Languages click to expand contents

Page 7Section 2. The CP Command Language click to expand contents

Page 13Section 3. CP Command Usage click to expand contents

Page 35Part 2. Reference Information click to expand contents

Page 41Section 5. Format of CP Commands click to expand contents

Page 173Appendix. VM/370 Command Summary click to expand contents

Extracted Text (may have errors)

Help

loading

Extracted Text (may have errors)

Extracted Text (may have errors)