Start of change

CHANGE_MIRROR_OBJECTCONNECT procedure

The CHANGE_MIRROR_OBJECTCONNECT procedure is used to start, stop, and change the ObjectConnect for Db2® Mirror server.

Authorization: The user must have either the QIBM_DB2_MIRROR function usage or,
  • To change the STATE setting, *JOBCTL special authority.
  • To change any other setting, *IOSYSCFG special authority.

For the authority needed to use this procedure, see Authorization.

Read syntax diagramSkip visual syntax diagram CHANGE_MIRROR_OBJECTCONNECT ( STATE => state,AUTO_START => auto-start,MINIMUM_JOBS => minimum-jobs,MAXIMUM_JOBS => maximum-jobs,INACTIVE_TIME => inactive-time )

The schema is QSYS2.

state
A character or graphic string that indicates how to change the state of the ObjectConnect for Db2 Mirror server. If this parameter is omitted, the state of the ObjectConnect for Db2 Mirror server does not change.
END
End the ObjectConnect for Db2 Mirror server.
START
Start the ObjectConnect for Db2 Mirror server.
auto-start
A character or graphic string that indicates how to start the ObjectConnect for Db2 Mirror server. If this parameter is omitted, the auto-start server setting does not change.
NO
Do not start the ObjectConnect for Db2 Mirror server automatically.
YES
Start the ObjectConnect for Db2 Mirror server automatically when the MIRROR_OTHER Network Redundancy Group becomes active.
The initial configuration default value is YES.
minimum-jobs
An integer value that specifies the minimum number of server jobs that are started by the ObjectConnect receiver job to wait for client connections. If this parameter is omitted, the minimum number of server jobs does not change.
The initial configuration default value is 1. The maximum value is 999.
maximum-jobs
An integer value that specifies the maximum number of server jobs that are started by the ObjectConnect receiver job to accept client connections. If this parameter is omitted, the maximum number of server jobs does not change.
The initial configuration default value is 5. The maximum value is 32767.
inactive-time
An integer value that specifies the length of time, in minutes, that a server job will stay inactive before ending. If this parameter is omitted, the server inactive time does not change.
The initial configuration default value is 30. The maximum value is 1440.

Example

  • Start the ObjectConnect for Db2 Mirror server and set it to start automatically.
    CALL QSYS2.CHANGE_MIRROR_OBJECTCONNECT(STATE      =>'START',
                                       AUTO_START => 'YES');
End of change