FEPI INQUIRE NODE

Function

FEPI INQUIRE NODE returns information about a FEPI node.

Syntax

Read syntax diagramSkip visual syntax diagramFEPI INQUIRE NODE
 
>>-FEPI INQUIRE--NODE(data-value)--+-------------------+-------->
                                   '-ACQNUM(data-area)-'
 
>--+-----------------+--+-------------------+------------------->
   '-ACQSTATUS(cvda)-'  '-INSTLSTATUS(cvda)-'
 
>--+------------------------+--+------------------+------------->
   '-LASTACQCODE(data-area)-'  '-SERVSTATUS(cvda)-'
 
>--+---------------------+-------------------------------------><
   '-USERDATA(data-area)-'
 

The following commands allow you to browse all FEPI NODE definitions. Read the information on browsing earlier in this book before using the browsing commands.

FEPI Browse NODE

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 VTAM® ACB is opened or closed. The relevant CVDA values are:
ACQUIRED
The VTAM ACB for the node is open and ‘set logon start’ has completed.
ACQUIRING
A state of ACQUIRED has been requested but opening the VTAM 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 VTAM ACB has been closed.
RELEASING
A state of RELEASED has been requested but closing the VTAM ACB for the node has not yet been completed.

If ACQUIRING or RELEASING persist, the operator might need to intervene using VTAM commands to recover the node.

INSTLSTATUS(cvda)
returns the install 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 VTAM OPEN ACB, zero indicating success. For details of VTAM 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

Condition RESP2 Meaning
ILLOGIC 1 For START: browse of this resource type is already in progress.
For NEXT or END: START was not issued.
END 2 For NEXT: all resource definitions have been retrieved.
INVREQ 117 NODE name unknown.
[[ Contents Previous Page | Next Page Index ]]