Command options

Following are the set of commands that can be passed on the URL of a web interaction.

debug

debug tells the dll which debug queue to use for the current page.

Debug in the URL

    http://machinename/scripts/connector.dll?pagename=syslogon&debug=bob1

Debug object on the page

    <input type=hidden name=debug value=bob1>>

 

 

session / sessionid

session / sessionid tells the session manager which session number to use for the current interaction. sessionid is new to 3.2 and only works when a server pin is defined. Any new account or upgraded account will use sessionid while older accounts will still use session. sessionid is encrypted for each page interaction. You should not make use of the session / sessionid variables directly in you urls, but should rather use the {{url DIRT tag.

Session object on the page

    <input type=hidden name=session value=2345435343>
OR
    <input type=hidden name=sessionid value=072584676483008450667576029640000456>

 

 

sequence

sequence tells the session manager which sequence number to use for the current interaction. This should no longer be used in 3.2 and above.

Sequence in the URL

http://machinename/scripts/connector.dll?session=2345435343&sequence=3

Sequence object on the page

<input type=hidden name=sequence value=3>

 

 

sessioncopy / linksession

sessioncopy / linksession is used to copy a session's security from one window to another. linksession is new to 3.2 and only works when a server pin is defined. Any new account or upgraded account will use linksession while older accounts will still use sessioncopy. linksession is encrypted for each page interaction. You should not make use of the sessioncopy / linksession variables directly in your urls, but should rather use the {{url DIRT tag.

For added security, web builder can be configured so as to only allow a particular linksession value once. To enable this feature, tick the box on the Configuration, General Options screen. If this is enabled, and the same linksession is presented to jWB, a linksession error will fire.

JavaScript Example

<script>
url = "{{url||page||syslogon}}";
windowopts = "top=50,left=50,width=800,height=600";
window.open(url,"MyWindow",windowopts);
</script>

 

 

sequencecopy

sequencecopy is used to copy a session's security from one window to another. This should no longer be used in 3.2 and above.

Sequencecopy in the URL

http://machinename/scripts/connector.dll?pagename=syslogon&sessioncopy=2345435343&sequencecopy=23

JavaScript Example

<script>
    url = "{{variable||sysexename}}?pagename=syslogon&";
    url = url + "sessioncopy={{variable||syssession}}&";
    url = url + "sequencecopy={{variable||syssequence}}";
    windowopts = "top=50,left=50,width=800,height=600";
    window.open(url,"MyWindow",windowopts);
</script>

 

 

datacopy

datacopy is used to copy the common block entries sysid, sysdata, syshidden and sysreserved between pages. It's value can be used to specify whether you want to copy all the entries, or a specified combination of sysid, sysdata, syshidden, and sysreserved. Multiple entries are delimited by a comma (,).

datacopy in the URL

Copy all values between sessions:
http://machinename/scripts/connector.dll?pagename=syslogon&sessioncopy=2345435343&sequencecopy=23&datacopy=all

Copy only sysdata between sessions:
http://machinename/scripts/connector.dll?pagename=syslogon&sessioncopy=2345435343&sequencecopy=23&datacopy=sysdata

Copy sysdata and sysid between sessions:
http://machinename/scripts/connector.dll?pagename=syslogon&sessioncopy=2345435343&sequencecopy=23&datacopy=sysdata,sysid

JavaScript Example

<script>
    url = "{{url||page||syslogon}}&";
    url = url + "datacopy=all";
    windowopts = "top=50,left=50,width=800,height=600";
    window.open(url,"MyWindow",windowopts);
</script>

 

 

pagename

pagename allows the developer to specify in the URL which page they would like to view.

pagename in the URL

http://machine/scripts/connector.dll?pagename=syslogon

 

 

routine

routine allows the developer to call a routine via the URL.

routine in the URL

http://machine/scripts/connector.dll?routine=MySubRoutine

 

 

pagecall

pagecall calls a non-secure page. ie: the session manager does not create a session.

pagecall in the URL

http://machine/scripts/connector.dll?pagecall=MyPageName

 

 

trigger

trigger specifies the trigger that was set when the page was submitted.

Trigger object on the page

<input type=submit name=trig_1 value=button1>

JavaScript Example

<script>
<input type=button name=MyButton value=MyButton
    onclick = "document.forms[0].trigger.value='sub_sysnavrefresh';
    document.forms[0].submit();">
</script>