PicLan-IP Pre-compiler Statements

The following mv/Basic extension functions are included in PicLan-IP:

 1.  PL_GETVAR a1 FROM a2 THEN/ELSE
 2.  PL_GETHDR a1 from a2 THEN/ELSE
 3.  PL_ISVAR a1 FROM a2
 4.  PL_PUTVAR a1 IN a2 THEN/ELSE
 5.  PL_SETVAR a1 TO a2 THEN/ELSE
 6.  PL_GET_COOKIE a1 FROM a2 THEN/ELSE
 7.  PL_SET_COOKIE a1 TO a2
 8.  PL_ADD_HDR a1
 9.  PL_PR a1
10.  PL_PRINT a1
11.  PL_PRSTATE a1

PL_GETVAR a1 FROM a2 THEN/ELSE

Retrieve a form variable named a2 and store the result in variable a1.

The ELSE clause will execute if there is no form variable a2.

PL_GETHDR a1 FROM a2 THEN/ELSE

Retrieve an HTTP header named a2 and store the result in variable a1.

The ELSE clause will execute if there is no head field named a2.

If multiple header fields are named a2, then the result will be a dynamic array with multiple values seperated by value marks.

PL_ISVAR a1 FROM a2

If a2 is a form variable, then set a1 to 1, otherwise set a1 to 0.

PL_PUTVAR a1 IN a2 THEN/ELSE

Update or create a form variable named a2 and store the value of a1 in it.

The ELSE clause will execute if there is no existing form variable a2.

PL_SETVAR a1 TO a2 THEN/ELSE

Update or create a form variable named a2 and store the value of a1 in it.

The ELSE clause will execute if there is no existing form variable a2.

PL_GET_COOKIE a1 FROM a2 THEN/ELSE

Retrieve a header cookie named a2 and store it's string in a1.

The ELSE clause will execute if the cookie does not exist.

Cookies have limitations as to what types of data and how much data can be stored. You should keep cookie sizes as small as practical. You also cannot store binary data in cookies which precludes the direct storage of MultiValue delimiter characters. If you need to store MultiValue dynamic arrays, you can convert them to hex strings and then store those strings.

Cookies should not be used to store more than 1K in a single cookie or more than 4K for a single web site.

PL_SET_COOKIE a1 TO a2

Add an HTTP header to set a cookie named a1 to a value a2.

The stored cookie is not persistent and will expire when the browser is exited. Use PL_ADD_HDR ... to set persistent cookies.

PL_ADD_HDR a1

Add a manual HTTP header string.

PL_PR a1

Print to the screen and to the PLIP-MONITOR program without ending a line. This is the equivelent of:

PRINT 'this is a message' :

PL_PRINT a1

Print to the screen and to the PLIP-MONITOR program with end a line. This is the equivelent of:

PRINT 'this is a message'

PL_PRSTATE a1

Update the thread processes current processing state. When the current processing state is updated, the WWW TIMEOUT value restarts and any thread hangs will report the new state to the user in any error message.