FEPI INQUIRE NODE

Description

FEPI INQUIRE NODE returns information about a FEPI node.

The following commands allow you to browse all FEPI NODE definitions.

FEPI INQUIRE NODE START
FEPI INQUIRE NODE(8-character data-area) NEXT
[The options are as for FEPI INQUIRE NODE]
FEPI INQUIRE NODE END

Options

ACQNUM(fullword binary data-area)

returns the number of times that the node has been acquired.

ACQSTATUS(cvda)

returns the acquire state—that is, whether the z/OS® Communications Server ACB is opened or closed. The relevant CVDA values are:

ACQUIRED

The z/OS Communications Server ACB for the node is open and ‘set logon start' has completed.

ACQUIRING

A state of ACQUIRED has been requested but opening the z/OS Communications Server ACB for the node and issuing ‘set logon start' has not yet been completed.

RELEASED

Sessions on any connections involving the node have been unbound and the z/OS Communications Server ACB has been closed.

RELEASING

A state of RELEASED has been requested but closing the z/OS Communications Server ACB for the node has not yet been completed.

If ACQUIRING or RELEASING persist, the operator might need to intervene using z/OS Communications Server commands to recover the node.

INSTLSTATUS(cvda)

returns the installation state of the node. The relevant CVDA values are:

INSTALLED

The node has been defined by INSTALL and is available for use.

NOTINSTALLED

The node is being discarded, but is still in use.

LASTACQCODE(fullword binary data-area)

returns the result of the last acquire request for the node; that is, the return code from the last z/OS Communications Server OPEN ACB, zero indicating success. For details of z/OS Communications Server return codes, see z/OS Communications Server: IP and SNA Codes.

NODE(8-character data-value/8-character data-area)

is the name of the node.

SERVSTATUS(cvda)

returns the service state of the node. The relevant CVDA values are:

INSERVICE

The node is in service and can be used in a conversation.

OUTSERVICE

The node is out of service and cannot be used for any conversation.

GOINGOUT

A state of OUTSERVICE has been requested but the node is still being used by a conversation.

USERDATA(64-character data-area)

returns the user data for the node. If no user data has been set, nulls are returned.

Conditions

ILLOGIC

RESP2 value:

1

For START: browse of this resource type is already in progress. For NEXT or END: START was not issued.

END

RESP2 value:

2

For NEXT: all resource definitions have been retrieved.

INVREQ

RESP2 value:

117

NODE name unknown.