Information
Limited support BMC provides limited support for this version of the product. As a result, BMC no longer accepts comments in this space. If you encounter problems with the product version or the space, contact BMC Support.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see BMC AMI Ops Monitor for z/OS 6.3.

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.

Warning

Note

The test program terminates automatically after approximately three hours. You can cancel it at any time while it is running.

To change data-space contents

  1. 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                                        *         
    //*                                                                   *         
    //*********************************************************************
  2. 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   1799
  3. When 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 2442
  4. From 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...... 007E3D20
  5. From 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 A

     The start address is 00000000, and the sample text reads THIS IS A TEST.

This section contains the following topics:




 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

MainView for z/OS 6.2