Parameters

data-name
This parameter allows you to specify a data name for the source data to be browsed. This name will be displayed in the Title line of the default Browse panel; if data-name is not specified, no name is displayed on the panel. This parameter must not have any embedded blanks, and its maximum length is 54 characters. This name is stored in ZDSNT in the function pool.
rec-format
The record format of the data to be browsed:
  • F - fixed
  • FA - fixed (ASA printer control characters)
  • FM - fixed (machine code printer control characters)
  • V - variable
  • VA - variable (ASA printer control characters)
  • VM - variable (machine code printer control characters)
  • U - undefined.
rec-len
The record length, in bytes, of the data to be browsed. For variable and undefined record formats, this is the maximum record length. This parameter must be a positive numeric value with a maximum value of 32,760 bytes.

The dialog can hide data during a Browse session by specifying the record length to be less than the actual data being browsed. By doing this, BRIF displays only the data up to the specified record length.

read-routine
A fullword address indicating the entry point of a dialog-supplied read routine. Start of changeIt is recommended that the high-order bit of this value be set ON.End of change See Read routine for more information about this parameter.

If a read-routine displays its own panel, then a CONTROL DISPLAY SAVE should be done at the beginning of the panel and a CONTROL DISPLAY RESTORE should be done at the end.

cmd-routine
A fullword address indicating the entry point of a dialog-supplied routine that processes the BROWSE primary command or any dialog-specific primary commands. Start of changeIt is recommended that the high-order bit of this value be set ON.End of change See Command routine for more information about this parameter. If this parameter is not specified, ISPF initiates a recursive Browse session to handle any request for the BROWSE primary command.

If a cmd-routine displays its own panel, then a CONTROL DISPLAY SAVE should be done at the beginning of the panel and a CONTROL DISPLAY RESTORE should be done at the end.

dialog-data
A fullword address indicating the beginning of a dialog data area. This address is passed to the dialog-supplied routines. If no address is supplied, zeros are passed to the dialog routines. This data area provides a communication area for the dialog.
panel-name
The name of the panel to use for displaying the data. The default is the standard Browse data display panel (ISRBROBA). Refer to z/OS V2R2 ISPF Planning and Customizing for information about developing a customized panel.
format-name
The name of the format to be used to reformat the data. The default is no format. This parameter is provided to support the IBM® 5550 terminal using the Double-Byte Character Set (DBCS).
YES|NO
Specifies whether the data is treated as mixed-mode DBCS data. If YES is specified, the BRIF service treats the data as mixed-mode DBCS data. If NO is specified, the data is treated as EBCDIC (single-byte) data. This parameter is provided to support the IBM 5550 terminal using the Double-Byte Character Set (DBCS).
Start of changeEXTENDEnd of change
Start of changeIndicates that the read routine has been changed to accept record numbers that exceed 99999999.End of change