6.13 pct
This command is used to maintain per-translation statistics and to test Point Code and CIC Translation (PCT) functionality. The command can use Stats mode to reset or display per-translation statistics or Test mode to test PCT behavior.
Options
Options and option parameters that are underlined indicate that a value must be specified for that option or parameter. Do not enter the underlined option or parameter; enter a value for the information represented by the underlined option or parameter.
-h
This option is used to provide help information for the command.
The following options are common to both Stats mode and Test mode:
-p pctype
Point Code Type. This option applies to all point codes in the option list.
The following options apply to only Stats mode:
-a realpc
Real Point Code
-c cicr
CIC range. This option can be specified only if SI is 4, 5, or 13.
- Range:
- The option can be in one of these forms:
- wildcard(*)
- ecics-ecice:rcics-rcice, e.g., 5-10:15-20
- ecics:rcics (e.g., 5:6, which is equivalent to 5-5:6-6)
-e epc
Emulated Point Code
-f fpc
Filter Point Code. This option can be a wildcard (*).
-l
List the stats for the selected rules. The -e or -a option must be supplied. Both of these options can be specified.
-r
Resets the stats for selected rules. If no other options are specified, then this option resets stats on all rules. If other options are specified, then the -e or -a option must be specified.
-s si
-u ssn
Subsystem Number. The si=3 option must be specified before this option can be specified. This option can be a wildcard (*)
The following options apply only to Test mode.
-c cic
CIC in simulated MSU. If a value of 4, 5, or 13 is specified for the si option, then the -c must be specified.
-d dpc
Destination Point Code in simulated MSU.
-o opc
Originating Point Code in simulated MSU.
-s si
SI in simulated MSU.
-u ssn
Subsystem number in CgPA and CdPA in simulated MSU. The si=3 option must be specified before the -u option can be specified. If the -u is not specified, and the si=3 is specified, then the route on SSN is off.
pass:loc=1201:cmd=”pct –m stats –r –e 4-3-1”
pass:loc=1201:cmd="pct -m test -d 4-3-1 -o 7-2-30 -s 3 -u 26"
Dependencies
None
Notes
None
Output
This example shows a help report:
pass:loc=1201:cmd="pct -h" Command Accepted – Processing
Usage:
pct -m stats [-l | -r] [-p pctype] [-e epc] [-f fpc] [-a realpc] [-s si] [-u ssn] [-c cicr]
pct -m test [-p pctype] -d dpc -o opc -s si [-c cic] [-u ssn]
pct -h
Modes:
stats - reset or display per-rule stats
test - test PCT behavior for a message with the specified field values
Common Options:
-p pctype is ANSI, ITUI, or ITUN
stats Mode Options:
-r reset the stats for selected rules
with no other options, resets stats on all rules
if other options present, -e or -a must be supplied
-l list the stats for selected rules (default)
the -e or -a option must be supplied
both -e and -a may be supplied
-e emulated point code
-a real point code
-c cicr is in these forms:
* (see Note 1)
ecics-ecice:rcics-rcice, e.g., 5-10:15-20
ecics:rcics, e.g., 5:6 which is equiv to 5-5:6-6
allowed only if SI is 4, 5, or 13
-f filter pc; may be * (see Note 1)
-s si; can be 0, 3, 4, 5, 13, or * (see Note 1)
-u ssn; may be * (see Note 1)
allowed only if SI is 3
test Mode Options:
-d DPC in simulated MSU
-o OPC in simulated MSU
-s SI in simulated MSU
-u SSN in CgPA and CdPA in simulated MSU;
if absent and si is 3, indicates that route on SSN is off;
allowed only if SI is 3
-c CIC in simulated MSU;
required if SI is 4, 5, or 13
Notes:
1. an explicit * will match only with rule containing a wildcard; to match
on wildcard or a specific value, do not specify the associated option
Stats Mode
With the -l option, all matching translations are displayed along with the following three statistics for each translation:
- DPCLKP – Number of successful translations of the DPC and/or CIC of a message (the number of successful DPC lookups).
- OPCLKP – Number of successful translations of the OPC and/or CIC of a message (the number of successful OPC lookups).
- MSUDISC – Number of messages discarded after successfully translating the DPC of a message from an emulated point code to a real point code, but where the real point code is unreachable.
The IDX (index) column is the unique row number of the entry in the PCT table. The index for a particular translation is the same across all cards.
The output for a single translation consists of two or three lines.
For translations with an SI of 4, 5, or 13, the CIC range field is displayed only for translations with a specific value for the CIC range.
This example lists all translations with an EPC of 4-3-1 (ANSI):
pass:loc=1201:cmd=”pct –m stats –l –e 4-3-1” Command Accepted – Processing
idx epc rpc fpc si ssn
6 004-003-001 007-003-001 007-002-030 3 24
dpclkp: 0 opclkp: 0 msudisc: 0
7 004-003-001 007-003-002 007-002-030 3 26
dpclkp: 0 opclkp: 0 msudisc: 0
8 004-003-001 007-003-006 007-002-030 5 ---
ecic: 100-105 rcic: 200-205
dpclkp: 0 opclkp: 0 msudisc: 0
9 004-003-001 007-003-011 007-002-* 3 24
dpclkp: 0 opclkp: 0 msudisc: 0
10 004-003-001 007-003-016 007-*-* 3 24
dpclkp: 0 opclkp: 0 msudisc: 0
11 004-003-001 007-003-021 007-002-030 3 *
dpclkp: 0 opclkp: 0 msudisc: 0
12 004-003-001 007-003-026 007-002-030 5 ---
dpclkp: 0 opclkp: 0 msudisc: 0
13 004-003-001 007-003-031 007-002-* 3 *
dpclkp: 0 opclkp: 0 msudisc: 0
14 004-003-001 007-003-036 007-003-* 3 *
dpclkp: 0 opclkp: 0 msudisc: 0
15 004-003-001 007-003-041 007-*-* 3 *
dpclkp: 0 opclkp: 0 msudisc: 0
16 004-003-001 007-003-046 008-*-* 3 *
dpclkp: 0 opclkp: 0 msudisc: 0
17 004-003-001 007-003-051 007-002-029 * ---
dpclkp: 0 opclkp: 0 msudisc: 0
18 004-003-001 007-003-056 007-002-030 * ---
dpclkp: 0 opclkp: 0 msudisc: 0
19 004-003-001 007-003-061 007-002-* * ---
dpclkp: 0 opclkp: 0 msudisc: 0
20 004-003-001 007-003-066 007-*-* * ---
dpclkp: 0 opclkp: 0 msudisc: 0
21 004-003-001 007-003-071 -------------- 3 24
dpclkp: 0 opclkp: 0 msudisc: 0
22 004-003-001 007-003-076 -------------- 5 ---
ecic: 100-105 rcic: 200-205
dpclkp: 0 opclkp: 0 msudisc: 0
23 004-003-001 007-003-081 -------------- 3 *
dpclkp: 0 opclkp: 0 msudisc: 0
24 004-003-001 007-003-086 -------------- 5 ---
dpclkp: 0 opclkp: 0 msudisc: 0
25 004-003-001 007-003-091 -------------- * ---
dpclkp: 0 opclkp: 0 msudisc: 0This example resets counters for all translations with an EPC of 4-3-1 (ANSI):
pass:loc=1201:cmd=”pct –m stats –r –e 4-3-1” Command Accepted – Processing
Stats reset on 20 rulesTest Mode
Test mode allows determination of whether an incoming message with the specified field values would result in a match on an entry in the PCT table. Output includes the content of the message, as specified on the command line, the lookup result, and the matching entry if a match exists.
This example shows a match on the DPC lookup:
pass:loc=1201:cmd="pct -m test -d 4-3-1 -o 7-2-30 -s 3 -u 26" Command Accepted – Processing
Point Code and CIC Translation Lookup Test
MSU content:
OPC: 007-002-030
DPC: 004-003-001
SI: 3
SSN: 26
Lookup result:
Match on DPC was found
Matching entry:
idx epc rpc fpc si ssn
7 004-003-001 007-003-002 007-002-030 3 26This example shows a match on the OPC lookup:
pass:loc=1201:cmd="pct -m test -d 7-2-30 -o 7-3-2 -s 3 -u 26" Command Accepted – Processing
Point Code and CIC Translation Lookup Test
MSU content:
OPC: 007-003-002
DPC: 007-002-030
SI: 3
SSN: 26
Lookup result:
Match on OPC was found
Matching entry:
idx epc rpc fpc si ssn
7 004-003-001 007-003-002 007-002-030 3 26This example shows a match on a DPC lookup where the matching translation has a wildcard Filter PC and a wildcard SI:
pass:loc=1201:cmd="pct -m test -d 4-3-1 -o 9-9-9 -s 4 –c 106" Command Accepted – Processing
Point Code and CIC Translation Lookup Test
MSU content:
OPC: 009-009-009
DPC: 004-003-001
SI: 4
CIC: 106
Lookup result:
Match on DPC was found
Matching entry:
idx epc rpc fpc si ssn
25 004-003-001 007-003-091 -------------- * ---