LOGINFO
NM and CM callable.
Provides information about an opened user logging file (whole file set).
User logging (LG) or system supervisor (OP) capability is required.
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.
(Refer to Table 4-25
item array whose type varies (optional)
Returns the value of the item specified by the
corresponding itemnum. Refer to Table 4-25 .
Table 4-25. LOGINFO Itemnum/Item Values
-----------------------------------------------------------------------------------------------
| | | |
| 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 |
| | | |
-----------------------------------------------------------------------------------------------
Related Information
Intrinsics None
Commands SHOWLOGSTATUS
Manuals User Logging Programmer's Guide (32650-90027)