Previous Topic Next topic Print topic


FSV-C-get-database-info

Gets the database information for the currently accessed server.

Syntax:

When the fsview has been initialized using FSV-C the callback uses the following syntax:

call FSV-C-get-database-info using      fsvw-data-block

When the fsview has been initialized using FSC-C-long-password the callback uses the following syntax:

call FSV-C-get-database-info using      fsvw2-data-block

Parameters:

Parameters when the fsview has been initialized using FSV-C (fsvw-data-block):

fsvw-dbase-filename
pic x(255).
fsvw-dbase-filename-size
pic x(2) comp-x.
fsvw-dbase-filesize
pic x(16).

Parameters when the fsview has been initialized using FSC-C-long-password (fsvw2-data-block):

fsvw2-dbase-filename
pic x(255).
fsvw2-dbase-filename-size
pic x(2) comp-x.
fsvw2-dbase-filesize
pic x(16).

See FSVIEW Datablock or FSVW2 Datablock for a complete definition of the fsvw-data-block or fsvw2-data-block respectively.

On Entry:

None.

On Exit:

When fsview has been initialized using FSV-C:

fsvw-dbase-filename
The database file name of the currently selected server.
fsvw-dbase-filename-size
Length of the name stored in fsvw-dbase-filename

A value of 0 (zero) means that no database in use.

fsvw-dbase-filesize
The size of the database file.

When fsview has been initialized using FSV-C-long-password:

fsvw2-dbase-filename
The database file name of the currently selected server.
fsvw2-dbase-filename-size
Length of the name stored in fsvw-dbase-filename

A value of 0 (zero) means that no database in use.

fsvw2-dbase-filesize
The size of the database file.

Comments:

This call does not directly return information to the calling program but makes repeated calls back to a user-defined call. Up to 10 entries at a time are sent to the callback. You must provide the callback specified in the FSVIEW function FSV-C-add-to-dbase-list.

The success of the call can be checked by examining RETURN-CODE.

Previous Topic Next topic Print topic