#!/bin/ksh93 # IBM_PROLOG_BEGIN_TAG # This is an automatically generated prolog. # # 61haes_r720 src/43haes/lib/ksh93/hacmp/KLIB_HACMP_get_fallback_timer_attributes.sh 1.5 # # Licensed Materials - Property of IBM # # COPYRIGHT International Business Machines Corp. 2011,2015 # All Rights Reserved # # US Government Users Restricted Rights - Use, duplication or # disclosure restricted by GSA ADP Schedule Contract with IBM Corp. # # IBM_PROLOG_END_TAG # @(#)66 1.5 src/43haes/lib/ksh93/hacmp/KLIB_HACMP_get_fallback_timer_attributes.sh, hacmp.assist, 61haes_r720, 1525A_hacmp720 6/1/15 13:43:59 #============================================================================ # # Name: KLIB_HACMP_get_fallback_timer_attributes # # Description: This is the main, FPATH function that is invoked by clmgr # to collect fallback timer information. The cltimerpolicy # utility is invoked to extract the necessary data. # # Inputs: See the "devDoc()" function at the bottom of this file. # # Outputs: The properties hash is populated. The only other outputs are # any error messages that might be needed. # # Returns: Zero if no errors are detected. Otherwise, an appropriate # non-zero value is returned. Refer to the "RETURN" section # of the "devDoc()" function at the bottom of this file for # the standard return code values/meanings for clmgr. # #============================================================================ function KLIB_HACMP_get_fallback_timer_attributes { LINENO=2 . $HALIBROOT/log_entry "$0()" "$CL" : version=1.5, src/43haes/lib/ksh93/hacmp/KLIB_HACMP_get_fallback_timer_attributes.sh, hacmp.assist, 61haes_r720, 1525A_hacmp720 : INPUTS: $* typeset timer=${1//\"/} # Get the "properties" associative array reference, and initialize it if [[ -z $2 ]] || [[ -n $CLMGR_LOGGING && $2 == "|" ]]; then timer= typeset -n properties=$1 else typeset -n properties=$2 fi [[ $CLMGR_LOGGING == 'med' ]] && set +x # Only trace param values #=================================== : Declare and initialize variables #=================================== for k in ${!properties[*]}; do unset properties[$k]; done typeset name= value= TIMERS= DATA= typeset -A property_table property_translation typeset -i INDEX=0 rc=$RC_SUCCESS typeset key= typeset -i matches=0 typeset -u attr= uc_key= typeset -A queries typeset -i i=0 typeset SUNDAY= MONDAY= TUESDAY= WEDNESDAY= THURSDAY= FRIDAY= SATURDAY= dspmsg -s 36 cluster.cat 16 'Sunday,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday' | IFS=, read SUNDAY MONDAY TUESDAY WEDNESDAY THURSDAY FRIDAY SATURDAY typeset -A days days=( [0]="$SUNDAY" [1]="$MONDAY" [2]="$TUESDAY" [3]="$WEDNESDAY" [4]="$THURSDAY" [5]="$FRIDAY" [6]="$SATURDAY" ) typeset JAN= FEB= MAR= APR= MAY= JUN= JUL= AUG= SEP= OCT= NOV= DEC= dspmsg -s 36 cluster.cat 15 'Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec' | IFS=, read JAN FEB MAR APR MAY JUN JUL AUG SEP OCT NOV DEC typeset -A months months=( [0]="$JAN" [1]="$FEB" [2]="$MAR" [3]="$APR" [4]="$MAY" [5]="$JUN" [6]="$JUL" [7]="$AUG" [8]="$SEP" [9]="$OCT" [10]="$NOV" [11]="$DEC" ) #=================================================== : Check for any specified attribute=value pairs. : If any are found, use those to query the output. #=================================================== while (( $# > 0 )); do value="$1" if [[ $value == *=* ]]; then attr=${value%%=*} # "attr" makes this uppercase queries[$attr]="${value#*=}" fi shift done property_table=( [description]="DESCRIPTION" [name]="NAME" [prop_sync]="SYNC_WITH_CLUSTER" [prop_auto]="SYNC_WHEN_CHANGED" ) property_translation=( [0]="false" [1]="true" ) #================================================================ : Check for a defined cluster. No need to continue without one. #================================================================ CL=$LINENO isClusterDefined if (( $? != RC_SUCCESS )); then rc=$RC_MISSING_DEPENDENCY #======================================= : Make sure we have something to query #======================================= elif [[ -n $timer ]]; then for timer in ${timer//,/ }; do CL=$LINENO KLIB_HACMP_is_known_fallback_timer $timer 2>/dev/null if (( $? != RC_SUCCESS )); then dspmsg -s $CLMGR_SET $CLMGR_MSGS 102 '\nERROR: "%1$s" does not appear to exist!\n\n' "$timer" 1>&2 dspmsg -s $CLMGR_SET $CLMGR_MSGS 143 "Available Fallback Timers:\n\n" 1>&2 typeset available CL=$LINENO KLIB_HACMP_list_fallback_timers available for (( i=0; i<${#available[*]}; i++ )); do if [[ ${available[$i]} != *([[:space:]]) ]]; then print -u2 "\t${available[$i]}" fi done print -u2 "" rc=$RC_NOT_FOUND else TIMERS="$TIMERS $timer" fi done elif (( CLMGR_VERBOSE || ${#queries[*]} > 0 )); then print -- "$0()[$LINENO]($SECONDS): cltimerpolicy -a list -f list" >>$CLMGR_TMPLOG TIMERS=$(cltimerpolicy -a list -f list) print -- "$0()[$LINENO]($SECONDS): cltimerpolicy RC: $? ($TIMERS)" >>$CLMGR_TMPLOG else dspmsg -s $CLMGR_SET $CLMGR_MSGS 100 "\nERROR: a name/label must be provided.\n\n" 1>&2 rc=$RC_MISSING_INPUT fi (( $rc != RC_SUCCESS )) && unset TIMERS #================================================================ : Populate the return hash with the retrieved attributes/values #================================================================ for timer in $TIMERS; do print -- "$0()[$LINENO]($SECONDS): cltimerpolicy -a list -f smit -n $timer" >>$CLMGR_TMPLOG # Always log commands DATA=$(cltimerpolicy -a list -f smit -n $timer) print -- "$0()[$LINENO]($SECONDS): cltimerpolicy RC=$? ($DATA)" >>$CLMGR_TMPLOG # Always log commands print -- "$DATA" |\ while IFS=':' read name recurrence year month day_of_month \ week_day hour minutes do properties[NAME$INDEX]=$name properties[REPEATS$INDEX]=$recurrence [[ $recurrence == "once" ]] && properties[REPEATS$INDEX]="never" properties[HOUR$INDEX]=$hour properties[MINUTE$INDEX]=$minutes #========================================================= : Since the product puts dummy values in the fields that : that are not used at all, but lead to confusing output, : it is necessary to only set the relevant values. #========================================================= case "$recurrence" in once) properties[YEAR$INDEX]=$year properties[MONTH$INDEX]=${months[$month]} (( month++ )) properties[MONTH_NUM$INDEX]=$month properties[DAY_OF_MONTH$INDEX]=$day_of_month ;; yearly) properties[MONTH$INDEX]=${months[$month]} (( month++ )) properties[MONTH_NUM$INDEX]=$month properties[DAY_OF_MONTH$INDEX]=$day_of_month ;; monthly) properties[DAY_OF_MONTH$INDEX]=$day_of_month (( month++ )) properties[MONTH_NUM$INDEX]=$month ;; weekly) properties[DAY_OF_WEEK$INDEX]=${days[$week_day]} properties[DAY_OF_WEEK_NUM$INDEX]=$week_day ;; esac done (( INDEX++ )) [[ $INDEX == *0 ]] && (( INDEX++ )) done #========================================================== : If any searches/filters were specified, handle them now #========================================================== if (( $rc == RC_SUCCESS && ${#queries[*]} > 0 )); then CL=$LINENO search_properties queries properties rc=$? fi (( $rc == RC_SUCCESS )) && CL=$LINENO prune_indexes properties log_return_msg "$rc" "$0()" "$LINENO" return $? } # End of "KLIB_HACMP_get_fallback_timer_attributes()" #============================================================================ # # Name: devDoc # # Description: This is a never-to-be-called, wrapper function that all the # clmgr FPATH functions implement in order to hide embedded # syntax from trace logging. This information is implemented # in POD format, and can be viewed in a number of ways using # POD tools. Some viewing suggestions for this function's POD- # formatted information are: # # perldoc # pod2text -c # pod2text -c --code # pod2html # # However, the more important use for this information is that # it is parsed by clmgr to display the syntax for this file's # operation. The information in the "SYNOPSIS" section is used # for this purpose. This feature was originally implemented # using the man page information. However, in a code review it # was pointed out that this approach had to be changed because # customers do not have to install the man pages! Therefore, a # built-in dependency on man page information would break the # automatic help feature of clmgr. So the SYNPOSIS section must # be used instead. # # IMPORTANT: As a result of this, it is imperative that the # information in this SYNOPSIS be kept in sync # with the man page information, which is owned # by the IDD team. # # Inputs: None. # # Outputs: None. # # Returns: n/a (not intended to be invoked) # #============================================================================ function devDoc { : <<'=cut' >/dev/null 2>&1 =head1 NAME KLIB_HACMP_get_fallback_timer_attributes =head1 VERSION Version Number: 1.5 Last Extracted: 6/16/15 17:51:04 Last Changed: 6/1/15 13:43:59 Path, Component, Release(, Level): src/43haes/lib/ksh93/hacmp/KLIB_HACMP_get_fallback_timer_attributes.sh, hacmp.assist, 61haes_r720, 1525A_hacmp720 =head1 SYNOPSIS clmgr query fallback_timer [,,,...] clmgr -v query fallback_timer NOTE: aliases for "fallback_timer" are "fa" and "timer". =head1 DESCRIPTION Retrieves the configuration data for one or more fallback timers. =head1 ARGUMENTS 1. timer [REQUIRED] [string] The clmgr label/string of one or more fallback timers (comma or space separated) that are to be queried. 2. properties [REQUIRED] [hash ref] An associative array within which data about the queried objects can be returned to the caller. =head1 RETURN 0: no errors were detected; the operation appears to have been successful 1: a general error has occurred 2: a specified resource does not exist, or could not be found 3: some required input was missing 4: some detected input was incorrect in some way 5: a required dependency does not exist 6: a specified search failed to match any data =head1 COPYRIGHT COPYRIGHT International Business Machines Corp. 2011,2015 All Rights Reserved =cut } # End of "devDoc()" #============================================================================== # The following, comment block attempts to enforce coding standards when this # file is edited via emacs or vim. This block _must_ appear at the very end # of the file, or the editor will not find it, and it will be ignored. #============================================================================== # Local Variables: # indent-tabs-mode: nil # tab-width: 4 # End: #============================================================================== # vim: tabstop=4 shiftwidth=4 expandtab #==============================================================================