Database line commands


In cross-reference views that show database names, you can use the following line commands.

Note

The global versions of the commands add the Global keyword to the corresponding IMS command.

IRLM must be in use for global database command support.

Line command

Result

PD

PDG

Stop a database

Issues the IMS /STOP DATABASE command to stop a database. The STOP command does not close the database. It prevents subsequently scheduled programs from accessing the database. Programs that were already scheduled are not affected.

PD stops the database on the target IMS subsystem.

PDG stops the database on all IMS subsystems that share the database.

SD

SDG

Start a database

Issues the IMS /START DATABASE command to start a database. The START command allocates and permits access to the database. Any messages on the suspend queue, for transactions whose program has access to the database, are moved to the normal queue. If the database is registered to DBRC and requires backout or recovery, it will not be started.

SD starts the database on the target IMS subsystem.

SDG starts the database on all IMS subsystems that share the database.

RD

RDG

DBRecover a database

Issues the IMS /DBR DATABASE command. DBR closes and deallocates the database and unauthorizes it with DBRC. The command is used to prevent programs or transactions from accessing the database. After closing the database, IMS switches to the next OLDS and issues a simple checkpoint. The /DBD DATABASE will fail for any databases being accessed by a BMP or JBP.

RD modifies the database on the target IMS subsystem.

RDG modifies the database on all IMS subsystems that share the database.

ND

NDG

DBRecover a database with the NOFEOV option

Issues the IMS /DBR DATABASE command with the NOFEOV option. The NOFEOV prevents IMS from doing an OLDS switch after completing the database recovery.

ND modifies the database on the target IMS subsystem.

NDG modifies the database on all IMS subsystems that share the database.

LD

Lock a database

Issues the IMS /LOCK DATABASE command to lock a database. The LOCK command prevents subsequently scheduled programs from accessing the database. Programs already scheduled are not affected.

UD

Unlock a database

Issues the IMS /UNLOCK DATABASE command to unlock a database. The /UNLOCK command allows programs and transactions to access the database.

DD

DDG

DBDUMP a database

Issues the IMS /DBDUMP DATABASE. These commands are used to prevent transactions or programs from updating DL/I databases. Message regions using the database will be terminated when they finish processing. The database will then be closed and reopened for input. The database dump command will fail if any BMPs or JBPs are accessing the database.

DD modifies the database on the target IMS subsystem.

DDG modifies the database on all IMS subsystems that share the database.

SQ

Quiesce a database

This command issues the IMS UPD DB NAME() START(QUIESCE) OPTION(NOHOLD) command, which quiesces the selected database without placing a hold on the database.

SQH

Quiesce a database

This command issues the IMS UPD DB NAME() START(QUIESCE) OPTION(HOLD) command, which quiesces the selected database and places a hold on the database.

PQ

Stop a database quiesce

This command issues the IMS UPD DB NAME() STOP(QUIESCE) command, which stops the quiesce that is in progress for the selected database.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*