Chapter 34 ETN32SRV (Guardian Enhanced TN3270 Server) Messages

The messages in this chapter are generated by the Guardian Enhanced TN3270 Server subsystem. The subsystem ID displayed by these messages includes ETN32SRV as the subsystem name.




	NOTE: Negative-numbered messages are common to most subsystems. If you receive a negative-numbered message that is not described in this chapter, see Chapter 15.

STARTED banner

banner

identifies the version of the Guardian Enhanced TN3270 Server software for the process.

Cause The Guardian Enhanced TN3270 Server process was started.

Effect The Guardian Enhanced TN3270 Server process can be configured.

Recovery Informational message only; no corrective action is needed.

SHUTDOWN

Cause A STOP PROCESS command was received by the Guardian Enhanced TN3270 Server.

Effect The Guardian Enhanced TN3270 Server is terminating.

Recovery Informational message only; no corrective action is needed.

Session established. Window subdev [ Host: host-name ] IPADDR=ipaddr PORT=port

`subdev`	is the name of the Guardian Enhanced TN3270 Server window.
`host-name`	is the name of the internet protocol (IP) host (if known) that is running the Guardian Enhanced TN3270 Server client session.
`ipaddr`	is the remote IP address of the client of the Guardian Enhanced TN3270 Server session.
`port`	is the remote port number of the client of the Guardian Enhanced TN3270 Server session.

Cause A session was established with the Guardian Enhanced TN3270 Server process.

Effect A Guardian Enhanced TN3270 Server window is assigned to the user initiating the session, if one is available.

Recovery Informational message only; no corrective action is needed.

Session opcode Error err Window subdev [ Host: host-name ] IPADDR=ipaddr PORT=port

`opcode`	is the socket operation that returned the error.
`err`	identifies the error returned by the Transmission Control Protocol/Internet Protocol (TCP/IP) process.
`subdev`	is the name of the window associated with the session during which the error occurred.
`host-name`	is the name of the internet protocol (IP) host (if known) that is running the Guardian Enhanced TN3270 Server client session.
`ipaddr`	is the remote IP address of the client of the Guardian Enhanced TN3270 Server session.
`port`	is the remote port number of the client of the Guardian Enhanced TN3270 Server session.

Cause An error occurred on an input/output (I/O) operation to the TCP/IP process for the specified session.

Effect The session is terminated.

Recovery Consult the Tandem TCP/IP Programming Manual for a definition of the error. If the error was due to a network problem, attempt to reestablish the session. If the error is 4022: Invalid Argument, or 4108: Unknown Option, review the client’s socket parameters and procedures and then retry the session connection. Restart the TCP/IP process if the failure repeats or for other error conditions.

Session terminated. Reason reas Window subdev [ Host: host-name ] IPADDR=ipaddr PORT=port Elapsed days Days hrs:mins:secs Msgs sent/rcvd: msgs-sent / msgs-rcvd Bytes sent/rcvd: bytes-sent / bytes-rcvd

`reas`	is the reason the user session was terminated.
`subdev`	is the name of the window associated with the session that was terminated.
`host-name`	is the name of the internet protocol (IP) host (if known) that is running the Guardian Enhanced TN3270 Server client session.
`ipaddr`	is the remote IP address of the client of the Guardian Enhanced TN3270 Server session.
`port`	is the remote port number of the client of the Guardian Enhanced TN3270 Server session.
`days`	is the elapsed time of the session, in number of days.
`hrs:mins:secs`	is the elapsed time of the session, in hours, minutes, and seconds.
`msgs-sent`	is the number of messages sent from the host to the client during the session.
`msgs-rcvd`	is the number of messages received from the client during the session.
`bytes-sent`	is the number of bytes sent by the host to the client during the session.
`bytes-rcvd`	is the number of bytes received from the client during the session.

Cause A user session was terminated for the reason specified.

Effect The window is available for reuse unless it was closed due to an application failure.

Recovery Reestablish the session if necessary.

SPI opname Error err

`opname`	identifies a NonStop Kernel file-system operation.
`err`	identifies the error returned by the Subsystem Programmatic Interface (SPI) procedure.

Cause An error occurred on a call to an SPI routine.

Effect The Guardian Enhanced TN3270 Server terminates and creates an Inspect save file.

Recovery Restart the Guardian Enhanced TN3270 Server process.

$RECEIVE opname Error err

`opname`	identifies a NonStop Kernel file-system operation.
`err`	identifies a file-system error.

Cause A file-system error occurred on the $RECEIVE file.

Effect The Guardian Enhanced TN3270 Server terminates and creates an Inspect save file.

Recovery Restart the Guardian Enhanced TN3270 Server process. Refer to Appendix B, for a definition of the specified error. For more detailed information including recovery actions, refer to the Guardian Procedure Errors and Messages Manual.

fsmid State machine error State=fsm.state Event=fsm.event ( objname )

`fsmid`	is the identification of the finite state machine (FSM) within the Guardian Enhanced TN3270 Server that generated the error.
`fsm.state`	is the current state of the FSM.
`fsm.event`	is a signal causing a predetermined action based on the current state and error.
`objname`	is the name of the object for which the FSM error occurred.

Cause An FSM error occurred.

Effect The Guardian Enhanced TN3270 Server terminates and creates an Inspect save file.

Recovery Restart the Guardian Enhanced TN3270 Server process. Contact your service provider and provide all relevant information as follows:

Descriptions of the problem and accompanying symptoms
Details from the message or messages generated
Supporting documentation such as Event Management Service (EMS) logs, trace files, and a processor dump, if applicable

If your local operating procedures require contacting the Global Mission Critical Solution Center (GMCSC), supply your system number and the numbers and versions of all related products as well.

Guardian opname error err [ Window: subdev ] [ Host: host-name ] [ IPADDR=ipaddr PORT=port ]

`opname`	identifies a NonStop Kernel file-system operation.
`err`	identifies a file-system error.
`subdev`	is the name of the window (if known) associated with the session on which the error occurred.
`host-name`	is the name of the internet protocol (IP) host (if known) that is running the Guardian Enhanced TN3270 Server client session.
`ipaddr`	is the remote IP address of the client (if known) of the Guardian Enhanced TN3270 Server session.
`port`	is the remote port number of the client (if known) of the Guardian Enhanced TN3270 Server session.

Cause A NonStop Kernel file-system procedure returned an error.

Effect None.

Recovery Informational message only; no corrective action is needed.

ABNORMAL TERMINATION: text

text

identifies the cause of the error.

Cause The Guardian Enhanced TN3270 Server encountered a fatal error described by text.

Effect The Guardian Enhanced TN3270 Server terminates, and then creates an Inspect save file.

Recovery Correct the problem and restart.

ASSERTION FAILURE: ( condition ) FILE: source-file Line: edit-linenumber

`condition`	is the error condition.
`source-file`	identifies the NonStop Kernel source file where the condition occurred.
`edit-linenumber`	identifies the line number of the NonStop Kernel source file where the condition occurred.

Cause The Guardian Enhanced TN3270 Server encountered a logical inconsistency in the code.

Effect The Guardian Enhanced TN3270 Server terminates, and then creates an Inspect save file.

Recovery Restart the Guardian Enhanced TN3270 Server process. Contact your service provider and provide all relevant information as follows:

Descriptions of the problem and accompanying symptoms
Details from the message or messages generated
Supporting documentation such as Event Management Service (EMS) logs, trace files, and a processor dump, if applicable

If your local operating procedures require contacting the Global Mission Critical Solution Center (GMCSC), supply your system number and the numbers and versions of all related products as well.

Network opcode error err on tcpip-process

`opcode`	is the socket operation that returned the error.
`err`	identifies the error returned by the Transmission Control Protocol/Internet Protocol (TCP/IP) process.
`tcpip-process`	is the name of the TCP/IP process that is reporting the error.

Cause The Guardian Enhanced TN3270 Server encountered an input/output (I/O) error on the socket used to monitor network connections requests.

Effect The socket to the TCP/IP process is closed and reopened.

Recovery The Guardian Enhanced TN3270 Server continues to try to reestablish the socket with TCP/IP for errors 14, 66, and 201. Monitor the Guardian Enhanced TN3270 Server to see if the socket can be restored. If the Guardian Enhanced TN3270 Server cannot automatically restore the socket, restart the TCP/IP process.

The Guardian Enhanced TN3270 Server stops or abends for other errors. If the Guardian Enhanced TN3270 Server had been running as a NonStop process pair, the backup process automatically assumes the primary process role and attempts to maintain the socket with TCP/IP. Monitor the Guardian Enhanced TN3270 Server to see if the socket is functioning properly with TCP/IP. If the socket is not functioning properly, restart the TCP/IP process.

GETHOSTBYADDR error err

err

identifies the error returned by the GETHOSTBYADDR function.

Cause The Guardian Enhanced TN3270 Server encountered an error trying to resolve a host name by a Domain Name Resolver configured in the RESCONF file. (The RESCONF file is used by the Domain Name Resolver to configure the Domain Name Server component of the Transmission Control Protocol/Internet Protocol (TCP/IP)).

Effect The Guardian Enhanced TN3270 Server does not report the client’s host name in Event Management Service (EMS) errors.

Recovery Reestablish communications with the Domain Name Resolver.

Logging switch to: coll

coll

is the name of the Event Management Service (EMS) collector to which logging was switched.

Cause The logging changed to the specified EMS collector due to an operator command or an error on a previous log file.

Effect EMS messages are written to a new EMS collector.

Recovery Informational message only; no corrective action is needed.

Primary Process Established: Process Name = process-name

process-name

is the Guardian Enhanced TN3270 Server process.

Cause The primary process of a Guardian Enhanced TN3270 Server NonStop pair started.

Effect The primary process tries to start a backup process.

Recovery Informational message only; no corrective action is needed.

Backup Process Established: Process Name = process-name

process-name

is the Guardian Enhanced TN3270 Server process.

Cause The backup process of a Guardian Enhanced TN3270 Server NonStop pair started.

Effect NonStop operation can begin.

Recovery Informational message only; no corrective action is needed.

Primary Process Failed: Process Name = process-name

process-name

is the Guardian Enhanced TN3270 Server process.

Cause The primary process of a Guardian Enhanced TN3270 Server NonStop pair failed.

Effect The backup process assumes the role of the primary process.

Recovery Informational message only; no corrective action is needed.

Backup Process Failed: Process Name = process-name

process-name

is the Guardian Enhanced TN3270 Server process.

Cause The backup process of a Guardian Enhanced TN3270 Server NonStop pair failed.

Effect The primary process tries to start another backup process.

Recovery Informational message only; no corrective action is needed.