gtpo1marOperations

ZNCCB-Initialize/Display CCB Information

Use this command to:

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)):

 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:

 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:

 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:

 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:

 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:

 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:

 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:

 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:

  1. 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.

  2. TEXT and TLEN are provided only in the formatted display and are displayed only if data is on the inbound queue.

  3. PRID and PMOD are displayed only under all of the following conditions:
    1. The application is running in a loosely coupled environment.
    2. The local LU being used for the session is a generic TPF/APPC LU.
    3. 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.