Brocade Fabric OS Command Reference Guide v6.1.0 (53-1000599-02, June 2008)

Table Of Contents
436 Fabric OS Command Reference
53-1000599-02
portCfg
2
ficon Use this command to enable or disable FICON emulation in an FCIP tunnel
and modify associated parameters onan FCIP tunnel on a 'virtual' E_Port.
This command is supported only on a Brocade 7500/FR4-18 platform. A
feature key is required to enable any of the FICON emulation processing. The
tunnel must be down or disabled to issue and process the FICON commands.
The result of executed commands are persistent. The syntax for portCfg ficon
is as follows:
portCfg ficon [slot/]Ge_Port tunnel_Id config |delete [FeatArgs] [ParamArgs]
This command has the following operands:
tunnel_Id Specifies the tunnel ID for the configuration change. Range 0-7.
config Creates or modifies a FICON configuration.
delete Deletes an existing FICON configuration.
The following optional feature arguments are supported with the config and delete
options. These configurations are persistent.
-x 1|0 Enables or disables XRC emulation. 1 is enabled, O is disabled. FICON
XRC Emulation allows XRC (IBM eXtendedRemote Copy, also known as
IBM z/OS Global Mirroring) to operate effectively at extended distances.
-w 1|0 Enables or disables Tape Write Pipelining. This feature improves the
performance of certain applications when writing to tape over extended
distances. 1 is enabled, O is disabled.
-r 1|0 Enables or disables Tape Read Pipelining. This feature improves
performance for certain applications when reading from FICON tape over
extended distances. 1 is enabled, O is disabled.
-t 1|0 Enables or disables TIN/TIR emulation. This feature enhances recovery
when a TIN/TIR exchange occurs as part of a channel recovery operation
during tape emulation. 1 is enabled, O is disabled.
-l 1|0 Enables or disables Device Level Acknowledgement emulation. This
feature is applicable to both FICON Disk and Tape configurations. The
feature removes one network round trip for exchanges that end with a
Device Level Acknowledgement frame from the device. 1 is enabled, O is
disabled.
-i 1|0 Enables or disables FICON Tape Read Block ID. This feature permits
FICON write channel programs containing embedded read block ID
commands (Cadres) with a byte count of exactly four bytes to be
processed as emulated commands during write emulation processes. 1
is enabled, O is disabled.
The following optional parameter specific arguments are supported with the config and
delete options.
-a |--wrtMaxPipe value
Defines the maximum number of tape write channel commands (CCWs)
that can enter the write pipeline for a single device whether all the CCWs
are bundled in a single channel program or in multiple channel
programs. The setting has significance only for host (channel) initiated
operations at this side and does not affect tape write operations initiated