Displaying variables
Issuing the primary command V on the COMMAND line of the EXEC Testing Control panel invokes the panel shown in the following figure.
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:
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 pool |
SHAR | SHARED pool |
PROF | PROFILE pool |
SHRT | SHARED TEST pool |
PRFT | PROFILE TEST 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.
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.
Set breakpoints before or after any IMFEXEC statement.
BMC Software --------------------- EXEC Test ---------------------------------
COMMAND ===>
EXEC === QAOBCMD2 ID === 3 DATE --- 25/08/26
Options: B - Browse EXEC output V - Variable access TIME --- 14:12:03
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 QAOBCMD2 */ 00001
/* DOC GROUP(AO) FUNC(SAMPLE) AUTHOR(BMC) 00002
/* DOC DESC(Sample EXEC to return command response to a batch 00003
00004
/*------------------------------------------------------------ 00005
* Sample EXEC which can be used to send command responses to a 00006
* batch job. 00007
* 00008
* No modifications to this EXEC are required. Copy execs QAOBC 00009
* and QAOBCMD3 to the UBBPROC dataset. 00010
* 00011
* This EXEC is submitted by batch job QAOBCMD1. QAOBCMD1 uses 00012
* TSO to submit QAOBCMD2. Since QAOBCMD2 runs under TSO, it 00013
* contains no IMFEXEC statements. 00014
* 00015
* QAOBCMD2 is passed 2 parameters from the batch job: 00016
* 00017
* 1. SS1 The SSID of the BBI/SS PAS where 00018
* the command should run. 00019
* 00020
* 00021
* 2. COMMAND1 This is the fully qualified 00022
* IMFEXEC CMD statement containing the 00023
* command to be issued by AO. 00024
* 00025
* QAOBCMD2 uses AO Anywhere to invoke EXEC QAOBCMD3 on the 00026
* desired system. The SHARE parameter on the AOEXEC SELECT 00027
* EXEC statement allows the command to be passed to QAOBCMD3 00028
* 00029At a breakpoint, issue the VAR command on the COMMAND line and press Enter.
BMC Software --------------------- EXEC Test ---------------------------------
COMMAND ===>
EXEC === QAOBCMD2 ID === 3 DATE --- 25/08/26
Options: B - Browse EXEC output V - Variable access TIME --- 14:12:03
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 QAOBCMD2 */ 00001
/* DOC GROUP(AO) FUNC(SAMPLE) AUTHOR(BMC) 00002
/* DOC DESC(Sample EXEC to return command response to a batch 00003
00004
/*------------------------------------------------------------ 00005
* Sample EXEC which can be used to send command responses to a 00006
* batch job. 00007
* 00008
* No modifications to this EXEC are required. Copy execs QAOBC 00009
* and QAOBCMD3 to the UBBPROC dataset. 00010
* 00011
* This EXEC is submitted by batch job QAOBCMD1. QAOBCMD1 uses 00012
* TSO to submit QAOBCMD2. Since QAOBCMD2 runs under TSO, it 00013
* contains no IMFEXEC statements. 00014
* 00015
* QAOBCMD2 is passed 2 parameters from the batch job: 00016
* 00017
* 1. SS1 The SSID of the BBI/SS PAS where 00018
* the command should run. 00019
* 00020
* 00021
* 2. COMMAND1 This is the fully qualified 00022
* IMFEXEC CMD statement containing the 00023
* command to be issued by AO. 00024
* 00025
* QAOBCMD2 uses AO Anywhere to invoke EXEC QAOBCMD3 on the 00026
* desired system. The SHARE parameter on the AOEXEC SELECT 00027
* EXEC statement allows the command to be passed to QAOBCMD3 00028
* 00029The contents for all of the SHARED and PROFILE variables are displayed in the Global Variable Diagnostic Tool.
BMC Software ---- Global Variable Diagnostic Tool ---- BMC AMI OpsA
COMMAND ===> TGT ===> JO4C
Primary command: Add Scroll right/left DATE --- 25/08/26
TIME --- 13:33:08
LC CMDS --- (S)elect, (D)elete
Variable Name Pool Value
_______________________________ ____
_ ABCPROF.1 PROF ABC123
_ A71EPAS SHAR A71C
_ A72EPAS SHAR A72C
_ A73EPAS SHAR A73C
_ CSM.ACTIVEFLAG SHAR NO
_ CSMREPDD SHAR CSMRESP
_ DPVOL SHAR BAB317
_ EIMDEBUG SHAR N
_ HSMSYS SHAR CN
_ JB64PAS SHAR JB64
_ JB65PAS SHAR JB65
_ JESPARM SHAR JES2PASC
_ JO71PAS SHAR &JO71PAS
_ MYTESTPROF PROF MYTESTONWEDNESDAY
_ NULLVAL SHAR <NULL>
_ PAGVL01 SHAR VPAGC31
_ PAGVL02 SHAR VPAGC30
_ PLEXCFG1 SHAR MULTI
_ PLEXCFG2 SHAR SYSTEM
_ PREFIX SHAR AAOJO
_ QAGSSTA SHAR OFF
_ QAOARPMN SHAR AAOARP00
_ QAOCSMDB SHAR JO4C
_ QAOCSMRU SHAR NO
_ QAOIMSUN SHAR YES
_ QAOMVAO SHAR JO4C
_ QAOMVSST SHAR ACTIVE
_ QAOREL SHAR 8.4.00
_ QAORIHST SHAR YES
_ QAORULST SHAR ACTIVE
_ QAUDIT SHAR 1
_ QBLANK SHAR
_ QCASCNCT SHAR Y
_ QCASID SHAR JOCS
_ QCASJOBN SHAR AAOJOCAS
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.
SAY ABC
In a CLIST, use the WRITE statement to show the contents of a variable that are not a SHARED or PROFILE variable.
WRITE &ABC