The Create compiled profile page

Use the "Create compiled profile" page to work with the contents of a debugging profile for compiled language (Language Environment®) programs. You can use the page to perform the following functions:

Create a new profile
Initially, the page contains default values for some of the fields. You must supply other values to complete the profile.
Edit an existing profile
Initially, the page contains the values that were previously defined for the profile.
Figure 2. The Create compiled profile page
This is an illustration of the Create compiled profile  page

Fields on the Create compiled profile page

The fields on the "Create compiled profile" page are:

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 lower case characters you enter are converted to upper case.

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.
Acceptable characters
A-Z a-z 0-9 $ @ # . / - _ % & ¢ ? ! : | " = ¬ , ; < >

Because transaction ids are case-sensitive, any lower case characters you enter are not converted to upper case.

You can specify a generic value if you want to debug programs that run under a set of similarly-named transactions.
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
Start of changeSpecify 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.
Acceptable characters
A-Z 0-9 $ @ #

Any lower case characters you enter are converted to upper case.

You can specify a generic value if you want to debug a set of similarly-named programs.End of change
Compile unit
Start of changeSpecify 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 lower case characters you enter are not converted to upper case.

End of change
Applid
Specify a value in this field when you want to confine debugging to programs that run in the specified CICS region.
Acceptable characters
A-Z 0-9 $ @ #

Any lower case characters you enter are converted to upper case.

You can specify a generic value if you want to debug programs in a set of similarly-named regions.

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.
Acceptable characters
A-Z 0-9 $ @ #

Any lower case characters you enter are converted to upper case.

You can specify a generic value if you want to debug programs that are being run by a group of similarly-named users.

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.
Acceptable characters
A-Z a-z 0-9 $ @ # . / - _ % & ¢ ? ! : | " = ¬ , ; < >
Restriction:
You cannot specify a terminal ID that consists entirely of blanks
You can specify a generic value if you want to debug programs that are being run at a number of similarly-named terminals.
Important:
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.
Acceptable characters
A-Z 0-9 $ @ #

Any lower case characters you enter are converted to upper case.

You can specify a generic value if you want to debug programs that are being run at a number of terminals with similar netnames.

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 debugging profile for a compiled language (Language Environment) program.

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:
Command file
Specifies the primary commands file associated with the profile. You can specify the fully qualified name of a sequential dataset 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:
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 dataset or a member of a partitioned data set.
Language Environment options
Specifies Language Environment run-time options for programs that match this profile. When a program is selected for debugging because it matches the profile, the run-time options specified will override other run-time options that you may have in effect. For more information, see the CICS Application Programming Guide.

Buttons on the Create compiled profile page

The buttons on the "Create compiled profile" page are:

Create
Create a new profile using the information entered on the page
Replace
Update an existing profile using the information entered on the page
Save options as default
Save the contents of the following fields. The saved values are used by default each time you create a debugging profile for a compiled language (Language Environment) program.

Related concepts
the CICS Application Programming Guide
Related tasks
Using the application debugging profile manager Web interface
Creating a debugging profile with the Web interface
Changing a debugging profile with the Web interface
the CICS Application Programming Guide
Related references
The List all profiles page
The Create Java profile page
The Set compiled display device page
[[ Contents Previous Page | Next Page Index ]]