Automating an Instance of the IWSz Server for AAI

Automating the startup and shutdown of the IWSz Server for AAI is highly recommended. This topic provides recommendations for the startup/shutdown automation and describes the console messages generated by the IWSz Server for AAI.

Console Messages

All console message IDs begin with +AIT followed by the message ID (5 characters, zzzzz in the example below). Then, the text portion of the messages starts with the instance code of the IWSz Server for AAI that issues the message. In this example, the instance code is YYYX.

Example:

+AIT.ZZZZZ:YYYX <message text>

All console messages are issued using the TSO SEND command.

Note:

The IWSz Server for AAI main processing runs under OMVS and uses child processes to perform various z/OS related activities. This includes the TSO SEND function to generate console messages.

Console messages that are generated from the IWSz Server for AAI are not issued from the main task STC name but can be associated with a BPXAS task name operating as a child process. Take this information into account when using automation to capture these console messages.

Automatic Startup

It is recommended to automatically start the IWSz Server for AAI primary STC at IPL time. The STC should remain active at all times to maintain status synchronicity between IWSz and AAI.

Tip:

The IWSz Server for AAI depends on IWSz being active to be able to function. Consider this fact when designing your automation strategy.

Console Messages on Startup

When the IWSz Server for AAI Primary STC starts successfully, the following console message is displayed to confirm it:

+AIT.SCN1I: YYYX IWS Server for AAI now active on DD MMM YYYY at HH:MM:SS

If errors occur during the initialization or configuration settings during start up, the IWSz Server for AAI terminates with the following console message:

+AIT.SCN8S: YYYX IWS Server for AAI has failed on DD MMM YYYY at HH:MM:SS

Automatic Shutdown

It is also recommended to shut down the IWSz Server for AAI automatically. For this purpose, you use the secondary Request STC based on yourHLQ.CUSTLIB member AITRyyyx, where yyyx is the unique code for the instance

However, you can also request the shutdown manually through the ISPF Interface.

Console Messages on Shutdown

When the IWSz Server for AAI Primary STC is shut down, either automatically or manually, the following console message is displayed to confirm it:

+AIT.SCN7I: YYYX IWS Server for AAI terminated on DD MMM YYYY at HH:MM:SS

Server Errors

The IWSz Server for AAI is extremely robust and will not generally fail unless in case of catastrophic errors. However, it traps certain error conditions and attempts to work around them to continue processing while trying to recover data that has not been delivered. The IWSz Server for AAI traps the following errors:

  • Various FTP/SFTP connection failures when trying to deliver data

  • Failure during event data report creation

  • Failure to start the separate child processes

In all cases, it makes various retry attempts. If these attempts do not solve the problem, it will still attempt to continue.

To make you aware that such errors are happening, the IWSz Server for AAI issues console messages that can be captured by your automation processes. You can then set up the appropriate actions to alert on the failures.

+AIT.SCN2E: YYYX IWS Server for AAI Event Data Delivery failed - Continuing

+AIT.SCN3E: YYYX IWS Event Data generation failed RC=nnnn - Continuing

+AIT.SCN4E: YYYX IWS Server for AAI Definition Data Spawn failure - errno=nnnnnn

+AIT.SCN5E: YYYX IWS Server for AAI Current Plan Data Spawn failure - errno=nnnnnn

+AIT.SCN6E: YYYX ADD process ID=nnnnnnnn has failed - Review ADD LOG

+AIT.SCN6E: YYYX CPD process ID=nnnnnnnn has failed - Review CPD LOG

Should a report generation or data delivery failure occur in the Asynchronous Definition Data Delivery (ADD) “child” process, it will issue a console message highlighting the failure. The following console message will be issued from theIWSz Instance:

+AIT.ACN1E: YYYX IWS/z Definition Data Delivery failed RC=nnnn – Terminated

If a report generation or data delivery failure occurs in the Current Plan Data Delivery (CPD) “child” process, it will issue a console message highlighting the failure. The following console message will be issued from the IWSz Server for AAI Instance:

+AIT.CCN1E: YYYX IWS/z Current Plan Data Delivery failed RC=nnnn - Terminated

See also: