Fields on the Create LE debugging profile screen
- Create LE Debugging Profile
- Specify the name of the profile. If you change the name of an
existing profile, CADP creates a new profile with the new name, and
leaves the original profile unchanged.
Acceptable characters A-Z 0-9 $ @ #Any lowercase characters you enter are converted to uppercase.
The following fields specify which programs should trigger the start of a debugging session when the profile is active.
- Transaction
- Specify a value in this field when you want to debug only those
programs that run under the specified transaction id.
You can specify a generic value if you want to debug programs that run under a set of similarly-named transactions.Acceptable characters A-Z a-z 0-9 $ @ # . / - _ % & ¢ ? ! : | " = ¬ , ; < >Because transaction ids are case-sensitive, any lowercase characters you enter are not converted to uppercase.
Note: Do not specify an alias transaction name in this field; CICS does not support the use of alias transaction names to select programs for debugging. - Program
- Specify a value in this field when you want to debug only the
specified program. In this context the program is the program as known
to CICS, such as a load module name, initial program in a transaction
or a program that has been XCTL'd or LINKed to.
You can specify a generic value if you want to debug a set of similarly-named programs.Acceptable characters A-Z 0-9 $ @ #Any lowercase characters you enter are converted to uppercase.
- Compile unit
- Specify a value in this field when you want to debug only the
specified compile unit. You can specify a generic value if you want
to debug a set of similarly-named compile units. In this context the
compile unit is the program as known to the compiler; for example,
PROGRAM-ID for COBOL and the main PROCEDURE name for PL/I.
Acceptable characters A-Z a-z 0-9 $ @ # . / - _ % & ¢ ? ! : | " = ¬ , ; < >Because compile unit names are case-sensitive, any lowercase characters you enter are not converted to uppercase.
- Applid
- Specify a value in this field when you want to confine debugging
to programs that run in the specified CICS region. The default value
is the applid of the region where the Debugging Profile Manager is
running.
You can specify a generic value if you want to debug programs in a set of similarly-named regions.Acceptable characters A-Z 0-9 $ @ #Any lowercase characters you enter are converted to uppercase.
- Userid
- Specify a value in this field when you want to confine debugging
to programs that are being run by the specified user. The default
value is the ID of the user who is using the debugging profile manager.
You can specify a generic value if you want to debug programs that are being run by a group of similarly-named users.Acceptable characters A-Z 0-9 $ @ #Any lowercase characters you enter are converted to uppercase.
Important: The user ID specified here is not necessarily the owner of the profile: the owner of the profile is the user who created it. - Termid
- Specify a value in this field when you want to confine debugging
to programs that are being run at the specified terminal.
You can specify a generic value if you want to debug programs that are being run at a number of similarly-named terminals.Acceptable characters A-Z a-z 0-9 $ @ # . / - _ % & ¢ ? ! : | " = ¬ , ; < >Restriction: You cannot specify a terminal ID that consists entirely of blanksImportant: The terminal specified here is not necessarily the terminal at which the debugging session is conducted. The terminal used for the debugging session is specified in the "Set LE debugging display device" screen. - Netname
- Specify a value in this field when you want to confine debugging
to programs that are being run at terminals with the specified netname.
You can specify a generic value if you want to debug programs that are being run at a number of terminals with similar netnames.Acceptable characters A-Z 0-9 $ @ #Any lowercase characters you enter are converted to uppercase.
The following fields specify suboptions of the TEST runtime option, and are passed to Debug Tool. See the Debug Tool for z/OS and OS/390 User's Guide for more information. You can save the values that you specify; the saved values are used by default each time you create an LE debugging profile. For more information, see Specifying default values for Debug Tool and LE options.
- Test level
- Specifies which conditions raised by your program will cause Debug
Tool to gain control. You can enter the following values:
- All
- Error
- None
- Command file
- Specifies the primary commands file associated with the profile. You can specify the fully qualified name of a sequential data set or a member of a partitioned data set.
- Prompt level
- Specifies whether an initial commands list is unconditionally
executed during program initialization. Enter one of the following:
- PROMPT
- NOPROMPT
- command
- Preference file
- Specifies the preference file that Debug Tool uses when debugging programs that match this profile. You can specify the fully qualified name of a sequential data set or a member of a partitioned data set.
- Other Language Environment options
- Specifies Language Environment runtime options for programs that match this profile. When a program is selected for debugging because it matches the profile, the runtime options specified will override other runtime options that you may have in effect. For more information, see Defining runtime options for Language Environment .