Programmer Guide > Getting Session Information > Calling INFO with No Parameters
  

Calling INFO with No Parameters
When INFO is called without any positional or keyword parameters, it provides an overview of the current state. The information provided is:
*A traceback showing the current procedure and function nesting.
*Amount of code area, number of local variables, and number of parameters. (When PV-WAVE reads a procedure or function for the first time, it compiles it into executable code. Every routine has a code area where the executable code is placed and a data area where information about all locally available variables (including common block variables) resides. The amount of room used in each of these areas is reported to the current routine, along with the number of local variables and parameters.)
*A one-line description of every current variable.
*A description of all currently accessible common blocks.
*The names of all saved procedures and functions.
As an example of a typical PV-WAVE session, the command:
INFO
might result in output similar to:
% At $MAIN$(0).
Code area used: 0.00% (0/30000), Data area used: 4.88% (100/8000)
# local variables (including 0 parameters: 4/250)
# common symbols: 3/8
B BYTE = Array(256)
G BYTE = Array(256)
I BYTE = Array(512, 512)
R BYTE = Array(256)
X(CBLK)	 INT = 0
Y(CBLK)	 INT = 11
Z(CBLK)	 INT = 12
Common Blocks:
CBLK(3)
Saved Procedures:
INTERP_COLORS READ_SRF SHOW3
Saved Functions:
AVG  BILINEAR   CORRELATE   CURVEFIT
This session summary provides the following information:
*The current routine is $MAIN$, meaning that you are currently at the main program level and that no called routine is executing.
*The second and third lines indicate that the code area is empty (zero bytes used out of 30,000 available) and approximately 95% of the data area is also free (100 bytes used out of 8,000 available). The code area is empty because you are currently at the $MAIN$ level and no $MAIN$ program has been entered.
*The fourth line shows how many local variables the current data area can accommodate. It also indicates the total number of local variables including the number of parameters. In this example, 4/250 means that there is space for a total of 250 local variables and only four are currently being used.
*The sixth line shows how many common block symbols are being used and how many there are space for.
*The next seven lines give one-line descriptions of all locally available variables. The first four variables (B, G, I, and R) are local variables, while the other three (X, Y, and Z) are contained in the common block CBLK. Note that the one-line descriptions of scalar variables gives their values, while the descriptions of arrays shows their dimensions. Use the PRINT procedure to look at the contents of arrays.
*Following the descriptions of variables is the list of available common blocks. In this session, the only common block is named CBLK, and it contains three variables.
*The final information printed is the names of all saved procedures and functions.

Version 2017.1
Copyright © 2019, Rogue Wave Software, Inc. All Rights Reserved.