IT45981: ACEV12 DOCUMENTATION FOR MQSIEXTRACTCOMPONENTS COMMAND MISSING INFORMATION ABOUT PARAMETER INTEGRATION-NODE-DOMAIN-GROUP

APAR status

• Closed as documentation error.

Error description

• ACE V12 documentation for mqsiextractcomponents command which is
  used to migrate an Integration Node doesnt provide any
  explanation about the command parameter-
  integration-node-domain-group.
  
  mqsiextractcomponents --help command output shows the following
  information for the parameter integration-node-domain-group
  which doesnt exists in the ACEV12 documentation.
  --integration-node-domain-group <arg> The Windows Domain Group
  that is used to secure files in the sharedWorkPath of a multi
  instance integration node. Only used in conjunction with
  --shared-workpath.
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All users of App Connect Enterprise V12 using
  mqsiextractcomponents command to migrate multi instance
  integration nodes from V11 to V12 on Windows Platform.
  
  
  Platforms affected:
  Windows on x86 platform, Windows on x86-64 platform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  App Connect Enterprise V12 product documentation for
  mqsiextractcomponents command  does not provide any explanation
  about the command parameter --integration-node-domain-group.
  
  mqsiextractcomponents --help command output lists the following
  parameter integration-node-domain-group in the command usage
  syntax however it is not described in the product documentation.
  
  --integration-node-domain-group <arg> The Windows Domain Group
  that is used to secure files in the sharedWorkPath of a multi
  instance integration node. Only used in conjunction with
  --shared-workpath.
  

Problem conclusion

• The Knowledge Center Topic - mqsiextractcomponents command -
  https://www.ibm.com/docs/en/app-connect/12.0?topic=commands-mqsi
  extractcomponents-command will be updated with the below
  information regarding the parameter
  --integration-node-domain-group.
  
  --integration-node-domain-group windows_domain_group
  
  (Optional  and exclusive to extraction of configuration and
  resources from an integration node only)The Windows Domain Group
  that is used to secure files in the sharedWorkPath of a multi
  instance integration node. Only used in conjunction with
  --shared-workpath. On non-windows platforms this parameter is
  not supported.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels