DMK_ENV.pm

NAME

DMK_ENV.pm -- Core DMK library to set/get the environment, used by DMK perl scripts

SYNOPSIS

use DMK_ENV;

it exports the following functions and procedures that can directly be called by another perl-script:

  • set_internal_config_var()

  • set_internal_config_alias()

  • modify_path()

  • get_env()

  • get_home_version()

  • get_pdbfiles()

  • get_processes()

  • read_ora_homes()

  • read_ora_sids()

  • read_orabasetab()

  • read_dmk_config()

  • write_ora_sids()

and it exports the following global variables:

  • $iswin

    For Unix=0, for Windows=1

  • $iswin

    Is the script running in an interactive terminal (tty -s)? 1=yes

  • %orahomes

    Information about ORACLE_HOME's from $etc/ora_homes. For a detailed field description, see the header of the configuration file. For the current home, additional information is gathered: rel (release), ver (version), rooh (read-ony OH, roohctl)

      $orahomes{'/u00/app/oracle/product/19.7.0'} => {
     'oracle_base' => '/u00/app/oracle',
     'product' => 'rdbms_ee',
     'invname' => 'OraDB19Home1',
     'rooh' => 0,
     'dbs' => '/u00/app/oracle/product/19.7.0/dbs',
     'existing' => 1,
     'version' => 'AUTO',
     'ver' => '190700',
     'rel' => 1900,
     'name' => 'rdbms1900'
  },

  • %orasids

    Information about ORACLE_SID's from $etc/ora_sids (existing=1) or a new detected ORACLE_SID. For a detailed field description, see the header of the configuration file.

      $orasids{'DB1970'} => {
     'home' => '/u00/app/oracle/product/19.7.0',
     'crstype' => '',
     'admin' => '/u00/app/oracle/admin/DB1970A',
     'existing' => 1,
     'instances' => '',
     'type' => 'I'
  },

  • %dmk_config_var

    Information about variables set by dmk-core.pl ([INTERNAL]) or from configuration files. For details about setting the variables, see $DMK_HOME/bin/dmk-core.pl The hash is structured by section (INTERNAL/GLOBAL/SID/[ORACLE_SID]/[ORACLE_SID.PDB]), followed by the variable name.

    This hash is built by the "Tie::IxHash" module, so the chronoligical order is preserved in a loop.

      $dmk_config_var{'GLOBAL'}{'ORATAB'} => {
     'name' => 'ORATAB',       #field 2 of config line
     'warn' => 1,              # = with nooption
     'value' => '/etc/oratab', # field 5
     'line' => 'var::ORATAB::=::nooption::"/etc/oratab"::
  },

  • %dmk_config_alias

    Information about aliases set by dmk-core.pl ([INTERNAL], usually "SID", "SID.PDB" and "cdd.*" aliases) or from configuration files. The hash is structured by section (INTERNAL/GLOBAL/SID/[ORACLE_SID]/[ORACLE_SID.PDB]), followed by the alias name.

      $dmk_config_alias{'GLOBAL'}{'cda'} => {
     'name' => 'cda',                      #field 2 of config line
     'option' => 'var_noforce',            #field 3
     'value' => 'cd ${DMK_ORA_ADMIN_SID}', #field 4
     'line' => 'alias::cda::var_noforce::\'cd ${DMK_ORA_ADMIN_SID}\'::'
  },

  • @sidlist

    array with all ORACLE_SID's from $etc/ora_sids (1st field)

  • @ora_homes

    array with all lines of $etc/ora_homes

  • $ora_homes_changed

    Set to 1 if a change is detected with ORACLE_HOME's, e.g. a home was deleted (compared to ora_homes)

  • @ora_sids

    array with all lines of $etc/ora_sids

  • $ora_sids_changed

    Set to 1 if a change is detected with ORACLE_SID's, e.g. a SID was deleted or added (compared to ora_sids)

  • $initialsid

    Which SID should be set if dmk.sh is sourced without a SID. DMK automatically chooses a SID, but this can be overridden by the variable DMK_INITIALSID in the [GLOBAL] section

  • $grid_home

    ORACLE_HOME of the used Grid-Infrasture.

  • $host_short

    The hostname without domain.

  • $separator

    Directory separator within a PATH variable. For Unix it is ":"

  • $DMK_ORATAB_STAT,

  • $DMK_ORAGCHOMELIST_STAT

  • $DMK_ORAINVENTORY_STAT

  • $DMK_ORA_HOMES_STAT

  • $DMK_ORA_SIDS_STAT

    All these DMK_[configfile]_STAT variables contain the size in bytes and the timestamp in sec since 1970. It is used to detect changes of the environment. If it is unchanged, the time-consuming process of re-read the whole environment can be omitted.

FUNCTIONS, PROCEDURES

PROCEDURE set_internal_config_var

set variables generated by dmk (not via configfile), It is a wrapper to fill the %dmk_config_var hash

Parameter

  • $VAR: DMK variable name (usually uppercase)

  • $value: value of the variable

  • $option: nooption, nowarn (default)

POD ERRORS

Hey! The above document had some coding errors, which are explained below:

  • Around line 207:

    Unterminated F<...> sequence

PreviousLibrariesNextAppendix

Last updated