Example 1:
This example establishes an enabled SLIP trap with an ID of 0002.
It requests an SVC dump (by default) if there is an 0C4 program check
interruption while module MOD01 and job JOBXYZ are in control.
SLIP SET,ENABLE,ID=0002,COMP=0C4,ERRTYP=PROG,JOBNAME=JOBXYZ,
LPAMOD=MOD01,END
Example 2:
This example sets up an error event (non-PER) trap with an ID of
DUM1 that suppresses all SYSABEND dumps for the 806 system completion
code.
SLIP SET,COMP=806,ID=DUM1,ACTION=NOSYSA,END
Example 3:
This command sets an instruction fetch PER trap that will cause
an SVC dump when the instruction at CD3100 is executed. PER monitoring
will be active in all address spaces in the system because neither
ASID nor JOBNAME was specified.
SLIP SET,IF,ENABLE,ACTION=SVCD,RANGE=CD3100,END
Example 4:
This example sets up a trap for a successful branch trace of the
path taken through the LPA module MOD01 starting at offset 108 (hex)
through 4FC during the execution of JOBX. After 20 standard SLIP
records have been written the trap is automatically disabled.
SLIP SET,SBT,ENABLE,ID=PER1,LPAMOD=(MOD01,108,4FC),JOBNAME=JOBX,
ACTION=TRACE,MATCHLIM=20,END
Example 5:
This command defines a trap that will cause an SVC dump when storage
location CD3010 is altered. MATCHLIM is 1 and PRCNTLIM is 10 by default.
SLIP SET,SA,ENABLE,ACTION=SVCD,RANGE=CD3010,END
Example 6:
This example sets up two SLIP traps, both initially disabled, and
then enables them both with a SLIP MOD command. The second trap prevents
the first trap from matching for the subset of instructions specified
by LPAMOD.
SLIP SET,IF,DISABLE,LPAMOD=(MODX,110,1FB),JOBNAME=JOB1,MATCHLIM=500,
ACTION=TRACE,TRDATA=(STD,REGS),END
SLIP SET,IF,DISABLE,LPAMOD=(MODX,1C4,1D7),ACTION=IGNORE,END
SLIP MOD,ENABLE,ALL
Note: The IGNORE trap is specified after the non-IGNORE trap because
traps are processed for match tests in last-in, first-out order.
Example 7:
The SLIP trap will match on a branch instruction into LPA module
MODZ starting at offset 220 (hex) through 240. When the trap is matched,
the actions specified in the REMOTE parameter will be performed unconditionally.
Systems SYS1 and SYS2 will be placed into a restartable wait state.
System SYS3 will schedule an SVC dump. The dump for system SYS3 will
include address spaces 3 and 4. The local system will also schedule
an SVC dump. The dump for this system will include address spaces
0 and C.
SLIP SET,SBT,ACTION=SVCD,ASIDLST=(0,C),LPAMOD=(MODZ,220,240),
REMOTE=(UNCOND,(SYSLIST=(SYS1,SYS2),ACTION=WAIT),
(SYSLIST=(SYS3),ACTION=SVCD,ASIDLST=(3,4))),END
Example 8:
The SLIP trap does not contain the parameters ASIDSA or DSSA. Normally,
message IEE604D would be issued; however, because the OK parameter
is also specified, SLIP will continue processing without issuing the
WTOR.
SLIP SET,SA,OK,RANGE=(1000,2000),END
Example 9:
This example
and the next show how to use the STOPGTF parameter. This one stops
GTF tracing when the instruction at offset 50 in module MYMOD is executed.
In this case, the GTF records originate from some source, perhaps
other than SLIP:
SLIP SET,IF,PVTMOD=(MYMOD,50),ACTION=STOPGTF,END
Example 10:
Like the previous example,
this example shows how to use the STOPGTF parameter. This example
stops GTF tracing when the instruction at offset 50 into module MYMOD
is executed. With ML=100 specified, only 100 trace records are written,
after which the SLIP trap is disabled, and all GTF tracing is stopped:
SLIP SET,IF,PVTMOD=(MYMOD,50),ACTION=(STOPGTF,TRACE),ML=100,END
Example 11:
This example shows
how to use the GTFID parameter. In this example, the operator starts
two GTF instances HM1 and HM2. When a unit of work takes an abend
with code FFFx, the SLIP trap deactivates the instance HM1, leaving
HM2 active:
START GTFX.HM1
START GTFX.HM2
SLIP SET,C=FFF,A=STOPGTF,GTFID=(HM1),E
Example 12:
This example shows
how to use the SUBTRAP parameter. When the first instruction in IEFBR14
is executed, a PER interrupt occurs and the SLIP action processor
tries to determine whether trap TRP1 is a match. If it matches, a
trace record is generated and no further action is taken; otherwise,
the SLIP action processor checks whether TRP2 matches:
SLIP SET,IF,LPAMOD=(IEFBR14,0),A=SVCD,ID=TRP2,E
SLIP SET,IF,DATA=(1R,EQ,0),A=(SUBTRAP,TRACE),ID=TRP1,E
Example 13:
This example shows
how to use the MSGID parameter. This trap matches on the command response
from the DISPLAY TIME command:
IEE136I LOCAL: TIME=16.37.02 DATE=2001.102...
where the significant time is hour 16 (meaning the time is between
4:00 and 4:59 p.m.):
SLIP SET,MSGID=IEE136I,DATA=(3R?+14,EQ,F1F6),ACTION=WAIT,ML=1,END
Example 14:
This example shows
how to use 64-bit addresses on the RANGE parameter. It requests a
dump when the first above-the-bar page is modified by job TEMP5:
SLIP SET,SA,ASIDSA=(SA),RANGE=(1_00000000,+FFF),ACTION=SVCD,JOBNAME=TEMP5,END
Example 15:
This example shows how to include
a small amount of above-the-bar virtual storage as part of the summary
dump capture phase, which is captured synchronously under the unit
of work that took the PER interrupt, and a larger portion as part
of the non-summary dump phase. Note that there is a limit on the
amount of storage that can be captured in the summary dump phase:
SLIP SET,IF,PVTMOD=(MYMOD,13E),SUMLIST=(6G!,+FFF),LIST=(1_00000000,2_00000000),END
Example 16:
This is an example of a REMOTE LIST,
which can be used to dump storage in the address space whose jobname
is TEMP5:
SLIP SET,IF,PVTMOD=(MYMOD,13E),
REMOTE=(ACTION=SVCD,LIST=('TEMP5'.1_00000000,2_00000000,100000,+FFF)),
ACTION=SVCD,END
Example
17:
This is an example of using 64-bit operands in the TRDATA
keyword. Eight bytes of data are fetched from address 1_00000000;
the resulting address is used to fetch another 8 bytes, which is used
as the starting address to capture
X'10' bytes of storage
in a trace buffer:
SLIP SET,IF,PVTMOD=(MYMOD,13E),ACTION=TRACE,TRDATA=(1_00000000!,+10),ML=1,END
Example 18:
This example shows how to compare
data in bits 32–64 of register 6 (the default), but ensures that bits
0–31 of register 6 are zero:
SLIP SET,IF,PVTMOD=(MYMOD,1A6),DATA=(1_00100000,EQC,6G),ACTION=WAIT,END
Example 19:
This example is similar to the previous
example, except that the order of the values specified on EQC is reversed.
This SLIP trap compares data in all 8 bytes of register 6 (the default):
SLIP SET,IF,PVTMOD=(MYMOD,1A6),DATA=(6G,EQC,1_00100000),ACTION=WAIT,END
Example 20:
This example compares four bits of
data starting at bit 10 in register 6 with the data at address 1_00101000
starting at bit 10:
SLIP SET,IF,PVTMOD=(MYMOD,1B2),DATA=(6G(10),EQC(4),1_00101000),ACTION=WAIT,END
Example 21:
This example compares two bits of
data starting at bit 2 at the specified address with a constant:
SLIP SET,IF,PVTMOD=(MYMOD,1B2),DATA=(1_00101001(2),EQ,10),ACTION=WAIT,END
Example 22:
This example stores eight bytes from
1_00000000 into the buffer addressed by register 7:
SLIP SET,IF,PVTMOD=(MYMOD,1B2),REFBEFOR=(7G!,EQC(8),1_00000000),
ACTION=(REFBEFOR),END
Example 23:
This
example moves eight bits starting from bit position 4 at 1_00101000
to bit position 4 of register 6:
SLIP SET,IF,PVTMOD=(MYMOD,1B2),REFBEFOR=(6G(4),EQC(8),1_00101000),
ACTION=(REFBEFOR),END