You can obtain communications status information about your applications by using the Display Job (DSPJOB) or the Work with Job (WRKJOB) commands.
Communications status information can be obtained for:
v Active intersystem communications function (ICF) sessions
v Common Programming Interface (CPI) Communications conversations v User-defined communications
Information that can be obtained includes the number of input, output, and other operations, as well as the current operation and most recently issued operation.
You can obtain the communications status information, by using the DSPJOB, or WRKJOB commands with OPTION(*CMNSTS) specified. You can also select option 17 from the Display Job or Work with Job displays. To print communications status information, specify OUTPUT(*PRINT). The Work with Configuration Status, Work with Active Jobs, and Work with APPN Status can access the Work with Job display.
Selecting option 17 from the Display Job or the Work with Job displays when communications identifiers are active brings up the following display:
|
|
|
|
|
|
Display Communications Status
System: SYSNAMxxx
Job: DSP02 User: QUSER Number: 007798
Type options, press Enter.
5=Display
--- Communications --- ---Number of
Operations---Opt Identifier Method Output Input Other
_ ________________ ______________
_ B *UNKNOWN-CPIC 0 0 1
_ USRHANDLE1 *USRDFN 150 20 3
_ USRHANDLE2 *USRDFN 51 96 2
_ A APPC-CPIC 101 51 11
_ DEV1 INTRA-ICF 24 0 1
_ ICF00 SNUF-ICF 2 5 1
Bottom F3=Exit F5=Refresh F11=Display operations F12=Cancel F16=Job menu F17=Top F18=Bottom
Opt
Type in the number of the appropriate option next to one or more entries.
5=Display is the only valid option, and is used to display detailed information about the session. For ICF entries, the following kinds of displays can appear:
v Display CPI Communications v Display APPC ICF Session
v Display Asynchronous ICF Session v Display BSCEL ICF Session v Display Finance ICF Session v Display Intrasystem ICF Session v Display Retail ICF Session v Display SNUF ICF Session
For CPI Communications entries, the Display CPI Communications display appears. No options are supported for user-defined communications.
Communications Identifier
This is the identifier that is used by the application program.
CPI Communications conversations
Theconversation_IDreturned by the Initialize or Accept_Conversation calls and specified on all other calls.
ICF sessions
The program device name specified in the application for an active (acquired) ICF session.
User-defined communications
The communications handle that the application program is using.
Communications Method
This is the communications method being used.
ICF sessions
The ICF communications type used. Possible values are:
APPC-ICF
Advanced program-to-program communications
ASYNC-ICF
Asynchronous communications BSCEL-ICF
Binary synchronous communications equivalence link FINANCE-ICF
Finance communications INTRA-ICF
Intrasystem communications RETAIL-ICF
Retail communications SNUF-ICF
SNA upline facility communications CPI Communications conversations
The communications type that is used for the CPI Communications conversation. Possible values are:
*UNKNOWN-CPIC
CPI Communications conversations in the Initialize conversation_state.
APPC-CPIC
CPI Communications conversations in any conversation_state other than Reset or Initialize.
User-defined communications
This field always shows *USRDFN for communications identifiers that are using user-defined communications support.
Output
This is the number of output operations that are performed on the communications identifier.
ICF sessions
The number of successful ICF write operations. It does not count write operations in which another function, such as invite, is specified and the length is 0. Cancel, cancel-invite, fail, negative-response, and
request-write operations are not counted. Successful combined write/read operations are counted.
CPI Communications conversations
This count will be increased when a Send_Data completes successfully.
However, CPI Communications will not increase this count for a Send_Data call with asend_lengthof zero and another function that is requested such as asend_typeof CM_SEND_AND_CONFIRM. This count also will be increased when an Allocate call completes
successfully.
User-defined communications
The number of calls to Send Data (QOLSEND).
Input
This is the number of input operations that are performed on the communications identifier.
ICF sessions
The number of successful ICF read operations that received data.
CPI Communications conversations
The number of Receive_Data calls that have completed successfully.
User-defined communications
The number of calls to Receive Data (QOLRECV).
Other
This field contains operations that are counted and are not included under output or input operations.
ICF sessions
The number of all other high-level language operations such as open/acquire, acquire, release, and close.
CPI Communications conversations
The number of all other successful CPI Communications calls that are not counted under output or input.
User-defined communications
The number of calls to Enable Link (QOLELINK) and Set Filter (QOLSETF).
When F11 is pressed on the first Display Communications Status display, a second Display Communications Status display appears. This display lists the current or last operation issued for the communications identifier.
Display Communications Status
System: SYSNAMxxx
Job: DSP02 User: QUSER Number: 007798
Type options, press Enter.
5=Display
Communications
---Opt Identifier Method Operation _ ________________ ______________
_ B *UNKNOWN-CPIC CMINIT
_ USRHANDLE1 *USRDFN QOLSEND
_ USRHANDLE2 *USRDFN QOLRECV
_ A APPC-CPIC CMSEND
_ DEV1 INTRA-ICF SND,EGP,CFM,DET
_ ICF00 SNUF-ICF RFI
Bottom F3=Exit F5=Refresh F11=Display number of operations F12=Cancel F16=Job menu F17=Top F18=Bottom
Operation
This is the current or last operation that is issued by the program. The operation displayed is dependent on the communications method that is used for the communications identifier.
ICF sessions
The current or last ICF operation that is issued by the program. The ICF function codes are the same as the function codes used by the Trace ICF function, and are described as follows:
ACQ Acquire AWT Allow-Write CFM Confirm
CLS Close CNI Cancel-Invite CNL Cancel DET Detach EGP End-of-Group
EOA End-of-Session-Abnormal EOS End-of-Session
EVK Evoke FAL Fail
FMH Function-Management-Header FRC Force-Data
GTA Get-Attributes INV Invite
NRP Negative-Response
OPN Open with Acquire-Program-Device RCF Respond-to-Confirm
RCV Receive REL Release
RFI Read-From-Invited-Program-Devices RST Restore
RWT Request-to-Write SDV Subdevice-Selection SND Send
SPD Suspend TMR Timer
CPI Communications conversations
The current or last CPI Communications call that was issued, for example, CMINIT (Initialize_Conversation). Refer to the CPI Communications Reference book for more information on CPI Communications calls.
User-defined communications
The current or last user-defined communications call that was issued, for example, QOLELINK, QOLSETF, QOLSEND, or QOLRECV.
When the 5=Display option is entered next to the ICF00 identifier in the first or second Display Communications Status display, the following display appears:
Display SNUF ICF Session Program device . . . : ICF00 Remote location . . . : RCHSNUF Device . . . : RCHSNUF ICF file . . . : ICFFILE Library . . . : ICFLIB
Press Enter to continue.
F3=Exit F12=Cancel
The same information is displayed for the other ICF communication types. For APPC communications the local location name, mode, remote network identifier, logical unit of work ID, and state are also shown.
When the 5=Display option is entered next to the B identifier in the first or second Display Communications Status display, the following display appears:
Display CPI Communications Conversation identifier . . . : B
Remote location . . . : OVRTHERE Transaction program . . . : PARTNERPGM
Device . . . : APPCDEV Local location . . . : OVERHERE Mode . . . : BLANK Remote network identifier . . . . : APPN
Logical Unit of Work ID . . . : RPC.MARTY2.X'A8FD757A2105'.00001 State . . . : SEND
Side information . . . : EXAMPLE Library . . . : XMPLIB
Press Enter to continue.
F3=Exit F12=Cancel