1. Database Administration - GWS User's Guide
  2. Gateway Screening (GWS) Overview
  3. Gateway Screening Attributes

Gateway Screening Attributes

Each screen has attributes which hold information required to perform a particular screening function. The following attributes are required in order to implement all of the screening functions.

The screen set name(scrn) is a four character (one alpha and up to three alphanumeric) value that specifies the name of the screen set.

The screening reference (sr) is a four character (one alpha and up to three alphanumeric) value. Combined with the next screening function identifier (nsfi), it uniquely defines a screening table.

The network identifier for ANSI point codes (ni) is an integer between 0 and 255, the asterisk “*”, or the character “c”.

The network cluster for ANSI point codes (nc) is an integer between 0 and 255, the asterisk “*”, or the character “c”.

The network cluster member for ANSI point codes (ncm) is an integer between 0 and 255, the asterisk “*”, or the character “c”.

The zone for ITU international point codes (zone) is an integer between 0 and 7, the asterisk “*”, or the character “c”.

The area for ITU international point codes (area) is an integer between 0 and 255, the asterisk “*”, or the character “c”.

The ID for ITU international point codes (id) is an integer between 0 and 7, the asterisk “*”, or the character “c”.

The 14-bit ITU national point code (npc) is an integer between 1 and 16383, the asterisk “*”, or the character “c”. The EAGLE supports different formats for 14-bit ITU national point codes as defined by the npcfmti parameter of the chg-stpopts command. No matter what format is defined by the npcfmti parameter, the 14-bit ITU national point code must be entered as an integer for gateway screening. If the format of the 14-bit ITU national point code that you wish to enter for gateway screening is not a single integer, the point code value must be converted into a single integer value. For more information on converting 14-bit ITU national point code values, see the 14-Bit ITU National Point Code Formats section. For more information on the different ITU national point code formats, see the 14-Bit ITU National Point Code Formats section in Chapter 2, Configuring Destination Tables in Database Administration - SS7 User's Guide.

Gateway Screening supports using ITU international spare point codes in addition to ITU international point codes, and 14-bit ITU national spare point codes in addition to 14-bit ITU national point codes. The pcst parameter is used to specify the whether or not the ITU international and 14-bit ITU national point codes are spare point codes (pcst=s parameter) or not (pcst=none parameter). For more information about ITU international and 14-bit ITU national spare point codes, see Chapter 2, Configuring Destination Tables in Database Administration - SS7 User's Guide. Gateway Screening does not support using private point codes.

The main signaling area value for 24-bit ITU national point codes (msa) is an integer between 0 and 255, the asterisk “*”, or the character “c”.

The sub-signaling area value for 24-bit ITU national point codes (ssa) is an integer between 0 and 255, the asterisk “*”, or the character “c”.

The signaling point value for 24-bit ITU national point codes (sp) is an integer between 0 and 255, the asterisk “*”, or the character “c”.

The ISUP message type (isupmt)/TUP message type (tupmt) is an integer between 0 and 255, or the character “*”. This parameter specifies either an ISUP message type or a TUP message type for the ISUP screening reference specified in the sr parameter.

The service indicator (si) is an integer between 0 and 15. This parameter specifies a service indicator for the SIO screening reference specified in the sr parameter. The service indicator is the first 4 bits of an SIO.

The network indicator code (nic) is an integer between 0 and 3 or an “*” (asterisk). This parameter specifies a network indicator code for the SIO screening reference specified in the sr parameter. The network indicator code is the last 2 bits of an SIO.

The H0 heading code (h0) is an integer between 0 and 15, or an “*” (asterisk). This parameter specifies the first four bits of a message type for the SIO screening reference.

The H1 heading code (h1) is an integer between 0 and 15, or an “*” (asterisk). This parameter specifies last four bits of a message type for the SIO screening reference.

The message priority (pri) is an integer between 0 and 3. This parameter specifies the message priorities for the SIO screening reference.

The subsystem number (ssn) is an integer between 0 and 255 or an “*” (asterisk). This parameter identifies the SCP application that should receive the message.

The routing indicator (ri) is destination point code (DPC), global title translation (GT), or “*” (asterisk). This parameter indicates whether a subsequent global title translation is required.

  • gt – indicates that a subsequent translation is required.
  • dpc – indicates that no further translation is required.
  • * (asterisk) – indicates all possible values (DPC and GT).

The translation type (type) is an integer between 0 and 255 or a “*” (asterisk). Identifies the type of global title translation. It is the decimal representation of the 1-byte field used in SS7.

The SCCP message type (sccpmt) is an integer with the values 9 (UDT messages), 10 (UDTS messages), 17 (XUDT messages), 18 (XUDTS messages), or “*” (asterisk). This parameter specifies one of these message types and is part of the calling party address screen.

The SCCP management (SCMG) format ID (scmgfid) is an integer from 1 to 255 or “*” (asterisk). This parameter specifies the function and format of an SCMG message and is part of the called party address screen.

The next screening function identifier (nsfi) is the screen function that is required to continue processing the message. It is the next step in processing the message. The values for this attribute are: opc, blkopc, sio, dpc, blkdpc, destfld, isup cgpa, tt, cdpa, aftpc, stop, and fail.

The next screening reference (nsr) is a four character (one alpha and up to three alphanumeric) value. Combined with the next screening function identifier (nsfi), it uniquely defines the next screening table to be used in the gateway screening process.

The gateway screening stop action set name (actname) is a six character (one alpha and up to five alphanumeric characters) value. Specified only with the nsfi=stop parameter, the gateway screening stop action set defines the additional actions the EAGLE can perform on MSUs that pass gateway screening.

The asterisk, or “*”, is a single entry that indicates all possible values for that parameter.

These attributes are not used on all screens. The following list shows which attributes are required for each screening function. There are two types of attributes, search keys and results. The search keys are used to match fields in the SS7 message in order to determine the screening function result. The result is determined by matching a search key with information in the current SS7 message. The result indicates the next step in the screening process.

  • Screen Set screening function
    • Search Key - SCRN
    • Result - NSFI, NSR, ACTNAME
  • Allowed OPC screening function
    • Search Key - SR, NI, NC, NCM,.ZONE, AREA, ID, NPC, MSA, SSA, SP, PCST
    • Result - NSFI, NSR, ACTNAME
  • Blocked OPC screening function
    • Search Key - SR, NI, NC, NCM,.ZONE, AREA, ID, NPC, MSA, SSA, SP, PCST
    • Result - NSFI, NSR, ACTNAME
  • Allowed SIO screening function
    • Search Key - SR, NIC, SI, H0, H1, PRI
    • Result - NSFI, NSR, ACTNAME
  • Allowed DPC screening function
    • Search Key - SR, NI, NC, NCM,.ZONE, AREA, ID, NPC, MSA, SSA, SP, PCST
    • Result - NSFI, NSR, ACTNAME
  • Blocked Allowed DPC screening function
    • Search Key - SR, NI, NC, NCM,.ZONE, AREA, ID, NPC, MSA, SSA, SP, PCST
    • Result - NSFI, NSR, ACTNAME
  • Allowed DESTFLD screening function
    • Search Key - SR, NI, NC, NCM,.ZONE, AREA, ID, NPC, MSA, SSA, SP, PCST
    • Result - NSFI, ACTNAME
  • Allowed ISUP screening function
    • Search Key - SR, ISUPMT, TUPMT
    • Result - NSFI, ACTNAME

      Note:

      The Allowed ISUP Screening function table contains both the ISUP message type (ISUPMT) and TUP message type (TUPMT). Only one of these parameters can be specified for an allowed ISUP screen. The parameter value to be used is dependent on the service indicator (SI) value specified in the allowed SIO screen: SI=5 for an ISUP message type, SI=4 for a TUP message type.
  • Allowed CGPA screening function
    • Search Key - SR, NI, NC, NCM,.ZONE, AREA, ID, NPC, MSA, SSA, SP, RI, SSN, SCCPMT, PCST
    • Result - NSFI, NSR, ACTNAME
  • Allowed TT screening function
    • Search Key - SR, TYPE
    • Result - NSFI, NSR, ACTNAME
  • Allowed CDPA screening function
    • Search Key - SR, NI, NC, NCM,.ZONE, AREA, ID, NPC, MSA, SSA, SP, SSN, SCMGFID, PCST
    • Result - NSFI, NSR, ACTNAME
  • Allowed AFTPC screening function
    • Search Key - SR, NI, NC, NCM,.ZONE, AREA, ID, NPC, MSA, SSA, SP, SSN, PCST
    • Result - NSFI, ACTNAME

    Note:

    The NSR attribute can only be specified when the NSFI is not STOP. The NSR cannot be specified with the ACTNAME attribute. The ACTNAME attribute can only be specified when the NSFI is STOP. The ACTNAME parameter cannot be specified with the NSR parameter. NSFI and NSR can only be defined once per screening table.