FEPI INQUIRE NODE returns information about a FEPI node.

FEPI 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
- 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.
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 ]]