MNPSC, MNPSD, MNPSF

There are three Multi-Node Persistent Session (MNPS) functions: MNPSD, MNPSC, and MNPSF. They provide two important capabilities:

Comparing session control blocks from a dump created at the time of a VTAM® failure (Z NET,CANCEL or ABEND) with a dump created after the recovery has completed. The MNPSD function creates a dump of the MNPS-related control blocks of the MNPS sessions when there is a VTAM failure. The MNPSC function compares the control blocks of that dump with the ones in a dump created after the recovery to determine whether session characteristics are the same.
Formatting MNPS session control blocks using the MNPSF function.

Operands

For MNPSD, only DDNAME is valid.

For MNPSC, DDNAME is valid. You can also specify the network ID and the resource name or the resource name only or the procedure-correlation identifier (PCID) only.

For MNPSF, DDNAME is not valid. You can specify the network ID and the resource name or the resource name only or the procedure-correlation identifier (PCID) only.

DDNAME

The DDNAME is a 1–8 character name identifying the data set to place or retrieve session data. The data set must exist and must be cataloged before use.

Be sure the data set characteristics match the following conditions.

Record format must be equal to V or VB.
Record length must be equal to 456 or greater.
Data set organization must be equal to PS.

Network ID

The network ID should be 1–8 alphanumeric characters. If it contains fewer than 8 characters, the leftmost characters are compared.

NetID is the name defined to NCPs and hosts to indicate the network where they reside. NetID is unique across all communicating SNA networks. It is assumed to be the host unless otherwise specified.

Resource name

The resource name should be 1–8 alphanumeric characters. The first character must be a-z, A-Z, @, #, or $. If it contains fewer than 8 characters, it is left-aligned before comparing.

PCID

The procedure-correlation identifier (PCID) must be 2 - 16 hexadecimal digits entered in the form X'nnnn'.

If the PCID is fewer than 16 digits, it is right-aligned and compared to the rightmost positions of the PCID from the dump.

The value entered must be an even number of digits.

Syntax

The syntax for MNPSD follows:

The syntax for MNPSC follows:

The syntax for MNPSF follows:

Sample output

MNPSD DDNAME(MNPSDUMP)
                             MNPS Dump Process
00000004 Record(s) were dumped successfully

MNPSC DDNAME(MNPSDUMP) RESOURCE(MAPPC2A1)
                             MNPS Compare Process
                                FMCB Extension
Field            Current     Dataset   Field           Current     Dataset
EXLEN            84          84        FMPRO           03          03
NAME             TCPM1011    TCPM1011  NETID           NETA        NETA
BRQS             1           1         BRQR            0           0
BRPS             0           0         BRPR            1           1
SSS              1           1         RNAMS           0           0
⋮
                                   ISTFMCB
Field            Current     Dataset   Field           Current     Dataset
TYPE             03          03        LNGTH           0286        0286
MXRUI            00000400    00000400  MXRUO           00000F00    00000F00
AVAIL            1           1         OCFLG           0           0
ICFLG            0           0         LU6             0           0
SESTY            0           0         ASPI            1           1
⋮
                                   ISTRPNCB
Field            Current     Dataset   Field           Current     Dataset
REMOTE_CONN_ID   1427431700000076                      1427431700000076
CONN_STATE       32          32        MAX_DATA_SIZ    0000E01D    0000E01D
PATHSWITCH_T     000000F0    000000F0  LOCAL_MNPS      1           1
ALS_CPNETID      NETA        NETA      ALS_CPNAME      SSCP2A      SSCP2A 
RELIABLE         1           1         CONN_TYPE       11          11     
⋮
                                   ISTBSB
Field            Current     Dataset   Field           Current     Dataset
BSBID            BC          BC
MAXSL           *00          87        MAXPL          *00          F8
F5SA_MSG         00000000000000050000000000000003
                 00000000000000050000000000000003
TYPE             1           1         IND             1           1
⋮
                                    ISTSIB
Field            Current     Dataset   Field           Current     Dataset
CBID             98          98
PCID             EAABEEC39E9C6EA5                      EAABEEC39E9C6EA5
BDUVN            0000000000000000                      0000000000000000
BCKUP            0           0         BXRFS           0           0
BSCI             1           1         BDLUT          *0           1
⋮
End of file reached
00000004 Record(s) were scanned successfully

MNPSF RESOURCE(MAPPC2A1)
                             MNPS Format Process
 FMCBX: 08B12138
    +0000  00000001  001D8402  02000004  08B0B018  | ......d......... |
    +0010  00000001  001B0000  0001001D  08B120A8  | ...............y |
    +0020  00000000  08D4D7F8  00000000  00000000  | .....MP8........ |
    +0030  00000000  D3F7F2F1  F1C14040  D5C5E3C1  | ....L7211A  NETA |
    +0040  40404040  00000000  00000000  00000000  |     ............ |
    +0050  00000000  00009080  00000000  00100000  | ................ |
    +0060  00000000  0A05C034  EAABEEC3  9E9C6EA1  | ......{....C..>~ |
    +0070  00000000  00000000  D3F7F2F1  F1C14040  | ........L7211A   |
    +0080  00000000                                | ....             |

 FMCB: 08B0B018
    +0000  03008000  08B12138  08B59B90  00000000  | ................ |
    +0010  08C68210  00000000  00000000  00000000  | .Fb............. |
    +0020  08C67260  00000000  1C016800  1FF00018  | .F.-.........0.. |
    +0030  00000000  00000000  0101001C  01010021  | ................ |
    +0040  00000000  00000000  08C67030  00000000  | .........F...... |
    +0050  1D096800  0FF00040  00000000  00000000  | .....0. ........ |
    +0060  0101001C  01010021  00000000  00000000  | ................ |
    +0070  00000000  00000000  00000000  02000004  | ................ |
    ⋮
 RPNCB: 08B2B800
    +0000  FABF001C  09F8B628  08C95048  00050000  | .....8...I&..... |
    +0010  0000000B  00000000  00000000  00000000  | ................ |
    +0020  00000000  00000000  00000000  00000000  | ................ |
    +0030  00000000  00000000  00000000  00000000  | ................ |
    +0040  00000000  00000000  090468B4  00000000  | ................ |
    +0050  95001200  1FF00040  00000000  00000000  | n....0. ........ |
    +0060  00000000  00000000  89C584E0  00000000  | ........iEd\.... |
    +0070  37010000  0FF00060  00000000  00000000  | .....0.-........ |
    ⋮
 BSB: 08B14228
    +0000  BC0000C0  00800080  00040080  00800001  | ...{............ |
    +0010  00000000  00000000  00000000  00000000  | ................ |
    +0020  00000000  00000000  00000000  00004000  | .............. . |
    +0030  00000000  00000003  00000000  00000001  | ................ |
    +0040  00000001  001B0000  0000001D  00000001  | ................ |
    +0050  001C3C16  D10040C0  00017FFF  00010007  | ....J. {.."..... |
    +0060  00070001  00000000  00000000  00000000  | ................ |
    +0070  0000260D  00000000  00000000  00000000  | ................ |
    ⋮
 SIB: 09FE9300
    +0000  9800FC00  00000000  EAABEEC3  9E9C6EA1  | q..........C..>~ |
    +0010  00000000  00000000  40404040  40404040  | ........         |
    +0020  00000000  00000000  B3942810  BDE39308  | .........m...Tl. |
    +0030  09FE9188  09FE9478  00000000  00000000  | ..jh..m......... |
    +0040  00000000  09FE9410  09FE93B0  0A05C034  | ......m...l...{. |
    +0050  10311000  00000008  09FE9478  00000000  | ..........m..... |
    +0060  00000000  00000000  A0000000  08B18018  | ................ |
    +0070  00000090  00000000  00000000  00000000  | ................ |
    ⋮