SLIP SET examples

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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