LOGINFO

Syntax

           I32V   I16         I16V     *
  LOGINFO (index, logstatus [,itemnum, item] [...]);

NOTE: You can specify up to four itemnum/item pairs.

Parameters

index

32-bit signed integer by value (required)

Passes your access to the user logging system. This is the value returned in the index parameter of the OPENLOG intrinsic.

logstatus

16-bit signed integer by reference (required)

Returns one of the following values, indicating the success/failure of the intrinsic call:

Value

Meaning

0

Successful

2

Parameter out of bounds

4

Incorrect index parameter

7

Illegal capability; user logging (LG) or system supervisor (OP) capability required

14

Invalid access

17

Either itemnum or item missing

18

Invalid itemnum

itemnum

16-bit signed integer by value (optional)

Specifies which item value is to be returned.

item

array whose type varies (optional)

Returns the value of the item specified by the corresponding itemnum.

Item Numbers

Itemnum/
Mnemonic

Item Description

1/I32

Total number of records written in current file

2/I32

Current file size

3/I32

Current file space left

4/I16

Number of users

5/I32

Total records written in whole file set

6/CA

Current log file name

7/I16

Current log file type

0

DISK

1

TAPE

8/CA

Previous log file name

9/I16

Previous log file type

0

DISK

1

TAPE

10/U16

CHANGELOG allowed (true/false)

11/U16

AUTO allowed (true/false)

12/I16

Current file sequence number

13/I16

Log status:

0

INACTIVE

1

ACTIVE

2

Close pending

3

Stop pending

14/I16

Returns unique log number for the logging process

Related Information

Commands

SHOWLOGSTATUS

Manual

User Logging Programmer's Guide