MV VIEW
This command identifies the view to be used for accessing data.
Command | Parameters |
|---|---|
MainView | MV VIEW | NAME(viewname) [STEM(stemname)] [DD(ddname)] [PARMS(parm1...parm2...parmn)] CHANNEL(channelname) |
The following table describes the parameters:
Parameter | Function | Notes |
|---|---|---|
NAME | view name that describes the request | 1- to 8-characters alphanumeric VIEW is an alias for this parameter. |
STEM | stem name of a set of REXX variables containing the view definitions | 1- to 26-characters alphanumeric This parameter may be used to dynamically specify view contents. A root for a set of stem variables is specified. The variable root.0 contains the total count of stem variables. The actual view is contained in the variables root.1 through root. x. The syntax of the specified view is identical to that of the view normally found in the BBVDEF data set. |
DD | DD name to use to access the view from the BBI-SS PAS | 1- to 8-characters alphanumeric Note that members that do not contain <VIEW> and <BASE> statements as the first two lines are ignored. However, the view search continues with the next DD in the view member search order. The view member search order is as follows:
For more information about BBVDEF, refer to the MainView Common Customization Guide. |
PARMS | view parameters as specified with the view name on the command line or in a hyper link | 1- to 80-characters alphanumeric Parameters in parentheses must be enclosed in quotation marks. Note: Commands such as TIME, WHERE, and so on cannot be passed to a view with the PARMS parameter. |
CHANNEL | token that identifies a previously connected channel | 1- to 32-characters alphanumeric |
Condition codes are listed in the following table:
Value | Description |
|---|---|
0 | The view was successfully read and parsed. It is available for subsequent GETDATA requests. |
4 | The specified view could not be read. |
8 | Bad stem variable specified. The specified variables could not be found. |
12 | The specified channel could not be found. |
16 | Syntax error detected or invalid parameters supplied. |
Example
This example shows an EXEC that requests that view JOVER be read and parsed. The view is read from the target BBI-SS PAS. The connection is to use the previously connected channel whose token is contained in the variable JOBCHANNEL.
REXX EXEC example:
CLIST example:
The following example demonstrates how the STEM() parameter may be used to dynamically specify a view:
'ALLOC F(VIEW) DA('BBI26.BAORAE.BBVDEF(PLEX1)') SHR REUSE'
address MVS
'EXECIO * DISKR VIEW (STEM DEFS. FINIS)'
address IMFEXEC
'MV CONNECT MYCHANNEL MSG'
'MV CONTEXT PRODUCT(PLEXMGR) CHANNEL('MYCHANNEL')'
'MV VIEW STEM(DEFS) CHANNEL('MYCHANNEL') VIEW(PLEX1)'
'MV GETDATA CHANNEL('MYCHANNEL') ARRAY(RESULTS) REFRESH'
'MV RELEASE CHANNEL('MYCHANNEL')'
'ARRAY DISC RESULTS NOSAVE'