SNAX/APC Application Programming Manual

Verb Definitions
SNAX/APC Application Programming Manual—138786
3-86
DISPLAY-STATUS Verb
DISPLAY-STATUS Verb
A local TP uses the DISPLAY-STATUS verb to request status of one or all of the local
LUs controlled by a SNAX/APC process.
The reply from DISPLAY-STATUS contains the state of the sessions or conversations.
If the session is active, DISPLAY-STATUS returns the partner LUNAME. If there is an
active conversation, DISPLAY-STATUS returns the local TP name, the count of verbs
issued over the session, and the outstanding verb (if any). If pacing is active, DISPLAY-
STATUS returns the pacing counts.
The information returned from DISPLAY-STATUS is in record format; it is up to the
application designer to format the data. The state information is numeric.
Any TP that has completed a TP-READY verb can issue DISPLAY-STATUS for the
local LU specified in that verb. Only authorized TPs can receive status from other local
SNAX/APC LUs. A TP is authorized by specifying the SESSION-CONTROL-
ATTRIBUTE field in the TP-NAME configuration record. If an unauthorized TP
requests status on other LUs, SNAX/APC terminates the conversation abnormally.
DISPLAY-STATUS must be the only UOW in an IPC message.
Note. The fields DSR-NUM-RECORDS and DSR-STATUS-AREA are not defined by
the SNAX/APC DDL because they cannot be created by DDL. The SNAX/APC DDL
provides example definitions for these fields in COBOL and TAL. You must create the
definitions for these fields.
Request Format
?SECTION DISPLAY-STATUS-REQ,TANDEM
01 DISPLAY-STATUS-REQ.
02 DS-HEADER.
03 REQ-UOW-ID PIC X(2).
03 REQ-UOW-CODE PIC 9(4) COMP.
02 DS-PARAMETERS.
03 DS-APC-LUNAME PIC X(8)
Reply Format
?SECTION DISPLAY-STATUS-REP,TANDEM
01 DISPLAY-STATUS-REP.
02 DSR-HEADER.
03 REP-UOW-ID PIC X(2).
03 REP-VERB-CODE PIC 9(4) COMP.
03 REP-RETURN-CODE PIC S9(4) COMP.
03 REP-RETURN-CODE-DETAIL PIC S9(4) COMP.
02 DSR-PARAMETERS.
03 DSR-APC-NETWORK-NAME PIC X(34).
01 DSR-NUM-RECORDS PIC 9(4) COMP.
01 DSR-STATUS-AREA.
02 DSR-STATUS-TEXT