Programming Reference Manual - Public Support Login - Unisys

Copying Between Files
5.3.3. Source File Identifier
The source file identifier parameter names the file from which data is copied. The
named file must be a tape file for which the run of the calling program has read
privileges. See 2.3 for a full description of this parameter.
5.3.4. Destination File Identifier
This destination file identifier parameter names the file to which data is copied. The
named file must be a mass storage file for which the run of the calling program has write
privileges. See 2.3 for a description of this parameter.
5.3.5. Descriptor Return Area
With this parameter, PCFP returns the description of the logical file read from the tape
file. The size of this parameter is given by the item DESC_RTN_AREA_SIZE in the
function packet. Whenever DESC_RTN_AREA_SIZE = 0, PCFP ignores this parameter
and does not return the description of the logical file to the calling program. To return
the entire logical file description, the calling program must provide an area that is at least
15 words long. The descriptor return area is defined in element FP$RTN$SAFD.
Note: Figure 5–5 shows the new format that is returned when INTERFACE_LEVEL has
a value of at least FP_INTERFACE_LEVEL_2. New definitions must be used when using
the new interface level.
• For C users, the new definition name is fp_rtn_saf_desc_2_type.
• For COBOL users, the new definition name is FP-RTN-SAF-DESC-2.
• For FORTRAN users, the new definition name is FP$RTN$SAFD2.
If you modify an existing COPY_SAF_RAF or COPY_SAF_SAF function to use an
INTERFACE_LEVEL value of FP_INTERFACE_LEVEL_2, you must also modify the
descriptor return area definition to use the new definition name. For compatibility, the
current definition names are unchanged and describe the interface level1 descriptor
return area. The format of the interface level1 descriptor return area is described in
comments contained in the current definitions.
5–20 7830 9796–013