Fields on the Create compiled profile page
- Debugging profile
- Specifies the name of the profile.
If you are working with an existing profile, and you change the name that is displayed, the application debugging profile manager 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.
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.
The default value is the applid of the region where the application debugging profile manager is running, and is displayed at the top of the page.
- 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 that 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.
The default value is the ID of the user that is using the application debugging profile manager, and is displayed at the top of the page.
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 compiled display device" page. - 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 options that are passed to Debug Tool. See 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 a Language Environment debugging profile.
- Test level
- Specifies what conditions need to be met for Debug Tool to gain
control for programs that match this profile. Select one of 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.
- 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 .