SIR2002 What’s New in SIR2002 and How to Use it

SIR Review n VisualPQL –Dialogs and Message Processing –New Commands –New Functions –Pop Up Boxes –‘EXECUTE DBMS’ n New User Interface n ODBC n Multiple Databases

SIR Review n Descriptive, Plot, Graph Procedures n Internet Enabled n New Master Communication n Additional File Support n Unlimited Program Size n No ‘Table Space’ n Spreadsheet

SIR2002 Major New Features n User Interface Enhancements n Database Enhancements n VisualPQL Enhancements n Dialog and Menu Enhancements n PQLForms n Screen Painter for Dialogs n Screen Painter for PQLForms n ODBC Enhanced

SIR2002 User Interface n Enter into window, submit with ctrl-R n Search window n Data/Spreadsheet menu access to tabfiles & database using indexes n Paged Dialogs e.g. Procedures, Record Schema, Settings n Program/member –Improved search –Create new procedure file n Painters available from program menu n Secondary Index on schema n ‘Rewind’ Button

Database Enhancements n Secondary Indexes n Extended Strings –String Compression n Auto Increment Keys n SIR SPREADSHEET –New Grid –Secondary Indexes n Duplicate Value Label Check

Secondary Indexes n n Analogous to tabfile secondary indexes n n Multiple variables as keys in index n n Multiple indexes on a record type n n Creation - command or schema menu n n Automatic maintenance n n List Stats

Secondary Indexes Secondary Indexes Creation n n Database/Secondary Index Menu n n Command – –CREATE [UNIQUE] DBINDEX index_name ON database.recname ( var_name [ ASC | DESC ] [,... ] ) [UPPER] n n Creates the index structure n n Creates the actual index from values of any existing records

Secondary Indexes Secondary Indexes Maintenance n n Index is automatically maintained if records are added, deleted or modified n n Maintenance automatic through all modules – Utilities, PQL, Master, Forms, SQL n n Indexes rebuilt if database recovered from Import or Reload n n Delete index – –DROP DBINDEX index_name ON [database.] recname | ALL

Secondary Indexes Places Used n n VisualPQL – –PROCESS RECORD … INDEXED BY … – –LOOKUP RECORD... INDEXED BY … n n PQLForms – –SCREEN RECORD... INDEXED BY … n n SPREADSHEET utility – –SIR SPEADSHEET RECTYPE = n / INDEXED BY …..

Extended Strings n Maximum Database String Variables size increased to 4094 n Database Strings Compressed n Database keys fixed length –Max. 320 characters in total –Sort keys same limits –Secondary Index keys same limits

Auto Increment Keys n Final Part of Key –Named Integer Variable n Specify as SORT IDS name (I) n Ascending number from previous record of same type in Case n Specify as 0 in REC IS (key,0) n If value specified, it is used

SIR2000 SPREADSHEET n Third Party Active-X Control n Windows Only n Needs Complete Data Set n Slow n Size Limits n No resize

SIR2002 GRID n Runs on all platforms n Displays immediately n No limitations on number of rows n Resizable n Used in SIR SPREADSHEET utility –Enhanced for secondary indexes

VisualPQL Enhancements –PROCESS REC …. INDEXED BY –Extended Strings –Extended Constants –Redefinition of arrays –Sorting Arrays –GRID Command –LOOKUP Command –50 extra functions (tabfile schema) –File Handling n Extended number of text files open n Text files between windows and Unix n HEX Format on READ and WRITE –LABEL for headings on Quick Report –FORMAT for fields on CSV

PROCESS RECORD... INDEXED BY n n All existing clauses used in conjunction with INDEXED BY – –AFTER, FROM, THRU, etc. n n Makes the case and record current for update as necessary n n RECORD IS constructs do not support the INDEXED BY clause

Extended Strings and Constants n String size increased to 4094 –Local Variables –Database Variables –Database Strings Compressed n Maximum constant limit of 32k removed –Limit is 4096 constants of any size n Database keys fixed length –Max. 320 characters in total –Sort keys same limits –Secondary Index keys same limits

Array Processing REDEFINE ARRAY array_name (dim1, dim2,...) –Alters dimensions –Alters number and/or value of any dimension –Array can grow or shrink –Existing values mapped to new dimensions –New values are set to missing. –NOARRAYMSG n SORT array_name [BY key_array_varname] [(n)] [DESCENDING]

GRID Command GRID title list_of_arrays (1 or 2 dimension) [HEADERS=(list_of_col_headers)] [HEADERS=(list_of_col_headers)] [RESPONSE = integer_varname| [RESPONSE = integer_varname|array_varname] [SIZE=rows] [SIZE=rows] [DISPLAY=row,width] [DISPLAY=row,width] [UPDATE | NOUPDATE] [UPDATE | NOUPDATE]

PQL Procedure (unchanged) SPREAD SHEET [/VARIABLES= varlist ] [/SORT=[(n)]variable[(A)|(D)],...] [/BOOLEAN= (logical_expression)] [/SAMPLE= fraction [,seed ] ] [/TITLE= 'spreadsheet title']

LOOKUP command n LOOKUP RECORD dbname.recname | TABLE tabfile.table [INDEXED BY indexname] [GET VARS ALL| 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 n Secondary 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 n DEDIT – –Various ‘painter’ dialog functions n n Files & Directories – –FILECNT C ount of files in named directory – –FILEIS I f 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) 2 st_atime Access Time 3 st_ctime Creation Time 4/9 st_dev Drive number 5 st_ino inode (UNIX) 6 st_mode Bit mask for file-mode information. 7 st_mtime Modification time 8 st_nlink Always 1 on non-NTFS file systems 10 st_size Size (bytes) 11 uid User (UNIX) FILESTAT Function

New Functions FILETIME Function returns SIR times or dates about a file FILETIME Function returns SIR times or dates about a file –1 Time of last access –2 Date of last access –3 Time of creation –4 Date of creation –5 Time of last modification –6 Date of last modification

New Functions n Schema – –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 n Tabfile Schema –TABINDU I ndex unique –TABRECS N umber of rows on table –TABVINFN Various numeric data about a table column –TABVINFS Various character data about a table column –TABVRANG Valid or missing value ranges –TABVVALI Validates a table variable –TABVVLAB Label for value label n for table col –TABVVVAL Value for value label n for table col

New F New Functions n Main Output Window –WINCNT Number of lines in output window WINLIN Nth line from the output window WINMOVE Moves and resizes main window WINPOS Moves to line in output window and highlights line WINSELL Selected Line WINSELP Position in the line selected

File Handling n Extended number of text files open n Text files between windows and Unix n n Binary File READ and WRITE Special Formats –HEXw Binary string, w digits(up to 4094) –IBw Binary integer, w digits(1,2 or 4) –RBw Binary real, w digits (4 or 8)

Dialog and Menu Enhancements –4000+ Elements in single dialog –SHOW/HIDE elements in dialog –POPUP Menus in menus and dialogs –HELP Message type –TIMER Message type –DEDIT dialog type –SET ITEM FONT

‘Tabbed’ or Paged Dialogs –4000+ Elements –SET DIALOG TITLE string_exp –SHOW ITEM id –HIDE ITEM id

Pop Up Menus n DISPLAY POPUP LIST (string_exp,string_exp,..) | array_name,no_of_items ANCHOR id | AT row,col ANCHOR id | AT row,col RESPONSE num_varname RESPONSE num_varname [SEPARATOR n,n...] [SEPARATOR n,n...] [POSTYPE num_exp] [POSTYPE num_exp] n Displays pop up menu in menu or dialog n Positioned relative to ANCHOR id or at the position specified by the AT clause. n RESPONSE returns selected item (or –1)

Help Message n Help Dialog Message –MESSAGE HELP –END MESSAGE n ? On dialog – drag to item

Timer Message n MESSAGE TIMER –Message processing block –Automatically generated –Used to refresh the display of image/ animation ENABLE TIMER n ENABLE TIMER n – start automatic generation of messages every n tenths of a second DISABLE TIMER stops messages DISABLE TIMER stops messages

SET ITEM FONT n Sets font on text display in dialog n Size – Small, Standard, Large n Bold n Italic n Underline n Font Face

PQLForms n Replacement for Forms n Record at a time GUI screens n Data Browsing and Data Entry n Integrated with VisualPQL

PQLForms n Extensions to VisualPQL –Include standard VisualPQL in source as necessary –Generates standard VisualPQL n Keeps Forms ‘style’ –SCREEN per record/table –FIELD command –Next/Previous, etc. n Predefined Logic –Clauses on commands to edit, check data, etc. –Standard Buttons for users to navigate n Dialog Based

PQLForms Structure FORM – Overall Program SCREEN – Menu / Record / Row (PAGE – New Page of displayed fields) FIELD – Variable ( Prompt,Data,Label) CALL – Button for user to pass control to other SCREEN END SCREEN END FORM

PQLForms Structure form. screen record EMPLOYEE. field id. field name. field currpos. call screen OCCUP. end screen. screen record OCCUP. field id. field position. field startsal. end screen end form

Example PQLForm

Using Forms n Run as normal from file or member –Save as :E –Ensure databases/tabfiles connected n Standard Buttons n Prompt/Data/Labels n Enter for Keys n Enter for Data

Screen Painter n Point & Click n Dialogs n PQLForms n Integrated with member editing

Dialog & Forms ‘Painter’ n Interactive, visual tool n Create and position dialog elements n Create and position forms elements n Link forms elements to database and table variables n Integrate with specification of all clauses n New VisualPQL dialog type

VisualPQL - DEDIT n n DEDIT type,id,arg1,arg2 n - Types 1 to 12 n DCONTROL - Types 1 to 12 LABEL EDIT BUTTON CHECK RADIO CHOICE LIST TEXT HLINE VLINE LBOX IMAGE Messages – Types 0 to 11 Messages – Types 0 to 11 INITIAL STOP NEW CLONE CLONES MOVE SIZE DELETE PROPERTIES LIST TEST HELP

Dialog Painter n Integrates layout with logic specification n Use Members or Files n Edit menu recognises source

Form Painter n Similar to Dialog Painter n Linked to database & tabfile variables n Generates new Forms programs

SIR2002