TRACEMASTER INSTRUCTIONS

Created on 27/02/2007 16:40:00

EXECUTING & FOLLOWING CODE IN SUB-ROUTINES

==============================================
1) THE SUB-ROUTINE SYMBOL CODE MUST BE IN THE SAME
LIBRARY AS THE PROGRAM YOU ARE TESTING
2) ENTER THE MAIN PROGRAM AS YOU WOULD NORMALLY
3) ENTER THE FOLLOWING COMMANDS
A) XSYM NNNN
WHERE NNNN IS THE SUBROUTINE NAME
IF THIS WORKS, SKIP TO D
B) LOAD NNNN
WHERE NNNN IS THE SUBROUTINE NAME
C) XSYM NNNN
WHERE NNNN IS THE SUBROUTINE NAME
D) AT NNNN
WHERE NNNN IS THE SUBROUTINE NAME
THIS WILL SET A BREAKPOINT WHERE-EVER
THE SUBROUTINE IS EXECUTED
E) HIT F10 TO EXECUTE TO THE FIRST BREAK-POINT
F) FOR SUBROUTINES WITHIN SUBROUTINES
1) WAIT UNTIL YOU ARE IN THE FIRST SUBROUTINE
2) OR USE XSYM NNNN YYYY FORMAT, WHERE YYYY IS THE 2ND

/var/www/apps/conversion/tmp/scratch_2/275016509.doc
Page 1 of 6

TRACEMASTER INSTRUCTIONS

Created on 27/02/2007 16:40:00

PREPARATION STEPS TO FOLLOW BEFORE ON-LINE TESTING

=======================================================
1) THIS WILL BE REQUIRED UNTIL THEY CHANGE THE ENDEVOR
OPTIONS TO DO THIS AUTOMATICALLY
A) SET UP A NEW ENDEVOR MEMBER, WITH THE SAME NAME
AS THE PRODUCTION ON-LINE PROGRAM, BUT WITH A
TYPE OF "OPT"
B) ENTER THE INFORMATION AS INDICATED BELOW. CHANGE
THE NAME AS NECESSARY (COPIED FROM CDP527)
*********************************************************************
** POSITION 1 MUST BE BLANK
** POSITION 2 - 9 STEP DESCRIPTION IE.ASM,DB,CICS,LINK,COB,CII,CLE
** POSITION 10 - 11 BLANK
** POSITION 12 - 55 OPTIONS GO HERE LAST POSITION SHOULD BE A COMMA
*********************************************************************
CLE
RENT
LINK
RENT
2) YOU WILL NEED TO CREATE YOUR OWN SYMBOL LIBRARY. CLONE
TRACEMASTER SYMBOL LIBRARY: "NT.SMS.TRACEMST.SOURCE"
NEW SYMBOL LIBRARY: "QM76.TRACEMST.SOURCE"
(RECOMMENDED NAME FORMAT)
3) GET A SOURCE CODE PRINT OF THE PROGRAM. YOU DO NOT NEED
A COMPILE LISTING. OPTION 3.6 SHOULD BE SUFFICIENT.
======> STEP 4 INSTRUCTIONS ASSUME YOU ARE COMPILING UNDER COBOL MVS
======> IF YOU ARE NOT, THE "LE" REFERENCES SHOULD BE REMOVED
4) COMPILE THE PROGRAM. YOU WILL HAVE TO CHANGE THE PROCESSOR
GROUP NAME, REPLACING THE LAST 2 CHARACTERS WITH A "M4". FOR
EXAMPLE, PROCESSOR "CLENBLX0" BECOMES "CLENBLM4". YOU CAN
COMBINE THIS ACTION WITH STEP #1, PROVIDED THAT YOU ADD THE
"OPT" VERSION FIRST. ONCE COMPLETE, I RECOMMEND THAT YOU
CHECK THE COMPILE LISTING. GO DOWN TO THE BOTTOM, THEN BACK
UP & CHECK THE LINKAGE OPTIONS. YOU WANT TO SEE "REENT" AND
"REUSE" BOTH SET TO "YES". IF YOU DON'T, YOU DID SOMETHING
WRONG. IF SO, FIX & REPEAT.
5) COPY/RENAME THE PROGRAM AS YOU USED TO DO. FOR EXAMPLE,
"CDP572" WILL BE COPIED TO THE TEST IMS LIBRARY AS "TST572"
THE FROM/TO LIBRARY NAMES ARE:
FROM: "SP.NDV.NT.STD.LINKLIB.IMS.LE"
TO: "IMSVS.LE.TPPGMLIB"
6) LOCATE THE PROGRAM(S) YOU ARE TESTING IN THE NORMAL SYMBOL
LIBRARY, AND COPY THEM TO THE ONE YOU CREATED. HOWEVER,
YOU WILL NEED TO CHANGE THE NAME, GIVING ALL PROGRAMS
A PREFIX OF "TST". THIS IS NECESSARY, SO THAT THE SYMBOL
NAME MATCHES THE SCREEN NAME, AND IS THE REASON WHY YOU
/var/www/apps/conversion/tmp/scratch_2/275016509.doc
Page 2 of 6

TRACEMASTER INSTRUCTIONS

Created on 27/02/2007 16:40:00

NEED THE NEW LIBRARY

YOU ARE NOW READY TO START ON-LINE TESTING
******************************************

STEPS TO FOLLOW FOR ON-LINE TESTING USING TRACEMASTER

=======================================================
1)

IN TSO A, SET UP A SESSION.

TYPE: "TSO TMASTER"

ON THE COMMAND LINE

2)

SELECT OPTION 0

3)

CHANGE THE "CURRENT LIBRARY DEFINITIONS" TO MIMIC

THE FOLLOWING, USING YOUR USER ID. YOU WILL HAVE
TO ENTER THE OPTIONS INDIVIDUALLY,
CURRENT LIBRARY DEFINITIONS:
ASR . . . . . . .'QM76.XTASR'
TEST PROFILES . .'QM76.XTPROF'
MACRO . . . . . .'QM76.XTMACLIB'
SYMBOLS . . . . .'NT.SMS.TRACEMST.SOURCE'
TIOFILE . . . . .'QM76.TIOFILE'

4)

CHANGE THE "SYMBOLS" LIBRARY NAME ABOVE TO BE THE

ONE YOU ARE USING FOR ON-LINE TESTING.

5)

NOW, SELECT OPTION 7: "SELECT IMS ID"

A) ENTER AN "S" TO THE LEFT OF THE LINE THAT REFERENCES
THE AMVS REGION. HIT "ENTER"
B) YOU SHOULD NOW SEE AN "S" TO THE RIGHT OF THE "IMS ID"
COLUMN (IF IT IS ALREADY THERE, YOU CAN SKIP THESE STEPS)

6)

BACK OUT TO THE "TRACEMASTER - PRIMARY MENU"

7)

SELECT OPTION 3 (IMS/DC)

A) CHANGE THE TRAN CODES, PSB NAMES, MPP AND SYMBOL LIBRARY
NAMES AS NECESSARY
1)
2)
3)
4)

THE
THE
THE
THE

TRAN CODES ARE USUALLY IN THE FORMAT: TT527 (EX)

PSB NAME IS USUALLY IN THE FORMAT: TST527 (EX)
MPP LOAD LIBRARY #1: 'IMSVS.LE.TPPBMLIB'
TRACEMASTER SYMBOL LIBRARY: 'QM76.XTSYMLIB'

B) HIT "ENTER"

/var/www/apps/conversion/tmp/scratch_2/275016509.doc
Page 3 of 6

TRACEMASTER INSTRUCTIONS

Created on 27/02/2007 16:40:00

STEPS TO FOLLOW FOR ON-LINE TESTING USING TRACEMASTER

=======================================================
8)

AT THIS POINT YOU ARE STARTING TO TEST THE PROGRAM. IF YOU

HIT ENTER ENOUGH, YOU WILL EVENTUALLY SEE THE PROGRAM SOURCE
CODE. AT THAT POINT YOUR MACHINE WILL FREEZE.
A) HIT RESET (ESCAPE)
B) GO TO THE MAIN SESSIONS MENU

C) CHANGE THE "NEXT APPLICATION" ID TO "PF22" OR ANY OTHER

PF KEY YOU DESIRE. THIS WILL MAKE SWITCHING BETWEEN
THE ON-LINE SCREEN & THE TRACEMASTER WALK-THRU MUCH EASIER.
D) NOW ENTER IMSTEST (#13); TYPE: /TEST MFS TO ACCESS THE
TEST SCREENS; AT THIS POINT YOU CAN DO ONE OF THE FOLLOWING
1) ENTER THE MAIN IMSTEST MENU, AND SELECT THE SCREEN
NAME THAT WILL TAKE YOU TO THE SCREEN THAT YOU WANT
TO TEST (ALL OTHER IMS SCREENS WILL BE TREATED NORMALLY)
OR
2) TYPE "/FOR XXXXXXXXX", WHERE 'XXXXXXXX' IS THE
SCREEN NAME FOR THE IMS TRANSACTION THAT YOU WANT TO TEST.
FOR EXAMPLE, TYPING "/FOR CDT527A2" WILL DIRECTLY TEST
THE TST527 SCREEN.
E) WHEN YOU HAVE ENTERED THE NECESSARY INFORMATION FOR THE
TRANSACTION YOU ARE TESTING, THE SYSTEM WILL AGAIN FREEZE
('SYSTEM' WILL APPEAR AT THE BOTTOM OF THE SCREEN)
HIT RESET (ESCAPE) TO REGAIN CONTROL
F) NOW USE THE PF KEY YOU SELECTED IN STEP C TO SWITCH BACK
TO THE PROGRAM. HIT ENTER (IF NECESSARY), AND THEN WALK
THRU THE PROGRAM AS IN ANY OTHER TRACEMASTER SESSION.
G) WHEN TRACEMASTER FINALLY TRANSFERS CONTROL BACK TO IMSTEST,
THE SYSTEM WILL AGAIN FREEZE UP. USE THE PF KEY AGAIN TO
SWITCH TO THE IMS SESSION FOR REVIEW OR OTHER ACTIONS.
9) TO END THE TRACEMASTER TEST
A) GO BACK TO THE IMS SCREEN
B) CLEAR THE SCREEN
C) TYPE "TMEITS20" & HIT ENTER
D) THE SCREEN SHOULD NOW DISPLAY A LIST OF THE IMS TEST REGIONS
E) ENTER "P" TO THE LEFT OF YOUR SESSION (LOOK FOR YOUR ID)
F) NOW TOGGLE BACK TO THE MAINFRAME (USING THE PF KEY)
G) YOU SHOULD SEE A MESSAGE TO THE EFFECT THAT YOU TEST
/var/www/apps/conversion/tmp/scratch_2/275016509.doc
Page 4 of 6

TRACEMASTER INSTRUCTIONS

HAS ENDED

/var/www/apps/conversion/tmp/scratch_2/275016509.doc
Page 5 of 6

Created on 27/02/2007 16:40:00

TRACEMASTER INSTRUCTIONS

Created on 27/02/2007 16:40:00

STEPS TO FOLLOW FOR ON-LINE TESTING USING TRACEMASTER

=======================================================
10)

EMERGENCY EXITS
A) GO TO THE MAIN MENU (USING THE PF KEY, OR /M; IF NECESSARY,
BLANK OUT THE SCREEN YOU ARE ON FIRST)
B) TYPE END 13 TO END THE IMS TEST SESSION
C) TYPE END 1 TO END THE AMVS SESSION
D) NOW RE-ENTER AMVS, FIGURE OUT WHAT YOU DID WRONG, AND
TRY, TRY AGAIN

/var/www/apps/conversion/tmp/scratch_2/275016509.doc
Page 6 of 6