CISCO-FICON-MIB

All MIBs › CISCO-FICON-MIB

Organization: Cisco Systems, Inc.

Last Updated: 2006-04-07

Category: Cisco Devices, Fibre Channel and Storage, SNA and Legacy Protocols

Description: Provides management objects for FICON (Fibre Connection) ports used with IBM mainframe storage connectivity on Cisco MDS SAN switches.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

What Is CISCO-FICON-MIB?

CISCO-FICON-MIB manages FICON (Fiber Connection), the IBM mainframe storage connectivity standard, on Cisco MDS SAN switches acting as FICON Directors. It exposes configuration data for port swapping (remapping port numbers), port blocking, and VSAN-level FICON host control settings including the ability to take a switch offline for a given VSAN. This is primarily a configuration/administrative MIB for FICON Director behavior rather than a raw performance counter MIB, so its monitoring value is in confirming port swap mappings and VSAN host-control states are correctly applied, which is critical in mainframe environments where port numbering must match host-side FICON definitions exactly. It depends conceptually on Cisco's VSAN model used elsewhere in Cisco MDS Fibre Channel MIBs. It is deployed exclusively on Cisco MDS 9000 series SAN switches configured as FICON Directors in IBM mainframe data centers. Engineers can download the CISCO-FICON-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-FICON-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

Cisco MDS FICON Director SAN switches

Monitoring Examples

An administrator would check cficonPortSwapTable/cficonPortSwapEntry to confirm cficonSwapPortNumberFirst and cficonSwapPortNumberSecond reflect the intended port swap and that cficonPortSwapEntryStatus shows the swap is active. Checking cficonVsanTable/cficonVsanEntry's cficonVsanHostControlSwOffline flag would reveal whether a VSAN has been intentionally taken offline for host-initiated maintenance, explaining an unexpected loss of FICON connectivity to the mainframe.

What Can Be Monitored

port swap mapping status
port block/unblock configuration
VSAN host control offline state
default port block setting

Imported Objects

From CISCO-SMI

ciscoMgmt

OBJECT-IDENTITY

From CISCO-ST-TC

FcAddressId

From CISCO-VSAN-MIB

vsanIndex

OBJECT-TYPE

From IF-MIB

InterfaceIndex
ifIndex	OBJECT-TYPE

From SNMP-FRAMEWORK-MIB

SnmpAdminString

From SNMPv2-CONF

MODULE-COMPLIANCE
NOTIFICATION-GROUP
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Integer32
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

DisplayString
RowStatus
TEXTUAL-CONVENTION
TruthValue

How to Use in IPNetwork Monitor

Example using cfStatsFramePacingTime OID:

Select a Cisco MDS FICON Director SAN switch as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type cfStatsFramePacingTime into the Find box to locate it in the OID tree, selecting the specific row/instance you want to monitor since this is a table column, then select it and click OK. It reports the number of 2.5 microsecond units that frame transmission is blocked due to zero credit. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is a Counter32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
T/F cficonAutoSaveState	1.3.6.1.4.1.9.9.375.1.1.15	TruthValue	read-only	The object indicates whether auto save state is enabled or disabled. Enabling the auto save state, saves the configuration to the configuration file whenever a configuration change is made. If the cficonAutoSaveState is disabled (false), the configuration change is not saved to the configuration file.
cficonAutoSaveStateGroup	1.3.6.1.4.1.9.9.375.2.2.15			A collection of objects for the FICON configuration copy auto save operation.
INT cficonCfgFileCmd	1.3.6.1.4.1.9.9.375.1.1.5.1.5	INTEGER	read-create	The object to apply this configuration file to the VSAN identified by the vsanIndex. When reading this object, a noOp(2) is returned. open(3) opens this file for modifying. close(4) closes this file.
STR cficonCfgFileCmdErrorString	1.3.6.1.4.1.9.9.375.1.1.5.1.8	SnmpAdminString	read-only	The string describing the reason the the last 'apply' command failed. This string needs to be polled only in the case when the value of the cficonCfgFileCmdStatus is 'failed'.
INT cficonCfgFileCmdStatus	1.3.6.1.4.1.9.9.375.1.1.5.1.7	INTEGER	read-only	The object to describe the status of the last 'apply' command. success - The last apply command was successful. inProgress - The last apply command is still in the process of execution. failed - The last apply command failed. notApplicable - The last apply command status is not available.
STR cficonCfgFileCupName	1.3.6.1.4.1.9.9.375.1.1.13.1.1	SnmpAdminString	read-write	The name of CUP.
cficonCfgFileCupNameEntry	1.3.6.1.4.1.9.9.375.1.1.13.1		not-accessible	A cficonCfgFileCupNameTable entry. Each entry provides the CUP name for a VSAN (identified by vsanIndex) and a file (identified by cficonCfgFilename).
cficonCfgFileCupNameGroup	1.3.6.1.4.1.9.9.375.2.2.13			A collection of objects for the FICON CUP name for the vsan in the configuration files.
cficonCfgFileCupNameTable	1.3.6.1.4.1.9.9.375.1.1.13		not-accessible	A table listing the CUP names for each vsan in a configuration file.
STR cficonCfgFileDescr	1.3.6.1.4.1.9.9.375.1.1.5.1.2	SnmpAdminString	read-create	The description of the configuration file.
cficonCfgFileEntry	1.3.6.1.4.1.9.9.375.1.1.5.1		not-accessible	A cficonCfgFileTable entry. Each entry provides the configuration file for a vsan (identified by vsanIndex) and a file (identified by cficonCfgFilename). Each entry lists the file status, the time the file was last updated etc. The cficonCfgFileRowStatus object is used to create or delete a configuration file. For creation or deletion, only the cficonCfgFileRowStatus object needs to be set in the PDU. cficonCfgFileCmd object is used to apply this configuration file to the vsan specified by the vsanIndex. For example, To create a configuration file 'cfg' for vsan 1, the management application must do the following - cficonCfgFileRowStatus.1.cfg = createAndGo; To delete the configuration file, cficonCfgFileRowStatus.1.cfg = destroy; To apply this configuration file, cficonCfgFileCmd.1.cfg = apply;
cficonCfgFileGroup	1.3.6.1.4.1.9.9.375.2.2.5			A collection of objects for the per VSAN config file table.
STR cficonCfgFileLastUpdated	1.3.6.1.4.1.9.9.375.1.1.5.1.4	SnmpAdminString	read-only	The time this file was last updated. The format is as follows - Wed Nov 5 18:53:52.172485 2003
STR cficonCfgFilename	1.3.6.1.4.1.9.9.375.1.1.5.1.1	SnmpAdminString	not-accessible	The name of the configuration file.
ROW cficonCfgFileRowStatus	1.3.6.1.4.1.9.9.375.1.1.5.1.6	RowStatus	read-create	The rowStatus of this row.
INT cficonCfgFileStatus	1.3.6.1.4.1.9.9.375.1.1.5.1.3	INTEGER	read-only	The status of filename containing these ports. Network Management station must check this object before it can read the contents of the configuration file. If it is 'locked', it means that the host or the CLI or the network management station is in the process of writing the contents of this file. If it is 'locked' the the file cannot be read. If it is 'unlocked', then the file is ready to be read.
cficonCfgFileTable	1.3.6.1.4.1.9.9.375.1.1.5		not-accessible	A table listing the configuration files for each vsan.
cficonConfigCopyEntry	1.3.6.1.4.1.9.9.375.1.1.14.1		not-accessible	A config-copy request. A management station wishing to create an entry should first generate a random serial number to be used as the index to this sparse table. The station should then create the associated instance of the row status object. This config-copy operation is only to copy the running configuration to startup configuration for FICON. Once the appropriate instance of all the configuration objects have been created, either by an explicit SNMP set request or by default, the row status should be set to active to initiate the request. Note that this entire procedure may be initiated via a single set request which specifies a row status of createAndGo. Once the config-copy request has been created (i.e. the cfCopyEntryRowStatus has been made active), the entry cannot be modified - the only operation possible after this is to delete the row. Once the request completes, the management station should retrieve the value of the status object and should then delete the entry. In order to prevent old entries from clogging the table, entries will be aged out, but an entry will never be deleted within 5 minutes of completing.
cficonConfigCopyGroup	1.3.6.1.4.1.9.9.375.2.2.14			A collection of objects for the FICON configuration copy operation.
U32 cficonConfigCopyIndex	1.3.6.1.4.1.9.9.375.1.1.14.1.1	Unsigned32	not-accessible	Object which specifies a unique entry in the cficonConfigCopyTable. A management station wishing to initiate a config-copy operation should use a random value for this object when creating an instance of a cficonConfigCopyEntry.
cficonConfigCopyTable	1.3.6.1.4.1.9.9.375.1.1.14		not-accessible	A table of config-copy requests.
ROW cficonCopyEntryRowStatus	1.3.6.1.4.1.9.9.375.1.1.14.1.4	RowStatus	read-create	The status of this table entry. Once the entry status is set to active, the associated entry cannot be modified until the request completes (cficonCopyState transitions to successful or failed state).
STR cficonCopyFailReason	1.3.6.1.4.1.9.9.375.1.1.14.1.3	SnmpAdminString	read-only	An error string describing the reason the copy failed.
INT cficonCopyState	1.3.6.1.4.1.9.9.375.1.1.14.1.2	INTEGER	read-only	Specifies the result of this config-copy request. This value of this object is instantiated only after the row has been instantiated, i.e. after the cficonCopyEntryRowStatus has been made active.
T/F cficonDefaultPortBlock	1.3.6.1.4.1.9.9.375.1.2.1	TruthValue	read-write	This object indicates the default state which whether to prohibit traffic or allow traffic among all External Ports of a new FICON VSAN. If 'true' the default state is prohibit all traffic, else the default state is allow all traffic. The default values of the cficonProhibitPortNumbers and the cficonRunCfgProhibitPrtNums in a newly created FICON VSAN are consistent with the state of this object.
cficonDefaultPortBlockGroup	1.3.6.1.4.1.9.9.375.2.2.22			A collection of objects providing default port block state.
cficonDirHistEntry	1.3.6.1.4.1.9.9.375.1.1.9.1		not-accessible	A row in the cficonDirHistTable, identified by the vsanIndex and the key counter.
cficonDirHistGroup	1.3.6.1.4.1.9.9.375.2.2.9			A collection of objects for the Director History table.
I32 cficonDirHistKeyCounter	1.3.6.1.4.1.9.9.375.1.1.9.1.1	Integer32	not-accessible	The key counter.
OCT cficonDirHistPortNumbers	1.3.6.1.4.1.9.9.375.1.1.9.1.2	OCTET STRING	read-only	The list of ports that have configuration change for a value of cficonDirHistKeyCounter. If a port has configuration change, its bit position will be 1. Each octet within the value of an object of this type, specifies a set of eight ports, with the first octet specifying ports 1 through 8, the second octet specifying ports 9 through 16, etc. Within each octet, the most significant bit represents the lowest numbered port and the least significant bit represents the highest numbered port.
cficonDirHistTable	1.3.6.1.4.1.9.9.375.1.1.9		not-accessible	A table listing the director history buffer. Director History Buffer is a mechanism to determine those ports that have changed their configuration for a particular value of a key counter. The FICON Director maintains a change vector of 256 bits (32 bytes) and an associated key counter. This table lists this vector for a given key counter.
cficonInterfaceSwapEntry	1.3.6.1.4.1.9.9.375.1.1.20.1		not-accessible	A cficonInterfaceSwapTable entry contains 2 interface indices to be swapped among other objects. A management station wishing to create an entry should first obtain a unique serial number, e.g. get the cficonInterfaceSwapNextIndex scalar as the index to this sparse table. The station should then create the associated instance of the row status object. Note that when creating a row in this table, the cficonSwapPortEntryStatus, cficonSwapInterfaceIndexFirst and cficonSwapInterfaceIndexSecond are all required. The values of cficonSwapInterfaceIndexFirst and cficonSwapInterfaceIndexSecond should be different. If for any reason the new row can not be created, no swap action will be performed. If the table entry creation is successful, the value of cficonSwapInterfaceActionStatus will be pending(1) first and the SNMP response will be returned as success. When the swap starts, the value will be executing(2). After the swap action is done, the value will be either success(3) or failure(4). cficonSwapInterfaceFailReason contains the failure reason to indicate where the failure is from. cficonSwapInterfaceSystemError is a user readable description given by the failure causing sub-module. The management station should delete the entry after the value of cficonSwapInterfaceActionStatus being either success(3) or failure(4).
cficonInterfaceSwapGroup	1.3.6.1.4.1.9.9.375.2.2.21			A collection of objects providing port swap functionality.
I32 cficonInterfaceSwapIndex	1.3.6.1.4.1.9.9.375.1.1.20.1.1	Integer32	not-accessible	An arbitrary index for the swap command.
I32 cficonInterfaceSwapNextIndex	1.3.6.1.4.1.9.9.375.1.1.21	Integer32	read-only	Next unique index available for creating new entry in the FICON interface swap table.
cficonInterfaceSwapTable	1.3.6.1.4.1.9.9.375.1.1.20		not-accessible	This table provides a management application with the capability to swap the configuration of two specified interfaces. In FICON, a host associates a great deal of configuration data with a port-address. If the FICON port connecting the host to the switch has some problem and the user wants to connect the host to a different port in the switch, one needs to swap the configuration of the two ports. This command transparently swaps the configuration of two ports without affecting the host.
INT cficonLinkIncident	1.3.6.1.4.1.9.9.375.1.1.12.1.1	INTEGER	read-only	The type of link incident that occurred on an interface. bitErrThreshExceeded - Bit Error Threshold exceeded. lossOfSignalOrSync - Loss of Signal or Sync message. nosReceived - NOS msg Received NOS - Non Operational State primitiveSeqTimeOut - Primitive Timeout invalidPrimitiveSeq - Invalid Primitive sequence
INT cficonLinkIncidentClear	1.3.6.1.4.1.9.9.375.1.1.12.1.3	INTEGER	read-write	The object used to clear the link incident for an interface.
cficonLinkIncidentEntry	1.3.6.1.4.1.9.9.375.1.1.12.1		not-accessible	An entry listing the cficonLinkIncidentTable.
cficonLinkIncidentGroup	1.3.6.1.4.1.9.9.375.2.2.12			A collection of objects for the FICON incidents table.
cficonLinkIncidentTable	1.3.6.1.4.1.9.9.375.1.1.12		not-accessible	A table listing the link incidents in a FICON interface. A Link incident is an event when the interface experiences the conditions described in the cficonLinkIncident object.
STR cficonLinkIncidentTime	1.3.6.1.4.1.9.9.375.1.1.12.1.2	DisplayString	read-only	The time at which the link incident happened. The format is as follows - Wed Nov 5 18:53:52.172485 2003
OCT cficonLogicReservedPN	1.3.6.1.4.1.9.9.375.1.1.18	OCTET STRING	read-write	Reserved port numbers for logical ports. There can be up to 256 port numbers reserved for logical ports.
cficonNotificationGroup	1.3.6.1.4.1.9.9.375.2.2.17			A collection of FICON notifications.
CFI cficonPortAddr	1.3.6.1.4.1.9.9.375.1.1.3.1.1	CficonPortNumOrAddr	not-accessible	The Port Address of this port.
cficonPortAddrNumEntry	1.3.6.1.4.1.9.9.375.1.1.7.1		not-accessible	A cficonPortAddrNumTable entry. Each entry provides the port address to port number mapping.
cficonPortAddrNumGroup	1.3.6.1.4.1.9.9.375.2.2.7			A collection of objects giving association of a port address to port number and interface index of the port.
cficonPortAddrNumTable	1.3.6.1.4.1.9.9.375.1.1.7		not-accessible	A table listing the association of Port address to port number.
CFI cficonPortAddrPortAddr	1.3.6.1.4.1.9.9.375.1.1.7.1.1	CficonPortNumOrAddr	not-accessible	The port address of this port.
CFI cficonPortAddrPortNumber	1.3.6.1.4.1.9.9.375.1.1.7.1.2	CficonPortNumOrAddr	read-only	The port number of this port.
T/F cficonPortBlock	1.3.6.1.4.1.9.9.375.1.1.3.1.2	TruthValue	read-write	The object indicates whether to block or unblock this port. This is one of the port-connectivity parameters. If 'true' this port is blocked, else it is unblocked.
cficonPortEntry	1.3.6.1.4.1.9.9.375.1.1.3.1		not-accessible	A cficonPortTable entry. Each entry provides the information about a port, identified by cficonPortAddr, in the configuration file, identified by cficonPortFilename, on this VSAN, identified by vsanIndex.
cficonPortGroup	1.3.6.1.4.1.9.9.375.2.2.3			A group containing an object providing ficon port information.
NUM cficonPortIfIndex	1.3.6.1.4.1.9.9.375.1.1.6.1.2	InterfaceIndex	read-write	The interface index of this port. For ports that are not installed, this object would be zero.
NTF cficonPortInfoChange	1.3.6.1.4.1.9.9.375.0.1			A FICON Port Change notification is generated whenever the unit type of the port changes.
OCT cficonPortMap1	1.3.6.1.4.1.9.9.375.1.1.16.1	OCTET STRING	read-only	The port map1. This object contains information specific to third party vendor and the usage is vendor specific. Each record is 6 bytes long and there can be up to 42 records in this object. Each record consists of the following - 0-3 bytes - IfIndex byte 4 - Port Address byte 5 - Unit Type
OCT cficonPortMap2	1.3.6.1.4.1.9.9.375.1.1.16.2	OCTET STRING	read-only	The port map2. This object contains information specific to third party vendor and the usage is vendor specific. Each record is 6 bytes long and there can be up to 42 records in this object. Each record consists of the following - 0-3 bytes - IfIndex byte 4 - Port Address byte 5 - Unit Type
OCT cficonPortMap3	1.3.6.1.4.1.9.9.375.1.1.16.3	OCTET STRING	read-only	The port map3. This object contains information specific to third party vendor and the usage is vendor specific. Each record is 6 bytes long and there can be up to 42 records in this object. Each record consists of the following - 0-3 bytes - IfIndex byte 4 - Port Address byte 5 - Unit Type
OCT cficonPortMap4	1.3.6.1.4.1.9.9.375.1.1.16.4	OCTET STRING	read-only	The port map4. This object contains information specific to third party vendor and the usage is vendor specific. Each record is 6 bytes long and there can be up to 42 records in this object. Each record consists of the following - 0-3 bytes - IfIndex byte 4 - Port Address byte 5 - Unit Type
OCT cficonPortMap5	1.3.6.1.4.1.9.9.375.1.1.16.5	OCTET STRING	read-only	The port map5. This object contains information specific to third party vendor and the usage is vendor specific. Each record is 6 bytes long and there can be up to 42 records in this object. Each record consists of the following - 0-3 bytes - IfIndex byte 4 - Port Address byte 5 - Unit Type
OCT cficonPortMap6	1.3.6.1.4.1.9.9.375.1.1.16.6	OCTET STRING	read-only	The port map6. This object contains information specific to third party vendor and the usage is vendor specific. Each record is 6 bytes long and there can be up to 42 records in this object. Each record consists of the following - 0-3 bytes - IfIndex byte 4 - Port Address byte 5 - Unit Type
cficonPortMapEntry	1.3.6.1.4.1.9.9.375.1.1.16.8.1		not-accessible	The port map entry. This entry consists of a index number indicating a set of ports and a port map object carrying certain port attributes for these ports.
cficonPortMapGroup	1.3.6.1.4.1.9.9.375.2.2.16			A collection of objects for the FICON port maps.
cficonPortMapGroupRev1	1.3.6.1.4.1.9.9.375.2.2.18			A collection of objects for the FICON port maps.
I32 cficonPortMapIndex	1.3.6.1.4.1.9.9.375.1.1.16.8.1.1	Integer32	not-accessible	The port map index. This number indicates the group of ports described by the port map object.
I32 cficonPortMapMax	1.3.6.1.4.1.9.9.375.1.1.16.7	Integer32	read-only	Number of port map objects.
OCT cficonPortMapObj	1.3.6.1.4.1.9.9.375.1.1.16.8.1.2	OCTET STRING	read-only	The port map object. This object contains information specific to third party vendor and the usage is vendor specific. Each record is 7 bytes long and there can be up to 36 records in this object. Each record consists of the following - 0-3 bytes - IfIndex byte 4 - Port Address byte 5 - Unit Type byte 6 - Port Number
cficonPortMapTable	1.3.6.1.4.1.9.9.375.1.1.16.8		not-accessible	The port map table. This table contains the list of port map objects to carry the information of IfIndex, port Address, unit Type and Port Number for all ports.
STR cficonPortName	1.3.6.1.4.1.9.9.375.1.1.3.1.3	SnmpAdminString	read-write	The name of this port.
cficonPortNumAddrEntry	1.3.6.1.4.1.9.9.375.1.1.8.1		not-accessible	A cficonPortNumAddrTable entry. Each entry provides a mapping between the port number and its port number.
cficonPortNumAddrGroup	1.3.6.1.4.1.9.9.375.2.2.8			A collection of objects for the port number to port Address translation table.
cficonPortNumAddrTable	1.3.6.1.4.1.9.9.375.1.1.8		not-accessible	A table listing the association of Port number to its port number.
CFI cficonPortNumber	1.3.6.1.4.1.9.9.375.1.1.6.1.1	CficonPortNumOrAddr	not-accessible	The port number of this port.
cficonPortNumIfEntry	1.3.6.1.4.1.9.9.375.1.1.6.1		not-accessible	A cficonPortNumIfTable entry. Each entry provides a mapping between the port number and its interface index.
cficonPortNumIfGroup	1.3.6.1.4.1.9.9.375.2.2.6			A collection of objects giving association of a Port Number to Interface Index of the Port.
cficonPortNumIfTable	1.3.6.1.4.1.9.9.375.1.1.6		not-accessible	A table listing the association of Port number to its interface index.
CFI cficonPortRunCfgAddr	1.3.6.1.4.1.9.9.375.1.1.4.1.1	CficonPortNumOrAddr	not-accessible	The address of this port.
T/F cficonPortRunCfgBlock	1.3.6.1.4.1.9.9.375.1.1.4.1.2	TruthValue	read-write	The object indicating whether to block or unblock this port. If 'true' this port is blocked, else it is unblocked.
cficonPortRunCfgEntry	1.3.6.1.4.1.9.9.375.1.1.4.1		not-accessible	A cficonPortRunCfgTable entry. Each entry provides the information about a port (identified by cficonPortAddr), on this VSAN (identified by vsanIndex), for the running configuration.
cficonPortRunCfgGroup	1.3.6.1.4.1.9.9.375.2.2.4			A group containing an object providing ficon port information.
STR cficonPortRunCfgName	1.3.6.1.4.1.9.9.375.1.1.4.1.3	SnmpAdminString	read-write	The port name of this port.
cficonPortRunCfgTable	1.3.6.1.4.1.9.9.375.1.1.4		not-accessible	A table listing the port information as stored in the running configuration. Each port is identified by the port address in the context of its vsan Index.
cficonPortSwapEntry	1.3.6.1.4.1.9.9.375.1.1.1.1		not-accessible	A cficonPortSwapTable entry. A management station wishing to create an entry should first generate a pseudo-random serial number to be used as the index to this sparse table. The station should then create the associated instance of the row status object. It must also, in the same PDU create the associated instance of the cficonSwapPortNumberFirst and cficonSwapPortNumberSecond objects. Note that when creating a row in this table, the cficonSwapPortEntryStatus, cficonSwapPortNumberFirst and cficonSwapPortNumberSecond are all required. Once the operation completes, the management station should delete the entry.
cficonPortSwapGroup	1.3.6.1.4.1.9.9.375.2.2.1			A collection of objects providing port swap functionality.
I32 cficonPortSwapIndex	1.3.6.1.4.1.9.9.375.1.1.1.1.1	Integer32	not-accessible	An arbitrary index for the swap command.
cficonPortSwapTable	1.3.6.1.4.1.9.9.375.1.1.1		not-accessible	A table to issue the port swap command. In FICON, lots of configuration in the host is associated with a port-address. If the FICON port connecting the host to the switch has some problem and the user wants to connect the host to a different port in the switch, one needs to swap the configuration of the two ports. This command transparently swaps the configuration of two ports without affecting the host.
cficonPortTable	1.3.6.1.4.1.9.9.375.1.1.3		not-accessible	A table listing the port information as stored in the configuration file.
OCT cficonProhibitPortNumbers	1.3.6.1.4.1.9.9.375.1.1.3.1.4	OCTET STRING	read-write	The list of ports that will be prohibited from communication. Each octet within the value of an object of this type, specifies a set of eight ports, with the first octet specifying ports 1 through 8, the second octet specifying ports 9 through 16, etc. Within each octet, the most significant bit represents the lowest numbered port and the least significant bit represents the highest numbered port.
cficonReservedPortNumGroup	1.3.6.1.4.1.9.9.375.2.2.19			A collection of objects for the reserved FICON port numbers.
cficonRlirErlEntry	1.3.6.1.4.1.9.9.375.1.1.19.1		not-accessible	An entry (conceptual row) containing information about an Nx_Port which has registered to receive RLIRs on the VSAN indicated by vsanIndex.
ADR cficonRlirErlFcId	1.3.6.1.4.1.9.9.375.1.1.19.1.1	FcAddressId	not-accessible	The Fibre Channel Identifier (FC-ID) of the subscribing Nx_Port.
U32 cficonRlirErlFormat	1.3.6.1.4.1.9.9.375.1.1.19.1.2	Unsigned32	not-accessible	Indicates the device type for which the Nx_Port is interested in receiving RLIR ELS.
cficonRlirErlGroup	1.3.6.1.4.1.9.9.375.2.2.20			A collection of objects for displaying RLIR ERL.
INT cficonRlirErlRegType	1.3.6.1.4.1.9.9.375.1.1.19.1.3	INTEGER	read-only	This object indicates the type of registration desired by the subscriber. conditionalRx(1) - the Nx_Port is registered as a valid recipient of subsequent RLIRs. But such an Nx_Port is chosen as the recipient of a link incident record only if no other recipients from the ERL on this VSAN have been chosen. alwaysRx(2) - the Nx_Port is registered as a valid recipient of subsequent RLIRs. Such an Nx_Port is always chosen as a recipient of a link incident record.
cficonRlirErlTable	1.3.6.1.4.1.9.9.375.1.1.19		not-accessible	A table of Nx_Ports that have registered to receive RLIRs on all VSANs on the local switch.
STR cficonRunCfgManufacturer	1.3.6.1.4.1.9.9.375.1.1.4.1.7	DisplayString	read-only	The name of the the company that manufactured this FICON Director.
STR cficonRunCfgModelNumber	1.3.6.1.4.1.9.9.375.1.1.4.1.6	DisplayString	read-only	The model number for this FICON Director. It is in the form of ASCII characters.
STR cficonRunCfgPlantOfMfg	1.3.6.1.4.1.9.9.375.1.1.4.1.8	DisplayString	read-only	The plant code that identifies the plant of manufacture of this FICON Director.
I32 cficonRunCfgPortId	1.3.6.1.4.1.9.9.375.1.1.4.1.11	Integer32	read-only	This is the identifier of the peer port. If the peer port is channel, as described by the instance of cficonRunCfgUnitType, then cficonRunCfgPortId will be the CHPID (Channel Path Identifier) of the channel path that contains this peer port. If the peer port is controlUnit, then cficonRunCfgPortId will be 0. If the peer port is fabric, then cficonRunCfgPortId will be port address of the interface on the peer switch.
OCT cficonRunCfgProhibitPrtNums	1.3.6.1.4.1.9.9.375.1.1.4.1.4	OCTET STRING	read-write	The list of ports that will be prohibited. Each octet within the value of an object of this type specifies a set of eight ports, with the first octet specifying ports 1 through 8, the second octet specifying ports 9 through 16, etc. Within each octet, the most significant bit represents the lowest numbered port and the least significant bit represents the highest numbered port.
STR cficonRunCfgSerialNumber	1.3.6.1.4.1.9.9.375.1.1.4.1.9	DisplayString	read-only	The sequence number assigned to this FICON Director during manufacturing.
INT cficonRunCfgStatus	1.3.6.1.4.1.9.9.375.1.1.4.1.12	INTEGER	read-write	This object specifies the status of the row, whether some specific columns in this row are valid, invalid or old. These specific columns are - cficonRunCfgProhibitPrtNums, cficonRunCfgTypeNumber, cficonRunCfgModelNumber, cficonRunCfgManufacturer, cficonRunCfgPlantOfMfg, cficonRunCfgSerialNumber and cficonRunCfgUnitType. The only value that can be assigned by the Network Management System(NMS) is 'invalid'. The NMS cannot set this object to any other value (i.e 'valid' or 'old'). valid - The information ( values of the other columns) is guaranteed to be correct. old - The information was valid before the port went down. Although the information has not vanished, it cannot be guaranteed. invalid - When the port does not have the information at all. (i.e. when the port comes up for the first time or the NMS clears the information.
STR cficonRunCfgTypeNumber	1.3.6.1.4.1.9.9.375.1.1.4.1.5	DisplayString	read-only	The type number for this FICON Director.
INT cficonRunCfgUnitType	1.3.6.1.4.1.9.9.375.1.1.4.1.10	INTEGER	read-only	The peer type of the port that this port is communicating. channel - Host controlUnit - Disk fabric - Another SAN switch
T/F cficonSetHostTimeControl	1.3.6.1.4.1.9.9.375.1.1.2.1.15	TruthValue	read-create	The object indicating whether VSAN time can be set by the host. If 'true', the host can set the time, else it can not.
INT cficonShowPorts	1.3.6.1.4.1.9.9.375.1.1.11	INTEGER	read-write	An object to control which ports are displayed. If set to all(1), all the ports, regardless whether they are installed or not are displayed in the cficonPortTable and cificonPortRunCfgTable. If set to 'installed', only the ports that are installed ports are displayed in the cficonPortTable and cificonPortRunCfgTable.
I32 cficonSlotIndex	1.3.6.1.4.1.9.9.375.1.1.17.1.1	Integer32	not-accessible	The chassis slot number.
cficonSlotPortNumEntry	1.3.6.1.4.1.9.9.375.1.1.17.1		not-accessible	Chassis slot port number entry. This entry has the slot number and reserved port numbers for this slot.
cficonSlotPortNumTable	1.3.6.1.4.1.9.9.375.1.1.17		not-accessible	Chassis slot port number table. This table contains the list of all reserved port numbers for all slots of the chassis.
OCT cficonSlotReservedPN	1.3.6.1.4.1.9.9.375.1.1.17.1.2	OCTET STRING	read-write	Chassis slot port numbers. Reserved port numbers for one chassis slot. There can be up to 64 port numbers reserved for each slot in the chassis.
cficonStatsEntry	1.3.6.1.4.1.9.9.375.1.1.10.1		not-accessible	An entry listing the FICON statistics for FICON port.
cficonStatsGroup	1.3.6.1.4.1.9.9.375.2.2.10			A collection of objects for the FICON statistics table.
cficonStatsTable	1.3.6.1.4.1.9.9.375.1.1.10		not-accessible	A table listing the FICON Statistics .
INT cficonSwapInterfaceActionStatus	1.3.6.1.4.1.9.9.375.1.1.20.1.4	INTEGER	read-only	The status of the port swap request. pending - the request is waiting to be processed by the device. executing - the request is currently being processed by the device. success - the request has been completed successfully by the device. failure - the request failed.
ROW cficonSwapInterfaceEntryStatus	1.3.6.1.4.1.9.9.375.1.1.20.1.7	RowStatus	read-create	If this object is set to 'active(1)' then the port configurations of the ports specified by objects cficonSwapInterfaceIndexFirst and cficonSwapInterfaceIndexSecond will be swapped.
INT cficonSwapInterfaceFailReason	1.3.6.1.4.1.9.9.375.1.1.20.1.5	INTEGER	read-only	The reason of failed port swap request other - the failure is caused by other sub-module. none - no failure. dmFailure - the failure is caused by Domain Manager. ficonFailure - the failure is caused by FICON Manager. pmFailure - the failure is caused by Port Manager. psmFailure - the failure is caused by Port Security Manager. qosFailure - the failure is caused by QOS sub-module. spanFailure - the failure is caused by SPAN sub-module. zsFailure - the failure is caused by Zone Server.
NUM cficonSwapInterfaceIndexFirst	1.3.6.1.4.1.9.9.375.1.1.20.1.2	InterfaceIndex	read-create	The first port number that needs to be swapped .
NUM cficonSwapInterfaceIndexSecond	1.3.6.1.4.1.9.9.375.1.1.20.1.3	InterfaceIndex	read-create	The second port number that needs to be swapped.
STR cficonSwapInterfaceSystemError	1.3.6.1.4.1.9.9.375.1.1.20.1.6	SnmpAdminString	read-only	A system error string readable by user for the failed swap action.
ROW cficonSwapPortEntryStatus	1.3.6.1.4.1.9.9.375.1.1.1.1.4	RowStatus	read-create	If this object is set to 'createAndGo(4)' then the port configurations of the ports specified by objects cficonSwapPortNumberFirst and cficonSwapPortNumberSecond will be swapped.
CFI cficonSwapPortNumberFirst	1.3.6.1.4.1.9.9.375.1.1.1.1.2	CficonPortNumOrAddr	read-create	The first port number that needs to be swapped .
CFI cficonSwapPortNumberSecond	1.3.6.1.4.1.9.9.375.1.1.1.1.3	CficonPortNumOrAddr	read-create	The second port number that needs to be swapped.
T/F cficonVsanAutoSavePortAddrCfg	1.3.6.1.4.1.9.9.375.1.1.2.1.5	TruthValue	read-create	The object indicating whether the configuration will be saved in the configuration file for this VSAN. When an operator modifies a configuration, the running configuration is modified. If this object is 'true', then the configuration is saved in the configuration file as well. If this object is 'false', then the running configuration is not saved in the configuration file.
INT cficonVsanCharSet	1.3.6.1.4.1.9.9.375.1.1.2.1.8	INTEGER	read-create	The Character Set used for the exchange of of information with the host in this VSAN.
INT cficonVsanClearAllegience	1.3.6.1.4.1.9.9.375.1.1.2.1.16	INTEGER	read-create	The object used to clear a CUP allegiance. If this object is set with value, 'clear(1)' the CUP goes in a 'non-allegiance' or 'unlocked' mode as described in the description of cficonVsanDeviceAllegience object above.
INT cficonVsanCodePage	1.3.6.1.4.1.9.9.375.1.1.2.1.7	INTEGER	read-create	The EBCDIC Code page used for the exchange of information with the host in this VSAN.
STR cficonVsanCupName	1.3.6.1.4.1.9.9.375.1.1.2.1.14	SnmpAdminString	read-create	The name of CUP.
INT cficonVsanDeviceAllegience	1.3.6.1.4.1.9.9.375.1.1.2.1.11	INTEGER	read-only	The object indicating whether CUP is in a allegiance state. If it is in allegiance state with a channel, it cannot accept any commands from any logical paths. A CUP goes in an allegiance state when it accepts command from a channel and forms 'an allegiance' with it until the successful completion of the channel program, at which point the CUP goes in a an 'unlocked' mode.
T/F cficonVsanEnableCup	1.3.6.1.4.1.9.9.375.1.1.2.1.6	TruthValue	read-create	The object indicating Control Unit Port (CUP) is enabled. If 'true', CUP is enabled, else it is disabled.
cficonVsanEntry	1.3.6.1.4.1.9.9.375.1.1.2.1		not-accessible	A cficonVsanTable entry. Each entry, identified by vsanIndex, provides the objects to manage FICON functionality in this VSAN, identified by vsanIndex. To create a vsan, only the cficonVsanEntryStatus needs to be set in the PDU. A vsan will be created with default values for all the objects in the entry. Once the vsan is created, the values of all the writable objects within a row can be modified.
ROW cficonVsanEntryStatus	1.3.6.1.4.1.9.9.375.1.1.2.1.17	RowStatus	read-create	The status of this table entry.
INT cficonVsanFiconState	1.3.6.1.4.1.9.9.375.1.1.2.1.18	INTEGER	read-create	The object used to control the state of the ports belonging to a vsan in the context of the FICON functionality. If this object is set to 'offline(1)' all the ports belonging to the vsan, specified by the vsanIndex are put in the suspended state. If this object is set to 'online(2)' all the ports belonging to the vsan, specified by the vsanIndex are put in the operational state.
cficonVsanGroup	1.3.6.1.4.1.9.9.375.2.2.2			A group containing objects providing ficon information in a vsan.
T/F cficonVsanHostControl	1.3.6.1.4.1.9.9.375.1.1.2.1.1	TruthValue	read-create	The object indicates whether the host is allowed to alter FICON Director connectivity parameters. If 'true' the host is allowed to alter the parameters, else it cannot.
T/F cficonVsanHostControlClkAlrtMode	1.3.6.1.4.1.9.9.375.1.1.2.1.3	TruthValue	read-create	The object indicates whether director clock alert mode is enabled or disabled. If 'true', the mode is enabled, else it is disabled.
T/F cficonVsanHostControlSwOffline	1.3.6.1.4.1.9.9.375.1.1.2.1.2	TruthValue	read-create	The object specifying whether the host can put the VSAN offline. If 'true' it allows the host to put the VSAN offline, else it cannot.
T/F cficonVsanHostOrDefaultTime	1.3.6.1.4.1.9.9.375.1.1.2.1.13	TruthValue	read-only	The object indicating whether VSAN time is set by the host or the time is global time within a FICON Director. If 'true', the time was set by the host, else it is same as the FICON Director's global time.
I32 cficonVsanKeyCounter	1.3.6.1.4.1.9.9.375.1.1.2.1.9	Integer32	read-only	A counter that is incremented every time there is a configuration change. This counter is used by the Host to keep track of the number of configuration changes that have taken place.
STR cficonVsanSerialNum	1.3.6.1.4.1.9.9.375.1.1.2.1.19	SnmpAdminString	read-only	The serial number of the FICON director.
T/F cficonVsanSnmpControl	1.3.6.1.4.1.9.9.375.1.1.2.1.4	TruthValue	read-create	The object indicates whether network management system is allowed to alter FICON director connectivity parameters. If 'true', the network management system is allowed to alter FICON director connectivity parameters, else, it cannot.
cficonVsanTable	1.3.6.1.4.1.9.9.375.1.1.2		not-accessible	A table containing the objects to manage FICON functionality in a VSAN.
STR cficonVsanTime	1.3.6.1.4.1.9.9.375.1.1.2.1.12	DisplayString	read-only	The system time in the VSAN. This could be set either by the host or be the default global time in the FICON Director. The default global time is the local time in the FICON Director. The format is as follows - Wed Nov 5 18:53:52.172485 2003
T/F cficonVsanUserAlertMode	1.3.6.1.4.1.9.9.375.1.1.2.1.10	TruthValue	read-create	The object indicating whether director user alert mode is enabled or disabled. If 'true', the mode is enabled. else it is disabled.
C32 cfStatsDispErrorsInFrame	1.3.6.1.4.1.9.9.375.1.1.10.1.2	Counter32	read-only	Number of frames with disparity errors.
C32 cfStatsDispErrsOutOfFrame	1.3.6.1.4.1.9.9.375.1.1.10.1.4	Counter32	read-only	Number of frames with OOF errors.
C32 cfStatsEOFErrs	1.3.6.1.4.1.9.9.375.1.1.10.1.3	Counter32	read-only	Number of frames with EOF errors.
C32 cfStatsErrorSummary	1.3.6.1.4.1.9.9.375.1.1.10.1.6	Counter32	read-only	This counter contains a sum of the errors counted by a set of the other defined error counters.
C32 cfStatsFramePacingTimeEx	1.3.6.1.4.1.9.9.375.1.1.10.1.1	Counter32	read-only	Number of 2.5 microsecond units that frame transmission is blocked due to zero credit.
C32 cfStatsInvalidOrderSets	1.3.6.1.4.1.9.9.375.1.1.10.1.5	Counter32	read-only	Number of invalid or unrecognizable Order Sets outside of frames.
cifconShowPortGroup	1.3.6.1.4.1.9.9.375.2.2.11			A collection of objects for the FICON statistics table.
ciscoFiconCompliance	1.3.6.1.4.1.9.9.375.2.1.1			Compliance statement for FICON MIB.
ciscoFiconComplianceRev1	1.3.6.1.4.1.9.9.375.2.1.2			Compliance statement for FICON MIB.
ciscoFiconComplianceRev2	1.3.6.1.4.1.9.9.375.2.1.3			Compliance statement for FICON MIB.
ciscoFiconComplianceRev3	1.3.6.1.4.1.9.9.375.2.1.4			Compliance statement for FICON MIB.
ciscoFiconCompliances	1.3.6.1.4.1.9.9.375.2.1
ciscoFiconConfig	1.3.6.1.4.1.9.9.375.1.1
ciscoFiconGlobal	1.3.6.1.4.1.9.9.375.1.2
ciscoFiconGroups	1.3.6.1.4.1.9.9.375.2.2
ciscoFiconMIB	1.3.6.1.4.1.9.9.375			This is the FICON (FIber CONnection) MIB module. FICON is an IBM standard of transport mechanism for communication between the mainframes and devices and is a major consideration for enterprise data centers. The Cisco MDS Storage Area Network (SAN) switches provide the functionality of a FICON Director to the customers.
ciscoFiconMIBConform	1.3.6.1.4.1.9.9.375.2
ciscoFiconMIBNotifications	1.3.6.1.4.1.9.9.375.0
ciscoFiconMIBObjects	1.3.6.1.4.1.9.9.375.1
ciscoFiconPortMap	1.3.6.1.4.1.9.9.375.1.1.16
CFI portAddress	1.3.6.1.4.1.9.9.375.1.1.8.1.2	CficonPortNumOrAddr	read-only	The port address of this port.
CFI portAddrPortNumber	1.3.6.1.4.1.9.9.375.1.1.8.1.1	CficonPortNumOrAddr	not-accessible	The port number of this port.

RFC description

Cisco FICON MIB for managing FICON (Fiber Connection) - IBM standard transport for mainframe-to-device communication on Cisco MDS 9000 Series switches.

Start monitoring Cisco MDS FICON Director SAN switches with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download CISCO-FICON-MIB