Cat Members

2/27/2008

Defines the programmatic interface for a UPOS credit authorization terminal (CAT) device.

The following tables list the members exposed by the Cat type.

Protected Constructors

	Name	Description
	Cat	Creates an instance of the Cat class.

Top

Public Fields

	Name	Description
	ExtendedErrorCenterError	Indicates an error was returned from the approval agency in CenterResultCode.
	ExtendedErrorCommandError	Indicates the command sent to the CAT is incorrect.
	ExtendedErrorCommunicationError	Indicates a communication error has occurred between the approval agency and the CAT.
	ExtendedErrorDailyLogOverflow	Indicates the daily log is too big to be stored.
	ExtendedErrorDeficient	Indicates the balance is insufficient for an electronic money device. The device cannot close the settlement.
	ExtendedErrorFirmwareBadFile	Indicates the specified firmware file or files exist, but one or more of those files are either not in the correct format or are corrupted. (inherited from PosCommon)
	ExtendedErrorOverDeposit	Indicates a failure occurs for an electronic money device if the attempted settlement amount exceeds the charge account limit.
	ExtendedErrorReset	Indicates the CAT was stopped during processing by the CAT Reset key or Stop key.
	ExtendedErrorStatistics	Indicates a specified statistic could not be reset or updated. (inherited from PosCommon)
	ExtendedErrorStatisticsDependency	(inherited from PosCommon )
	StatisticCommunicationErrorCount	Holds the programmatic name of the Communication Error Count common statistic. (inherited from PosCommon)
	StatisticDeviceCategory	Holds the programmatic name of the Device Category common statistic. (inherited from PosCommon)
	StatisticFirmwareRevision	Holds the programmatic name of the Firmware Revision common statistic. (inherited from PosCommon)
	StatisticHoursPoweredCount	Holds the programmatic name of the Hours Powered On common statistic. (inherited from PosCommon)
	StatisticInstallationDate	Holds the programmatic name of the Installation Date common statistic. (inherited from PosCommon)
	StatisticInterface	Holds the programmatic name of the Interface common statistic. (inherited from PosCommon)
	StatisticManufactureDate	Holds the programmatic name of the Manufacture Date common statistic. (inherited from PosCommon)
	StatisticManufacturerName	Holds the programmatic name of the Manufacturer Name common statistic. (inherited from PosCommon)
	StatisticMechanicalRevision	Holds the programmatic name of the Mechanical Revision common statistic. (inherited from PosCommon)
	StatisticModelName	Holds the programmatic name of the Model Name common statistic. (inherited from PosCommon)
	StatisticSerialNumber	Holds the programmatic name of the Serial Number common statistic. (inherited from PosCommon)
	StatisticUnifiedPOSVersion	Holds the programmatic name of the Unified POS Version common statistic. (inherited from PosCommon)
	StatusPowerOff	Indicates that the device’s power is turned off or it is detached from the terminal. (inherited from PosCommon)
	StatusPowerOffline	Indicates that the device is powered on but is either not ready or unable to respond to requests. (inherited from PosCommon)
	StatusPowerOffOffline	Indicates that either the device’s power is off or it is offline. (inherited from PosCommon)
	StatusPowerOnline	Indicates that the device’s power is turned on and it is ready for use. (inherited from PosCommon)
	StatusUpdateFirmwareComplete	Indicates the update firmware process has completed successfully. (inherited from PosCommon)
	StatusUpdateFirmwareCompleteDeviceNotRestored	Indicates the update firmware process succeeded. However, the Service Object and/or the physical device cannot be returned to the state they were in before the update firmware process started.  (inherited from PosCommon)
	StatusUpdateFirmwareFailedDeviceNeedsFirmware	Indicates the update firmware process failed. The device will not be operational until another attempt to update the firmware is successful. (inherited from PosCommon)
	StatusUpdateFirmwareFailedDeviceOk	Indicates the update firmware process failed. However, the device is still operational. (inherited from PosCommon)
	StatusUpdateFirmwareFailedDeviceUnknown	Indicates the update firmware process failed. The device is in an indeterminate state. (inherited from PosCommon)
	StatusUpdateFirmwareFailedDeviceUnrecoverable	Indicates the update firmware process failed. The device is either unusable or unrecoverable through software. (inherited from PosCommon)
	StatusUpdateFirmwareProgress	Indicates the update firmware process has completed 1 to 100 percent successfully. (inherited from PosCommon)
	WaitForever	Used as the value for a timeout parameter in common and device-specific methods to indicate the method should wait until it receives a response, instead of timing out. (inherited from PosCommon)

Top

Public Properties

(see also Protected Properties )

	Name	Description
	AccountNumber	Gets the credit card number of the settled account.
	AdditionalSecurityInformation	Gets or sets additional security information for an authorization operation.
	ApprovalCode	Gets the credit approval code.
	AsyncMode	Gets or sets the Boolean value that indicates whether the authorization runs asynchronously.
	Balance	Gets a credit card balance.
	CapAdditionalSecurityInformation	Gets the Boolean value that indicates whether the AdditionalSecurityInformation property can be used.
	CapAuthorizeCompletion	Gets the Boolean value that indicates whether the AuthorizeCompletion method is implemented.
	CapAuthorizePreSales	Gets the Boolean value that indicates whether the AuthorizePreSales method is implemented.
	CapAuthorizeRefund	Gets the Boolean value that indicates whether the AuthorizeRefund method is implemented.
	CapAuthorizeVoid	Gets the Boolean value that indicates whether the AuthorizeVoid method is implemented.
	CapAuthorizeVoidPreSales	Gets the Boolean value that indicates whether the AuthorizeVoidPreSales method is implemented.
	CapCashDeposit	Gets the Boolean value that indicates whether the CashDeposit method is implemented.
	CapCenterResultCode	Gets the Boolean value that indicates whether the CenterResultCode method is implemented.
	CapCheckCard	Gets the Boolean value that indicates whether the CheckCard method is implemented.
	CapCompareFirmwareVersion	Gets a Boolean value that indicates whether the Service Object/device supports comparing the firmware version in the physical device against that of a firmware file. (inherited from PosCommon)
	CapDailyLog	Gets the daily log ability of the device.
	CapInstallments	Gets the Boolean value that indicates whether the "Installments" item is provided.
	CapLockTerminal	Gets a Boolen value that indicates whether the device has a security lock and can set it.
	CapLogStatus	Gets a Boolen value that indicates whether the device can give information about the status of the log.
	CapPaymentDetail	Gets the Boolean value that indicates whether the PaymentDetail property is implemented.
	CapPowerReporting	Gets the power reporting capabilities of the device. (inherited from PosCommon)
	CapStatisticsReporting	Gets a Boolean value that indicates whether the device can accumulate and can provide various statistics regarding usage. (inherited from PosCommon)
	CapTaxOthers	Gets the Boolean value that indicates whether the item "TaxOthers" is provided.
	CapTrainingMode	Gets the Boolean value that indicates whether the TrainingMode property is implemented.
	CapTransactionNumber	Gets the Boolean value that indicates whether the TransactionNumber property is implemented.
	CapUnlockTerminal	Gets the Boolean value that indicates whether the security lock can be released.
	CapUpdateFirmware	Gets a Boolean value that indicates whether the device's firmware can be updated through the UpdateFirmware method. (inherited from PosCommon)
	CapUpdateStatistics	Gets a Boolean value that indicates whether some or all the device statistics can be reset to 0 (zero) by using the ResetStatistic and ResetStatistics methods, or updated by using the UpdateStatistic and UpdateStatistics methods. (inherited from PosCommon)
	CardCompanyId	Gets the credit card company ID.
	CenterResultCode	Gets the code from the approval agency.
	CheckHealthText	Gets a string that indicates the health of the device. (inherited from PosCommon)
	Claimed	Gets a Boolean value that indicates whether the device is claimed for exclusive access. (inherited from PosCommon)
	Compatibility	Gets the compatibility level of a device. (inherited from PosDevice)
	DailyLog	Gets the result of the AccessDailyLog method.
	DeviceDescription	Gets a string identifying the device and the company that manufactured it. (inherited from PosCommon)
	DeviceEnabled	Gets or sets a Boolean value that indicates whether the device has been placed in an operational state. (inherited from PosCommon)
	DeviceName	Gets a short string identifying the device and any pertinent information about it. (inherited from PosCommon)
	FreezeEvents	Gets or sets a Boolean value that indicates whether the application has requested that the Service Object not deliver events. (inherited from PosCommon)
	LogStatus	Gets the status of the dealing log of the CAT device.
	OutputId	Gets the identifier of the most recently started asynchronous output.
	PaymentCondition	Gets the payment condition of the most recent successful authorization operation.
	PaymentDetail	Gets payment condition details as the result of an authorization operation.
	PaymentMedia	Gets or sets the payment media type that the approval method should approve.
	PowerNotify	Gets or sets the type of power notification selection made by the application. (inherited from PosCommon)
	PowerState	Gets the current power condition. (inherited from PosCommon)
	SequenceNumber	Gets a "sequence number" as the result of each method call.
	ServiceObjectDescription	Gets a string identifying the Service Object that supports the device and the company that produced it. (inherited from PosCommon)
	ServiceObjectVersion	Gets the Service Object version number. (inherited from PosCommon)
	SettledAmount	Gets the amount of the settlement for an electronic money device.
	SlipNumber	Gets a "slip number" as the result of each authorization operation.
	State	Gets the current state of the device. (inherited from PosCommon)
	SynchronizingObject	Gets or sets the object that is used to marshal the event handler calls issued because of a POS event. (inherited from PosCommon)
	TrainingMode	Gets or sets the Boolean value that indicates whether each operation is run in training mode.
	TransactionNumber	Gets a transaction number as the result of each authorization operation.
	TransactionType	Gets a transaction number as the result of each authorization operation.

Top

Protected Properties

	Name	Description
	DeviceInstanceId	(inherited from PosCommon )
	DevicePath	Gets or sets the hardware path of a device. (inherited from PosCommon)
	HardwareId	(inherited from PosCommon )
	IsExclusiveUseDevice	Overridden. Gets the Boolean value that indicates whether the credit authorization terminal is an exclusive-use device.

Top

Public Methods

(see also Protected Methods )

	Name	Description
	AccessDailyLog	Gets the daily log from CAT.
	AuthorizeCompletion	Authorizes the purchase after approval.
	AuthorizePreSales	Preauthorizes a purchase.
	AuthorizeRefund	Approves a refund for a purchase.
	AuthorizeSales	Approves a purchase.
	AuthorizeVoid	Approves cancellation of a purchase.
	AuthorizeVoidPreSales	Preauthorizes a cancellation.
	CashDeposit	Charges the specified amount of money to the account.
	CheckCard	Indicates that a card check is intended.
	CheckHealth	(inherited from PosCommon )
	Claim	(inherited from PosCommon )
	ClearOutput	Clears outputs that have been buffered for the unit.
	Close	Releases the device and its resources. (inherited from PosCommon)
	CompareFirmwareVersion	(inherited from PosCommon )
	DirectIO	(inherited from PosCommon )
	Equals	Overloaded. (inherited from Object )
	GetHashCode	(inherited from Object )
	GetType	(inherited from Object )
	LockTerminal	Sets the security lock.
	Open	Opens a device for later input/output processing. (inherited from PosCommon)
	ReferenceEquals	(inherited from Object )
	Release	Releases exclusive access to the device. (inherited from PosCommon)
	ResetStatistic	(inherited from PosCommon )
	ResetStatistics	Overloaded. (inherited from PosCommon )
	RetrieveStatistic	(inherited from PosCommon )
	RetrieveStatistics	Overloaded. (inherited from PosCommon )
	ToString	(inherited from Object )
	UnlockTerminal	Releases the security lock.
	UpdateFirmware	(inherited from PosCommon )
	UpdateStatistic	(inherited from PosCommon )
	UpdateStatistics	Overloaded. (inherited from PosCommon )

Top

Protected Methods

	Name	Description
	DeleteConfigurationProperty	(inherited from PosCommon )
	Finalize	(inherited from Object )
	GetConfigurationProperty	(inherited from PosCommon )
	Invoke	(inherited from PosCommon )
	MemberwiseClone	(inherited from Object )
	SetConfigurationProperty	(inherited from PosCommon )

Top

Public Events

(see also Protected Events )

	Name	Description
	DirectIOEvent	Raised by the Service Object to communicate information directly to the application. (inherited from PosCommon)
	ErrorEvent	Notifies the application that a CAT error has been detected and suitable response by the application is necessary to process the error condition.
	OutputCompleteEvent	Notifies the application that the queued output request associated with the OutputId property has completed successfully.
	StatusUpdateEvent	Raised by the Service Object to alert the application of a device status change. (inherited from PosCommon)

Top

Protected Events

	Name	Description
	DeviceAddedEvent	(inherited from PosCommon )
	DeviceRemovedEvent	(inherited from PosCommon )

Top

See Also

Reference

Cat Class
Microsoft.PointOfService Namespace