VUCP(1,C) AIX Commands Reference VUCP(1,C) ------------------------------------------------------------------------------- vucp PURPOSE Receives NETDATA files. SYNTAX +--------+ +------+ +-------------------+ vucp ---| +----+ |---| |---| +--------+ |---| +-| -b |-+ +- -r -+ +- file -| |-+ +----+ +- dest -+ +------+ +--------+ vucp ---| | | |---| +- -q -+ +- file -+ Note: This command is for the System/370 only. DESCRIPTION The vucp command is used to interpret and translate (if required) a NETDATA file. The result is directed to dest. The actual transmitted spool file is left unchanged in your netfile directory. This allows you to process the file using different translate tables (this can be helpful if an error occurs during the reading in of the file). Because the file is left in the netfile directory, you are responsible for deleting that file. You can do this, for example, by using the AIX/370 rm command. If a file was sent via the uvcp command, the specified translation option is included in the transmitted file. This option determines vucp command processing, unless explicitly overridden by you through the use of the translation options. The conditions are: o The translation table specified via the environment variable NLIN is used to translate the file from EBCDIC to ASCII. o The -b option was used by the uvcp command. No translation occurs. If acknowledgement was requested and the vucp command is invoked without the -q option, an acknowledgement is returned to the sender. DEFAULTS FOR THE VUCP COMMAND The defaults for the vucp command are: Processed November 8, 1990 VUCP(1,C) 1 VUCP(1,C) AIX Commands Reference VUCP(1,C) o Translation to ASCII by using the translation table specified in your environment variable NLIN. If the file was transmitted using the uvcp command, the specified translate option is included in the transmitted file and determines the translation default. Note: If you have selected a language that supports multibyte characters, the environment variable NLIN is not used. Translation to one of the supported file or network code sets is done by checking the current locale. For information on supported code sets, see "iconv." o No overwrite of an existing file with the same name. o Standard input is used, if the file parameter is omitted. o Standard output is used, if the dest parameter is omitted. RESTRICTIONS o The NETDATA protocol allows multiple files to be included in one transmission. The vucp command only reads the first file of such a transmission. The uvcp sends multiple files one by one. o If you try to use the vucp command for a non-NETDATA file, an error message such as the following is displayed: UVC107 vucp: INVALID INPUT FORMAT You must interpret the correct format of the file. FLAGS -b Specifies that a binary file is being received. New-line characters are not inserted in the output file and no translation is performed. -r Specifies that the newly created output file is to replace any existing file with the same name. Unless this option is specified, processing stops and you receive this error message if a file with the same name as the output file exists: UVC201 vucp: FILE file name ALREADY EXISTS, SPECIFY -r OPTION The existing file is not overwritten. file Identifies the file name of the file to be received. If a qualified path name is specified for the file, it is used. Otherwise, the current working directory is searched. If the file is not found there, the Processed November 8, 1990 VUCP(1,C) 2 VUCP(1,C) AIX Commands Reference VUCP(1,C) $HOME/netfile directory is searched. You can have more than one file waiting and you must specify which file you want. You must have read access to the file. dest Specifies where the received file is to be placed. If dest is a directory, it is used to store the file with the file name contained in the transferred file's data record. If dest is an absolute path name, the directory and the file name contained in that path name is used. If dest is not specified, the file is directed to the standard output. -q Specifies that the file name, the sender, the node, and the date and time of sending is displayed. The type of file is also displayed if the file was sent via the uvcp command. There are two types of files: text file was translated using the default translate table. binary file was not translated or was translated using a translate table other than the default table. When using this option, the file is not actually received; therefore, acknowledgement (if requested) is not sent. FILES /usr/lib/nls/nlin Directory containing the EBCDIC/ASCII translation facility. RELATED INFORMATION See the following commands: "uvcp," "iconv," and "rdrdaemon." Processed November 8, 1990 VUCP(1,C) 3