Messages ING001I to INGY1337I
Note that within NetView an additional * may be appended to the end of the message text.
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.
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:
- 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.
- 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:
- The REXX runtime library might not be installed on the remote system.
- 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
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
- 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
ATTACHcommand 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
DETACHcommand 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:
- Event notification is not enabled on this agent for any of the intended event notification targets.
- The Inform List of the resource does not contain the intended event notification target.
- 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.
- 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.
- 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 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.
| 8 | A timeout occurred. |
| 1nn | Failed to check the input data.
|
| 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.
|
| 5nn | Failed to check the input arguments of the command.
|
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
- 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
- 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
| 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 |
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.
| 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 |
| 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 |
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.
| 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
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:
| 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.
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
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 RETURNSystem 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.
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
AGT.sysplex.xcfgrp.TARGET.FROMDOM.domain.TODOM.
targetdomidSystem 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=xxxxinCLASS=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.
- 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:
| 0 | OK command executed |
| 4 | OK but NO data returned (only if RESP=YES) |
| 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) |
| 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 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.
| 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.
- 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.
- 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
NoneOperator 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
NoneOperator 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.
- 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 command – request
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.
- 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
INGCHW0EClasses
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.- 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
INGRX815Classes
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.- 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
INGRX815Classes
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.- 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, INGRVX80Classes
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.- 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
INGRX815Classes
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
INGRX806Classes
40ING826I 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
INGRX830Classes
40ING827I 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
INGRX830Classes
40ING828I 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
INGRX806Classes
40ING830I 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
INGCHW0EClasses
40ING831I 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
INGCHW0EClasses
40ING832I 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
INGCHW0EClasses
40ING920I 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.
- 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.
- 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.
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.
- TSO.plexname.system.CMDRCVR.SEND
- TSO.plexname.system.CMDRCVR.SEND
- TSO.plexname.system.CMDRCVR.SEND.USERTASK
| 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.
- 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.
- 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
longsincelongtoo 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=nnnnwhether 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=YESmight be missing in the INGXINIT member.The configuration file
ing.adapter.plugin.propertiesdefines the XCF group ID for the automation adapter. The configuration fileinge2eagt.propertiesdefines 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 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.
| 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.
See Automation Manager Reason Codes for details.
Reason Meaning 10E0 The configuration data set does not contain an entry for the system that the automation manager is running on.
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
- 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
- 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 | 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.
| 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.
| 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
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.
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.
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.
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.
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.