Edited command buffer format

The edited command buffer is logged in the X'02' log record and is passed to the AOI user exit. You can use the edited command buffer to determine if any recoverable commands were issued for the resource you are analyzing.

Edited command buffer examples

For example, if you are analyzing a hung terminal problem, look at any log records, including X'02' records, that apply to that terminal.

However, finding the applicable log records might be difficult. If the problem is repeatable, you can use the /LOG command to mark the log when certain activities are started or stopped. The /LOG command writes a comment to a X'02' log record. This narrows the range of log records you need to examine.

Example: If transaction XYZ results in a hung terminal, use the /LOG command to write a comment to a X'02' log record before the transaction is started and after the terminal is hung, as follows: 
/LOG START XYZ TRAN THAT RESULTED IN HUNG TERMINAL.
/LOG TERMINAL IS NOW HUNG.

Look for these comments in the X'02' log record edited command buffers to determine the range of log records to examine.

The following figure shows the layout of the edited command.

Figure 1. Edited command layout
Graphic is a rectangle with 8 columns. The first column (from left to right) is labeled "FLAG1." The second column is labeled "CCC." The third column is labeled "NK." The fourth column contains two rows. The first row is labeled "Keyword Abbreviation." The second row contains 3 columns. The first column (from left to right) in row 2 is labeled "CNT." The second column in row 2 is labeled "PARAMETER or PASSWORD." The third column in row 2 is labeled "DDL." The fifth column is labeled "FLAG2." The sixth column is not labeled, but contains symbols indicating that "FLAG2" can be repeated as many times as needed until the seventh and final column which is labeled "FLAG3."
Figure Number
  Description
FLAG1
X'FE' to denote the beginning of the edited command. If any parameter contains an error, the command action modules set this byte to X'FC'. An exception is DFSICL40 processing of ALL expanded parameters.
CCC
First 3 characters of entered command.
NK
Hexadecimal value of number of keywords in the condensed buffer.
FLAG2
One of the following:
X'FC'
Parameter that follows found in error.
X'FF'
3-byte keyword abbreviation follows.
X'FE'
Count (CNT) field and parameter follow.
C'('
Count (CNT) field and password follow.
Keyword Abbreviation
First 3 characters of entered command. Consult DFSCKWDO to obtain the abbreviation; it is sometimes the first 3 characters of any keyword.
CNT
Count of number of characters in parameter or password immediately following the CNT. It can be a comma, period, blank, or left parenthesis.
Parameter or Password
Exists exactly as entered from the terminal.
DDL
The delimiter entered after the parameter or password. It may be X'80' if the keyword ALL was expanded to individual parameters.
FLAG3
Period indicating end of command.

Exception: Only parameter passwords are present in the condensed buffer; command passwords are not present.