obrowse - Browse a z/OS UNIX file


obrowse -r xx [file...]


Use obrowse to browse a file in the z/OS® UNIX file system.This command uses the TSO/E OBROWSE command and must be run in the foreground. The 3270 passthrough mode is used to invoke the TSO/E OBROWSE command under OMVS.

You can specify any number of files; the TSO/E OBROWSE command is invoked once for each file. If you do not specify a file name, the main entry panel is displayed. From that panel, you can enter the directory name and file name of an existing file you want to browse. If you are browsing fixed-length records, you must also indicate the record length.

The file name can be absolute or relative. Avoid using single quotation marks or parentheses within the file name.


-r xx
Sets the record length to be browsed for fixed length text files. xx is length. If -r xx is specified, the file is processed as fixed length records. This lets you convert a variable length file to fixed length for viewing.

Environment variables

By default, starting in V1R11, the ISPF browse dialog service is used when browsing z/OS UNIX files. Specify BPXWISHISPF=NO if you want obrowse to use the original dialog service.

Usage notes

  1. You cannot use obrowse if you used rlogin or telnet to access the shell.
  2. obrowse passes the effective UID of its process to the TSO session. If the EUID does not match the EUID of the TSO process, the OBROWSE TSO command will attempt to set the effective UID of the TSO process to that of the shell command prior to loading the file.

Exit values

The TSO/E OBROWSE command was invoked once for each file specified.
Failure because obrowse could not access at least one file because single quotation marks or parentheses were used in the file name.
Failure because obrowse was not able to set 3270 passthrough mode.