The PORT command prints an analysis of a port structure related to a port file.
If the port structure was not in memory when the dump was created, DUMPANALYZER returns the following response:
PORT OVERLAYED
Syntax
── PORT ─┬─<PORTINDEX>─────────┬─┬──────────────┬──────────────────────┤ ├─ AT ──<ADDRESS>─────┤ ├─ EXPAND ─────┤ ├─ VIA ──<ASD INDEX>──┤ ├─ TERSE ──────┤ ├─ ALL ───────────────┤ ├─ ONELINE ────┤ ├─ SERVICE ──<NUMBER>─┘ ├─ NOSUBPORTS ─┤ │ ├─ SUMMARY ────┤ │ └─ SUMOFFER ───┤ └─ PROVLIST ─┬─<PL INDEX>──────────────┤ ├─ AT ──<ADDRESS>─────────┤ └─ VIA ──<ASD INDEX>──────┘
The PORT command analyzes the port structure of a port file and optionally its subports, or a provider list. A provider list is a structure that contains information related to port matching when more than one network provider is involved.
The following text describes the meaning of each construct. Refer to “Basic Constructs” earlier in this section for information about the <absolute address> and VIA <ASD number> constructs.
PORT <port index>
Analyzes the port structure at the <port index> offset into the MCP port array. This also analyzes each of the port subports in a format that displays the most useful information on one line. This number is stored in the LIBRARYINFO word of the FIB of a port file. The subport structure also contains this number in its PABNO field.
PORT AT <absolute address>
Analyzes the port structure at the given absolute memory address. This also analyzes each of the port subports in a format that displays the most useful information on one line. If the memory address specified does not contain a port structure, then DUMPANALYZER displays the following message:
BAD PABNO
PORT VIA <ASD number>
Analyzes the port structure at the address referenced by the ASD number supplied. This also analyzes each of the port subports in a format that displays the most useful information on one line. If the memory address referenced by the ASD number does not contain a port structure, DUMPANALYZER displays the following message:
BAD PABNO
PORT ALL
Analyzes all the port structures in the dump and their subport structures, depending on the level of subport detail requested.
PORT SERVICE <number>
Analyzes all the port structures assigned to the specified service and their subport structures depending on the level of subport detail requested. A unique service number is available for each network type. For example, the service number for BNA is zero (0), the service number for TCP protocol is twelve (12).The value of the service number is specified using the basic NUMBER construct. Therefore, the default is a <hexadecimal number>. To select TCP PORT files, use “SERVICE C”.
PORT PROVLIST <provlist index>
Analyzes the provider list at the <provlist index> offset into the MCP PROVLIST array.
PORT PROVLIST AT <absolute address>
Analyzes the provider list at the given absolute memory address.
PORT PROVLIST VIA <ASD number>
Analyzes the provider list at the address referenced by the ASD number supplied.
PORT <port index> ONELINE
This is the same as PORT <port index>.
PORT <port index> TERSE
This is the same as PORT <port index> ONELINE except it also displays the matching attributes that are relevant, depending on the SERVICE attribute of the port.
PORT <port index> EXPAND
This is the same as PORT <port index> except that it fully analyzes all the subports of the port.
PORT <port index> NOSUBPORTS
This is the same as PORT <port index> except that the analysis of subports is suppressed.
PORT ALL SUMMARY
PORT SERVICE <number> SUMMARY
PORT ALL SUMOFFER
PORT SERVICE <number> SUMOFFER
SUMMARY and SUMOFFER provide a single line summary for each PORT. The port summary contains the maximum subports declared, number of open subports, number of closed subports, allocated subports, and the declaring process identity. SUMOFFER also includes the number of offered subports. A cumulative summary is provided.
Example
The following shows an example of the first page of the response to the PORT command. The dump was created on a system running BNA Version 2.
INPUT: PORT 54 PORT ATTRIBUTE BLOCK DESCRIPTOR AT 5 800001 D0265C 00(00) 0 D7D6D9 E30054 MYPORTADDRESS =84(54) 01(01) 0 003200 000000 MAXSUBFILES =50(32) LASTSUBPORT =0(0) SERVICE =0(0) 02(02) 0 23D004 000000 MAXRECSIZE =9168(23D0) PREFERREDCHARSET =4(4) REMOTERRF =0(0) TRANSLATEATT =0(0) DEF_DIALOG_PR_ATT =0(0) 03(03) 0 000000 000109 FIRSTCHANGEDSUBFILE =0(0) HOSTSERVICESDIALOGNO =0(0) WAITFOROPEN =FALSE SOMEERROR =FALSE ATTACHED_TO_PLM =FALSE BNAV2 PLM PORT =FALSE TTP_PORT =1(1) SYNC_PORT =0(0) SERVICE ATTRIBUTE =FALSE 04(04) 0 000000 3205A0 OPENEDSUBPORTS =0(0) CLOSEDSUBPORTS =50(32) PORTOWNERSTACK =90(5A) PROGRAM AGENT =FALSE RETIRING =FALSE IOWNYOURLOCK =FALSE 05(05) 0 000500 000180 PORT_EVENT_NUM =5(5) READABLESUBPORTS =0(0) USING PROCESS TYPE =1(1) WORD_ORIENTED =TRUE 06(06) 0 010300 000000 TTP_IX =1(1) SECURITYTYPEATT =3(3) FRAMESIZEATT =0(0) INTERFACE MODEL =0(0) 07(07) 0 000001 000002 PORTSTATEEVENT =1(1) 5 670000 0002C6 0 000000 000000 EVENT ANALYSIS: MESSAGEEVENT =2(2) 0 000000 000000 0 000000 000000 EVENT ANALYSIS: 08(08) 0 000000 000003 INTERNALEVENT =0(0) 5 610000 00055B 3 000000 00008D EVENT ANALYSIS: PORTLOCK =3(3) 0 000000 000000 0 000000 000000 EVENT ANALYSIS: 09(09) 0 000000 000000 PORTLOCKWORD =0(0) 10(0A) 0 000000 000000 PORTGRABWORD =0(0) 11(0B) 0 001900 1A001B MESSAGE FORWARDING LISTS LIST NUMBER: 27. NO OF ELEMENTS: 0.