SNAX/APC Application Programming Manual

Verb Definitions
SNAX/APC Application Programming Manual—138786
3-92
DISPLAY-STATUS Verb
OUTSTANDING-VERB
contains the verb request code if a conversation is active and SNAX/APC is
processing a verb. If there is no active conversation or current verb, the field
contains a zero.
VERB-COUNT
indicates the number of LU 6.2 conversation verbs issued over this LU since the
session was activated. The count of verbs excludes all operator verbs and service
UOWs. When the verb count exceeds 65,535, SNAX/APC resets the value to zero.
Return Codes
The following return codes can be returned in the REP-RETURN-CODE field of
DSR-HEADER:
RC-OK
RC-DEALLOCATE-ABEND-PROG (LO)
Considerations
•
This verb cannot be used on parallel-session LUs or at version level S2 or S3. The
addressed LU must be a single-session LU. Otherwise, the following IPC return
code is returned:
REP-CODE = REQ-ERROR (3)
HEADER-RETURN-CODE = SERVICE-DENIED (3)
HEADER-RETURN-CODE-DETAIL = VERB-NOT-ALLOWED-FOR-PS-LU
(412)
•
In version S1, single session configuration—if the number of LUs is large and the
amount of data that needs to be returned by SNAX/APC is greater than the
read.count in the WRITEREAD used to send the verb to SNAX/APC, the data in the
reply will be truncated.
•
In version, single session configuration—if the number of LUs is large and the
amount of data that needs to be returned by SNAX/APC is greater than the
read.count in the WRITEREAD used to send the verb to SNAX/APC, the data in the
reply will be truncated.
•
If a DISPLAY-STATUS verb is processing when SNAX/APC receives a CANCEL
system message from the application program, SNAX/APC deactivates the session
and replies to the cancelled IPC. SNAX/APC frees the internal resources after
finishing the processing of the verb.