Centric features In this presentation… –macro capabilities more sophisticated functionality –advanced macro features Inspector Debugging error trapping

centric features

• In this presentation…– macro capabilities

• more sophisticated functionality

– advanced macro features• Inspector• Debugging• error trapping• printing macros• structures and user defined types

– all features discussed in this session are also available with newlook developer (ND)

Advanced Macro Programming

• inspector

– access to variables, objects and properties– read and modify access– remove variables– value and type information– arrays and collections– watch important values


• inspector

– All window


• inspector

– Auto window


• inspector

– Watch window


• debugging

– control and inspect execution– breakpoints– macro context list– observe execution of code even without errors


• types of problems

– error conditions– invalid input– macro logic errors


• breakpoints

– breakpoints halts the execution of a macro or script and gives you a snapshot of its condition at any moment.

– variables and properties can be inspected to analyze the current state.

– variables and property values can be changed to alter the execution of the macro or script.


• breakpoints allow you to:

– observe the condition of the user interface. – determine which active macros/scripts have been

called. – watch the values of variables, properties, and

objects. – change the values of variables and properties. – view which action the macro or script will run next.


• breakpoints occur when:

– execution reaches a line with a breakpoint– you choose Break from the Run menu– you click the Break button on the toolbar– a break expression defined in the Add Watch dialog

box changes


• debugging toolbar

– debugging mode• turn on or off the debugging features. When debugging

mode is turned off breakpoints do not cause execution to halt.

– start• begin execution from current location and proceed until

next breakpoint is reached.



– break• halt execution at the macros current location.

– end• terminate execution of the current macro/script at its

current location.



– step into• continue execution by executing the next statement

and move into the next macro/script being called.

– step over• continue execution by executing the next statement

and move over the next macro/script being called.



– step to cursor• continues execution of the current macro/script until it

reaches the current cursor position.

– toggle breakpoint• turns on or off the breakpoint at the current cursor

position.



– clear all breakpoints• clears any breakpoints currently set

– show next action• displays the next action to be executed.• the editor will display the action with the cursor located

at the statement.



– add watch• add a variable, object or property to the Watch window

to allow its current value to be seen.

– context list• while in break mode, presents a dialog box that shows

all macros that have been called but not yet run to completion.




• context list

– displays the call stack.– shows all macros that have been called to get to this

execution point.– allows you to easily select the macros calling the

current macro to analyze their program logic.


• error trapping

– handling of error conditions.– actions to set error handlers, raise errors or resume

execution.– error handler is called if an error is encountered in

the macro when running.– default run-time error dialog if no error handler is

set.


• OnError macro action

– used to set or clear the error handler.– error handlers can be nested.– default handling displays run-time error dialog.– error handler should test or copy the Err object

properties before another error could be triggered.


• OnError macro action

– Arguments• label

name of location to execute if a macro error occurs.

blank label disables the error handler.

error handler automatically disabled when macro terminates.


• Resume macro action

– used to resume execution of a macro after a run-time error has been handled.

– special value of Next to resume at the statement after the one that triggered the error.

– other values allowed to resume at other points.


• Resume macro action

– Arguments• label

name of location to execute if a macro error occurs.

Next value behavior depends upon whether the handler is in the same macro as where the error was triggered.


• Raise macro action

– Arguments• Number

error number to be raised.

• Descriptiontext description to be displayed in error dialog.


• Raise macro action

– generates a run-time error.– can be called from error handler or from general

macros.


• Err object

– used to provide information about a run-time error.– only valid when a error handler is executing.– read-only but Raise can be used to set errors.– property of the App object.


• printing macros

– debugging– education– versioning

– clipboard can also be used to bring macro contents across to another application (such as notepad)

• printing macros

Open DBConnect (SampleConnection, DBServerDDM, ="Network Address=" & NetworkAddress & ";Network

Port=447;Use Encryption for Data=False;Host CCSID=37;Mode=ReadWrite|ShareDenyNone;Isolation Level=ReadCommitted;Process Binary as Character=True")

DBOpen (SampleRecordset, SampleConnection, /QSYS.LIB/QGPL.LIB/QAFCTUTDBF.FILE/DBFILE1.MBR,

DBUseServer, DBOpenForwardOnly, DBLockReadOnly, DBCmdUnknown)RunMacro (Sample - Database actions.First, , )StopMacro

Close DBClose (SampleRecordset)DBDisconnect (SampleConnection)StopMacro



• user defined types

– structures.– database records.– Call, RPCCall and WebCall


• predefined data types

– Byte– Boolean– Integer– Long– Single– Double– String– String *– WString– WString *


• Type macro action

– used to describe a user defined data type.– can have one or more elements.– multiple element data types are referred to as

structures.– described using predefined data types.


• Type macro action example

Type (MyType, Code as Long, Description as String * 32)


• Dim macro action

– declares a variable and allocates storage.– convention is to put Dim actions at the beginning of

the macro.– variable type can be a pre-defined type or a user

defined type.– typically used in conjunction with the Type action

and is not usually required for variable creation within macros.


• Dim macro action example

Dim (MyVariable, MyType)


• referencing fields

Type (MyType, Code as Long, Description as String * 32)

Dim (MyVariable, MyType)SetValue (MyVariable.Code, 99)SetValue (MyVariable.Description, "Undefined error!")


• referencing fields


• Call example

– Type (WIN32_FIND_DATA, dwFileAttributes as DWORD,ftCreationTimeLow as DWORD, ftCreationTimeHigh as DWORD,ftLastAccessTimeLow as DWORD,ftLastAccessTimeHigh as DWORD,ftLastWriteTimeLow as DWORD,ftLastWriteTimeHigh as DWORD,nFileSizeHigh as DWORD,nFileSizeLow as DWORD,dwReserved0 as DWORD,dwReserved1 as DWORD,cFileName as String * 260,cAlternateFileName as String * 14)


• Call example

– Declare (C:\Winnt\System32\Kernel32.dll, FindFirstFileA, , Long, ByVal lpFileName as String, ByRef lpFindFileData as WIN32_FIND_DATA)

– Dim (FindFileData, WIN32_FIND_DATA)– Call (FindFirstFileA, fldFileName,FindFileData, iResult)


• RPCCall example

– Type (InfoTable2, p1 as String * 10, p2 as String * 1, p3 as String * 1, p4 as Long, p5 as String * 20)

– Type (ChridReceiver, p1 as Long, p2 as Long, p3 as InfoTable2)

– Dim (VarChrid, ChridReceiver)


• RPCCall example

– RPCDeclare (Connection1, QSYS, QWCRSVAL, QuerySystemChar, , Output prmRetVar as ChridReceiver, Input prmRetVarLen as Long, Input prmNumofValues as Long, Input prmValueName as String * 10, InputOutput prmError as String)

– RPCCall (Connection1, QuerySystemChar, VarChrid, 44, 1, "QCHRID", fldError, )

centric 8 Training

Workshop 1

Documents

Centric features In this presentation… –macro capabilities more sophisticated functionality –advanced macro features Inspector Debugging error trapping