To use the Display Utility, issue the following transaction:
►►─ DBUT ─ location ─┬─────────────┬─┬──────────┬─┬────────────────────┬──────►◄ └─ operation ─┘ └─ scroll ─┘ └─┬─────────┬─ scan ─┘ └─ range ─┘
Note: The DBUT command is not available from the console.
Multiple operations may be specified.
(Required) Specify DBUT as the transaction ID.
(Required) Specify one of the following to indicate the starting location for the display operation:
Identifies the storage location for the start of the display. Specify the address in hexadecimal and code a space or the equal sign (=) immediately following the transaction ID (DBUT=address; DBUT address).
Identifies the location from the entry point address (EPA) of the named CICS program module. Include a blank space between DBUT and M=module.
Identifies the location from the load point address (LPA) of the named CICS program module. Include a blank space between DBUT and L=module.
Note: Although VSE environments can use either M=module or L=module, we recommend using L=module in VSE environments.
The named module must be defined in the CICS System Definition data set (CSD). Valid entries include application programs and CA Datacom CICS Services modules.
(Optional) Specify one or more of the following operations to indicate the display location relative to the starting location. If you specify more than one operation, the Display Utility performs the operations serially. That is, it starts at the specified starting location, performs the first operation to arrive at a new location which it uses as a starting location for the second operation.
Display the data xxxxxxxx bytes following the starting location. Specify xxxxxxxx as a hexadecimal value.
Display the data xxxxxxxx bytes preceding the starting location. Specify xxxxxxxx as a hexadecimal value.
Display the contents at the location pointed to by the address indicated in the specified location. Use -> to indicate that the fullword pointed to is treated as a 24-bit address (only the three low-order bytes in the fullword is used). Use => if the fullword pointed to is to be treated as a 31-bit address (all four bytes are considered as making up the address).
(Optional) Specify one of the following to indicate the amount and direction to scroll from the display location:
Indicates that the next display should be xx pages forward. A page is 256 bytes (16 lines).
Indicates that the next display should be xx pages backward.
Indicates that the next display should be xx half-pages forward. A half-page is 128 bytes (8 lines).
Indicates that the next display should be xx half-pages backward.
Indicates that the next display should be xx lines forward.
Indicates that the next display should be xx lines backward.
If you specify a scroll operand, the Display Utility scrolls the indicated amount and direction each time you press Enter.
(Valid only if used with a scan operand.) Specify either H=xxxxxxxx or H=nnK to limit the search to xxxxxxxx bytes or nn KB (kilobytes) following the current location. Specify xxxxxxxx as a hexadecimal value or nn as a decimal value.
Note: If you specify both the range operand and the scan operand, you must specify the range value before you specify the scan value.
(Optional) To scan for the first occurrence of a given target following the current location, enter one of the following:
where target is a character representation of the scan target.
where target is the hexadecimal representation of the scan target. This must be in full byte, that is, the target must be an even number of characters (for example, 2, 4, 6, 8, 10...).
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|