The ACFUTFEP utility front ends one text file (the intercepted file) with another (the interceptor file). The output produces a file combining the intercepted and interceptor files. When you later load the output file (for example, to generate a module or DCSS), specified CSECT or ENTRY points in the intercepted text refer to a corresponding interceptor CSECT or ENTRY.
The syntax of this utility is:
ACFUTFEP fileid1 fileid2 [fileid3] [(options)]
File identifier of the input (intercepted) text file. Operands include fni fti fmi|*.
fni
Required. Filename of the intercepted program.
fti
Required. Filetype of the intercepted program.
fmi|*
Required. Filemode of the intercepted program. An asterisk uses the first file found in the CMS search order with the specified fni and fti values of fileid1.
File identifier of the output (interceptor) text file. Do not use this identifier with the RESTORE option; it terminates the ACFUTFEP program with an error message. Operands include [fnf|*|= [ftf|*|= [fmf|*|=]].
fnf
Required. Filename of the interceptor program.
ftf|*|=
Optional. Filetype of the interceptor program. Default is TEXT. If you specify an asterisk (*), ACFUTFEP uses the default value TEXT. An equal sign (=) uses the fti value of fileid1.
fmf|*|=
Optional. Filemode of the interceptor program. An asterisk (*) uses the first file found in the CMS search order with the specified fnf and ftf values of fileid2. An equal sign (=) uses the fmi value of fileid1.
File identifier of the output text file. Operands include [fno|= [fto|= [fmo|*|=]]].
fno|=
Optional. Filename of the output text file. If you specify an equal sign (=), ACFUTFEP uses the fni value of fileid1.
fto|=
Optional. Filetype of the output text file. You cannot use a filetype of TEXTIBM; this is reserved for saving the original file. If you specify an equal sign (=), ACFUTFEP uses the fti value of fileid1.
fmo|*|=
Optional. Filemode of the output text file. Default is an asterisk (*). If you specify an asterisk (*), ACFUTFEP uses the fmi value of fileid1 unless minidisk is read-only, then it uses the mode A. If you specify an equal sign (=), ACFUTFEP uses the fmi value of fileid1.
Valid options are listed below:
OLD
This program previously processed the intercepted file fileid1 and has CA ACF2 for z/VM intercepts or an interceptor program, or both.
NEW
The intercepted file fileid1 does not contain CA ACF2 for z/VM intercepts or an interceptor program. If it does, ACFUTFEP issues an error message and processing halts.
REPLACE
Replace any file with the same identifier as the output file fileid3.
RENAME
Change the filetype to TEXTIBM to rename a file with the same identifier as the output file fileid3. The filename remains unchanged.
RESTORE
Restore the intercepted file fileid1 to the condition before it was front ended. You cannot specify the interceptor file fileid2. ACFUTFEP ignores the INTERCPT (also INTERCEPT) option. It sets the OLD option.
NOHISTORY
Do not insert history records into the output file fileid3. If you select this option, this program cannot process the output file again without the results being unpredictable. Use with caution.
Specifies the intercepted CSECT or ENTRY in fileid1 and the corresponding interceptor CSECT or ENTRY from fileid2. You can use a slash (/) to separate More than one fileid1 and fileid2 pair. If any other options follow the INTERCPT (also INTERCEPT) list, a slash (/) must follow the last operand in the list. You can repeat the INTERCPT|INTERCEPT option multiple times, once for each intercept. If you never specify the option, by default the intercepted CSECT or ENTRY being is in fileid1 and the interceptor CSECT or ENTRY comes from fileid2.
|
Copyright © 2009 CA Technologies.
All rights reserved.
|
|