REVIEW TSO Command

REVIEW is a TSO command that provides the capability of viewing a sequential dataset or a member of a partitioned dataset in a full-screen mode, similar to ISPF Browse.

There are several versions on the various editions of the CBT, but I worked with what I think is the original version, from file #300 of CBT version 249.  Review was originally written by Bill Godfrey of the Planning Research Corporation in McLean, VA.  It is currently maintained by Greg Price, a frequent contributor to the Hercules' community.  (For an alternate installation method using a distribution provided by Greg Price, see Alternate Review Install.)

 

Installation

The only change I made to the original material was to place a macro that was located following the assembler source to precede the source, which is a requirement of the F assembler.  I placed the source and the help text together in a single jobstream.  The jobstream - review$.jcl - is contained in the archive review.tgz [MD5: 337852E80D0A71CEE090EE59879909C3].  Download the archive and extract the jobstream (WinZip on Windows/?? or tar on Linux).  Submit the jobstream to assemble and link the single load module for REVIEW into SYS2.CMDLIB and copy the help text into SYS2.HELP.  If you don't have SYS2.CMDLIB defined, you will need to modify the jobstream to specify a different target load library.  Also if you do not have SYS2.HELP defined, you may modify the jobstream to place the help information into SYS1.HELP.

 

Utilizing REVIEW

REVIEW may be also be started with the alias REV.  Since the help text thoroughly documents the functions, I have simply included it here, formatted slightly to improve readibility:

The REVIEW command allows a dataset to be examined at a 3270 terminal in full screen mode.

SYNTAX - 

  REVIEW 'DSNAME' UNIT('UNIT') VOLUME('VOLUME')
     or 
  REVIEW 'FILENAME' FILE

REQUIRED - 'DSNAME' OR 'FILENAME' 

DEFAULTS - NONE 

OPERANDS -

  'DSNAME(MEMBER)' - the dataset to be examined
  'FILENAME' - the DD name allocated to the dataset to be examined

  The first operand is assumed to be a dataset name unless it is followed by the keyword 'FILE'

  FILE - this keyword indicates that the first operand is a DD name, not a dataset name.  This is useful for looking at a temporary dataset or at concatenated libraries.

  A member name may be specified in the first operand after the DD Name if the DD Name is allocated to a PDS.  This allows you to enter 'REVIEW SYSPROC(X) F' to look at member 'X' in whatever PDS is allocated to DD Name 'SYSPROC'.

  VOLUME('VOLUME') - for uncataloged datasets, the volume serial.

  UNIT('UNIT') - for uncataloged datasets, the unit type.  This can be omitted if your session default unit is appropriate.  This operand is ignored if the volume is not specified.

  Program Function Keys used by this command are:

    PFK1 - Top
    PFK2 - Bottom
    PFK3 - End
    PFK4 - not defined by REVIEW
    PFK5 - Find
    PFK6 - not defined by REVIEW
    PFK7 - Up
    PFK8 - Down
    PFK9 - Hex
    PFK10 - Left
    PFK11 - Right
    PFK12 - not defined by REVIEW

The functions of the Program Function Keys may be changed using the PFKN subcommand, but the changes are in effect only until the command ends.  Example: 'PFK6 RIGHT 1' would make PFK6 'RIGHT 1'.

  Subcommands:

    UP - scroll backwards a specified number of records.  If no operand is specified, the 'RANGE' value is used.  This value is displayed in the upper right corner.

    - (minus key) - same as UP

    DOWN - scroll forwards a specified number of records.  If no operand is specified, the 'RANGE' value is used.

    + (plus key) - same as DOWN

    LEFT - scroll to the left a specified number of columns.  If no operand is specified, 80 is used.

    < (less than key) - same as LEFT.

    RIGHT - scroll to the right a specified number of columns.  If no operand is specified, 80 is used.

    > (greater than key) - same as RIGHT.

    TOP - scroll up to the first record.

    BOTTOM - scroll down to the last record.

    BOT - same as BOTTOM.

    LIST - display the specified record number.  This is a relative record number, not a sequence number from the data.

    HEX ON - display the screen in hexadecimal.

    HEX OFF - display the screen in characters (EBCDIC).

    HEX - toggle hex mode; if hex is on, it will be turned off; if it hex is off, it will be turned on.

    FIND - search forward until the specified string is found.  The string does not have to be in quotes unless it contains one or more embedded blanks.  String may be followed by a column number.  If no operand, string from previous FIND is used.

    CAPS - display lower case data in caps.

    ASIS - display lower case data in lower case.

    MEMBER - switch to a specified member within the same partitioned dataset as the current member.

    PFKN - set program function key 'N'.

    SMF ON - if SMF data is being examined, convert the record type, date, and time to understandable format.

    SMF OFF - undo SMF ON.

    SMF - toggles SMF; if SMF is on, it will be turned off; if SMF is off, it will be turned on.

    END - end the command.


I hope that you have found my instructions useful.  If you have questions that I can answer to help expand upon my explanations and examples shown here, please don't hesitate to send them to me:


Return to Site Home Page 


This page was last updated on January 17, 2015 .