TOIAUTO_Q keyword

The TOIAUTO_Q keyword specifies whether IMS Tools Online System Interface issues database quiesce commands before and after the batch image copy process.

This keyword is effective for the batch image copy process and when the IMS Tools Online System Interface is used.
Functions that support this keyword
Image Copy function
Statements that support this keyword
GLOBAL statement
Site default option
Supported
Related keywords
Format
Read syntax diagramSkip visual syntax diagramTOIAUTO_Q=NY
Y
Issues database quiesce commands before and after the batch image copy process.
N
Does not issue any database quiesce commands.
Default value
TOIAUTO_Q=N
Usage notes
  • To apply TOIAUTO_Q=Y, the following conditions must be satisfied:
    • All the load libraries of IMS HP Image Copy and the IMS Tools Online System Interface, and IMS HP Image Copy site default module are APF-authorized.
    • IMS Type 2 command is available through the OM API.
    • DBRC=Y is specified. If DBRC=N is specified, IMS HP Image Copy does not issue database quiesce commands.
    • Database data set or area data set is registered to DBRC.
    • MINVERS of the RECON data set is 11.1 or higher.
    • TOIXCFGR keyword is specified.
    • While the IMS HP Image Copy job is running with TOIAUTO_Q=Y, you must not manually issue any database quiesce commands. If you manually issue database quiesce commands, an unexpected result might be encountered.
  • TOIAUTO_Q=Y is ignored when specified with the following statements:
    • RCV (Recovery function)
    • CRC (Create Image Copy function)
    • CIC (concurrent image copy)
    • ACIC (concurrent image copy)
    • GROUP statements that contain FUNC=CIC, FUNC=ACIC, or FUNC=CRC keyword
  • The TOIAUTO keyword and TOIAUTO_Q=Y are mutually exclusive.
  • The following considerations apply to the database quiesce function:
    • If the database was already quiesced by another program, IMS HP Image Copy will not release the quiesce on the database after the IMS HP Image Copy job step ends.
    • If a quiesce command fails for the database, IMS HP Image Copy will not create image copies of the database.
    • In the restart processing of the Checkpoint Restart function, IMS HP Image Copy will not issue database quiesce commands for the database that was successfully processed in the previous run. IMS HP Image Copy will issue database quiesce commands only for the databases that will be reprocessed.
    • To quiesce the database, IMS HP Image Copy issues an IMS Type 2 command, such as UPDATE DB or UPDATE AREA command, together with the START(QUIESCE) and OPTION(HOLD) keywords. To release the quiesce, IMS HP Image Copy issues UPDATE DB or UPDATE AREA command together with the STOP(QUIESCE) keyword.
    • IMS HP Image Copy specifies OPTION(NOFOEV) keyword when issuing an IMS Type 2 command to release the quiesce on the database. This keyword specifies that the IMS log is not switched to the next OLDS by the database quiesce and a simple checkpoint is not taken. To switch the IMS log, you must do it manually.
    For more information about the database quiesce function, see IMS publications.