Open Method (ANIMATE)

9.0, PLBCMP GUI Only

The Open method associates an AVI file with an ANIMATE object. The method uses the following format:

Where:

label

Optional. A Program Execution Label.

object

Required. An ANIMATE object that is accessed.

return

Optional. A Numeric Variable that indicates the success or failure of the method.

name

Required. A Character String Variable or literal that specifies the name of the AVI file.

Flags Affected: EOS, OVER, ZERO

Note the following:

1. When running under the PL/B Application Server, the first character of the file {name} has special meaning:

 

First Character	The file ...
! (exclamation mark)	resides on the client rather than the server.
? (question mark)	is obtained from the cache or from the server and placed in the cache.
* (asterisk)	is obtained from the in-memory cache or from the server and placed only in the in-memory cache.

 

2. A return value of zero (0) indicates success.

3. If the value returned is zero, the ZERO Condition Flag is set.

4. The OVER and EOS Condition Flags are always cleared.

5. For improved performance in the Application Server environment, do not specify the optional return value unless needed.

See Also: Example Code, Method Syntax, ANIMATE Methods