Issue with docs.zowe.org/stable/user-guide/api-mediation/wto-message-on-startup/

[dkelosky]

Description

The doc states

"This functionality requires the following changes to the zowe.yaml:

Change the property zowe.sysMessages by adding the value - "ZWEAM001I"

However, in a new install (Zowe 3.0+), this example is already added. Is the request to change this property only for Zowe v <3.0?

Pages to Update

Screenshots

Expected behavior

Additional context

[dkelosky]

Correction, the examples that already exist in example-zowe.yaml have different message prefixes:

  sysMessages:
    #   # Zowe starting
    - "ZWEL0021I"
    #   # Zowe started
    - "ZWEL0018I"
    - "ZWEL0006I"
    #   # Zowe ready to use
    - "ZWES1601I"
    #   # Zowe stopping
    - "ZWEL0008I"
    #   # Zowe stopped
    - "ZWEL0022I"
    #   # Zowe components starting
    - "ZWEL0001I"
    #   # Zowe components stopped
    - "ZWEL0002I"
    #   # API ML components ready
    - "ZWEAM000I"
    #   # App server ready
    - "ZWED0031I"
    #   # ZSS ready
    - "ZWES1013I"

[balhar-jakub]

Or if you are upgrading from Zowe V2. I proposed the text change to reflect that it may be already there now.

[dkelosky]

Thanks for taking a stab at this. FYI: The doc shows message prefixes like "ZWEAM001I" however the pre populated example has "ZWEL0001I"

[balhar-jakub]

ZWEL0001I and ZEWAM001I are different messages. Both are issued by Zowe. I am not sure I understand the follow-up question.

[dkelosky]

Clearly I am confused 😄

ZWEL0001I is provide as a default example in example-zowe.yaml for v3+. ZEWAM001I is the example from the doc and applies to gateway service. The follow up question is: should the defaults that are now in example-zowe.yaml be documented?

Side note: ZWEAM000I is also provided in example-zowe.yaml which applies to catalog service, but I didn't think these messages were applicable to anything besides the gateway: #4143 . Is that correct or am I misinterpreting ?

[balhar-jakub]

There are three different messages that are similar:
ZWEAM000I - Is issued by every API ML service when the service starts. That doesn't mean the API ML itself is operational.
ZWEAL0001I - Is issues when launcher starts all services. That doesn't mean that they are operational.
ZWEAM001I - Is issued by the API Gateway once API ML is operational.