Line commands are used to select an option or cause the current Code Debug CICS function to take a particular action, such as deleting a previously set breakpoint. Line commands are inserted in the field preceding each line of the display, allowing a function to be performed upon that line.

Code Debug CICS line commands are used for several different functions:

• Source listing
• Editing trap, trace, and storage protection entries
• Address selection
• Abend, task, and CSECT selection
• File Utility
• Editing DL/I segments
• Db2 File Utility
• Task Storage Display
• Processing SLS data sets
• Resource Summary
• Session Profile.

The following table summarizes the Code Debug CICS line commands by function. Because the function of a line command can vary slightly depending on which screen is being used, each screen description in this manual also includes detailed information on the line commands that can be used on that screen.

Line Command Summary

A (After)

The A (After) line command sets a breakpoint, or marks a line as the destination for data to be moved or copied. The difference in functionality is described separately according to screens:

• Source Listing screen (2.L) and List Breakpoints screen (1.1)
• Other screens.

Source Listing and List Breakpoints screens

On these screens, the A line command sets an unconditional after breakpoint. With this breakpoint, Code Debug CICS always halts execution of the program after executing the statement.

When used on the following screens, the A line command marks the destination for data to be copied or moved:

• 
  
  • Edit DL/I Segment screen (5.4.4)
  • Trace Summary screen (1.4)
  • Trap Summary screen (1.6)
  • Storage Protection screen (1.8)
  • Db2 File Utility screens (5).

The copied or moved data is placed after the line on which the A line command is entered.

 AC (After Conditional)

The AC (After Conditional) line command sets a conditional breakpoint after a program statement. Use the AC command on the Source Listing screen (2.L) and the List Breakpoints screen (1.1) to halt execution after a statement. For syntax of an if-condition, see Variable-and-Common-Parameters.

 B (Before)

The B (Before) line command sets a breakpoint, or marks a line as the destination for data to be moved or copied. The difference in functionality is described separately according to screens:

• Source Listing screen (2.L)
• Other screens.

Source Listing and List Breakpoints screens

On these screens, the B line command sets an unconditional before breakpoint. With this breakpoint, Code Debug CICS always halts execution of the program before executing the statement.

Other screens

When used on the following screens, the B line command marks the destination for data to be copied or moved:

• 
  
  • Edit DL/I Segment screen (5.4.4)
  • Trace Summary screen (1.4)
  • Trap Summary screen (1.6)
  • Storage Protection screen (1.8)
  • Db2 File Utility screens.

The copied or moved data is placed before the line on which the B line command is entered.

B (Browse)

The B (Browse) line command selects a data set or queued temporary storage queue for multiple record browsing. This command is used only on the File Utility screens (5.1.1, 5.2.1, and 5.6.1).

BC (Before Conditional)

The BC (Before Conditional) line command is used on the Source Listing screen (2.L) to set a conditional breakpoint before a statement in a program. Use the BC command on the Source Listing screen (2.L), and the List Breakpoints screen (1.1) to halt execution before executing a statement. For syntax of an if-condition, see Variable-and-Common-Parameters.

C (Close)

The C (Close) line command selects an SLS data set to be closed. This command is only used on the SLS Data set screen (9.L).

C (Copy)

When used on the following screens, the C (Copy) line command specifies the line to be copied to another location:

• Edit DL/I Segment screen (5.4.4)
• Trace Summary screen (1.4)
• Trap Summary screen (1.6)
• Storage Protection screen (1.8)
• Db2 File Utility screens.

To complete the copy, specify a destination with an A (After) or B (Before) line command.

When used on the Load Profile (0.4) screen, the C (Copy) line command copies the selected profile to create a new profile record.

C (Count)

The C (Count) line command selects statements to be counted during program execution. This command is used on the Source Listing screen (2.L) and the List Breakpoints screen (1.1).

The C (Count) line command provides a quick method for counting single statements. A COUNT field is displayed to the right of every statement selected for counting and is incremented by one each time the statement is executed.

CC (Count Block)

The CC (Count Block) line command selects a block of statements to be counted during program execution. This command is used on the Source Listing screen (2.L).

The CC (Count Block) line command provides a quick method for counting blocks of statements. The first CC prefix establishes the upper or lower boundary of the block. The second CC establishes the opposite boundary.

A COUNT field is displayed to the right of every statement selected for counting and is incremented by one each time the statement is executed.

 D (Delete)

The D (Delete) line command deletes any after breakpoint, before breakpoint, count, keeps, onetime breakpoint, skip, and verify from a statement. It also deletes an entry or record from a data set, deletes individual saved traps, deletes individual intercepts, and removes the profile record from the Profile Data set.

The difference in functionality is described separately according to screens:

• Source Listing screen (2.L)
• List Breakpoints screen (1.1)
• Break/Abend screen (2.1)
• Intercept Summary screen (1.7)
• Saved Traps screen (1.5)
• Load Profile screen (0.4)
• CSECT screens
• Editing and Listing DL/I Segments screens
• Other File Utility screens

Source Listing Screen

Deletes any previously set after breakpoint, before breakpoint, count, keeps, onetime breakpoint, skip, and verify from a statement. Use the following line commands to set these for a statement:

• 
  
  • A, AC, B, BC, O, or Z line commands to set a breakpoint
  • C line command to set a count
  • K line command to set a keep
  • SK line command to set a skip
  • V line command to set a verify.

When you use the D line command, the following conditions apply:

• 
  
  • On a statement that has a conditional breakpoint set (AC or BC), the associated breakpoint and condition are removed.
  • On the -COND- flag for a conditional breakpoint, only the condition is deleted, and the breakpoint then becomes unconditional. For example, an AC changes to an A.

List Breakpoints Screen

Deletes any previously set after breakpoint, before breakpoint, count, or onetime breakpoint from a statement. Use the following line commands to set these for a statement:

• 
  
  • A, AC, B, BC, O, or Z line commands to set a breakpoint
  • C line command to set a count.
  • K line command to set a keep
  • SK line command to set a skip
  • V line command to set a verify.

When you use the D line command, the following conditions apply:

• 
  
  • On a statement that has a conditional breakpoint set (AC or BC), the associated breakpoint and condition are removed.
  • On the -COND- flag for a conditional breakpoint, only the condition is deleted, and the breakpoint then becomes unconditional. For example, an AC changes to an A.

Break/Abend Screen

If a keep has been set for a variable, as indicated by a K in the line command field, the keep can be deleted by overtyping it with a D.

Intercept Summary Screen

Deletes a prior intercept that was set or a new line in error.

Load Profile Screen

Removes the profile record from the Profile Data set.

Saved Traps Screen

Deletes individual saved traps.

CSECT Screens

Deselects a CSECT for processing.

Editing and Listing DL/I Segments Screens

Deletes an SSA from the SSAs displayed.

Other File Utility Screens

Deletes one record from a data set. On the Temporary Storage Queue List screen (5.2.1), deletes the entire queue.

DA (Delete After)

The DA (Delete After) line command deletes only an after breakpoint from a statement. Any before breakpoint, count, keeps, onetime breakpoint, skip, and/or verify on the statement are unaffected by the DA line command. Use the A or AC line commands to set an after breakpoint for a statement.

When you use the DA line command on a statement that has a conditional after breakpoint set (AC) or on the -COND- flag for that breakpoint, both the breakpoint and the associated condition are removed.

The DA line command is available on the Source Listing screen (2.L) and the List Breakpoints screen (1.1).

DB (Delete Before)

The DB (Delete Before) line command deletes only a before breakpoint from a statement. Any after breakpoint, count, keeps, onetime breakpoint, skip, and/or verify on the statement are unaffected by the DB line command. Use the B or BC line commands to set a before breakpoint for a statement.

When you use the DB line command on a statement that has a conditional before breakpoint set (BC) or on the -COND- flag for that breakpoint, both the breakpoint and the associated condition are removed.

The DB line command is available on the Source Listing screen (2.L) and the List Breakpoints screen (1.1).

DC (Delete Count)

The DC (Delete Count) line command deletes only the count from a statement. Any after breakpoint, before breakpoint, keeps, onetime breakpoint, skip, and/or verify on the statement are unaffected by the DC line command. Use the C or CC line commands to set a count for a statement or block of statements, respectively.

The DC line command is available on the Source Listing screen (2.L) and the List Breakpoints screen (1.1).

DD (Delete Block)

The DD (Delete Block) line command deletes all of the breakpoints, counts, keeps, skips, and verifies from a block of statements. To begin a block, type DD on the line where the block of statements begins. Type DD again on the line where the block of statements ends.

The DD line command is available on the Source Listing screen (2.L).

DH (Delete Hex)

Turns off the Hex mode display for an item in the KEEP window. This command is only valid if the H line command was previously used on the data field.

The DH line command is available on the Source Listing screen (2.L), the Break/Abend screen (2.1), and the Variable Storage screen (2.3).

DK (Delete Keep)

Deletes the Keep in the KEEP window. This command is only valid if a KEEP was previously used on the data field.

The DK line command is available on the Source Listing screen (2.L), the Break/Abend screen (2.1), the Variable Storage screen (2.3), and the List Breakpoints screen (1.1).

DO (Delete Onetime)

The DO (Delete Onetime) line command deletes only a onetime breakpoint from a statement. Any after breakpoint, count, keeps, skip, and/or verify on the statement are unaffected by the DO line command.

A onetime breakpoint can be indicated by an O or by a Z. Use the O line command to set a onetime breakpoint for a statement. If you have currently trapped a break or abend, use the Z line command to set a onetime breakpoint for a statement and issue the GO command.

The DO line command is available on the Source Listing screen (2.L) and the List Breakpoints screen (1.1).

DS (Delete Skip)

The DS (Delete Skip) line command deletes only the skip from a statement. Any after breakpoint, before breakpoint, count, keep, onetime breakpoint, and/or verify on the statement are unaffected by the DS line command. The S or SC line commands can be used to set a skip for a statement. The SS line command can be used to set skips for a block of statements.

The DS line command is available on the Source Listing screen (2.L).

DV (Delete Verify)

The DV (Delete Verify) line command deletes only the verify from a statement. Any after breakpoint, before breakpoint, count, keep, onetime breakpoint, and/or skip on the statement are unaffected by the DV line command. The V or VV line commands can be used to set a verify for a statement or block of statements, respectively.

The DV line command is available on the Source Listing screen (2.L).

DZ (Delete Runto)

The DZ (Delete Runto) line command deletes only a onetime breakpoint from a statement. Any after breakpoint, count, keeps, skip, and/or verify on the statement are unaffected by the DZ line command.

A onetime breakpoint can be indicated by an O or by a Z. Use the O line command to set a onetime breakpoint for a statement. If you have currently trapped a break or abend, use the Z line command to set a onetime breakpoint for a statement and issue the GO command.

The DZ line command is available on the Source Listing screen (2.L) and the List Breakpoints screen (1.1).

DDA (Delete Block After)

The DDA (Delete Block After) line command deletes only all the after breakpoints from a block of statements. Any before breakpoints, counts, keeps, onetime breakpoints, skips, and verifies in the block of statements are unaffected by the DDA line command. To begin a block, type DDA on the line where the block of statements begins. Type DDA again on the line where the block of statements ends. The A or AC line commands can be used to set an after breakpoint for a statement.

The DDA line command is available on the Source Listing screen (2.L).

DDB (Delete Block Before)

The DDB (Delete Block Before) line command deletes only all the before breakpoints from a block of statements. Any after breakpoints, counts, keeps, onetime breakpoints, skips, and verifies in the block of statements are unaffected by the DDB line command. To begin a block, type DDB on the line where the block of statements begins. Type DDB again on the line where the block of statements ends. The B or BC line commands can be used to set a before breakpoint for a statement.

The DDB line command is available on the Source Listing screen (2.L).

DDC (Delete Block Count)

The DDC (Delete Block Count) line command deletes only all the counts from a block of statements. Any after breakpoints, before breakpoints, keeps, onetime breakpoints, skips, and verifies in the block of statements are unaffected by the DDC line command. To begin a block, type DDC on the line where the block of statements begins. Type DDC again on the line where the block of statements ends. The C or CC line commands can be used to set a count for a statement or block of statements, respectively.

The DDC line command is available on the Source Listing screen (2.L).

DDK (Delete Block Keep)

The DDK (Delete Block Keep) line command deletes only all the keeps from a block of statements. Any after breakpoints, before breakpoints, counts, onetime breakpoints, skips, and verifies in the block of statements are unaffected by the DDK line command. To begin a block, type DDK on the line where the block of statements begins. Type DDK again on the line where the block of statements ends. The K or KK line commands can be used to set a keep for the variable in a statement or all the variables in a block of statements, respectively.

The DDK line command is available on the Source Listing screen (2.L).

DDS (Delete Block Skip)

The DDS (Delete Block Skip) line command deletes only all the skips from a block of statements. Any after breakpoints, before breakpoints, counts, keeps, onetime breakpoints, and verifies in the block of statements are unaffected by the DDS line command. To begin a block, type DDS on the line where the block of statements begins. Type DDS again on the line where the block of statements ends. The S or SC line commands can be used to set a skip for a statement. The SS line command can be used to set skips for a block of statements.

The DDS line command is available on the Source Listing screen (2.L).

DDV (Delete Block Verify)

The DDV (Delete Block Verify) line command deletes only all the verifies from a block of statements. Any after breakpoints, before breakpoints, counts, keeps, onetime breakpoints, and skips in the block of statements are unaffected by the DDV line command. To begin a block, type DDV on the line where the block of statements begins. Type DDV again on the line where the block of statements ends. The V or VV line commands can be used to set a verify for a statement or block of statements, respectively.

The DDV line command is available on the Source Listing screen (2.L).

F (First)

The F (First) line command displays the first line or the first n lines in a block of excluded lines on the Source Listing screen (2.L).

• F displays the first line in an excluded block.
• Fn displays the first n lines in an excluded block. For example, F5 displays the first five lines in an excluded block.

An F typed on a line that is not excluded is ignored. If the number used with an F is greater than the number of excluded lines, all lines that were excluded in the block are displayed.

Lines are excluded using the X or XX line command or the EXCLUDE primary command.

GT (Go To)

The GT (Go To) line command repositions the execution pointer (=====>) that indicates where a program in a break/abend state will resume processing.

H (Hex)

Displays an item in the KEEP window portion in Hex mode. This command is only valid while in SHOW ALL display mode.

The H line command is available on the Source Listing screen (2.L), the Break/Abend screen (2.1), and the Variable Storage screen.

I (Insert)

The I (Insert) line command inserts either a new blank line or a new record, depending on the screen from which it is entered:

• Trap, Trace, and Storage Protection screens
• Edit DL/I Segment and Db2 File Utility screens.

Trap, Trace, and, Storage Protection Screens

When used on the following screens, the I line command inserts one blank line into the data:

• 
  
  • Trace Summary screen (1.4)
  • Trap Summary screen (1.6)
  • Storage Protection screen (1.8).

Edit DL/I Segment (5.4.4) Screen and Db2 File Utility Screens

When used on these screens, the I line command inserts one record after the line.

I (Intercept)

The I (Intercept) line command selects the CSECT and sets a breakpoint at the entry point for that CSECT. This line command is only available on the List of CSECTS (2.6.1) screen.

IA (Insert After)

The IA (Insert After) line command inserts one new SSA line into the data immediately after the specified SSA. This line command is used on the Edit DL/I Segment screen (5.4.4).

IB (Insert Before)

The IB (Insert Before) line command inserts one new SSA line into the data immediately before the specified SSA. This line command is used on the Edit DL/I Segment Screen (5.4.4).

K (Keep)

The K (Keep) line command selects variables to be kept for viewing. It is used on the following screens:

• Source Listing screen (2.L)
• Break/Abend screen (2.1)
• Program Storage screens (2.3).

Variables are selected to be kept for viewing by typing a K in the line area preceding the variable on the Program Storage screens (2.3), the statement on the Source Listing screen (2.L), or the line area preceding the variable on the Break/Abend screen (2.1).

• K sets a keep for the first variable on a line.
• Kn sets a keep for the nth variable on a line in a C, COBOL or PL/I program. For example, K3 sets a keep for the third variable on the line.
• K* sets a keep for every variable on the line in a C, COBOL or PL/I program.

There is no limit to the number of variables that can be kept for viewing. When an abend occurs, or the program reaches a breakpoint, the current values of the selected variables are displayed on the View Break/Abend screen (2.1) and in the keep window on the Source Listing screen (2.L).

KK (Keep Block)

The KK (Keep Block) line command selects all the variables in a block of statements to be kept for viewing. It is used in the line area preceding the first and last statements of the desired block on the Source Listing screen (2.L).

There is no limit to the number of variables that can be kept for viewing. When an abend occurs, or the program reaches a breakpoint, the current values of the selected variables are displayed on the View Break/Abend screen (2.1) and in the keep window on the Source Listing screen (2.L).

L (Last)

The L (Last) line command displays the last line or n lines of code in an excluded block.

• L displays the last line of code.
• Ln displays the last n lines of an excluded block. For example, L5 displays the last five lines of an excluded block.

An L typed on a line that is not excluded is ignored. If the number used with an L is greater than the number of excluded lines, all lines that were excluded in the block are displayed.

Lines are excluded using the X or XX line commands or the EXCLUDE primary command.

L (Lock)

The L (Lock) line command is used on the Select Address screen to ensure that an address is not deleted from the table. The table holds only sixteen entries and the oldest entry is always the one that is deleted. See the primary command SELECT (SEL).

M (Move)

When used on the following screens, the M (Move) line command specifies the line to be moved to another location:

• Trace Summary screen (1.4)
• Trap Summary screen (1.6)
• Storage Protection screen (1.8).
• Edit DL/I Segment screen (5.4.4)
• DB2 Build SQL Easy Query screen (5.5.2)

When used on the Db2 File Utility screens, this command specifies the Db2 column to be moved to another location.

To complete the move, specify the destination with an A (After) or B (Before) line command.

MM (Move Block)

The MM (Move Block) line command indicates the starting and ending range of a block of Db2 columns that are to be moved after or before another column. The first MM establishes the upper or lower boundary of the block. The second MM establishes the opposite boundary. To complete the move, specify a destination with an A (After) or B (Before) line command.

The MM (Move Block) line command is available on the DB2 Build SQL Easy Query screen (5.5.2).

O (Onetime)

The O (Onetime) line command sets a temporary breakpoint on a statement. The onetime breakpoint pauses execution before the statement and is then automatically deleted.

O (Open)

The O (Open) line command selects an SLS data set to be opened. This command is only used on the SLS Data set screen (9.L).

P (Path)

The P (Path) line command highlights the hierarchical path needed to access a DL/I segment. This command is used on the DL/I Segment List screen (5.4.3).

P (Peek)

Available on the Source Listing screen (2.L) and Break/Abend screen (2.1), and their KEEP windows. P transfers to the applicable Program Storage screen (2.3) and positions to the first variable selected. Pn transfers to the applicable Program Storage screen (2.3) and positions to the nth variable selected. Only valid when in a break/abend state.

Q (Easy Query)

The Q line command transfers you from the DB2 Table/View List screen (5.5.1) to the DB2 Build SQL Easy Query screen (5.5.2).

R (Release)

The R (Release) line command releases all breakpoints, counts, and skips from a selected program. The R line command is used on the Resource Summary screens (1.P and 9.P). From the 9.P screen, keeps are also released.

From the 1.P screen, only the resources of the local debugging session can be released. From the 9.P screen, the R line command can release resources for any debugging session in the CICS region.

This is helpful if a user signs off from CICS without ending their debugging session, then signs back on with a different debugging session ID. An XPSP user can use the R line command to free up resources used by the first debugging session.

R (Reload)

The R (Reload) line command is used on the Saved Traps (1.5) screen to reload individual traps.

R (Rename)

The R (Rename) line command is used on the Load Profile (0.4) screen to rename the selected profile.

R (Replicate)

The R (Replicate) line command creates an exact copy of the row on which the command is entered. The new row is displayed immediately following the replicated row.

S (Save)

The S (Save) line command is used on the Trap Summary screens (1.6 and 9.6) to save the specified trap into the profile data set immediately, rather than at the end of the session.

S (Select)

The S line command is used to select entries in menus, the Memory Display screens (2.2, 9.2), the Select Address screen, and the Load Profile (0.4) screen. It is also used to select channels on the Program Channel Display (2.C.1) or containers on the Channel Container Display (2.C.2) screens.

Address Selection: The S line command is used on the Select Address screen to select an address. The data at that address is then displayed on the Memory Display screens (2.2, 9.2).

List All Tasks: The S line command is used to select a task from the list on the List All Tasks screen (9.2).

List Abends: When listing abends on the List Abends screen (1.3), use the S line command to select an abend for viewing on the View Break/Abend screen (2.1).

File Utility: The S line command is used to select a record, PSB, PCB, segment, or MQ queue for further processing.

List of CSECTs: The S line command is used to select a CSECT for processing.

Channels and Containers: The S line command is used to select a channel on the Program Channel Display (2.C.1) screen and transfer to the Channel Container Display (2.C.2) screen to display a list of its containers. It may also be used on the 2.C.2 screen to select a container and transfer to the Browse Container Data (2.C.3) screen to display the data it contains.

Task Storage Display: The S line command is used to display/update a single area from the list on the Memory Display screen (2.2 or 9.2, based on Code Debug session type).

Load Profile: The S line command is used to select the profile to load.

S (Unconditional Skip)

The S line command sets an unconditional skip before a statement in a program.

SC (Conditional Skip)

The SC line command sets a conditional skip before a statement in a program. See  for syntax of an if-condition.

SS (Select Block)

The SS line command selects a block of entries or columns for display on the DB2 Build SQL Easy Query screen (5.5.2).

SS (Skip Block)

The SS (skip block) line command sets unconditional skips for all statements within the block selected on the Source Listing screen (2.L).

U (Unlock)

The U (Unlock) line command is used on the Select Address screen to unlock an entry. The entry is then eligible to be deleted when new entries are added.

V (Verify)

The V (Verify) line command displays Assembler object code and allows it to be modified on the Source Listing screen (2.L) for Assembler programs.

Assembler object code cannot be modified using the V line command for a program residing in a protected (E)RDSA.

VV (Verify Block)

The VV (Verify Block) command displays a block of Assembler object code and allows it to be modified on the Source Listing screen (2.L) for Assembler programs.

Assembler object code cannot be modified using the VV line command for a program residing in a protected (E)RDSA.

X (Exclude)

The X (Exclude) line command specifies a line or Db2 column to be excluded from display. The difference in functionality is described separately according to screens:

• DB2 Build SQL Easy Query screen (5.5.2)
• Source Listing screen (2.L).

DB2 Build SQL Easy Query (5.5.2) Screen

The X line command specifies a Db2 column to be excluded from the display.

Source Listing Screen (2.L)

The X line command excludes one or n lines from the display.

• 
  
  • X excludes a single line.
  • Xn excludes n number of lines. For example, X5 excludes five lines from the display.

XX (Exclude Block)

The XX (Exclude Block) line command specifies a block of lines or block of Db2 columns to be excluded from display. The difference in functionality is described separately according to screens:

• DB2 Build SQL Easy Query screen (5.5.2)
• Source Listing screen (2.L).

DB2 Build SQL Easy Query Screen (5.5.2)

The XX line command specifies a block of Db2 columns to be excluded from the display.

Source Listing Screen (2.L)

The XX line command specifies a block of lines to be excluded from the display.

Z (Runto)

The Z (Runto) line command is valid on the Source Listing screen (2.L). It sets an unconditional onetime breakpoint and will issue a GO command if you have currently trapped a break or abend. After the onetime breakpoint has been taken, it is deleted. If the onetime breakpoint is not taken, it is redisplayed as an O.