AIX命令参考大全，卷 2，d - h

fxfer 命令

用途

在本地系统和主机间传输文件，主机通过 HCON 连接。

语法

重新启动中断了的文件传输

fxfer -R [ -n SessionName ]

从主机下载文件

fxfer [ -n SessionName ] [ -a | -r ] [ -d ] [ -c | -C ] [ -J ] [ -f FileName ] [ -F ] [ -H HostType ][ -I InputField ] [ -q ] [ -t [ [ -l ] [ -s ] [ -b ] ] | -T [ [ -l ] [ -s ] [ -b ] ] ]

[ -v ] [ -x HostLogin ] [ -e ] [ -X CodeSet ] SourceFile DestFile

向主机上载文件

fxfer [ -n SessionName ] [ -a | -r ] [ -u ] [ -c | -C] [ -J] [ -f FileName ] [ -H HostType ] [ -q ] [ -t [ [ -l ] [ -s] ] | -T [ [ -l ] [ -s] ] ] [ -l ] [ -s] [ -v ] [ -x HostLogin ] [ -X CodeSet ] [ -F | -V | -U ] [ -B BlockSize ] [ -L LoglRecLength ] [ -I InputField ] [ -S NumberUnits [ ,IncreaseUnits | ,IncreaseUnits,UnitType | ,,UnitType ] ] [ -M Volume] [ -N Unit] [ -k] SourceFile DestFile

显示帮助屏幕

fxfer -h

描述

fxfer命令在 本地系统 和大型机主机之间传输文件，大型机主机通过主机连接程序（HCON）进行连接。文件可以从 本地系统 传输到主机（上载），或者从主机传到 本地系统（下载）。 fxfer 命令将以 SourceFile 参数命名的文件传给以 DestFile 参数命名的文件。当 HCON 会话需要特定的会话概要文件或者现存的会话时，传输过程开始。

主机操作系统可以是 VM/CMS MVS/TSO CICS/VS （CICS/MVS 或者 CICS/VSE）VSE/ESA 或者 VSE/SP， 并安装上相应版本的 3270 文件传送程序（安装了 IND$FILE 或者等同物）。主机的文件传送程序版本由会话概要文件中的 File Transfer Program 取值来确定。fxfer 命令支持文本或二进制数据的传输。文件可以主机发出，也可以传给主机，可以包含 ASCII 或者 EBCDIC 译文，也可以不包含。

安全机制避免了未经授权的访问、已有文件的损坏和数据遗失。如果非 HCON 用户发出 fxfer 命令，此命令失败。如果 fxfer 命令在结束前被中断，则传输状态保存在 RESTART 文件中。

如果 fxfer 命令和 -h 标志一起发出，则显示帮助屏幕。如果此命令和 -R 标志一起发出，则搜索 $HOME 目录下的重新启动文件。如果存在重新启动文件，则显示重新启动菜单，启用文件传输的重新开始。如果 -h 和 -R 标志没有指定，此命令试着执行指定的文件传输。

fxfer 命令信息包括：

• 标记
• 主机文件特征标志
• 示例
• 文件

此命令需要：

• 一个或多个适配器，用于连接大型机主机。
• 一个要安装在主机上的大型机操作系统，这些操作系统包括：
  • VM/SP CMS
  • VM/XA CMS
  • MVS/SP TSO/E
  • MVS/XA TSO/E
  • CICS/VS（CICS/MVS 或者 CICS/VSE）
  • VSE/ESA
• 大型机主机支持的文件传送程序（ IND$FILE 或者其等同物）被安装在大型机上。

使用 fxfer 命令的会话概要文件

fxfer 命令和 HCON 会话互相通信，并可能需要一个特定的会话概要文件。会话概要文件定义了：

• 和主机的通信路径
• 主机类型
• 缺省文件传输方向（下载或者上传）
• 恢复时间
• 文件传送等待周期

当 fxfer 命令执行自动登录时，概要文件也可定义：

• 主机登录标识符
• AUTOLOG 节点标识符
• AUTOLOG 跟踪开关状态
• AUTOLOG 超时值

用户一般在调用 fxfer 命令时指定会话概要文件。当此命令从已有会话的子 shell 运行时发生异常。在这种情况下，如果用户没有指定会话概要文件， fxfer 命令使用已有的会话。如果正确的会话没有运行， fxfer 命令就调用新的会话。

fxfer命令搜索 HCON 会话，如下：

• 当不用 -n SessionName 标志时，
  • 如果 fxfer 命令从已有会话的子 shell 发出，命令使用和此子 shell 相关的会话（在 $SNAME 环境变量中定义）。
  • 如果不是从仿真器会话的子 shell 发出， fxfer 命令则发出错误消息并且终止。
• 当和 -n SessionName 标志一起发出时，文件传输在指定的会话上执行。如果不存在指定的会话，命令在会话概要文件中搜索此会话。如果找不到指定的会话概要文件， fxfer 命令发出错误消息并且终止。如果存在指定的概要文件， fxfer 命令尝试自动登录主机，通过使用会话概要文件中定义的 AUTOLOG 值，此值使用 -x 标志来定义，或者通过提示用户输入必要的登录信息。

中断和重新启动的文件传送

fxfer 命令可以在结束前通过运算符或者不可恢复的通信错误来中断。如果中断了，此命令在 RESTART 文件中保存传输状态。传输可以从开始处重新开始，而不会丢失数据。

如果在传输中断后开始传输其它新的文件， fxfer 命令则发出 RESTART 文件已被创建的信号，并且显示如下选项：

• 重新启动中断文件的传输。
• 保存 RESTART 文件并退出文件传输程序。
• 删除 RESTART 文件并退出文件传输程序。
• 删除 RESTART 文件并继续当前的传输。

fxfer 命令和 -R 标志配合使用也可以重新启动中断了的文件传输。

如果在以自动登录开始的文件传输过程中主机通信丢失或者断开，可以通过重新连接登录到主机上以恢复文件传输。恢复时间由会话概要文件中的 File Transfer Recovery Time 取值确定。一旦主机重新建立连接，文件传输从开始处继续。如果通信不能重新建立，文件传输程序生成一个 RESTART 文件。

如果显式文件传送和主机之间的通信丢失，用户必须重新启动仿真器会话，并且在重新启动文件传输前登录回主机。

源文件和目标文件

fxfer 命令 SourceFile 和 DestFile 参数是必需的。 SourceFile 参数为文件传输指定了源文件。 DestFile 参数为文件传输指定目标文件。本地系统 文件名使用普通格式。主机文件名遵从主机命名约定，它是以下格式之一：

标志

注：双字节字符集（DBCS）支持日本英语、日本片假名、韩国语或者繁体汉语，注意事项有：

• 如果指定了 DBCS -l 或者 -s 标志，以下翻译标志之一（ -t -T或者 -J）也必须指定，否则 DBCS 标志就被忽略了。
• -M ， -N ，和 -k 标志只在 MVS/TSO 主机中使用。
• -e 标志只有在 CICS 用于下载时有效。
• -b 标志只有在下载时有效。

-I   "FILE=TS)   This   is   a   comment"

UserID,AutologNodeID[,Trace,Time   .   .   .]

主机文件特征标志

以下标志指定了主机文件特征，它们只可以用于上传文件（-F 标志除外，它可在从 VSE 主机中下载时使用）：

-S   NumberUnits,IncreaseUnits,UnitType

-S   NumberUnits,IncreaseUnits

-S   NumberUnits

-S   NumberUnits,,UnitType

示例

以下示例为会话 a 采用的会话概要文件为：

Session   type         DFT
Communication   device         3270c0
Language         English   (U.S.A.)
Host   type         CMS
File   transfer   direction         up
File   transfer   wait   period         10
File   transfer   recovery   time         30

此处：

• host type 是 VM/CMS。
• 通过 DFT 3270 连接设备进行连接。
• 文件传输的缺省方向为上传 （使用会话概要文件 a 来下载文件，用户必须指定 -d 标志和 fxfer 命令）。
• 文件传输过程保持 10 分钟登录状态。
• 如果传输中断，传输进程在 30 分钟内尝试恢复连接，然后将信息保存到 RESTART 文件中，以便后续传输。
• 解释语言为 U.S.A. ASCII-EBCDIC。
  1. 要上载 samplefile 文件（当前目录下）至主机，并且使用 U.S.A. 转化表将它转化为 EBCDIC 输入：

     fxfer   -n   a   -t   samplefile   "test   file   a"

     • -n 通知 fxfer 命令使用 a 会话传输文件。
     • -t 指示 fxfer 命令使用 new-line 字符进行转化。
     转化后的数据放在主机上的 a 测试文件中。因为主机文件名包含空格，文件名需要用引号括起来。
  2. 要将 file2 文件上传到 VM/CMS 主机下的 test file b ，请输入：

     fxfer   -urv   -L   132   -V   -H   CMS   file2   "test   file   b"

     • -u 指示 fxfer 命令上传此文件。
     • -H 表明主机类型为 VM/CMS。如果目标文件存在，它将被传输文件替换（因为指定了 -r 标志）。
     • -v 让 fxfer显示传输的字节数和用时。终端上显示了状态或者诊断输出。
     • 如果主机文件不存在，主机文件的最大逻辑记录长度设置为 132 字节（ -L 标志）。
     • 主机文件记录的格式是变量（ -V 标志）。没有进行转化。
  3. 从 a 仿真器会话的子 shell，要把 本地系统 /etc/motd 文件上传到 CICS motdfile 主机文件，同时进行转换并填充空格，请输入：

     fxfer   -utFH   CICS   -I   ")This   is   a   comment"   /etc/motd   "motdfile"

     • -u 通知命令上传文件。
     • -t 从 ASCII 到 EBCDIC 进行转化。
     • -F 使传输程序在上传文件填充空格到 80 列（缺省记录长度）。要修改缺省列，使用 -L 标志和不同的记录长度（列）。
     • -H 指定主机为 CICS 类型。
     • -I 指定 InputField 的值被添加到 IND$FILE 命令中去。
     在这个例子中，“This is a comment”是主机注释字段。

     使用 fxfer 命令上传或者下载文件时，到或者从当前环境外的 TSO 环境必须有其它环境的授权。需要使用单引号（'），然后双引号（"）来修饰文件（或数据集）。

  4. 例如，上传文件 newfile 到 TSO 环境，其中完整的限定名称是 sys4.parmlib.samplefile ，请输入：

     fxfer   -urtvH   TSO   'newfile'   "sys4.parmlib.samplefile"

     • -u 通知命令上传文件.
     • 如果 sys4.parmlib.samplefile 文件存在，它将被替换（ -r 标志）成newfile文件的转化后内容（ -t 标志）。
     • -v 通知 fxfer 命令每隔几秒将文件传输状态写到本地屏幕上。
     • -H 通知 fxfer 命令主机是 MVS/TSO 主机。

       注： 此示例假定 fxfer 命令是从已有会话的子 shell 发出（使用 e789 命令建立会话）。

  5. 从 MVS/TSO 主机下载文件 spfuser.test 至 本地系统输入：

     fxfer   -n   a   -d   -r   -H   TSO   spfuser.test   samplefile1

     • -n 通知 fxfer 命令使用会话 a 传输文件。如果会话 a 还没有创建，命令试图自动登录。因为没有指定主机登陆标识， fxfer 命令检查会话概要文件寻找登录标识。如果还没有指定登录标识，则提示用户输入登录标识和密码。
     • -d 重设缺省的文件传输方向，缺省为上载。
     • 如果samplefile1 文件已经存在，它将被从主机上下载的文件替换掉（ -r 标志）。
     • -H 通知 fxfer 命令主机为 MVS/TSO 主机而不是 VM/CMS（在会话概要文件中的缺省值）。
     传输文件放在 samplefile1 文件中，在 本地系统 里。文件传输是同步执行的。
  6. 下载 VM/CMS 主机test file a 并把它附加在 本地系统 中的 mydir/samplefile 文件后，使用会话概要文件 a 并自动登录，请输入：

     fxfer   -n   a   -dat   -q   -f   status.out
     -x   laura,vm1,trace   "test   file   a"   mydir/samplefile

     • -n 通知 fxfer 命令使用会话概要文件 a 来传输文件。
     • -x 提供主机登录标识。 fxfer 命令首先检查会话是否已经建立在 本地系统 上了。如果是，此命令在已有会话的基础上传输文件。如果会话 a 还没有建立。 fxfer 命令通过使用主机登录标识 laura 和自动登录脚本 vm1 来自动登录，并跟踪登录活动。提示用户输入密码。此命令传输文件。
     • -dat 通知 fxfer 命令下载文件（-d 标志），使用 U.S.A. 转化表（在会话概要文件中定义）将数据从 EBCDIC 转化为 ASCII（-t 标志），并附加（ -a 标志）转化后的文件到 mydir/samplefile 文件中，此文件在 本地系统 里。如果 mydir/samplefile 文件不存在， fxfer 命令忽略 -a 标志并创建文件。
     • 状态和诊断输出放在 status.out 文件中，文件位于当前本地目录（ -f 标志）。
     • -q 通知 fxfer 命令异步传输文件。
     当用户输入密码，提示符返回并且在后台执行文件传输。

     要在同一个文件传输进程中增加另一个要执行的文件传输，请输入：

     fxfer   -n   a   -daq   -f   status.out   "test   file   b"   
     mydir/samplefile

     • -n 通知 fxfer 命令使用 a 会话来传输文件。因为 a 会话已经在前一个命令中创建了， fxfer 命令不需要再次登录主机了。
     • -d 通知此命令从主机上下载文件。
     • -a 通知此命令将 test file b 主机文件附加到 mydir/samplefile 文件后，此文件在 本地系统 中。
     • -q 通知 fxfer 命令异步传输文件。
     fxfer 命令继续将状态信息发送到 status.out 文件，此文件在 本地系统 中，（-f 文件）。

     注：

     1. 如果 fxfer 命令的文本超出了屏幕的边界，文本自动折到下一行。按下 Enter 键来折行文本将出错。
     2. 当在队列中有异步传输时启动同步文件传输将出错。
     3. 只要会话仍在运行，并且 dfxfer 进程仍然登录在主机上，就不会提示用户要求输入登录标识或者密码。进程保持登录状态的持续时间由会话概要文件中 File Transfer Wait Period 决定。

  7. 要从仿真器子 shell 重新启动中断了的文件传输，请输入：

     fxfer   -R

     -R 通知 fxfer 命令使用保存在某一 RESTART 文件中的信息执行文件传输。此 RESTART 文件是 $HOME/x_fxfer.r 显式重新启动文件或者 $HOME/i_fxfer.r 隐式重新启动文件。如果 -R 标志和其它文件传输标志一同指定，其它标志都被忽略。显示此 RESTART 文件传输菜单。使用此菜单，通知 fxfer 命令传输中断的文件。

  8. 通过命令行而不是从仿真器子 shell 来重新启动文件传输，请输入：

     fxfer   -R   -n   a

     -n 标志通知 fxfer 命令使用 a 会话执行重新启动后的传输。

文件

相关信息

SMIT 命令。

有关安装基于 Web 的系统管理器的信息，请参阅《AIX 5L V5.2 基于 Web 的系统管理器管理指南》中的『第 2 章：安装与系统需求』。