Domdsmc query DB2pendingdbs

How to use the domdsmc query db2pendingdbs command is described.

Purpose

The domdsmc query db2pendingdbs parameter lists the DB2® enabled Notes® databases that are pending activation. These databases reside in an alternate database and the activate process (Domdsmc DB2activatedbs) copies them to the Domino® DB2 database. The alternate DB2 database is considered available when it is not manually deleted through DB2 server interface, overwritten by another restore operation, or removed from the list of DB2 databases (that contain DB2 enabled Notes databases) available for activation.

Syntax


>>-DOMDSMC--Query -DB2Pendingdbs-------------------------------->

>--+-------------------------------+---------------------------->
   |               .-domdsm.cfg--. |   
   '-/CONFIGfile=--+-cfgfilename-+-'   

>--+----------------------------+--+--------------------+------><
   |            .-domdsm.log--. |  |             .-60-. |   
   '-/LOGFile=--+-logfilename-+-'  '-/LOGPRUne=--+-n--+-'   
                                                 '-No-'     

Parameters

/CONFIGfile=cfgfilename
Specifies the name of the Data Protection for IBM® Domino preferences file. The file name can include a fully qualified path. If you do not specify a path, it is assumed the preferences file in the directory where Data Protection for IBM Domino is installed.

The default preferences file is domdsm.cfg.

/LOGFile=logfilename
Specifies the name of the activity log that is generated by Data Protection for HCL Domino. The log file name is used for the current command and does not update the default log file that is stored in the preferences file. You can use the set command to change the default log file name that is stored in the preferences file. The command-line parameter can be used to override the default for one command run. If the specified file does not exist, it is created. If it does exist, new log entries are appended to the file. The file name can include a fully qualified path. If you do not specify a path, the file is written to the directory where Data Protection for HCL Domino is installed.

The default log file is domdsm.log.

When you are using multiple simultaneous instances of Data Protection for IBM Domino to run operations, use the /logfile parameter to specify a different log file for each instance. Using this parameter directs logging for each instance to a different log file and prevents interspersed log file records. Failure to specify a different log file for each instance can result in unreadable log files.

/LOGPRUne=60|n|No
Specifies whether to prune log entries. By default, log pruning is enabled and done daily. You can use the set command to do one of the following actions:
  • Change the defaults so that log pruning is disabled
  • Change the number of days log entries are saved
You can use the /logprune option to override these defaults for one command run. Note, when the value of /logprune is a number, the prune is done even if one is complete for the day.
You can specify:
60
Specifies that log entries are saved for 60 days before pruning.
n
Specifies the number of days to save log entries. The range of values is 0 - 9999. A value of 0 deletes all entries in the log except for the current command run entries.
No
Do not prune the log.
Changes to the value of the timeformat or dateformat parameter can result in an undesired pruning of the log file. If you are running a command that prunes the log file and the value of the timeformat or dateformat parameter changes, run one of the following to prevent pruning of the log file:
  • Make a copy of the existing log file.
  • Specify a new log file with the /logfile parameter or logfile setting.

Examples

Example 1: The following example queries (and displays) a list of DB2 enabled Notes databases that are pending activation:

domdsmc query db2pendingdbs

Output example:

    Domino Server: Server01
    --------------

    Backup Date           Size      Group    DB2 Database  Database
---------------------  -----------  -----    ------------  --------
01/21/2012 11:53:30        64.00B   GRP1     DOMALT1       db2nsf1.nsf
01/21/2012 11:53:30        64.00B   GRP1     DOMALT1       db2nsf2.nsf
01/21/2012 11:53:30        64.00B   GRP1     DOMALT1       db2nsf3.nsf
01/21/2012 11:53:30        64.00B   GRP1     DOMFULL1      db2nsf1.nsf
01/21/2012 11:53:30        64.00B   GRP1     DOMFULL1      db2nsf2.nsf
01/21/2012 11:53:30        64.00B   GRP1     DOMFULL1      db2nsf3.nsf
01/21/2012 11:53:30        64.00B   GRP2     DOMFULL1      db2nsf4.nsf
01/21/2012 11:53:30        64.00B   GRP2     DOMFULL1      db2nsf5.nsf
01/21/2012 11:53:30        64.00B   GRP2     DOMFULL1      db2nsf6.nsf

Example 2: The following example queries a list of DB2 enabled Notes databases that are pending activation. However, there are no databases waiting for activation:

domdsmc query db2pendingdbs

Output example:

ACD5418I There are no databases pending activation.