FEPI INQUIRE NODE

Inquire on a FEPI node.

Read syntax diagramSkip visual syntax diagram
FEPI INQUIRE NODE

>>-FEPI INQUIRE--NODE--(--data-value--)------------------------->

>--+-------------------------+--+-----------------------+------->
   '-ACQNUM--(--data-area--)-'  '-ACQSTATUS--(--cvda--)-'   

>--+-------------------------+---------------------------------->
   '-INSTLSTATUS--(--cvda--)-'   

>--+------------------------------+----------------------------->
   '-LASTACQCODE--(--data-area--)-'   

>--+------------------------+--+---------------------------+---><
   '-SERVSTATUS--(--cvda--)-'  '-USERDATA--(--data-area--)-'   

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 the VTAM® Programming manual.
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.


dfhp735.html | Timestamp icon Last updated: Monday, 5 June 2017