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.
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
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.
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.
- 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 lower case characters
you enter are not converted to upper case.
- 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.
- Test level
- Command file
- Prompt
- Preference file
- Language Environment options
the CICS Application Programming Guide
[[ Contents Previous Page | Next Page Index ]]