Inquire Function

You can use the inquire function to query information about any backups managed by the external backup tool.

This function is called with the user ID, the backup ID, and the file name or pipe name. The user ID must be specified, but the backup ID and file name or pipe name are optional. The content of the output file for this function depends on the information specified in the request.

If the input list contains multiple entries, Backint for MaxDB generates the output for the individual entries, and displays it in the order they were entered.

There are four possible cases:

Entries in the Input File

Entries in the Output File

Neither backup ID nor file name or pipe name specified
#NULL

List of backup IDs for a user ID sorted by the date the backup was created (latest backup first)
One list entry consists of one backup ID.
#BACKUP <backup_id>

If no backup IDs exist for the specified user ID, Backint for MaxDB does not create any output.

Backup ID specified, file name or pipe name not specified:
<backup_id>

List of files or pipes that belong to the backup ID
Each list entry consists of the specified backup ID and a file name or pipe name.
#BACKUP <backup_id> <file_name>
|#BACKUP <backup_id> <pipe_name>

If no files and/or pipes exist for the specified backup ID, Backint for MaxDB does not create any output.

File name or pipe name specified,
backup ID not specified:
#NULL <file_name> |#NULL <pipe_name>

List of backup IDs that belong to the specified file or pipe, sorted by the date the backup was created (latest backup first)
Each list entry consists of a backup ID and the specified file name or pipe name.

( #BACKUP <backup_id> <file_name>
|#BACKUP <backup_id> <pipe_name>
)

If no backup exists for the specified file or pipe, MaxDB generates output that contains the keyword #NOTFOUND.

(#NOTFOUND <file_name>)
(#NOTFOUND <pipe_name>)

Both backup ID and file name or pipe name specified:
<backup_id> <file_name>
|<backup_id> <pipe_name>

The backup specified by the backup ID and the file name or pipe name:
#BACKUP <backup_id> <file_name>
|#BACKUP <backup_id> <pipe_name>

If no backup with the specified backup ID exists for the specified file or pipe, MaxDB generates output that contains the keyword #NOTFOUND.

(#NOTFOUND <file_name>)
(#NOTFOUND <pipe_name>)