docs: def fcpinfo(rh):
      """
      Get fcp info and filter by the status.
  
      Input:
         Request Handle with the following properties:
            function    - 'GETVM'
            subfunction - 'FCPINFO'
            userid      - userid of the virtual machine
            parms['status']       - The status for filter results.
  
      Output:
         Request Handle updated with the results.
         Return code - 0: ok, non-zero: error
      """
      rh.printSysLog("Enter changeVM.dedicate")
  
      parms = ["-T", rh.userid]
  
      hideList = []
      results = invokeSMCLI(rh,
                            "System_WWPN_Query",
                            parms,
                            hideInLog=hideList)
  
      if results['overallRC'] != 0:
          # SMAPI API failed.
          rh.printLn("ES", results['response'])
          rh.updateResults(results)    # Use results from invokeSMCLI
  
      if results['overallRC'] == 0:
          # extract data from smcli return
          ret = extract_fcp_data(results['response'], rh.parms['status'])
          # write the ret into results['response']
          rh.printLn("N", ret)
      else:
          rh.printLn("ES", results['response'])
          rh.updateResults(results)    # Use results from invokeSMCLI
  
      return rh.results['overallRC']