VA FileMan Programmer Manual: CHKPT^DIUTL

Contents:

Main

File Pointer Maintenance API

CHKPT^DIUTL(): Check for Existing File Entry Points

Reference Type	Category	ICR #
Supported	File Pointer Maintenance	6876

Description

The CHKPT^DIUTL API checks what entries points to a particular record exist in a VA FileMan file. It returns an array of records in one of two formats based on the flag parameter:

FLAG=0 (default)—text:

ARRAY(0)=line count
ARRAY(line #)="Entry" record ien "in FILE (" file ") refers to it"

FLAG=1—detailed: Shows data and data dictionary information that points to the record:
```
ARRAY(0)=line count
ARRAY(file #, ien, dd/subdd #, field #)=""
```

NOTE: This API was released with VA FileMan Patch DI*22.2*10 and updated with DI*22.2*19.

Format

    CHKPT^DIUTL(FILE,IEN,MSG_ROOT[,FLAG])

Input Parameters

file	(Required) VA FileMan file number.
ien	(Required) Internal Entry Number (IEN) of the record.
msg_root	(Required) Closed global root or local array.
flag	(Optional) Output format: 0 (default)—text 1—detailed

Output

Depending on flag parameter, it returns:

FLAG=0 (default)—text:

ARRAY(0)=line count
ARRAY(line #)="Entry" record ien "in FILE (" file ") refers to it"

FLAG=1—detailed: Shows data and data dictionary information that points to the record:
```
ARRAY(0)=line count
ARRAY(file #, ien, dd/subdd #, field #)=""
```

Reviewed/Updated: May 2026