Profile Options

This section provides information about the keywords and operands for CA Culprit profile options. The CA Culprit profile options determine the report format, date format, and other site-specific characteristics.

For more information about the profile options or overriding the options at runtime, refer to the chapter PROFILE Parameter.

CA Culprit uses default values for the profile options after installation. To change the installation default refer to the section Update Installation Default Profile Options.

This section contains the following topics:

Keywords and Operands

Update Installation Default Profile Options

Keywords and Operands

Block/Track Option

(z/VSE systems only) The BT option specifies the number of blocks per track for CA Culprit work files written to disk.

BT={ 1 ◄─
     2
     4
     8}

CALC Key Sign Option

The CALSIN option specifies whether to store IDMS CALC keys with an F or C sign.

CALSIN={F ◄─
        C }

F-Specifies packed decimal IDMS CALC keys are stored with an F sign.
C-Specifies packed decimal IDMS CALC keys contain a C sign.

Headers Option

The CCH option specifies whether to force headers.

CCH={ N ◄─
      A
      G }

N-Specifies no headers are forced when a detail or total lines specifies a carriage control of 1. Headers print only when the specified lines per page for the report is exceeded or when a control break occurs for a sort field with a break code on 1.
A-Specifies headers are always printed whenever a detail line or total line specify a carriage control of 1.
G-Specifies headers are forced by a line printing with a carriage control of 1 only if it is a total line and the totals being printed are grand totals.

Assembly Date Option

The DATE option specifies the PROFILE assembly date.

DATE=mm/dd/yy

mm/dd/yy

Specifies the date the PROFILE CSECT was assembled.

This option should always be specified for diagnostic purposes.

Buffer Size Option

The DICTB option specifies report buffer size.

DICTB=buffer-size-n

buffer-size-n

Specifies the record size that is used for reports generated for the Data Dictionary Reporter and for IDMS-DC reports.

Default: 1000

Maximum: 32767

Lines Per Page Option

The DLLP option specifies the number of lines per page on each diagnostic list.

DLLP=lines-per-page-n

lines-per-page-n-

Specifies the number of lines per page that prints in the CA Culprit diagnostic listings. This option does not affect the number of lines per page in output reports.

Default: 55

Date Stamp Option

The DS option specifies the format of the date stamp that appears on CA Culprit listings and user output reports.

DS= { A
      E
      C
      H )

Note: For more information about date stamp see the chapter PROFILE Parameter.

Error Options

The following error options specify the number of errors to be reported and the manner in which errors are processed. If this option is used in the MACRO, the option must be entered as indicated in the syntax shown below:

{ EE=
  IE=
  ME=      (error-count-n, return-code-n {I  {D )
  OE=                                     A   N}
  PE=                                     S}
  SE=  }

Note: For more information about error options see the chapter PROFILE Parameter.

Report Error Level Option

The EX option specifies the error codes under which CA Culprit will read and report on the user's input files.

EX= { W
      E
      N }

Note: For more information about this option see the chapter PROFILE Parameter.

Hexadecimal Dump Option

The HD option specifies the format in which hexadecimal dumps issued by the extended error handling facility are to appear.

HD= { V
      H 
      D }

Note: For more information about this option see the chapter PROFILE Parameter.

IDMS Buffer Size Option

The IDMSB option specifies the buffer size for CA IDMS access.

IDMSB=record-size-n

record-size-n

Specifies the buffer size reserved for IDMS database accesses when the record size field is omitted from the INPUT parameter.

Default: 1000

Maximum: 32767

DDNAME Modification Option

(z/OS systems only) The IN0 and IN4 options are used to change CA Culprit step ddnames.

{ IN0=    (ddname,00,' ',00)
  IN4= }

ddname: Specifies the ddname to which the step is to be changed. The default is SYSIN.

IN0 and IN4 specify the CA Culprit step whose ddname is changed as follows:
IN0-CULP0 step
IN4-CULP4 step

Report Lines Per Page Option

The LP option specifies the maximum number of lines per page for all user reports.

LP=lines-per-page-n

Note: For more information about this option see the chapter PROFILE Parameter.

Line Size Option

The LS option specifies the line size for all printed reports.

LS=line-count-n

Note: For more information about this option see the chapter PROFILE Parameter.

Numeric Editing Option

The MONEYED option specifies American or European numeric editing.

MONEYED= { A
           E }

A-Specifies the default numeric editing is to be done in the American fashion, that is, decimal digits separated from integer digits with a period, and integer digits separated into groups of three with commas, for example, 1,000.52.
E-Specifies European editing, that is, decimal digits separated from integer digits with a comma, and integer digits separated into groups of three with a period, for example, 1.000,52.

Tape Records/Block Option

(z/VSE systems only) The RB option specifies the size of CA Culprit work files written to tape.

RB= (records/blocks): Specifies the size of CA Culprit work files written to tape, expressed in 780-byte records per block.

Return Codes Option

The RC option specifies the return codes associated with the four levels of CA Culprit messages.

RC=(return-code-n..)

Note: For more information about this option see the chapter PROFILE Parameter.

Relocating Loader Option

(z/VSE systems only) The RELO option specifies if a relocating loader is present.

RELO= { Y ◄─
        N }

Y: Specifies the operating system has a relocating loader.
N: Specifies the operating system does not have a relocating loader.

Schema Name Option

The SCHMREQ option specifies whether a schema name is required.

SCHMREQ= { Y
           N ◄─}

Y: Specifies the schema name is required. The schema version remains optional.
N: Specifies the user can omit coding the schema name when entering the SS= operand on the INPUT parameter for access of a CA IDMS database.

Repeat First Page Option

The SF option specifies whether to repeat the first page of printed output on special forms.

SF= { N
      E }

Note: For more information about this option see the chapter PROFILE Parameter.

SPIE/STXIT Routine Option

The SPIE option specifies whether to enable the SPIE/STXIT routine.

SPIE= { Y ◄─

N }

Y: Specifies CA Culprit extended error handling SPIE/STXIT routine is enabled.
N: Specifies the SPIE/STXIT routine is disabled. Program check errors that normally are trapped by CA Culprit result in immediate abnormal termination of the job.

File Characteristics Option

The S work-file-n option specifies the file whose default characteristics are to be overridden.

S work-file-n=(filename, logical-unit-n, file-type, dtf-code) -

work-file-n

Specifies the SYS number of a CA Culprit work, input, or key file whose default characteristics are to be overridden.

The following are the valid codes:

These codes correspond to the name SYS002, SYS003, and so on.

Filename

Specifies the filename (z/VSE) orddname (z/OS) to be used for this file.

logical-unit-n

Specifies the logical unit number associated with this file. Valid values are from 1 through 256.

z/OS users must code a value to satisfy the MACRO, but CA Culprit ignores the value.

file-type

Specifies the type of file. Valid codes are T (tape), D (disk), and blank enclosed in single quotation marks (indicates a LUB/PUB lookup).

z/OS users must code a value to satisfy the MACRO, but CA Culprit ignores the value.

dtf-code

A two-character hexadecimal code representing the one-byte DTF code of the device for the file. FF (the default) indicates that a LUB/PUB lookup is performed.

z/OS users must code a value to satisfy the MACRO, but CA Culprit ignores the value.

Time Stamp Option

The TS option specifies whether a time stamp is to appear on parameter listings and user reports. If this option is specified, all three values must be included, as indicated by the following syntax:

TS=( { Y   }, { Y   }, { Y   } )
       N ◄─      N ◄─      N ◄─

Note: For more information about this option see the chapter PROFILE Parameter.

Separator Character Option

The TSEP option specifies the hour/minute separator.

TSEP= { : ◄─
        / }

:: Specifies to use a colon to separate hours from minutes on a time stamp.
/: Specifies to use a slash to separate hours from minutes on a time stamp.

Source Library Option

The PARMLIB option specifies the source library that CA Culprit uses for =COPY and =MACRO parameters.

PARMLIB=source-library-a

For source-library-a, specify one of the following values:

STANDARD: Specifies the source library is a source statement library (z/VSE) or a partitioned data set (z/OS).
PANVALET: Specifies the source library is a CA Panvalet for z/OS library or a CA Panvalet for z/VSE library.
LIBRARIAN2: Specifies the source library is a CA Librarian for z/OS r2 library or a CA Librarian for z/VSE r2 library.
LIBR30: Specifies the source library is a CA Librarian for z/OS r3 library or a CA Librarian for z/VSE r3 library.
LIBRARIAN3: Specifies the source library is a CA Librarian for z/OS r3.1 and above library or a CA Librarian for z/VSE r3.1 and above library.

CA Panvalet File Option

(z/VSE systems only) The PANFILE option identifies the logical unit number and devices that CA Culprit uses for accessing a CA Panvalet for z/VSE library with =COPY and =MACRO parameters.

PANFILE='logical-unit-number=device-type1-a,device-type2-a'

Default: PANFILE='SYS006=333-,3330'

Note: The single quotation marks are required.