Parameters

data-name

This parameter allows you to specify a data name for the source data to be viewed. This name appears in the title line of the default View panel. It is also the target data name for an edit recovery table entry when edit recovery is active. This name must not have any embedded blanks, and its maximum length is 54 characters. This name is stored in ZDSNT in the function pool.

profile-name

The name of the edit profile to be used. This parameter is required when recovery-request is NO (or is not specified); otherwise, it is not allowed.

rec-format

The record format: F - fixed, V - variable. This parameter is required when recovery-request is NO (or is not specified); otherwise, it is optional, but it must be the same record format that was specified when recovery was initiated for the data.

rec-len

The record length, in bytes. It must be a positive numeric value between 10 and 32 760, inclusive. For variable record format, this is the maximum record length. This parameter is required when recovery-request is NO (or is not specified); otherwise, it is optional, but it must be the same record length that was specified when recovery was initiated for the data.

read-routine

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

cmd-routine

A fullword address indicating the entry point of a dialog- supplied routine that processes the MOVE, COPY, and VIEW primary commands. This routine also processes the CREATE and REPLACE primary commands when the address of a write-routine is specified as a parameter on the VIIF call. It is recommended that the high-order bit of this value be set ON. See Command routine for more information about this parameter. If this parameter is not specified, ISPF processes these commands.

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.

edit-len

The length, in bytes, of the data to be displayed for viewing. This parameter indicates that the data records should be considered to have a length shorter than rec-len during viewing. Thus, the dialog may include data in the record that is not accessible for viewing.

Edit-len must be a numeric value between 10 and 32 760, inclusive, and must be less than or equal to parameter rec-len. Rec-len is the default. If the edit-len parameter is specified, the bytes from (edit-len + 1) to rec-len are not displayed. That means the inaccessible record data is at the end of the record.

The edit-len parameter is optional when recovery-request is NO (or is not specified); otherwise, it is not allowed. The edit-len parameter is not allowed when format-name is specified.

panel-name

The name of the panel to use for displaying the data. This parameter is optional when recovery-request is NO (or is not specified); otherwise, it is not allowed. The default is the standard View data display panel. See z/OS ISPF Planning and Customizing for information about developing a customized panel.

macro-name

The name of the initial macro to be executed. This parameter is optional when recovery-request is NO (or is not specified); otherwise, it is not allowed. The default is no initial macro. See z/OS ISPF Edit and Edit Macros for more information on macros.

format-name

The name of the format to be used to reformat the data. This parameter is optional when recovery-request is NO (or is not specified); otherwise, it is not allowed. The default is no format. This parameter is provided to support the IBM® 5550 terminal using the Double-Byte Character Set (DBCS). This parameter is not allowed when the edit-len parameter is specified.

YES|NO (mixed-mode)

Specifies whether the data is treated as mixed-mode DBCS data. This parameter is optional when recovery-request is NO (or is not specified); otherwise, it is not allowed. If YES is specified, the VIIF service treats the data as mixed-mode DBCS data. If NO (the default) 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).

YES|NO (recovery-request)

Specifies whether to process a pending view recovery that was being viewed with the VIIF service when a system failure occurred. If YES is specified, the edit recovery should proceed. This function is similar to the EDREC service with the PROCESS option. If YES is specified to process the view recovery, you must specify the read routine and write routine, but you must not specify profile name, edit-len, panel-name, macro-name, format-name and mixed-mode. If NO is specified, no edit recovery is processed; VIIF views the specified data.

parm-var

The name of an ISPF variable that contains parameters which are to be passed to the initial macro specified by macro-name. The variable value must not exceed 200 bytes in length. If no macro name is specified, parm-var must be blank or not specified.

write-routine

A fullword address indicating the entry point of a dialog- supplied write routine used to handle the writing of records for the CREATE and REPLACE primary commands. It is recommended that the high-order bit of this value be set ON. If a write-routine is not supplied, ISPF handles the writing of records for the CREATE and REPLACE primary commands. See Write routine for more information about this parameter.

NO|YES (change warning)

Specifies whether a warning message is issued on the first change of data. If you specify YES, the VIIF service gives a warning when the first data change is made, indicating that data cannot be saved in View. If you specify NO, no data change warning is given.

tabname

The name of a user line command table to be used for the view session. The value must be 8 characters, blank padded.