Trace Master

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
C) XSYM NNNN
D) AT NNNN
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
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
Page 2 of 6
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"
Page 3 of 6
Created on 27/02/2007 16:40:00

=======================================================
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
Page 4 of 6
HAS ENDED
Page 5 of 6
Created on 27/02/2007 16:40:00
Created on 27/02/2007 16:40:00

=======================================================
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
Page 6 of 6

Trace Master

Uploaded by

Copyright:

Available Formats

Trace Master

Uploaded by

Document Information

Original Description:

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Trace Master

Uploaded by

Copyright:

Available Formats

TRACEMASTER INSTRUCTIONS

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

EXECUTING & FOLLOWING CODE IN SUB-ROUTINES

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

PREPARATION STEPS TO FOLLOW BEFORE ON-LINE TESTING

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

NEED THE NEW LIBRARY

STEPS TO FOLLOW FOR ON-LINE TESTING USING TRACEMASTER

IN TSO A, SET UP A SESSION.

ON THE COMMAND LINE

CHANGE THE "CURRENT LIBRARY DEFINITIONS" TO MIMIC

CHANGE THE "SYMBOLS" LIBRARY NAME ABOVE TO BE THE

NOW, SELECT OPTION 7: "SELECT IMS ID"

BACK OUT TO THE "TRACEMASTER - PRIMARY MENU"

SELECT OPTION 3 (IMS/DC)

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

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

STEPS TO FOLLOW FOR ON-LINE TESTING USING TRACEMASTER

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

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

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

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

STEPS TO FOLLOW FOR ON-LINE TESTING USING TRACEMASTER

You might also like