VIEW command

Summary

Privileges

Any user can specify a VIEW command for any parameter, except where noted. For example, only the system manager or the system administrator can specify VIEW ERRORS.

Function

Displays the current settings of one or more Model 204 parameters or sets of parameters

Syntax

VIEW [parameter | parameter-set] ...

Where:

parameter	is a Model 204 parameter.
parameter-set	is a set of Model 204 parameters of a particular type (see the discussion below).

Syntax notes

If no parameters or parameter sets are specified in the command, Model 204 displays the settings of all parameters.

Individual parameter names can be interspersed with parameter set names, in any order, except for ERRORS, which must appear last.

VIEW ERRORS

VIEW ERRORS displays error messages that have been issued for SNAPs or error messages that have the SAVE option set. The SAVE option can be set by the MSGCTL command. VIEW ERRORS can be specified only by the system manager or system administrator. VIEW ERRORS is different from other VIEW commands in that it doesn't really display parameter values but instead displays error messages that have been issued.

Example

VIEW OUTLPP OUTLPP 60 OUTPUT LINES PER PAGE

Usage notes

• The VIEW command displays the current settings of any number of Model 204 parameters or sets of parameters.

Model 204 parameters, with exceptions such as ERRLEN and ERRSAVE, can be specified in the VIEW command. Parameters can be specified in any order.

• You can also display the file and storage information described in the table below when you specify the following values with VIEW.

  VIEW command special parameters

  Value you specify with VIEW or $VIEW	Information displayed
  DTSLBOPR	TBO files: Date and time a transaction is backed out during ROLL FORWARD processing. Non-TBO files: Date and time a partial transaction is applied during ROLL FORWARD processing.
  DTSLCHKP	Date and time of last checkpoint rolled back to. Will be blank if the file has also been rolled forward.
  DTSLDKWR	Date and time of last DKWR
  DTSLRCVY	Date and time of last recovery
  DTSLRFWD	Date and time of last ROLL FORWARD
  DTSLUPDT	Date and time of last update
  FIWHEN	Date and time FISTAT was reset
  FIWHO	Terminal ID that reset FISTAT

Viewing parameter sets

One or more sets of parameters also can be specified in the VIEW command. Valid set names are listed in the following table.

Parameter sets viewable with VIEW

Set	Meaning
ALL	All parameters
CWAIT	System parameters associated with the Model 204 scheduler
ERRORS	Error messages that accompany SNAPs or error messages that have the SAVE option set. The SAVE option can be set by the MSGCTL command. (This parameter can be specified only by the system manager or system administrator.)
FPARMS	File characteristic parameters
TABLES	File table parameters
SYSTEM	System parameters
USER	User parameters, including those that can be reset by the user
UTABLE	User table parameters that determine how complex a request you can run

You can display these values individually by specifying them by name in the VIEW command (for example, VIEW STORMAX or when the ALL or the SYSTEM option of the VIEW command is selected).

The VIEW FPARMS and VIEW TABLES commands display information about the default file. They must be issued in file context-that is, the current default must be a file, not a group. If these commands are issued in group context, the null string is returned. If a user does not have the correct privilege, use of the VIEW command to display restricted file parameters generates an error message.

Viewing in Parallel Query Option/204

In PQO, the VIEW command is not reliable for all file parameters. In remote file context, reliable VIEW command results are guaranteed only for the following parameters:

ASTRPPG

ATRPG

CURFILE

CURLOC

FICREATE

FILEORG

FITRANS

HASHKEY

LOCATION

OPENCTL

RECSCTY

SORTKEY

Similarly, for VIEW FPARMS or VIEW TABLES commands in remote file context, correct information is guaranteed only for the file parameters listed in the previous table.

For examples of remote file context VIEW command displays for individual file parameters, see the Parallel Query Option/204 User's Guide.