Specifies the parameter type. It must be coded starting in column 2.
Profile options can be coded in any column after PRO or PROFILE. Any number of options can be coded in any order. An option cannot be repeated.
Represents the expanded syntax explained below.
For an explanation of site-specific-options, see the expanded syntax rules below.
For an explanation of error-options, see the expanded syntax rules below.
Note: For more information on numeric errors and the extended error-handling facility, see the CA Culprit for Messages and Codes Guide.
Expansion of Format-options
Specifies the line size for all printed reports in a CA Culprit run. Under z/OS and z/VM, at a z/VM installation, line-size must be in the range 1 through 150; under z/VSE, it must be in the range 1 through 132. The default is 132 characters for each line of output. Line-size can be changed for individual reports by coding record-size on the OUTPUT parameter.
Specifies the maximum number of lines, excluding the title and headers, on each page of all reports in the CA Culprit run. The number must be in the range 1 through 32767. The default is 55 lines to a page. Lines-per-page can be changed for individual reports by coding the LP= specification on the OUTPUT parameter.
Refers to special forms output.
The SF= option is useful only when spooling is not in effect for printed output.
(Default) Indicates that the first page of output is not reprinted.
Indicates that the operator is to be prompted with a console message to mount special forms. The first page of output is reprinted as often as requested. This specification allows special forms to be properly aligned in the printer.
Indicates whether a time stamp, in hh:mm format, is to appear on CA Culprit parameter listings and output reports. If a time stamp is requested, it appears immediately after the system date.
The first indicator pair (Y/N) after the equal sign represents the time stamp on the Sequential Parameter Listing; the second indicator pair (Y/N) represents the time stamp on the Input Parameter Listing; the third indicator pair (Y/N) represents the time stamp on all titled user reports.
The default for each indicator pair is N; N specifies no time stamp. If one of the above indicators is specified, all three must be specified.
If a PROFILE parameter containing a TS= specification is the first CA Culprit parameter entered in a run, the time stamp appears on all pages of the Sequential Parameter Listing. If a PROFILE parameter containing a TS= keyword expression is not the first CA Culprit parameter entered in a run, the time stamp appears on every page except the first page of the Sequential Parameter Listing.
Specifies the format of the date stamp that appears on all CA Culprit parameter listings and output reports.
(Default) Specifies the American standard date format mm/dd/yy.
Specifies the European standard date format dd/mm/yy.
Specifies the Canadian date format yy/mm/dd.
Specifies the hajreh (Arabic) date format.
Specifies the format of hexadecimal dumps produced by the extended error-handling facility.
(Default) Specifies a vertical dump format. Alphanumeric characters print above the zone and digit portions of each character.
Specifies a horizontal dump format. The zone and digit portions of each character alternate across a line on the left side of the output page; the alphanumeric characters print on the right side of the output page.
Note: The following report shows sample horizontal and vertical hexadecimal dumps. For more information on the extended error-handling facility, see the CA Culprit for CA IDMS Messages and Codes Guide.
Generates dumps in a vertical format using a DBCS character set.
mm/dd/yy RUN TIME MESSAGES Vnn.n PAGE 1 INVALID NUMERIC DATA ENCOUNTERED IN REPORT 01 ERROR OCCURRED DURING PROCESSING DETAIL LINE 1 FIELD 3 MOST RECENT SUBSCRIPT VALUE 0 INPUT BUFFER NUMBER 1 RECORD BUFFER DUMP CHAR TERRY CLOTH THERMOREGULATION HUMIDITY CONTROL CLK ZONE ECDDE44444CDDEC44444444444444ECCDDDDCCEDCECDD4444CEDCCCEE4CDDEDDD4CDD00000030004 DIGIT 359980000033638000000000000003859469574313965000084494938036539630332000000800C0 01...5...10....5...20....5...30....5...40....5...50....5...60....5...70....5...80 mm/dd/yy RUN TIME MESSAGES Vnn.n PAGE 1 INVALID NUMERIC DATA ENCOUNTERED IN REPORT 01 ERROR OCCURRED DURING PROCESSING DETAIL LINE 1 FIELD 3 MOST RECENT SUBSCRIPT VALUE 0 INPUT BUFFER NUMBER 1 RECORD BUFFER DUMP POSITION ADDRESS STORAGE 00001 12A7C0 E3C5D9D9 E8404040 4040C3D3 D6E3C840 40404040 40404040 40404040 40E3C8C5 *TERRY CLOTH THE* 00033 000020 D9D4D6D9 C5C7E4D3 C1E3C9D6 D5404040 40C8E4D4 C9C4C9E3 E840C3D6 D5E3D9D6 *RMOREGULATION HUMIDITY CONTRO* 00065 000040 D340C3D3 D2000000 00000038 00000C40 *L CLK.......... *
Indicates American or European numeric editing.
(Default) Specifies that default numeric editing is to be done according to the American standard, where decimal digits are separated from integer digits with a period, and integer digits are separated into groups of three with commas. For example, 1,000.52.
Specifies that default numeric editing is to be done according to the European standard, where decimal digits are separated from integer digits with a comma, and integer digits are separated into groups of three with a period. For example, 1.000,52.
Specifies the default format in which social security numbers will appear when using an FS edit mask.
Formats social security numbers using the date stamp (DS) option. This is provided for upward compatibility.
Formats social security numbers in American format: nnn-nn-nnnn.
Formats social security numbers in Canadian format: nnn-nnn-nnn.
Default: D
Expansion of Site-specific-options
Indicates the CA Culprit processing mode under which the program is to run, as described below.
Insures that programs written and previously run under Release 5.0 produce the same results when run under CA Culprit Releases 6.0 and later.
(Default) Uses the full capabilities of the most current release of CA Culprit (Release 6.0 and later). Programs written and previously run under CA Culprit Release 5.0 may yield different results when executed under RELEASE=6.
Specifies the source library accessed for all reports in a run.
If this specification is omitted from a run that contains a USE parameter, =COPY parameter, or =MACRO parameter, source code is retrieved from the library member named in the PARMLIB= keyword expression during the last assembly of the CULL-PROF macro.
Note: For more information on the CULL-PROF macro, see the Installation Guide for your operating system.
(Default) Indicates that the source is retrieved from a z/VSE source statement library (SSL), a z/OS partitioned data set (PDS) source library; the source can be retrieved from a z/VM MACLIB or a z/OS PDS.
Indicates that the source is retrieved from the CA Panvalet library.
Indicates that the source is retrieved from a CA Librarian Release 3.0 or greater library.
Specifies the management (MCD) code of the master file. It is required to access modules in PROD2 status. This code is not printed in any CA Culprit listings.
(z/OS only) Enables users without a relocating loader to identify self-relocating user modules so that CA Culprit can load those modules at the most advantageous core location.
Module-name must be the name used in the linkage editor PHASE statement when the module was link edited. Module names specified by the SR= option are added to the list of self-relocating CA-supplied and user-coded modules that is established at installation time. As many as 12 self-relocating modules can be specified by the user.
(IDD users only) Specifies the security password associated with a user defined to IDD. This PROFILE parameter option is required when IDD security features are in effect; the password is not printed in any CA Culprit listings.
(IDD users only) Specifies the name of a user defined in IDD. This PROFILE parameter option is required when IDD security features are in effect. The PROFILE parameter must appear before the INPUT parameter if USER is required because the user is validated immediately after the INPUT parameter is read.
Expansion of Error-options
Specifies the error conditions under which CA Culprit is to read and report on one or more user input files.
Note: For more information on severity codes associated with processing errors, see the CA Culprit for CA IDMS Messages and Codes Guide.
(Default) Indicates that reports are produced only if no E- or F-level errors are encountered in the run. If E- or F-levels are encountered during verification of the input parameters, input file processing is canceled. The compile phase is completed to allow input parameter validation, but the input file is not read.
Indicates that E-level errors can occur without canceling the extract phase. Reports that contain no errors and reports that contain only W-level errors are generated. Reports that contain E-level errors are not generated. If any report contains an F-level error, the extract phase is terminated.
Indicates that the input files are not read and that no reports are generated. This option allows input parameter validation only.
Specifies four return codes associated with four severity codes: I, W, E, and F, respectively. Each return code must be in the range 0 through 4095. The default for each code is 0. However, if one return code is specified, all four codes must be explicitly stated even if the default value is taken.
When CA Culprit executes as a five-step job, a return code specification affects the job execution of each operating system:
When CA Culprit executes as a one-step job in z/OS, z/VSE, and z/VM environments, a nonzero return code specification affects the job execution:
Note: (z/OS, z/VM, and z/VSE users) If a nonzero return code is issued for I-level and W-level messages, the job will be canceled since CA Culprit always issues informational messages and often issues W-level messages.
Specifies the maximum number of numeric errors to be reported by the extended error-handling facility during SELECT/BYPASS parameter processing. Error-count must be a number in the range 0 through 32767; the default is 25.
Specifies the maximum number of numeric errors to be reported by the extended error-handling facility during processing of match keys in a match-file run. Error-count must be a number in the range 0 through 32767; the default is 25.
Specifies the maximum number of numeric errors to be reported by the extended error-handling facility during the extract phase of processing. Error-count must be a number in the range 0 through 32767; the default is 25.
Specifies the maximum number of numeric errors reported by the extended error-handling facility during execution of a user input module. Error-count must be a number in the range 0 through 32767; the default is 0.
Specifies the maximum number of numeric errors reported by the extended error-handling facility during execution of a user procedure module. Error-count must be a number in the range 0 through 32767; the default is 0.
Specifies the maximum number of numeric errors reported by the extended error-handling facility during the output phase of processing, including execution of a user output module (if any). Error-count must be a number in the range 0 through 32767; the default is 0.
Indicates the action to be taken in the event that one of the error thresholds described above is exceeded.
The expanded syntax is explained below.
Expansion of Error-action
Allows processing to continue after the specified limit is exceeded; additional errors are not reported. The end-of-file statistics show the total number of errors encountered. IGNORE is the default action for SE=, ME=, and EE= specifications.
Forces end-of-file processing when the specified limit is exceeded. For each keyword expression described above except OE=, STOP has the same effect as a STOP-RUN statement in type 7 or type 8 procedure logic. When STOP is specified for OE=, only the current report is terminated.
Causes abnormal termination of the CA Culprit phase if the specified limit is exceeded. ABEND is the default action for IE=, PE=, and OE= specifications. CANCEL may be used as a synonym for ABEND.
(z/OS only) Is an optional value that specifies the abend condition.
Return-code must be a number in the range 0 through 4095. The default is 0 for SE=, ME=, and EE= specifications; it is 999 for IE=, PE=, and OE= specifications.
Causes a dump for the abend condition; NODUMP suppresses a dump. NODUMP is the default for SE=, ME=, and EE= specifications; DUMP is the default for IE=, PE=, and OE= specifications.
Examples
Sample PROFILE parameters are shown and described below.
Example 1
PROFILE HD=H LS=70 LP=40
All reports associated with this PROFILE parameter have a maximum of 40 lines (excluding the title and headers, if any) for every page of output. Each line has 70 characters. Any hexadecimal dumps that are generated by the extended error-handling facility have a horizontal format.
Example 2
PROFILE SE=25,ABEND,12,DUMP RC=0,0,0,16
If more than 25 numeric errors are encountered during SELECT/BYPASS processing, the job step terminates. When the step terminates, CA Culprit generates a return code of 12 and produces a dump. Although 25 errors is the default value, it must be specified on this PROFILE parameter because subsequent defaults within the expression are changed (that is, ABEND overrides IGNORE, 12 overrides 0, and DUMP overrides NODUMP).
If CA Culprit encounters F-level errors, it generates a return code of 16. In this example, return codes for I-, W-, and E-level messages must be explicitly stated because a nonzero return code for F-level errors is requested.
At a z/VSE installation, the job cancels at the end of the job phase in which CA Culprit encounters an F-level error. At z/OS and z/VM installations running five-step CA Culprit jobs, the return code can be coded on JCL statements to control the execution of subsequent CA Culprit steps.
Example 3
PROFILE EX=E RC=0,4,8,12
Reports that are error-free are generated regardless of the occurrence of E-level errors in other reports. Reports with I- and W-level errors only are considered to be error free.
One return code is specified for each error severity level; that is, 0 for I-level messages, 4 for W-level messages, 8 for E-level messages, and 12 for F-level messages.
At z/OS and z/VM installations, if I-, W-, and E-level messages are detected in a single processing phase, a code of 8 (the highest applicable code) is returned for that step. At a z/VSE installation, a W-level error cancels the job at the end of the step in which the error is detected. This action occurs because the PROFILE specifies a nonzero return code for W-level errors.
Example 4
PROFILE DS=E EE=50 TS=N,N,Y * $THESE REPORTS ARE FOR DISTRIBUTION TO ALL EUROPEAN AFFILIATES
In this example, as many as 50 numeric errors that occur during the extract phase are reported; any additional numeric errors that occur during this phase are ignored.
The date appears on parameter listings and reports in the European format, dd/mm/yy. The time stamp appears on all titled reports but not on parameter listings. A continuation line is coded to accommodate a long comment.
Example 5
PROFILE USER=CLK PW=PERU
For IDD users, a user name and password are submitted to IDD in order to access files defined to the data dictionary.
Example 6
PROFILE PARMLIB=LIBRARIAN3
This example specifies that parameters copied by a USE parameter, =COPY parameter, or =MACRO parameter are to be copied from a CA Librarian library.
|
Copyright © 2014 CA.
All rights reserved.
|
|