The DEFVIEW control statement adds or modifies logical view definitions:
Syntax:
/DEFVIEW VIEW=vname NUM=vnum USER=userid
FILTER=fname SECURED=N/Y DESC='Up to 40 characters'
DEFAULT=N/Y LOCKLEFT=N/Y DISPCC=Y/N
EXCPAGES=nnn EXCRECS=nnn DISPRECS=nnn
ACL1= AHL1= ACL2= AHL2= ALINES=nn
HSCROLL=N/Y
HEADING=( (rec,pos,len,clr,hlt), or ('text',clr,hlt), ... )
HED1= HED2= HED3= HED4= HED5= HED6=
CLR1= CLR2= CLR3= CLR4= CLR5= CLR6=
HLT1= HLT2= HLT3= HLT4= HLT5= HLT6=
CRINDEX=N/Y
COLUMN=( (pos,len,clr,hlt,hdg),
or ('text',clr,hlt,hdg), ... )
HDGn=( (rec,clr,hlt) or ('text',clr,hlt) ...) )
SEARCH=( (bline,eline,bcol,ecol,op,'text',type,symbol), ... )
INDEX=( (name,line,col,len,extract,leftjust,upper) ... )
Where:
Specifies a 1-32 character name for this view. Using an ASTERISK as the last character makes this a GBL VIEW.
If the VIEW ID (name + number + userid) does not exist in the database, it is added. If it already exists, it is modified. This parameter is required.
Logical view number (1-255).
Specify a 1-8 character userid to make this a private view.
Omit this parameter if this is a public view.
Name of a filter which is applied automatically whenever the view is selected. 1-8 characters. Valid filter characters are limited to alphanumeric, national, and limited special characters.
Specify Y to prevent unsecured DISTIDs from accessing this view in EXP mode. (Secured DISTID access is defined in CA Deliver for each DISTID on the report distribution list)
Default: N
Description that is used to identify the logical view. 1-40 characters enclosed in quotes.
This is the default view for this view name. It is used when a user selects a report through the online V command.
Default: N
The leftmost column of data (as specified as the first entry under the column definitions) can be locked on the display to prevent it from scrolling off during horizontal scrolling.
Default: N
Determines whether carriage controls are included as position one of the online display.
Default: N
Specifies the total number of pages to be excluded at the top of the report (0-999).
Default: 0
Specifies the total number of records to be excluded at the top of the page. This lets you exclude the title and heading records detail is displayed (0-60). The combined value of EXCRECS and DISPRECS cannot exceed 254.
Default: 0
Specifies the number of data records that are contained on a page (0-254). This lets you exclude report footing lines while viewing. Leave blank to display all lines on the page. The combined value of EXCRECS and DISPRECS cannot exceed 254.
Specifies the primary and secondary colors to be used for two alternating groups of report lines. Blank uses default 3270 colors.
B = Blue
R = Red
P = Pink
G = Green
T = Turquoise
Y = Yellow
W = White
Number of lines in each group. (1 to 9).
Specifies the primary and secondary highlight to be used for two alternating groups of report lines. Blank uses default 3270 highlight.
B = Bold
R = Reverse Video
U = Underline
Specifies that the index for this view is a cross-report index.
Default: N
Specifies whether the primary heading line is to remain fixed during left/right scrolling.
Default: N
Primary heading specifications are defined by entries within a table. The HEADING specifications are enclosed within parentheses. In addition, each row in the table is also enclosed by parentheses. Table rows have the following format:
(
(rec,pos,len,clr,hlt) or ('text',clr,hlt), Row-2, Row3, …
)
The number of the record where data is to be extracted.
position within the record to start extraction.
Length of the data to be extracted.
Color to be applied to the heading. See ACL1 for values.
Highlight to be applied to the heading. See AHL1 for values.
Constant text to be included in the heading - This text is to be enclosed in quotes.
Specifies the record number that is used for extracting DEFAULT column headings. (1-99).
Specifies the color attribute for the corresponding heading line. See ACL1 for values.
Specifies the highlight attribute for the corresponding heading line. See HL1 for values.
Data column specifications are defined by the entries within a table. The COLUMN parameter is enclosed in parentheses. In addition, each entry in the table is also enclosed by parentheses.
Table entries have two formats:
(
(pos,len,clr,hlt,hdg#) or
('text',clr,hlt,hdg#), …
)
position within the record extraction the column.
Length of the data column to be extracted.
Color to be applied to the column.
Highlight to be applied to the column.
Constant text to be included in the column - This value must be enclosed in quotes.
Indicates whether an explicitly heading has been defined for the data column. Zero (the default) indicates the column headings will be extracted from the records as specified by the DEFAULT column headings (HED1, HED2, ..). Specify a number between 1 and 99 to identify the HDGn parameter that defines the heading.
Note: To update COLUMN or HDGn definitions for an existing view, you must specify both COLUMN and HDGn definitions.
An explicit column heading for an entry referenced in the COLUMN table. The HDGn parameter is enclosed in parentheses. In addition, each entry in the table is also enclosed by parentheses. Table entries have two formats:
The number of the record where the heading is extracted.
Color to be applied to the heading.
Highlight to be applied to the heading.
Constant text to be included in the heading - This value must be enclosed in quotes.
Note:
The DEFVIEW facility is limited to 99 explicit column headings. If more than 99 are needed, they must be added through the online interface.
To update COLUMN or HDGn definitions for an existing view, you must specify both COLUMN and HDGn definitions.
Specifies the index search specifications.
Index search specifications are defined by entries within a table. The SEARCH specifications are enclosed within parentheses. In addition, each row in the table is also enclosed by parentheses.
Note: To update SEARCH= definitions for an existing view, specify all SEARCH= definitions. All existing table entries are replaced with the new entries.
Table rows have the following format:
( (bline,eline,bcol,ecol,op,'text',type,symbol), (row-2), (row-3),
)
The beginning or only line to be searched for text. The beginning line can be a specific line number from 1 to 255 or a relative line number in the form r+n where r is the reference symbol from an earlier search specification and n is the number of lines from the search specification in the range of 0 to 255.
Note: This is a line number, not a record number. Carriage controls are to be taken into account when specifying a line number.
The last line to be searched for text. The ending line can be a specific line number from 1 to 255 or a relative line number in the form r+n where r is the reference symbol from an earlier search specification and n is the number of lines from the search specification in the range of 0 to 255. If omitted, the beginning line is the only line searched.
Note: This is a line number, not a record number. Also, the beginning and ending line fields cannot reference a different search specification.
The beginning or only column to be searched for text. The beginning column can be a specific column number from 1 to 32760 or a relative column number in the form r+n or r-n where r is the reference symbol from an earlier search specification and n is the number of columns from the search specification in the range of 0 to 32760.
Note: The line and column fields cannot reference a different search specification.
the last column to be searched for text. The ending column can be a specific column number from 1 to 32760 or a relative column number in the form r+n or r-n where r is the reference symbol from an earlier search specification and n is the number of columns from the search specification in the range of 0 to 32760. If omitted, the beginning column is the only column searched. The beginning and ending column are to be large enough to op - specifies one of the following values to indicate the type of comparison to be performed:
Search text. This is to be enclosed in quotes. The text is maintained as upper case characters but matches lower case page data. For the LK comparison operator, the text can specify a special matching character or any other character to specifically match that character. The special matching characters are:
Indicates whether multiple occurrences of the text can be found on a report page. This field can be specified as follows:
Defines the reference symbol that is associated with the search specification. The reference symbol can be any non-blank character. This character is to be unique within the search specifications. Define a reference symbol only if a subsequent search or extraction of data is based on the location of the search text.
Specify the index field names and locations.
Index field specifications are defined within a table. The INDEX specifications are enclosed within parentheses. In addition, each row in the table is also enclosed by parentheses.
Note: To update INDEX= definitions for an existing view, specify all INDEX= definitions. All existing table entries are replaced with the new entries. To create a page index for an existing SYSOUT, the INDEX control statement must be issued on that SYSOUT before viewing.
Table rows have the following format:
(
(name,line,col,len,extract,leftjust,upper), ...
)
Identifies the index data being extracted. Index names are required for a cross report index. In all cases, the use of index name is recommended because changes to line, column, and length does not affect the selection of old indexes. Each index name is to be unique and cannot be reused within the index. 1-8 Characters.
Specifies the line where indexing data is to be extracted. The line number can be a specific line number from 1 to 255 or a relative line number in the form r+n where r is the reference symbol of a search specification and n is a number of lines from the search specification in the range of 0 to 255.
Note: This is a line number, not a record number. Carriage controls are to be taken into account when specifying a line number.
Specifies the beginning column where indexing data is to be extracted. The column number can be a specific column number from 1 to 32760 or a relative column number in the form r+n or r-n where r is the reference symbol of a search specification and n is a number of columns from the search specification in the range of 0 to 32760.
Note: The first column of data (after the carriage control) is column 1. Also, the line and column fields cannot reference a different search specification.
Len - specifies the length of the field to be extracted and indexed.
Specifies as ALL (or blank), FIRST, or NBLK to indicate whether index data is to be extracted from all pages, whether index data is to be extracted from the first page of a group of pages (in other words, only extract data when previous index values have changed), or whether new index data is to be extracted when the index data is not blank.
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|