Use this command to:
- Initialize one or all TPF Advanced Program-to-Program Communications
(TPF/APPC) conversation control blocks (CCBs) or all CCBs associated with a
specific LU
- Display the contents of a specific CCB
- Display a list of CCB IDs for conversations with a specific remote LU
- Display a summary of the number of active and inactive CCBs
- Display a summary of the number of CCBs in each conversation state
- Display the number of CCBs in a particular conversation state.
Requirements and Restrictions
None.
Format
- INIT
- initializes CCB resources and the fields in the session control block
(SCB) that are associated with the CCB.
- Note:
- Use this parameter only in a test environment and only when the TPF system is
in NORM state. Initializing an active CCB clears the CCB entry and can
cause unpredictable results.
- ALL
- initializes the lost CCBs. Any lost CCBs, which are CCBs
that are marked as in use but are not actually being used, are returned to the
pool of available CCBs.
- Force
- forces all CCBs to be initialized.
- N netid.nodename
- initializes all CCBs associated with the specified NAU, where
netid is the 1- to 8-character network identifier and
nodename is the 1- to 8-character LU name. The network ID
and name of a resource must both begin with a letter (A-Z), @,
#, or $. The remaining characters can be letters
(A-Z), numbers (0-9), @, #, or
$.
- Note:
- To specify an SNA network ID or resource name that contains dollar signs
($), you must type two consecutive dollar signs ($$) for
each dollar sign in the network ID or resource name. For example, if
the SNA resource name is $SNANAME, you must type
$$SNANAME.
- O ordinal
- initializes the CCB resource for the specified ordinal number, where
ordinal is the hexadecimal ordinal number.
- DF
- produces a formatted display for the specified CCB resources.
- O ordinal
- displays the CCB resources for the specified ordinal number, where
ordinal is the hexadecimal ordinal number.
- DU
- produces an unformatted display for the specified CCB resources.
- DC
- displays a summary of the number of CCBs.
- SUM
- displays a summary of the number of active and inactive CCBs.
- ALL
- displays a summary of the number of CCBs in each conversation
state.
- MAPPED
- displays a summary of the number of CCBs in each mapped conversation
state. If you omit this parameter, the basic conversation states are
displayed.
- state
- displays the number of CCBs in a particular basic conversation
state. The valid conversation state codes are:
- 00
- RESET
- 01
- SEND
- 02
- RECEIVE
- 03
- RECEIVED CONFIRM
- 04
- RECEIVED CONFIRM SEND
- 05
- RECEIVED CONFIRM DEALLOCATE
- 08
- PENDING DEALLOCATE
- 09
- END.
- Note:
- TPF does not support the other conversation state codes defined by the LU
6.2 architecture. Conversations using the TPF mapped
conversation interface are counted by their underlying basic conversation
state.
- N netid.nodename
- displays the CCB IDs associated with the specified NAU, where
netid is the 1- to 8-character network identifier, and
nodename is the 1- to 8-character LU name. The network ID
and name of a resource must both begin with a letter (A-Z), @,
#, or $. The remaining characters can be letters
(A-Z), numbers (0-9), @, #, or
$.
- Note:
- To specify an SNA network ID or resource name that contains dollar signs
($), you must type two consecutive dollar signs ($$) for
each dollar sign in the network ID or resource name. For example, if
the SNA resource name is $SNANAME, you must type
$$SNANAME.
Additional Information
Online help information is available for this command. To display
the help information, enter one of the following:
ZNCCB HELP
ZNCCB ?
Examples
The formatted (ZNCCB DF) and unformatted (ZNCCB DU) displays in the
examples provide the following information:
- Note:
- Not all of the information is in both displays.
- ALOCQ
- is the pointer to the next CCB entry, if any, on the queued ALLOCATE list
for a given (LU,MODE) pair.
- AORI
- is the ACTIVATE_ON_RECEIPT and ACTIVATE_ON_CONFIRMATION
indicator. In the formatted display, one of the following values is
shown (see note (AORC)):
- AOC DEALLOCATE PENDING
- AOC PREP TO RCV PENDING
- AOC CONFIRM PENDING
- AOR PENDING.
- BTYP
- is the receive buffer type.
- CCBADR
- is the address of the CCB.
- CCBID
- is the conversation ID.
- CEBR
- is the conditional end bracket received.
- CFML
- is the confirm locks.
- CONV
- is the conversation state.
- CS
- is the mapped conversation state. In the formatted display, one of
the following values is shown if TPF mapped conversation support is used for
this conversation:
- CM INITIALIZE STATE
- CM SEND STATE
- CM RECEIVE STATE
- CM CONFIRM STATE
- CM CONFIRM SEND STATE
- CM CONFIRM DEALLOCATE STATE
- INVALID.
- CTYPE
- is the conversation type. In the formatted display, one of the
following values is shown:
- DFCI1
- is the CCB control indicator.
- DT
- is the mapped conversation deallocate type. In the formatted
display, one of the following values is shown if TPF mapped conversation
support is used for this conversation:
- CM DEALLOCATE SYNC LEVEL
- CM DEALLOCATE FLUSH
- CM DEALLOCATE CONFIRM
- CM DEALLOCATE ABEND
- INVALID.
- ED
- is the mapped conversation error direction. In the formatted
display, one of the following values is shown if TPF mapped conversation
support is used for this conversation:
- CM RECEIVE ERROR
- CM SEND ERROR.
- ERRF
- is the state of FSM_ERROR_OR_FAILURE.
- EVT
- is the event indicator.
- FLAG
- is the CCB flag control indicator.
- FLAG2
- is the CCB flag 2 control indicator.
- IND1
- is the control indicator.
- INPF
- is the file address of first record in the CCB inbound queue.
- INPL
- is the file address of last record in the CCB inbound queue.
- LDAT
- is the amount of data processed for the current logical record being
sent.
- LL
- is the logical length of the current record being sent.
- LLREM
- is the logical length of the current logical record being received.
- LUNAME
- is the remote logical unit name.
- NET ID
- is the network ID of the remote LU.
- OUTB
- is the output buffer address.
- PARM
- is the 8-byte hexadecimal value of the token if PARMI indicates a
token. If PARMI indicates a data level, PARM is the file address of
where the block is saved. See note (AORC).
- PARMI
- is one of the following values in the formatted display (see note (AORC)):
- TOKEN
- Indicates that the transaction program sent a TPF/APPC
ACTIVATE_ON_CONFIRMATION or ACTIVATE_ON_RECEIPT verb with the TOKEN
parameter.
- DATALEVEL
- Indicates that the transaction program sent an ACTIVATE_ON_CONFIRMATION or
ACTIVATE_ON_RECEIPT verb with the DL parameter.
In the unformatted display, a value of X'FF' indicates that PARM is
a token. Any other value indicates that PARM is a data level.
- PBLK
- is the address of the partner block, if any, used to start a mapped
conversation.
- PLEN
- is the length of data needed to POST this conversation.
- PMOD
- is the mode name specified on the ALLOCATE verb. See note (PRMOD).
- POST
- is the state of FSM_POST.
- PRID
- is the RID of the remote LU specified on the ALLOCATE verb. See
note (PRMOD).
- PROG
- is the program name specified on the ACTIVATE_ON_RECEIPT or
ACTIVATE_ON_CONFIRMATION verb. See note (AORC).
- PTR
- is the mapped conversation prepare to receive type. In the
formatted display, one of the following values is shown if TPF mapped
conversation support is used for this conversation:
- CM PREP TO RECEIVE SYNC LEVEL
- CM PREP TO RECEIVE FLUSH
- CM PREP TO RECEIVE CONFIRM
- INVALID.
- RC
- is the mapped conversation return control type. In the formatted
display, one of the following values is shown if TPF mapped conversation
support is used for this conversation:
- CM WHEN SESSION ALLOCATED
- CM IMMEDIATE
- INVALID.
- RES
- is reserved for IBM use.
- RFSM
- is the state of CCB. In the formatted display, one of the following
values is shown:
- RID
- is the hexadecimal resource identifier (RID) of the partner logical
unit.
- RTSRI
- is the request to send received indicator.
- RVT1ADR
- is the address of resource vector table section 1 for this session.
- SCBID
- is the session control block ID.
- SCB1ADR
- is the address of session control block section 1.
- SL
- is the mapped conversation synchronization level. In the formatted
display, one of the following values is shown if TPF mapped conversation
support is used for this conversation:
- CM NONE
- CM CONFIRM
- INVALID.
- SLEVL
- is the synchronization level. This information is provided only in
the formatted display and is one of the following values:
- SON
- is the session outage indicator.
- ST
- is the mapped conversation send type. In the formatted display, one
of the following values is shown if TPF mapped conversation support is used
for this conversation:
- CM BUFFER DATA
- CM SEND AND FLUSH
- CM SEND AND CONFIRM
- CM SEND AND PREP TO RECEIVE
- CM SEND AND DEALLOCATE
- INVALID.
- TCBID
- is a unique ID that identifies a transaction program instance.
- TEXT
- is the first 25 bytes of the first block in the CCB inbound queue.
See note (TXTLN).
- TLEN
- is the text length of first record in the CCB inbound queue. See
note (TXTLN).
- TPDBI
- is the database index in which the transaction program is running.
- TPFMAP
- indicates if this conversation is using the TPF mapped conversation
support. This is provided only in the formatted display.
- TPORD
- is the ordinal number of the transaction program instance control block,
if any, associated with this conversation. The ITPICB data macro maps
and explains the information in this block.
Notes:
- In the formatted display, the AORI, PARM, PARMI, and PROG values
are displayed only if an ACTIVATE_ON_RECEIPT or
ACTIVATE_ON_CONFIRMATION is pending.
- TEXT and TLEN are provided only in the formatted display and
are displayed only if data is on the inbound queue.
- PRID and PMOD are displayed only under all of the following
conditions:
- The application is running in a loosely coupled environment.
- The local LU being used for the session is a generic TPF/APPC LU.
- The remote LU is already in session with another processor in the
complex.
Formatted information about a CCB using basic conversation verbs is
displayed in the following example.
+---------------------------------------------------------------------------------------------+
|User: ZNCCB DF O 1 |
| |
|System: NCCB0020I 16.58.55 CCB CONTENTS FORMATTED |
| CCBID 00000119 NET ID LUNAME APPC |
| RID 000040 RVT1ADR 025D5800 |
| SCBID 800002 SCB1ADR 026C00F4 |
| CCBADR 026BC2BC TCBID 338319C0 CTYPE BASIC SLEVL CONFIRM |
| CONV SEND ERRF INITIAL |
| POST INITIAL RFSM INUSE |
| INPF 00000000 INPL 00000000 |
| TPFMAP NO |
| END OF THE DISPLAY |
+---------------------------------------------------------------------------------------------+
Formatted information about a CCB using mapped conversation verbs is
displayed in the following example.
+--------------------------------------------------------------------------------+
|User: ZNCCB DF O 1 |
| |
|System: NCCB0020I 09.17.57 CCB CONTENTS FORMATTED |
| CCBID 0001F72D NET ID LLL LUNAME LU62A008 |
| RID 000081 RVT1ADR 001F9A94 |
| SCBID 800007 SCB1ADR 0032F658 |
| CCBADR 0022BCD0 TCBID EC46BD38 CTYPE MAPPED SLEVL CONFIRM |
| CONV SEND ERRF INITIAL |
| POST INITIAL RFSM INUSE |
| INPF 00000000 INPL 00000000 |
| TPFMAP YES |
| SL CM CONFIRM CS CM SEND STATE |
| DT CM DEALLOCATE SYNC LEVEL PTR CM PREP TO RECEIVE SYNC LEVEL |
| RC CM WHEN SESSION ALLOCATED ST CM SEND AND PREP TO RECEIVE |
| ED CM RECEIVE ERROR |
| END OF THE DISPLAY |
+--------------------------------------------------------------------------------+
Unformatted information about the CCB with ordinal number 1 is displayed in
the following example.
- Note:
- See the ICCB DSECT for information about the actual bit settings and
values.
+--------------------------------------------------------------------------------+
|User: ZNCCB DU O 1 |
| |
|System: NCCB0021I 17.02.26 CCB CONTENTS |
| NET ID LUNAME APPC |
| RVT1ADR 025D5800 CCBADR 026BC2BC SCB1ADR 026C00F4 |
| IND1 00 02 EVT 01 00 PROG 02 00000000 |
| PLEN 06 7FFF RES 08 00 SCBID 09 800002 |
| TCBID 0C 338319C0 CCBID 10 00000119 CTYPE 14 20 |
| LLREM 15 0000 DFCI1 17 00 |
| PARM 18 00000000 00000000 INPF 20 00000000 |
| INPL 24 00000000 CONV 28 01 ERRF 29 00 |
| POST 2A 00 RFSM 2B 01 CEBR 2C 00 |
| SON 2D 00 LL 2E 0000 LDAT 30 0000 |
| BTYP 32 00 RTSRI 33 00 CFML 34 00 |
| FLAG 35 00 RES 36 00 FLAG2 37 40 |
| OUTB 38 C00070AB PRID 3D 000000 AORI 40 00 |
| PARMI 41 00 TPORD 42 0000 ALOCQ 44 00000000 |
| PMOD 48 00000000 00000000 PBLK 50 00000000 |
| SL 54 00 CS 55 00 DT 56 00 |
| PTR 57 00 RC 58 00 ST 59 00 |
| ED 5B 00 TPDBI 5C FF00 |
| END OF THE DISPLAY |
+--------------------------------------------------------------------------------+
All the CCBs associated with the specified NAU are initialized in the
following example.
+--------------------------------------------------------------------------------+
|User: ZNCCB INIT N LU62A003 |
| |
|System: NCCB0022I 17.14.26 CCB INITIALIZATION COMPLETE |
+--------------------------------------------------------------------------------+
The number of active and inactive CCBs is displayed in the following
example.
+--------------------------------------------------------------------------------+
|User: ZNCCB DC SUM |
| |
|System: NCCB0023I 09.17.34 CCB SUMMARY INFORMATION |
| RESOURCE STATUS |
| NUMBER OF ACTIVE CCBS 50 |
| NUMBER OF INACTIVE CCBS 1950 |
| TOTAL NUMBER OF CCBS 2000 |
+--------------------------------------------------------------------------------+
A summary of the number of CCBs in each basic conversation state is
displayed in the following example.
+--------------------------------------------------------------------------------+
|User: ZNCCB DC ALL |
| |
|System: NCCB0024I 09:15:45 CCB CONVERSATION STATES |
| CONVERSATION STATE NUMBER COUNT EVENTS |
| RESET 00 1930 0 |
| SEND 01 22 12 |
| RECEIVE 02 16 0 |
| RECEIVED CONFIRM 03 4 0 |
| RECEIVED CONFIRM SEND 04 6 0 |
| RECEIVED CONFIRM DEALLOCATE 05 8 0 |
| PENDING DEALLOCATE 08 12 4 |
| END 09 2 0 |
| -------- -------- |
| TOTALS 2000 16 |
+--------------------------------------------------------------------------------+
A summary of the number of CCBs in each mapped conversation state is
displayed in the following example.
+--------------------------------------------------------------------------------+
|User: ZNCCB DC ALL MAPPED |
| |
|System: NCCB0028I 09:15:45 ACTIVE TPF MAPPED CONVERSATIONS |
| CONVERSATION STATE NUMBER COUNT |
| CM INITIALIZE STATE 02 2 |
| CM SEND STATE 03 12 |
| CM RECEIVE STATE 04 11 |
| CM SEND PENDING STATE 05 2 |
| CM CONFIRM STATE 06 3 |
| CM CONFIRM SEND STATE 07 1 |
| CM CONFIRM DEALLOCATE STATE 08 6 |
| -------- |
| TOTAL 37 |
+--------------------------------------------------------------------------------+
The CCB IDs associated with the specified NAU are displayed in the
following example.
+--------------------------------------------------------------------------------+
|User: ZNCCB DC N LU62A008 |
| |
|System: NCCB0026I 09.18.45 CCBID LIST FOR LU62A008 |
| 0000014D 00000277 00012409 00000533 00035603 00046190 |
| 00001777 00005645 |
+--------------------------------------------------------------------------------+
Related Information
See TPF ACF/SNA Data Communications Reference for
more information about SNA communications.