|
|
|
|
Use the following command syntax to invoke ACOPY:
acopy [] FromFile ToFile
One file (either the FromFile or the ToFile) resides on the local machine, and the other file resides on the remote machine:
The order in which you specify the files determines the direction of the copy (the first named file is copied to the second named file).
Specify the local file as filename.
Specify the remote file as destination name: filename. (For more information about specifying a destination name, see Destination Names.)
You use the same command to send and receive files. If the first named file is on the local node, ACOPY sends it to the remote node. If the first named file is on the remote node, ACOPY receives the file on the local node. Be sure that the parameter that identifies the remote file includes an identifier for the remote system.
For example, to send a local file named name1.c to a remote system named CPINET.LUNAME and save it as filename name2.c, enter the following:
acopy name1.c CPINET.LUNAME: name2.c
In this example, CPINET.LUNAME (an identifier for the remote system) consists of an LUNAME on the CPINET network. The colon (:) following the LU name separates the remote system identifier from the file name. The identifier for the remote system can be a fully qualified partner LU name (as in the example), a CPI-C symbolic destination name, or an alias stored in the APPC Name Server (see Destination Names).
Enter the following command to receive the same file from the same remote system:
acopy CPINET.LUNAME:name2.c name1.c
To limit access to ACOPY by unauthorized users, you can configure conversation-level and resource security for the copy of the target program (AFTPD) that resides on your system (refer to the SNAP-IX Administration Guide). If security is configured for your system, you must specify the option and the option. For information about these and other ACOPY options, see ACOPY Options. See also Using AFTP (and ACOPY) When Security Is Required.
Following are the restrictions for using ACOPY:
You can specify only one file to copy from and one file to copy to. To perform more complex copying operations, use AFTP .
One of the two named files must be a remote file, and the other must be a local file. It is not possible to copy files local-to-local or remote-to-remote.
To use the system without specifying a user ID and password,
you must set up an anon
account and disable conversation-level
security. (For more information about disabling security, refer to the SNAP-IX Administration Guide.)
The ACOPY options are as follows:
Specifies the user ID that is sent to the remote system. The UserID can be one to eight characters in length. One indication that the remote transaction program requires security is if you receive the CPI-C error message
CM_SECURITY_NOT_VALIDwhen attempting to copy a file. If you have conversation-level security configured for your system, this option is required.
Specifies the password that is sent to the remote system. This option is required when a user ID has been specified or if you have security configured for your system. The Password can be one to eight characters in length. If you do not enter a password after specifying a user ID, ACOPY will prompt you to specify one.
The transfer mode name. The default ModeName is #BATCH.
The TP name that runs on the remote system (target TP). The default TPName is AFTPD.
This option overrides the security option. By default, ACOPY sends the user ID of the running process to the remote system. If the remote system is not configured to require security, this option stops a user ID from being sent. If the remote system is not configured to require security, use this option if you receive the error message
CM_SECURITY_NOT_VALID.
This option specifies that data should be transferred in binary format.
This option specifies that data should be transferred in ASCII text format. This is the default file transfer mode, but you can configure the transfer mode default to be either ASCII or binary depending on the file type being transferred. For more information, see AFTP Configuration.
If you specify any of the options more than once, the system uses the last one entered.
To get help on using ACOPY, enter either of the following commands:
acopy ?
acopy -h
acopy -help
|
|
|
 |
|