Name

ocp − copy file data

Syntax

ocp [−f] [−i] [[−D document-type] [−C universal-class] [−S string-significance] [−M max-string-length]] [−X create-password] [−T trace-file] [−A] [−c (concurrency-access:lock[,...])] [−s security-group] [−F future-file-size] [−m] [−N] [−I]
 
[application-address::]file1 [application-address::]file2
 

Description

The ocp command can be used to copy files from a remote system to a local system, from a local system to a remote system, or from a remote system to a remote system.  Local to local file copies are not supported by ocp. The remote systems specified in the last case may be the same or different systems.

Unlike the Digital Unix dcp command, the FTAM for DECnet for Digital Unix ocp command does not use ASCII, binary, or image as terms to describe FTAM file types.  Instead, FTAM describes these characteristics in terms of document types that are specified using the −D option.  The −a and −i options of the DIGITAL UNIX dcp command will be supported through the new document type option by specifying FTAM-1 for stream text files (ASCII) and FTAM-3 for stream binary files (binary or image).

If the −D, -C, -S, and −M options are not specified by the user, the ocp command will create the destination file as an FTAM-3 file with a string significance of not significant and a maximum string length of 512.  If the −D option is specified without the other FTAM file type options, then the default values for those other options are:

For FTAM-1 files (any stream text files):  the universal class number is General string, the maximum string length is unlimited, and the string significance is not significant. 

For FTAM-2 files (any stream text files):  the universal class number is GraphicString, the maximum string length is unlimited, and the string significance is not significant. 

For FTAM-3 files (any files that are not stream text files):  the maximum string length is 512 and the string significance is not significant. 

Users can use the −D, -C, -S, and −M options to override the default file options.  However, the −C, -S, and −M options may be specified only if the −D option is specified. 

Options

−f Forces existing destination pathnames to be removed before copying, without prompting for confirmation.  The −i option is ignored if the −f option is specified.  This option is the default. 

−i Prompts users with the name of a file whenever the copy will cause an old file to be overwritten.  A yes answer will cause ocp to continue.  Any other answer will prevent it from overwriting the file.

−D document-type
Allows the user to override the default document type of FTAM-3 with one of the following flags.  Note that these flags are not case-sensitive.

FTAM-1 indicates that the FTAM-1 document type be used. 
FTAM-2 indicates that the FTAM-2 document type be used. 
FTAM-3 indicates that the FTAM-3 document type be used. 

−C universal-class
May only be used when −D is also specified. Allows the user to override the default file contents (universal class number parameter).  General is the default value if the FTAM-1 document type is specified.  The default value is 1aphic if the FTAM-2 document type is specified.  The following flags are possible.  Note that these flags are not case-sensitive. 

IA5
graphic
visible
General
Printable

−S string-significance
May only be used when −D is also specified. Allows the user to override the default string significance parameter of 0 using any of the following flags.  Note that these flags are not case-sensitive. 

v specifies that string significance is variable. 
f specifies that string significance is fixed. 
n specifies that string significance is not significant. 

−M max-string-length
May only be used when −D is also specified. Allows the user to override the default maximum string length parameter of unlimited for FTAM-1 and FTAM-2 files and 512 for FTAM-3 files. 

−X create-password
Used to specify the password that an FTAM responder might require before creating a file on its file system.  It is used by an FTAM responder to validate that the specified user has permission to create files on the current system.

−T trace-file
Specifies that a trace file be created with the indicated file name.  You must use the ositrace command to analyze this trace file.

−A Specifies that file1 be appended to file2. 

−s Allows the user to implement FTAM security group functions.  These functions only apply for local to remote, or remote to remote file copying. 

The syntax for the -s option is:
-s ’(action-list=(access-request [,access-request...]);

[concurrency=(ca-name:ca-key[,ca-name:ca-key...]);]

[passwords=(apwd-name:apwd-string[,apwd-name:apwd-string...]);]

[identity=user-identity-string;]

[legal-qual=legal-qual-string;])’

The following explains the -s syntax rules:

You can enter the security group parameters as a string list
on the command line, or you can create a file containing your security group parameters, and enter this filename as an argument to the -s option.

If you specify the security group as a string list on the command
line, it must be enclosed within single or double quotes.  All white space then appearing within these quotes is ignored.

The entire security string must be enclosed within parentheses,
and multiple entries within the parenthesis must be separated by commas.

You can abbreviate parameter values as long as there are enough
characters for a unique value.

You can use a backslash to continue any portion of the security group
specification onto a new line.  This applies to both when the security options are specified as a string list on the command line, and when the security options are specified from within a file.

You can specify more than one security group, however you must flag
each new group list element with its own -s option.  Note that the legal qualification parameter can only be specified once.

The following describes the valid parameters for the security group
options:

The access-request list is mandatory.  All other security group
parameters must be a sub-list of the action-list.  Valid access-request names are read, insert, replace, extend, erase, read-attribute, change-attribute, and delete-file.

The concurrency access names (ca-name) are optional, but when used
must be separated from the concurrency key by a colon.  If you have more than one concurrency access and key parameter pair, separate each pair with a comma.  Valid (ca-name) names are read, insert, replace, extend, erase, read-attribute, change-attribute, and delete-file.

Valid ca-key names are not-required, shared, exclusive, and
no-access. The access password (apwd-name) name is optional, but when used must be separated from the password string by a colon. Valid (apwd-name) names are read, insert, replace, extend, erase, read-attribute, change-attribute, and delete.

Access password strings (apwd-string) can be entered as either
graphic strings or octet strings.  See the explanation for password in the application-name command variable.

Identity of user user-identity-string must be a graphic string. 
See the explanation for user in the application-name command variable.

legal-qual-string conveys information about the legal status of the
file and its use (must be a graphic string).

−N Allows the user to create a file with defered availability. 

−I Allows the user to create a file with immediate availability.  Note that if both options (-N and -I) are specified. the second option overrides the first. 

−c (concurrency-access:lock)
Specifies concurrency access and lock parameter pairs for concurrency control. Do not use spaces between the parentheses.  If you use spaces, enclose the parameter values within quotation marks.  If you have more than one concurrency access and lock parameter pair, separate each pair with a comma. You can abbreviate parameter values as long as there are enough characters for a unique value.  The default value for the  lock parameter is not-required for all concurrency access parameters.  You can change the default by using the following values for concurrency access and lock. 

file1 Specifies the file to be copied.  If it is a remote file, the application name must be included as part of the file specification. 

file2 Specifies the file to which the input file is to be copied.  If it is a remote file, the application name must be included as part of the file specification. 

See Also

ocat(1), pr(1), omv(1)