The HBA Language 1 Introduction The HBA language is designed to help users to convert the text records into HTML table format The syntax of HBA language is simple With several lines of HBA codes the users are able to create a report in HTML format The HBA language is easy to use With HBA language the users don t have to know HTML language to generate reports in HTML table format The language is named after its typical usage to generate HTML report for Fibre Channel HBA Host Bus adapter To implement an enterprise SAN Storage Area Network solution an important step is to identify the driver and firmware versions of FC HBA and make sure they are on the support matrix Storage vendors such as EMC and IBM usually publish support matrix on which lists all the supported driver and firmware versions The listed driver firmware versions have been thoroughly tested and therefore fully supported by the storage vendors To avoid unnecessary troubleshooting the first step for SAN implementation is usually to make sure the driver and firmware versions are on the verdor s support matrix The HBA language will help field engineer to create HTML report of HBA very easily 1 1 Features Text Parsing HBA allows a user to search through a set of data using the functions provided The user will be able to state the record name in the command input file HTML Handling HBA has the ability to describe HTML output clearly and handle the HTML tags Data Comparison HBA allows a user to compare the value of text string in the text file with the pre defined string If the actual string is different form the pre defined string the user can specify the actions usually to append extra HTML table cells to HBA report 1 2 HBA Sample Syntax Text parsing sample HBA syntax START INFILE OUTFILE DELIMITER start of the program text file name output html file name the delimiter to separate the text records Data Comparison HBA code IF NAME THEN VALUE expected value for specific record HBA language will search for the record in the text file and compare the value with expected value Related HTML output will be generated 2 Tutorial 2 1 An example A sample program file sample hba is provided for tutorial purpose sample hba start of the program START input file in text format INFILE text txt output file in HTML format which is converted from input text file outfile output html delimiter for the records in the text input file delimiter the name of the record which HBA language should search in input text file and the expected value In this example HBA will look for a record which contains string Firmware and compare the related firmware version with the 3 03 06 Keywods could be lower case as well IF NAME Firmware THEN VALUE 3 03 07 The sample program converts text txt into output html which is in HTML table format text txt Host DC2MS906 Adapter Number 0 Adapter Model QLA2340 Adapter Node Name 20 00 00 E0 8B 12 66 CF Adapter Port Name 21 00 00 E0 8B 12 66 CF Adapter Port ID 00 00 00 Serial Number M32742 Driver Version SCSIport 9 0 0 2 w32 IP BIOS 1 42 Firmware Version 3 03 06 Device Target Count 0 PCI Bus Number 1 PCI Slot Number 2 PortType Topology NPort Adapter Status Loop down The generated HTML table will be The following are the steps how to run sample hba in a HBA environment 1 open a DOS prompt go to the directory where smple hba resides 2 run java HBA sample hba 3 you will find the output html file under the current directory 2 2 Installation steps HBA language is developed for Windows environment You need the followings software to run HBA language properly Windows 2000 XP JAVA J2SE v1 4 2 or higher HBA language package HBA language installation steps a unzip the hba zip to C HBA directory b on DOS prompt run set classpath classpath C HBA 3 Language Reference Manual 3 1 Lexical conventions 3 1 1 Comments A Java style comment is supported The characters introduce a comment which terminates with the new line has no special meaning inside comment line 3 1 2 Whitespace Whitespace is defined as the ASCII space horizontal tab 3 1 3 Identifiers An identifier is a sequence of letters and digits the first character must be alphabetic Upper and lower case letters are considered different Identifier letter letter digit 3 1 4 Keywords The following identifiers are reserved for use as keywords and may not be used otherwise INFILE OUTFILE START IF THEN NAME VALUE DELIMITER 3 1 5 Numbers A number consists of digits 3 1 6 Strings A string is a sequence of characters enclosed by double quotes A double quote inside the string is represented by two consecutive double quotes 3 1 7 Separators The following ASCII characters are separators 3 1 8 Built in variables The following identifiers are reserved for use as built in variables and may not be used otherwise Fin Fout DeLi Fnm Fvlu Command input file name HTML format file name generated by HBA Delimiter specified by users Specific field name Expected field value 3 2 Expressions Primary expressions include identifiers and constants 3 2 1 Identifier An identifier is a primary expression 3 2 2 Constant A constant is a right value expression which will be evaluated to the constant itself 3 3 Operators 3 3 1 Assignment operators variable expression The assign to operator groups right to left The value of the expression replaces the object referred to by the variable The operands need to have the string constant type 3 4 Statements Statements are executed in sequence 3 4 1 Expression statement Statements are in the form of expression 3 4 2 Conditional statement if expression then statement The expression is evaluated first and if it is non zero the statement is executed which is a expression as well
View Full Document
Unlocking...