Using the test program
This section describes how to modify the contents of a data space by using a test program provided by BMC.
The test program, called BBD9DSIV, is located in the BBLINK library. The test program creates two separate data spaces, then loads test data and waits. The test program is used in the following exercises to illustrate how to modify the contents of a data space.
To change data-space contents
Copy the test program JCL BBD9DSIV from the BBSAMP library into one of your data sets, as shown in the following figure, and then modify the JCL as instructed in the Instructions section.
//BBD9DSIV JOB (ACCOUNT),'YOUR NAME'
//*********************************************************************
//* *
//* This JOB creates two Data Spaces to verify the MAINVIEW *
//* DSPCZ, DSPCSTAT, DSPCINFO, and DSPCDUMP views. *
//* *
//* Element Data Space #1: Data Space #2: *
//* ---------------------------- --------- -------- *
//* Storage Key REFX 8 0 *
//* Data Space Type TYPX BASIC BASIC *
//* Data Space Name DSPNAME $DSPC001 $DSPC002 *
//* Data Space Scope SCOX SINGLE ALL *
//* Storage Reference REFX NO NO *
//* Storage Protect PROX YES NO *
//* Current Size CSIZ default* default* *
//* Maximum Size MSIZ 239 524288 *
//* *
//* The Data Space Name is copied to the first 8 bytes of the *
//* space, and the Data Space Stoken is copied to the second 8 *
//* bytes. *
//* *
//* * Default is the installation defined default maximum number *
//* of blocks. *
//* *
//* The program can be terminated by the operator STOP/P command, *
//* or it will timeout after one (1) hour. *
//* *
//* If the program abends, re-submit the job. If the problem *
//* persists, contact BMC Software Customer Support. *
//* *
//*********************************************************************
//DSIVSTEP EXEC PGM=BBD9DSIV
//STEPLIB DD DISP=SHR,DSN=*prefix*.BBLINK
//*********************************************************************
//* *
//* Instructions *
//* ------------ *
//* *
//* Tailor this JCL as follows: *
//* *
//* 1. Replace the JOB card above with one that satisfies your *
//* installation's standards. *
//* *
//* 2. Change '*prefix*' in the //STEPLIB statement to the high *
//* level qualifier you have used for your BBLINK *
//* distribution libraries. *
//* *
//* 3. Submit this job. *
//* *
//* 4. Check the DSPCZ, DSPCSTAT, DSPCINFO, and DSPCDUMP views *
//* under MainView for z/OS *
//* *
//* Change Activity: *
//* *
//* MMR 250 29 May 1998 Harvey Hartman *
//* - Augmented comments *
//* *
//* BPY2954 14 Nov 1996 Shameem Usmani *
//* BAY3322 - Initial version *
//* *
//*********************************************************************Display DSPCZ in MainView for z/OS, and then submit the JCL that you tailored in the previous step.The owner’s name for our example is BMVSLK1V, as shown in the following figure.
DDMMMYYYY HH:MM:SS ------ MAINVIEW WINDOW INTERFACE (Vv.r.mm) ----------------
COMMAND ===> SCROLL ===> PAGE
CURR WIN ===> 1 ALT WIN ===>
W1 =DSPCZ=============SYSE=====*========DDMMMYYYY==HH:MM:SS====MVMVS====D===37
C Owner Fetch Cur Max
- Name Count ASID K Type Scope Ref Prot Size Size
*MASTER* 15 0001 1 Basic All Ena **** 1617 71617
AAODJ41 1 0054 8 Basic Single Ena Yes 359 359
AAOTSHD 1 0027 8 Basic Single Ena Yes 899 899
APPC 7 0031 1 Basic Single Ena Yes 381K 381K
BITPCC5 8 0068 8 Basic Single Ena Yes 83 62526
BMVSLK1V 2 0018 0 Basic ****** Dis No 2442 2442
CMDJENCH 8 006A 4 Basic Single Ena No 83 62526
CNMNETD 18 0028 6 Basic ****** Ena Yes 512K 512K
CONSOLE 18 00A 0 Basic ****** Ena **** 87589 122K
CSQ3CHIN 1 003D 8 Basic Single Ena Yes 512 512
DC$BBI 1 0013 8 Basic Single Ena Yes 1799 1799When your job is displayed in the Owner Name field, hyperlink on it.In the example shown in the following figure, the DSPCSTAT view is displayed, showing the two test data spaces, DSPCONE and DSPCTWO.
DDMMMYYYY HH:MM:SS ------ MAINVIEW WINDOW INTERFACE (Vv.r.mm) ----------------
COMMAND ===> SCROLL ===> PAGE
CURR WIN ===> 1 ALT WIN ===>
W1 =DSPCZ====DSPCSTAT=SYSE=====*========DDMMMYYYY==HH:MM:SS====MVMVS====D=====2
C DataSpc Owner Fetch HSpac Cast Cur Max
- Name Name ASID K Type Scope Ref Prot Type Out Share Size Size
DSPCONE BMVSLK1V 0018 0 Basic All Dis No ***** **** **** 2442 2442
DSPCTWO BMVSLK1V 0018 0 Basic Single Dis No ***** **** **** 2442 2442From DSPCSTAT, hyperlink on DSPCONE.The DSPCINFO view is displayed, as shown in the following example.
DDMMMYYYY HH:MM:SS ------ MAINVIEW WINDOW INTERFACE (Vv.r.mm) ----------------
COMMAND ===> SCROLL ===> PAGE
CURR WIN ===> 1 ALT WIN ===>
W1 =DSPCZ====DSPCINFO=SYSE=====*========DDMMMYYYY==HH:MM:SS====MVMVS====D====1
-DataSpace- -----DataSpace-----
Name..... DSPCONE STOKEN........... 800054020000008B
Type..... Basic ASTE Real Address 01F26780
Scope.... All Cur Size(4k blks) 2442
Reference Dis Max Size(4k blks) 2442
FProt.... No #of Users........
HiperSpc. ****** ------Storage------
CastOut.. **** Real.............
Share.... **** Expanded.........
Key...... 0 Auxilliary.......
---Owner--- ---Owner Tokens----
Name..... BMVSLK1V STOKEN........... 0000006000000001
ASID..... 0018 TTOKEN(0-7)...... 0000006000000001
ASCB..... 00F88400 TTOKEN(8-15)..... 00000004007E3D20
TCB...... 007E3D20From DSPCINFO, hyperlink on the name DSPCONE.The DSPCDUMP view is displayed, as shown in the following example. You can change the start address and data-space contents from this view.
DDMMMYYYY HH:MM:SS ------ MAINVIEW WINDOW INTERFACE (Vv.r.mm) ----------------
COMMAND ===> SCROLL ===> PAGE
CURR WIN ===> 1 ALT WIN ===>
>W1 =DSPCDUMP==========SYSE=====*========DDMMMYYYY==HH:MM:SS====MVMVS====D====1
Dspc Name.. DSPCONE
Addr Space. BMVSLK1V
Start Addr. 00000000
Size in 4Ks 0000098A
Offset Hexadecimal Character
00000000 E3C8C9E2 40C9E240 C140E3C5 E2E340E3 THIS IS A TEST T
00000010 C8C9E240 C9E240C1 40E3C5E2 E340E3C8 HIS IS A TEST TH
00000020 C9E240C9 E240C140 40E3C8C9 E240C9E2 IS IS A THIS IS
00000030 40C140E3 C5E2E340 E3C8C9E2 40C9E240 A TEST THIS IS
00000040 C140E3C5 E2E340E3 C8C9E240 C9E240C1 A TEST THIS IS A
00000050 40E3C5E2 E3C8C9E2 40C9E240 C140E3C5 TESTHIS IS A TE
00000060 E2E340E3 C8C9E240 C9E240C1 40E3C5E2 ST THIS IS A TES
00000070 E340E3C8 C9E240C9 E240C140 40E3C8C9 T THIS IS A THI
00000080 E240C9E2 40C140E3 C5E2E340 E3C8C9E2 S IS A TEST THIS
00000090 40C9E240 C140E3C5 E2E340E3 C8C9E240 IS A TEST THIS
000000A0 C9E240C1 40E3C5E2 E3C8C9E2 40C9E240 IS A TESTHIS IS
000000B0 C140E3C5 E2E340E3 C8C9E240 C9E240C1 A TEST THIS IS A
000000C0 40E3C5E2 E340E3C8 C9E240C9 E240C140 TEST THIS IS AThe start address is 00000000, and the sample text reads THIS IS A TEST.
This section contains the following topics:
Related topic