Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004
Transfers or copies a disk file from one node to another (or within a single node). User must have both read and lock access to the source file. (CM)
[sourcefile [sfileloc][to[targetfile] [tfileloc][; opt]..]] DSCOPY [+[sfileloc] [to[tfileloc][; opt]...] ] [+ opt [; opt]... ]
sourcefile The name of the file to be transferred. You may optionally include a lockword, group name, and account name. The sourcefile can be a formal designator defined in a prior file equation. The formal designator must be preceded by an asterisk if a file equation is used. sfileloc A node specification for the source file can be specified in the following format. [delim1 [location]]["["[logon]"]"] [delim2 device] Brackets within quotes are required. The first delimiter (delim1) is either a colon (:) or a comma (,). The location parameter is either a node name or a previously defined environment id. Logon must be a valid logon sequence for the node in question, including all necessary passwords. If specified, the logon is used to create a temporary remote session on the node. Note that brackets ([]) are required around the logon sequence. Delim2 is either a comma (,) or a pound sign (#). The device parameter is the device class name of a disk device (default DISC). If delim1 and location are omitted, then the default is the global specification of the source file location or, if no global specification is currently in effect, the local node name. If delim1 appears without a location, the local node name is used whether or not there is a global specification. If you specify an individual or global logon, it is used to create a new session even if a session already exists on the node in question (in the specified remote environment). If the logon parameter and its surrounding brackets are omitted, the default is the global logon sequence. If no global logon is currently in effect, and there is no current remote session, the default is the logon sequence specified in a prior DSLINE command for this remote environment (in the LOGON= option). If you include the brackets but omit the logon, then a global logon specification is ignored and the DSLINE logon specification (or existing session if there is one) is used. The order of priority (from high to low) is: the specified logon, global logon, existing session, DSLINE logon. + Indicates a global option that affects all subsequent file transfers until overridden by CLEAR or a new global option. to Either the word TO or a semicolon (;). If sfileloc ends with a colon (:), not followed by a node name or environment id, you must use the semicolon (;) form. targetfile The name of the file (with optional lockword, group name, and account name) into which the source file will be copied. The targetfile can also be a formal designator defined in a prior file equation, as long as an asterisk precedes the target file. You can specify a KSAM file pair in the tfile parameter by enclosing a pair of names (separated by a comma) in quotation marks. The file equation can redirect the target file to the temporary domain by specifying the disposition parameter ';TEMP'. In this case, you cannot use domain parameters such as NEW, OLD, and OLDTEMP, nor can you use the disposition parameter ;DEL. Below is an example of redirection to the temporary domain: FILE targetfile=targetfile;TEMP DSCOPY sourcefile;*targetfile DEFAULT If the file name is omitted, the corresponding source file name is assumed. If the group and/or account names are omitted, corresponding portions of the target node session are assumed. tfileloc A node specification for the target file, with the same syntax and DEFAULTS as the sfileloc. [delim1 [location]]["["[logon]"]"] [delim2 device] You can specify alternate disk devices for a KSAM file pair by enclosing a pair of device names (separated by a comma) in quotation marks. [delim2 "dev1,dev2"]. opt Any of the following options (available only over nodes linked by a Local Area Network). The following parameters are mutually exclusive SEQ and DIR; APP, MOVE, OVER, and REP; FIX and VAR; and ASC and BIN. NOTE * indicates the option invokes Interchange Format. APP * Appends the source file to the existing file specified as a target file. ASC * Causes the target file to contain ASCII data. BIN * Causes the target file to contain binary data. CHECKPT= Where <cspec>= [interval] cspec [,[restart id file][,record]]] Initiates checkpointing during a transfer. CLEAR Clears all global specifications issued up to that point (not including specifications after CLEAR on the same line). COMP Causes the source file to be compressed before being transferred. Compression minimizes the space required to represent sequences of repeated characters. The data are decompressed before they are written to the target file. DIR * Causes the target file to be organized to allow direct access. FCODE=<sfilecode> Gives the file code for the source file. In order to copy a privileged file (for example, an IMAGE data base), you need to supply the appropriate negative file code in this option. You must have system manager or Privileged Mode capability in order specify a negative file code. FIX * Causes the target file to contain fixed length records. FSIZE=<filesize>* Specifies the size of the target file in records. ICHAR=<char>* Defines the character (char) to be inserted at the end of each logical record in a file copied to an HP-UX system. INT * Files are copied using Interchange Format. MOVE Purges the source file after a successful transfer. (Otherwise the file will be copied but the source file will remain.) OVER Causes a copy of the source file to be written over an existing target file, beginning with the first record. If the source file EOF is less than the target file EOF then the target file EOF will not change. The excess data in the target file is preserved ("write save"). The attributes of the source and target files must match. If the target file does not exist, a new file is created. QUIET Suppresses extraneous output such as the "% complete" message. REP (replace) Purges the existing target file and replaces the target file with a copy of the source file. If the target file does not exist, a new file is created. RESTART= Where <rspec>= <restart id> rspec or rspec= restart id file [,[record]]. Restarts an interrupted transfer which was initiated using the CHECKPT option. RSIZE=<recsize> Specifies the length (in bytes) of the target file records. SCHAR=<char>* Specifies the character (char) used to delimit logical records in files copied from HP-UX systems. SDEV=source_device Names the disk device on the source node where the source file resides. The device name can also be included in the file location specification. SEQ * Opens the target file for sequential access. SHOW Shows global specifications currently in effect (not including specifications after SHOW on the same line). STRIP Removes padding from the ends of records when creating the target file. TDEV=target_device Names the disk device on the target node where the target file is written. The device name can also be included in the file location specification. VAR * Causes the target file to be composed of variable length records. + opt Indicates that the following specifications are global. All specifications except file names may be made global. These remain in effect until a new, conflicting global specification is issued or the CLEAR option is used. Individual, non-global specifications override global specs for one transfer only. Global specifications are cleared when the DSCOPY subsystem terminates. If an invalid or unsupported keyword is specified as a global option, NFT ignores any options that follow. Options preceding the invalid option will not be ignored.
The DSCOPY command enables you to copy one or more files between systems. With DSCOPY you can copy a file and store the file on the same node, or on another node in the network. The location from which you issue the transfer request is independent of the source and target locations. Global specifications are indicated by placing a "+" before the specification. Global specifications take effect for all subsequent transfers until, or unless, one of the following conditions occurs: o A new global specification which conflicts with the old one is given. For example, if REP is specified globally, it will override and cancel a prior OVER global specification currently in effect. o An item given in an individual, non-global transfer specification conflicts with a previous global specification. This item will override the global specification for this one transfer only. o The CLEAR option is used. This clears all global specifications currently in effect (not including further specifications on the same line after the CLEAR). o The DSCOPY subsystem is terminated. All specifications except file names can be made global in this manner. The REP and OVER options override each other. Specifying a new SDEV or TDEV , or issuing "SDEV=" or "TDEV=" without a device name, clears a previous global source or target device. The only way to clear MOVE, COMP, or QUIET is to use CLEAR. If all source and target parameters are omitted, or if the command begins with "+" (global), you will receive a subsystem prompt consisting of the string DSCOPY. (You can also issue global specifications within the subsystem.) You may then submit a series of transfer requests interactively. After each transfer you will receive another prompt. File transfer requests are read from your terminal unless you specify that you want the requests to be read from a (command) file. To do this you must issue a file equation that equates the specified command file to the formal file designator DSCOPYI (for example FILE DSCOPYI=CMNDFILE). The file must be unnumbered. You may invoke the DSCOPY help facility by typing a question mark in response to the DSCOPY prompt. An ampersand (&) at the end of a line allows you to continue a command on the following line. To cancel the current line, or to interrupt a transfer, type "Control-Y." To terminate the subsystem from the DSCOPY prompt enter either "//" or "Control-Y."
Local to Local DSCOPY SFILE TO TFILE or DSCOPY SFILE ;TFILE Remote to Local (* Assumes Session was set up on remote node via Virtual Terminal *) DSCOPY FILEA:REMNODE TO FILEB or DSCOPY FILEA,REMNODE TO FILEB Local to Remote DSCOPY FILEY TO FILEZ:REMNODE[REMUSER.REMACCT] Remote to Remote (* Assumes Session was set up on REMNODE via Virtual Terminal *) DSCOPY FILE17,REMNODE TO FILE18,REMNODE Global Specifications DSCOPY + REMNODEB TO REMNODEA; MOVE; COMP (* "+" denotes global specifications. Command moves THISFILE on REMNODEB to THATFILE on REMNODEA. COMP denotes active data compression *) DSCOPY THISFILE TO THATFILE Back to Main Index