Xray
Free Trials
Current Release Levels
 
Call for more information:
 417 882 8012

 

Join the MacKinney Systems
monthly ezine list

Email address:

Xray Enhancements
Release 6.7 XRAY V6.7 is now available for use in the following environments:
DOS/VSE, z/VSE - CICS 1.7, CICS 2.1 - 2.3, TS 1.1
OS/390, z/OS - CICS 1.7 - CICS 4.1, TS 1.1 – 3.1

As well as consolidating fixes for all known problems, version 6.7 incorporates the following enhancements:
  64-bit instruction set and addressing: Full support for the 64-bit instruction set is incorporated together with the ability to reference and display data held in 64-bit storage.
  Improved COBOL support: Variables are now displayed on the stop display for additional COBOL verbs e.g. CALL. New versions of the Enterprise COBOL compiler are fully supported.
Improved PL/1 support:  PL/1 support has been improved so that the variables acted on by the current statement are displayed in a data window on the Stop display.
New versions of the Enterprise PL/1 compiler are fully supported.
Group command enhancement:  The data type of the items displayed on a Group display is now shown at the right hand end of the display.
PF key changes:  The text displayed next to PF key assignments has been shortened to permit more keys to be displayed on the PF key line.
Each user can now customize the keys that will be used for the various key related commands. This permits the association of a single key to a command rather than a pair of keys as at present.
Scroll commands:  Additional scroll commands, Up, Down, Backward and Forward have been introduced and standardized across all displays to permit more flexible scrolling through source and data displays.
Change logging: A system administrator can update the XRAY system control file to define the transient data destination to which storage area changes are logged. This facility also permits the suppression of change logging.
Source management: The source processor has changed to accept a PARM parameter to permit multiple copies of the source and link data for the same program to be held on the source file. The source processor also performs more precise checks on the compiler options selected to ensure they are adequate to permit extraction of information needed by XRAY.
The source processor will also issue warning messages and terminate with a return code of 4 when certain sections of the listing cannot be detected.

The source file maintenance program will copy and delete multiple versions of source data.

During debugging, XRAY will select the version of source and link data that matches the version of the program in use.
  Sub-task monitoring: At the start of the debugging session, it is now possible to indicate to XRAY whether monitoring is to be restricted to the main task or to include sub-tasks. When sub-task monitoring is selected a halt will occur each time a sub-task attach request is detected at which point the programmer can decide whether to monitor a particular sub-task or not. All subsequent stop displays indicate the sub-task to which the halt relates.
Register display:  The register display command now displays one register per line identifying the register number in each case. The display automatically switches from 32 bit to 64-bit after the use of any 64-bit instruction.
Cancel command:  The CANCEL command can now be abbreviated to CAN to cancel a transaction.

Download Xray 6.7 upgrade


Release 6.6 Source Management: 
Changes format of the data held on the source file to improve manageability of source and link information.

Restructures the source processor to reduce the storage required to execute it.  Adds a new ‘list only’ feature initiated via a PARM parameter on the EXEC statement to create a listing even if a fatal compile error occurs. Updates all sample JCL to incorporate this feature via conditional JCL.

The source file maintenance program converts old format source data into the new format when a file restore run executes.  Instead of deleting records when backing up the file, all records are backed up and data is deleted during the restore process. A new COPY enables data to be copied from one source file to another. This permits migration of programs between test environments without recompilation.
New Data Window Options:
Display data in data windows in more formats.  In addition to the existing hex dump and decimal dump formats, display data by value or as hex only. These formats are similar to those currently used for keep items. Control the format of data displayed in windows by additional items on the User Preferences display.
Stop Display Customization:
Adds options to vary the format and contents of the STOP display.  Fix the data window at the bottom of the display or place immediately after the current statement. The window can contain variables from the current program statement, keep items or both variables and keep items. Use the User Preferences display to control the contents and position of the window.  Use the WINDOW command to vary the contents of the window temporarily.
Mixed Case Displays:
Set Xray displays to mixed or upper case with an option on the User Preferences display. By default, displays are in mixed case.  Change the default temporarily with the CASE command or permanently using the User Preferences display.
Scrolling: 
Control the distance a display moves when a scroll key is pressed with a new User Preference option. The distance may be either a full page or to the current position of the cursor within the display. Use the SCROLL command to change the scroll distance on a temporary basis.
Improved Halt Delete Facilities:
Changes the format of the Delete Halt Points display (fastpath =7.3) allowing all halts for a particular program or module to be deleted. Displays additional lines for each unique program or module where halts are set, then deletes all halts for the program or module when these lines are selected by cursor positioning.
Group Command Enhancement:
Use the FIND/UFIND and RFIND commands to position the display by searching for a variable whose name contains a given string.
Keep Command:
Set keep items by positioning the cursor on the STOP display and pressing PF6.  For Assembler programs, keep items set via a source display get locator information from the object code for the statement from which it is selected.
Improved PL/1 Support:
Display variables and set keep items using the ZOOM and KEEP keys on source displays.
Step Enhancements:
Execute ‘n’ number of statements before the next step halt using the command STEP=n.
Code Re-Organization:
Reorganizes Xray’s internal structure to reduce storage requirements and enhance maintainability.

Release 6.5 Keep item enhancements:
  • Retains KEEP items across executions of the program.
  • Displays data on separate line if the text used to define the item exceeds 19 characters.
  • Delete keep items by positioning the cursor and hitting PF5.
  • Allows Keep items to contain more complex variable definitions.
  • Set Keep items by positioning the cursor on the STOP source display and pressing PF6.
  • Set Keep items by positioning the cursor on the Group display and pressing PF6
Introduces an optional session file to save halt and keep item definitions in order to retain them across sessions. If the file exists all monitor definitions are written to the file and restored when the program is next tested under XRAY.

Restores halts as un-initialized until the program to which they relate is executed and appear in yellow rather than green on displays.

Controls the initial presentation of various displays with a new User Preferences menu option. The capabilities provided under this option will be further enhanced in a subsequent version of the product.
Displays data in dump format with hex offsets or decimal format with decimal offsets. Decimal display format offset values are decimal numbers. Indicate hexadecimal values using the notation Xnnn or Hnnn.
Displays the whole of working storage by type G or WS in the command field.
Allows the ZOOM feature on source displays when the working storage section of a COBOL program is displayed. Use LEFT and RIGHT function keys to position the displayed source.
Provides an indirect display of data via storage displays by positioning the cursor and pressing the ZOOM key.
Halts on return to the calling module if a called module is stepped into and the PF12 used to continue. This also happens if an unexpected halt occurs in a called module. Note: Link data must be available for the program.
Improves variable processing Handles more levels of indirection on PL/1 based variables and to permit subscripts to also be based.
Displays bit variables in bit format.
Displays COBOL index variables as a logical value as well as an offset.
Issues new message to report when the system detects the link data on the source file doesn’t match the executable phase.
Improves source processor storage management to cause storage to be acquired incrementally. For VSE systems this requires a JCL change to specify SIZE=AUTO instead of SIZE=(AUTO,nnK) as storage is now acquired from the Getvis area.
Adds a new command UFIND to permit a backward string search from the current source statement or from the currently displayed offset of a storage area.

Release 6.4 Adds KEEP command and display. Allows for definition of a list of variables to display at each program stop point.
Adds a USER= parameter on the batch XRAY control statement to ensure only the designated user can connect to the batch job from a CICS XRAY session.
Improves handling of multi-CSECT Assembler programs. Enables halts to be set in any program CSECT via the source display. Name primary un-named CSECTs via PARM information supplied to the source processor.
Corrects a problem with COBOL LENGTH OF statements.
Supports OS/390 TS 1.1 thru TS 1.3 and VSE TS 1.1.

Release 6.3 Identify the user program with PARM data on the EXEC statement in place of an XRAYIN DD statement (MVS) or SYSIPT (VSE).
Adds a new GROUP command to display a COBOL data structure and all sub-items within it. May alter values by over-typing displayed information. Hexadecimal display/change of values supported..
Adds instructions for monitoring DB2 programs to the User Guide (MVS).
Introduces two new variations of the target command (T24 and T31) to specify whether the address being targeted is a 24 or 31-bit address. Permits display of 24-bit addresses from a word containing a non-zero high byte when in 31-bit mode and the display of 31-bit addresses when in 24-bit mode.
Updated User Manual with details of TOP and BOTtom commands
Permits update of the control file rather than recreation when a new system password is required.
Allows source file deletion criteria to be specified as number of days when using the batch utility TRCKSMNT. This permits repeated use of the same deletion jobstream.
Improves session clean-up for LU 6.2 sessions ensuring the session is available for another batch connection.

Release 6.2 Permits testing programs using a future date without changing the CICS system date. Allow automatic halt points when date accesses occur.
Improves Language Environment/370 support for newer COBOL versions.
Adds support for nested programs in COBOL II and COBOL for MVS/VSE.
Displays operand names in the STOP data window.
Adds support for 31 bit I/O and monitoring of authorized programs when key Xray programs are placed in an authorized library.