Purpose
Copies stored code and modifies copied or inline code.
Syntax
Col 1 ▼ ►►─── =COPY ─┬─ member-name ─────────────────┬─┬────────────────────────┬─────► ├─ 'module-name' ─┬───────────┬─┤ └─ Rptno= report-number ─┘ │ └─ version ─┘ │ └─ * ───────────────────────────┘ ►─┬─────────────────────┬────────────────────────────────────────────────────►◄ └┬─ INput ───┬─ = NO ─┘ └─ FilCard ─┘
Syntax Rules
Identifies an =COPY parameter. It must be coded starting in column 1.
The entire statement must be contained on one line. One or more spaces must separate =COPY from the variable information that follows. =COPY cannot be specified in a report that specifies the USE parameter. The =COPY parameter cannot be nested; therefore, it cannot be specified in stored code.
Identifies the source of code to be modified.
The name by which the stored code is accessed, as follows:
The accessed code must be stored in a library prior to run time and made available to the precompile phase of CA Culprit processing. The code must be stored with a record length of 80 bytes.
If the PARMLIB= option is coded on a PROFILE parameter that appears before the USE parameter, the parameters are copied from the library specified on the PARMLIB= option. Otherwise, the parameters are copied from the library selected as the default for PARMLIB at installation time.
Note: For more information on system defaults, see the CA IDMS Installation Guide for your operating system.
(IDD users only) Specifies a 1- to 32-character alphanumeric expression, enclosed in single quotation marks, that identifies the module containing stored code.
Specifies the module version number; if no value is specified, CA Culprit uses the highest version number known to the data dictionary for module-name.
Indicates that parameters entered directly in the input parameter stream are to be modified. The =COPY parameter applies to all parameters immediately following it up to the next =COPY or =MACRO parameter (if any).
A keyword expression that changes the report number coded in columns 2 and 3 of all inline or copied parameters to the number specified by report. Report-number must be a number in the range 00 through 99.
Only one report number can be associated with an =COPY parameter. Parameters that do not contain a report number, such as input definition parameters, are not affected by an =COPY parameter that specifies RPTNO=.
A keyword expression that suppresses delivery of the INPUT parameter in copied code. If this expression is used, an alternative INPUT parameter must be supplied before the =COPY parameter.
FILCARD may be used as a synonym for INPUT.
Examples
Sample =COPY parameters are shown and described below.
The following report shows a sample Sequential Parameter Listing created by CA Culprit during the precompile phase in response to an =COPY parameter. The listing prints plus signs (+) before each line of copied code.
mm/dd/yy SEQUENTIAL PARAMETER LISTING Vnn.n PAGE 1 00 ** SYSIN ** IN 80 INSTALLATION SECURITY OPTION IS NO =COPY RECS ┐ + REC EMP-NAME 1 25 'EMPLOYEE' 'NAME' │ Parameters copied + REC EMP-LNAME 11 10 │ from library member + REC DEPARTMENT 30 20 ├── RECS + REC TITLE 50 20 │ + REC SALARY 70 10 3 DP=2 │ 01SORT DEPARTMENT,1,TITLE ┘ 01410010 DEPARTMENT 0151*010 TITLE 0151*020 EMP-NAME 0151*030 SALARY
The following report shows the Input Parameter Listing generated after the sample Sequential Parameter Listing. On this listing, no distinction is made between parameters included by the =COPY parameter and those in the input parameter stream.
mm/dd/yy INPUT PARAMETER LISTING Vnn.n PAGE 1 ******** INPUT RECORD TYPE BLOCK FILE DESCRIPTION... ******** INPUT 00080 F ******** REC START SIZE TYPE DP FIELD-NAME RECORD-NAME,LEVEL ******** REC 00030 020 DEPARTMENT REC 00011 010 EMP-LNAME REC 00001 025 EMP-NAME 'EMPLOYEE' 'NAME' REC 00070 010 3 2 SALARY REC 00050 020 TITLE ******** SORT BREAK A/D SORT FIELD-NAME ******** 01 SORT 1 DEPARTMENT TITLE ******** EDIT LINE CC COLUMN VALUE OR FIELD-NAME AND EDIT OPTIONS... ******** 01 4 1 0010 DEPARTMENT ******** EDIT LINE CC COLUMN VALUE OR FIELD-NAME AND EDIT OPTIONS... ******** 01 5 1 *010 TITLE 01 5 1 *020 EMP-NAME 01 5 1 *030 SALARY EXTRACT WILL BE PERFORMED PROFILE OPTION IN EFFECT: RELEASE = 6
Example 1
=COPY PARAMETERS RPTNO=14
CA Culprit parameters are copied from library member PARAMETERS. The report number of all report-specific parameters is changed to 14.
Example 2
=COPY * RPTNO=02
06OUT D
063'STUDENT ACCOUNTS'
0651*010 NAME
- ◄More inline code
-
=MACRO *
=MEND
-
- ◄-More inline code
In this example, the inline code between the =COPY and =MACRO parameters is modified. Report number 06 is changed to 02.
Example 3
INPUT 80 F 400 PS(3375) =COPY INPUTPARAMS IN=NO
Except for any INPUT parameters, all of the parameters contained in library member INPUTPARAMS are copied. An alternative INPUT parameter is provided before the =COPY parameter.
|
Copyright © 2014 CA.
All rights reserved.
|
|