Messages ING001I to INGY1337I

Note that within NetView an additional * may be appended to the end of the message text.

Note: Because these INGXnnnnt messages are written to the syslog, the message text must be in English.

ING001I aaaa SERVICE FAILED, RC=bb, REASON=cccccccc

Explanation

SA z/OS detected an error.

  • The variable aaaa shows the service or command that failed.
  • The variable bb shows the value of the return code.
  • The variable ccccccccc shows the value of the reason code.

System action

None.

Operator response

If an INGOMX error occurred, see the online command help of INGOMX or see the INGOMX topic in IBM Z System Automation Programmer's Reference for further details about the return code.

If a NetView command error occurred, see the appropriate IBM Z NetView manual.

In all other cases, contact IBM® Support.

System programmer response

For service HSAPRHFR, see the Configure the System Logger topic in IBM Z System Automation Planning and Installation for instructions of how to correctly set up for logging with the system logger. Also, ensure that the LOGSTREAM parameter that is specified in the automation manager's parameter file HSAPRMxx and in the automation agent's DSIPARM member INGXINIT are identical.

For service INGPXMEM, ensure that SA z/OS has been initialized correctly and that the data service task INGPXDST is active. When the common global AOFINIT is set to a value greater than 0, the basic initialization completes successfully. When AOFINIT is not set, no initialization is attempted. In this case, ensure that AOFRANTL is called as an initial command out of your NetView stylesheet (CNMSTYLE). Otherwise, examine the netlog for messages that are issued during initialization and correct the errors.

If task INGPXDST is not active, try to start the task by using:
START TASK=INGPXDST
.

ING002I name IS NOT A SECONDARY AUTOMATION MANAGER

Explanation

The specified command or action is only applicable for a secondary automation manager.

  • The variable name shows the name of the automation manager that is not defined as secondary automation manager.

System action

Processing terminates.

Operator response

Specify the correct automation manager name and reissue the command.

ING003I name IS NOT A PRIMARY AUTOMATION MANAGER

Explanation

The specified command or action is only applicable for the primary automation manager.

  • The variable name shows that name of the automation manager that is not defined as primary automation manager.

System action

Processing terminates.

Operator response

Specify the correct automation manager name and reissue the command.

ING004I REQUEST request SUBMITTED

Explanation

The request to update the operation mode of the designated automation manager has been submitted under this task or another work operator.

  • The variable request shows the submitted request.

System action

Processing continues.

ING005I RESOURCE name IS AMBIGUOUS

Explanation

There is more than one resource with the specified name within the domain of the automation manager in charge. Because the command is running in line mode, SA z/OS is unable to determine which of the resources the command should be applied to.

  • The variable name shows the name of the resource that is not unique.

System action

Processing terminates.

Operator response

Specify the fully qualified resource name and reissue the command.

ING006I THERE IS NO RESOURCE name

Explanation

None of the resources defined in the sysplex matches the specified name pattern.

  • The variable name shows the name of the resource that could not be found.

System action

None.

Operator response

Correct the name of the resource and reissue the command.

System programmer response

None.

ING007I name IS NOT AN APPLICATION GROUP

Explanation

The display "group members" action was requested for a resource that is not an application group.

  • The variable name shows the name of the resource that is not an application group.

System action

None.

Operator response

None.

ING008I name SERVICE FAILED, RC=return_code, REASON=reason.

Explanation

A service routine was called that ended with a non-zero return code.

  • The variable name shows the name of the function that encountered the error. For function INGSTX, see the online command help of INGSTX or see the INGSTX topic in IBM Z System Automation Programmer's Reference for further details.
  • The variable return_code shows the return code that the failing service routine returned.
  • The variable reason shows descriptive text about the cause of the error.

System action

Processing terminates.

Operator response

Notify your system programmer.

System programmer response

Determine why the service routine failed and correct the problem. Examine the netlog for additional information.

For REASON=TIMEOUT, see the Work Item Statistics and Workitem Queue Monitoring topics in Appendix C. Problem Determination of IBM Z System Automation User's Guide.

The information there can help you to understand better the automation manager's workload and performance. TIMEOUT means that the automation agent stops waiting for a command response from the automation manager after the specified wait time. The wait time is controlled by the WAIT parameter that is available for most commands, (INGLIST, INGREQ, WAIT= nnn | NO). The default wait time is 30 seconds but you can adjust it. For details, see the Parameter Defaults for Commands topic in IBM Z System Automation Customizing and Programming.

In addition, the INGRPT command provides information about the automation manager's performance from a statistical point of view, like the total number of timeouts, average wait time, maximum wait time.

ING009I UPDATE OF parameter COMPLETED; SET TO value

Explanation

The requested function has been successfully completed.

  • The variable parameter shows the name of the parameter that was updated.
  • The variable value shows the new value of the parameter.

System action

None.

Operator response

None.

ING010I warning/error information

Explanation

  • The variable warning/error information shows descriptive text from the automation manager about the cause of the error.

System action

None.

Operator response

None.

ING011I CONFLICT DETECTED BETWEEN UP AND DOWN TIMESLOTS

Explanation

There is an overlap between an UP time slot and a DOWN time slot.

System action

None.

Operator response

Correct the time specification.

ING012I name IS NOT AN AUTOMATION MANAGER

Explanation

The specified command or action is only valid for an automation manager.

  • The variable name shows the name of the system where the command could not be processed.

System action

Processing is terminated.

Operator response

Specify the correct automation manager name and reissue the command.

ING013I PARAMETER parameter_name IS NOT APPLICABLE FOR RESOURCES OF TYPE type

Explanation

The specified parameter is not valid for resources of the specified type.

  • The variable parameter_name shows the name of the parameter that is not valid.
  • The variable type shows the type of the resource.

System action

Processing terminates.

Operator response

Correct the format and reissue the command.

ING014I CONFLICTING PARAMETERS SPECIFIED.

Explanation

Self-explanatory.

System action

Processing terminates.

Operator response

Correct the format and reissue the command.

ING015I NO MATCHING REQUEST FOUND FOR resource - SOURCE=source REQUEST=request

Explanation

An INGSET CANCEL was issued but the request identified by its type and source does not exist.

  • The variable resource shows the name of the resource.
  • The variable source shows the name of the source.
  • The variable request shows the name of the request that could not be found.

System action

Processing terminates.

Operator response

Correct the format and reissue the command.

ING016I SCOPE=scope IS NOT VALID FOR type REQUEST

Explanation

The specified scope is not valid for the type of request.

  • The variable scope shows the scope that was specified for the request.
  • The variable type shows the type of the request.

System action

Processing terminates.

Operator response

Correct the format and reissue the command.

ING017I EXPIRATION TIME timestamp HAS PASSED ON system

Explanation

The specified expiration date or time is in the past.

  • The variable timestamp shows the specified timestamp.
  • The variable system shows the name of the system.

System action

Processing terminates.

Operator response

Specify an expiration time or date that is in the future and reissue the command.

ING018I ONLY ONE GROUP ALLOWED FOR ACTION action

Explanation

You specified more than one group name for an INGGROUP action of ADJUST or MEMBERS.

  • The variable action shows the action that could not be performed.

System action

Processing terminates.

Operator response

Specify only one group name and reissue the command.

ING019I REQUESTED ACTION IGNORED FOR RESOURCE resource

Explanation

An INGGROUP ACTION EXCLUDE, AVOID, DEFAULT, or INCLUDE was requested for a group of nature basic.

  • The variable resource shows the name of the resource.

System action

Processing terminates.

Operator response

Correct the command syntax and reissue the command.

ING020I DATASET datasetname NOT FOUND OR NOT ACCESSIBLE

Explanation

Either the specified data set does not exist, or it is not accessible, or, if it is a configuration data set it is not a PDS.

  • The variable datasetname shows the name of the data set that is not available.

System action

None.

Operator response

Correct the name of the data set and reissue the command.

ING021I STATISTICS COUNTERS RESET ON SYSTEM sysname

Explanation

The statistics counts have been reset on the specified system.

  • The variable sysname shows the name of the system whose statistics counts were reset.

System action

Processing continues.

Operator response

None.

Module

INGRVRPX

ING022I THRESHOLD SETTINGS FOR resource CANNOT BE DELETED

Explanation

The threshold settings for DEFAULTS, MVSESA and SUBSYSTEM cannot be deleted.

  • The variable resource shows the name of the resource that the threshold settings cannot be deleted for.

System action

None.

Operator response

None.

Module

INGRYTH0

ING023I command COMMAND NOT ALLOWED TO RUN UNDER task TASK.

Explanation

The specified command cannot run under the specified task.

  • The variable command shows the name of the command that cannot be run.
  • The variable task shows the name of the task that the command cannot be run under.

System action

Processing stops.

Operator response

Reissue the command under another task.

Module

INGRYRPX

ING024I DELETION OF INTERNAL REQUEST IS NOT ALLOWED.

Explanation

The selected request is created by the automation manager due to:

  1. Vote propagation for an application group. This request cannot be canceled. It will be automatically removed when the vote that initiated the request is removed.
  2. A service period UP or DOWN window. This request cannot be canceled. It will be automatically removed when the UP or DOWN window ends.

System action

None.

Operator response

None.

ING025I OUTBOUND CONNECTION WITH DOMAIN domain RUNNING product ESTABLISHED.

Explanation

The local system has established a communication path with the named system.

  • The variable domain identifies the remote system. It is the domain ID of the remote system.
  • The variable product is the SA z/OS release running on the remote system.

System action

None.

Operator response

None.

ING026I ROUTINE clistname SENT TO DOMAIN domain LEVEL clist_level.

Explanation

The local system has sent the current version of the INGRVXMT routine to the remote system. This enables the local system to communicate with the remote system via the "remote procedure call" technique rather than NNT sessions.

  • The variable clistname is the name of the routine.
  • The variable domain identifies the remote system by its domain ID.
  • The variable clist_level shows the last APAR number, if present, and compile date.

System action

None.

Operator response

None.

ING027I ROUTINE clistname RECEIVED FROM DOMAIN domain RUNNING product LEVEL clist_level.

Explanation

Another system, identified by its domain ID, has sent a routine to communicate with the local system via the "remote procedure call" technique rather than NNT sessions.

  • The variable clistname is the name of the routine.
  • The variable domain is the domain ID of the remote system.
  • The variable product is the SA z/OS release level running on the remote system.
  • The variable clist_level shows the last APAR number and compile data of the routine.

System action

None.

Operator response

None.

ING028I command: PARAMETER parameter MISSING OR INVALID value

Explanation

The specified parameter is either wrong or missing.

  • The variable command is the name of the command being processed.
  • The variable parameter is the parameter that is invalid or missing.
  • The variable value is the value of the parameter that is wrong.

System action

None.

Operator response

None.

ING029I ROUTINE clistname IS COMPILED. CANNOT BE SENT TO DOMAIN domain

Explanation

Because the clist that is named in the message is compiled, it cannot be sent to the remote system. This is done for two reasons:

  1. The REXX runtime library might not be installed on the remote system.
  2. The compiled REXX routine does not contain any indication of its software level (release number, last APAR).
  • The variable clistname is the name of the routine.
  • The variable domain identifies the remote system by its domain ID.

System action

None.

Operator response

None.

ING030I Group group_name cannot be moved to another system - reason

Explanation

An attempt was made to move the group away from the system that it currently runs on, but no other system is available.

  • The variable group_name is the move group concerned.
  • The variable reason explains in more detail why the group cannot be moved.

System action

None.

Operator response

None.

System programmer response

None.

ING031I EVENT SUBSCRIPTION CONSUMER name IS UNKNOWN.

Explanation

The consumer specified in the INGEVOBS call is not defined, which means that the consumer is not registered.

  • The variable name is the name of the consumer as specified in the INGEVOBS command.

System action

The command is rejected.

Operator response

Reenter the correct command, if applicable or register the consumer first.

Classes

None.

ING032I AVAILABILITY TARGET avtgt CANNOT BE LESS THAN THE SATISFACTORY TARGET sattgt

Explanation

You have specified either a satisfactory target value that is larger than the availability target, or an availability target that is less than the satisfactory target assigned to the server group.

  • The variable avtgt is the availability target assigned to the group.
  • The variable sattgt is the satisfactory target assigned to the group.

System action

The command is rejected.

Operator response

Reenter the correct command.

Classes

None.

ING033I INBOUND SESSION STATUS CORRECTED FOR domain. SET status

Explanation

The gateway monitoring routine found an inbound session status that does not match the actual status. The session status is corrected.

  • The variable domain is the name of the domain that the local system has an inbound session with.
  • The variable status is the new inbound session status.

System action

Processing continues.

Operator response

None.

Classes

None.

ING034I STATUS stat OF SUBSYSTEM subsys IS NOT VALID FOR FUNCTION function

Explanation

AOFRYSAB was called to perform a function for a subsystem. The status of the subsystem does not allow this function.

  • The variable stat is the current status of the subsystem.
  • The variable subsys is the subsystem that the function is to be performed on.
  • The variable func is the function that is to be performed

System action

The function is not performed.

Operator response

None.

Classes

None.

ING035I system_name IS NOT A VALID SYSTEM FOR GROUP group_name

Explanation

The specified system name is either unknown or not a valid choice for the group.

  • The variable system_name is the invalid system name.
  • The variable group_name is the move group concerned.

System action

None.

Operator response

Specify a valid system that the group can be moved to.

Module

INGRYMV0

Classes

None.

ING036I GROUP group_name CANNOT BE MOVED TO SYSTEM system_name - reason

Explanation

You attempted to move the group to the specified system either now or at the next recycle, but one of the following conditions is true:

  • The system is down or System Automation is not fully initialized.
  • The member on that system is not startable.
  • The group is already running on that system.

System action

None.

Operator response

Specify another system that the group should be moved to.

Module

INGRYMV0

Classes

None.

ING037I GROUP group_name CANNOT BE BOXED - NOT ACTIVE

Explanation

You attempted to box the group but the application group is not active.

System action

None.

Operator response

None.

Module

INGRYMV0

Classes

None.

ING038I CONFLICTING PARAMETERS OR VALUES SPECIFIED => p1 - p2

Explanation

The specified parameters (or their values) conflict.

  • The variable p1 is the first invalid parameter.
  • The variable p2 is the second invalid parameter.

System action

None.

Operator response

Reenter the command with valid parameters.

Module

INGRYST0

Classes

None.

ING039I SESSION name IS UNKNOWN

Explanation

The specified session is not defined in the configuration file (ACF).

  • The variable name is the session name.

System action

None.

Operator response

Reenter the command with a valid session name.

Module

INGRVSS0

Classes

None.

ING040I THE FOLLOWING IS MISSING: keywords

Explanation

A command was entered but one or more required parameters were not specified.

  • The variable keywords shows a list of all the missing parameters.

System action

The command is rejected.

Operator response

Enter the command again and specify the required parameters.

Classes

None.

ING041I ONE OF THE FOLLOWING IS MISSING: keywords

Explanation

A command was entered but a required parameter was not specified.

  • The variable keywords shows a list of possible parameters to be specified.

System action

The command is rejected.

Operator response

Enter the command again and specify one of the suggested parameters.

Classes

None.

ING042I keyword1 MUST BE SPECIFIED WITH keyword2

Explanation

A command was entered but one of its parameters requires another one to be also specified.

  • The variable keyword1 shows the parameter that requires keyword2 to be specified.
  • The variable keyword2 shows the additional parameter that is required.

System action

The command is rejected.

Operator response

Enter the command again and specify the missing parameter.

Classes

None.

ING043I keyword1 MUST NOT BE SPECIFIED WITH keyword2

Explanation

A command was entered but one of its parameters disallows another one to be also specified.

  • The variable keyword1 shows the parameter that excludes the use of keyword2.
  • The variable keyword2 shows the parameter that is excluded by the use of keyword1.

System action

The command is rejected.

Operator response

Enter the command again and specify either keyword1 or keyword2.

Classes

None.

ING044I keyword1 MUST BE GREATER THAN OR EQUAL TO keyword2

Explanation

A command was entered with two parameters. The two values define a range. The second value must be greater than or equal to the first value.

  • The variable keyword1 shows the parameter that defines the end of the range.
  • The variable keyword2 shows the parameter that defines the start of the range.

System action

The command is rejected.

Operator response

Enter the command again and specify a value for keyword1 that is greater than or equal to the value given for keyword2.

Classes

None.

ING045I keyword MUST BE IN THE FORMAT format

Explanation

A command was entered with a parameter that requires a certain data format.

  • The variable keyword shows the parameter that requires the format.
  • The variable format shows the format that is required as one of the following, or any other self-explanatory text:
    MM/DD/YYYY
    A valid date in the form month/day/year
    HH:MM
    A valid time in the form hour:minute
    Cn
    1–n characters
    Dn
    1–n numeric digits
    Note that there might be additional lines that explain the problem in further detail.

System action

The command is rejected.

Operator response

Enter the command again and specify a value that conforms to the required format.

Classes

None.

ING046I keyword MUST BE ONE OF THE FOLLOWING: list

Explanation

A command was entered with a parameter that requires a certain value.

  • The variable keyword shows the parameter that requires the value.
  • The variable list shows a list of valid values that the parameter can take.

System action

The command is rejected.

Operator response

Enter the command again and specify a value from the list.

Classes

None.

ING047I keyword MUST BE IN THE RANGE FROM from TO to

Explanation

A command was entered with a parameter that must be in a certain range.

  • The variable keyword shows the name of the parameter that must be in the range.
  • The variable from shows the lowest possible value.
  • The variable to shows the highest possible value.

System action

The command is rejected.

Operator response

Enter the command again and specify a value in the given range.

Classes

None.

ING048I subsystem NOT DEFINED AS type SUBSYSTEM

Explanation

The specified subsystem is not of the required type.

  • The variable subsystem identifies the subsystem.
  • The variable type defines the type (CICS®, IMS, etc.).

System action

None.

Operator response

Specify a valid subsystem of the required type.

Classes

None.

ING049I No xxxx data to display for subsystem

Explanation

There are no commands specified in the policy for the specified subsystem.

  • The variable xxxx identifies the keyword that no commands have been defined for. It can be DISPINFO, IMSINFO, or CICSINFO.
  • The variable subsystem identifies the subsystem.

System action

None.

Operator response

None.

Classes

None.

ING050I HBEAT BEAT parameter

Explanation

A heartbeat was issued.

  • The variable parameter shows the parameters that were specified with the heartbeat.

System action

Processing continues.

Operator response

None.

System programmer response

None.

ING051I HBEAT RECV parameter

Explanation

A heartbeat was received.

  • The variable parameter shows the parameters that were specified.

System action

Processing continues.

Operator response

None.

System programmer response

None.

ING052I HBEAT FAIL parameter

Explanation

A heartbeat with the specified parameters failed.

  • The variable parameter shows the parameters of the failed heartbeat.

System action

Processing continues.

Operator response

None.

System programmer response

None.

ING053I HBEAT SDWN parameter

Explanation

A heartbeat with the specified parameters is shut down.

  • The variable parameter shows the parameters of the shutdown heartbeat.

System action

Processing continues.

Operator response

None.

System programmer response

None.

ING054I MAJOR RESOURCE object name CANNOT BE FOUND

Explanation

An invalid major resource was specified for the creation of a minor resource.

  • The variable object name shows the name of the resource that could not be found.

System action

Processing continues unless no replacement anchor can be found.

Operator response

Inform your system programmer.

System programmer response

If the originator is a customized INGPOST call, correct the call. If not, contact your IBM Support Center.

ING055I INVALID 'STATE=state' CONVERTED TO 'STATE=ALERT'

Explanation

An invalid state was specified in the INGPOST call. The state is converted to 'ALERT'.

  • The variable state shows the incorrect state that was converted to 'ALERT'.

System action

Processing continues.

Operator response

Inform your system programmer.

System programmer response

If the originator is a customized INGPOST call, correct the call. If not, contact your IBM Support Center.

ING057I command FAILED, GENALERT TEXT PARAMETER LONGER THAN 244 CHARS

Explanation

The resulting GENALERT parameter string exceeds the maximum length for GENALERTs.

  • The variable command shows the command that could not be executed.

System action

The command is canceled.

Operator response

Inform your system programmer.

System programmer response

Contact your IBM Support Center.

ING058I module function UNEXPECTED RESPONSE FROM service function : return code

Explanation

The service called for the specified function returned an unexpected return code.

  • The variable module shows the name of the module where the error occurred.
  • The variable function shows the name of function that called the service.
  • The variable service shows the service that was called.
  • The variable function shows the function of the service that was called.
  • The variable return code shows the value of the return code that was issued.

System action

The command is canceled.

Operator response

Inform your system programmer.

System programmer response

Contact your IBM Support Center.

ING059I USERSTATUS FOR OBJECT object UPDATED TO status value (status name)

Explanation

The status of the object has been set to the referred value.

  • The variable object shows the object whose status was updated.
  • The variable status value shows the status value of the object.
  • The variable status name shows the status name of the object.

System action

Processing continues.

Operator response

None.

System programmer response

None.

ING060I USERDATA FOR OBJECT object UPDATED: value

Explanation

The user data of the object has been updated to the specified value.

  • The variable object shows the object whose status was updated.
  • The variable value shows the new status of the object.

System action

Processing continues.

Operator response

None.

System programmer response

None.

ING061I INGPOST command NOT ALLOWED FOR OBJECT object

Explanation

The specified INPOST command is not allowed for the object.

  • The variable command shows the name of the INGPOST command that is not allowed for the object.
  • The variable object shows the name of the resource that the command is not valid for.

System action

The command is canceled.

Operator response

Inform your system programmer.

System programmer response

If the originator is a customized INGPOST call, correct the call. If not, contact your IBM Support Center.

ING062I command mode PROCESSING STARTED

Explanation

The command with the specified mode has started.

  • The variable command shows the name of the command that processing started for.
  • The variable mode shows the mode of the command.

System action

Processing continues.

Operator response

None.

System programmer response

None.

ING063I command mode PROCESSING COMPLETED RC return code

Explanation

The command with the specified mode completed.

  • The variable command shows the name of the command that processing completed for.
  • The variable mode shows the mode of the command.
  • The variable return code shows the value of the return code that was issued. A non-zero return code indicates that the command was in error.

System action

Processing continues.

Operator response

In case of a non-zero return code inform your system programmer.

System programmer response

In case of a non-zero return code investigate for proceeding.

ING064I ISSUING: command

Explanation

The command is issued by the command router.

  • The variable command shows the name of the command that is being issued.

System action

Processing continues.

Operator response

None.

System programmer response

None.

ING066I COMMAND NOT ISSUED: reason

Explanation

The command could not be executed.

  • The variable reason shows the reason why the command could not be executed.

System action

The command is canceled.

Operator response

Make sure the specified command was valid within the context. If it was valid, inform your system programmer.

System programmer response

Investigate the cause of the failure and take the appropriate steps.

ING068I CHANGES WILL BE LOST - PRESS function_key TO ACTIVATE

Explanation

At least one group policy attribute has been modified but not yet committed.

  • The variable function_key is the function key that activates the group policy change.

System action

None.

Operator response

Press the appropriate function key to commit the changes.

System programmer response

None.

ING069E ERROR LOADING topo file - reason

Explanation

The interpretation of the topo file could not be processed successfully.

  • The variable topo file shows the name of the topo file that could not be loaded.
  • The variable reason shows the reason why the topo file could not be loaded.

System action

Processing stops.

Operator response

Inform your system programmer.

System programmer response

Check the topo file for the specified failure.

ING070E UNEXPECTED RESPONSE FROM system RC return code

Explanation

The processing of a remote command on the specified system returned an unexpected return code.

  • The variable system shows the name of the system the returned the return code.
  • The variable return code shows the value of the return code.

System action

Processing continues, unless it was the last target system in the sysplex to make contact with.

Operator response

Check the final message ING063I and act according to its state.

System programmer response

None.

ING072E INITIAL COMMUNICATION WITH system FAILED

Explanation

The attempt to communicate with the specified system was unsuccessful.

  • The variable system shows the name of the system.

System action

Processing continues.

Operator response

Inform your system programmer.

System programmer response

Investigate the cause of the failure and take the appropriate steps.

ING074I RESOURCE resource HAS THE STATUS BOXED

Explanation

The desired action cannot be performed. The indicated resource has the status BOXED which cannot be overruled.

The variable resource shows the name of the resource.

System action

The action is rejected.

Operator response

None.

System programmer response

None.

ING075I RESOURCE resource IS NOT SELECTABLE. RSN=reason

Explanation

The desired action cannot be performed. The resource is not available ("Non-Startable") for the indicated reason.
  • The variable resource shows the name of the resource.
  • The variable reason shows the reason for the unavailability.

System action

The action is rejected.

Operator response

None.

System programmer response

None.

ING076I ACTION action IS NOT SUPPORTED BY THE RESOURCE

Explanation

The indicated action is not supported by the group model of the resource.

The variable action shows the value of the parameter ACTION.

System action

The command is rejected.

Operator response

Retry the command using an ACTION parameter that is accepted by the resource.

System programmer response

None.

ING077I module VERSION version IS NOT SUPPORTED BY worker

Explanation

The indicated module tries to execute the command on a target system that runs an SA agent with higher version, release, or modification level. The data that should be returned cannot be processed by the local system.
  • The variable module shows the name of the local system's module.
  • The variable version shows the version of the local system's module in the format VvRrMm.
  • The variable worker shows the name of the target system's module.

Note: This message is logged on the target system.

System action

The command is rejected.

Operator response

Retry the command using a resource that is accepted by both systems.

System programmer response

None.

ING078I NO MEMBERS ARE DEFINED FOR THE GROUP

Explanation

The command did not find any member defined for the group. Note that some other information is not available as well due to the empty group.

System action

The command continues.

Operator response

None.

System programmer response

None.

ING080I Monitor_name Session_name Logon_type Exception_text

Explanation

ING080I is issued on behalf of a monitor resource that uses the monitor command INGMTRAP to define a trap for one or more OMEGAMON® exceptions. It is issued for each exception that trips.

  • Monitor_name is the fully qualified monitor resource name in the format monitor_name/MTR/system_name, which indicates the monitor resource that this exception message was issued for. Note that monitor_name is known to INGMTRAP through the task global &SUBSAPPL.
  • Session_name is the name of the OMEGAMON session as it was specified by the NAME keyword on the INGMTRAP command.
  • Logon_type is the type attribute used by the OMEGAMON session named Session_name as defined in the automation policy.
  • Exception_text is the exception text as returned by OMEGAMON without the leading ‘+’ sign.

ING081I Monitor_name Session_name Logon_type NO EXCEPTION FOUND

Explanation

Message ING081I is never issued to an operator console, but is written to a monitor resource’s history. This happens when the monitor resource uses the monitor command INGMTRAP to define a trap for one or more OMEGAMON exceptions and no exception has tripped.

  • Monitor_name is the fully qualified monitor name in the format monitor_name/MTR/system_name, which indicates the monitor resource that this exception message was issued for. Note that monitor_name is known to INGMTRAP through the task global &SUBSAPPL.
  • Session_name is the name of the OMEGAMON session as it was specified by the NAME keyword on the INGMTRAP command.
  • Logon_type is the type attribute used by the OMEGAMON session named Session_name as defined in the automation policy.

ING082I NO SESSION OPERATORS HAVE BEEN DEFINED – OMEGAMON SESSION INITIALIZATION TERMINATED.

Explanation

The installation failed to define session operator entries in the automation policy.

System action

Automation initialization continues.

Operator response

Notify your system programmer.

System programmer response

Make sure you have defined at least one session operator AOFSESnn in the automation policy and assigned it to an automation operator, for example, AUTSESnn.

ING083I COMMAND command ISSUED BY operator IN SESSION session_name.

Explanation

Message ING083 is issued each time a list of one or more commands is sent to the OMEGAMON session that is denoted by session_name.

  • command is the first command in the list of commands that was issued with the INGOMX API.
  • operator is the operator or automation operator that issued the command.
  • session_name is the name of the OMEGAMON session that is to receive the command.

System action

None.

Operator response

None.

System programmer response

None.

ING084I REQUEST FOR OMEGAMON SESSION session_name FAILED. REASON CODE rsn

Explanation

SA z/OS failed to communicate with the OMEGAMON session denoted by session_name. The variable rsn contains more specific error information.

System action

The request is not executed.

Operator response

None.

System programmer response

The reason code, rsn, provides details about the cause of the failure. It is in hexadecimal encoding and it can be any of the following:
00000001 (Authentication unsuccessful)
The userid defined for this session is not permitted to log on to OMEGAMON. Possible reasons are:
  • The user ID is invalid.
  • The password is invalid.
  • SAFPW was specified as the password, but no password data set was specified in the NetView startup procedure.
  • SAFPW was specified as the password, but the password found in the password data set is either invalid, does not exist, or was fetched using an invalid owner. See IBM Z System Automation Planning and Installation for information about how to set up your security environment to use this function.
00000002 (Not an OMEGAMON session)
The session that was established between SA z/OS and the VTAM® APPLID defined for this session is not an OMEGAMON session. Validate and, if necessary, correct your session definitions in the customization dialog.
00000003 (VTAM not available)
VTAM was not active at the time the INGOMX API was invoked.
00000004 (Timeout occurred)
The request was interrupted due to a timeout that has been specified for this session. Either the timeout is too aggressive or too few session operators are defined to handle all assigned sessions.
00000005 (Password update failed)
The password of the user defined for this session is controlled by the system using SA z/OS password protection feature. Command INGPW failed to update the password in the SA z/OS password data set after OMEGAMON authentication with the new password.

Reset the session user's OMEGAMON password and re-initialize the system-controlled password in the SA z/OS password data set using INGPW.

00000006 (TAF fullscreen session not established)
NetView could not create a Terminal Access Facility (TAF) fullscreen session using the BGNSESS command. Refer to the netlog for additional messages issued by NetView.
0001nnnn (ATTACH of VOST failed with RC=nnnn)
SA z/OS failed to attach a virtual terminal. Refer to the NetView ATTACH command description for details of the return code represented by nnnn in bytes 2 and 3 of the reason code.
0002nnnn (DETACH of VOST failed with RC=nnnn)
SA z/OS failed to detach a virtual terminal. Refer to the NetView DETACH command description for details of the return code represented by nnnn in bytes 2 and 3 of the reason code.
0003nnnn (Internal error detected)
An internal error nnnn occurred within SA z/OS. Report this problem to your IBM Support Center.

ING085I OMEGAMON SESSION session_name {STARTED | STOPPED}. NEW STATE IS status.

Explanation

Message ING085I is issued each time SA z/OS established or destroyed an OMEGAMON session, denoted by session_name.

The action can be either of the following:

  • STARTED

    The session was started.

  • STOPPED

    The session was stopped.

The current status is indicated in variable status.

System action

None.

Operator response

None.

System programmer response

None.

ING087I task_name: PPI RECEIVER receiver_name READY

Explanation

The task task_name has initialized completely and the PPI receiver named receiver_name is ready for processing requests.

System action

Processing continues

Operator response

None

System programmer response

None

ING088I task_name: PPI RECEIVER receiver_name TERMINATED

Explanation

The task task_name has deleted the PPI receiver named receiver_name. No more requests can be processed.

System action

Processing terminates

Operator response

None

System programmer response

None

ING089I task_name: INVALID BUFFER RECEIVED, DATA DROPPED. RELATED INFO: request_data

Explanation

The PPI receiver owned by the task task_name received an invalid request buffer. The first 64 bytes are dumped with the message in the variable request_data.

System action

Processing continues

Operator response

None

System programmer response

Ensure that only the SA z/OS monitoring agent is sending requests to the PPI receiver that is owned by the task task_name.

ING090I TASK task_name IS NOW ACTIVE

Explanation

The task task_name has been activated.

System action

Processing continues.

Operator response

None.

System programmer response

None.

ING091I task_name ALREADY ACTIVE OR IN PROCESS OF BECOMING ACTIVE

Explanation

You started the task task_name but the task is already active or in the process of becoming active.

System action

Processing terminates.

Operator response

None.

System programmer response

None.

ING092I task_name: service_name SERVICE FAILED, RC=rc. ERROR INFORMATION: error_info

Explanation

During the execution of the service service_name, an error occurred. The variable error_info indicates in what context the service was invoked by the task task_name.

For detailed error information, see NetView: Customization - Using Assembler. In the case of NetView Program-to-Program Interface (PPI) errors see NetView: Application Programming Guide for more information related to the service return code rc.

System action

Processing terminates.

Operator response

None.

System programmer response

Determine why the service routine failed and correct the problem. Examine the netlog for additional information. If necessary, contact your local IBM Support Center for further assistance.

ING093I task_name: INVALID KEYWORD OR SYNTAX ERROR. RELATED INFORMATION: error_info

Explanation

An invalid keyword or value was specified in the initialization member for the task task_name. Related error information is provided in the variable error_info.

System action

Processing terminates.

Operator response

None.

System programmer response

See Step 2. Configure SA z/OS and NetView in the chapter Beginning the installation and configuration in Service Management Unite Installation and Configuration Guide for a list of valid keywords and values and correct the problem.

ING094I TASK task_name HAS TERMINATED

Explanation

The task task_name has terminated.

System action

Processing terminates.

Operator response

None.

System programmer response

None.

ING095I task_name: NO ACTIVE OPERATOR FOUND

Explanation

The PPI receiver owned by task task_name received a request for monitoring data but could not find an active automation operator to process the request.

System action

The message is sent back to the requestor and processing continues.

Operator response

None

System programmer response

Refer to IBM Z System Automation Monitoring Agent Configuration and User's Guide for instructions how to set up automation operators for this function and correct the problem.

ING096I function : text

Explanation

During processing the function request for monitoring data any of the following errors as indicated by text occurred. Examples for text are:

  • NetView RC rc from: command
  • Timeout occurred
  • ING008I …

System action

The message is sent back to the requestor and processing continues.

Operator response

None

System programmer response

If text contains an existing SA z/OS message ID, refer to the message help for problem resolution.

In case of a timeout, increase the time allotted for the longest request.

For return codes returned by SA z/OS or NetView services refer to related documentation or contact your local IBM Support Center for further assistance.

ING101I subsystem CONNECTION TO extsysid (connection_id) IS DOWN.

Explanation

When monitoring a connection between a subsystem and a DB2® or IBM MQ external subsystem, the connection was determined to be in the status not connected.

  • The variable subsystem shows the subsystem name as defined in SA z/OS.
  • The variable extsysid shows the external subsystem ID of DB2 or IBM MQ.
  • The variable connection_id identifies the affected connection.

System action

None.

Operator response

Check whether the subsystem is not connected to the external subsystem as a result of normal operation. If it is not, investigate why the connection is not up.

System programmer response

None.

ING102I subsystem CONNECTION TO extsysid (connection_id) IS UP.

Explanation

When monitoring a connection between a subsystem and a DB2 or IBM MQ external subsystem, the connection was determined to be in the status connected.

  • The variable subsystem shows the subsystem name as defined in SA z/OS.
  • The variable extsysid shows the external subsystem ID of DB2 or IBM MQ.
  • The variable connection_id identifies the affected connection.

System action

None.

Operator response

None.

System programmer response

None.

ING103I THREADS COULD NOT BE TERMINATED FROM subsystem

Explanation

This message introduces a list of ING104I messages that show threads that remain with a DB2 main after a thread termination process has completed.

  • The variable subsystem shows the name of the DB2 main that threads could not be terminated for.

System action

The requested function could not be performed.

Operator response

Investigate why the threads that are listed in the following ING104I messages could not be terminated and retry the termination command.

System programmer response

None.

Classes

40, 44.

ING104I connection_ID THREAD correlation_ID ddf_ID

Explanation

This message shows a thread that remains with a DB2 main after a thread termination process has completed. It is part of a multiline message that begins with message ING103I.

  • The variable connection_ID shows the connection ID of a thread that could not be terminated.
  • The variable correlation_ID shows the correlation ID of a thread that could not be terminated.
  • The variable ddf_ID shows the token associated to a distributed database access thread that could not be terminated.

System action

The requested function could not be performed.

Operator response

Investigate why the indicated thread could not be terminated and retry the termination command.

System programmer response

None.

Classes

None.

ING106I INDOUBT THREADS EXIST FOR name

Explanation

There are indoubt threads existing with the DB2 subsystem named in the message. The message is given when invoking the INGDB2 command checking for indoubt threads.

  • Variable name identifies the DB2 subsystem.

System action

Processing continues.

Operator response

None.

ING108I NO THREADS LEFT IN subsystem.

Explanation

There are no threads left with this DB2 subsystem for the thread termination process to cancel.

  • The variable subsystem identifies the DB2 subsystem.

System action

None.

Operator response

None.

System programmer response

None.

Classes

40, 44.

ING109E thread_number THREADS COULD NOT BE TERMINATED FROM subsystem.

Explanation

Threads remain with this DB2 subsystem after the thread termination process has completed.

  • The variable thread_number shows the number and type of threads.
  • The variable subsystem identifies the DB2 subsystem.

System action

None.

Operator response

Contact your system programmer.

System programmer response

Investigate why the number of indicated threads are not terminated and retry the termination command.

Classes

40, 44.

ING112I YOUR TSO DB2 (subsystem) THREAD IS ABOUT TO BE TERMINATED BY AUTOMATION.

Explanation

This message is broadcast to effected TSO users due to a DB2 thread termination request.

  • The variable subsystem identifies the DB2 subsystem.

System action

None.

Operator response

None.

System programmer response

Classes

40, 43.

ING113I YOUR TSO DB2 (subsystem) THREAD HAS BEEN TERMINATED BY AUTOMATION.

Explanation

This message is broadcast to effected TSO users as a result of a DB2 thread termination request.

  • The variable subsystem identifies the DB2 subsystem.

System action

Cancels the TSO users of the indicated DB2 subsystem.

Operator response

None.

System programmer response

None.

Classes

40, 43.

ING114E jobname CANCELLED BY AUTOMATION DUE TO subsystem THREAD TERMINATION.

Explanation

This message is issued for batch job cancellations due to a DB2 thread termination or DB2 shutdown process.

  • The variable jobname identifies the DB2 batch job.
  • The variable subsystem identifies the DB2 subsystem.

System action

Cancels the batch job for the indicated DB2 subsystem.

Operator response

None.

System programmer response

None.

Classes

40, 44.

ING127A THREADS FOUND AFTER LAST CYCLE OF DB2 (subsystem), FORCE SHUTDOWN.

Explanation

After the final cycle (as defined by the DBITTH timeout variable), threads were still found to exist for this DB2 subsystem.

  • The variable subsystem identifies the DB2 subsystem.

System action

None.

Operator response

Contact your system programmer.

System programmer response

Investigate why this process has not been able to terminate existing threads. If this DB2 needs to be shut down use the FORCE option.

Classes

40, 44.

ING129E jobname CANCELLED. TABLESPACE dbname.tsname (subsystem) NEEDED TO BE STOPPED

Explanation

The job was canceled due to a tablespace that needed to be stopped.

  • The variable jobname shows the job name for the job canceled.
  • The variable dbname.tsname identifies the tablespace.
  • The variable subsystem identifies the DB2 subsystem.

System action

The identified tablespace is stopped and the job is canceled.

Operator response

None.

System programmer response

None.

Classes

40, 44.

ING130I TABLESPACE dbname.tsname (subsystem) IS TO BE STOPPED. PLEASE STOP USING IT.

Explanation

The tablespace indicated is being stopped.

  • The variable dbname.tsname identifies the tablespace.
  • The variable subsystem identifies the DB2 subsystem.

System action

The identified tablespace will be stopped.

Operator response

None.

System programmer response

None.

Classes

40, 43.

ING131I YOU WERE CANCELLED, TABLESPACE dbname.tsname (subsystem) IS TO BE STOPPED.

Explanation

The indicated tablespace is being stopped and operator sessions using it are canceled.

  • The variable dbname.tsname identifies the tablespace.
  • The variable subsystem identifies the DB2 subsystem.

System action

The operator session is canceled.

Operator response

None.

System programmer response

None.

Classes

40, 43.

ING132I thread_number CANCELLED DUE TO STOP OF TABLESPACE dbname.tsname (subsystem).

Explanation

The tablespace indicated is being stopped and all threads are canceled.

  • The variable thread_number shows the number and type of threads canceled.
  • The variable dbname.tsname identifies the tablespace.
  • The variable subsystem identifies the DB2 subsystem.

System action

The indicated threads are canceled.

Operator response

None.

System programmer response

None.

Classes

40, 43.

ING133I YOUR USER ID WAS CANCELED IN ORDER TO ENABLE DSN TERMINATION FOR subsystem

Explanation

All threads are being stopped by operator request. TSO users with a DSN session are canceled in order to enforce the termination of their DSN session.

  • The variable subsystem identifies the name of the DB2 subsystem.

System action

The operator session is canceled.

Operator response

None.

System programmer response

None.

Classes

40, 43.

ING140I ALERT 'alert' FOR 'resource' ON 'system' AT timestamp

Explanation

This message is produced by SA z/OS and sent to targets such as System Automation for Integrated Operations Management (SA IOM), Netcool®/OMNIbus, or the Tivoli Enterprise Console (TEC) for event notification.

  • The variable alert shows the alert identifier that was specified when INGALERT was invoked, or the default that was used.
  • The variable resource shows the resource name that was specified when INGALERT was invoked, or the default that was used.
  • The variable system shows the system name that INGALERT was invoked on.
  • The variable timestamp shows the time when the event was originally produced. It is in the format hh:mm:ss mm/dd/yyyy.

System action

The event is passed to the intended event notification target.

Operator response

None.

System programmer response

None.

Classes

None.

ING141I SENDING OF ALERT 'alertid' FOR 'resource' WAS SUCCESSFUL

Explanation

An event was successfully sent to targets such as System Automation for Integrated Operations Management (SA IOM), Netcool/OMNIbus, or the Tivoli Enterprise Console (TEC) for event notification. In the case of SA IOM, it has acknowledged receipt of the alert.

  • The variable alertid shows the alert identifier that was specified when INGALERT was invoked or the default that was used.
  • The variable resource shows the resource name that was specified when INGALERT was invoked or the default that was used.

System action

The event was successfully sent to the intended event notification targets

Operator response

None.

System programmer response

None.

Classes

None.

ING142I SENDING OF ALERT 'alertid' FOR 'resource' IGNORED

Explanation

An event was not sent to targets such as System Automation for Integrated Operations Management (SA IOM), Netcool/OMNIbus, or the Tivoli Enterprise Console (TEC) for event notification because the configuration does not allow this. Events are ignored in the following cases:

  1. Event notification is not enabled on this agent for any of the intended event notification targets.
  2. The Inform List of the resource does not contain the intended event notification target.
  3. Code match checking with the message ID INGALERT of the subject resource returned either no data or the value IGNORE.
  • The variable alertid shows the alert identifier that was specified when INGALERT was invoked or the default that was used.
  • The variable resource shows the resource name that was specified when INGALERT was invoked or the default that was used.

System action

The event was not sent to the intended event notification targets.

Operator response

None.

System programmer response

If the event should not be ignored, determine the cause of the problem by using the INGCNTL command to check the alert mode on this agent and checking the Inform List and the code definitions for the subject resource in the automation policy.

Classes

None.

ING143I SENDING OF ALERT 'alertid' FOR 'resource' FAILED

Explanation

An event was not sent to targets such as System Automation for Integrated Operations Management (SA IOM), Netcool/OMNIbus, or the Tivoli Enterprise Console (TEC) for event notification because of an error. The error is detected by the command worker. Messages that are generated by the worker (or workers) are appended to the above message text.

  • The variable alertid shows the alert identifier that was specified when INGALERT was invoked or the default that was used.
  • The variable resource shows the resource name that was specified when INGALERT was invoked or the default that was used.

System action

The event was not sent to the intended event notification targets.

Operator response

None.

System programmer response

Check the additional message lines and determine the cause of the problem.

Classes

None.

ING144I CDEMATCH FOR entry type WITH CODES (code1,code2,code3) RETURNED INVALID VALUE: value

Explanation

During code match checking a matching code definition was found. However, the value returned by the matching code definition is invalid.

  • The variable entry shows the entry name of the definition in the MESSAGES/USER DATA policy item of the automation policy where the matching code definitions were searched for.
  • The variable type shows the message ID of the definition in the MESSAGES/USER DATA policy item of the automation policy where the matching code definitions were searched for.
  • The variables code1, code2, and code3 show the values that were used to search for a matching code definition in the MESSAGES/USER DATA policy item of the specified entry and type.
  • The variable value shows the value that is returned from the matching code definition.

System action

Further processing depends on the context. Processing usually stops.

Operator response

Check for more information.

System programmer response

Check the configuration and correct the problem.

Classes

None.

ING145I type INFORMATION IS INCOMPLETE

Explanation

An event is to be sent however the information about the event notification target is incomplete.

  • The variable type shows the event notification target that could not be notified. It is one of the following:
    IOM
    System Automation for Integrated Operations Management (SA IOM) could not be reached. The information specified with the ALERTHOST parameter of the INGCNTL command is incomplete.
    EIF
    An EIF event could not be generated. The EAS PPI receiver name to be specified with the EIFPPI parameter of the INGCNTL command is missing.
    TTT
    A trouble ticket could not be generated because the address data for the TDI server or the data set characteristics for the trouble ticket detail data are missing or incomplete. This data should be specified with the TTTHOST and TTTDATA parameters of the INGCNTL command.
    USR
    A user event could not be generated. The name of the automation procedure that is used to handle user events is missing. The procedure name should be specified with the USRHANDLER parameter of the INGCNTL command.

System action

The event is not sent to the indicated event notification target. The request is rerouted to the next available agent in the sysplex (if any).

Operator response

None.

System programmer response

Check the configuration and correct the problem.

Classes

None.

ING146I ALERTING IS DISABLED

Explanation

An alert is to be sent to targets such as System Automation for Integrated Operations Management (SA IOM), Netcool/OMNIbus, or the Tivoli Enterprise Console (TEC) for event notification. However event notification is not enabled on this agent for any supported event notification target.

System action

The event is not sent to the indicated event notification target.

Operator response

Turn on event notification for the intended target with the INGCNTL command if desired.

System programmer response

None.

Classes

None.

ING147I ALERTING IS NOT SUPPORTED FOR RESOURCE TYPE 'type'

Explanation

An event is to be sent to an event notification target such as IOM, EIF, TTT or USR. However, the resource type specified is not supported for event notification.

  • The variable type shows the type of the resource that was specified, which is not valid for event notification.

System action

The event is not sent to the intended event notification target.

Operator response

Correct the problem and reissue the command.

System programmer response

None.

Classes

None.

ING148I function : request REQUEST TIMED OUT

Explanation

A request timed out.

  • The variable function shows the name of the function that detected the time out.
  • The variable request shows the request that timed out.

System action

None.

Operator response

Check other messages for more information.

System programmer response

None.

Classes

None.

ING149I LIST CONTROL SETTINGS

Explanation

This message provides header information for the INGCNTL LIST command.

System action

Processing continues.

Operator response

None.

System programmer response

None.

Classes

None.

ING150I timestamp : object severity jobname DATA= data

Explanation

ING150I represents an event that was injected into the system by an external or internal monitor. Typically INGMON is called from the NetView automation table as an action for this event. INGMON will find the corresponding monitor resources and trigger automation there if applicable.

  • The variable timestamp is the time that the event was originally produced or when the message was created. It is in the format hh:mm:ss mm/dd/yyyy.
  • The variable object specifies the monitored object that this event is related to.
  • The variable severity specifies the severity of the status of the monitored object that led to this event.
  • The variable jobname specifies the job name that the monitored object is related to or 'N/A' if there is none.
  • The variable data can be any data the monitor provides that might be useful for automation or recovery actions.

System action

Processing continues.

Operator response

None.

System programmer response

None.

Classes

None.

ING151I ATTACH OF name SUCCESSFUL

Explanation

The ATTACH of a virtual operator station task (VOST) was successful.

  • The variable name specifies the attach name of the VOST. Note that this name is the content of TGLOBAL SUBSJOB, that is, the job name of the VOST management APL.

System action

Processing continues.

Operator response

None.

System programmer response

None.

Classes

None.

ING152I ATTACH OF name FAILED WITH RC=rc

Explanation

The ATTACH of a virtual operator station task (VOST) failed with a return code greater than 0.

  • The variable name specifies the attach name of the VOST. Note that this name is the content of TGLOBAL SUBSJOB, that is, the job name of the VOST management APL.
  • The variable rc shows the return code given by the ATTACH command.

System action

The VOST is not started.

Operator response

Contact your system programmer.

System programmer response

Review the netlog for additional messages issued by the ATTACH command and correct the problem.

Classes

None.

ING153I command OF name SUCCESSFUL

Explanation

The stopping of a virtual operator station task (VOST) was initiated successfully. Note that the VOST may still be active for a certain time after this message is issued.

  • The variable command shows the command used to stop the VOST.
  • The variable name specifies the attach name of the VOST. Note that this name is the content of TGLOBAL SUBSJOB, that is, the job name of the VOST management APL.

System action

Processing continues.

Operator response

None.

System programmer response

None.

Classes

None.

ING154I command OF name FAILED WITH RC=rc

Explanation

The stopping of a virtual operator station task (VOST) failed with a return code greater than 0.

  • The variable command shows the command used to stop the VOST.
  • The variable name specifies the attach name of the VOST. Note that this name is the content of TGLOBAL SUBSJOB, that is, the job name of the VOST management APL.
  • The variable rc shows the return code given by the command.

System action

The VOST is not stopped.

Operator response

Contact your system programmer.

System programmer response

Review the netlog for additional messages issued by the specified command and correct the problem.

Classes

None.

ING155I ENVIRONMENT CHECK FAILED FOR command. REASON=rs

Explanation

A command was issued in an unsupported environment.

  • The variable command shows the command that was executed.
  • The variable rs shows the reason code that can have the following values:
    1
    Required task globals not set
    2
    Running on an unsupported task
    3
    Configuration not fully loaded
    4
    Main include member could not be read
    5
    ACFLEVEL could not be determined
    6
    ACFLEVEL mismatch

System action

The command stops processing.

Operator response

Contact your system programmer.

System programmer response

See the documentation of the command that issued the message and correct the problem.

Classes

None.

ING156I name ENDED WITH RC=rc

Explanation

The command executed in a virtual operator station task (VOST) ended.

  • The variable name specifies the attach name of the VOST.
  • The variable rc shows the return code of the command that ran in the VOST.

System action

The VOST is stopped.

Operator response

None.

System programmer response

None.

Classes

None.

ING157I INVALID VALUE FOR name: value

Explanation

Data was found that is not valid.

  • The variable name specifies the context.
  • The variable value shows the invalid data.

System action

Processing stops.

Operator response

Contact your system programmer.

System programmer response

See the documentation of the command that issued the message and correct the problem.

Classes

None.

ING158I SENDING OF ALERT alertid FOR resource PARTIALLY FAILED

Explanation

An event was only partially sent to the designated targets.

  • Variable alertid identifies the alert identifier that was specified when INGALERT was invoked or the default was used.
  • Variable resource identifies the resource.

System action

Processing continues.

Operator response

None.

ING159I EXIT exitname RETURNED UNEXPECTED RESULTS. REASON reason

Explanation

An exit was called but returned either an invalid return code or invalid data.

  • The variable exitname shows the name of the exit that was called.
  • The variable reason shows why the exit is considered to be in error:
    01
    Unexpected return code
    02
    Invalid number of data lines returned
    03
    Invalid data found in the returned lines

System action

Further processing depends on the context. Processing usually stops.

Operator response

Check for more information.

System programmer response

Check the configuration and correct the problem.

Classes

None.

ING160I RESPONSE FROM SOAP SERVER: server_nameattribute_name_1 sep attribute_name_2 sep ... attribute_name_n sepattribute_value_1 sep attribute_value_2 sep ... attribute_value_n sep

Explanation

This message displays the names and values of the attributes that have been requested by an ITM SOAP request. The attribute names and values are separated by the separator character, sep, of value X'FF'.

The first line of this multiline message denotes the SOAP server, server_name, that provided this response.

The second line contains the attribute names separated by the separator character. All the following lines contain the attribute values separated by the separator character.

This message is written to the console only.

System action

None.

Operator response

None.

System programmer response

None.

ING161I SENDING SOAP REQUEST TO SERVER: server_name

Explanation

A SOAP request is being sent to the SOAP server denoted by server_name. This message is written to the netlog only.

System action

None.

Operator response

None.

System programmer response

None.

ING162I SOAP FAULT CODE code. REASON: reason

Explanation

The SOAP request failed with a fault code of code. Possible codes are Client, VersionMismatch, MustUnderstand, and Server. The Client fault code indicates that the SOAP message was incorrectly formed.

The reason text indicates the particular fault.

This message is written to the console only.

System action

None.

Operator response

Contact your system programmer.

System programmer response

For a Client fault code, correct the SOAP message and try again. For any other fault code, contact your IBM support representative.

ING163I FAULT DETAIL: text

Explanation

This message provides further detail in variable text about the fault reported in the preceding ING162I message. This message spans multiple lines if further fault details are reported in the SOAP response.

This message is written to the console only.

System action

None.

Operator response

Contact your system programmer.

System programmer response

For a Client fault code (see ING162I), correct the SOAP message and try again. For any other fault code, contact your IBM support representative.

ING164I SOAP REQUEST FAILED, REASON: reason SERVER: server_name

Explanation

An error occurred while attempting to process a SOAP request on the SOAP server denoted by server_name. The actual error reason is encoded in the separate reason variable.

This message is written to the console only.

The following reasons are defined:
00000004
A timeout occurred and the connection was terminated.
0001nnnn
INGOMX failed to connect to, send to, or receive from a socket created to communicate with the SOAP server denoted by server_name. The socket error is encoded in bytes 2 and 3 represented by variable nnnn.
0002nnnn
The output returned from the IBM Tivoli® Monitoring SOAP server could not be handled by the XML parser. The XML parser reason code is encoded in bytes 2 and 3 represented by variable nnnn.
0003nnnn
An internal error occurred. The variable nnnn represents the internal error code.
0004xyyy
An HTTP error occurred while processing the request. If x=0, yyy denotes the 3-digit HTTP response code, for example, 404. If x=1 and y=008 check userID and password otherwise the variable yyy represents the internal error code.
0005nnnn
An error occurred while allocating or reading the SOAP request data set. The pipe QSAM return code is encoded in bytes 2 and 3 represented by variable nnnn.
0006nnnn
An error occurred while processing a CORRCMD pipe stage. The return code is encoded in bytes 2 and 3 represented by variable nnnn.

System action

None.

Operator response

Contact your system programmer.

System programmer response

For reason code 00000004, increase the timeout value. The parameter default variable INGOMX_WAIT can be set to increase the timeout.

For reason codes 0001nnnn and 0004xyyy, ensure you have connectivity to the SOAP server and verify the port and path of the SOAP service.

For reason code 0005nnnn, specify the correct data set name or fix the I/O error.

In any other case, contact your IBM support representative.

ING165I protocol status-code reason-phrase

Explanation

This message reflects the status line of a preceding HTTP request in case of a non-zero status code.

  • The variable protocol reports the HTTP protocol used by the server.
  • The variable status-code reports the status of the request.
  • The variable reason-phrase contains human readable information explaining the status-code.

This message is written to the netlog only.

System action

None.

Operator response

Contact your system programmer.

System programmer response

For status codes 1xx and 2xx, no action is required.

For status codes 3xx, check out message ING167I for the new location and try again.

For status codes 4xx, check out the details reported by message ING166I and fix the problem.

For status codes 5xx, collect the details reported by message ING166I and contact your IBM support representative.

ING166I HTTP-RESPONSE INFORMATION: text

Explanation

This message reports additional information about the HTTP response, where the variable text contains general header fields, response header fields, and entity header fields.

This message is written to the netlog only.

System action

None.

Operator response

Contact your system programmer.

System programmer response

See message ING165I about how to use this information depending on the status code returned by the server.

ING167I NEW LOCATION: location

Explanation

This message is issued as the result of a 3xx status code received as the response of the HTTP SOAP request. The request URI was either temporarily or permanently moved to a new location or is only accessible through the proxy server at the reported location. The request must be redirected to the new location reported by the variable location.

This message is written to the console only.

System action

None.

Operator response

Contact your system programmer.

System programmer response

Correct the server information in the customization dialog to use the reported location and then try the request again.

ING168I CALLER IS NOT AUTHORIZED TO GENERATE PASSTICKET REASON: reason

Explanation

The caller of INGOMX attempted to activate an OMEGAMON session or to perform a SOAP request using a PassTicket for authentication. However, the caller is not authorized to generate a PassTicket on behalf of the user defined for this OMEGAMON session or SOAP server, respectively.

This message is written to the Netlog only.

  • The variable reason shows the return and reason codes of the underlying applications, such as the SAF application, RACF, or the PassTicket service.

System action

None.

Operator response

Contact your system programmer to obtain the necessary authorization to execute the INGOMX command.

System programmer response

Refer to the Security Considerations of the INGOMX command for further details regarding the authorization required to generate PassTickets.

ING169I UNABLE TO GENERATE PASSTICKET REASON: rr

Explanation

The caller of INGOMX attempted to activate an OMEGAMON session or to perform a SOAP request using a PassTicket for authentication. However, the system was not able to generate a PassTicket.

This message is written to the Netlog only.

The variable rr shows the return codes. It can have the following values:
12
The logon method for NetView is inadequate for PassTicket generation. Ensure SECOPTS.OPERSEC is set to either SAFCHECK or SAFDEF.
24
No PTKTDATA profile exists to match the specified SAF application.

System action

None.

Operator response

Contact your system programmer.

System programmer response

If the return code is 12, set the security option SECOPTS.OPERSEC to SAFCHECK or SAFDEF and restart NetView.

If the return code is 24, ensure that a corresponding PTKTDATA profile exists for the specified SAF application. For more information, see "Authentication using PassTickets" in Planning and Installation

For all other return codes, contact IBM service.

ING170I THE FOLLOWING ENTRY-TYPES HAVE BEEN DELETED: entry-type

Explanation

This message is issued by the INGCLEAN utility when entry-types have been deleted. The deleted entry-types are appended to the above message text. Note that the entry-types for which a default has been restored are not included in this list.
  • The variable entry-type displays any entry-types that have been deleted.

System action

Processing was successful.

Operator response

None.

System programmer response

None.

Classes

None.

ING172I Resource resource_name has been released.

Explanation

The named resource has been released from waiting in front of a pacing gate. It immediately starts or stops depending on the pacing gate type.
  • The resource_name variable shows the resource in automation manager notation that has been released.

System action

None.

Operator response

None.

System programmer response

None.

ING177I command_name command is ignored because resource_name resource is suspended.

Explanation

The command_name command has detected that resource_name resource is suspended and therefore did not perform its action.
  • The command_name variable shows the command that issues this message.
  • The resource_name variable shows the resource in automation manager notation that is suspended.

System action

None.

Operator response

None.

System programmer response

None. If the invocation of the command_name command was triggered by an installation-written script, consider avoiding the invocation for a suspended resource.

ING178I No valid resource was found for command command.

Explanation

None of the resources that are defined in the sysplex matches the specified name pattern or their types are not supported by the named command.
  • The command variable shows the command for which a resource cannot be found.

System action

None.

Operator response

Refer to the description of the command in Operator's Guide or Programmer's Reference for further details.

System programmer response

None.

ING179I The service xxx failed with RC=retcode REASON=reason_text

Explanation

The SA z/OS® function XVP (XCF variable pool) tried to execute a service that failed. XVP manages shared variables within different SAplexes in the same physical sysplex. The XVP function is internally used by SA z/OS. There is no direct external interface.
  • The xxx variable indicates the service that failed.
  • The retcode variable indicates the return code of the service that failed.
  • The reason_text variable provides extra error description.
The possible return codes are as follows.
8 A timeout occurred.
   
1nn Failed to check the input data.
  • 104 aof_xvpin.0 is not numeric.
  • 112 The variable name is not alphanumeric plus @$#_.
   
2nn Failed to send a command to the automation manager (see nn for rc from INGPXRPC)
   
3nn Failed to receive response from the automation manager (see nn for rc from INGPXRPC). For example, 316 occurs because the automation manager is no longer running.
   
4nn The XVP service failed.
  • 404 The pool does not exist.
  • 408 The variable does not exist.
  • 412 The update is still in progress.
  • 416 The initialization is not yet completed.
  • 424 The variable is read only.
  • 428 A replication error occurred.
  • 432 The command is invalid.
  • 436 The minor ENQ name is longer than 255 bytes.
  • 440 ENQ lock is already obtained.
  • 444 ENQ failed.
  • 445 DEQ failed.
  • 499 Failed to get MASTER lock.
   
5nn Failed to check the input arguments of the command.
  • 508 The service is invalid.
  • 512 An argument is not alphanumeric plus @$#_.
  • 516 The 1st char in option is invalid.
  • 517 The 2nd char in option is invalid.
  • 518 The 3rd char in option is invalid.
  • 520 The timeout format is invalid.

System action

The processing of the XVP command terminates.

Operator response

Notify your system programmer.

System programmer response

Determine why the service failed and correct the problem. Examine the netlog for extra information.

ING200W SA event with NoStatusChange reason in domain domain

Explanation

This message is created by the SA z/OS internal notification function to send current status information to the end-to-end automation adapter.

System action

None.

Operator response

None.

System programmer response

None.

ING201W SA detected a status change of resource resource in domain domain. Common observed state: observed, Common desired state: desired, Common operational state: operational, Common compound state: compound

Explanation

This message is created by the SA z/OS internal event notification function when the status of a resource changes. It shows the resource’s new status in the end-to-end automation resource data model.

  • The variable resource shows the name of the resource.
  • The variable domain shows the name of the end-to-end automation domain.
  • The variable observed shows the observed state of the resource.
  • The variable desired shows the desired state of the resource.
  • The variable operational shows the operational state of the resource.
  • The variable compound shows the compound state of the resource.

System action

None.

Operator response

None.

System programmer response

None.

ING202I SA turned the resource resource request as requested in domain domain. Common observed state: observed, Common desired state: desired, Common operational state: operational, Common compound state: compound

Explanation

This message is created by the SA z/OS internal event notification function when a request has been issued to start or stop a resource. It shows the resource’s current status in the end-to-end automation resource data model.

  • The variable resource shows the name of the resource.
  • The variable request indicates if an Online or Offline request has been issued.
  • The variable domain shows the name of the end-to-end automation domain.
  • The variable observed shows the observed state of the resource.
  • The variable desired shows the desired state of the resource.
  • The variable operational shows the operational state of the resource.
  • The variable compound shows the compound state of the resource.

System action

None.

Operator response

None.

System programmer response

None.

ING203I SA detected that the system system joined the domain domain

Explanation

This message is created by the SA z/OS internal event notification function when the automation manager reports that the observed status of a system resource has changed from Sysgone.

  • The variable system shows the name of the system.
  • The variable domain shows the name of the end-to-end automation domain.

System action

None.

Operator response

None.

System programmer response

None.

ING204W SA detected that the system system left the domain domain

Explanation

This message is created by the SA z/OS internal event notification function when the automation manager reports that the observed status of a system resource has become Sysgone.

  • The variable system shows the name of the system.
  • The variable domain shows the name of the end-to-end automation domain.

System action

None.

Operator response

None.

System programmer response

None.

ING205I SA turned off the automation for resource resource in domain domain. Common observed state: observed, Common desired state: desired, Common operational state: operational, Common compound state: compound

Explanation

This message is created by the SA z/OS internal event notification function when a request has been issued to switch on or off the automation flag of a resource. It shows the resource’s current status in the end-to-end automation resource data model.

  • The variable resource shows the name of the resource.
  • The variable domain shows the name of the end-to-end automation domain.
  • The variable observed shows the observed state of the resource.
  • The variable desired shows the desired state of the resource.
  • The variable operational shows the operational state of the resource.
  • The variable compound shows the compound state of the resource.

System action

None.

Operator response

None.

System programmer response

None.

ING206W SA detected a warning in domain domain. The resource resource has been degraded. Common observed state: observed, Common desired state: desired, Common operational state: operational, Common compound state: compound

Explanation

This message is created by the SA z/OS internal event notification function when the automation manager reports that the observed status of the resource has become degraded. It shows the resource’s current status in the end-to-end automation resource data model.

  • The variable resource shows the name of the resource.
  • The variable domain shows the name of the end-to-end automation domain.
  • The variable observed shows the observed state of the resource.
  • The variable desired shows the desired state of the resource.
  • The variable operational shows the operational state of the resource.
  • The variable compound shows the compound state of the resource.

System action

None.

Operator response

None.

System programmer response

None.

ING207W SA detected a warning in domain domain. The resource resource has a performance problem. Common observed state: observed, Common desired state: desired, Common operational state: operational, Common compound state: compound

Explanation

This message is created by the SA z/OS internal event notification function when the automation manager reports that the health status of the resource has become degraded. It shows the resource’s current status in the end-to-end automation resource data model.

  • The variable resource shows the name of the resource.
  • The variable domain shows the name of the end-to-end automation domain.
  • The variable observed shows the observed state of the resource.
  • The variable desired shows the desired state of the resource.
  • The variable operational shows the operational state of the resource.
  • The variable compound shows the compound state of the resource.

System action

None.

Operator response

None.

System programmer response

None.

ING208W SA detected a warning in domain domain. The resource resource has problems caused by a dependency to another resource. Common observed state: observed, Common desired state: desired, Common operational state: operational, Common compound state: compound

Explanation

This message is created by the SA z/OS internal event notification function when the automation manager reports that the startable status of the resource has become inhibited. It shows the resource’s current status in the end-to-end automation resource data model.

  • The variable resource shows the name of the resource.
  • The variable domain shows the name of the end-to-end automation domain.
  • The variable observed shows the observed state of the resource.
  • The variable desired shows the desired state of the resource.
  • The variable operational shows the operational state of the resource.
  • The variable compound shows the compound state of the resource.

System action

None.

Operator response

None.

System programmer response

None.

ING209W SA detected a problem in domain domain. The resource resource can't be turned into the requested state. Common observed state: observed, Common desired state: desired, Common operational state: operational, Common compound state: compound

Explanation

This message is created by the SA z/OS internal event notification function when the automation manager reports a problem in the automation state or the observed state. It shows the resource’s current status in the end-to-end automation resource data model.

  • The variable resource shows the name of the resource.
  • The variable domain shows the name of the end-to-end automation domain.
  • The variable observed shows the observed state of the resource.
  • The variable desired shows the desired state of the resource.
  • The variable operational shows the operational state of the resource.
  • The variable compound shows the compound state of the resource.

System action

None.

Operator response

None.

System programmer response

None.

ING210W SA detected a problem in domain domain. The resource resource needs a manual reset by the operator. Common observed state: observed, Common desired state: desired, Common operational state: operational, Common compound state: compound

Explanation

This message is created by the SA z/OS internal event notification function when the automation manager reports that the observed status of the resource has changed to harddown. It shows the resource’s current status in the end-to-end automation resource data model.

  • The variable resource shows the name of the resource.
  • The variable domain shows the name of the end-to-end automation domain.
  • The variable observed shows the observed state of the resource.
  • The variable desired shows the desired state of the resource.
  • The variable operational shows the operational state of the resource.
  • The variable compound shows the compound state of the resource.

System action

None.

Operator response

None.

System programmer response

None.

ING211W SA detected a problem in domain domain. The resource resource has problems caused by an offline system. Common observed state: observed, Common desired state: desired, Common operational state: operational, Common compound state: compound

Explanation

This message is created by the SA z/OS internal event notification function when the automation manager reports that the observed status of the resource has changed to sysgone. It shows the resource’s current status in the end-to-end automation resource data model.

  • The variable resource shows the name of the resource.
  • The variable domain shows the name of the end-to-end automation domain.
  • The variable observed shows the observed state of the resource.
  • The variable desired shows the desired state of the resource.
  • The variable operational shows the operational state of the resource.
  • The variable compound shows the compound state of the resource.

System action

None.

Operator response

None.

System programmer response

None.

ING212W SA event with unknown reason in domain domain

Explanation

This message is created by the SA z/OS internal event notification function when the automation manager sends an event with an unknown reason.

  • The variable domain shows the name of the end-to-end automation domain.

System action

None.

Operator response

None.

System programmer response

None.

ING213I SA detected that system automation is ready in domain domain

Explanation

This message is created by the SA z/OS internal event notification function to inform the end-to-end automation adapter that the status of the automation domain is Online.

  • The variable domain shows the name of the end-to-end automation domain.

System action

None.

Operator response

None.

System programmer response

None.

ING214W SA detected that system automation is broken in domain domain

Explanation

This message is created by the SA z/OS internal event notification function to inform the end-to-end automation adapter that the status of the automation domain is Offline.

  • The variable domain shows the name of the end-to-end automation domain.

System action

None.

Operator response

None.

System programmer response

None.

ING215I SA detected a configuration policy refresh in domain domain

Explanation

This message is created by the SA z/OS internal event notification function to inform the end-to-end automation adapter that the automation policy has been refreshed in the automation domain.

  • The variable domain shows the name of the end-to-end automation domain.

System action

None.

Operator response

None.

System programmer response

None.

ING216I SA detected a new configuration in domain domain. New resource resource created.

Explanation

This message is created by the SA z/OS internal event notification function to inform the end-to-end automation adapter that a new resource has been created in the automation domain.

  • The variable resource shows the name of the resource.
  • The variable domain shows the name of the end-to-end automation domain.

System action

None.

Operator response

None.

System programmer response

None.

ING217I SA detected a deleted configuration in domain domain. Resource resource deleted.

Explanation

This message is created by the SA z/OS internal event notification function to inform the end-to-end automation adapter that a resource has been deleted in the automation domain.

  • The variable resource shows the name of the resource.
  • The variable domain shows the name of the end-to-end automation domain.

System action

None.

Operator response

None.

System programmer response

None.

ING218I SA detected a new configuration in domain domain. Request action request issued for resource resource

Explanation

This message is created by the SA z/OS internal event notification function to inform the end-to-end automation adapter that a new request has been issued for the resource in the automation domain.

  • The variable domain shows the name of the end-to-end automation domain.
  • The variable resource shows the name of the resource.

System action

None.

Operator response

None.

System programmer response

None.

ING219I SA detected a deleted configuration in domain domain. Request action request deleted for resource resource

Explanation

This message is created by the SA z/OS internal event notification function to inform the end-to-end automation adapter that a request for the resource in the automation domain has been deleted.

  • The variable domain shows the name of the end-to-end automation domain.
  • The variable resource shows the name of the resource.

System action

None.

Operator response

None.

System programmer response

None.

ING220I SA detected a new configuration in domain domain. New relationship relationship with source resource source and target resource target created.

Explanation

This message is created by the SA z/OS internal event notification function to inform the end-to-end automation adapter that a new relationship has been created between the source resource and the target resource in the automation domain.

  • The variable domain shows the name of the end-to-end automation domain.
  • The variable relationship shows the name of the relationship.
  • The variable source shows the name of the dependent resource.
  • The variable target shows the name of the supporting resource.

System action

None.

Operator response

None.

System programmer response

None.

ING221I SA detected a deleted configuration in domain domain. Relationship relationship with source resource source and target resource target deleted.

Explanation

This message is created by the SA z/OS internal event notification function to inform the end-to-end automation adapter that a relationship between the source resource and the target resource in the automation domain has been deleted.

  • The variable domain shows the name of the end-to-end automation domain.
  • The variable relationship shows the name of the relationship.
  • The variable source shows the name of the dependent resource.
  • The variable target shows the name of the supporting resource.

System action

None.

Operator response

None.

System programmer response

None.

ING222I SA detected an automation status change in domain domain

Explanation

This message is created by the SA z/OS internal event notification function to inform the end-to-end automation adapter that properties have been changed in the automation domain.

  • The variable domain shows the name of the end-to-end automation domain.

System action

None.

Operator response

None.

System programmer response

None.

ING223W SA detected that the system system switched into maintenance mode by operator command in domain domain

Explanation

This message is created by the SA z/OS internal event notification function when the automation manager reports that the desired status of a system resource has changed to Available.

  • The variable system shows the name of the system.
  • The variable domain shows the name of the end-to-end automation domain.

System action

None.

Operator response

None.

System programmer response

None.

ING224I SA detected that the system system switched back to automation mode by an operator command in domain domain

Explanation

This message is created by the SA z/OS internal event notification function when the automation manager reports that the desired status of a system resource has changed to Unavailable.

  • The variable system shows the name of the system.
  • The variable domain shows the name of the end-to-end automation domain.

System action

None.

Operator response

None.

System programmer response

None.

ING225W SA suspended automation for resource resource in domain domain as requested.

Explanation

This message is created by the SA z/OS internal event notification function when the automation manager reports that the automation flag of the resource has been switched off.

  • The variable resource shows the name of the resource.
  • The variable domain shows the name of the end-to-end automation domain.

System action

None.

Operator response

None.

System programmer response

None.

ING226I SA resumed automation for resource resource in domain domain as requested.

Explanation

This message is created by the SA z/OS internal event notification function when the automation manager reports that the automation flag of the resource has been switched on.

  • The variable resource shows the name of the resource.
  • The variable domain shows the name of the end-to-end automation domain.

System action

None.

Operator response

None.

System programmer response

None.

ING230E Addressed consumer consumer not registered. Event not forwarded.

Explanation

An event was received with a consumer that was not registered as the target address. The event therefore cannot be forwarded to the addressed consumer.

  • The variable consumer shows the name of the event consumer that was specified as the target address of the event, and that the event should have been forwarded to.

System action

Processing of the event is terminated.

Operator response

None.

System programmer response

Check whether event notification has been correctly initialized and end-to-end automation has been registered as an event consumer.

ING231E Event notification service returns rc. Event not forwarded to receiver_id.

Explanation

The event could not be forwarded to the addressed consumer.

  • The variable rc shows the return code.
  • The variable receiver_id shows the name of the PPI receiver ID.

If the NetView EA/S is used for event forwarding, then rc is the return code from PIPE stage TECROUTE.

If the NetView EA/S is not used for event forwarding, then rc is the return code from the System Automation internal event forwarding mechanism AOF_PPI_CALLJAVA. Check if the E2E adapter is already running since the event is sent directly to the E2E adapter without using EA/S.

System action

Processing of the event is stopped.

Operator response

None.

System programmer response

Check whether the status of the PPI receiver ID is active. The status of PPI receivers can be listed with the command DISPPI.

ING232I PPI receiver ID for E2E adapter is set to receiver_id.

Explanation

The PPI receiver ID for the message adapter of the event/automation service, which is used to forward events to the automation adapter, has been set to the specified receiver ID.

System action

None.

Operator response

None.

System programmer response

None.

ING233E Event forwarding task EVTOPER for E2E not defined.

Explanation

The primary agent cannot be started because the automated function EVTOPER, which is used to forward the events to the automation adapter, has not been defined in the automation policy.

System action

Processing stops.

Operator response

None.

System programmer response

Define the automated function EVTOPER.

ING234E Request 'request' failed: RC=rc command='command' reason='reason'

Explanation

The specified command abended.

  • The variable request shows the request that was received from the automation adapter for execution.
  • The variable rc shows the return code of the command.
  • The variable command shows the command that implements the request.
  • The variable reason shows text that describes the error.

System action

Execution of the request stops.

Operator response

None.

System programmer response

Analyze the return code and reason code for the abending command.

ING235W No information from automation manager.event event not created for consumer.

Explanation

An error occurred when requesting information from the automation manager that needed to be included in a domain event. The event has not been created.

  • The variable event specifies the event to be created. Possible values are: READY, REFRESH, CHANGE.

    A READY event is created at initialization time of the automation domain and after having recovered from miscellaneous error situations.

    A REFRESH event is created after having refreshed the configuration policy.

    A CHANGE event is created after a takeover of the automation manager if the outage has not exceeded a given time interval.

  • The variable consumer shows the name of the event consumer that the event should have been forwarded to.

System action

Processing of the event is stopped.

Operator response

None.

System programmer response

Analyze the NetView log for further SA z/OS messages concerning the communication between the primary agent and the automation manager.

ING236W Task execution request request processed with warnings: COMMAND='command' REASON='reason'

Explanation

A warning was issued when executing a task execution request. The message variables are:
request
The name of the task execution request
command
The command that failed.
reason
Text that describes the error.

System action

The request is executed with warnings.

Operator response

None.

System programmer response

Analyze the reason code of the warning message.

ING237W Request 'request' processed with warnings: COMMAND='command' REASON='reason'

Explanation

A warning was issued when executing an end-to-end request.

  • The variable request shows the name of the end-to-end request.
  • The variable command shows the issued command that implements the request.
  • The variable reason specifies the warning message.

System action

The end-to-end request executes.

Operator response

Analyze the reason code of the warning message.

System programmer response

None.

ING238E Task execution request tex_request failed: ERROR=error_code SERVICE='service' RC=return_code REASON='reason'

Explanation

The REXX function INGRXTX0 and common REXX macros issue this message if there is an error. The message variables are:
tex_request
The name of the task execution request
error_code
The REXX function INGRXTX0 and the common REXX macros issue the following error codes:
1
RPC service failed: either INGPXSND, INGPXRCV or INGPXDEL.
2
Read from or write to the task execution data stream failed.
3
Unknown task execution operation name.
4
Execution of a task execution request started but failed. The REXX macro that implemented the execution of the request did not issue an error message. This is the default return code and the standard ING238E message is written with SERVICE=OperationName and RC=OperationReturnCode.
5
Authorization error: the user that made the request is not authorized to make it.
6
At least one request in the list of requests failed.
7
The execution of a task execution request failed for any other reason.
8
The execution of a task execution request failed because service INGPYAMC failed.
9
Execution of a task execution request was rejected because of expired expiration time.
10
User command executed but failed because return code is greater than zero.
11
Cannot start the user command because user command not found on target system.
12
Cannot start the user command because command user ID not defined on target system.
13
Cannot start the user command.
24
Task execution request contains no meta data.
28
The task execution command handler aborts because there is not enough time to send back the response data. No response is returned.
32
The task execution command handler aborts because of a REXX signaling error.
36
The automation adapter is not supported by this product.
service
The service that failed.
return_code
The return code of the service that failed.
reason
Text that describes the error.

The service, return_code, or reason variables may not have a value.

System action

Execution of the request failed for the reason given in the message.

Operator response

None.

System programmer response

Check the netlog and correct the error. If ERROR=28, increase the timeout value in seconds. For details, see End-to-End Automation ->Chapter Problem Determination of the End-to-End Adapter ->Timeout Problems.

ING239W Value in advanced automation option name not valid. Default value used.

Explanation

The value provided in the advanced automation option is not accepted as a valid value.

  • The variable name shows the name of the advanced automation option.
  • The variable value shows the value of the advanced automation option.

System action

Processing continues with the default value for the specified advanced automation option.

Operator response

None.

System programmer response

Correct the value provided in the advanced automation option.

ING240E Unexpected task execution request name tex_request.

Explanation

The REXX macro implemented to execute the task execution request was called with an unexpected task execution request name.

  • The variable tex_request shows the name of the task execution request.

System action

Processing of the task execution request fails.

Operator response

Contact your IBM Support Center.

System programmer response

None.

ING241E Unexpected task execution element type type.

Explanation

The REXX macro implemented to execute the task execution request was called with an unexpected task execution request type.

  • The variable type shows the type of task execution element.

System action

Processing of the task execution request fails.

Operator response

Contact your IBM Support Center.

System programmer response

None.

ING242E Cannot read task execution element from data stream.

Explanation

The REXX macro implemented to execute the task execution request cannot read the task execution element from the data stream.

System action

Processing of the task execution request fails.

Operator response

Contact your IBM Support Center.

System programmer response

None.

ING243E Cannot write task execution element to data stream.

Explanation

The REXX macro implemented to execute the task execution request cannot write to the data stream to return data to the calling routine.

System action

Processing of the task execution request fails.

Operator response

Contact your IBM Support Center.

System programmer response

None.

ING244E Invalid filter element name filter.

Explanation

The REXX macro implemented to execute the task execution request was passed an invalid filter element name.

  • The variable filter shows the name of the filter element.

System action

Processing of the task execution request fails.

Operator response

Contact your IBM Support Center.

System programmer response

None.

ING245E Duplicate filter element name filter.

Explanation

The REXX macro implemented to execute the task execution request was passed duplicate filter element names.

  • The variable filter shows the name of the filter element.

System action

Processing of the task execution request fails.

Operator response

Contact your IBM Support Center.

System programmer response

None.

ING246E Invalid combination of filter element names filter1 and filter2.

Explanation

The REXX macro implemented to execute the task execution request was passed an invalid combination of filter element names.

  • The variables filter1 and filter2 show the names of the two filter elements.

System action

Processing of the task execution request fails.

Operator response

Contact your IBM Support Center.

System programmer response

None.

ING247E Invalid filter element filter. Filter value unknown: value

Explanation

The REXX macro implemented to execute the task execution request was passed an unknown filter value.

  • The variable filter shows the name of the filter.
  • The variable value shows the value of the filter.

System action

Processing of the task execution request fails.

Operator response

Contact your IBM Support Center.

System programmer response

None.

ING248E Invalid filter element filter. Filter operator unknown: operator

Explanation

The REXX macro implemented to execute the task execution request was passed a filter element with an unknown operator comparing the filter name and filter value.

  • The variable filter shows the name of the filter.
  • The variable operator shows the filter operator.

System action

Processing of the task execution request fails.

Operator response

Contact your IBM Support Center.

System programmer response

None.

ING249E Execution of a task execution request timed out. The expiration time time was too short – missing_time.

Explanation

The expiration time that was provided for the task execution request was too short.

  • The variable time shows the expiration time that was provided for the task execution request.
  • The variable missing_time specifies the missing time interval.

System action

Processing of the task execution request fails.

Operator response

Contact your system programmer.

System programmer response

Check the defined timeout interval for the end-to-end automation request. The expiration time of an end-to-end automation request is determined by where it is issued, as follows:
Request issued from: Expiration time determined by:
The SMU WebUI or System Automation Application Manager The timeout interval that is defined in the WebSphere® Admin Console for the environment variable com.ibm.eez.aab.invocation-timeout-seconds
The automation adapter (such as INIT_DOMAIN) The timeout interval that is defined in the automation adapter ing.adapter.plugin.properties configuration file
E2E agent The timeout interval INGAGT_CON_TIMEOUT that is defined in the automation agent inge2eagt.properties configuration file
It is possible that an end-to-end automation request that has been issued might be queued in the automation adapter or the NetView operator task for a certain period of time. You can therefore increase the timeout interval to take this delay into account.

If the timeout occurs during INIT_DOMAIN, you can also increase the TIMEOUT parameter in ing.adapter.plugin.properties.

ING250E Execution of a service timed out. The expiration time time was reduced to number seconds.

Explanation

A service routine timed out without exploiting the expiration time that was provided for the execution of the task execution request. The execution time was reduced to the maximum value for the WAIT parameter of the executed service.

  • The variable time shows the expiration time that was provided for the task execution request.
  • The variable number shows the value for the WAIT parameter of the executed service.

System action

Processing of the task execution request fails.

Operator response

None.

System programmer response

None.

ING251E Invalid combination of filter elements filter1 and filter2. Values value1 and value2 are mutually exclusive.

Explanation

The REXX macro implemented to execute the task execution request was passed an invalid combination of values for the filter elements.

  • The variables filter1 and filter2 show the names of the two filter elements.
  • The variables value1 and value2 show the values of the two filter elements.

System action

Processing of the task execution request fails.

Operator response

Contact your IBM Support Center.

System programmer response

None.

ING252E Domain initialization failed. Automation environment not initialized.

Explanation

Initialization of the automation domain failed because initialization of the system automation environment of the primary agent has not yet been completed.

System action

The start of the automation adapter fails.

Operator response

Restart the automation adapter after the initialization of the automation environment of the primary agent has completed.

System programmer response

None.

ING253E Domain initialization failed. Primary agent already started on system system.

Explanation

Initialization of the automation domain failed because the primary agent is already running on another system within the subplex.

  • The variable system shows the system name.

System action

The start of the automation adapter fails.

Operator response

Check whether the automation adapter should be stopped on the other system.

System programmer response

None.

ING254E Domain initialization failed. PPI receiver receiver of EAS not ACTIVE.

Explanation

Initialization of the automation domain failed because the PPI receiver ID of the NetView event/automation service is not active.

  • The variable receiver shows the name of the PPI receiver.

System action

The start of the automation adapter fails.

Operator response

Analyze the status of the PPI receivers by using command DISPPI. Check whether the event/automation service has been started and has successfully initialized its receiver ID at the PPI.

System programmer response

None.

ING255E Requesting information from Automation Manager of domain domain failed.

Explanation

Requesting information from automation manager of an automation domain failed. Requesting information from automation is necessary during the initialization of the automation domain or when requesting information about the automation domain.

  • The variable domain shows the name of the automation domain.

System action

The task execution request fails.

Operator response

None.

System programmer response

Analyze the problem. Examine the NetView log for further information. If the problem persists contact your IBM Support Center.

ING256E Health check failed. Event forwarding switched off.

Explanation

Events were lost when trying to forward them from the primary agent to the automation adapter. Event forwarding has therefore been switched off, which results in failing the health check of the automation domain.

System action

The automation adapter will stop. A subsequent restart enforces the re-initialization of the automation adapter and a refresh of the status information about first-level automation resources on the end-to-end server.

Operator response

Check the communication path from the primary automation agent to the NetView event/automation service. As soon as the communication path is available again, the automation adapter can be restarted.

System programmer response

None.

ING257E Health check failed. PPI receiver receiver of EAS not ACTIVE.

Explanation

The PPI receiver identifier of the event/automation service is not in the status ACTIVE. This results in failing the health check of the automation domain.

  • The variable receiver shows the PPI receiver ID of the NetView event/automation service.

System action

The automation adapter does not send a heartbeat event. Thus the communication status of the domain on the end-to-end management server changes.

Operator response

Analyze the status of the PPI receivers by using command DISPPI. Check whether the event/automation service has been started and has successfully initialized its receiver ID at the PPI.

System programmer response

None.

ING258E Execution of service service failed. Unexpected data received.

Explanation

The requested service did not return the expected data.

  • The variable service shows the name of the requested service.

System action

Processing of the task execution request fails.

Operator response

Notify your system programmer.

System programmer response

Determine why the service routine fails. Examine the NetView log for additional information.

ING259E Invalid request element. Request name unknown: name

Explanation

An end-to-end request with an unknown name was received.

  • The variable name shows the request name.

System action

Processing of the task execution request fails.

Operator response

Contact your IBM Support Center.

System programmer response

None.

ING260E Invalid request element. Request type unknown: type

Explanation

An end-to-end request with an unknown type was received.

  • The variable type shows the request type.

System action

Processing of the task execution request fails.

Operator response

Contact your IBM Support Center.

System programmer response

None.

ING261E Invalid request element. Multiple solicited requests are not supported.

Explanation

Multiple solicited end-to-end requests were received to be executed by the primary agent. Only one solicited end-to-end request can be accepted.

System action

Processing of the task execution request fails.

Operator response

Contact your IBM Support Center.

System programmer response

None.

ING262W An attempt was made to overwrite at least one restricted parameter. Input parameters have been ignored: parameters

Explanation

An end-to-end request was received with parameters that attempted to overwrite restricted parameters. The parameters are ignored.

  • The variable parameters shows a list of the ignored parameters.

System action

Processing of the task execution request fails.

Operator response

Contact your IBM Support Center.

System programmer response

None.

ING263E Request rejected because mandatory parameter SOURCE is missing.

Explanation

An end-to-end request was received without the specified originator of the request via parameter SOURCE.

System action

Processing of the task execution request fails.

Operator response

Contact your IBM Support Center.

System programmer response

None.

ING264E Reset_from_NRE rejected because agent status of resource resource is CTLDOWN.

Explanation

A reset-from-non-recoverable-error request was received for a resource that is in agent status CTLDOWN. Such a request is not supported for resources in agent status CTLDOWN.

  • The variable resource shows the name of the resource that the request was issued for.

System action

Processing of the task execution request fails.

Operator response

Check the agent status of the resource that the request was issued for.

System programmer response

None.

ING265E Reset_from_NRE rejected because observed status of resource resource is not HARDDOWN.

Explanation

A reset-from-non-recoverable-error request was received for a resource that is not in status HARDDOWN. Such a request is only supported for resources in status HARDDOWN.

  • The variable resource shows the name of the resource that the request was issued for.

System action

Processing of the task execution request fails.

Operator response

Check the status of the resource.

System programmer response

None.

ING266E Reset_from_NRE failed because no data to resource resource received from Automation Manager.

Explanation

A reset-from-non-recoverable-error request was received for a resource. An error occurred when requesting information from the automation manager about the resource that the request was issued against.

  • The variable resource shows the name of the resource that the request was issued for.

System action

Processing of the task execution request fails.

Operator response

Check whether the resource that the request was issued for is known to the automation manager.

System programmer response

None.

ING267E Reset_from_NRE rejected because resource resource is not of class APL.

Explanation

A reset-from-non-recoverable-error request was received for a resource that is not of class APL. This request is only supported for resources of type APL.

  • The variable resource shows the name of the resource that the request was issued for.

System action

Processing of the task execution request fails.

Operator response

Check the type of the resource that the request was issued for.

System programmer response

None.

ING268E request rejected because system name is missing.

Explanation

An end-to-end request concerning a system was issued, but the system name was not specified.

  • The variable request shows the name of the end-to-end request.

System action

Processing of the task execution request fails.

Operator response

Check that the request was issued against a resource of class SYS.

System programmer response

None.

ING269E Native command contains an invalid value for parameter $WAIT: wait

Explanation

An invalid value was specified as the WAIT parameter when issuing a native command.

  • The variable wait shows the value for the WAIT parameter that was received.

System action

Processing of the task execution request fails

Operator response

Contact your IBM Support Center.

System programmer response

None.

ING270E User user is not authorized to execute command: command

Explanation

The execution of the specified command is rejected by the authorization user exit AOFEXE2E.

  • The variable user shows the user ID that is associated with the command.
  • The variable command shows the rejected command resulting from the related end-to-end request.

System action

Processing of the task execution request fails.

Operator response

Contact your system programmer to obtain the necessary authorization to execute the command.

System programmer response

If it is appropriate, authorize the user to issue the specified command.

ING271E Command execution failed. Waiting for asynchronous output timed out.

Explanation

A timeout occurred when waiting for asynchronous output generated by a command that was issued from within a PIPE.

System action

Processing of the task execution request fails

Operator response

Retry the operation. If the problem persists, contact your system programmer.

System programmer response

Determine why the command does not return its output within the expected time. Examine the NetView log for additional information.

ING272E More than one request in a list failed.

Explanation

More than one request in a list of requests that were included in a task execution request failed.

System action

Processing of the related requests fails.

Operator response

Examine the NetView log for additional information about the single requests that were processed with errors.

System programmer response

None.

ING273W More than one request in a list processed with warnings.

Explanation

More than one request in a list of requests that were included in a task execution request were processed with warnings.

System action

Processing of the task execution request continues.

Operator response

Examine the NetView log for additional information about the single requests that were processed with warnings.

System programmer response

None.

ING274E A query to the automation manager failed due to unsuccessful execution of service INGPYAMC.

Explanation

An error occurred when requesting information from the automation manager via the automation manager API INGPYAMC.

System action

Processing of the task execution request fails.

Operator response

Check the communication path from the primary agent to the automation manager and examine the NetView log for additional information. If the problem persists contact your IBM Support Center.

System programmer response

None.

ING275E Processing failed for command: command

Explanation

A command was called that ended with a non-zero return code.

  • The variable command shows the failed command.

System action

Processing of the command stops.

Operator response

For commands that are described in IBM Z System Automation Operator's Commands or in IBM Z System Automation Programmer's Reference, determine why the command failed and correct the problem.

System programmer response

None.

ING276E Execution of a service timed out.

Explanation

The return code of the requested service indicates a timeout problem.

System action

The requested service does not complete successfully.

Operator response

Retry the operation. If the problem persists, contact your system programmer.

System programmer response

Determine why the service routine timed out. Examine the NetView log for additional information.

ING277I Command Handler INGRXCMJ FAILED: RC=nn ReasonText

Explanation

The command handler of the Automation Agent Java™ Framework detected an error.

  • The variable RC is the return code from the command handler INGRXCMJ as described below.
  • The variable ReasonText is the description of the error, as described below.
Table 1. Reason Text for Return Codes
Return Code Reason Text
54 CMD_RC=cmd_rc CMD=cmdshort ERRMSG=errormsg
58 PIPE ERROR PIPE_RC=pipe_rc
59 PIPE ERROR STAGE=stage RC=scr CMD=cmdshort
60 PIPE ERROR STAGE CORRWAIT ASYNCH TIMEOUT
nn CMD=short command that failed
Note: For rc=1..32, message AOF356 was issued (command handler failed).
Table 2. Return Codes from INGRXCMJ
Return Code Explanation
0 Success
4 Invalid RPC Type
8 REXX function failed
12 NetView pipe failed
16 buffer.0 is wrong
20 Route cmd failed
24 JVM stuff failed
28 INGPXRCV rc<>0
32 Remote_Command failed (for remote target only)
52 Invalid data stream
54 CMD_RC=cmd_rc CMD=cmdshort ERRMSG=errormsg
58 PIPE ERROR PIPE_RC=pipe_rc
59 PIPE ERROR STAGE=stage RC=src CMD=cmdshort
60 PIPE ERROR STAGE CORRWAIT ASYNCH TIMEOUT
74 INGEXEC error
75 PIPE error
76 At least one command failed on the remote system
77 Target missing
Note: For return codes 74 to 77, see AOF_JVM_Route_Command (AOFC0210).

System action

The command has not been executed successfully.

Operator response

None.

System programmer response

Analyze the NetView log and search for further error messages which may provide more details about the reason of the error. If rc=54, look for the description of the associated command. If necessary, contact your IBM Contact Support Center.

ING278I System Automation E2E Agent cannot find resources of type xxx.

Explanation

The E2E agent queries the automation manager for DMN and REF resources. However there are no DMN or REF resources defined in the configuration file currently loaded by the automation manager. The placeholder xxx defines the type of resource, for example DMN or REF.

System action

E2E agent initialization continues and the status of the E2E agent application will be set to HALTED.

Operator response

None.

System programmer response

Check the System Automation policy for DMN and REF resources.

ING279I Resource type xxx not supported.

Explanation

The specified resource type disallowed for execution of a command or for a dialog. The placeholder xxx specifies the unsupported resource type, for example DMN.

System action

None.

Operator response

Specify a resource with valid type.

System programmer response

None.

ING300I Command command finished successfully

Explanation

A command has finished processing and achieved what it has been asked to do, for example, starting a resource.

  • The variable command is the command being executed.

System action

None.

Operator response

None.

System programmer response

None.

ING301I Command command failed - unexpected results after waiting for hh:mm:ss

Explanation

A command has finished processing but has not achieved what it has been asked to do. For example, when starting a resource, the resource is not in the expected state after the allowed time period.

  • The variable command is the command being executed.
  • The variable hh:mm:ss is the timer period.

System action

None.

Operator response

None.

System programmer response

None.

ING302I Nothing to cancel

Explanation

No request exists for the specified resource that originated from the same source.

System action

None.

Operator response

None.

System programmer response

None.

ING304I Waiting for termination of name aborted - reason

Explanation

Z System Automation was waiting for the termination of the name component, but the termination command was aborted.

  • Variable name is the name of component.
  • Variable reason explains why the termination command was aborted.

System action

Processing continues.

Operator response

None.

System programmer response

If the component is OMVS, consider adding command F BPXOINIT,SHUTDOWN=FORKINIT command as SHUTINIT command for JES in the policy.

ING305I System shutdown started for name

Explanation

Indicates that the termination of the system has been started. The shutdown was either requested by the local operator, GDPS® or the Active/Active controller.

  • Variable name identifies the name of the system.

System action

Processing continues.

System programmer response

None required.

ING306I System shutdown nearly complete for name

Explanation

Indicates that the shutdown of the names system is nearly finished. Only NetView is still active.

  • Variable name identifies the name of the system.

System action

Processing continues.

System programmer response

None required.

ING307I System shutdown for name already in progress

Explanation

Indicates that Z System Automation is already working on shutting down the named system.

System action

Processing continues.

System programmer response

None required.

ING308A Waiting for termination of name

Explanation

System automation is in the middle of shutting down the system and is waiting for the termination of the named component / address space. The termination process is on halt till the named component becomes inactive.

  • Variable name identifies the name of the system.

System action

Processing continues.

Operator response

Stop the named component / address space.

System programmer response

None required.

ING309I System shutdown for name redirected due to GDPS Tower, STOPAPPL=resource

Explanation

A system shutdown was requested by means of the INGREQ ALL command. Since the system is under control of GDPS, only the toplevel resource identified by means of the GDPS STOPAPPL parameter in the GEOPLEX OPTIONS member is terminated.

  • Variable name identifies the name of the system.
  • Variable resource identifies the GDPS STOPAPPL resource.

System action

Processing continues.

Operator response

None.

System programmer response

None required.

ING310I data

Explanation

This message is used to transport the completion block from the system being terminated back to the Active/Active Controller.

System action

Processing continues.

System programmer response

None.

ING311I Workload name not defined in the SA policy

Explanation

The Active/Active controller has requested either to Start, Stop a workload or to query the status of the workload, but the workload is not defined in the Z System Automation policy. Workload must be defined in the GDPS_WORKLOAD policy under the MVS component.

  • Variable name identifies the workload.

System action

Processing continues.

System programmer response

Define the workload in the Z System Automation policy, if necessary.

ING312I action of Workload name failed.

Explanation

The Active/Active controller has requested either to Start or Stop a workload, but this failed. See the NetView log for more details about the failure when the workload is managed by Z System Automation or the system log otherwise.

  • Variable action identifies the action being performed (START or STOP).
  • Variable name identifies the workload.

System action

Processing continues.

System programmer response

None.

ING313I time: IPL completed within expected time period, elapsed time was duration

Explanation

IPL completed within the expected time period. This means all required resources have reached one of the specified statuses. The specified statuses are shown in DISPSYS. This message will only be reported on the console.

  • Variable time shows the time when this message was generated.
  • Variable duration shows the time it took all required resources to reach one of the specified statuses.

System action

None.

Operator response

None.

System programmer response

None.

ING314I time: IPL not completed within limit: limit. Failing resources: resource

Explanation

IPL did not complete within the maximum time limit. This means not all required resources have reached one of the specified statuses. The specified statuses are shown in DISPSYS. The failing resources are appended to the above message test. This message will only be reported on the console.

  • Variable time shows the time the message was generated.
  • Variable limit shows the specified maximum time limit within an IPL is considered to be completed successfully.
  • Variable resource displays the names of all resources which have not reached one of the specified statuses.

System action

None.

Operator response

Check the failing resources and correct the problem(s) which are blocking the resources to reach one of the specified statuses.

System programmer response

None.

ING315I time: IPL completed after expected time period, elapsed time was duration

Explanation

IPL completed after the expected time period. This means all required resources have finally reached one of the specified statuses but not within the expected time period. The specified statuses are shown in DISPSYS. This message will only be reported on the console.
  • Variable time shows the time when this message was generated.
  • Variable duration shows the time it took all required resources to reach one of the specified statuses.

System action

None.

Operator response

None.

System programmer response

None.

ING321I Unsupported function command found in emulator command, Caller: caller

Explanation

The IMFEXEC command was invoked passing a function code that is not supported by Z System Automation.

  • Variable emulator is the name of the command, for example IMFEXEC or OPSCMD.
  • Variable command identifies the function that is not supported by Z System Automation.
  • Variable caller identifies the REXX script that called the IMFEXEC command.

System action

Processing continues.

System programmer response

Modify the script invoking the IMFEXEC command.

ING322I emulator function commands are no longer allowed, Caller: caller

Explanation

The IMFEXEC CMD command was called, but no longer supported in the NetView/Z System Automation environment.

  • Variable emulator is the name of the command, for example IMFEXEC or OPSCMD.
  • Variable function identifies the function.
  • Variable caller identifies the REXX script that called the IMFEXEC command.

System action

Processing continues.

System programmer response

Modify the script invoking the IMFEXEC command.

ING323I emulator function does not support parameter parameter, Caller: caller

Explanation

The IMFEXEC command was called for a supported function, but the specified parameter is not supported by the Z System Automation emulator.

  • Variable emulator is the name of the command, for example IMFEXEC or OPSCMD.
  • Variable function identifies the function.
  • Variable parameter identifies the parameter that is not supported.
  • Variable caller identifies the REXX script that called the IMFEXEC command.

System action

Processing continues.

System programmer response

Modify the script invoking the IMFEXEC command.

ING325I alert-message

Explanation

This message is used to carry the alert text from an IMFEXEC ALERT function call

System action

Processing continues.

System programmer response

None.

ING326I No command specified

Explanation

The OPSCMD command was invoked but no command was specified.

System action

Processing continues.

System programmer response

Modify the script invoking the OPSCMD command.

ING327I parameter parameter value is not allowed

Explanation

The OPSCMD command was invoked specifying a value for a parameter that is not supported by the Z System Automation provided emulator.

  • Variable parameter names the parameter.
  • Variable value is the value.

System action

Processing continues.

System programmer response

Modify the script invoking the OPSCMD command.

ING328I parameter parameter value is unknown

Explanation

The OPSCMD was invoked specifying a system that is not known in Z System Automation.

  • Variable parameter is SYSID/SYSTEM.
  • Variable value is the name of the system that is unknown.

System action

Processing continues.

System programmer response

Modify the script invoking the OPSCMD command.

ING329I Job=jobname User=userid issued: command

Explanation

The OPSCMD was invoked to execute the specified command.

  • Variable jobname is the name of the job who originated the OPSCMD call.
  • Variable userid is the user id associated with the job.
  • Variable command is the command being used.

System action

The command is processed.

System programmer response

None.

ING330I Command execution was successful

Explanation

From TSO, the function INGRCRPC was called to execute a command in the SA NetView agent.

This command was executed successfully. Output data might have been returned to the caller.

System action

The program exits.

Operator response

None.

System programmer response

None.

ING331I Command execution failed. Waiting for asynchronous output has been interrupted due to timeout.

Explanation

From TSO, the function INGRCRPC was called to execute a command in the SA NetView agent.

This command execution failed due to timeout. Output data has not been returned to the caller.

The command might still be running on the NetView task until it is completed. However, the connection to the command execution task has been interrupted and no data will be returned to the TSO caller.

System action

None.

Operator response

None.

System programmer response

Increase the timeout value in function INGRCRPC.

Check if the command is still running or it is waiting in the NetView tasks queue.

Try to increase the number of working tasks for the command receiver.

ING332I Command execution failed. RC=rc SYSTEM=sys Command=cmd REASON:xxxx

Explanation

From TSO, the function INGRCRPC was called to execute a command in the System Automation Agent.

The execution of command cmd failed with return code rc in the System Automation Agent on system sys. Additional error description xxxx might be available and describes the reason for the error. If the rc is not one of the following reserved return codes, the reason is the first message that could be collected.

Reserved Return Codes:

The System Automation command receiver that controls the execution of the command within the NetView task may return the following reserved return codes.

Table 3. Reserved Return Codes
RC REASON DESCRIPTION
9001 CMD_NOT_AUTHORIZED NetView command authorization error.
9002 CMD_NOT_FOUND Invalid command or command not found.
9003 CMD_CAUSED_NEGRETC Command returned a negative return code or an internally used NetView PIPE error was detected.
CMD_CAUSED_HALTCOND HALT condition raised due to command return code -5.
REXX_PROCESSING_ERROR REXX programming error detected.
9004 OPERID_INVALID Invalid or inactive target task.
USERID_INVALID TSO user ID does not match an active NetView operator task.
USERID_ERROR Internal error.
9005 INTERNAL_ERROR Internal error.

System action

The function or command terminated.

Operator response

None.

System programmer response

Analyze the netlog and search for further error messages. For example, see explanation of error message ING338I.

In case of return code 9002, you can look for message DSI002I. Return code 9002 may also be issued if the command resides in a PDS that has been appended to DSICLD via the OVERRIDE command, but the autotask has no authority to read from it.

In case of return code 9003, analyze your REXX program for possible programming errors. For example, see explanation of error message IRXnnnI.

In case of return code 9004, check if the corresponding operator task exists and is active. The operator task is either equal to the TSO user ID that called INGRCRPC, or was specified as the taskname parameter in function INGRCRPC, or is per default one of the SA auto operator functions AOFCMDnn (nn=01,02,…). INGRCRPC accepts a System Automation automated function as target task. In this case, check that it contains an active operator task.

For commands executed by EVJRYCMD or AOFRYCM, the following help applies:

In case of return code 9002, you can find additional information in //SYSTSPRT or in the redirected data set of your choice.

ING333I Receiver is starting for PPI=xxx

Explanation

The RPC receiver with PPI receiver ID xxx is starting.

System action

The receiver is ready to receive remote command.

Operator response

None.

System programmer response

None.

ING334I Receiver is already running for PPI=xxx

Explanation

The RPC receiver with PPI receiver id xxx is already running.

System action

The receiver terminates.

Operator response

Specify a different PPI receiver id if you want to start a new receiver.

System programmer response

None.

ING335I Execute remote command on behalf of JOB=job_name USER=user_ID OPER=task_name CLIST=clist_name COMMAND=cmd

Explanation

From TSO, the function INGRCRPC was called to execute a command in the SA NetView agent. This command cmd will be executed on the NetView task task_name on behalf of the TSO job job_name, TSO user user_ID, and TSO CLIST clist_name.

System action

None.

Operator response

None.

System programmer response

None.

ING336I Receiver PPI=xxx will be stopped due to operator request

Explanation

The RPC receiver with PPI receiver id xxx is stopping due to operator request. A stop-command has been received and issued by 'INGRCRCV STOP PPI=xxx'

System action

The receiver terminates.

Operator response

None.

System programmer response

None.

ING337I PPI RECEIVER STATUS LIST

Explanation

These messages are output of the command 'INGRCRCV QUERY' and display all receiver PPI ids started via command 'INGRCRCV START'. The following example displays a list of two PPI receivers. One is running in a VOST.
ING337I PPI RECEIVER STATUS LIST 
        STATUS   PPI      TASK     VOST
        ------   -------- -------- --------
        ACTIVE   INGRCRCV DSI#0020 EMURCV2
        ACTIVE   PPIABC   BDOW     

System action

None.

Operator response

None.

System programmer response

None.

ING338I Function or command xxxx failed, RC=nn REASON=yyyy

Explanation

A function or a command with name xxxx failed with return code nn. Additional error description is given in yyyy.

It might be that an error has occurred in the past while initializing the RDS environment.

For explanation of return code nn see the table below.

System action

Processing terminates.

Operator response

Notify your system programmer.

System programmer response

Determine why the function or command failed. Examine the netlog. If necessary, contact your IBM Support Center.

Use Table 4 to determine the return codes used in message ING338I:

Table 4. Return Codes of ING338I
Module Name ReturnCode and Description
INGRCVAF
204 Invalid name mask
205 Invalid name mask, stem contains either + or *
206 Invalid parmlist
207 Invalid name mask, length of stem>8
208 Invalid action
212 Unsupported action
216 Error in helper function, for example, INGPCGLB or INGPCREX
INGRCVAL
200 Invalid call to routine
204 Invalid input name
205 Invalid old value for action=A
208 Invalid action
212 Unsupported action
216 Error in helper function, for example, INGPCGLB
218 Error when global variable not exist for action=O
220 Function aborted
224 Syntax error in subroutine(procedure)
236 EMULATOR INIT STATUS is not OK
INGRCVAX
0     OK
2     RPC timeout
4..24 RPC error
60   Invalid SOURCE name
104 Decode data items error
108 Expected at least 1 data item
112 Expected at least 1 data item
114 service routine failed, for example, INGPCREX
116 Host not supported
200 Execution of remote command failed
      Return code from remote command is unknown or invalid
200 Execution of remote command failed
+nnn nnn is the remote return code from INGRCVAC or from
        INGRCVAL, for example, 404 means invalid input INGRCVAL
INGRCVAC
0 OK
2 Mandatory parms missing
4 Error in AOF_PPI_PARSE_DATA
8 Error parsing DataItems
12 Error parsing parmlist
15 Error sending data, PIPE PPI error
16 Error sending data, PIPE error
20 INGRCVAL failed
21 INGPCGLB failed
22 INGRCVAF failed
23 INGRCVAL failed for POOLIST
24 Unexpected error
28 Standard Safe not supported for action
34 Triggering message missing
36 ARCHIVE failed because RESTORE not OK
1nn ARCHIVE failed
2nn INGRCVAL failed (remote command only)
3nn RESTORE failed

where the return codes nn have the following meaning
4 PUT init-rec failed
8 2nd OPEN failed
10 DEL failed
12 GET failed
14 GET KEYS failed
15 RESTORE VSAM failed
16 PUT failed
18 INQUIRE failed
19 Cannot retrieve output value
20 VSAM DEL for LOOKUP failed
21 PIPE EDIT for LOOKUP failed
22 PIPE LOOKUP failed
31 ARCHIVE_VSAM failed, mdfy.0 not equal mdfyval.0
32 ARCHIVE_VSAM failed, ref.0 not equal refval.0
33 ref. or refval. are not initialized by INGPCGLB
34 INGPCGLB(QUERY) failed
35 INGPCGLB(UPD_OR_APP) failed
See also message ING344I for possible VSAM IO error description.
INGRCRPC
0 OK
2 TIMEOUT
4 Missing Input
8 INGPCREX call failed
9 INGPCSTK call failed
10 Decoding response data items failed (stem)
16 PPI error
20 REXX error such as Syntax, Novalue, and so on
24 Invalid data buffer
28 AOCT0000.REXMAC initialization failed
32 Error while preparing input stem
INGRCRCV
0 OK
4 Invalid action
8 RECEIVER already active
12 PPI error
16 PIPE error
20 Invalid parameter list
24 Service failed
28 Auto OPS environment checking failed
40 Initialization failed
INGRCMDH
0 OK
4 Not a RPC
8 Invalid RPC input data
15 Sending response via PPI failed.
This might be the case due to timeout condition.
16 Command execution failed
INRCEXC
0 OK
1 Routing the command failed
2 Executing the command failed on THIS task
4 Bad input arguments
8 AOF_PPI_PARSE_DATA failed
INGRCCSA
201 Memory object name exist already
202 Init of lookup table failed
203 Invalid object name too long (max 12 char)
204 Invalid object name
205 Invalid size, not a number
206 Invalid parmlist
207 Invalid trace parameters
208 Invalid action
212 Unsupported action
216 Error in function INGPCCSA
INGRCRDX
2 INGRCRPC timeout
4..24 INGRCRPC error
104 Decode data items error
108 Expected at least 1 data item
112 Unexpected remote message
116 Host not supported
117 RDS working dataset not configured in CSA
118 Must be called as command
120 Service routine failed
122 Incomplete installation detected for SA TSO REXX
200 Execution of remote command failed
    Return code from remote command is unknown or invalid
+nnn nnn is the remote return code from INGRCVAC
       or from INGRCVAL, for example 404 means invalid input INGRCVAL
INGRCRDS
nnn<200 Error due to underlying services
201 VALUE missing or invalid
202 Mandatory parms missing
203 Table name missing or invalid
204 Error in AOF_PPI_PARSE_DATA
205 COLUMNS missing or invalid
206 Invalid parameter value
208 Error parsing DataItems
212 Error parsing parmlist
215 Error sending data, PIPE PPI error
216 Error sending data, PIPE error
220 No match, nothing updated or deleted
221 INGPCGLB failed
222 INGRCVAL syntax error
223 Invalid action
224 DEQ failed
225 Export to Dataset failed
226 Import to Dataset failed
227 Cannot determine data format from DSN
229 ARCHIVE table name pre-validation failed
230 INGRCREX (PUT) failed
231 INGRCREX (GET) failed
232 PUT/GET sequence violation
233 Invalid environment.
Must be called from REXX environment and must not be called from a PIPE stage.
234 Invalid syntax in AOF_AAO_RDS_DFLTVARS      
235 Remote execution failed                    
236 Unhandled condition for a WORKER            
237 Validation of RDS-Index failed              
238 Too many RDS-Index collisions                  
239 No hashkeys generated for RDS-Index collisions
240 Invalid RDS-Index status  
241 Duplicate record(s) exist      
971 64-bit memory required.    
The AAO AOF_AAO_RDS_M64 was set to NO or MEMLIMIT=ZERO caused implicitly to set the AA0 to NO.
Do not set MEMLIMIT=ZERO and/or remove the AAO.
9xx Function INGPCGLB failed.
INGRCRDS underlying service
CreateTableControl:
1 Two words required or comma missing, for example,
    'NAME Char(30)'
2 NOT numeric, for example, 'NAME Char(3x)'
3 Unsupported data type, for example, 'YEAR Integer'
4 Zero columns, at least one column is required
5 Table name too long (>30 characters)
6 Max row length exceeds implementation limit 32000
7 Invalid column name
CreateTableRow:
11 Truncated at least one column
12 Unequal number of column names/values
13 Max length of a row is exceeded
UpdateTableRow:
InsertTable:
21 Invalid column name
ReadTextTableData/Header:
31 bad column delimiter
35 bad import header
CreateTable:
100 Table exist already
UpdateTableControl:
101 Table does not exist
ModifyTableControl:
102 Table LOCK does not match
IterateTable:
InsertTable:
104 Table does not exist
105 Bad validation of TCR(corrupted row)
106 Row does not exist (dir.i)
IterateTable:
110 Error, no COLUMN match
115 Error WHERE/SET clause parser
116 Error match where clause (Syntax error !?)
117 Error parse or update
118 Error copy table data
CreateTable:
InsertTable:
GlobalDatastore:
120 INGRCVAL failed, see GlobalDatastore(vn,'U')
ListOfTables:
ListOfPools:
130 INGPCGLB(QUERY_ACL) failed
131 INGPCGLB(QUERY_ACL) returns no hexdata
Parser WHERE/SET:
41,42 parsing error, unmatched brackets (TokenizeWhereClause)
43 unsupported operator (TokenizeWhereClause)
44 parsing error, tokenizer failed (ParseValueClause)
46 parsing error, unmatched brackets (Tokenizer)
48,49 parsing error, column name not found (ResolveColumnsinWhereClause)
52 parsing error, invalid operator (ParseSetClause)
56 bad expression in match clause (SYNTAX, NOVALUE)

ING339I Receiver PPI=xxx recovers bad command execution, continue...

Explanation

The RPC receiver with PPI receiver id xxx executed a remote command which failed. However, the receiver continues processing and waits for the next command.

System action

Execution of the current command terminates. Receiver continues.

Operator response

Notify your system programmer.

System programmer response

Determine why the remote command failed. Examine the netlog.

ING340I Deleted n1 of n2 pattern matching global symbols

Explanation

The function INGRCVAF has filtered n1 number of global variables. n2 global variables have been deleted. If n2 is smaller than n1 then either the global variable cannot be found or an error occurred.

System action

As many global variables have been deleted as possible.

Operator response

None.

System programmer response

None.

ING341I Receiver PPI=xxx has been stopped

Explanation

The RPC receiver with PPI receiver id xxx has been stopped.

System action

The receiver terminates.

Operator response

None.

System programmer response

None.

ING342I No receivers are started

Explanation

Command 'INGRCRCV QUERY' does not find any receivers that were started.

System action

None.

System action

None.

Operator response

None.

ING343I Parameter xxxx is not supported by function or command yyyy

Explanation

The function or command yyyy was invoked passing a parameter that is not supported by Z System Automation.

  • Variable xxxx identifies the parameter that is not supported by Z System Automation.
  • Variable yyyy is the name of the command that detected the error.

System action

Processing continues.

System programmer response

Modify the script invoking the command.

ING344I JOB job_name FAILED: error_text

Explanation

This message is used by command INGVALUE in order to report an error, while performing an archive/restore operation. This message might be trapped by the automation table.

Token 3 of the message is the subsystem job name, token 5 the subcommand that failed and token 6 the kind of error. For example, VSAM_IO_ERROR.

You can use this message to set the resource RDSARCH, for example, to status abending.

The error_text might be one of the following:
ARCHIVE VSAM_IO_ERROR DSIVSMXV reason
Reason will be the error message provided by the failing NetView service.
ARCHIVE VSAM_IO_ERROR INGRCVSM RC=nn
The number is nn is the return code from INGRCVSM.
ARCHIVE ERROR 36
During SA initialization INGRDS was not initialized.
ARCHIVE ERROR 1nn - reason
Any other error during archiving RDS or other long global variables occurred. The reason describes the error code nn.
RESTORE ERROR 3nn - reason
Any other error during restoring RDS or other long global variables occurred. The reason describes the error code nn.

System action

The originating command terminated.

Operator response

None.

System programmer response

Determine why the function or command failed. Examine the netlog. You might want to check for the message ING338I that provides additional information about the module that causes the error.

ING345I Status of long global variables: xxx

Explanation

Command 'INGVALUE STATUS' reports the status of the long global variable framework. This message is also written if the command 'INGVALUE RESTORE' was successful.

xxx might have the following values:

  • RESTORE SUCCESSFUL - Persistent long global variables were restored successfully.
  • INITIAL RESTORE OK - Initialization of persistent long global variables was successful during initialization of Z System Automation.
  • INITIAL RESTORE NOT DONE - Initialization of persistent long global variables was not done during initialization of Z System Automation.
  • INITIAL RESTORE FAILED - Initialization of persistent long global variables failed during Z System Automation initialization.

System action

None.

Operator response

None.

System programmer response

Determine why the function or command failed. Examine the netlog if the status is not successful.

ING346I Abort function xxx on purpose at LINE nn

Explanation

The REXX function xxx detected an error at line nn. The purpose is that the error causes invalid call to routine. This can only be achieved by returning nothing on purpose. See example:
ING338I Function or command INGRCVAL failed, 
RC=204 REASON=invalid character found
ING346I Abort function INGRCVAL on purpose at LINE 83
   270 +++ return
IRX0045I  Error running INGRCVAL, line 270: 
No data specified on function RETURN

System action

The function or command terminated.

Operator response

None.

System programmer response

Analyse the netlog and search for further error messages. See explanation of error message ING338I.

Note: Ignore the error the IRX0045I, since No data specified on function RETURN was done on purpose. The real reason was detected earlier in the failing program which caused message ING346I.

ING347I Receiver PPI=id does not start due to an unsupported environment for xxx

Explanation

The receiver task was started by command 'INGRCRCV START OPF=xxx'. The receiver searches for the existence of the automation operator task (for example, if xxx is AOFCMDOPER then the tasks are AOFCMDnn, nn=00,01,02,..) but no active task was found.

System action

Receiver terminates.

Operator response

Notify your system programmer.

System programmer response

Check if the operator tasks are defined or why they are inactive.

ING348I Receiver PPI=id starts with a degraded operator function array mm of nn for xxx.

Explanation

The receiver task was started by command 'INGRCRCV START OPF=xxx'. The receiver searches for the existence of the automation operator task (for example, AOFEMUnn, nn=00,01,02,...) but found at least one task that was inactive or not defined.

The receiver task continues running but executing incoming commands might be degraded because the inactive tasks are skipped, and commands might be queued.

  • The number mm is the number of active tasks
  • The number nn is the number of defined tasks
  • The variable xxx is the name of the operator function array.

System action

Receiver continues.

Operator response

Notify your system programmer.

System programmer response

Check why not all operator tasks are inactive.

ING350I Improper Job Log Monitoring definitions detected for name, RSN=rsn

Explanation

During initialization SA z/OS detected an improper definition for the Job Log Monitoring task.

  • The variable name shows the subsystem name that is affected.
  • The variable rsn shows the reason:
    10
    Job Log Monitoring interval defined but no message ID.
    11
    Offset specification is invalid.
    12
    Token specification is invalid.
    13
    Message ID defined even if JOBLOGALL has been specified.
    14
    Message offset is 0 but no token has been defined.
    15
    Token has been defined but no message offset.
    16
    Monitoring interval is invalid.
    17
    DD name specification is invalid.
    18
    Message ID is invalid.

System action

The definition is ignored.

Operator response

Correct the definition and refresh the configuration if desired.

System programmer response

None.

ING360I Security check failed RC=nn Reason: reason_text

Explanation

System Automation security checking fails such that not one of the other security messages can be issued any more. The reason_text explains the error.

System action

System Automation does not grant access.

Operator response

None.

System programmer response

The reason_text may help you determine the reason for the error. If an internal API error occurred switch on trace and rerun the command.

ING361I Security check for resource(s) failed.

Explanation

System Automation security checking for one or more resources failed. In the NETLOG this is a multiline message with additional ING362 message lines.

System action

The System Automation command is not carried out.

Operator response

Check the NETLOG for more information, especially the ING362 message lines or messages issued by SAF product. Request access to the listed resource and try the command again.

System programmer response

None.

ING362I profile=profile access=access userid=userid rc=rc

Explanation

System Automation checking for the specified resources failed. This message denotes the resource profile, the access authority requested and the userid for which the check was done. It further shows the return code of the service called to perform the check.

System action

The System Automation command is not carried out.

Operator response

Check the NETLOG for messages issued by the SAF product. If the return code is 4 the SECOPTS.SARESAUT is set to ON.FAIL and no profile exists. If the return code is 8 you do not have the required access rights.

System programmer response

None.

ING365I Security check for target domain targetdomid failed.

Explanation

A System Automation command tries to access an agent on a remote system. SAF check failed for the following profile within class SYSAUTO:
AGT.sysplex.xcfgrp.TARGET.FROMDOM.domain.TODOM.
targetdomid

System action

The System Automation command is not sent to the remote system.

Operator response

None.

System programmer response

Check if the user of the System Automation command is allowed to execute the command on a remote system. Give the user READ permission to the corresponding SAF profile. There might be additional SAF messages such as ICH408I for additional information.

ING366I System Automation third party security check failed: reason_text

Explanation

A command received from outside NetView (for example, via PPI) is rejected for execution. SAF checking against following profile within class NETCMDS failed: netid.domid.command

The reason_text provides more detail:

  • Access denied for USER=user CLASS=NETCMDS PROFILE=xxxx. In this case, grant the user access to the specified profile.
  • Profile not defined PROFILE=xxxx in CLASS=NETCMDS. In this case, define the specified profile in NETCMDS.

System action

System Automation does not grant access.

Operator response

None.

System programmer response

The reason_text may help you to determine the reason for the error. There might be additional SAF messages such as ICH408I for additional information.

ING370I

Explanation

This message is used to return command response data of any kind. It helps to distinguish between the various systems that were specified in the TARGET parameter.

The first 10 characters specify always the system name where the response comes from. The response data starts at position 11. If the response has multiple lines, then ING370I will be returned multiple times.

System action

None.

Operator response

None.

System programmer response

None.

ING371I Execution result SYSTEM=ssssssss COM=ccccc RC=nn

Explanation

This message is used to return command completion information. It helps to distinguish between the various systems that were specified in the TARGET parameter.

This message may occur only once per target system.
  • The ssssssss specifies the name of the system where the command was executed.
  • The nn specifies the command return code.
  • The ccccc specifies the communication type that is used to transmit the command to the target system. The following types are supported.
    LOCAL
    The command was executed on local system
    XCF
    XCF communication within the same SAplex
    GWAY
    Gateway and using remote command
    RMTCMD
    Remote command
    EXTXCF
    Extended XCF within the extended XCF communication group
    OTHER
    Other communication mechanism

System action

None.

Operator response

None.

System programmer response

None.

ING372I Transmission error, RC=nn REASON: xxxxx

Explanation

This message is used to return the overall command transmission code.

This message might occur at most once if command execution fails on at least one of the target systems or if another kind of error occurs before the command can be sent.

The message is issued by the System Automation internal function INGPYCOM which might be called by external commands.

The reason xxxxx variable describes the return code in text form.

Return Code nn:

Success:
0 OK command executed
4 OK but NO data returned (only if RESP=YES)
No attempt to execute remote command:
10 No command in default safe
11 TARGET= parameter not available or no value
12 Parameter parsing error
14 Target is not active
15 Only one target is allowed (only if SNGLTGT=YES)
Failure when attempting to execute remote command:
20 Default command transmission error
21 Timeout
22 Invalid command on target system
23 Command is not authorized
24 Command returned a negative return code or PIPE error or PIPE stage error detected
25 Command caused halt condition (for example, NOVALUE)
26 Operator task is not active on local system
27 User command was executed on target system but failed with RC<>0
28 Cannot execute user command due to invalid user ID
29 Cannot execute user command due to internal error in INGRYCOM

System action

The command execution failed on at least one target system.

Operator response

None.

System programmer response

A return code value that is smaller than 20 might be caused by invalid input parameters. Normally this message is accompanied by other messages that are issued by a System Automation command that actually transmits another command to remote systems. Check the NETLOG for extra error messages.

ING376I The E2E agent cannot connect to dmn because reason.

Explanation

A request cannot be sent to a remote automation domain because the connection data is not available. It is either because the E2E adapter on the remote domain is not yet started, or because the E2E adapter is already running but it's the first time that the corresponding DMN has been loaded, for example by command "INGAMS REFRESH". This message is often accompanied with message ING377I.
  • The variable dmn shows the name of the remote automation domain.
  • The variable reason shows an explanation of the error.

System action

The processing of the E2E agent continues.

Operator response

Notify your system programmer.

System programmer response

Start or recycle the E2E adapter on the remote automation domain.

ING377I The E2E agent service xxx failed with RC=retcode, REASON=reason_text

Explanation

The E2E agent tried to execute a service that failed.
  • The xxx variable specifies the service that failed.
  • The retcode variable specifies the return code of the failing service.
  • The reason_text variable provides extra error description.
Possible return codes for INGRE2E and INGRE2E1 are as follows:
201 An error occurred when the parameter list is parsed.
202 The action is not supported.
203 The parameter is invalid.
204 Mandatory parameter is missing.
205 Cannot find resource.
219 Timeout during invocation of Java plug-in
220 Domain has no short name mapping.
221 Invocation of the java service failed via INGJAVA.
222 INGPYAMC failed.
223 Transmission to remote system failed.
224 No current system was found for E2E agent in SYSPLEX/GRP.
225 An Online or Offline request failed due to bad domain, for example, there is no persistent data available for this domain.
226 QRYINFO detects that the E2E agent initialization is not yet complete.
227 Initialization is aborted because the E2E agent exists on same or remote system.
228 Cannot refresh the E2E agent because INGREQ fails.
229 Necessary CGlobals are not defined or corrupted. The E2E agent might be stopped.
230 Cannot send an event E2EAGT_ON or E2EAGT_OFF to the E2E adapter.
231 REFRESH is pending.
232 Internal service failed.
233 Cannot get domain information because there is no persistent data available for this domain or the domain is not running. Recycle the E2E adapter on the remote domain.
234 Cannot get domain information because the domain is unknown or disabled.
235 Got TCP/IP connection error to the remote E2E adapter
236 The E2E agent terminated itself because the primary automation manager (PAM) was not available.
237 Execution of an MVS or NetView command failed.

System action

The processing terminates.

Operator response

Notify your system programmer.

System programmer response

Determine why the service failed and correct the problem. Examine the netlog for extra information.

ING378I The E2E agent task taskname failed for domain dom, reason.

Explanation

This diagnostic message is issued by the E2E agent to signal that a task was executed unsuccessfully within the USS process of the E2E agent. For example, the task might be an online, offline, or subscription request to the remote domain that is specified in the variable dom. Many of these tasks might be processed within a thread pool in parallel and an unsuccessful result will be reported for each task and remote domain.

The task can be one of the following types.
online
Start request of remote resource.
offline
Stop request of remote resource.
subscribe
Subscription request for remote domain.
unsubscribe
Unsubscription request for remote domain.
ResynchDomain
Synchronization request of remote resource.
The variable reason shows the text that explains what fails.
  • Unknown resource resource

    The specified remote resource is not known on the remote domain.

  • resource ref, remote resource resource

    The task cannot be executed successfully for the remote resource. See extra error messages.

    The ref variable shows the SA resource reference and the resource variable shows the referenced resource on the remote domain.

This diagnostic message appears in a multi-line message together with other error messages that are detected by the E2E agent. The multi-line message is written to NETLOG only.

System action

None

Operator response

None.

System programmer response

Analyze the error messages and check the reason of the problem.

ING379I The E2E agent is not running.

Explanation

This message is issued by the E2E agent to signal that the command cannot be executed by the USS process of the E2E agent because the E2E agent is not started.

System action

None

Operator response

None.

System programmer response

Start the E2E agent.

ING380I Persistent data store is initializing

Explanation

This message is used to indicate that the persistent data store is being starting up.

System action

None.

Operator response

None.

System programmer response

None.

ING381I Persistent data store is started

Explanation

This message is used to indicate that the persistent data store is fully initialized and operational.

System action

None.

Operator response

None.

System programmer response

None.

ING382I Persistent data store is terminating

Explanation

This message is used to indicate that the persistent data store is being shut down.

System action

None.

Operator response

None.

System programmer response

None.

ING383I Persistent data store is terminated

Explanation

This message is used to indicate that the persistent data store is shut down completely.

System action

None.

Operator response

None.

System programmer response

None.

ING384I Persistent data store is not available

Explanation

This message is used to indicate that the persistent datastore is not available.

System action

The requested operation is not carried out.

Operator response

Start the APL representing the persistent data store.

System programmer response

None.

ING385I Persistent data store communication failed - diagnosis info:

Explanation

This message is used for diagnosis purposes. It is the first line of a multi-line message and is written to the Netlog only. Subsequent lines provide more information.

System action

None.

Operator response

None.

System programmer response

Analyze the error messages and check the reason of the problem.

ING386I Persistent data store communication failed

Explanation

Although the persistent data store is available, a problem exists with the communication. See Netlog for message ING385I.

System action

None.

Operator response

None.

System programmer response

Analyze the error messages and check the reason of the problem.

ING387I Persistent data store communication timed out

Explanation

A timeout occurred in the communication to the persistent data store. The wait time of 5 seconds was exceeded.

System action

None.

Operator response

Retry the action again.

System programmer response

Check whether the persistent data store works properly.

ING388I Persistent data store is breaking

Explanation

This message is used to indicate that the persistent data store has encountered a severe error and will shut down.

System action

The application shuts down.

Operator response

None.

System programmer response

None.

ING389E Persistent data store is broken

Explanation

This message is used to indicate that the persistent data store is shut down completely but is unable to restart without any additional action.

System action

None.

Operator response

None.

System programmer response

Check the error description that is provided with the message and take additional steps to resolve the issue.

ING390I Only current templates can be used to create dynamic resources

Explanation

You are trying to create a dynamic resource from an outdated template.

System action

None.

Operator response

Choose a current template.

System programmer response

None.

ING391I Creation failed. Resource: name

Explanation

An automated resource could not be created. See Netlog for message ING413I.

The variable name identifies the resource that was not created.

System action

None.

Operator response

None.

System programmer response

Analyze the error messages and check the reason of the problem.

ING392I Creation was successful. Resource: name

Explanation

An automated resource was successfully created.

The variable name identifies the resource that was created.

System action

A resource was created and added to automation.

Operator response

None.

System programmer response

None.

ING393I Deletion was successful. Filter: filter - Resources: num

Explanation

One or more automated resources were successfully deleted.
  • The variable filter shows the filter that was used to identify the resources.
  • The variable num shows the number of deleted resources.

System action

One or more resources were deleted.

Operator response

None.

System programmer response

None.

ING394I Resource cannot be created on system name

Explanation

An automated resource is intended to be created on an invalid system.

The variable name specifies the name of the invalid system.

System action

No resource is created.

Operator response

When dynamically creating an automated resource on a particular system, verify that the system can be accessed and that the template does exist there.

System programmer response

None.

ING395I Multiple matches. Filter: filter

Explanation

The specified filter yields more than one result where only one was expected.

The variable filter shows the filter that was specified.

System action

None.

Operator response

Choose a more precise filter.

System programmer response

None.

ING396I No match. Filter: filter

Explanation

The specified filter yields zero results where at least one was expected.

The variable filter shows the filter that was specified.

System action

None.

Operator response

Choose a less precise filter.

System programmer response

None.

ING397I Deletion failed. Filter: filter

Explanation

One or more automated resources could not be created. See Netlog for message ING414I.

The variable filter shows the filter that was specified.

System action

None.

Operator response

None.

System programmer response

Analyze the error messages and check the reason of the problem.

ING398I Conflict detected with the dynamic resource resource - Action: action

Explanation

Automation managers and agents uniquely identify static resources (created in the policy) and dynamic resources (created with INGDYN) by their names. You should avoid name conflicts between static and dynamic resources. In this case, a static resource in the current automation configuration is detected to be conflicting with a dynamic resource previously created by INGDYN.

The variable resource refers to the name of the conflicting resource.

Variable action refers to the current action performed by INGDYN. It can be one of the following actions:
DELETE
This is a user action, that is triggered via the INGDYN DELETE command to delete the dynamic resource.
SYNC
This is an automatic action, that is triggered by the system to recreate dynamic resources from the persistent data store.

System action

If the action is SYNC, the dynamic resource has not been recreated, and it was kept in the persistent data store.

If the action is DELETE, the dynamic resource was deleted from the persistent data store.

In any case, the static resource in the data model of automation managers and agents remains unchanged.

Operator response

None.

System programmer response

This is a normal and expected behavior in the following cases:
  • A dynamic resources has been temporarily created via INGDYN and later on, it has been added to the automation configuration. In this case, you have to use INGDYN DELETE to clean up the conflicting dynamic resource from the persistent data store.
  • You are issuing INGDYN DELETE as part of the cleanup mentioned above.

Classes

40, 43, 46, 90.

ING400I BCPM Work order work_order is created on BCPM server server, system system.

Explanation

This message displays the identifier of a work order created in the Business Continuity Process Manager (BCPM) as the result of an outage event on the system.

System action

None.

Operator response

None.

System programmer response

None.

ING401E Unable to create BCPM Work order. Return code return_code from BCPM server server, system system.

Explanation

An outage event from the system cannot be delivered or processed by the Business Continuity Process Manager (BCPM) server.

System action

None.

Operator response

Inform the IT Service Continuity administrator about the outage.

System programmer response

Refer to the netlog for additional messages issued by the SA z/OS INGOMX command.

ING402I BCPM server server is notified about completion of task task with code code, system system.

Explanation

The task triggered by the Business Continuity Process Manager (BCPM) has completed. BCPM has received and processed the task completion information.

System action

None.

Operator response

None.

System programmer response

None.

ING403E Unable to notify BCPM server server about completion of task task with code code, system system. INGOMX command has returned error_code.

Explanation

The task triggered by the Business Continuity Process Manager (BCPM) has completed, but the BCPM cannot receive the task completion information. The INGOMX command ended with an error.

System action

None.

Operator response

Inform the IT Service Continuity administrator about the problem.

System programmer response

Refer to the netlog for additional messages issued by the INGOMX command. Check for the reason for the INGOMX error.

ING404E BCPM server server cannot process notification from task task. BCPM exception is exception_code.

Explanation

The task triggered by the Business Continuity Process Manager (BCPM) has completed, but the BCPM cannot process the task completion information.

System action

None.

Operator response

Inform the IT Service Continuity administrator about the problem.

System programmer response

None.

ING405I BCPM replied to the WTOR wtor with ID reply_id with reply on system system.

Explanation

The outstanding WTOR was reprocessed by the Business Continuity Process Manager (BCPM).

System action

A process requested WTOR is continued.

Operator response

None.

System programmer response

None.

ING406E BCPM unable to reply to the WTOR wtor with reply on system system. RC=rc.

Explanation

The outstanding WTOR is either no longer active and has already been reprocessed by an operator or automation product, or it cannot be reprocessed by the Business Continuity Process Manager (BCPM).

System action

None.

Operator response

Check for outstanding WTORs on the system. Inform the Service Continuity Team about the problem.

System programmer response

None.

ING407E BCPM unable to execute GDPS batch script batch_script. Return code rc, reason reason.

Explanation

The GDPS batch script was triggered by the Business Continuity Process Manager (BCPM), but cannot be executed.

System action

The script is not executed.

Operator response

Inform the IT Service Continuity administrator about the problem.

System programmer response

Refer to the netlog for additional messages issued by GDPS.

ING408I BCPM command command ended with rc=rc.

Explanation

The command triggered by the Business Continuity Process Manager (BCPM) has completed.

System action

None.

Operator response

None.

System programmer response

None.

ING410I Persistent data store backup was successful:

Explanation

This message indicates that the backup of the persistent data store was successful. The message also contains the USS path to the backup directory.

System action

None.

Operator response

None.

System programmer response

None.

ING411I Persistent data store backup failed:

Explanation

This message indicates that the backup of the persistent data store failed.

System action

None.

Operator response

None.

System programmer response

Check the error description that is provided with the message and take additional steps to resolve the issue.

ING412I Persistent data store backups must be deleted manually:

Explanation

This message indicates that the application was unable to delete old backups.

System action

None.

Operator response

None.

System programmer response

Check the error description that is provided with the message and take additional steps to resolve the issue.

ING413I Dynamic resource creation failed - diagnosis info:

Explanation

This message is used for diagnosis purposes. It is the first line of a multi-line message and is written to the Netlog only. Subsequent lines provide more information.

System action

None.

Operator response

None.

System programmer response

Analyze the error messages and check the reason of the problem.

ING414I Dynamic resource deletion failed - diagnosis info:

Explanation

This message is used for diagnosis purposes. It is the first line of a multi-line message and is written to the Netlog only. Subsequent lines provide more information.

System action

None.

Operator response

None.

System programmer response

Analyze the error messages and check the reason of the problem.

ING420I IBM Z System Automation Operations REST server is initializing

Explanation

This message is used to indicate that the System Automation Operations REST server is starting up.

System action

None.

Operator response

None.

System programmer response

None.

ING421I IBM Z System Automation Operations REST server is initialized

Explanation

This message is used to indicate that the System Automation Operations REST server is fully initialized and operational.

System action

None.

Operator response

None.

System programmer response

None.

ING422I IBM Z System Automation Operations REST server is terminating

Explanation

This message is used to indicate that the System Automation Operations REST server is shutting down.

System action

None.

Operator response

None.

System programmer response

None.

ING423I IBM Z System Automation Operations REST server is terminated

Explanation

This message is used to indicate that the System Automation Operations REST server is shut down completely.

System action

None.

Operator response

None.

System programmer response

None.

ING424I IBM Z System Automation Operations REST server is breaking

Explanation

This message is used to indicate that the System Automation Operations REST server has encountered a severe error and will shut down.

System action

The application shuts down.

Operator response

None.

System programmer response

None.

ING425E IBM Z System Automation Operations REST server is broken: &1

Explanation

This message is used to indicate that the System Automation Operations REST server is shut down completely but is unable to restart without any additional action.

The &1 variable describes the error that the System Automation Operations REST server encountered.

System action

None.

Operator response

None.

System programmer response

Check the error description that is provided with the message and take additional steps to resolve the issue.

ING500I error_text

Explanation

A program that has failed has produced this additional information regarding the error. See preceding messages.

System action

Execution probably halts. See subsequent messages.

Operator response

Contact your system programmer.

System programmer response

Assist the operator. Contact your IBM Support Center.

ING501I debug_text

Explanation

This is a generic informational message that shows the flow within the function.

System action

Execution continues.

Operator response

None.

System programmer response

None.

ING502I SA z/OS Discovery Library Adapter started date time

Explanation

This indicates the time that the SA z/OS DLA started execution.

System action

Execution continues.

Operator response

None.

System programmer response

None.

ING503I SA z/OS Discovery Library Adapter completed date time, RC=nn

Explanation

This indicates the time that the SA z/OS DLA completed execution.

System action

Execution finishes.

Operator response

If RC=0 the output file is now ready to be downloaded.

System programmer response

None.

ING504I Checksum data updated

Explanation

Following a successful run, the checksum data (member @CHCKSUM) stored in the output data set has been updated.

System action

Execution continues.

Operator response

None.

System programmer response

None.

ING505I Checksum data cleared; bad run

Explanation

The SA z/OS DLA has failed during its execution and, because it has not been able to generate a valid output book, it has cleared the checksum data.

System action

Execution continues.

Operator response

Analyze the problem and, when fixed, rerun the SA z/OS DLA to generate a valid book.

System programmer response

Assist the operator.

ING507I Data in dataset_name truncated; Increase output LRECL

Explanation

This indicates that the SA z/OS DLA tried to write a line to the output data set that was longer than the data set's LRECL.

  • The variable dataset_name identifies the fully qualified name of the data set.

System action

The book is generated with the truncated line. Depending on the nature of the truncated data, the iDML book that is generated may or may not be valid.

Operator response

Reallocate the data set with a longer LRECL and rerun the SA z/OS DLA.

System programmer response

Assist the operator.

ING508I Output of book book skipped; checksum matches

Explanation

The SA z/OS DLA has successfully executed, however the contents of the generated book are the same as the previously generated book in the same output data set. Generation of a book from the newly generated data is therefore suppressed in order to preserve discovery date and time information in the previously generated book.

  • The variable book identifies the book.

System action

Execution continues.

Operator response

None.

System programmer response

None.

ING509I Data set name is not a partitioned data set

Explanation

The specified output data set is not a partitioned data set.

  • The variable name identifies the data set.

System action

None.

Operator response

Correct the name of the data set and reissue the command.

System programmer response

None.

ING510I program Directory OPEN failed for DDName ddname, RC rc

Explanation

The program was unable to open the directory for the data set that is pointed to by the ddname. The OPEN macro gave the specified return code.

System action

Execution probably halts. See subsequent messages.

Operator response

The output data set must be a PDS—you cannot use a sequential file. Contact your system programmer.

System programmer response

Assist the operator. Contact your IBM Support Center.

ING511I program Directory READ failed for DDName ddname, RC rc RS rsn

Explanation

The program tried to read the directory for the data set that is pointed to by the ddname, but received the unexpected return and reason codes indicated.

System action

Execution probably halts. See subsequent messages.

Operator response

The output data set must be a PDS—you cannot use a sequential file. Contact your system programmer.

System programmer response

Assist the operator. Contact your IBM Support Center.

ING512I program STORAGE macro call failed for type type, RC rc

Explanation

The program received an unexpected return code from a call to the STORAGE macro for the type of storage that was requested.

System action

Execution probably halts. See subsequent messages.

Operator response

Contact your system programmer.

System programmer response

There may be other messages in the netlog or syslog at the time of the incident that will give more details. If NetView is not running REGION=0M, try increasing its region size. Contact your IBM Support Center.

ING513I program Codepage Translation Routine CUNLCNV returned RC rc, RS rsn

Explanation

The program called the CUNLCNV routine and received an unexpected return and reason code.

System action

Execution probably halts. See subsequent messages.

Operator response

Contact your system programmer.

System programmer response

Contact your IBM Support Center.

ING520I REQUEST request WAS SUCCESSFUL FOR function

Explanation

The specified request for the specified record completed successfully.

  • The variable request identifies the request.
  • The variable function identifies the function.

ING521I REQUEST request was UNSUCCESSFUL FOR function

Explanation

The specified request for the specified function failed to process.

  • The variable request identifies the request.
  • The variable function identifies the function.

ING522I TOO FEW PARAMETERS SPECIFIED

Explanation

You did not enter the minimum number of parameters required for the operand used for the INGPW command.

Operator response

Issue the command again using the correct number of parameters.

ING523I INVALID DELIMITER OF delimiter ENCOUNTERED

Explanation

You entered the specified delimiter, but the delimiter is not correct for the INGPW command.

  • The variable delimiter identifies the incorrect delimiter.

Operator response

Issue the command again using the correct syntax.

ING524I request ERROR PROCESSING VSAM DATASET

Explanation

INGPW issued a VSAM function and received an error while processing a request.

  • The variable request identifies the name of the VSAM macro request that was processing when the error occurred.

System action

The INGPW command fails and does not perform its function.

Operator response

Notify your system programmer.

System programmer response

Browse the NETLOG for the specific VSAM error message that signalled the error. Refer to the VSAM reference manuals to correct the error. If the error persists, contact IBM Software Support.

ING525I PARAMETER parameter INVALID for REQUEST command

Explanation

The specified parameter that must be passed to the specified command is incorrect.

  • The variable parameter identifies the incorrect parameter.
  • The variable command identifies the name of the command.

System action

The command fails and does not perform its function.

Operator response

If the message appears on an operator panel, correct the parameter and re-enter the command. If necessary, view the help for the INGPW command to assist in entering a valid command. If the message appears in the NETLOG, notify your system programmer.

System programmer response

Perform the problem determination function on the command. Find the error in the NETLOG and contact IBM Software Support.

ING526I EXPECTED PARAMETERS MISSING FOR REQUEST commandrequest

Explanation

The specified parameter that must be passed to the specified command is missing.

  • The variable command identifies the incorrect command.
  • The variable request identifies the name of the request.

System action

The command fails and does not perform its function.

Operator response

If the message appears on an operator panel, correct the input and re-enter the command. If necessary, view the help for the INGPW command to assist in entering a valid command. If the message appears in the NETLOG, notify your system programmer.

System programmer response

Perform the problem determination function on the command. Find the error in the NETLOG and contact IBM Software Support.

ING527I EXPECTED PARAMETERS INVALID FOR REQUEST command - parameter = value

Explanation

The parameter that must be passed to the specified command is incorrect.

  • The variable command identifies the name of the command
  • The variable parameter identifies the name of the parameter
  • The variable value identifies the value of the parameter that is incorrect.

Explanation

The command fails and does not perform its function.

Operator response

If the message appears on an operator panel, correct the input and re-enter the command. If necessary, view the help for the INGPW command to assist in entering a valid command. If the message appears in the NETLOG, notify your system programmer.

System programmer response

Perform the problem determination function on the command. Find the error in the NETLOG and contact IBM Software Support.

ING529I p1 p2 p3 p4 p5

Explanation

The report is the response to an INGPW request.

Operator response

Refer to the INGPW reference manuals for details.

ING530I operator NOT AUTHORIZED TO request RECORD FOR user owner

Explanation

operator is not authorized to execute specified INGPW request. The execution of the request is rejected.
  • The variable operator identifies the NetView Operator attempting to execute the INGPW request.
  • The variable request identifies the attempted INGPW operation.
  • The variable user identifies the userid of the INGPW request for which password maintenance services are required.
  • The variable owner identifies the owning entity for which password maintenance services are required.

System action

Processing of the INGPW request fails.

Operator response

Contact your system programmer to obtain the necessary authorization to execute the command.

System programmer response

Examine the SYSLOG for ICH408I messages giving more details about the effective ACEE and required permissions.

Evaluate the need the operator has for the INGPW request. If authorization should be granted, notify the security administrator.

Command INGPW requires the following permissions to the resource ING.PW.user.owner in the class SYSAUTO:

   
READ for INGPW READ request
UPDATE for INGPW UPDATE request
CONTROL for INGPW INIT and REGEN requests
ALTER for INGPW DELETE request

ING531I PASSWORD IS TOO length

Explanation

You specified a new password with an incorrect length on the INGPW command. Passwords must be a minimum of 4 characters and a maximum of 20 characters.

  • The variable length contains the value LONG or SHORT and explains why there are too many or too few characters.

System action

The INGPW command fails.

Operator response

Reissue the command with a new password of the correct length.

ING532I NETVIEW PASSWORD DATASET NOT ALLOCATED

Explanation

The password data set is not allocated in the Product Job Control Language (JCL).

Operator response

Notify your system programmer.

System programmer response

Add an INGPSWD DD statement to the procedure to allocate the VSAM data set.

ING533I ERROR OPENING PASSWORD DATASET

Explanation

INGPW cannot open the INGPSWD DD password data set.

Operator response

Notify your system programmer.

System programmer response

Ensure that the INGPSWD DD password data set is allocated correctly and is defined to the Product.

ING534I RECORD FOR data1 data2 NOT FOUND

Explanation

The information for the specified data cannot be found.

  • The variable data1 identifies the unique data identifer
  • The variable data2 identifies a second unique data identifier.

Operator response

If the data specified is a user ID and an owner ID, notify your system programmer. If the data specified relates to another function, modify any filter settings that are in effect. If problem persists, notify your system programmer.

System programmer response

If the data specified is a user ID and an owner ID, use the INIT option to specify a password record for the user. For any other data, browse the NETLOG for informational messages, and ensure that the relevant function has initialized successfully.

ING535I CURRENT PASSWORD IS current

Explanation

INGPW retrieved the specified current password from the password data set.

  • The variable current identifies the current password.

Operator response

Notify your system programmer.

System programmer response

Ensure that the message is suppressed so that it does not appear in the log or on an operator terminal.

ING536I CURRENT/NEW PASSWORD is current/new

Explanation

The INGPW command randomly generated the specified new password because the current password was defined with an expiration date and is expired, or new password was requested by the INGPW REGEN command.

  • The variable current identifies the current password.
  • The variable new identifies the new password.

Operator response

Notify your system programmer.

System programmer response

Automation Product suppresses this message, but the routines that perform cross-product logons can still use it. Change the external product password for the affected user and update the record in the password dataset using INGPW UPDATE command, if required.

ING537I CURRENT PASSWORD IS password - ERROR CREATING NEW PASSWORD

Explanation

This message displays the current password. The password record was defined with an expiration date and is expired, but the INGPW command cannot generate and store a new one because of a VSAM error.

  • The variable password identifies the current password.

Operator response

Notify your system programmer.

System programmer response

The Automation Product suppresses this message, but the routines that perform cross-product logons can still use it. Browse the NETLOG for the specific VSAM error message that signalled the error. Refer to the VSAM reference manuals to correct the error. If the error persists, contact IBM Software Support.

ING538I NEW PASSWORD UPDATE FAILED - VSAM ERROR

Explanation

VSAM could not update the current password held in the INGPSWD DD password data set to the new password because of a VSAM error.

Operator response

Notify your system programmer.

System programmer response

Browse the NETLOG for the specific VSAM error message that signalled the error. Refer to the VSAM reference manuals to correct the error.

ING539I NEW PASSWORD UPDATE FAILED - NO NEW PASSWORD

Explanation

VSAM cannot update the current password held in the password data set to the new password because no password has been assigned.

Operator response

Notify your system programmer.

System programmer response

Wait until the password expires before issuing the UPDATE parameter, or use the REGEN parameter to generate a new password.

ING600I LOOPING ADDRESS SPACE SUPPRESSION REPORT

Explanation

This is a multiline message that is generated whenever the Looping Address Space Suppression Monitor runs. It contains information about the results of the query to OMEGAMON the routine has made and details of any apparently looping address spaces that are found, along with details of any planned corrective actions.

This message only appears in the Netlog and is not available for automation.

System action

The monitor runs again after the appropriate interval, any corrective actions indicated will be taken.

Operator response

None.

System programmer response

None.

ING601E LOOPING ADDRESS SPACE DETECTED: jobname stepname (ASID asid)

Explanation

The Looping Address Space Suppression monitor has found an address space that appears to be in a CPU intensive loop and has been instructed to issue a warning message. The variables identify the address space in question.

System action

The monitor takes any corrective actions specified by your policy for it. It then runs again after the appropriate interval. At this point it may take more actions, including issuing another warning message.

Operator response

Investigate. Notify your system programmer.

System programmer response

Fix the problem. If it is a known false positive result, update your policy to ignore it.

ING602I LOOPING ADDRESS SPACE DIAGNOSTIC REPORT

Explanation

When the Looping Address Space Suppression monitor executes a DIAG instruction it produces a diagnostic report. The report is a multiline message and is only available in English.

The report is generated through OMEGAMON Inspect functionality and indicates where the instruction pointer was within the looping address during a small sampling window. For address spaces that are in a tight CPU loop, this will identify the portion of the code where the loop is present.

The report identifies the program, the load module (and the job the load module is a part of, if it is not the same one), and then gives a list of CSECTs and offsets along with a percentage indicating how often the looping job was detected at this portion of the code.

System action

Execution continues.

Operator response

Notify your system programmers.

System programmer response

Notify the people responsible for looping the application. If it is a known false positive result, update your policy to ignore it.

ING800I VERIFYING type-model HARDWARE AUTOMATION INTERFACE

Explanation

A check of the type and model of the hardware automation interface is performed.

  • The variable type-model shows the type and model of the hardware being verified.

System action

The verification process for the specified processor is starting.

Operator response

None.

System programmer response

None.

ING801I AUTOMATION INTERFACE NOT SUPPORTING type-model HARDWARE

Explanation

Verification determined that the processor hardware is not supported

  • The variable type-model shows the type and model of the hardware.

System action

None.

Operator response

None.

System programmer response

None.

ING802I HARDWARE INTERFACE COMPONENT HSAET32 CANNOT BE ACTIVATED

Explanation

An error was reported by the HSAET32 internal command. The command that establishes and activates the hardware interface failed.

System action

None.

Operator response

None.

System programmer response

Check the netlog or the system log for HSAxxxx messages about the problem.

ING803I HARDWARE INTERFACE AUTO OPERATOR autotask CANNOT BE STARTED

Explanation

The named autotask failed to start. The hardware interface cannot be used.

  • The variable autotask shows the autotask that could not be started.

System action

None.

Operator response

None.

System programmer response

Check the netlog for additional messages. Correct the problem and activate the autotask again. This will initialize the hardware interface.

ING804I HARDWARE AUTOMATION INTERFACE OF type-model PROCESSOR VERIFIED

Explanation

The verification for the specified processor has ended.

  • The variable type-model shows the type and model of the hardware.

System action

None.

Operator response

None.

System programmer response

None.

ING805I requestor REQUESTS TO CONNECT TO CPC cpcaddr

Explanation

The hardware interface tries to establish a connection to the indicated processor hardware.

  • The variable requestor shows the originator of the request.
  • The variable cpcaddr shows the address of the CPC.

System action

Processing continues.

Operator response

None.

System programmer response

None.

Module

INGRVX80

class

40.

ING806E COMMUNICATION WITH CPC cpcaddr CANNOT BE ESTABLISHED

Explanation

A failure occurred while the processor hardware was contacted through the hardware interface.

  • The variable cpcaddr shows the address of the CPC that a session could not be established with.

System action

None.

Operator response

None.

System programmer response

Check the netlog for AOFAxxxx messages to obtain more information, for example, the available condition and sense codes. Correct the problem and restart the session to the CPC.

Module

INGRVX80

ING807I OPERATOR opid IS WAITING FOR SYSOPS INITIALIZATION TO COMPLETE

Explanation

The operator task is currently executing the clist INGRX810 or INGRX805 and halts processing until the NetView common global variable AOFCOMPL has a value of YES, which indicates that SA z/OS SysOps initialization is complete. This halt is a temporary condition. Processing continues once SA z/OS SysOps is initialized. Message ING808I is issued to indicate that the continuation of the clist execution for the operator task.

  • The variable opid shows the name of the affected NetView operator task.

System action

None.

Operator response

None.

System programmer response

In situations when SA z/OS SysOps cannot initialize, you can use the STOP FORCE command to end the current command of such an operator. For more information about the SA z/OS common global variable AOFCOMPL, see IBM Z System Automation Customizing and Programming.

Module

INGRX805, INGRX810

ING808I OPERATOR opid ENDED TO WAIT FOR SYSOPS INITIALIZATION

Explanation

The operator task continues to execute the clist INGRX810 or INGRX805 after processing was halted. Message ING807I was issued to indicate the halt condition for the operator task.

  • The variable opid shows the name of the affected NetView operator task.

System action

None.

Operator response

None.

System programmer response

None.

Module

INGRX805, INGRX810

ING809I BCPII EVENT ERROR(rc) BETWEEN CPC cpcaddr AND domain/operator. LASTS(stime)

Explanation

A general BCPii event wait occurred. The BCPii connection will be terminated.

The variable rc is the HwmcaWaitEvent return code passed back from the System z API to the caller (INGHWCOM), while waiting for event data from the Support Element.

The variable cpcaddr is the Processor name defined as SA-PDB/Connection Flag/CPC Name of the processor in SNA netid.nau format. The connection flag indicates:
L
BCPii local connection. SA z/OS targets its own CPC.
R
BCPii connection to a remote CPC using a HMC for routing.
.
The Connection Flag information is not available.

The variable domain is the NetView domain name of the BCPii connection.

The variable operator is the operator task name of the event session for the affected BCPii connection.

The variable stime is the Date/Time stamp of the last successful connection start in the format yymmddhhmmss.

System action

The BCPii session terminates.

Operator response

None.

System programmer response

For return code information, refer to the condition codes table in the appendix section Internal Transport Services "0Bx00xxx" of IBM Z System Automation Messages and Codes.

Module

INGCHW0E

Classes

40

ING810I requestor REQUESTS TO DISCONNECT FROM CPC cpcaddr

Explanation

The hardware interface terminates the communication with the indicated processor hardware.

  • The variable requestor shows the originator of the request.
  • The variable cpcaddr shows the address of the CPC.

System action

Processing continues.

Operator response

None.

System programmer response

None.

Module

INGRVX80

class

40.

ING811I BCPII CONNECTION HEARTBEAT BETWEEN CPC cpcaddr AND domain/operator FAILED. LASTS(stime)

Explanation

For a period of 4 minutes, the Support Element of the addressed CPC has not responded to the BCPii heartbeat request of the operator task running in the NetView domain. The BCPii event connection is no longer working.

  • The variable cpcaddr is the Processor name defined as SA-PDB / Connection Flag / CPC Name of the processor in SNA netid.nau format. The Connection Flag indicates:
    L
    BCPii local connection. SA z/OS targets its own CPC.
    R
    BCPii connection to a remote CPC using a HMC for routing.
    .
    The Connection Flag information is not available.
  • The variable domain is the NetView domain name of the BCPii connection.
  • The variable operator is the operator task name of the event session of the affected BCPii connection.
  • The variable stime is the Date/Time stamp of the LAST successful connection start in the format yymmddhhmmss.

System action

The BCPii connection is internally restarted. If the restart is successful, message ING812I is issued. If the restart fails, message ING813E is issued with additional information.

Operator response

None.

System programmer response

None.

Module

INGCHW0E

Classes

40.

ING812I BCPII LINK BETWEEN CPC cpcaddr AND domain/operator RE-ESTABLISHED. NEW LASTS(stime)

Explanation

After a BCPii event session heartbeat failure, the BCPii connection has been successfully restarted.

  • The variable cpcaddr is the Processor name defined as SA-PDB / Connection Flag / CPC Name of the processor in SNA netid.nau format. The Connection Flag indicates:
    L
    BCPii local connection. SA z/OS targets its own CPC.
    R
    BCPii connection to a remote CPC using a HMC for routing.
    .
    The Connection Flag information is not available.
  • The variable domain is the NetView domain name of the BCPii connection.
  • The variable operator is the operator task name of the event session for the affected BCPii connection.
  • The variable stime is the Date/Time stamp of the LAST successful connection start in the format yymmddhhmmss. The connection start initializes the LASTS value and is therefore prefixed with NEW.

System action

Processing continues.

Operator response

None.

System programmer response

For additional information, refer to the event handler asynchronous response report AOFA0998.

Module

INGCHW0E

Classes

40.

ING813E BCPII CONNECTION RECOVERY FROM domain/operator TO CPC cpcaddr FAILED. RSN(rsncode) LASTS(stime)

Explanation

After a BCPii event session heartbeat failure between the targeted CPC and the operator task of the NetView domain, the internal BCPii connection restart failed.

  • The variable cpcaddr is the Processor name defined as SA-PDB / Connection Flag / CPC Name of the processor in SNA netid.nau format. The Connection Flag indicates:
    L
    BCPii local connection. System Automation targets its own CPC.
    R
    BCPii connection to a remote CPC using a HMC for routing.
    .
    The Connection Flag information is not available.
  • The variable domain is the NetView domain name of the BCPii connection.
  • The variable operator is the operator task name of the event session for the affected BCPii connection.
  • The variable rsncode is the reason code. For full details, refer to the appendix section Internal Transport Services "0Bx00xxx" of IBM Z System Automation Messages and Codes.
  • The variable stime is the Date/Time stamp of the LAST successful connection start in the format yymmddhhmmss.

System action

The BCPii connection to the addressed CPC is closed.

Operator response

Since the BCPii connections are monitored by SA z/OS or GDPS, a start of a failing connection is retried automatically at each defined monitor cycle time. No further action is required. If the heartbeat failure message ING811I was preceded by a ING814E message, additional error cause and reason information is available.

System programmer response

None.

Module

INGCHW0E

Classes

40.

ING814E BCPII CONNECTION TO domain/operator ABORTED BY THE CPC cpcaddr SUPPORT ELEMENT. CAUSE(cause_type) REASON(rsn_str) LASTS(stime)

Explanation

The CPC Support Element has sent an 'Application_Ended' event over an active BCPii connection to indicate the communication with the NetView domain/operator is about to end.

  • The variable cpcaddr is the Processor name defined as SA-PDB / Connection Flag / CPC Name of the processor in SNA netid.nau format. The Connection Flag indicates:
    L
    BCPii local connection. SA z/OS targets its own CPC.
    R
    BCPii connection to a remote CPC using a HMC for routing.
    .
    The Connection Flag information is not available.
  • The variable domain is the NetView domain name of the BCPii connection.
  • The variable operator is the operator task name of the event session for the affected BCPii connection.
  • The variable cause_type is the action that caused the console application to end. Depending on the type given, a possible console application outage time can be predicted.
    SHUTDOWN_CONSOLE
    Long outage, manual intervention is required to recover.
    RESTART_APPLICATION
    Medium outage of 10 - 20 minutes can be expected until the console application is fully operational.
    RESTART_CONSOLE
    Medium outage of 10 - 20 minutes can be expected until the console device and console application are fully operational again.
    UNKNOWN
    The type code in the event data is unknown. Long outage, manual intervention may be required to recover.
  • The variable rsn_str refers to the issuer that caused the console application to end.
    USER
    A logged-on SE user.
    AUTOMATION
    An automation application.
    OTHER
    Remote action such as SE reboot from an HMC.
    UNKNOWN
    The reason code in the event data is unknown.
  • The variable stime refers to the Date/Time stamp of the LAST successful connection start in the format yymmddhhmmss.

System action

Processing continues.

Operator response

Use the cause_type information of the message to determine the BCPii connection outage time that can be expected. In case of a long outage time, consider the SUSPEND command for the BCPii connection.

System programmer response

None.

Module

INGCHW0E

Classes

40.

ING815I BCPII CONNECT FROM domain/operator TO CPC cpacaddr RETURNED: resp

Explanation

Request to contact the CPC Support Element of cpcaddr over the BCPii from domain/operator returned a response of resp.

  • The variable cpcaddr is the Processor name defined as SA-PDB / Connection Flag / CPC Name of the processor in SNA netid.nau format. The Connection Flag indicates:
    L
    BCPii local connection. SA z/OS targets its own CPC.
    R
    BCPii connection to a remote CPC using a HMC for routing.
    .
    The Connection Flag information is not available.
  • The variable domain is the NetView domain name of the BCPii connection.
  • The variable operator is the operator task name of the event session for the affected BCPii connection.
  • The variable resp is:
    SUCCESS
    SE connection established.
    ERROR(rsncode)
    Failure to contact the SE.
    rsncode
    For information about the reason code, please refer to the appendix section Condition Codes in Response Messages, Error Strings, Condition Codes of IBM Z System Automation Messages and Codes. Select the table that lists the reason code together with the error description.

System action

If the connect was successful, session initialization continues with CPC configuration discovery. Message ING817I will be issued when this is complete. If the connect processing failed, no further session initialization is done and processing stops.

When a BCPii connection monitoring interval is defined to SA z/OS or GDPS HMC monitoring is used for cpcaddr, the connect requests will be retried automatically.

Operator response

None.

System programmer response

None.

Module

INGCHW0A

Classes

40.

ING816I BCPII AWAIT CMD SESSION TERMINATION TO CPC cpcaddr IN delay SECONDS: DOMAIN(domain) OPID(operator) CMD(cmd) LASTS(stime)

Explanation

The HW event handler for CPC (cpcaddr) session returned an error and the asynchronous session terminates. In order to perform a save memory cleanup, an ongoing HW command for the CPC running in task (operator) needs to be terminated first. Wait for (delay) seconds for normal command termination.

  • The variable cpcaddr is the Processor name defined as SA-PDB / Connection Flag / CPC Name of the processor in SNA netid.nau format. The Connection Flag indicates:
    L
    BCPii local connection. SA z/OS targets its own CPC.
    R
    BCPii connection to a remote CPC using a HMC for routing.
    .
    The Connection Flag information is not available.
  • The variable cmd is the command token of the currently executed HW command.
  • The variable domain is the NetView domain name of the BCPii connection.
  • The variable delay is the time in seconds the command session is given to end.
  • The variable operator is the operator task name of the command session using the affected BCPii connection.
  • The variable stime is the Date/Time stamp of the LAST successful connection start in the format yymmddhhmmss.

System action

Processing continues.

Operator response

None.

System programmer response

None.

Module

INGCHW0M

Classes

40.

ING817I BCPII DISCOVERY OF cpcaddr FOR domain/operator RETURNED: resp

Explanation

The initial discovery request from domain/operator for configuration information of cpcaddr ended with a response of: resp

  • The variable cpcaddr is the Processor name defined as SA-PDB / Connection Flag / CPC Name of the processor in SNA netid.nau format. The Connection Flag indicates:
    L
    BCPii local connection. SA z/OS targets its own CPC.
    R
    BCPii connection to a remote CPC using a HMC for routing.
    .
    The Connection Flag information is not available.
  • The variable domain is the NetView domain name of the BCPii connection.
  • The variable operator is the operator task name of the event session for the affected BCPii connection.
  • The variable resp is:
    SUCCESS NEW LASTS(stime)
    All required CPC configuration information has been retrieved. The BCPii connection is now fully operational.
    stime
    Date/Time stamp of the LAST successful connection start in the format yymmddhhmmss. The connection start initializes the LASTS value and is therefore prefixed with NEW.
    FFDC(ffdc_id)
    Failure to retrieve the required CPC configuration information. The BCPii session cannot be used.
    ffdc_id
    The four character ID string represents the exit point from the discovery processing and can be used by IBM to locate the failing retrieval.

System action

Processing continues.

Operator response

None.

System programmer response

None.

Module

INGCHW0A

Classes

40.

ING818I BCPII LINK BETWEEN domain/operator AND CPC cpcaddr IS NOW TERMINATED. NEW STATUS(connstat) OLD LASTS(stime)

Explanation

The connection to the cpcaddr has been successfully closed from the domain/operator side. Before applications can use the connection again, they must restart it. If the connection was closed, because of a session suspension, before restarting it, the session must be resumed.

  • The variable cpcaddr is the Processor name defined as SA-PDB / Connection Flag / CPC Name of the processor in SNA netid.nau format. The Connection Flag indicates:
    L
    BCPii local connection, SA z/OS targets its own CPC.
    R
    BCPii connection to a remote CPC using a HMC for routing.
    .
    The Connection Flag information is not available.
  • The variable domain is the NetView domain name of the BCPii connection.
  • The variable operator is the operator task name of the event session for the affected BCPii connection.
  • The variable connstat is the new connection-session status:
    NOT_CONNECTED
    Connection-session can be restarted again.
    SUSPENDED
    Connection is suspended from normal usage. It is required to resume it first, before restarting a BCPii session over this connection.
  • The variable stime is the Date/Time stamp of the LAST successful connection start in the format yymmddhhmmss. Since the connection is no longer active the LASTS is prefixed with OLD.

System action

Processing continues.

Operator response

None.

System programmer response

None.

Module

INGCHW0C, INGCHW0D

Classes

40.

ING819I BCPII ROUTE domain/operator - cpcaddr cstat LASTS(stime)

Explanation

The BCPii connection monitor, configured for CPC cpcaddr has detected a connection status of cstat. Note that connection monitoring can be suppressed by specifying an interval value of 'NONE' in the PDB processor entry for a CPC. Processors specified in the GEOPLEX definitions of GDPS are automatically excluded from monitoring since GDPS provides the HMC Monitor to supervise BCPii connections.

For the eligible CPCs, the BCPii connection monitor starts running after the SA z/OS agent initially activates the configured BCPii connections. The same applies if changes in the processor definitions, affecting the current or new BCPii connections are activated with an ACF REFRESH or ACF COLD at SA z/OS agent runtime.

  • The variable domain is the NetView domain name of the BCPii connection.
  • The variable operator is the operator task name of the event session for the affected BCPii connection.
  • The variable cpcaddr is the Processor name defined as SA-PDB / Connection Flag / CPC Name of the processor in SNA netid.nau format. The Connection Flag indicates:
    L
    BCPii local connection. SA z/OS targets its own CPC.
    R
    BCPii connection to a remote CPC using a HMC for routing.
    .
    The Connection Flag information is not available.
  • The variable cstat is:
    CONNECTED
    The BCPii connection is established.
    NOT_CONNECTED
    No BCPii connection is active.
  • The variable operator is the operator task name of the event session for the monitored BCPii connection. If cstat is NOT_CONNECTED the LASTS field value is a dot.
  • The variable stime is the Date/Time stamp of the LAST successful connection Start in the format yymmddhhmmss. If cstat is NOT_CONNECTED the LASTS field value is a dot.

System action

If the connection status is NOT_CONNECTED, the monitor will try to start it. If the connection status is CONNECTED, no extra processing is done. In any case, the next monitor run is scheduled, using the configured monitor interval to set up a NetView timer for this monitor run.

Operator response

When needed, the BCPii connection monitoring can be stopped by using the SA z/OS SETTIMER command dialog. Look for the 'AOFRASCD HWOPER01 INGRX830 1' cmd string and perform the delete action of the associated TIMER-ID in the dialog.

System programmer response

None.

Module

INGRX830

Classes

40.

ING820I BCPII SESSION MANAGEMENT FUNCTION LIMITATION IN FAVOR OF APPLICATION appl_designator WAS REQUESTED BY oper ON DOMAIN domain.

Explanation

Command INGHWSRV BCPIIPRIO was issued to block BCPii session restarts from interrupting important application operation.
Message variables:
appl_designator
Name of the favored application.
oper
NetView operator or autotask, who issued the command.
domain
NetView domain name.

System action

The BCPii session management function operations are only limited.

Operator response

None.

System programmer response

None.

Module

INGRX815

Classes

40.

ING821I BCPII SESSION MANAGEMENT FUNCTION LIMITATION RELEASED BY oper ON DOMAIN domain

Explanation

Command INGHWSRV BCPIIPRIO was issued to restore normal SA-BCPII session management operation.
Message variables:
oper
NetView operator or autotask, who issued the command.
domain
NetView domain name.

System action

The BCPii session management function runs in normal mode.

Operator response

None.

System programmer response

None.

Module

INGRX815

Classes

40.

ING822I BCPII SESSION MANAGEMENT TO PROCESSOR processor IS CURRENTLY LIMITED BY appl_designator ON domain.

Explanation

BCPii session re-cycle operation was blocked. The management operation that terminates the session is not executed. Command INGHWSRV can be used to restore normal operation mode for the session which was previously limited in favor of appl_designator.
Message variables:
processor
Target processor of the blocked session. For application GDPS, only processors defined in the GEOPLEX domain/options are affected.
appl_designator
Name of the blocking application.
domain
NetView domain name.

System action

The BCPii session management function continues without terminating the session.

Operator response

None.

System programmer response

None.

Module

INGRX806, INGRVX80

Classes

40.

ING823I THE CURRENT BCPII SESSION MANAGEMENT PRIORITY IS SET TO appl_designator ON DOMAIN domain.

Explanation

Displays the current BCPII session management priority setting of the domain. Command INGHWSRV BCPIIPRIO can be used to change this setting.
Message variables:
appl_designator
Name of the application that has priority, or NONE.
domain
NetView domain name.

System action

None.

Operator response

None.

System programmer response

None.

Module

INGRX815

Classes

40.

ING824I requestor requests to connect to CPC cpc which is not in scope with the local processor

Explanation

The BCPii hardware interface tries to connect to the indicated processor hardware that is defined with a different connection scope.
  • The requestor variable shows the originator of the request.
  • The cpc variable shows the address of the target CPC.

System action

Processing continues.

Operator response

Contact your system programmer.

System programmer response

Verify your automation policy definitions for the processor cpc. If connection to the CPC is required for the application, make sure that SA policy for both local and remote processors contain equal Connection Scope definitions. Otherwise, verify the application connecting to the CPC and insure correct application configuration.

ING825I GDPS can now request control of INTERNAL CPC connections

Explanation

The connection to the CPC's local Support Element is operational. GDPS can now request and later return exclusive session control of all processors that have 'INTERNAL' specified as their connection protocol in the active SA policy. In case a processor has multiple connection protocols specified, the exclusive session control applies only to the 'INTERNAL' session.

Exclusive session control means that starting, stopping, and monitoring of the session is performed by GDPS. The connection test to the local CPC is always tried by SA, independently from GDPS. However, monitoring and termination of the session to the local CPC can be controlled by GDPS.

This message is issued only after an SOCNTL/ACF load processing and processor definitions have been initially loaded or refreshed. Another condition for this message to occur is that the SA.GDPS tower has been set in the active CNMSTYLE definitions.

System action

None.

Operator response

None.

System programmer response

None.

Module

INGRX806

Classes

40

ING826I GDPS has control of the INTERNAL connection to CPC cpc_name (netid.nau)

Explanation

GDPS, which is configured on this SA agent instance, has indicated to take exclusive session control of the INTERNAL protocol connection to the named CPC. This control includes the monitoring of the INTERNAL connection.
  • The cpc_name variable shows the Entry Name of the processor entry as defined in the processor info policy.
  • The netid variable shows the Network Name of the processor entry as defined in the processor info policy.
  • The nau variable shows the HW Resource Name of the processor entry as defined in the processor info policy.

System action

The SA connection monitoring, if configured in the processor policy, stops.

Operator response

None.

System programmer response

None.

Module

INGRX830

Classes

40

ING827I Automation has control of the INTERNAL connection to CPC cpc_name (netid.nau)

Explanation

SA now has session control of the named CPC, which is configured on this SA agent instance. INTERNAL protocol connection monitoring, if configured, is done by SA.
  • The cpc_name variable shows the Entry Name of the processor entry as defined in the processor info policy.
  • The netid variable shows the Network Name of the processor entry as defined in the processor info policy.
  • The nau variable shows the HW Resource Name of the processor entry as defined in the processor info policy.

System action

The SA connection monitoring, if configured in the processor policy, starts.

Operator response

None.

System programmer response

None.

Module

INGRX830

Classes

40

ING828I GDPS currently cannot use the local SE connection

Explanation

SA tried to establish an INTERNAL connection to the local Support Element (SE), but an error occurred. A local SE connection must be possible before remote CPC connections are made. The used netid.nau address was not confirmed by the SE to be the local address due to the connection error.

This message is issued only after an SOCNTL/ACF load processing and processor definitions have been initially loaded or refreshed. Another condition for this message to occur is that the SA.GDPS tower has been set in the active CNMSTYLE definitions.

System action

If the local SE connection remains under SA control and has a connection monitor interval configured, SA retries the local SE connection.

If GDPS requested and got control of the local SE connection, its connection monitoring logic retries the local SE connection.

Operator response

None.

System programmer response

If the SA-BCPii messages in the netlog do not show which failing SE address is the local one, use the NetView QRYGLOBL command to display Cglobal ING.0HWSERIAL. The serial number value is the one of your local CPC. Use an HMC where your CPC with this serial number is defined. The CPC/SE network details show the netid and nau address values of your local SE.

Module

INGRX806

Classes

40

ING830I BCPii CONNECTION TO domain/operator IS ABOUT TO BE STOPPED BY THE CPC cpcaddr CONSOLE. REMAINING_SECONDS(seconds) DELAY_TOLERANCE(tolerance_value) INTENDED_ACTION(shutdown_type) REASON(rsn_str) INVOKER(invoker_name) COMPONENT(component_name) LASTS(stime)

Explanation

This message announces a planned outage for an IBM Z console connection. Only the active BCPii session is affected if the intended action doesn’t target the alternate console. Operators and automation applications can use the information provided in the message text to determine end-to-end connection and outage details, as well as outage mitigation actions.
  • The variable domain is the NetView domain name of the BCPii connection.
  • The variable operator is the operator task name of the event session for the affected BCPii connection.
  • The variable cpcaddr is the processor name defined as SA-PDB / Connection Flag / CPC Name of the processor in SNA netid.nau format. The Connection Flag indicates:
    L
    BCPii local connection. SA z/OS targets its own CPC.
    R
    BCPii connection to a remote CPC using an HMC for routing.
    .
    The Connection Flag information is not available.
  • The variable seconds specifies the number of seconds remaining until the outage begins.
  • The variable tolerance_value can be one of the following settings:
    0 (numeric 0)
    The outage cannot be delayed.
    >0 (positive numeric)
    Number of seconds left until the outage begins.
    <0 (negative numeric)
    Outage will begin when there are no applications that require to delay the outage.
  • The variable shutdown_type can have one of the following values:
    SHUTDOWN_CONSOLE
    The console will be powered-off and it will take manual intervention for a power-on.
    RESTART_APPLICATION
    The console application will be stopped and will automatically be restarted.
    RESTART_CONSOLE
    The console will be stopped and will automatically be restarted.
  • The variable rsn_str refers to the reason of the planned outage. The following values are returned:
    FIRMWARE_UPDATE
    A firmware update.
    PROBLEM_RECOVERY
    A recovery from a problem.
    REPAIR
    A repair action.
    SWITCH
    A primary and alternate console switch.
    USER
    A logged-on user action.
    OTHER
    None of the above reasons. 
  • The variable invoker_name indicates the invoker that initiated the outage request. It has the following values:
    USER
    A logged-on user.
    AUTOMATION
    An automation interface.
    FIRMWARE
    The console firmware.
    OTHER
    Some other action.
  • The variable component_name specifies the name of the console application component that caused the HWMCA SHUTDOWN event to be issued, which System Automation translates into this message.
  • The variable stime refers to the Date/Time stamp of the last successful connection start in the format yymmddhhmmss.

System action

Processing continues.

Operator response

Use the shutdown_type information of the message to estimate a BCPii connection outage time that can be expected. For a long outage, use the INGHWSRV SUSPEND command to suspend the session. For a transient outage, use the INGHWSRV SUSPEND HOLD command to put the session in HOLD mode. Without any action, the console session will end at outage begin. Message ING814E will be issued, and System Automation terminates the connection from its end.

System programmer response

None.

Module

INGCHW0E

Classes

40

ING831I BCPII CONNECTION BETWEEN domain/operator AND THE CPC cpcaddr CONSOLE IS OPERATIONAL AGAIN

Explanation

After a planned outage period, the targeted primary IBM Z® console has sent an HWMCA_STARTED_EVENT, which indicates that the connection for the current active session is operational again.
  • The variable domain is the NetView domain name of the BCPii connection.
  • The variable operator is the operator task name of the event session for the affected BCPii connection.
  • The variable cpcaddr is the processor name defined as SA-PDB / Connection Flag / CPC Name of the processor in SNA netid.nau format. The Connection Flag indicates:
    L
    BCPii local connection. SA z/OS targets its own CPC.
    R
    BCPii connection to a remote CPC using an HMC for routing.
    .
    The Connection Flag information is not available.

System action

Processing continues.

Operator response

Use the INGHWSRV RESUME command to fully reestablish the IBM Z console session. Without any action, the console connection remains in HOLD mode, which will prevent the session from being operational for commands and events.

System programmer response

None.

Module

INGCHW0E

Classes

40

ING832I BCPII CONNECTION TO domain/operator ENDED BY THE CPC cpcaddr CONSOLE. CAUSE(cause_type) REASON(rsn_str) LASTS(stime)

Explanation

The CPC console has sent an 'Application_Ended' event over its BCPii connection to indicate the communication with the NetView domain/operator is now ending. This message is the equivalent to message ING814E, but since the session is in HOLD mode, it will be internally monitored and re-connected as soon as the 'Application_Started' event is received.
  • The variable domain is the NetView domain name of the BCPii connection.
  • The variable operator is the operator task name of the event session for the affected BCPii connection.
  • The variable cpcaddr is the processor name defined as SA-PDB / Connection Flag / CPC Name of the processor in SNA netid.nau format. The Connection Flag indicates:
    L
    BCPii local connection. SA z/OS targets its own CPC.
    R
    BCPii connection to a remote CPC using an HMC for routing.
    .
    The Connection Flag information is not available.
  • The variable cause_type can have one of the following values:
    SHUTDOWN_CONSOLE
    The console will be powered-off and it will take manual intervention for a power-on.
    RESTART_APPLICATION
    The console application will be stopped and will automatically be restarted.
    RESTART_CONSOLE
    The console will be stopped and will automatically be restarted.
    UNKNOWN
    The type code in the event data is unknown.
  • The variable rsn_str refers to the issuer that caused the console communication to end. The following values are returned:
    USER
    A logged-on console user.
    AUTOMATION
    An automation application.
    OTHER
    Remote action such as SE reboot from an HMC.
    UNKNOWN
    The reason code in the event data is unknown.
  • The variable stime refers to the Date/Time stamp of the last successful connection start in the format yymmddhhmmss.

System action

Processing continues.

Operator response

Use the cause_type information of the message to estimate a BCPii connection outage time that can be expected. As the session is in HOLD mode, it will recover automatically as soon as the 'Application_Started' event is received. All event filters set before the outage will still be active. If you need to regain manual control, you can issue an INGHWSRV cpcname RESUME command, followed by an INGHWSRV cpcname FORCE command. Note that the FORCE command may return an error in case of no console connection. However, the SA-BCPii session data is cleared. If you consider the console outage as over, you can try command INGHWSRV cpcname CONNECT to start a new console session. Note that in this case no event filters are set.

System programmer response

None.

Module

INGCHW0E

Classes

40

ING920I COMMAND cmd ISSUED BY jobname INHIBITS OTHER COMMANDS/JOBS FROM EXECUTING

Explanation

SA z/OS found a command or job that inhibits at least one other command from completing its execution. The policy defined during customization does not allow for abending the command.

  • The variable cmd shows the command name.
  • The variable jobname shows the name of the job.

System action

Processing continues.

Operator response

Inform your system programmer.

System programmer response

Check the execution time of the command. If the execution time is not reasonable, add the command to the policy along with a reasonable execution time. This allows the cancelation of the job if necessary.

Module

INGRX744

Classes

40, 43.

propd

YES

ING921I THE JOB jobname IS BEING ABENDED DUE TO A HUNG COMMAND DETECTION ON RESOURCE resource

Explanation

SA z/OS detected a job that owns a resource that inhibits commands from executing successfully. The job is abended with U2047 RSNC9D5C740 to avoid lockouts of other commands.

  • The variable resource shows the major and minor name of the resource.
  • The variable jobname shows the name of the job.

System action

Automation abends the indicated job.

Operator response

None.

System programmer response

None.

Module

INGRX744

Classes

40, 43.

propd

YES

ING922I DUE TO COMMAND FLOOD DETECTION THE JOB job IN asid ON system IS BEING ABENDED

Explanation

SA z/OS detected a job that is flooding the master or console address space with commands. To avoid lockouts of other commands the job is canceled and all of its commands are abended with U2047 RSNC9D5C740.

  • The variable job shows the name of the job.
  • The variable asid shows the address space ID running the job.
  • The variable system shows the name of the system running the job.

System action

SA z/OS cancels the indicated job and abends all its commands in the command class where the automation detected the command flooding.

Operator response

Inform your system programmer.

System programmer response

Determine the reason why the job was flooding the master or console address space with commands. Make the necessary changes to prevent future occurrences of this situation before you restart the job.

Module

INGRX746

Classes

40, 43.

propd

NO

ING923I LONG-RUNNING ENQ AUTOMATION IS ACTIVE

Explanation

Automation has started monitoring of long-running ENQs sysplexwide.

System action

Processing continues.

Operator response

None.

System programmer response

None.

Module

INGRX745

Classes

None.

propd

NO

ING924E AUTOMATION DETECTED THE JOB job IN asid ON system FLOODING THE COMMAND CLASS cc

Explanation

SA z/OS detected a job that floods the indicated command class. However, the policy defines the job as non-cancelable. For this reason the automation leaves the job and the commands that have been issued by the job untouched.

  • The variable job shows the name of the job issuing the command.
  • The variable asid shows the address space ID running the job.
  • The variable system shows the name of the system running the job.
  • The variable cc shows the name of the command class that is affected.

This message is issued approximately every 60 seconds until there are no more commands waiting for execution.

System action

Processing continues.

Operator response

Observe the command class to determine whether the job still floods the class. If this is the case, cancel the job because this is a serious situation that inhibits other commands from being executed in the indicated class.

After you have canceled the job clean up the command class. Use the command CMDS SHOW to determine the IDs of the commands that have been issued by the indicated job. Then use the command CMDS REMOVE to remove any commands that are waiting, and the command CMDS ABEND to terminate any commands that are executing.

System programmer response

None.

Module

INGRX746

Classes

40, 43.

propd

NO

ING925E CF cfname IS IN NORMAL_OFFLINE STATE, UNABLE TO function

Explanation

SA z/OS is unable to enable or populate the coupling facility. SA z/OS has issued V PATH(cfname,chp), ONLINE commands on all systems in the sysplex, but at least one system is unable to connect to the coupling facility. This condition has persisted for 30 seconds.

  • The variable cfname is the coupling facility name.
  • The variable function is either ENABLE or POPULATE.

System action

Processing continues.

Operator response

Contact your system programmer.

System programmer response

Ensure that every system in the sysplex has at least one channel path that is online to the coupling facility.

Classes

40, 43.

propd

YES

ING926I JOB jobname INHIBITS OTHER COMMANDS FROM EXECUTING. RESOURCE=qname rname

Explanation

SA z/OS found a job that inhibits at least one other command from completing its execution. The policy defined during customization does not allow for terminating the task that holds the resource lock.

  • The variable jobname shows the name of the job.
  • The variable qname shows the major resource name that is enqueued by the job and required by the command.
  • The variable rname shows the minor resource name that is enqueued by the job and required by the command.

System action

Processing continues.

Operator response

Contact your system programmer.

System programmer response

Check the execution time of the command. If the execution time is not reasonable, add the command to the policy along with a reasonable execution time. This allows the cancelation of the job if necessary.

Module

INGRX744.

Classes

40, 43.

propd

YES

ING927E HSAPRGRS ENQ REQUEST FAILED. REQUEST request RETURN CODE return code REASON CODE reason code

Explanation

HSAPRGRS was called for ENQ processing but failed. This may be an ENQ/GRS issue or a programming error in HSAPRGRS. For ENQ failures the requested resource may already be in use and not available or the GRS environment may not be valid.

  • The variable request shows the request type for HSAPRGRS/GQSCAN.
  • The variable return code shows the return code from HSAPRGRS or the GQSCAN macro.
  • The variable reason code shows the reason code from HSAPRGRS or the GQSCAN macro.

System action

Processing is halted.

Operator response

Contact your system programmer.

System programmer response

Check the return codes listed below:

Code
Meaning
0
Request successfully completed.
4
CHNG
Status cannot be changed. Other tasks share the resource.
EXCL/SHR/TEST
Resource is not immediately available.
REL
Resource control requested but not yet assigned.
SCAN
No resources matched the request.
8
CHNG
Status cannot be changed. No ENQ has been requested.
EXCL/MOVE/SHR/TEST
A previous request was made. The task already has control of the resource.
REL
Resource is already released or the task does not have control of the resource.
SCAN
The area is too small.

For return codes 10 and 12 a reason code from macro GQSCAN is also returned (see z/OS MVS Assembler Reference).

10
SCAN
GQSCAN failed. Check the reason code.
12
SCAN
GQSCAN failed. Check the reason code.
20
CHNG/EXCL/MOVE/SHR/TEST
A previous request was made. The task does not have control of the resource.
24
EXCL/MOVE/SHR
ENQ limit reached.
32
No storage available for GQSCAN.
36
Resource not owned by the task with the TCB address.
-1
IRXEXCOM error.
-2
IRXEXCOM error.
n01
nth parameter not specified.
n02
Length of nth parameter is greater than 240.
n03
nth parameter doesn't represent a stem variable.
n04
Value of nth parameter is invalid.
n05
Invalid parameter.
1nnn
IRXEXCOM error 'nnn'.

Classes

40, 43.

ING930I Policy Services Provider is starting

Explanation

This message is used to indicate that the Policy Services Provider is starting up.

System action

None.

Operator response

None.

System programmer response

None.

ING931I Policy Services Provider started

Explanation

This message is used to indicate that the Policy Services Provider is fully initialized and operational.

System action

None.

Operator response

None.

System programmer response

None.

ING932I Policy Services Provider is stopping

Explanation

This message is used to indicate that the Policy Services Provider is shutting down.

System action

None.

Operator response

None.

System programmer response

None.

ING933I Policy Services Provider stopped

Explanation

This message is used to indicate that the Policy Services Provider is shut down completely.

System action

None.

Operator response

None.

System programmer response

None.

ING934I Policy Services Provider start failed

Explanation

This message is used to indicate that the Policy Services Provider has encountered a severe error while starting.

System action

None.

Operator response

None.

System programmer response

Check the syslog and javalog for the associated messages. Correct the problem and restart the Policy Services Provider.

ING935I ISPF service failed with table table-name and function function-name

Explanation

This message is used to indicate that the Policy Services Provider has encountered an error while invoking the ISPF service.
  • The variable table-name shows the table name of the ISPF table service function.
  • The variable function-name shows the function name of the ISPF

System action

None.

Operator response

None.

System programmer response

Check whether the user has the authority to access the policy database.

ING936I User userid is not authorized to use Policy Services Provider. Reason: ssrrnnnn

Explanation

This message indicates that there might have been a problem with authentication of the user.
  • The variable userid shows the operator ID originating the request.
  • The variable ssrrnnnn provides 3 pieces of return and reason code information:
    • ss: SAF return code.
    • rr: RACF return code.
    • nnnn: RACF reason code.

System action

None.

Operator response

None.

System programmer response

See the "Securing the Policy Services Provider" topic in IBM Z System Automation Planning and Installation for instructions on how to correctly set up authentication and authorization for the Policy Services Provider.

ING937I User userid requested access access to resource profile profile-name in resource class class, but access is forbidden. Reason: ssrrnnnn

Explanation

This message indicates that there might have been a problem with authorization of the user.
  • The variable userid shows the operator ID originating the request.
  • The variable access shows the resource access level.
  • The variable profile-name shows the resource profile name.
  • The variable class shows the resource class.
  • The variable ssrrnnnn provides 3 pieces of return and reason code information:
    • ss: SAF return code.
    • rr: RACF return code.
    • nnnn: RACF reason code.

System action

None.

Operator response

None.

System programmer response

See the "Securing the Policy Services Provider" topic in IBM Z System Automation Planning and Installation for instructions on how to correctly set up authentication and authorization for the Policy Services Provider.

INGC1010I Exit exitname has been disabled.

Explanation

The exit named in exitname has been disabled. exitname can have the values of XMEOUT for the CICS message exit, or XDTOUT for the Transient Data Queue exit.

This message will be issued if an existing policy has enabled the specified exits and a refresh of the policy is in progress. The exits are disabled and then optionally re-enabled based on the new policy.

System action

Processing continues and the specified exit is not invoked to process messages.

Operator response

This is not an error message. The product will function correctly with one or both the exits disabled. However, this message should be followed by INGC1011I if the user has specified a message exit policy according to the IBM Z System Automation Product Automation Programmer’s Reference and Operator’s Guide manual.

INGC1011I Exit exitname has been enabled.

Explanation

The exit named in exitname has been enabled. exitname can have the values of XMEOUT for the CICS message exit, or XDTOUT for the Transient Data Queue exit.

This message will be issued if a refresh of the policy is in progress. The exits are enabled if the user has specified policy information in the MESSAGES/USER DATA policy. The XMEOUT exit will be enabled for any message in the policy that starts with DFH and has an OFFSET= value specified in the USER DATA section. The XTDOUT exit will be enabled for any message that has the OFFSET= and TDQUEUE= values specified in the USER DATA section.

System action

Processing continues and the specified exit will be invoked to process messages.

Operator response

None.

INGC1012I No message policy definitions found. Exits will not be enabled.

Explanation

There are no USER DATA policy definitions for the XMEOUT or XTDOUT exits and so the exits will not be enabled.

System action

Processing continues and the exits will not be invoked to process messages.

Operator response

If messages should be processed, check that the OFFSET= parameter has been specified in the USER DATA section of the message policy. Also check that the TDQUEUE= parameter is specified for Transient Data Messages.

INGC1013I Processing function. CICS service Service failed with EIBRCODE=code

Explanation

In the process of refreshing the message exit policy in the CICS subsystem, a CICS service has returned an unexpected return code.

The variable function can be one of:
XMEOUT
Policy was being processed for the XMEOUT exit.
XDTOUT
Policy was being processed for the XTDOUT exit.
BOTH
Policy was being processed for both the XMEOUT and XTDOUT exits.
The variable service can be one of:
DISABLE
Exit was being disabled via EXEC CICS DISABLE.
ENABLE
Exit was being enabled via EXEC CICS ENABLE.
EXTRACT
Exit information was being extracted via EXEC CICS EXTRACT.
FREEMAIN
Storage was being released via EXEC CICS FREEMAIN.
GETMAIN
Storage was being obtained via EXEC CICS GETMAIN.
MSGBUILD
A message was being built. EIBRCODE refers to the code returned from this routine and not an EXEC CICS function.
The variable code is the EIBRCODE of the EXEC CICS function or the return code as specified above.

System action

Processing is aborted and exits may or may not be enabled or disabled.

Operator response

For MSGBUILD make sure that the INGAMCE module is in the DFHRPL concatenation. If it is and for all other circumstances, report this error to service.

INGI1010I Automated Operator Exit Initialized for IMS ims Level level

Explanation

The SA z/OS exit has been initialized and the IMS control region is running at the specified level.

  • The variable ims is the IMS subsystem id.
  • The variable level is the Version Modification Release of the IMS.

System action

Processing continues.

Operator response

None.

INGI1011I No message policy definitions found. Exits will not be enabled for IMS ims.

Explanation

There are no USER DATA policy definitions for the IMS subsystem and so the exits will not be enabled.

  • The variable ims is the IMS subsystem id.

System action

Processing continues and the exits will not be invoked to process messages.

Operator response

If messages should be processed, check that the OFFSET= parameter has been specified in the USER DATA section of the message policy.

INGI1012I Exit DFSAOE00 has been disabled for IMS ims.

Explanation

The DFSAOE00 exit has been disabled.

This message will be issued if an existing policy has enabled the specified exits and a refresh of the policy is in progress. The exits are disabled and then optionally re-enabled based on the new policy.

  • The variable ims is the IMS subsystem id.

System action

Processing continues and the specified exit is still invoked, however as no message policy is present, it will not take any actions.

Operator response

This is not an error message. The product will function correctly with the exit disabled. However, this message should be followed by INGI1013I if you have specified message exit policy according to the IBM Z System Automation Product Automation Programmer’s Reference and Operator’s Guide manual.

INGI1013I Exit DFSAOE00 has been enabled for IMS ims.

Explanation

The DFSAOE00 exit has been enabled.

This message will be issued if a refresh of the policy is in progress. The exits are enabled if the user has specified policy information in the MESSAGES/USER DATA policy. The exit will be enabled for any message in the policy that has the OFFSET= value specified in the USER DATA section.

  • The variable ims is the IMS subsystem id.

System action

Processing continues and the specified exit will be invoked to process messages.

Operator response

None.

INGLCR01E Dynamic allocation failed for DSN=file name.

Explanation

Life Cycle Recording (LCR) cannot allocate the data set specified in file name.

System action

Either LCR cannot be enabled or the error occurred while offloading the data space to a data set (using the SAVE command).

Operator response

Check that you have specified a correct data set name via the command INGRXQRY LCR, or in HSAPRMxx or INGXINIT.

System programmer response

None.

INGLCR02I Close life cycle recording.

Explanation

SA z/OS starts closing Life Cycle Recording (LCR) for either the primary automation manager (PAM) or an automation agent.

System action

The data space is automatically offloaded to the data set.

Operator response

None.

System programmer response

None.

INGLCR03I Begin blocking access to LCR.

Explanation

When Life Cycle Recording (LCR) is about to close or offload the data space, activities by other tasks are blocked until the data space has been written to disk.

System action

None.

Operator response

None.

System programmer response

None.

INGLCR04I End blocking access to LCR.

Explanation

The Life Cycle Recording (LCR) close or offload process has finished.

System action

None.

Operator response

None.

System programmer response

None.

INGLCR05E ABEND xxxx-rcrcrcrc occurred for output media media_type

Explanation

An abend occurred during the I/O operation for a data set or data space for Life Cycle Recording (LCR).

  • The variable xxxx is the system completion code.
  • The variable rcrcrcrc is the corresponding reason code.

System action

Life Cycle Recording is disabled.

Operator response

Collect additional information about the reason for the abend, for example, the data set was too small. If you cannot fix the problem, report the error to your IBM Support Center.

System programmer response

None.

INGLCR06E Cannot open/write output media.

Explanation

Life Cycle Recording (LCR) cannot complete one of the following:

  • Opening a data set or a data space
  • Writing a record to the data space
  • Offloading the data space to data set

System action

Life Cycle Recording is disabled.

Operator response

Look for additional error messages, such as INGLCR05.

System programmer response

None.

INGLCR07I Life cycle recording has been enabled, NAME=dataset_name

Explanation

Life Cycle Recording (LCR) has been enabled with the dataset_name that will later be used as the offload data set.

System action

None.

Operator response

None.

System programmer response

None.

INGLCR08I Life cycle recording is currently status, NAME=dataset_name

Explanation

Status message indicating the current status of Life Cycle Recording (LCR), which is either enabled or disabled.

System action

None.

Operator response

None.

System programmer response

None.

INGLCR09I Life cycle recording will be disabled.

Explanation

An abend occurred and Life Cycle Recording (LCR) is about to be disabled.

System action

None.

Operator response

None.

System programmer response

None.

INGLCR10I Life cycle recording has been successfully initialized, NAME=dataset_name

Explanation

Life Cycle Recording (LCR) has been initialized. A data set was allocated and an initial record was written (any old data is lost). The data space has been allocated.

System action

Life Cycle Recording is ready for the command to enable it.

Operator response

None.

System programmer response

None.

INGLCR11I Successfully flushed records, total size #rec(KB)=size1(size2).

Explanation

size1 is the total number of checkpoint records ever written by Life Cycle Recording (LCR) to the data space. This is an accumulated number and is not reset due to possible wraparound.

size2 is the number of bytes actually allocated by the data space. Later when the data space is saved to disk, size2 is written.

System action

None.

Operator response

None.

System programmer response

None.

INGLCR12I Switch output media for Life cycle recording.

Explanation

Life Cycle Recording (LCR) has switched the output media. The old data space is offloaded to the old data set. A new, empty data space is allocated and initialized with an initial record. A new data space is created.

System action

None.

Operator response

None.

System programmer response

None.

INGLCR13E Switching output media for life cycle recording failed.

Explanation

Life Cycle Recording (LCR) cannot switch the output media.

System action

None.

Operator response

None.

System programmer response

None.

INGLCR15E Creation of data space failed for DSP=file name

Explanation

Life Cycle Recording (LCR) cannot create a data space. This is caused either by the command INGRXQRY LCR, or while initializing the SA z/OS INGPXDST agent task or the SA z/OS primary automation manager (PAM).

System action

LCR cannot be enabled.

Operator response

Look for additional error messages, such as INGLCR23E.

System programmer response

None.

INGLCR21I Start offloading data space.

Explanation

Life Cycle Recording (LCR) starts offloading the data space to the data set.

System action

None.

Operator response

None.

System programmer response

None.

INGLCR22I End offloading data space.

Explanation

Life Cycle Recording (LCR) has finished offloading the data space to the data set.

System action

None.

Operator response

None.

System programmer response

None.

INGLCR23E function failed, rc=rc frc=frc rsn=rsn

Explanation

Life Cycle Recording (LCR) detected an error while processing the function function. Diagnostic information is provided as the return code (rc), function return code (frc), and reason code (rsn).

  • The variable function shows the function that produced the error. It can be OPEN, CLOSE, OFFLOAD, or FLUSH.
  • The variable rc shows the return code:
    32
    REXX V-pool error
    40
    Communication environment not available
    81
    Initialization of lifecycle recording failed
    99
    Invalid input arguments
    <100
    Internal error by INGPXILC
    108
    Internal. Invalid parameter list
    109
    Internal. LCR control block has not been initialized
    112
    Internal. Invalid function
    116
    Dynamic allocation failed
    120
    File open failed
    121
    File put failed
    122, 123
    Writing a control record failed while closing the file
    128
    Get record failed
    132
    Function rejected because a server error occurred previously
    136
    ESTAE cannot be established
    140
    An abend occurred
    144
    DSP Create failed
    145
    DSP Delete failed
    146
    DSP Put failed
    147
    DSP Get failed
    148
    DSN is missing
    149
    Semicolon missing in INGRXQRY command
    150
    Invalid size
    >200
    ENQ failed
    >300
    DEQ failed
    >400
    NetView ALLOC error
    489
    Invalid parameter list
  • The variable frc shows the function return code. This is additional diagnostic information that is intended for the IBM Support Center.
  • The variable rsn shows the reason code. This is additional diagnostic information that is intended for the IBM Support Center.

System action

LCR is disabled.

Operator response

Collect additional error messages, if available.

System programmer response

None.

INGPC010I pgm is unable to perform function service, PPI_id=xxxxxxxx

Explanation

The program pgm failed to perform the PPI function service with PPI using the PPI ID xxxxxxxx. Function could be:

  • open DSIPHONE(OPENRECV)
  • close DSIPHONE(CLOSE)
  • send DSIPHONE(SEND)
  • AOF_PPI_SEND
  • receive DSIPHONE(RECEIVER)

System action

The program exits.

Operator response

Check if a correct PPI receiver ID was specified. Message INGPC011I might also be issued and provides additional PPI and DSIPHONE error information.

For AOF_PPI_SEND, a security error might have occurred. Search for message INGPC028I.

System programmer response

None.

INGPC011I xxxxx, PPI Reason: yyyy

Explanation

The message provides DSIPHONE error information xxxxx and optional PPI error info yyyy. When sending over secure PPI then xxxxx describes the error info about the SA secure PPI interface INGPAUTH instead of DSIPHONE. It will be issued in addition to INGPC010I.

System action

None.

Operator response

None.

System programmer response

None.

INGPC012I The program pgm detected missing or invalid input for argument n

Explanation

The program pgm failed because the input argument n is missing or invalid.

System action

The program exits.

Operator response

None.

System programmer response

Check input arguments.

INGPC015I cond condition trapped in script pgm Line: sigl Code: rc Description: desc

Explanation

The program pgm failed due to a REXX script error.

System action

The program exits.

Operator response

Report problem to your system programmer unless the condition is triggered by the operator, such as a HALT condition.

System programmer response

Report the problem to your IBM Support Center.

INGPC016I INGPCxxx service failed, RC=nn

Explanation

The program INGPCxxx failed with return code nn.

System action

The program exits.

Operator response

Report the problem to your system programmer.

System programmer response

Report the problem to your IBM Support Center.

INGPC017I pgm failed. Reason

Explanation

The program pgm failed. Additional error info is provided in Reason.

System action

The program exits.

Operator response

Report the problem to your system programmer.

System programmer response

Analyze the return code and/or additional error message. Resolve the problem and rerun the command.

INGPC018I pgm terminates with error, rc=nnn

Explanation

The program pgm terminates due to an error. Return code nnn is provided.

System action

The program exits.

Operator response

Report the problem to your system programmer.

System programmer response

Analyze the return code and/or additional error message. Resolve the problem and rerun the command.

INGPC019I pgm does not support host: HOST ASP

Explanation

The program pgm does not support the REXX host environment. HOST and ASP is extracted from REXX 'parse source'.

System action

The program exits.

Operator response

Check why the program was called in the wrong environment.

System programmer response

None.

INGPC020I pgm detected bad response: reason

Explanation

The program pgm failed since an unexpected response was received. Reason describes the error.

System action

The program exits.

Operator response

Report problem to your system programmer.

System programmer response

Report the problem to your IBM Support Center.

INGPC021I pgm is called with invalid name cpyname

Explanation

The program pgm failed since the REXX program was copied with an unsupported name or alias cpyname.

System action

The program exits.

Operator response

Report problem to your system programmer.

System programmer response

Use supported OPSxxxx names when copying or defining an alias of pgm.

INGPC022I pgm is called as cpyname for an invalid mode: mode

Explanation

The program pgm failed since it was called as command but only function call is supported or vice versa. The invalid mode is either COMMAND or FUNCTION.

System action

The program exits.

Operator response

Invoke the function only as the supported mode.

System programmer response

None.

INGPC023I RACF® check failed: reason. For info.

Explanation

On TSO the emulator commands check the TSO user id against a profile. This message will be issued if access is not granted or if an RACF error message occurred. reason might be one of the following:

  • Access Allowed
  • Profile not Defined
  • User not Authorized
  • HSAPRRAC rc=nnn

Info is given in the following format, for example: UserID=BDOW Clist=INGRCCMX Class=FACILITY PROFILE=ING.EMULATOR.CMD

The high level qualifier ING was customized via command "INGCSA SET NAME=EMU.RACF.HLQ VALUE=ING". The qualifier EMULATOR is a fixed string and CMD depends on the calling clist being one of the following:{CMD,VAL,SQL,DFLT}. If EMU.RACF.HLQ was not customized, RACF checking is ignored.

System action

The calling program terminates.

Operator response

Report the problem to your system programmer.

System programmer response

Give the TSO user the correct RACF access rights or correct the RACF HLQ.

INGPC024I SA REXX function aborted due to no data specified on RETURN

Explanation

A System Automation REXX function running under TSO detected an error. A typical scenario might be: Due to the RACF checking of the TSO user id, an emulated function fails. Since a value must be returned for this error, the emulator must force an Incorrect call to routine by returning nothing. This forces REXX error message IRX0045I on purpose. The originating error is described in an additional message, for example INGPC023I.

System action

The REXX function exits.

Operator response

Report the problem to the system programmer.

System programmer response

Analyze additional message accompanied with INGPC024I and fix the problem in the REXX user program.

INGPC025I Incorrect call to name

Explanation

The named program was called directly rather than from a REXX script.

System action

The program exits.

Operator response

None.

INGPC026I error information

Explanation

An error occurred as reported by the previously issued message for example, INGPC017I. This message gives additional information.

System action

The program exits.

Operator response

Report problem to your system programmer.

System programmer response

If necessary, report the problem to your IBM Support Center.

INGPC027I command. Parameter parm missing or invalid value

Explanation

The specified parameter is either wrong or missing.

  • The variable command is the name of the command being processed.
  • The variable parm is the parameter that is invalid or missing.
  • The variable value is the value of the parameter that is wrong. The variable is only present when applicable.

System action

None.

Operator response

None.

INGPC028I Security check for TSO user failed due to errtext.

Explanation

A TSO program tries to send a command via INGRCRPC to the System Automation/NetView Agent on a secure channel. Message INGPC028I will be issued if the SAF front-end security checking failed.

If the TSO user runs the batch API, the TSO user ID must have READ access to the following SAF front-end profile:
  • TSO.plexname.system.CMDRCVR.SEND
If the TSO user calls INGRCRPC, the TSO user ID must have READ access to one or both of the following profiles:
  • TSO.plexname.system.CMDRCVR.SEND
  • TSO.plexname.system.CMDRCVR.SEND.USERTASK
Table 5. Error Text for INGPC028I
errtext Description
HSAPRRAC error Internal API returns an error.
invalid parameter Internal API detects an invalid input argument.
invalid class The class SYSAUTO is not authorized.
user not authorized TSO userid is not authorized to access the profile.
resource not protected The profile is not defined.

System action

Request was not sent to the System Automation/NetView agent.

Operator response

None.

System programmer response

Search for additional security messages, such as ICH408I.

Check if the profile was correctly defined and the TSO user ID has READ access. If an internal API error occurred, switch on trace and rerun the command.

INGPC029I Parameter xxxx is not supported by emulator for yyyy.

Explanation

The emulated command or function for yyyy was called on TSO but the parameter xxxx is not supported by the SA z/OS emulator.

System action

The program continues.

Operator response

None.

System programmer response

Modify the script invoking the emulator.

INGV0001I Library aa.bb is not APF authorized.

Explanation

The indicated library is not APF authorized.

  • The variable aa identifies the high-level qualifier of the library as found in the configuration file.
  • The variable bb identifies the type of the library.

The verification ends with warnings.

System action

None.

Operator response

None.

System programmer response

Correct the panel descriptions.

INGV0002I LPA Module aa not found.

Explanation

The indicated module is required to be stored in the LPA. However, the verification routine could not locate the module in the LPA.

  • The variable aa identifies the name of the module.

The verification ends with warnings.

System action

None.

Operator response

None.

System programmer response

Ensure the content of the library ending with SINGLPA is loaded into the LPA.

INGV0003I Library aa.bb not in LNKLST.

Explanation

The indicated library is not found in the current LNKLST concatenation.

  • The variable aa identifies the high-level qualifier of the library as found in the configuration file.
  • The variable bb identifies the type of library.

The verification ends with warnings.

System action

None.

Operator response

None.

System programmer response

Add the indicated library to the current LNKLST.

INGV0004I Library aa.bb preceded by cc.

Explanation

The indicated library has been found in the current LNKLST set. However, the verification routine also detected that another library of the same type precedes the library.

  • The variable aa identifies the high-level qualifier of the library as found in the configuration file.
  • The variable bb identifies the type of library.
  • The variable cc shows the data set name of the library that precedes this library.

The verification ends with warnings.

System action

None.

Operator response

None.

System programmer response

Move the entry to the top of the current LNKLST set.

INGV0005I Improper PPT entry found for aa, RSN=bb

Explanation

The verification routine either did not find the indicated module in the program property table (PPT) or the corresponding PPT entry shows an improper or missing attribute.

  • The variable aa shows the name of the module.
  • The variable bb shows one or more reasons:
      80
    NOCANCEL not specified.
      40
    KEY(8) not specified.
      20
    NOSWAP not specified.

The verification ends with warnings.

System action

None.

Operator response

None.

System programmer response

Correct the PPT entry of the indicated module depending on the reason code.

INGV0006I Log stream aa not defined.

Explanation

The verification routine could not connect to the indicated log stream because it is not defined to the current LOGR policy.

  • The variable aa shows the name of the log stream.

The verification ends with warnings.

System action

None.

Operator response

None.

System programmer response

Define the indicated log stream to the current LOGR policy.

INGV0007I System logger still active.

Explanation

The verification routine found the System Logger address space active. However, the configuration file indicates the configuration for a GDPS KSYS system. This type of system does not allow an active System Logger.

The verification ends with warnings.

System action

None.

Operator response

None.

System programmer response

Stop the System Logger address space.

INGV0008I REXX package aa not found.

Explanation

The verification routine could not locate the indicated REXX function package in the LPA or the LNKLST concatenation.

  • The variable aa shows the name of the function package.

The verification ends with warnings.

System action

The verification step is skipped.

Operator response

None.

System programmer response

Add the indicated REXX function package either to the LPA or to the LNKLST.

INGV0009I REXX function package aa not found in bb.

Explanation

The verification routine could not find the required REXX function package in the indicated module.

  • The variable aa shows the name of the SA function package.
  • The variable bb shows the name of the REXX function package.

The verification ends with warnings.

System action

None.

Operator response

None.

System programmer response

Edit the source member of the module and add the required REXX function package to the module. Re-assemble and re-link the module and add it to the LPA or to the LNKLST.

INGV0010I Version mismatch found, aa - bb.

Explanation

The verification routine detected a version mismatch between two ISPF dialog members, ISPF table AOFTOPOL and panel AOFG#NL1.

  • The variable aa shows the version of the ISPF table.
  • The variable bb shows the version of the ISPF panel.

The verification ends with warnings.

System action

None.

Operator response

None.

System programmer response

Verify that the ISPF installation libraries are set up correctly.

INGV0011I Major node aa not found.

Explanation

The verification routine detected that the NetView major node has not been defined to VTAM.

  • The variable aa shows the NetView major node name.

The verification ends with warnings.

System action

None.

Operator response

None.

System programmer response

Add the major node definition to VTAM and activate it.

INGV0012I Applid aa not found in bb.

Explanation

The verification routine detected that the NetView applid has not been defined in the indicated VTAM major node.

  • The variable aa shows the NetView applid.
  • The variable bb shows the NetView major node name.

The verification ends with warnings.

System action

None.

Operator response

None.

System programmer response

Correct the VTAM major node definition and activate it.

INGV9000I Verification step "aa" not executed.

Explanation

The verification could not switch into a mode and key that is required to perform the indicated verification step.

  • The variable aa shows the description of the step.

System action

The step is not performed.

Operator response

None.

System programmer response

Ensure that the library containing the verification is APF authorized. Then, repeat the verification.

INGV9001I Parse error occurred, Text<aa> Pos=bb, RC=cc.

Explanation

The verification parses the configuration file created by the wizard. The parser found an error condition.

  • The variable aa shows the text around the error.
  • The variable bb shows the position in error relative to the beginning of the text.
  • The variable cc shows the return code returned by the parser.

System action

Verification is terminated.

Operator response

None.

System programmer response

Contact the IBM support center.

INGV9002I Keyword aa not found.

Explanation

The indicated keyword could not be found in the configuration file. Or, the keyword is found but has no value.

  • The variable aa shows the name of the keyword.

System action

Verification is terminated.

Operator response

None.

System programmer response

Contact the IBM support center.

INGV9003I Macro aa failed, RC=bb, RSN=cc.

Explanation

The indicated macro failed.

  • The variable aa shows the name of the macro.
  • The variable bb shows the return code of the macro.
  • The variable cc shows the reason code of the macro.

System action

Verification is terminated.

Operator response

None.

System programmer response

Contact the IBM support center.

INGV9004I Configuration file error.

Explanation

The verification routine requires the configuration file created by the wizard. Either the ddname INGCFG was not specified or the record format of the file is UNDEFined or a read error occurred.

System action

Verification is terminated.

Operator response

None.

System programmer response

Correct the error condition and re-run the verification.

INGV9005I aa authority missing, CLASS=bb, RESOURCE=cc.

Explanation

The verification routine requires the indicated authorization when the Security Authorization Facility (SAF) is available.

  • The variable aa shows the required authority.
  • The variable bb shows the name of the SAF class.
  • The variable cc shows the name of the resource.

System action

Verification is terminated.

Operator response

None.

System programmer response

Grant the required authorization to the verification routine and re-run the verification.

INGV9006I Member aa(bb) not allocated, RC=cc, RSN=dd.

Explanation

The verification routine failed to allocate the indicated member.

  • The variable aa shows the name of the data set.
  • The variable bb shows the name of the member.
  • The variable cc shows the return code of the DYNALLOC macro.
  • The variable dd shows the reason code of the DYNALLOC macro.

System action

Verification step is terminated.

Operator response

None.

System programmer response

Ensure that the data set is available on the current system and re-run the verification.

INGV9007I Member aa(bb) could not be opened, RC=cc.

Explanation

The verification routine failed to open the indicated member.

  • The variable aa shows the name of the data set.
  • The variable bb shows the name of the member.
  • The variable cc shows the return code of the OPEN function.

System action

Verification step is terminated.

Operator response

None.

System programmer response

Contact the IBM support center.

INGV9008I Release information not found in member aa(bb).

Explanation

The verification routine could not find the release information in the indicated member.

  • The variable aa shows the name of the data set.
  • The variable bb shows the name of the member.

System action

Verification step is terminated.

Operator response

None.

System programmer response

Contact the IBM support center.

INGV9009I System Logger not active.

Explanation

The verification routine did not find the System Logger address space active. This inhibits the routine from verifying the definitions of the automation-specific log streams.

System action

Verification step is terminated.

Operator response

None.

System programmer response

Start the System Logger address and re-run the verification.

INGX1001E PLX STACK OVERFLOW: module compile_date info

Explanation

SA z/OS detected an internal error due to a PLX stack overflow.

  • The variable module shows the name of the module that detected the stack overflow.
  • The variable compile_date shows the date that the module was compiled.
  • The variable info gives additional information about the overflow.

System action

None. The function terminates with abend 3999.

Operator response

None.

System programmer response

Check the syslog for the associated messages and dump information, and contact your IBM Support Center.

INGX1002I SHORT ON XCF BUFFERS - RETRY

Explanation

The SA z/OS communication framework cannot send data segments due to the condition Short On XCF Buffers. SA z/OS will try to resend the data segment after a timeout delay. If this is not successful a timeout error message ING008I is issued.

System action

None.

Operator response

None.

System programmer response

Check the syslog for the associated message HSAM1050E that contains further debugging information. If the problem persists consider increasing the number of XCF buffers. The maximum XCF buffer size for SA z/OS is 4028.

INGX1011I INBOUND DIAGNOSTICS: DIF=nn ABS=nn QUE=n EXP=n SEC=nn CPU=nnn OUT=nn RSP=nn FAF=nn

Explanation

This message is issued by the automation manager work item queue monitoring routine when it detects that more work items are arriving than can be processed by the automation manager within the monitoring interval.

DIF
The number of incoming work items that have not yet been processed during the monitoring interval. It is the number of work items in the queue at the current monitoring time minus the number of work items in the queue at the last monitoring. If the number is positive and grows it is an indication that the automation manager is being put under stress.
ABS
The total number of work items in the input and output queues. This value includes the number of work items that have been processed but that have not been through the cleanup process. The number is typically higher than the QUE number. If the number differs greatly from the QUE value, it might be an indication that the automation manager is unable to deliver command responses to the automation agents. A value that is slightly higher than QUE is acceptable.
QUE
The current size of the work item queue.
EXP
The number of work items in the input queue that have already expired. Expired work items are not processed by the automation manager but cause an ING008 timeout message.
SEC
The monitoring interval. It is customizable and runs from 10 to 999 seconds.
CPU
The total accumulated CPU time used by the automation manager
OUT
The number of outbound orders that are waiting to be sent to the agent or agents.
RSP
The query work items in the input queue.
FAF
The number of work items in the input queue that do not require a response. Typically, these are status updates.

System action

Execution continues.

Operator response

None.

System programmer response

None.

INGX9601I System Automation WebServices Adapter jobname failed: reason

Explanation

The WebServices Adapter caught an exception. The reason describes the kind of exception.

System action

The HTTP request has been aborted. However, processing of the WebServices Adapter continues.

Operator response

None.

System programmer response

Check the reason and try to resolve the problem. If necessary, contact your IBM Support Center.

INGX9602I System Automation WebServices Adapter jobname accepts HTTP requests via remote_contact.

Explanation

The WebServices Adapter is ready to accept HTTP requests via the IP address and port as specified in remote_contact.

System action

Processing continues.

Operator response

None.

System programmer response

None.

INGX9603I System Automation WebServices Adapter jobname initialization complete for automation domain name.

Explanation

The WebServices Adapter is ready to work automation domain name.

System action

Processing continues.

Operator response

None.

System programmer response

None.

INGX9604I System Automation WebServices Adapter jobname internal error error_code, reason.

Explanation

The WebServices Adapter suffers an internal error that is not expected to be caused by any input URL or input parameter.

The internal error_code and the reason is additional debug information for IBM support.

System action

The WebServices Adapter continues running or terminates depending on the error scenario.

Operator response

None.

System programmer response

Contact your IBM Support Center.

INGX9605I System Automation WebServices Adapter jobname does not accept reason.

Explanation

The URL associated with the HTTP request is not accepted due to the specified reason. In most cases the URL has an invalid format or unsupported parameters.

System action

The HTTP request is rejected. The WebServices Adapter continues running.

Operator response

None.

System programmer response

None.

INGX9632I System Automation E2E agent jobname terminates: reason

Explanation

The E2E agent detects an error most likely during the initialization of its USS process.
  • The variable reason provides diagnostic information about the error that occurred.

System action

E2E agent terminates.

Operator response

None.

System programmer response

Determine why the E2E agent failed and correct the problem. Examine the syslog and netlog for additional information. If the reason is the failing command INGRE2E, look for message ING377I in the netlog and check the return code.

Make sure that you always use the code page IBM 1047 for the E2E agent configuration file. If not, the input check might fail and this message might show an unpredictable character string as a result.

INGX9633I System Automation E2E Agent jobname initialization complete

Explanation

The E2E agent initialization is completed and is ready to accept connections from remote automation domains.

System action

Processing continues.

Operator response

None.

System programmer response

None.

INGX9634I System Automation E2E agent jobname user ID or password is not correctly specified or the credential file cannot be loaded from path.

Explanation

The E2E agent initialization tries to load the file inge2eagt.credentials.properties, which contains the user ID and password that are needed to connect to the remote automation domains. The file cannot be loaded or it does not contain a user ID and password pair for each domain that was loaded by the E2E agent.
  • The variable jobname shows the name of the job.
  • The variable path shows the path of the credential file.

System action

Processing terminates.

Operator response

None.

System programmer response

Create a credential file inge2eagt.credentials.properties and copy it into the configuration directory of the E2E agent. Each domain that is defined in the policy needs to have either a specific or a generic credential statement. For each specified user ID, you must also specify a password. For a remote z/OS domain, the user ID must be a valid SAF user ID. See also the parameter INGAGT_CRED_CFG in the configuration file inge2eagt.properties.

INGX9635I System Automation E2E agent jobname rejects a join event from hostname host of the unknown automation domain: dom.

Explanation

The E2E agent has received a join event from a remote automation domain that is not known. There is no corresponding DMN object defined in the currently loaded SA automation policy. Therefore, the connection to the E2E agent is rejected.
  • The variable jobname shows the name of the E2E agent's job.
  • The variable host shows the TCP/IP hostname or IP address of the remote automation domain.
  • The variable dom shows the name of the remote automation domain.

System action

The processing continues.

Operator response

None.

System programmer response

Check whether the unknown automation domain has been defined in the SA automation policy and correct the problem.

INGX9636I System Automation E2E agent jobname connection failed to dom(hostname) with exception: exception_text

Explanation

The E2E agent cannot establish a TCP/IP connection to a remote automation domain.
  • The variable jobname shows the name of the E2E agent's job. o The variable dom shows the name of the remote automation domain.
  • The variable hostname shows the TCP/IP hostname or IP address of the remote automation domain.
  • The variable exception_text shows the text of the exception.

System action

Processing continues.

Operator response

None.

System programmer response

Check the text of the exception. Possible reasons for TCP/IP connection errors might be an SSL handshake problem or a firewall problem.

INGX9701I ingadapter.sh [-](start|stop|GenerateSampleKeys| IBMSupport|traceON|traceOFF) [suffix]

Explanation

Describes the syntax of the automation adapter start/stop command. It is also shown if there are invalid arguments or no arguments specified.

System action

None.

Operator response

Specify command syntax as described.

INGX9702I Script ingadapter.sh completed successfully.

Explanation

The end-to-end automation adapter start script ended successfully.

System action

None.

Operator response

None.

INGX9703E Script ingadapter.sh completed unsuccessfully.

Explanation

An error occurred during script execution.

System action

Script execution is interrupted.

Operator response

Check previous error messages for more details.

INGX9704I Preparing the environment to start the automation adapter using custom root directory xxx.

Explanation

The script ingadapter.sh performs a validation and a cleanup step before starting the automation adapter. The script determines whether an automation adapter on the same port is already running, or if there are any open connections left by a failed automation adapter shutdown. In the former case the script aborts and in the latter case the connections are dropped. Moreover, any existing pid-file of a failed automation adapter shutdown is deleted.

xxx specifies the USS path of the currently used E2E adapter custom root directory.

System action

None.

Operator response

If the automation adapter cannot be started or the connections cannot be dropped, check whether the user ID that was used to run the automation adapter has the correct access rights. For details see the chapter Operating the End-to-End Automation Adapter in IBM Z System Automation End-to-End Automation.

INGX9705E Cannot start automation adapter with the same configuration: hostname:port

Explanation

The automation adapter cannot be started twice with the same port number and hostname as specified in the automation adapter master configuration file. This is determined by examining an existing pid-file whose filename is constructed from the hostname and port number. The containing process-id is used to determine whether another automation adapter is running or if the pid-file has been left over by a failed automation adapter shutdown. If the corresponding automation adapter USS process does not exist then delete the pid file and restart the automation adapter. The pid file resides in the automation adapter data directory with extension '.pid'.

System action

Script execution is interrupted.

Operator response

Start the automation adapter with a different configuration.

INGX9706I Trying to drop possible open, unused connections. Processing port: port_number

Explanation

The script tries to close possible open and unused connections that have been left by a failed automation adapter shutdown. These connections are detected with the netstat command. The connection will be dropped using the command netstat -d conid, if specific access rights have been granted.

System action

Connections are dropped.

Operator response

If the ingadapter.sh script cannot drop connections check whether the user ID that was used to run the automation adapter has the correct access rights. For details see the chapter Operating the End-to-End Automation Adapter in IBM Z System Automation End-to-End Automation.

INGX9707I Status of the process: process is running.

Explanation

The process is already running.

The process can be one of the following:
  • automation adapter
  • E2E agent
.

System action

None.

Operator response

None.

INGX9708I Status of the automation adapter: adapter is not running.

Explanation

Information about the status of the automation adapter.

System action

None.

Operator response

None.

INGX9709E Rights to access process list have not been granted. Change permissions.

Explanation

The necessary rights to show all processes have not been granted to the current user. The script cannot correctly determine the automation adapter status.

System action

Script execution is interrupted.

Operator response

Change access rights to show all processes. For more information, see Customizing USS and TCP/IP.

INGX9710I Could not retrieve installed codepage. Trying with default codepage:

Explanation

The script was not able to determine the installed codepage because environment variable CODEPAGE has not been set correctly. It attempts to use the default codepage.

System action

The system uses the default codepage.

Operator response

Set the environment variable CODEPAGE in the configuration file ing.adapter.plugin.properties to the desired codepage.

INGX9711E The automation adapter configuration file is missing.

Explanation

The automation adapter master configuration file, ing.adapter{suffix}.properties, was not found. The suffix is optional and can be specified as the second argument of ingadapter.sh.

System action

Script execution is interrupted.

Operator response

If you use a suffix make sure you have specified it as the second argument for ingadapter.sh. The automation adapter master configuration file is expected to be located in the configuration directory. Also check the customization section of the script ingadapter.sh. Check manual for corresponding information.

INGX9712I Generating Sample Keys for test purposes.

Explanation

The script generates sample keystore and truststore files for SSL. These keys are for testing purpose only.

System action

None.

Operator response

None.

INGX9713E Keytool was not found. Please install a java-sdk and customize ingadapter.sh accordingly.

Explanation

The automation adapter script, ingadapter.sh, attempted to use the keytool from the Java SDK but the tool was not found. The keytool is used to generate sample keys for SSL.

System action

Cannot create sample keys.

Operator response

Install a Java SDK and adapt the path to the keytool using the variable JAVA_KEYTOOL in the customization section of the script ingadapter.sh.

INGX9714I Trace was set to: level.

Explanation

The script has successfully set the specified level. level is either OFF or DEBUG_MAX.

System action

None.

Operator response

None.

INGX9715E An error occurred while trying to set log level.

Explanation

The script failed in at least one case to set the specified log level. Use the counterpart of the command to reset the logger to its previous state. Ignore failures that are reported by the script in this undo step. Those commands that succeeded the first time will succeed in the undo step and those that did not will not succeed the second time.

System action

None.

Operator response

Undo changes by invoking the opposite trace command: for example, traceOFF if traceON has failed.

INGX9717I Cannot write file or directory: uss_path

Explanation

The script failed because it has no write access to the specified file or directory or the file or directory does not exist at all.

System action

The script terminates.

Operator response

None.

System programmer response

Check if you have properly set up the configuration file ingadapter.properties for the E2E adapter or inge2eagt.properties for the E2E agent. You might have to set the variable E2E_CUSTOM_ROOT to a path that is not read only. If this variable is not set, then the default path is the path that is specified in E2E_INSTALL_ROOT. The configuration file is used in the STDENV DD of the corresponding startup procedure of the JCL.

INGX9718I Cannot create file or directory: uss_path

Explanation

The script failed because it cannot create the specified file or directory by using the mkdir command .

System action

The script terminates.

Operator response

None.

System programmer response

Check if you have properly set up the configuration file ingadapter.properties for the E2E adapter or inge2eagt.properties for the E2E agent. You might have to set the variable E2E_CUSTOM_ROOT to a path that is not read only. If this variable is not set, then the default path is the path that is specified in E2E_INSTALL_ROOT. The configuration file is used in the STDENV DD of the corresponding startup procedure of the JCL.

INGX9719I Shell script command 'cmd' result

Explanation

The script cannot run the specified command cmd successfully or the specified command returns an unexpected value.

The cmd variable shows the command specified in the script.

The result variable shows one of the following values:
  • Failed
  • Returns unexpected value xxx

System action

The script terminates if the specified command failed. Otherwise, the script continues running.

Operator response

None.

System programmer response

If the command is 'hostname -p stackname', then check that the stackname is valid and check that the hostname from the default TCP/IP stack is different from the hostname of the separate TCP/IP stack.

The command hostname is used to determine the TCP/IP hostname automatically. If you specify the correct IP address or hostname directly in the parameter eez-remote-contact-hostname in the configuration file ing.adapter.properties, you can avoid executing the command hostname.

INGX9730I Starting Automation Agent Java Plugin Adapter Script: start_parameters

Explanation

The USS script of the System Automation Agent Java Adapter starts. The start parameters are a list of name-value pairs which might be useful for diagnostic purposes.

System action

Processing continues.

Operator response

None.

System programmer response

None.

INGX9731I Finished Automation Agent Java Adapter Script: RC=retcode

Explanation

The USS script of the System Automation Agent Java Adapter has been terminated. The final return code is provided in retcode.

System action

Processing finished.

Operator response

None.

System programmer response

If the retcode is not zero, look for additional messages and analyze the reason for the problem.

0
Success.
1
Java environment setup failed for example due to improper parameter values in inge2eagt.properties.
2
USS script failed.
>2
Java mainline failed, see also message INGX9877I.

INGX9732I Cannot create logger output directory: logdir

Explanation

The USS script of the System Automation Agent Java Adapter cannot create the logger output directory as specified by logdir.

System action

Processing terminates.

Operator response

None.

System programmer response

Check that the USS script has correct write access permissions.

INGX9733I Bad Java version foundVersion, required is requiredVersion.

Explanation

The USS script compares the required minimum Java version with the actual version found by java version.

  • The foundVersion variable has the value 'or java not installed' if Java is not installed at all. Otherwise, it shows the installed Java version that is not supported.
  • The requiredVersion variable shows the required minimum Java version.

System action

Processing terminates.

Operator response

None.

System programmer response

Install and set up at least the required Java version.

INGX9800E Cannot find message file or message ID file_or_msgid

Explanation

The message file cannot be loaded or the message ID cannot be found in the message file.

  • The variable file_or_msgid shows the name of the associated message file or ID.

System action

None.

Operator response

Check the class path.

System programmer response

None.

INGX9801E INGXLogger cannot setup com.ibm.log.PDLogger

Explanation

Initialization of the message and trace log service failed.

System action

The message or trace data cannot be written to the log file.

Operator response

Check the classpath or the logger configuration file, eezjlog.properties.

System programmer response

None.

INGX9802I INGXLogger has successfully been initialized using configuration file config_file from path path.

Explanation

Initialization of the message and trace log service was successful. The logger configuration data were read from the specified configuration file.

  • The variable config_file shows the name of the configuration file that the logger configuration data was read from.
  • The variable path shows the path of the configuration file.

System action

Message and trace data will be written to the log file.

Operator response

None.

System programmer response

None.

INGX9803E INGXLogger is not available : message

Explanation

An attempt was made to write a message to the logger but the logger was not initialized.

  • The variable message shows the message that could not be written to the logger.

System action

The message is written to the stderr.txt file.

Operator response

None

System programmer response

None.

INGX9810I Timeout after interval seconds.

Explanation

A connection from the JVM to the SA z/OS communication manager (INGPXDST) timed out.

  • The variable interval shows the duration of the timeout.

System action

The response from the associated request is not received.

Operator response

Increase the timeout.

System programmer response

None.

INGX9820E JNI function function failed with return code return_code.

Explanation

A function call to the specified JNI DLL failed.

  • The variable function shows the function call that failed.
  • The variable return_code shows the return code that specifies the reason for the failure:
    10
    Internal—invalid field ID (attribute not available in Java class)
    20
    Internal—handle cannot be saved in Java long since long too small
    21
    Internal—handle is invalid, for example, null pointer
    22
    Handle cannot be created since no memory
    23
    Internal—handle iterator already used (number of slots too small)
    25
    The ASCB address is no longer correct. Recycle the End-to-end automation adapter.
    26
    Internal—invalid array size (Java array size is zero or too small)
    27
    Internal—invalid object (null pointer or an unexpected class)
    30
    Internal—invalid parameter (unexpected input argument)
    31
    Invalid buffer length (input data buffer has unexpected length)
    32
    A Java class that was accessed via JNI has thrown an exception
    33
    Creation of a new Java array failed
    34
    Creation of a new Java string failed
    35
    Out of memory
    36
    A Java class cannot be found
    40
    Catastrophic error—an unexpected exception occurred
    1000
    PPI receive timeout
    11nn
    PPI subsystem not available
    12nn
    PPI initialization of receiver queue failed
    13nn
    The PPI receiver queue exists already
    14nn
    PPI NetView posted PPI ECB due to subsystem error
    15nn
    PPI cannot receive data
    16nn
    PPI cannot delete receiver queue
    17nn
    PPI cannot send data
    where nn denotes the PPI-specific return code as described in the NetView Application Programmer's Guide, for example:
    04
    The PPI receiver is not active. For example, the SA z/OS agent is not available or is not properly customized.
    24
    The PPI is not active.
    25
    The ASCB address is no longer correct. Recycle the automation adapter.
    26
    The receiver program is not defined, for example, PPI=YES has not been added to INGXINIT.
    28
    An active subsystem interface address space was found, but an active PPI address space was not found.
    32
    No NetView storage is available.
    35
    The receiver buffer queue is full.

System action

The corresponding request failed.

Operator response

Analyze the return code. If necessary, contact your system programmer.

System programmer response

Analyze the return code. For example:

  • RC=1300 indicates that another SA Java process is running on the system and uses the same PPI receiver ID. Verify with D OMVS,A=nnnn whether there is another SA Java process running, where nnnn is the ASID of the PPI receiver ID that you obtained with the NetView DISPPI command.

    For example, PPI receiver ID INGEVE2E is used by the automation adapter and INGJVMxx is used by the End-to-End agent.

  • RC=1726 indicates that there might be a mismatch of the XCF group ID in the configuration file for the automation adapter or End-to-End agent. Verify whether it matches the XCF group ID that was defined in INGXINIT for the automation agent and HSAPRMxx for the automation manager. Alternatively, the statement PPI=YES might be missing in the INGXINIT member.

    The configuration file ing.adapter.plugin.properties defines the XCF group ID for the automation adapter. The configuration file inge2eagt.properties defines the XCF group ID for the End-to-End agent. This value might be overwritten by the start procedure itself or by the start parameters of the corresponding APL entry in the automation policy.

INGX9821E Object of class class has already been destroyed.

Explanation

Internal error.

System action

The corresponding request failed.

Operator response

Contact your IBM Support Center.

System programmer response

None.

INGX9822E Environment error. Check handle failed with return code return_code.

Explanation

Internal error.

System action

The corresponding request failed.

Operator response

Contact your IBM Support Center.

System programmer response

None.

INGX9823E Class class cannot load DLL dll.

Explanation

The JNI DLL cannot be loaded from the specified Java class.

System action

All communication services will fail.

Operator response

Check the libpath.

System programmer response

None.

INGX9830E INGXStream failed reading from the data stream. Attempted to read expected bytes and got actual bytes.

Explanation

The data stream decoder expected to read expected number of bytes but got only actual bytes.

System action

The corresponding request fails.

Operator response

Check why connection was broken.

System programmer response

None.

INGX9831E INGXStream failed reading from the data stream. Found unexpected end-of-data.

Explanation

The data stream decoder did not find the end-of-data marker. Data might be corrupted. The connection might have broken or there is an internal data stream error.

System action

The corresponding request fails.

Operator response

Check why connection was broken.

System programmer response

None.

INGX9833E INGXStream failed due to invalid header.

Explanation

The data stream decoder found an invalid header in the data stream.

System action

The corresponding request fails.

Operator response

Contact your IBM Support Center.

System programmer response

None.

INGX9840E Execution of a remote REXX command handler aborted.

Explanation

The corresponding request cannot be executed within the SA z/OS NetView backend.

System action

The corresponding request fails.

Operator response

Analyze the NetView log for more SA z/OS messages or REXX syntax errors, or both.

System programmer response

None.

INGX9850E FileIO function function failed, rc=rc reclen=rl fname=dsn fmode=mode

Explanation

An I/O error occurred while accessing a z/OS data set from a Java program. For example, opening or reading the SMF report.

  • The variable function is the name of the function that detected the IO error.
  • The variable rc is the return code from the I/O service routine libingjrio.so.
  • The variable rl is the local record length used to access the data set.
  • The variable dsn is the name of the data set.
  • The variable mode is the file mode used to access the data set.

System action

Processing terminates.

Operator response

Perform problem determination and correct the problem.

INGX9854E At least one input parameter is missing.

Explanation

This is a generic message that is issued when at least one input parameter was not specified or its value is null.

System action

Processing terminates.

Operator response

Perform problem determination, for example, check the input data, and correct the problem.

INGX9855E function has been stopped due to a failure, rc=rc

Explanation

An error occurred and the specified function terminates.

  • The variable function is the name of the function that terminates due to an error.
  • The variable rc is the return code:
    16
    The logger object cannot be instantiated.
    32
    Processing failed due to an exception.
    40
    Exception occurred during cleanup.

System action

Processing terminates.

Operator response

Perform problem determination, analyze associated exceptions and correct the problem.

INGX9856E Illegal syntax or format, data

Explanation

This is a generic message that is issued when a conversion error occurred in a Java program. For example, the data and time string from an SMF report are converted to an integrated timestamp of a specific format.

  • The variable data is diagnostic data that might describe the reason for the problem in more detail.

System action

Processing terminates.

Operator response

Perform problem determination, for example, check the input data, and correct the problem or contact your IBM Support Center.

INGX9860I function starting to feed the SA z/OS SMF report into DB2 table.

Explanation

The program is being started. It reads the SMF report, converts it to EEZ format and puts it into the DB2 table. This message is written to syslog.

  • The variable function is the name of the function that issued the message.

System action

None.

Operator response

None.

INGX9861I function is going to connect to DB2.

Explanation

The program tries to connect to the remote or local DB2 via JDBC driver.

  • The variable function is the name of the function that issued the message.

System action

None.

Operator response

None.

INGX9862I function is going to open the SMF report dsn

Explanation

The program tries to open the SMF report. The SMF report must have been generated before this program runs.

  • The variable function is the name of the function that issued the message.
  • The variable dsn is the name of the data set that contains the SMF report to be processed.

System action

None.

Operator response

None.

INGX9863I function is going to feed DB2 with the SMF report.

Explanation

The program attempts to read the SMF report, and converts each record from the SMF report to a row in the corresponding EEZ tables in DB2.

  • The variable function is the name of the function that issued the message.

System action

None.

Operator response

None.

INGX9864I function fed num events successfully into the DB2 table within time seconds.

Explanation

The program has successfully put the specified number of events from the SMF report into the DB2 table.

  • The variable function is the name of the function that issued the message.
  • The variable num is the number of records converted.
  • The variable time is the number of seconds taken by the program to feed DB2 with the SMF records.

System action

None.

Operator response

None.

INGX9865I Contents of EEZFeeder properties file: config_parms

Explanation

The input data from STDENV is converted to an internal properties file for the eezfeeder.jar.

  • The variable config_parms is the list of configuration parameters that is passed to eezfeeder.jar.

System action

None.

Operator response

None.

INGX9866I function completed successfully.

Explanation

The program has successfully put the SMF report into the EEZ tables in DB2.

  • The variable function is the name of the function that issued the message.

System action

None.

Operator response

None.

INGX9870I System Automation Agent Java Plugin 'nickname' failed: 'reason'

Explanation

The Automation Agent Java Framework invoked a plugin with name nickname. The plugin failed and a reason is provided which describes the error.

System action

The Java plugin cannot execute the request. Processing of the Automation Agent Java Adapter continues.

Operator response

None.

System programmer response

Usually, the reason starts with a message ID. Look for that message description in this case. Otherwise reason describes the error. Analyze the log file of the associated Automation Agent Java Adapter. Search for further error messages which may provide more details about the reason of the error.

INGX9871I System Automation Agent RPC from Java Plugin to Netview failed:'reason'

Explanation

The Automation Agent Java Framework attempted to call a NetView command but the attempt failed. The reason of the failure is described in the reason text.

System action

The Java plugin cannot execute a command on the local System Automation NetView Agent. Processing of the Automation Agent Java Adapter continues.

Operator response

None.

System programmer response

The reason starts with a message ID. Look for that message description. Analyze the log file of the associated Automation Agent Java Adapter space. Search for further error messages which may provide more details about the reason of the error.

INGX9872I System Automation Agent Java Plugin with nickname 'nickname' not found.

Explanation

The Automation Agent Java Framework tries to invoke a plugin with name 'nickname'. However a plugin with matching 'nickname' cannot be found.

System action

None.

Operator response

None.

System programmer response

Look in the NetView log and search for correlated error messages in order to find the System Automation command that tried to call the Java plugin. Check if this command requires a Java plugin installation.

INGX9873I System Automation Java Plugins are not available or not initialized

Explanation

During the startup of the Automation Agent Java Adapter, it will be checked that at least one plugin is available and successfully initialized. If this is not the case, this message is issued and the address space stops.

System action

Address space stops.

Operator response

None.

System programmer response

Search for additional messages that explain the reason why the plugin cannot be initialized. For example because the plugin class cannot be found in class path.

INGX9874I System Automation Agent Java Adapter 'subsjob' is active.

Explanation

Message used for automation of the Automation Agent Java Adapter via System Automation policy.

System action

None.

Operator response

None.

System programmer response

None.

INGX9875I System Automation Agent Java Adapter 'subsjob' is ready.

Explanation

Message used for automation of the Automation Agent Java Adapter via System Automation policy.

System action

None.

Operator response

None.

System programmer response

None.

INGX9876I System Automation Agent Java Adapter 'subsjob' has been stopped.

Explanation

Message used for automation of the Automation Agent Java Adapter via System Automation policy.

System action

None.

Operator response

None.

System programmer response

None.

INGX9877I System Automation Agent Java Adapter 'jobname' has been stopped due to failure, rc=return code

Explanation

The Automation Agent Java Adapter terminates abnormally. You may exploit this message for use by defining a System Automation policy for setting the Automation Agent Java Adapter in the status ABENDED.

  • The variable jobname is the name of the corresponding job.
  • The variable return code can be:
    0
    Success
    4
    Abend posted by plugin
    8
    Abend mainline

System action

Automation Agent Java Adapter terminates.

Operator response

None.

System programmer response

None.

INGX9879I System Automation Agent Java Plugin with nickname 'nickname' cannot be invoked: errortext.

Explanation

The Automation Agent Java Framework tries to invoke a plugin with name 'nickname'. However a plugin with matching nickname cannot be invoked because an error occurred. The errortext described the reason of the error.

System action

None.

Operator response

None.

System programmer response

Try to fix the problem if errortext gives you an indication. If necessary, contact IBM support Center.

INGX9880I System Automation Java Plugin 'nickname' cannot be loaded

Explanation

The Automation Agent Java Framework tries to reload the Java class representing the plugin with name 'nickname'. However the class cannot be found.

System action

None.

Operator response

None.

System programmer response

Adapt the classpath in the script ingjava accordingly.

INGX9881I System Automation Java Plugin 'nickname' terminates adapter due to: 'description'

Explanation

The plugin encountered a problem that requires the adapter to terminate. The 'description' describes the reason given by the plugin.

System action

Adapter terminates.

Operator response

None.

System programmer response

Try to solve the problem described by 'description'.

INGX9882I System Automation Agent Adapter jobname terminates unexpectedly due to reason

Explanation

The Automation Agent Java Adapter terminates abnormally due to an unhandled exception that is caught by the mainline.
  • The jobname variable is the name of the corresponding job.
  • The reason variable provides diagnostic information about the abnormal termination.

System action

The Automation Agent Java Adapter terminates.

Operator response

None.

System programmer response

Check the reason that this message provides and try to find the cause of the problem.

Analyze the log file of the associated Automation Agent Java Adapter. Search for further error messages that might provide more details about the cause of the error.

INGX9901E INGXPluginLogger cannot initialize com.ibm.log.EEZLoggerJLog.

Explanation

An attempt to create a logger for the SA z/OS plug-in component was unsuccessful.

System action

No message or trace data is written to the logger output destination.

Operator response

None.

INGX9902I INGXPluginLogger has successfully been initialized using configuration file file from path path.

Explanation

The message and trace data of the SA z/OS plug-in will be written to the logger output destination.

System action

None.

Operator response

None.

INGX9904E Adapter plug-in initialization was unsuccessful.

Explanation

The initialization of the SA z/OS plug-in was not successful.

System action

Start up of plug-in is stopped.

Operator response

Installation or customization was erroneous, for example, the logger or the plug-in configuration file. Also check whether the automation adapter customization for NetView is correct.

INGX9905E Adapter function function failed: exception text

Explanation

The specified adapter plug-in function was unsuccessful. An exception was caught from an underlying component.

System action

None.

Operator response

Read the original exception and follow its explanation.

INGX9906E Error message from SA z/OS: SA z/OS message

Explanation

Execution of a command using SA z/OS was unsuccessful. This message presents the extracted error message.

System action

None.

Operator response

For details about the extracted error message see IBM Z System Automation Messages and Codes or IBM Z NetView Messages and Codes.

INGX9910I The command cmd will be performed for resource res on behalf of user usr with comment: cmt

Explanation

A user has issued a command that relates to a resource. This command has been received by the adapter and will be performed by automation on the indicated resource.

  • The variable cmd shows the end-to-end command that was issued against the adapter.
  • The variable res shows the name of the SA z/OS resources.
  • The variable usr shows the end-to-end operator name that issued the command.
  • The variable cmt shows the comment that was entered by the operator.

System action

The command has been received and will be executed for the resource.

Operator response

None.

INGX9911I The command cmd will be performed for system sys on behalf of user usr

Explanation

A user has issued a command that relates to a system. This command has been received by the adapter and will be performed by automation on the specified system.

  • The variable cmd shows the end-to-end command that was issued against the adapter.
  • The variable sys shows the name of the system that is involved with the command.
  • The variable usr shows the end-to-end operator name that issued the command.

System action

The command has been received and will be executed.

Operator response

None.

INGX9912I The command to move resource group grp away from system sys will be performed on behalf of user usr with comment: cmt

Explanation

A user has issued a request to move a resource group away from specified system. This command has been received by the adapter and will be performed by automation.

  • The variable grp shows the name of the group that is involved with the command.
  • The variable sys shows the name of the system that is involved with the command.
  • The variable usr shows the end-to-end operator name that issued the command.
  • The variable cmt shows the comment that was entered by the operator.

System action

The command has been received and will be executed.

Operator response

None.

INGX9913I The command to move resource group grp to the home system will be performed on behalf of user usr with comment: cmt

Explanation

A user has issued a command that relates to a resource. This command has been received by the adapter and will be performed by automation on the indicated resource.

  • The variable grp shows the name of the group that is involved with the command.
  • The variable usr shows the end-to-end operator name that issued the command.
  • The variable cmt shows the comment that was entered by the operator.

System action

The command has been received and will be executed.

Operator response

None.

INGX9914I The command to move resource group grp to system sys will be performed on behalf of user usr with comment: cmt

Explanation

A user has issued a command that relates to a resource. This command has been received by the adapter and will be performed by automation on the indicated resource.

  • The variable grp shows the name of the group that is involved with the command.
  • The variable sys shows the name of the system that is involved with the command.
  • The variable usr shows the end-to-end operator name that issued the command.
  • The variable cmt shows the comment that was entered by the operator.

System action

The command has been received and will be executed.

Operator response

None.

INGX9915I Command reset from non-recoverable error will be performed on resource res on behalf of user usr

Explanation

A user found a non-recoverable resource, which means the resource is not automated until a user issues the reset command. The reset command has been received by the adapter and will be performed by automation on the indicated resource.

  • The variable res shows the name of the SA z/OS resources.
  • The variable usr shows the end-to-end operator name that issued the command.

System action

The command has been received and will be executed for the resource.

Operator response

None.

INGY1000I service FAILED IN MODULE module, RC=return_code, REASON=reasoncode error_info

Explanation

An unexpected return code was retrieved from the service call mentioned in the message.

  • The variable service shows the name of the service that failed.
  • The variable module shows the name of the module where the error occurred.
  • The variable return_code shows the value of the return code that was issued.
  • The variable reason error_info shows the value of the reason code that was returned and indicates the cause of the error.
Use Table 6 to determine the cause of the error:
Table 6. Return and Reason Codes of INGY1000I
Service Return Code Reason Code Explanation
INGPYENC 8 1 Incorrect parameter passed to the encoding routine.
INGPYENC 8 2 The generated instruction stream is on a higher level than allowed.
INGPYDEC 8 1 CRC value mismatch detected.
INGPYDEC 8 2 Incorrect table identifier found in the instruction stream.
INGPYDEC 8 3 Incorrect agent role/command combination found in the instruction stream.
INGPYDEC 8 4 Bad work item received: total length of work item is less than 0.
INGPXRPC
INGPYRCV
0 20 REXX variable pool problem.
INGPXRPC
INGPYRCV
0 24 A severe error occurred. See the netlog for further details.
INGPXRPC
INGPYRCV
0 28 The sysplex communication manger is not available.
INGPXRPC
INGPYRCV
0 2C An abend occurred.
INGPOPPI any any See the appropriate NetView manual where the service call that is mentioned in the message is described.

System action

Processing stops.

User response

For module names prefixed with INGPX, see also Sysplex Communication Services Return and Reason Codes.

Examine the return and reason codes from the service call and contact your system programmer.

INGY1001I SEVERE ERROR DETECTED IN MODULE module, REASON=reason

Explanation

An internal error has occurred.

  • The variable module shows the name of the module where the error occurred.
  • The variable reason shows the value of the reason code that was returned and indicates the cause of the error. It can have the following values:
    1
    An incorrect function code was specified for invoking the instruction builder.
    2
    An incorrect request code was specified for invoking the instruction builder.
    3
    The data contained in the passed data stem does not fit in the work buffer.
    4
    Incorrect parameters detected when the automation manager interface routine was called. The number of specified parameters exceeds the maximum number allowed.

System action

The request is canceled. A return code is sent to the program that issued the request.

User response

Examine the reason code for the possible cause of the error and contact your system programmer.

INGY1002I NOT ENOUGH STORAGE TO HANDLE COMMAND/REQUEST

Explanation

A GETMAIN failure occurred.

System action

The command or process in progress when the error occurred terminates.

User response

None.

INGY1003E ABNORMAL TERMINATION abend_code, REASON=abend_reason, MODULE=module, FOOTPRINT=footprint

Explanation

A system service or instruction has failed.

  • The variable abend_code shows the value of the abend code.
  • The variable abend_reason shows the value of the abend reason.
  • The variable module shows the name of the module where the error occurred.
  • The variable footprint shows the information about the caller of the routine.

System action

The command or process in progress when the error occurred is terminated.

User response

None.

INGY1004I AUTOMATION MANAGER CALL FAILED. RC=returncode, REASON=reason

Explanation

An error occurred while communicating with the automation manager.

  • The variable returncode shows the value of the return code that was issued. It can have the following values:
    4
    The request was processed. However, the automation manager found minor problems with the work item composed for the request.
    8
    An instruction that is part of the work item is in error. The reason code provides more details about the cause of the error.
    12
    There is a severe problem with the work item. It did not pass the instruction interpretation phase in the automation manager.
  • The variable reason shows the value of the reason code that was issued. The reason code is for internal diagnosis only.
    Reason Meaning
    10E0 The configuration data set does not contain an entry for the system that the automation manager is running on.
    See Automation Manager Reason Codes for details.

System action

The instance terminates.

User response

Examine the netlog for additional messages with more details about the cause of the error. In case that return codes 8 or 12 were issued report the error to your IBM Support Center if necessary.

INGY1005I TOO MANY PARAMETERS SPECIFIED FOR FUNCTION function

Explanation

Too many parameters are specified for the function.

  • The variable function shows the name of the function that failed.

System action

The command or process in progress when the error occurred is terminated.

User response

Check whether WebSphere MQ is set up properly as a z/OS subsystem. See WebSphere MQ for z/OS System Administration Guide for further information. Also check whether your specifications in SA z/OS are correct. See HSAPRMxx for information about the automation manager part and INGXINIT for information about the SA z/OS NetView agent.

INGY1006I NO COMMUNICATION PATH AVAILABLE TO destination

Explanation

The communication with the designated automation manager could not be established.

  • The variable destination shows the name of the automation manager that the command was routed to.

System action

None.

User response

Wait until the designated automation manager becomes available and reissue the command.

Verify that an automation manager was started. Make sure that the GRPID specifications in member HSAPRMxx and the corresponding DSIPARM member INGXINIT are identical.

INGY1010E LICENSE MANAGER CALL service FAILED, RC=return_code, STATUS=status_code

Explanation

When SA z/OS was initializing, a license check for this instance of SA z/OS was performed. An error occurred and a correct license certificate could not be found. A combination of return code and status code can be used to determine the cause of the error.

  • The variable service shows the name of the service that failed.
  • The variable return_code shows the value of the return code that was issued.
  • The variable status_code shows the value of the status code that was returned.

System action

The SA z/OS initialization stops and SA z/OS terminates.

System programmer response

Make sure that a valid license certificate for SA z/OS exists in the IBM License Manager database. If a valid license certificate exists and the error persists, contact your IBM Support Center.

User response

Notify your system programmer.

INGY1011I No License obtained for current SA z/OS version

Explanation

When SA z/OS was initializing, a license check for Version 2 of SA z/OS was performed. A valid license certificate for Version 2 could not be found, or the IBM License Manager reported an error condition.

System action

The SA z/OS initialization stops and SA z/OS terminates.

System programmer response

Make sure that a valid license certificate for SA z/OS exists in the IBM License Manager database. If a valid license certificate exists and the error persists, contact your IBM Support Center.

User response

Notify your system programmer.

INGY1012I Component component is not supported

Explanation

When the indicated component was initializing, a capability check was performed. The capability module does not allow use of the component.

  • The variable component shows the name of the component.

System action

The initialization stops and the component terminates.

Operator response

Notify your system programmer.

System programmer response

In case an improper capability module is being used by the indicated component, replace the module by a capability module that supports the component.

INGY1013I Module module not found

Explanation

When the indicated component was initializing, a capability check was performed. However, the capability module could not be located in the LPA, the STEPLIB concatenation, or the LNKLST concatenation.

  • The variable module shows the name of the capability module.

System action

The initialization stops and the component terminates.

Operator response

Notify your system programmer.

System programmer response

Add the required capability module to either location LPA, STEPLIB, or LNKLST and restart the component.

INGY1015E CONVERSION ERROR DETECTED. SEE INGDUMP DATA SET FOR DETAILS

Explanation

Routine INGPYDEC has detected a conversion error while decoding the buffer received from the automation manager. The buffer contains data that the INGPYDEC routine does not understand.

The INGPYDEC routine provides debugging information in the INGDUMP data set.

System action

SA z/OS continues ignoring the data that cannot be converted.

System programmer response

Contact your IBM Support Center and provide the information in the INGDUMP data set.

User response

Notify your system programmer.

INGY1020I Parameter value is not a valid parameter

Explanation

The specified parameter is invalid.

  • The variable value shows the value of the parameter. The value is invalid.
  • The variable parameter shows the name of the parameter.

System action

None.

Operator response

Correct the invalid parameter value.

System programmer response

None.

INGY1021I Required Parameter parameter missing.

Explanation

The named parameter is not specified.

  • The variable parameter shows the name of the parameter that is missing.

System action

None.

Operator response

Specify the missing parameter.

System programmer response

None.

INGY1022I REXX module name - Invalid syntax

Explanation

An SA z/OS REXX function detected a syntax error in its invocation. This error can result from extra operands being specified or expected operands that are missing.

  • The variable name is the name of the REXX routine that contains the error.

System action

The REXX function ends.

Operator response

Notify your system programmer that there are errors in the named REXX module.

System programmer response

Correct the statement in the REXX module.

INGY1023I REXX module name - Unknown variable name var_name

Explanation

An SA z/OS REXX function detected a syntax error in its invocation. The specified variable name was not recognized.

  • The variable name is the name of the REXX routine that contains the error.
  • The variable var_name is the name of the variable that is unknown.

System action

The REXX function ends.

Operator response

Notify your system programmer that there are errors in the named REXX module.

System programmer response

Correct the statement in the REXX module.

INGY1024I REXX module name - Error occurred. Reason=reason

Explanation

An SA z/OS REXX function detected an error during processing.

  • The variable name is the name of the REXX routine that contains the error.
  • The variable reason indicates the cause of the error. It can have the following value:
    1
    Retrieval of the NetView common global that is associated with the variable failed.
    2
    SA z/OS is not fully initialized.

System action

The REXX function ends.

Operator response

Examine the reason code for the possible cause of the error and contact your system programmer if necessary.

System programmer response

For reason code 2, examine the NetView log for additional messages that explain why accessing the common global failed.

INGY1025I REXX module name - Unknown subsystem/job name res_name

Explanation

An SA z/OS REXX function detected a syntax error in its invocation. The specified subsystem name or its job name is not defined to SA z/OS.

  • The variable name is the name of the REXX routine that contains the error.
  • The variable res_name is the name of the resource. It can be a subsystem name or its associated job name.

System action

The REXX function ends.

Operator response

Notify your system programmer that there are errors in the named REXX module.

System programmer response

Correct the statement in the REXX module.

INGY1026I Invalid Parameter value, Reason=reason

Explanation

An SA z/OS routine attempted to access the SA z/OS capability file but specified an invalid parameter.
  • The variable value specifies the parameter in error.
  • The variable reason specifies why the parameter was rejected.

System action

Execution continues.

Operator response

None.

System programmer response

Contact IBM Service.

INGY1090I Program name is not APF authorized

Explanation

The SA z/OS discovery engine was invoked but the module named in the message does not reside in an APF authorized library. The discovery engine must be authorized in order to pickup sensitive data such as program name or program parameters from the various address spaces.

  • The variable name holds the name of the program.

System action

The discovery engine terminates.

System programmer response

Place the named module into an authorized library.

INGY1097I Job jobname - STCname - User ended. RC=rc

Explanation

This message indicates that a started task (STC) that was initiated by SA z/OS has ended. The return code informs SA z/OS of the result and acts accordingly. Additional messages may be issued to the netlog.

  • The variable jobname indicates the job name that this STC was assigned.
  • The variable STCname indicates the STC that was invoked.
  • The variable User indicates the user that this job was run under.
  • The variable rc indicates the return code returned by the job:
    0
    Okay
    1
    There was a parameter mismatch
    3
    A timeout occurred
    10nn
    nn is the return code from the STC

System action

None.

Operator response

None.

System programmer response

None.

INGY1100I AN SA AUTOMATION MANAGER TAKEOVER HAS BEEN REQUESTED

Explanation

The SA z/OS automation manager found an WebSphere MQaccess problem. A takeover to another automation manager instance was forced. Message INGY1103I shows the reason for the takeover.

System action

An SA z/OS automation manager takeover is triggered. However, if the automation manager runs on the last system within the XCF group the takeover request is ignored. Instead, a switch from WebSphere MQ to XCF communication will be performed.

User response

None.

INGY1101I FAILED MQ FUNCTION WILL BE RETRIED

Explanation

A WebSphere MQ access problem has been detected, the failed function will be retried. See message INGY1103I for further information about the WebSphere MQ problem.

System action

The failed SA z/OS function is retried.

System programmer response

Examine preceding message INGY1103 or INGY1104 to understand the WebSphere MQ specific reason for the failure.

User response

None.

INGY1102I AUTOMATION STATE QUEUE IS CORRUPTED, PROCESSING CONTINUES

Explanation

A problem with the StateQueue has been detected. The SA z/OS automation manager now frees the StateQueue access. The queue is marked as GET/PUT disabled.

System action

The SA z/OS automation manager tries to continue its work without the StateQueue. However, severe problems may result in a takeover when the failed UOW ends. If the SA z/OS manager can continue, it will monitor the queue and try to reconnect when the queue is GET/PUT enabled again.

User response

Analyze the queue problem described in message INGY1103I. Redefine the StateQueue and mark it as GET/PUT enabled.

INGY1103I MQ FUNCTION function FAILED. REASON = MQreason'

Explanation

A WebSphere MQ function failed.

  • The variable function shows the function that failed.
  • The variable reason shows the reason code that indicates the cause of the error. See WebSphere MQ for z/OS Application Programming Reference for a description of the reason code.

System action

Depending on the severity and the SA z/OS instance having that problem it can be one of the following:

  • The WebSphere MQ function may be retried.
  • A manager takeover might be triggered.
  • The SA z/OS instance terminates.

User response

When the instance terminates, analyze the WebSphere MQ problem and restart the failed instance.

INGY1104I SEVERE MQ LINKAGE PROBLEM. REASON = reason

Explanation

This message indicates that WebSphere MQ is not set up correctly.

  • The variable reason shows the reason code that indicates the cause of the error.

System action

The instance terminates.

User response

See WebSphere MQ for z/OS System Administration Guide for further information. If you cannot resolve the problem contact your IBM Support Center.

INGY1105I MQ SUBSYSTEM mqssid NOT DEFINED OR INVALID.

Explanation

This message indicates that WebSphere MQ is not set up correctly.

  • The variable mqssid shows which WebSphere MQ definition is missing or invalid.

System action

The instance terminates.

User response

Refer to WebSphere MQ for z/OS System Administration Guide (SC34-6585-00) for further information. If you cannot resolve the problem contact your IBM Support Center.

INGY1106I INVALID MAXMSGL SPECIFICATION FOUND FOR THE queue, SPECIFIED VALUE = yourValue, REQUIRED VALUE = requiredValue. PROCESSING CONTINUES

Explanation

SA z/OS found inconsistent definitions in the queue. This can happen when samples that are provided with SA z/OS are used that do not reflect the latest WebSphere MQ versions.

  • The variable queue shows the name of the queue that contains incorrect definitions.
  • The variable yourValue shows the value that is not correct.
  • The variable requiredValue shows the value that should be specified.

System action

The instance continues processing, but the overall processing performance might be impacted when the required value is less than the one you specified.

User response

Correct the length and rerun the queue definition jobs when applicable.

INGY1107I PROBLEM DETECTED WITH THE AUTOMATION STATE QUEUE. QUEUE REMOVED FROM PROCESSING

Explanation

This message is issued after INGY1102, when the manager was able to complete processing. However, the State Queue remains corrupted and is now removed.

System action

The automation manager frees the State Queue from all accesses. After that you are able to redefine the queue.

User response

Analyze the reason for the corruption and redefine the queue.

INGY1108I AUTOMATION STATE QUEUE INSERTED AGAIN

Explanation

This message is related to message INGY1107. It contains notification that the manager tried to reinstate the queue again. This will happen when the manager detects that the queues are marked GET/PUT enabled again.

System action

The manager tries to reinstate the State Queue again.

User response

None.

INGY1109I RECOVERY FOR THE queue HAS BEEN STARTED. ACTIONCODE = action

Explanation

The manager detected a Queue Full condition and decided to recover from that situation.

  • The variable queue shows the name of the queue that is full.
  • The variable action shows the recovery action that is taken.

System action

The automation manager automatically tries to resolve queue full situations. The following action codes can occur:
1
Query requests from the work item queue are deleted without any processing.
2
The manager stops the update process to avoid an overflow of the agent queue.
3
All agents are asked to enter a slowdown mode. That means only important requests are sent to the manager.
4
Is a combination of actions 1 and 3.
5
The agent queue will be determined and 'zombie' messages are deleted. 'Zombie' messages are orders and responses and agents that are currently not active.
6
Is a combination of actions 1 and 5.

User response

None.

INGY1111I WAITING FOR MQ QUEUE MANAGER mqssid TO COME UP

Explanation

Either the automation manager or one of it's agents is waiting for the WebSphere MQ manager to come up. As long as is not running as an WebSphere MQ application, the automation manager cannot be restarted without possible loss of data.

  • The variable mqssid shows the subsystem ID of the WebSphere MQ Manager that SA z/OS tries to connect to.

System action

Processing continues.

User response

None.

INGY1112I WAITING FOR MQ PEER/LOCAL RECOVERY TO COMPLETE

Explanation

Takeover is waiting for WebSphere MQ peer/local recovery to complete.

System action

Takeover processing will actively poll WebSphere MQ to recognize when the WebSphere MQ peer recovery has been completed.

User response

None.

INGY1113I SEVERE MQ QUEUE RECOVERY PROBLEM, CANNOT CONTINUE

Explanation

During a takeover SA z/OS detected a severe WebSphere MQ related processing problem.

System action

The takeover cannot be completed HOT, and will be reset to WARM. However, processing continues.

User response

Analyze the reason of this problem using WebSphere MQ diagnostic means.

INGY1114I FOUND DEFECT WORKITEMS, CANNOT CONTINUE

Explanation

During a takeover SA z/OS detected that an automation manager request in the work item queue has been rolled back twice. It looks like a HOT takeover would again result in a termination.

System action

The takeover cannot be completed HOT, and will be reset to WARM. However, processing continues.

User response

Analyze the reason of the repeated termination of the manager.

INGY1120I Starting modname

Explanation

This message is written to indicate that the program has started.

  • The variable modname is the name of the module being started.

System action

None.

User response

None.

Module

INGPUSMF

class

None.

INGY1121I Ending modname

Explanation

This message is written to indicate that the program has ended.

  • The variable modname is the name of the module that has ended.

System action

None.

User response

None.

Module

INGPUSMF

class

None.

INGY1122I Unable to open the filename file. RC=retcode

Explanation

SA z/OS attempted to open the named file. The OPEN service failed.

  • The variable filename is the ddname of the data set.
  • The variable retcode is the return code from the OPEN call that failed.

System action

The INGPUSMF utility program ends.

User response

Examine the return code from the service call.

Module

INGPUSMF

class

None.

INGY1123I filename has unexpected record length of nnn

Explanation

While opening the named file, the utility program detected that the record length does not match the expected length of 80.

  • The variable filename is the ddname of the data set.
  • The variable nnn is the record length.

System action

The file that is in error is ignored and considered to be not present.

User response

Allocate the data set with the correct record length.

Module

INGPUSMF

class

None.

INGY1124I Specified user parameters

Explanation

This message documents the options that the INGPUSMF utility program works with.

System action

None.

User response

None.

Module

INGPUSMF

class

None.

INGY1125I Invalid parameter detected: option

Explanation

The INGPUSMF utility program encountered an invalid parameter option.

  • The variable option identifies the option that is invalid.

System action

The option that is in error is ignored.

User response

None.

Module

INGPUSMF

class

None.

INGY1126I All SMF records will be selected for processing

Explanation

This message indicates that no filtering option was specified when invoking the INGPUSMF utility program. Filter options are SYSID, FROM, and TO.

System action

None.

User response

None.

Module

INGPUSMF

class

None.

INGY1127I nnnnn records {read in | processed}

Explanation

This message records the number of records either read or processed.

  • The variable nnnnn is the number of records either read in or processed.

System action

None.

User response

None.

Module

INGPUSMF

class

None.

INGY1130I debug_text

Explanation

This is a generic informational message that shows debug information.

System action

Execution continues.

Operator response

None.

System programmer response

None.

INGY1131I PPI Receiver name is active. TASK=taskname

Explanation

The task identified by its name has been activated.

System action

Execution continues.

Operator response

None.

System programmer response

None.

INGY1132I PPI Receiver name has terminated. TASK=taskname

Explanation

The task identified by its name has been terminated.

System action

Execution continues.

Operator response

None.

System programmer response

None.

INGY1133E Command command to receiver failed with RC=retcode - description

Explanation

The SA z/OS USS process exit routine or its corresponding receiver attempted to execute a NetView PPI command that has failed.

  • The variable command indicates in the CNMNETV function that failed.
  • The variable receiver is the name of the PPI receiver that experienced the error.
  • The variable retcode is the return code from the CNMNETV call.
  • The variable description gives an explanation of the error.

For detailed error information, see IBM Z NetView Programming: Assembler. In case of NetView Program-to-Program Interface (PPI) errors see IBM Z NetView Application Programmer’s Guide for more information related to the service return code rc.

System action

Processing terminates.

Operator response

Report the error condition to your system programmer.

System programmer response

Report the problem to the SA z/OS service team for further diagnosis.

INGY1201E Unable to load NetView module module-name

Explanation

The TWS command exit module supplied by SA z/OS was unable to load the named module for execution.

System action

The command exit module supplied by SA z/OS returns a code of 4 to TWS. This forces the operation into an error state with error code 'OAUT'. Processing continues.

Operator response

Determine why the exit could not load the module. Ensure that the NetView load libraries are in either the link list or the STEPLIB concatenation for the TWS Controller address space.

System programmer response

If the module name is CNMNETV, ensure that the NETVIEW.CNMLINK data set is either in the system link list or in the STEPLIB concatenation for the TWS Controller address space.

INGY1202E PPI Command command-name to receiver-id failed with error-text

Explanation

The TWS command exit module supplied by SA z/OS attempted to execute a NetView PPI command that has failed.

command-name has the following values:
Command Name Meaning
QUERYPPI PPI request 1, Query if PPI services are available
QUERYRCV PPI request 2, Query the receiver ID status
SEND PPI request 14, Send a buffer to a receiver ID

receiver-id is the name of the PPI receiver that experienced the error. This can be ignored for the QUERYPPI command.

error-text gives an explanation of the error, as follows:
Text Meaning
Receiver is Disabled RC=4. The receiver is not active.
The receiver ID is defined but not active, so PPI has accepted a copy of the data buffer and queued it to the receiver ID queue.
PPI is Available RC=10. The PPI is available to process requests.
This is the result of a QUERYPPI command.
Receiver is Active RC=14. The PPI receiver ID specified is active.
This is the result of a QUERYRCV command.
Receiver is Inactive RC=15. The PPI receiver ID specified is inactive.
This is the result of a QUERYRCV command.
Receiver already Active RC=16. The PPI receiver ID specified is already active.
Receiver ECB not zero RC=18. The ECB specified in the request is not zero.
This occurs if the program does not clear the ECB before executing a RECEIVE command.
Request code not defined RC=20. The request code is not defined.
Not in Primary Mode RC=22. The program that issued this request is not running in PRIMARY mode.
PPI uses z/OS Cross-Memory services so the program must be running in PRIMARY mode for it to be successful.
Not Authorized RC=23. The program that issued this request is not authorized.
If the receiver ID has been defined to accept buffers only from authorized programs, this error occurs if the sender program is not authorized.
PPI is not Available RC=24. The PPI is not available.
This is the result of a QUERYPPI command.
ASCB ID is Invalid RC=25. The ASCB address is not correct.
In a RECEIVE command, the ASCB address is specified. If this does not match the address specified in the OPEN command this error occurs.
Receiver is not Defined RC=26. The receiver program is not defined.
This is the result of a QUERYRCV command.
No PPI Address Space RC=28. The NetView SSI address space is running, but no PPI function is defined to it.
The NetView SSI address space should be enabled to process PPI requests.
No Data in Queue RC=30. The data buffer queue for the receiver ID is empty.
This is the result of issuing a RECEIVE command but the buffer queue is empty.
Receive buffer is too small RC=31. The receive buffer specified in the request is too small to hold the queued buffer.
This occurs when the RECEIVE command specifies a buffer area that is too small to hold the queued data buffer. Re-issue the request specifying a larger buffer area.
No NetView Storage Available RC=32. The PPI has run out of NetView Storage.
Buffer length is invalid RC=33. The buffer length supplied in the request is invalid.
Receive Queue is full RC=35. The receiver ID queue is full.
This occurs for a SEND command when the receiver's buffer queue has reached its defined limit.
ESTAE cannot be established RC=36. A recovery environment could not be established.
SENDER, RECEIVER IDs are invalid RC=40. Either the sender or receiver ID is not valid.
Processing error has occurred RC=90. An internal processing error has occurred.

System action

The command exit module supplied by SA z/OS returns a code of 4 to TWS. This forces the operation into an error state with error code 'OAUT'. Processing continues.

Operator response

Report the error condition to your system programmer.

System programmer response

Report the problem to the SA z/OS service team for further diagnosis.

INGY1203I Request failed for adname-opnum (jobname) on wsname

Explanation

This is an information message to describe the TWS function that incurred an error during processing. This error message is always issued in addition to error messages INGY1201 and INGY1202.

  • adname is the TWS Application Description.
  • opnum is the TWS Operation Number in the Application Description.
  • jobname is optional and is the TWS jobname that is associated with the Operation Number.
  • wsname is the TWS Workstation name that was processing the Operation at the time of the error.

System action

The command exit module supplied by SA z/OS returns a code of 4 to TWS. This forces the operation into an error state with error code 'OAUT'. Processing continues.

Operator response

No action is required. This message provides information that can be used to help diagnose the problem.

System programmer response

None.

INGY1300I aa bb cc dd ee

Explanation

The Job Log Monitoring has read a message from a log data set and has sent this message to NetView for automation.

This message is a multi-line message. The first line is a label line showing the following tokens:

  • The variable aa is the owner of the job. The value is 8 characters long and filled with blanks if necessary.
  • The variable bb is the name of the job. The value is 8 characters long and filled with blanks if necessary.
  • The variable cc is the job identifier. The value is 8 characters long and filled with blanks if necessary.
  • The variable dd is the ddname of the corresponding spooled data set. The value is 8 characters long and filled with blanks if necessary.
  • The variable ee is the message ID that has been defined in the ISPF dialogs as one of the filter criteria. The value is up to 32 characters long and left-justified. The variable shows the value 'N/A' for all non-SA controlled jobs.

Each subsequent line represents a line of the original message.

Operator response

None.

System programmer response

Processing continues.

System programmer response

None.

INGY1301I Job Log Monitoring is ready for requests.

Explanation

The Job Log Monitoring task has been started and is now ready for processing requests.

System action

Processing continues.

Operator response

None.

System programmer response

None.

INGY1302I Job Log Monitoring is being terminated.

Explanation

Job Log Monitoring task has been stopped by a NetView stop command or during NetView termination. All opened data sets are closed and deallocated. And all monitoring information is deleted.

System action

The task is terminated.

Operator response

None.

System programmer response

None.

INGY1303I Job Log Monitoring has been suspended.

Explanation

The Job Log Monitoring task has been stopped on request. All opened data sets are closed and deallocated. The monitoring information is kept for restarting the task later.

System action

The task is terminated.

Operator response

None.

System programmer response

None.

INGY1304I JES2 or JES3 is not the primary job entry subsystem.

Explanation

SA z/OS only supports Job Log Monitoring for JES2 and JES3. Since the task may be started before any job entry subsystem is started the job entry subsystem check is delayed until the first request is received.

System action

The task is terminated.

Operator response

None.

System programmer response

Remove all definitions from Job Log Monitoring from your PDB and rebuild the PDB. This prevents SA z/OS from starting the task the next time when the configuration is being refreshed.

INGY1305I Job Log Monitoring has been started for uid-jnm-jid-ddn.

Explanation

The Job Log Monitoring task has allocated the spool data set that corresponds to indicated ddname and monitors new incoming messages. Note that empty messages lines are suppressed.

  • The variable uid is the owner of the job.
  • The variable jnm is the name of the job.
  • The variable jid is the job identifier.
  • The variable ddn is the ddname of the monitored spool data set.

System action

Processing continues.

Operator response

None.

System programmer response

None.

INGY1306I Job Log Monitoring has been stopped for uid-jnm-jid-ddn.

Explanation

The Job Log Monitoring task has removed the corresponding spool data set from monitoring. The data set has been closed and deallocated.

  • The variable uid is the owner of the job.
  • The variable jnm is the name of the job.
  • The variable jid is the job identifier.
  • The variable ddn is the ddname of the monitored spool data set.

System action

Processing continues.

Operator response

None.

System programmer response

None.

INGY1307I Error condition detected when processing uid-jnm-jid-ddn, RC=rc RSN=rsn.

Explanation

The Job Log Monitoring detected an error condition when it processes the spool data set that corresponds to the ddname. The return and reason codes describe the particular reason.

  • The variable uid is the owner of the job.
  • The variable jnm is the name of the job.
  • The variable jid is the job identifier.
  • The variable ddn is the ddname of the monitored spool data set.
  • The variable rc shows the return code:
    8
    Message retrieval failed.
    12
    Stop monitoring failed.
    16
    Start monitoring failed.
  • The variable rsn shows the reason code in hexadecimal characters. The first byte of the reason code describes the function, the second byte is the return code of the failing macro, and the last two bytes represent the reason code of the failing macro. See Table 7.
Table 7. First byte (function code) of the reason code
Function Failing Macro Terminate
'01'x ESTAE Yes
'11'x STORAGE OBTAIN Yes
'12'x STORAGE RELEASE Yes
'21'x DYNALLOC ALLOCATE Yes
'22'x DYNALLOC FREE Yes
'31'x GENCB ACB  
'32'x GENCB RPL Yes
'33'x OPEN ACB  
'34'x MODCB RPL  
'35'x CLOSE ACB Yes
'36'x POINT RPL  
'37'x GET RPL  
'41'x GET CGLOBAL Yes
'42'x SET CGLOBAL Yes
'51'x RACROUTE AUTH  
'61'x CREATE Name/Token Yes
'62'x DELETE Name/Token Yes
'63'x READ Name/Token Yes
'71'x DSPSERV CREATE Yes
'72'x DSPSERV EXTEND  
'73'x ALESERV ADD Yes
'74'x ALESERV DELETE Yes
'75'x TCBTOKEN Yes
'76'x SRB Yes
'77'x LOAD Yes

System action

If the message was issued by the task INGTJLM, the task is terminated depending on the function that was performed (see Table 7).

Operator response

None.

System programmer response

Correct the error condition that relates to the function specific return and reason codes. Restart the task if necessary.

INGY1308I Internal error condition detected. RC=rc RSN=rsn.

Explanation

The Job Log Monitoring could not initialize successfully.

  • The variable rc shows the return code.
  • The variable rsn shows the reason code. For a description of the reason codes, refer to Table 7.

System action

The task is terminated when rc shows a value of 12 or higher.

Operator response

None.

System programmer response

If the task is terminated contact your IBM Support Center.

INGY1309I Job Log Monitoring encountered abend SCC=scc RSN=rsn.

Explanation

The Job Log Monitoring encountered the indicated abend. The system completion and reason codes describe the abend condition.

  • The variable scc shows the system completion code.
  • The variable rsn shows the abend reason code.

System action

After all data sets have been closed and deallocated the task is terminated.

Operator response

None.

System programmer response

When the cause of the abend is eliminated you may restart the task using the NetView command START.

INGY1310I Syntax error on parm.

Explanation

The command processor for Job Log Monitoring detected a syntax error.

  • The variable parm shows the parameter in error.
    CMD
    A required parameter is missing. Or, an improper combination of parameters or an unknown parameter has been detected.
    DDN
    The keyword value is not a valid ddname.
    INTERVAL
    The monitoring interval is not in the range 1 to 3600.
    JOBID
    The job identifier is incorrect or too long.
    JOBNM
    The job name is incorrect or too long.
    POLL
    The polling time is not in the range from 1 to 3600.
    OWNER
    The name of the job owner is incorrect or is too long.
    REQ
    The request is not one of the following: RECYCLE, START, STOP, STATUS, SUSPEND

System action

The command is rejected.

Operator response

Correct the error condition and reissue the command.

System programmer response

None.

INGY1311I Application jobnm(subsysnm) will not be monitored, RSN=rsn

Explanation

Monitoring is disabled for the indicated application because no filter criteria have been defined or the application does not run under control of JES2 or JES3.

  • The variable jobnm shows the job name of the application.
  • The variable subsysnm shows the subsystem name of the application.
  • The variable rsn shows one of the following reasons:
    1
    No filter criteria have been defined.
    2
    Application does not run under control of JES2 or JES3.

System action

Processing continues.

Operator response

None.

System programmer response

Correct the policy data, rebuild the ACF, and refresh the configuration data.

Note: You need to define at least one filter criteria even if all messages are processed.

INGY1312I Command processing failed, RC=rc RSN=rsn.

Explanation

The command processor for Job Log Monitoring detected an internal error.

  • The variable rc shows the return code of the internal error condition.
  • The variable rsn shows the reason code of the internal error condition:
    12
    No filter criteria found for the job.
    16
    Job has not been defined for monitoring.
    20
    No filter criteria could be found.

System action

The command is rejected.

Operator response

In case of reason code 20 verify that the filter criteria have been defined and that the clist INGRJLMP ran successfully.

System programmer response

None.

INGY1313I Job Log Monitoring task is not active

Explanation

The command processor found the Job Log Monitoring task inactive.

System action

The command is not processed.

Operator response

Start the task and reissue the command.

System programmer response

None.

INGY1314I uid-jnm-jid-ddn is already being monitored

Explanation

Job Log Monitoring does already monitor the spool data set that corresponds to the indicated ddname.

  • The variable uid is the owner of the job.
  • The variable jnm is the name of the job.
  • The variable jid is the job identifier.
  • The variable ddn is the ddname of the monitored spool data set.

System action

The command is ignored.

Operator response

None.

System programmer response

None.

INGY1315I uid-jnm-jid-ddn has not been activated for monitoring.

Explanation

Job Log Monitoring has not been instructed to monitor the spool data set of the indicated data set.

  • The variable uid is the owner of the job.
  • The variable jnm is the name of the job.
  • The variable jid is the job identifier.
  • The variable ddn is the ddname of the monitored spool data set.

System action

The command is ignored.

Operator response

None.

System programmer response

None.

INGY1316I Automation environment has not been initialized.

Explanation

The Job Log Monitoring task detected that the automation environment has not been initialized. If the task was already active all monitoring is delayed until the automation environment is initialized.

System action

The task is terminated if it was started by the command.

Operator response

Retry the command after the automation environment has been initialized.

System programmer response

None.

INGY1317I Job uid-jnm-jid not found.

Explanation

The Job Log Monitoring task did not find the indicated job active or on the output queue.

  • The variable uid is the owner of the job.
  • The variable jnm shows the job name.
  • The variable jid shows the job identifier.

System action

The command is rejected.

Operator response

In case a parameter was misspelled, correct the value and reissue the command.

System programmer response

None.

INGY1318I Job Log Monitoring has been terminated for uid-jnm-jid-ddn.

Explanation

The Job Log Monitoring task did not find the job active, but on the output queue. After all messages have been processed the monitoring is terminated for the spool data set that corresponds to the indicated ddname.

  • The variable uid is the owner of the job.
  • The variable jnm is the name of the job.
  • The variable jid is the job identifier.
  • The variable ddn is the ddname of the monitored spool data set.

System action

Processing continues.

Operator response

None.

System programmer response

None.

INGY1319I No Job Log Monitoring definitions found.

Explanation

The Job Log Monitoring task did not find any monitoring definitions. However, because of the ACF information SysOps assumes that the monitoring definitions are available.

System action

The ACF-based request is rejected. Only manual monitoring requests are honored.

Operator response

None.

System programmer response

Check the NetView log and the policy database definitions as to why the task could not find any monitoring definitions. The clist INGRJLMP prepares and stores the definitions used by the monitoring task.

INGY1320I DDname ddn of jnm/jid not found

Explanation

The Job Log Monitoring task did not find the indicated ddname in JCL image of the job.

  • Variable ddn shows the ddname.
  • Variable jnm shows the job name.
  • Variable jid shows the job identifier.

System action

The command is rejected.

Operator response

In case one of the keyword values was misspelled, correct the value and reissue the command.

System programmer response

None.

INGY1321I Multiple job ids (jid/jid) exist for jnm.

Explanation

An INGJLM START | STOP command was issued without the JOBID parameter. However, the Job Log Monitoring function found at least two job ids for the specified job name. The first two job ids are presented in the message.

  • The variable jnm shows the job name.
  • The variable jid shows a job identifier.

System action

The command is rejected.

Operator response

Reissue the command using a specific job id.

System programmer response

None.

INGY1322I Multiple jobs (uid/uid) exist for jnm.

Explanation

An INGJLM START | STOP command was issued without the OWNER parameter. However, the Job Log Monitoring function found at least two jobs for the specified job name but with different owners. The owners of the first two jobs are presented in the message.

  • The variable uid shows an owner of the job name.
  • The variable jnm shows the job name.

System action

The command is rejected.

Operator response

Reissue the command using a specific job id.

System programmer response

None.

INGY1323I reqtype job id failed. RC=rc1/rc2.

Explanation

The task INGTJLM failed to receive or return a job id.

Only when NetView has been started with SUB=MSTR and the task DSIRQJOB has not been defined, INGTJLM tries to receive a job id from the primary JES during task initialization. The job id is normally requested by DSIRQJOB. When the job id is not received any spool data set browse request results in assigning a non-printable job id which leaves JES 'not dormant' (message $HASP607) on shutdown and requires the CANCEL command to terminate JES.

  • The variable reqtype shows the type of request.
  • The variable rc1 shows the SSI return code.
  • The variable rc2 shows additional return code information for return code 0.

Refer to "MVS Using the Subsystem Interface" for a detailed explanation of the return codes.

System action

The task is terminated.

Operator response

Correct the error condition and restart the task.

System programmer response

None.

INGY1324I Job id jid received.

Explanation

The task INGTJLM received the indicated job id from JES.

Only when NetView has been started with SUB=MSTR and the task DSIRQJOB has not been defined, INGTJLM requests a job id from the primary JES during task initialization. Without a job id any spool data set browse request results in assigning a non-printable job id which leaves JES 'not dormant' (message $HASP607) on shutdown and requires the CANCEL command to terminate JES.

  • The variable jid shows the job id.
Note: The request was done without requiring the allocation of a joblog.

System action

Processing continues. The job id will be returned to JES at task termination.

Operator response

None.

System programmer response

None.

INGY1325I Job id jid returned.

Explanation

The task INGTJLM returned the indicated job id to JES. The job id was requested during task initialization because NetView has been started with SUB=MSTR and the task DSIRQJOB has not been defined.

  • The variable jid shows the job id.

System action

Processing continues.

Operator response

None.

System programmer response

None.

INGY1326I Job Log Monitoring suspended due to missing job id.

Explanation

The task INGTJLM detected that the task DSIRQJOB has not received a job id from JES or has returned the job id to JES. Without a job id any spool data set browse request results in assigning a non-printable job id which leaves JES 'not dormant' on shutdown and requires the CANCEL command to terminate JES. To prevent JES from being canceled the task performs an internal SUSPEND command. All open data sets are closed and deallocated. The monitoring information is kept for restarting.

System action

The task is terminated.

Operator response

None.

System programmer response

Determine the reason why the job id is not available. After the task DSIRQJOB has received a job id again (refer to message DWO154I) the task INGTJLM is automatically restarted.

INGY1327I req_type of JES node information failed. RC=rc1/rc2/rc3

Explanation

The task INGTJLM failed to determine the owner or the task could not release the node of JES2 information provided by JES.

The node id is part of the resource name that is used to perform the SAF check for verifying read access to a JESSPOOL resource associated with a spool data set.

  • The variable req_type shows the type of request.
  • The variable rc1 shows the SSI return code.
  • The variable rc2 shows the SSOBRETN field.
  • The variable rc3 shows the SSJPRETN field.

System action

The task is terminated.

Operator response

None.

System programmer response

Correct the error condition and restart the task.

INGY1328I No READ access to internal spool data set of owner-job-jid

Explanation

Job log monitoring has no READ access to an internal spool data set of the indicated job. The internal spool data set holds relationship information between ddnames and spool data sets.
  • The variable owner shows the owner of the job.
  • The variable job shows the name of the job.
  • The variable jid shows the job identifier.

System action

The request is rejected.

Operator response

None.

System programmer response

Search the netlog or syslog of the profile name that inhibits Job Log Monitoring from accessing the spool data set. Correct the problem and re-issue the request.

INGY1329I SAF check of request aa failed, RC=bb

Explanation

The issuer of the command is not allowed to perform the indicated request.
  • The variable aa shows the request.
  • The variable bb shows the return code of the NetView service DSIKVS.

System action

The request is rejected.

Operator response

Re-issue the command after you have been granted to perform the request.

System programmer response

None.

INGY1330I No valid primary job entry subsystem found.

Explanation

The Job Log Monitoring system could not detect a valid primary job entry subsystem. Either the supported subsystem has not initialized yet or an unsupported subsystem is the primary job entry subsystem.

System action

The request is rejected.

Operator response

When the primary job entry subsystem is supported, re-issue the command after the subsystem has initialized.

System programmer response

None.

INGY1331I IEFSSREQ request req failed for uid-jnm-jid-ddn with RC=ssirc

Explanation

The job marked the spool data set for spinning off. The task INGTJLM failed to determine the current data set name of the indicated ddname.
  • The variable req shows the type of request.
  • The variable uid shows the owner of the job.
  • The variable jnm shows the name of the job.
  • The variable jid shows the job identifier.
  • The variable ddn shows the DD name.
  • The variable ssirc shows the SSI return code.
Refer to 'SSI Function Code 80' in MVS Using the Subsystem Interface for a detailed explanation of the return code.

System action

The request is rejected.

Operator response

None.

System programmer response

For return code 4, remove the JESLOG parameter and restart the job.

For return code 24, wait for the completion of the SSI and start the monitoring manually.

For all other return codes, contact your IBM Support Center.

INGY1332I Next SPIN data set for uid-jnm-jid-ddn not found.

Explanation

The indicated job ended before Job Log Monitoring could allocate the next spool data set in sequence. All data of this data set is lost.
  • The variable uid shows the owner of the job.
  • The variable jnm shows the name of the job.
  • The variable jid shows the job identifier.
  • The variable ddn shows the DD name.

System action

Monitoring for the indicated DD name is terminated.

Operator response

None.

System programmer response

Hold the spool data set until Job Log Monitoring has processed the data set. Check for messages INGY1333I or INGY1306I to determine when the spool data set can be released.

INGY1333I SPIN message found: aa-bb-cc-dd-ee-ff

Explanation

Job Log Monitoring has trapped the SPIN message for the indicated data set. This means JES has allocated a new spool data set for the ddname. And, subsequent messages are written to the data set.
  • The variable aa shows the owner of the job.
  • The variable bb shows the name of the job.
  • The variable cc shows the job identifier.
  • The variable dd shows the DD name.
  • The variable ee shows the spool data set identifier.
  • The variable ff shows the SYSOUT identifier of the job output that is associated with the spool data set.
The SYSOUT identifier can be used in subsequent spool commands to release or cancel the data set, for example, on the OUTGRP parameter of a JES2 spool command, or on the DSN parameter of a JES3 spool command.

System action

Processing of the indicated spool data set identifier has finished.

Operator response

None.

System programmer response

None.

INGY1334I req request failed, RSN=rsn

Explanation

The command processor could not complete the indicated request successfully.
  • The variable req shows the request.
  • The variable rsn shows the reason code. For a description of the reason codes, refer to table Table 7.

System action

The command is rejected.

Operator response

None.

System programmer response

Contact your IBM Support Center.

INGY1335I req request failed, RC=rc COMP=cc CODE=code RSN=rsn.

Explanation

Job Log Monitoring scheduled an SRB in the Master address to create, extend, or delete a data space. The SRB did not complete successfully for the indicated reason.
  • The variable req shows the request.
  • The variable rc shows the return code of the macro IEAMSCHD.
  • The variable cc shows the completion code of the macro IEAMSCHD.
  • The variable code shows information associated with the completion code.
  • The variable rsn shows additional information associated with the completion code.

System action

If the message is issued by the task INGTJLM the task is terminated.

Operator response

None.

System programmer response

If the task is terminated, contact your IBM Support Center.

INGY1336I RECYCLE behavior has been set to val.

Explanation

The behavior of Job Log Monitoring after a NetView recycle has been set to the indicated value.
  • The variable val shows one of the following values:
  • RESET - The internal structure is cleared on the next start after NetView has been recycled.
  • RESUME - Job Log Monitoring continues the monitoring on the next start after NetView has been recycled using the last information that is kept in the internal structure before monitoring is stopped.

System action

The command completed successfully.

Operator response

None.

System programmer response

None.

INGY1337I Job Log Monitoring suspended since JES had not initialized yet.

Explanation

The task INGTJLM detected that the Job Entry Subsystem had not initialized yet. The function is suspended and will automatically be resumed as soon as the task DSIRQJOB receives a job ID. In case that this task is not defined to NetView, either JES message (HASP492 or IAT2645) will restart INGTJLM.

System action

The task is terminated.

Operator response

None.

System programmer response

None.