Overview

What It Does

The PROFILE (PRO) parameter is an optional parameter that can be used to override system defaults on a run-by-run basis.

Note: The system profile established at CA Culprit installation may reflect different values from those indicated as defaults in this chapter. You may change the defaults for your site by altering the CULPPROF module. Refer to the appendix Profile Options for information on modifying CULPPROF.

Options specified on the PROFILE parameter can be grouped into three categories:

Format options
Site-specific options
Error options

Format Options

Format options format and print CA Culprit parameter listings and reports. Examples of these actions are:

The system time can be printed at the top of each page of output.
European, Canadian, or American date formats can be requested.
The number of characters per line and lines per page can be specified for the run.
For special forms output, the first page of the report can be reprinted in order to properly align the form in the printer.
Vertical or horizontal hexadecimal dumps can be requested.

Site-specific

Site-specific options perform installation-specific actions. Examples of these actions are:

At z/OS installations with no relocating loaders, self-relocating user modules can be identified.
CA Culprit processing modes can be specified to accommodate reports written for CA Culprit releases before 6.0.
For CA Librarian users, a password code can be specified as needed.
For Integrated Data Dictionary (IDD) users, a password code and user name can be specified as needed.
One of four types of libraries can be identified that store CA Culprit parameters in library members; the stored parameters can be accessed through USE parameters, =COPY parameters, or =MACRO parameters.

Note: At installation time, users can select additional system profile options. For more information on establishing site-specific profile options, see the CA IDMS Installation Guide for your operating system.

Error Options

Error options specify actions in response to the severity level or the number of numeric errors generated during CA Culprit processing. Severity codes encountered as a result of a CA Culprit error are I (informational), W (warning), E (error), and F (fatal). Examples of these actions follow:

CA Culprit can be instructed to generate reports containing I- and W-level errors even though other reports in the same run contain E- or F-level errors.
At z/OS and z/VM installations, return code values can be set for each level of error; the values can be used to control the execution of subsequent job steps through execution JCL. At z/VSE installations, a nonzero return code forces job cancellation.
CA Culprit outputs a buffer dump for every numeric error encountered during a processing phase up to a specified number. When the specified number of numeric errors is reached, CA Culprit can be directed to ignore additional errors, stop the CA Culprit run, or terminate the job step with an abend condition.

Note: For more information on error handling, see the CA Culprit for CA IDMS Messages and Codes Guide.

PROFILE Syntax

More information:

PROFILE Parameter

Overrides system defaults.

      Col
      2
      ▼         ┌──────────────────────────────┐
►►─── PROfile ──▼─┬─ format-options ─────────┬─┴──────────────────────────────►◄
                  ├─ site-specific-options ──┤
                  └─ error-options ──────────┘

Expansion of Format-options

►►─┬─ LS = ─┬─ 132 ◄──────┬───────────────────────┬───────────────────────────►◄
   │        └─ line-size ─┘                       │
   ├─ LP = ─┬─ 55 ◄────────────┬──────────────────┤
   │        └─ lines-per-page ─┘                  │
   ├─ SF = ─┬─ NORMAL ◄──┬────────────────────────┤
   │        └─ EXTRA ────┘                        │
   ├─ TS = ─┬─ Y ───┬─ , ─┬─ Y ───┬─ , ─┬─ Y ───┬─┤
   │        └─ N ◄──┘     └─ N ◄──┘     └─ N ◄──┘ │
   ├─ DS = ─┬─ A ◄──┬─────────────────────────────┤
   │        ├─ E ───┤                             │
   │        ├─ C ───┤                             │
   │        └─ H ───┘                             │
   ├─ HD = ─┬─ V ◄──┬─────────────────────────────┤
   │        ├─ H ───┤                             │
   │        └─ D ───┘                             │
   ├─ MONEYED = ─┬─ A ◄──┬────────────────────────┤
   │             └─ E ───┘                        │
   └─ SSN = ┬─ D ◄──┬─────────────────────────────┘
            ├─ A ───┤                             
            └─ C ───┘

Expansion of Site-specific-options

►►─┬─ RELEASE = ─┬─ 5 ───┬───────────┬────────────────────────────────────────►◄
   │             └─ 6 ◄──┘           │
   ├─ PARMLIB = ─┬─ STANDARD ◄──┬────┤
   │             ├─ PANVALET ───┤    │
   │             └─ LIBRARIAN3 ─┘    │
   ├─ LIBR-PW = librarian-password ──┤
   │        ┌───────────────┐        │
   ├─ SR = ─▼─ module-name ─┴────────┤
   ├─ PW = password ─────────────────┤
   └─ USER = user-id ────────────────┘

Expansion of Error-options

►►─┬─ EX = ─┬─ W ◄─┬────────────────────────────────────────────────────────┬─►◄
   │        ├─ E ───┤                                                       │
   │        └─ NO ──┘                                                       │
   ├─ RC = ─┬─ 0 ──────┬─ , ─┬─ 0 ──────┬─ , ─┬─ 0 ──────┬─ , ─┬─ 0 ──────┬─┤
   │        └─ i-code ─┘     └─ w-code ─┘     └─ e-code ─┘     └─ f-code ─┘ │
   │ ┌─────────────────────────────────────┐                                │
   └─▼─┬─┬─ SE ─┬─ = ─┬─ 25 ◄─────────┬──┬─┴─ error-action ─────────────────┘
       │ ├─ ME ─┤     └─ error-count ─┘  │
       │ └─ EE ─┘                        │
       └─┬─ IE ─┬─ = ─┬─ 0 ◄──────────┬──┘
         ├─ PE ─┤     └─ error-count ─┘
         └─ OE ─┘

Expansion of Error-action

►►─┬─ IGNORE ───────────────────────────────────┬─────────────────────────────►◄
   ├─ STOP ─────────────────────────────────────┤
   └┬─ ABEND ──┬─┬───────────────┬─┬──────────┬─┘
    └─ CANCEL ─┘ └─ return-code ─┘ ├─ DUMP ───┤
                                   └─ NODUMP ─┘