CHECKONLY command


 CHECKONLY DATA=(data)
           ,CHECKLOC=(row,col,leng)
           [,LOC=(row,col)]
           [,SCAN={YES|integer|1}]

The CHECKONLY command specifies that the utility compare only a portion of the records identified for comparison. The DATA, LOC, and SCAN operands specify the string of data the utility uses to identify a record. After the utility finds a record that matches the specifications, the CHECKLOC operand specifies which field is to be compared.

You can issue multiple CHECKONLY commands to define multiple records that require the comparison of only specific fields.

Note: If you have coded the CHECKONLY and the MASK commands, the Log Compare Utility checks all CHECKONLY commands before checking any MASK commands. The Log Compare Utility checks the MASK commands only if the DSPY record did not match any of the CHECKONLY commands. Only one CHECKONLY statement is applied to a screen prior to comparison.

DATA=(data)

Function: The DATA operand specifies the data that identifies the record. The Log Compare Utility requires this operand whenever you specify the CHECKONLY command.

Format: You can represent the data as EBCDIC, hexadecimal (enclosed in single quote marks), or a mixture of both; the data can be up to 20 bytes in length.

Note: SO and SI characters are removed from DBCS data entered and are not counted as part of the previously mentioned 20 bytes. To include an SO or SI character in the data for the data compare, add the hexadecimal equivalent of an SO (X'0E') or SI (X'0F') to the data.

CHECKLOC=(row,col,leng)

Function: The CHECKLOC operand identifies the field that the utility compares for the record. The Log Compare Utility requires this operand whenever you specify the CHECKONLY command. You must specify the row and column location of the field and the length of the field (row,col,leng).

You can issue the CHECKLOC operand multiple times for a single CHECKONLY command, defining multiple fields to be compared.

If a CHECKLOC operand specifies a location beyond the end of the screen buffer, the Log Compare Utility ignores that location. Therefore, if all of the locations specifies by CHECKLOC operands are out of range, the Log Compare Utility always considers the panels equal because there are no fields specified within the screen buffer to compare.

Format: The values for row, col, and leng are integers from 1 to 255.

LOC=(row,col)

Function: The LOC operand indicates the exact panel position where the utility can find the data specified by the DATA operand or where the scan is to start if you specify the SCAN operand.

Format: The values for row and col can be integers from 1 to 255.

Default: The default is 1 for both row and col.

SCAN={YES|integer|1}

Function: The SCAN operand specifies whether or not the utility is to scan the record sequentially for the data specified in the DATA operand. When you specify scanning, the utility searches the record starting at the location specified in the LOC operand. If you omit the LOC operand, the starting location is (1,1) of the screen image.

If you code YES for the SCAN operand, the utility searches the record to the end. If you specify an integer, the utility searches the number of positions specified by integer.

Format: integer can be an integer from 1 to 32767.

Default: 1.