Displaying variables


This panel displays a scrollable listing of all TSO variables of the currently executing EXEC, accompanied by all variables found in the BMC AMI Ops Automation LOCAL pool for this EXEC.

In addition, all variables that are contained in the PROFILE, SHARED, PROFILE TEST, and SHARED TEST pool may be shown.

Issuing the primary command V on the COMMAND line of the EXEC Testing Control panel invokes the panel shown in the following figure.

BMC Software ------------------ Variable Selection --------------- BMC AMI OpsA
 COMMAND ===>
 Primary command: Add                Scroll right/left        DATE --- 01/01/30
                                                              TIME --- 14:02:31
 LC CMDS --- (S)elect, (D)elete

      Variable Name                    Pool Value
      _______________________________  LOCL
 _    LINE1                            LOCL PARSE . . . . . . . . . . . . . . .
 _    MTARGET1                         LOCL SYSB
 _    MTARGET2                         LOCL SYSC
 _    MTARGET3                         LOCL SYSD
 _    MTARGET4                         LOCL BADN
 _    MTARGET5                         LOCL ROLF
          ************************* END OF DATA **************************

Two input fields allow you to narrow the focus down to the variables of interest. You can specify a pattern in the column labeled VARIABLE NAME that all variables to be displayed must match; for example, entering IMF* (or IMF for short) displays only all variables beginning with these three characters.

If you enter a pattern that ends with a dash ( - ), you must enter an asterisk after the dash. For example:

IMF-*

The input field in the column titled POOL accepts either a full or a pattern specification for one of the following values:

Value

Interpretation

TSO

Standard REXX or CLIST variable

LOCL

Local BMC AMI OpsA pool

SHAR

SHARED BMC AMI OpsA pool

PROF

PROFILE BMC AMI OpsA pool

SHRT

SHARED TEST BMC AMI OpsA pool

PRFT

PROFILE TEST BMC AMI OpsA pool

For example, specifying P* displays all variables currently contained in the PROFILE and PROFILE TEST pools. This display can be scrolled right and left to show the full value of a variable.

The following line commands can be entered in the input fields in the column labeled LC:

Command

Interpretation

S

Select this variable for update or display .

D

Delete this variable .

The ADD primary command may be used to add additional variables to a particular pool. PROFILE and SHARED variables may be displayed but not deleted or modified. See Overview-for-the-EXEC-Testing-Facility for an explanation of this restriction.

(BMC.AMIOPS.SPE2210)

Displaying SHARED or PROFILE variable values with the VAR primary command 

To use the VAR primary command to review at the values of SHARED and PROFILE variables during EXEC testing, perform the following steps.

  1. Set breakpoints before or after any IMFEXEC statement.  

    BMC Software  --------------------- EXEC Test --------------BREAKPOINTS CHANGED
    COMMAND ===>                                                                   
    EXEC === IMF#09    ID === 12                                 DATE --- 22/07/22
    Options: B - Browse EXEC output                              TIME --- 06:57:28
             C - Conditional Breakpoints   O - OSPI session display                
    Primary Commands:                                                              
        STEP - Single step execution       CONTinue - Execute, stop at breakpoints
        RUN  - Execute without stopping    CANcel   - Terminate execution          
        L    - Locate by line number       Find     - Find string                  
        OFF  - Remove all breakpoints      CMDSHOW ON/OFF -Show/remove this display
        SKIP - Skip current statement      FORCE    - Force terminate EXEC         
        VARON/VAROFF | EXPAND - Variable substitution on current line              
    Line Commands --- Break (A)fter, Break (B)efore, (O)ff                         
             ***************************************************************       
           B->/* REXX     */                                                 00001
                                                                             00002
    _         "IMFEXEC VGET QCASJOBN SHARED"                                 00003
    _   B     "IMFEXEC MSG 'Jobname: "QCASJOBN"'"                            00004
                                                                             00005
              EXIT 0                                                         00006
              /*------------------------------------------------------------ 00007
             *************************** END OF DATA ****************************  

  2. At a breakpoint, issue the VAR command on the COMMAND line and press Enter.

    BMC Software  --------------------- EXEC Test --------------BREAKPOINTS CHANGED
    COMMAND ===> VAR                                                               
    EXEC === IMF#09    ID === 13                                 DATE --- 22/07/22
    Options: B - Browse EXEC output                              TIME --- 07:32:36
             C - Conditional Breakpoints   O - OSPI session display                
    Primary Commands:                                                              
        STEP - Single step execution       CONTinue - Execute, stop at breakpoints
        RUN  - Execute without stopping    CANcel   - Terminate execution          
        L    - Locate by line number       Find     - Find string                  
        OFF  - Remove all breakpoints      CMDSHOW ON/OFF -Show/remove this display
        SKIP - Skip current statement      FORCE    - Force terminate EXEC         
        VARON/VAROFF | EXPAND - Variable substitution on current line              
    Line Commands --- Break (A)fter, Break (B)efore, (O)ff                         
             ***************************************************************       
           B->/* REXX     */                                                 00001
                                                                             00002
    _         "IMFEXEC VGET QCASJOBN SHARED"                                 00003
    _   B     "IMFEXEC MSG 'Jobname: "QCASJOBN"'"                            00004
                                                                             00005
              EXIT 0                                                         00006
              /*------------------------------------------------------------ 00007
             *************************** END OF DATA ****************************  

  3. The contents for all of the SHARED and PROFILE variables are displayed in the Global Variable Diagnostic Tool. 

    BMC Software  ----Global Variable Diagnostic Tool (UNSUPPORTED)--- BMC AMI OpsA
    COMMAND ===>                                                 TGT ===> RJI1     
    Primary command: Add                Scroll right/left        DATE --- 22/07/22
                                                                 TIME --- 07:33:59
    LC CMDS --- (S)elect, (D)elete                                                 
                                                                                  
         Variable Name                    Pool Value                               
         _______________________________  ____                                     
    _    AEWACSA                          PROF .80.........                        
    _    AEWBCSA                          PROF .80.........                        
    _    AEWCCPU                          PROF .95.........                        
    _    AEWDEVU                          PROF .80.........                        
    _    AEWTCPU                          PROF .50.........                        
    _    BBISTEPN                         PROF NONE                                
    _    CNTLTASK                         PROF NONE                                
    _    CSM.ACTIVEFLAG                   SHAR NO                                  
    _    DUMPCLER                         PROF NONE                                
    _    DUMPDSF                          PROF 0                                   
    _    DUMPLCDS                         PROF NONE                                
    _    DUMPMF                           PROF 1                                   
    _    DUMPNDS                          PROF 3                                   
    _    DUMP00                           PROF .SYS1.DUMP00.19.11.36               
    _    DUMP01                           PROF .SYS1.DUMP01.19.13.39               
    _    DUMP02                           PROF .SYS1.DUMP02.19.14.04               
    _    JESWAIT                          PROF 030                                 
    _    JESWATCH                         PROF DONOTWAT                            
    _    LBGCLAS                          PROF MDRAI53                             
    _    LBGCPUH                          PROF 75                                  
    _    LBGCPUL                          PROF 20                                  
    _    LBGIBEG                          PROF NONE                                
    _    LBGIDEC                          PROF 1                                   
    _    LBGIEND                          PROF NONE                                
    _    LBGIINC                          PROF 2                                   
    _    LBGPAGE                          PROF 50                                  
    _    LOGREC                           PROF NONE                                
    _    MVSCALL                          PROF NONE                                
    _    QAGSSTA                          SHAR ADMIN                               
    _    QCASJOBN                         SHAR RJI1                       

Displaying TSO or LOCAL variable values with the VAR primary command 

Use the following REXX (or CLIST) statements in your EXECs to review the contents of TSO and LOCAL variables.

For example, in REXX EXECs, use the SAY statement to display the contents of a variable that is not a SHARED or PROFILE variable. 

ABC = "TSO VARIABLE"     
SAY ABC                  

In a CLIST, use the WRITE statement to show the contents of a variable that are not a SHARED or PROFILE variable.

SET ABC = "TSO VARIABLE"
WRITE &ABC

 

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

BMC AMI Ops Automation 8.3.01