SIR2002

What’s New in What’s New in SIR2002 SIR2002

and and How to Use itHow to Use it

SIR2000 - ReviewSIR2000 - Review VisualPQLVisualPQL

– Dialogs and Message ProcessingDialogs and Message Processing– New CommandsNew Commands– New Functions New Functions – Pop Up BoxesPop Up Boxes– ‘‘EXECUTE DBMS’EXECUTE DBMS’

New User InterfaceNew User Interface ODBC ODBC Multiple DatabasesMultiple Databases

SIR2000 - ReviewSIR2000 - Review Descriptive, Plot, Graph ProceduresDescriptive, Plot, Graph Procedures Internet Enabled Internet Enabled New Master CommunicationNew Master Communication Additional File Support Additional File Support Unlimited Program SizeUnlimited Program Size No ‘Table Space’No ‘Table Space’ SpreadsheetSpreadsheet

SIR2002 Major New SIR2002 Major New FeaturesFeatures

User Interface EnhancementsUser Interface Enhancements Database EnhancementsDatabase Enhancements VisualPQL EnhancementsVisualPQL Enhancements Dialog and Menu EnhancementsDialog and Menu Enhancements PQLFormsPQLForms Screen Painter for Dialogs Screen Painter for Dialogs Screen Painter for PQLFormsScreen Painter for PQLForms ODBC Enhanced ODBC Enhanced

SIR2002 User InterfaceSIR2002 User Interface Enter into window, Enter into window,

submit with ctrl-Rsubmit with ctrl-R Search windowSearch window Data/Spreadsheet Data/Spreadsheet

menu access to menu access to tabfiles & database tabfiles & database using indexesusing indexes

Paged Dialogs e.g. Paged Dialogs e.g. Procedures , Record Procedures , Record Schema, SettingsSchema, Settings

Program/member Program/member – Improved search Improved search – Create new Create new

procedure fileprocedure file Painters available Painters available

from program menufrom program menu Secondary Index on Secondary Index on

schemaschema ‘‘Rewind’ ButtonRewind’ Button

Database EnhancementsDatabase Enhancements Secondary IndexesSecondary Indexes Extended StringsExtended Strings

– String CompressionString Compression Auto Increment KeysAuto Increment Keys SIR SPREADSHEET SIR SPREADSHEET

– New GridNew Grid– Secondary IndexesSecondary Indexes

Duplicate Value Label CheckDuplicate Value Label Check

Secondary IndexesSecondary Indexes Analogous to tabfile secondary

indexes Multiple variables as keys in index Multiple indexes on a record type Creation - command or schema menu Automatic maintenance List Stats

Secondary Indexes Secondary Indexes Creation

Database/Secondary Index Menu Command

– CREATE [UNIQUE] DBINDEX index_name ON database.recname ( var_name [ ASC | DESC ] [ , ... ] ) [UPPER]

Creates the index structure Creates the actual index from values of

any existing records

Secondary Indexes Secondary Indexes Maintenance

Index is automatically maintained if records are added, deleted or modified

Maintenance automatic through all modules – Utilities, PQL, Master, Forms, SQL

Indexes rebuilt if database recovered from Import or Reload

Delete index – DROP DBINDEX index_name

ON [database.] recname | ALL

Secondary IndexesSecondary IndexesPlaces Used Places Used

VisualPQL– PROCESS RECORD … INDEXED BY …– LOOKUP RECORD ... INDEXED BY …

PQLForms– SCREEN RECORD ... INDEXED BY …

SPREADSHEET utility – SIR SPEADSHEET RECTYPE = n /

INDEXED BY …..

Extended StringsExtended Strings Maximum Database String Maximum Database String

Variables size increased to 4094Variables size increased to 4094 Database Strings CompressedDatabase Strings Compressed Database keys fixed lengthDatabase keys fixed length

– Max. 320 characters in totalMax. 320 characters in total– Sort keys same limitsSort keys same limits– Secondary Index keys same limitsSecondary Index keys same limits

Auto Increment KeysAuto Increment Keys Final Part of KeyFinal Part of Key

– Named Integer VariableNamed Integer Variable Specify as SORT IDS name (I) Specify as SORT IDS name (I) Ascending number from previous Ascending number from previous

record of same type in Caserecord of same type in Case Specify as 0 in REC IS (key,0)Specify as 0 in REC IS (key,0) If value specified, it is usedIf value specified, it is used

SIR2000 SPREADSHEETSIR2000 SPREADSHEET Third Party Active-X ControlThird Party Active-X Control Windows OnlyWindows Only Needs Complete Data SetNeeds Complete Data Set Slow Slow Size LimitsSize Limits No resize No resize

SIR2002 GRIDSIR2002 GRID Runs on all platformsRuns on all platforms Displays immediatelyDisplays immediately No limitations on number of rowsNo limitations on number of rows ResizableResizable Used in SIR SPREADSHEET utilityUsed in SIR SPREADSHEET utility

– Enhanced for secondary indexesEnhanced for secondary indexes

VisualPQL EnhancementsVisualPQL Enhancements– PROCESS REC …. PROCESS REC ….

INDEXED BYINDEXED BY– Extended StringsExtended Strings– Extended Constants Extended Constants – Redefinition of Redefinition of

arraysarrays– Sorting ArraysSorting Arrays– GRID CommandGRID Command– LOOKUP CommandLOOKUP Command– 50 extra functions 50 extra functions

(tabfile schema)(tabfile schema)

– File HandlingFile Handling Extended number of Extended number of

text files opentext files open Text files between Text files between

windows and Unixwindows and Unix HEX Format on HEX Format on

READ and WRITEREAD and WRITE– LABEL for headings LABEL for headings

on Quick Reporton Quick Report– FORMAT for fields FORMAT for fields

on CSVon CSV

PROCESS RECORD ... INDEXED BY

All existing clauses used in conjunction with INDEXED BY– AFTER, FROM, THRU, etc.

Makes the case and record current for update as necessary

RECORD IS constructs do not support the INDEXED BY clause

Extended Strings and ConstantsExtended Strings and Constants String size increased to 4094String size increased to 4094

– Local VariablesLocal Variables– Database VariablesDatabase Variables– Database Strings CompressedDatabase Strings Compressed

Maximum constant limit of 32k removedMaximum constant limit of 32k removed– Limit is 4096 constants of any sizeLimit is 4096 constants of any size

Database keys fixed lengthDatabase keys fixed length– Max. 320 characters in totalMax. 320 characters in total– Sort keys same limitsSort keys same limits– Secondary Index keys same limitsSecondary Index keys same limits

Array ProcessingArray ProcessingREDEFINE ARRAY array_name (dim1, dim2,...)REDEFINE ARRAY array_name (dim1, dim2,...)

– Alters dimensions Alters dimensions – Alters number and/or value of any dimensionAlters number and/or value of any dimension– Array can grow or shrinkArray can grow or shrink– Existing values mapped to new dimensionsExisting values mapped to new dimensions– New values are set to missing. New values are set to missing. – NOARRAYMSGNOARRAYMSG

SORT array_name SORT array_name [BY key_array_varname] [BY key_array_varname] [(n)] [(n)] [DESCENDING][DESCENDING]

GRID CommandGRID CommandGRID title list_of_arrays GRID title list_of_arrays (1 or 2 dimension)(1 or 2 dimension) [HEADERS=(list_of_col_headers)][HEADERS=(list_of_col_headers)] [RESPONSE = [RESPONSE = integer_varname|integer_varname|

array_varname]array_varname] [SIZE=rows][SIZE=rows] [DISPLAY=row,width][DISPLAY=row,width] [UPDATE | NOUPDATE][UPDATE | NOUPDATE]

PQL Procedure PQL Procedure (unchanged)(unchanged)

SPREAD SHEETSPREAD SHEET[/VARIABLES= varlist ][/VARIABLES= varlist ][/SORT=[(n)]variable[(A)|[/SORT=[(n)]variable[(A)|(D)], ...](D)], ...]

[/BOOLEAN= [/BOOLEAN= (logical_expression)](logical_expression)]

[/SAMPLE= fraction [,seed ] ][/SAMPLE= fraction [,seed ] ][/TITLE= 'spreadsheet title'][/TITLE= 'spreadsheet title']

LOOKUP commandLOOKUP command LOOKUP RECORD dbname.recname |LOOKUP RECORD dbname.recname |

TABLE tabfile.table TABLE tabfile.table [INDEXED BY indexname] [INDEXED BY indexname] [GET VARS ALL| [GET VARS ALL| target_varlist| target_varlist| local_varlist = target_varlist}] local_varlist = target_varlist}]

[VIA keylist][VIA keylist] [USING caseid,keylist][USING caseid,keylist] [FORWARD | BACKWARD][FORWARD | BACKWARD] [RESULT num_varname][RESULT num_varname] [WHERE (condition)][WHERE (condition)]

New New Functions Secondary IndexesSecondary Indexes

– DBINDS Number of indexes on database

– DBINDN Name of index– DBINDR Record indexed– DBINDV Variables in index– DBINDV Name of nth variable in

index

New New Functions DEDITDEDIT

– Various ‘painter’ dialog functions Files & Directories

– FILECNT Count of files in named directory– FILEIS If name exists as file or directory– FILEN nth file in directory– FILESTAT Various data about named file e.g. size– FILETIME Various dates/times (creation/access)

of file in SIR formats– MAKEDIR Creates a directory– DELDIR Deletes a directory

New Functions

1 gid group (UNIX)1 gid group (UNIX)2 st_atime Access 2 st_atime Access TimeTime3 st_ctime Creation 3 st_ctime Creation Time Time 4/9 st_dev Drive 4/9 st_dev Drive numbernumber5 st_ino inode (UNIX)5 st_ino inode (UNIX)6 st_mode Bit mask for 6 st_mode Bit mask for file-mode information.file-mode information.

7 7 st_mtime st_mtime Modification timeModification time

8 st_nlink Always 1 on 8 st_nlink Always 1 on non-NTFS file non-NTFS file systemssystems

10 st_size Size (bytes)10 st_size Size (bytes)11 uid User (UNIX) 11 uid User (UNIX)

FILESTAT FunctionFILESTAT Function

New Functions FILETIME FunctionFILETIME Function returns SIR returns SIR

times or dates about a filetimes or dates about a file– 1 Time of last access1 Time of last access– 2 Date of last access2 Date of last access– 3 Time of creation3 Time of creation– 4 Date of creation4 Date of creation– 5 Time of last modification5 Time of last modification– 6 Date of last modification6 Date of last modification

New Functions SchemaSchema

– NVALLAB Synonym for NLABELS

– NVARLAB Number of lines in variable label

– NVARSC Number of variables in a record including common vars

– RECDOC Number of lines of documentation

– RECDOCN Nth line of documentation

– VALLABSN Label for value label n for variable

– VALLABSP Position of value label associated with specified value

– VALLABSV Value for value label n for variable

– VARLABSN Nth line of variable label

– VARNAMEC Name of variable using counts including common vars

New New Functions Tabfile SchemaTabfile Schema

– TABINDU ITABINDU Index uniquendex unique– TABRECS NTABRECS Number of rows on tableumber of rows on table– TABVINFNTABVINFN Various numeric data about a table Various numeric data about a table

columncolumn– TABVINFSTABVINFS Various character data about a table Various character data about a table

columncolumn– TABVRANGTABVRANG Valid or missing value ranges Valid or missing value ranges– TABVVALITABVVALI Validates a table variable Validates a table variable– TABVVLABTABVVLAB Label for value label n for table col Label for value label n for table col– TABVVVALTABVVVAL Value for value label n for table col Value for value label n for table col

New FNew Functions Main Output WindowMain Output Window

– WINCNT WINCNT Number of lines in output Number of lines in output windowwindowWINLIN WINLIN Nth line from the output windowNth line from the output windowWINMOVE WINMOVE Moves and resizes main Moves and resizes main windowwindowWINPOS WINPOS Moves to line in output window Moves to line in output window and highlights lineand highlights lineWINSELL WINSELL Selected LineSelected LineWINSELP WINSELP Position in the line selectedPosition in the line selected

File HandlingFile Handling Extended number of text files openExtended number of text files open Text files between windows and UnixText files between windows and Unix Binary File READ and WRITE

Special Formats– HEXw HEXw Binary string, w digits(up to 4094)Binary string, w digits(up to 4094)– IBw IBw Binary integer, w digits(1,2 or 4) Binary integer, w digits(1,2 or 4) – RBw RBw Binary real, w digits (4 or 8)Binary real, w digits (4 or 8)

Dialog and Menu Dialog and Menu EnhancementsEnhancements

– 4000+ Elements in single dialog4000+ Elements in single dialog– SHOW/HIDE elements in dialogSHOW/HIDE elements in dialog– POPUP Menus in menus and dialogsPOPUP Menus in menus and dialogs– HELP Message typeHELP Message type– TIMER Message typeTIMER Message type– DEDIT dialog typeDEDIT dialog type– SET ITEM FONTSET ITEM FONT

‘‘Tabbed’ or Paged DialogsTabbed’ or Paged Dialogs– 4000+ Elements4000+ Elements– SET DIALOG TITLE string_expSET DIALOG TITLE string_exp– SHOW ITEM idSHOW ITEM id– HIDE ITEM idHIDE ITEM id

Pop Up MenusPop Up Menus DISPLAY POPUP LISTDISPLAY POPUP LIST

(string_exp,string_exp,..) | (string_exp,string_exp,..) | array_name,no_of_itemsarray_name,no_of_items

ANCHOR id | AT row,colANCHOR id | AT row,col RESPONSE num_varnameRESPONSE num_varname [SEPARATOR n,n...][SEPARATOR n,n...] [POSTYPE num_exp][POSTYPE num_exp] Displays pop up menu in menu or dialogDisplays pop up menu in menu or dialog Positioned relative to ANCHOR id or at the Positioned relative to ANCHOR id or at the

position specified by the AT clause.position specified by the AT clause. RESPONSE returns selected item (or –1)RESPONSE returns selected item (or –1)

Help MessageHelp Message Help Dialog MessageHelp Dialog Message

– MESSAGE HELP FID@__MESSAGE HELP FID@__– END MESSAGEEND MESSAGE

? On dialog – drag to item? On dialog – drag to item

Timer MessageTimer Message MESSAGE TIMERMESSAGE TIMER

– Message processing block Message processing block – Automatically generated Automatically generated – Used to refresh the display of image/ Used to refresh the display of image/

animation animation ENABLE TIMER nENABLE TIMER n

– start automatic generation of messages start automatic generation of messages every n tenths of a secondevery n tenths of a second

DISABLE TIMERDISABLE TIMER stops messages stops messages

SET ITEM FONTSET ITEM FONT Sets font on text display in dialogSets font on text display in dialog Size – Small, Standard, LargeSize – Small, Standard, Large BoldBold ItalicItalic UnderlineUnderline Font FaceFont Face

PQLFormsPQLForms Replacement for FormsReplacement for Forms Record at a time GUI screensRecord at a time GUI screens Data Browsing and Data EntryData Browsing and Data Entry Integrated with VisualPQLIntegrated with VisualPQL

PQLFormsPQLForms Extensions to VisualPQLExtensions to VisualPQL

– Include standard VisualPQL in source as necessaryInclude standard VisualPQL in source as necessary– Generates standard VisualPQL Generates standard VisualPQL

Keeps Forms ‘style’Keeps Forms ‘style’– SCREEN per record/tableSCREEN per record/table– FIELD commandFIELD command– Next/Previous, etc. Next/Previous, etc.

Predefined LogicPredefined Logic– Clauses on commands to edit, check data, etc.Clauses on commands to edit, check data, etc.– Standard Buttons for users to navigateStandard Buttons for users to navigate

Dialog BasedDialog Based

PQLForms StructurePQLForms StructureFORM – Overall ProgramFORM – Overall Program

SCREEN – Menu / Record / RowSCREEN – Menu / Record / Row(PAGE – New Page of displayed fields)(PAGE – New Page of displayed fields)FIELD – Variable (FIELD – Variable (Prompt,Data,Label)Prompt,Data,Label)CALL – Button for user to pass CALL – Button for user to pass control to other SCREENcontrol to other SCREEN

END SCREENEND SCREENEND FORMEND FORM

PQLForms StructurePQLForms Structureform. screen record EMPLOYEE. field id. field name. field currpos. call screen OCCUP. end screen. screen record OCCUP. field id. field position. field startsal. end screenend form

Example PQLFormExample PQLForm

Using FormsUsing Forms Run as normal from file or memberRun as normal from file or member

– Save as :ESave as :E– Ensure databases/tabfiles connectedEnsure databases/tabfiles connected

Standard ButtonsStandard Buttons Prompt/Data/LabelsPrompt/Data/Labels Enter for KeysEnter for Keys Enter for DataEnter for Data

Screen Painter Screen Painter Point & ClickPoint & Click Dialogs Dialogs PQLFormsPQLForms Integrated with member editingIntegrated with member editing

Dialog & Forms ‘Painter’Dialog & Forms ‘Painter’ Interactive, visual toolInteractive, visual tool Create and position dialog elementsCreate and position dialog elements Create and position forms elementsCreate and position forms elements Link forms elements to database and Link forms elements to database and

table variablestable variables Integrate with specification of all Integrate with specification of all

clausesclauses New VisualPQL dialog typeNew VisualPQL dialog type

VisualPQL - DEDITVisualPQL - DEDIT DEDIT type,id,arg1,arg2 DCONTROL - Types 1 to 12 - Types 1 to 12 LABEL EDIT BUTTON CHECK RADIO CHOICE LIST TEXT HLINE VLINE LBOX IMAGE

Messages – Types 0 to 11Messages – Types 0 to 11 INITIAL STOP NEW CLONECLONES MOVE SIZE DELETE PROPERTIES LIST TEST HELP

Dialog PainterDialog Painter Integrates layout with logic Integrates layout with logic

specificationspecification Use Members or FilesUse Members or Files Edit menu recognises sourceEdit menu recognises source

Form PainterForm Painter Similar to Dialog PainterSimilar to Dialog Painter Linked to database & tabfile Linked to database & tabfile

variablesvariables Generates new Forms programsGenerates new Forms programs

SIR2002

SIR 2002SIR 2002