Space announcement This documentation space provides the same content as before, but the organization of the content has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Load Profile (0.4)

Related topics

Using-Code-Debug-CICS-with-Assembler-program

Using-Code-Debug-CICS-with-COBOL-program

Loading-a-profile_COBOL-guide

Screen-IDs

Common-screen-field

PF-key-settings

Load-a-Profile

The Load Profile screen (0.4) is used to choose an existing profile from which to load default session values. These values can be used to:

  • Replace the current session values with those from another profile.
  • Establish a new profile from an existing one.

Access this screen by typing the number 4 on the Session Profile Menu, or as described in Transferring Between Screens.

Load Profile Screen (0.4)

 ------------------------------ LOAD PROFILE (0.4) ------------------------C024
COMMAND ===>                                                   SCROLL ===> CSR
MODULE:          CSECT:
                                                                  ENTRY 000001
CURRENT PROFILE: AJMTRACE.ACMEJET0         DISPLAY MASK ==> ******** ACMEJET0
LINE COMMANDS:   S (Select)   C (Copy)   D (Delete)   R (Rename)

CMD  NAME     OWNER    NEWNAME  DESCRIPTION
----------------------------------------------------------------------------
 _   AFHHOS0  ACMEJET0 ________ ____________________________________________
 _   AJMCSECT ACMEJET0 ________ Profile 1
 _   AJMNONE  ACMEJET0 ________ Profile 2
 _   AJMTRACE ACMEJET0 ________ Profile 3
 _   AUTOSEL  ACMEJET0 ________ ____________________________________________
     **END**

Loading a Profile

  1. Type the name of the desired profile in the first DISPLAY MASK field and do one of the following:


      • If the profile data set is in the new format and the profile you want is already owned by you (keyed by your user-ID), then simply locate the profile that you want to use, select it, and press Enter.
      • If the profile data set is in the new format and the profile you want is owned by someone else, overtype your CICS user ID in the second DISPLAY MASK field with wild-card characters ('*') and press Enter. All profiles on the profile data set are now displayed. Locate the profile that you want to use, select it, and press Enter.
      • If the profile data set is in the old format, all profiles on the profile data set are already displayed. Locate the profile that you want to use, select it, and press Enter.

    Important

    If the profile data set is in the old format, the second DISPLAY MASK field does not exist.

  2. Use the S line command to select the profile to use. Press Enter.

Input Fields

DISPLAY MASK

Used for limiting the number of profiles to be displayed on this listing screen. The first field is for matching to the profile name while the second field is for matching to the owner. The second field is only available if the profile data set is in the new format. The initial value for the first field is all asterisks and for the second field is your CICS user ID, so that all profiles you own are displayed initially. If the profile you are looking for is not displayed, you can modify the second field with wildcards ('*') to display additional profiles, including those with no known owner.

CMD

Line command entry field. Valid entries are:


    • S (Select): Selects the profile to use.
    • C (Copy): Copies the selected profile to create a new profile record. Use of this line command requires that the NEWNAME field be entered and, if the name already exists, that profile is replaced with the profile you have copied. The OWNER field of the new profile is the current CICS userID.
    • D (Delete): Removes the profile record from the Profile Data set. XPSP users can delete any profile. XPED/XPRT users can only delete profiles in which the OWNER field matches the current CICS userID.
    • R (Rename): Renames the selected profile then deletes the original profile. XPSP users may rename any profile. Because the original profile will be deleted, XPED/XPRT users may only rename profiles in which the OWNER field matches the current CICS userID.

NEWNAME

Used when renaming or copying a profile.

DESCRIPTION

Allows users to enter a free-form description of the profile record.

Output Fields

ENTRY

Indicates which Profile Data set record number is being displayed at the top of the screen.

CURRENT PROFILE

Indicates which profile is currently being used by Code Debug CICS for this debugging session. It is formatted as NAME.OWNER. If the profile data set is not in the new format, only NAME is displayed (no period and no OWNER).

DISPLAY MASK

The name of the profile and, if the profile data set is in the new format, the CICS userID from which default session values were loaded. An asterisk indicates a wildcard.

NAME

Used to identify the profile record. This field is often identical to OWNER field because Code Debug CICS defaults the NAME field to the CICS user ID unless an explicit "P=...." parameter is entered with session startup.

OWNER

The CICS userID that was in effect on this terminal when this profile record was created. If the profile data set is not in the new format, this field does not display.

DESCRIPTION

Displays a free-form description of the profile record. If the description is supplied at the same time as a C(Copy) or R(Rename) line command, then the description entered is applied only to the new profile record.

Establishing a New Profile from Another User

  1. Access the Load Profile screen (0.4).
  2. If “ownership” has been established, change the second part of the DISPLAY KEY to asterisks. This will show all profiles on file. Find the one that you want to copy.
  3. Using line command C and the NEWNAME field, copy the profile that you want to the name that you want.
  4. To immediately establish any profile as the profile in effect, use line command S to select the profile.

Establishing a New Name for the Profile

  1. Access the Load Profile screen (0.4) and find the profile you want to rename.
  2. Using line command C and the NEWNAME field, copy the profile that you want to the name that you want.
  3. To immediately establish any profile as the profile in effect, use line command S to select the profile.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*