gtpo1m8wOperations

ZMATP-Display or Modify MATIP Values

Use this command to do the following:

MATIP provides a means for using TCP/IP communications for legacy communication protocols such as X.25.

Requirements and Restrictions

Format




ADD
adds ASCUs to a host name. The host name must be already defined.

RHostn-hostname
specifies the remote host name, where hostname is the name of the host. Specify the host name in alphanumeric characters. Each portion of the host name separated by dots must be no larger than 63 alphanumeric characters.
Note:
Hyphens (-) are also allowed in the host name.

ASCU-
specifies the ASCU, where:

ascun
specifies the list of ASCUs. The maximum number of ASCUs in a specified list is eleven 2-byte ASCUs or six 4-byte ASCUs.

ALL
deletes every ASCU associated with a specific host name.

ALTer
changes the IP address, terminal type, or both, associated with the LNIATA specified or changes the existing host name. The host name must be already defined.

lniata
is a 6-digit hexadecimal number for the LNIATA.

IP-
specifies if the IP address is to be added to the terminal address table (WGTA) entry for the LNIATA specified, where:

ipaddress
is an IP address in dotted decimal notation.

CLEAR
specifies that no IP address should be associated with this device.

TYPE-term
specifies the terminal type to be associated with the specified LNIATA, where term is a 2-digit hexadecimal number indicating the type of terminal referenced by the LNIATA or one of the following values:

IPBRIDGE
IP Bridge.

MATIPA
MATIP Type-A conversational device.

MATIPH
MATIP Type-A host-to-host device.

MATIPB
MATIP Type-B device.

MQ
MQ Bridge device.

NOTCPIP
No longer associated with TCP/IP middleware.

DEFine
defines the IP address associated with an LNIATA or defines the host name. The host name must not be already defined.

DELete
deletes a host name or ASCUs. The host must be already defined.

DISplay
displays session information associated with an LNIATA and session characteristics for a host name. If the ASCU parameter is also specified, the ASCU list associated with the host name will be displayed.

STArt
starts the MATIP Type-A and Type-B listeners, and activates MATIP support.

STOp
stops the MATIP Type-A and Type-B listeners, and closes all active MATIP sessions.

Additional Information

Online help information is available for this command. To display the help information, enter one of the following:

ZMATP HELP

ZMATP ?

Examples

The following example displays the status of a session using LNIATA FE1401.

+--------------------------------------------------------------------------------+
|User:   ZMATP DISPLAY FE1401                                                    |
|                                                                                |
|System: MATP0006I 13.26.55 DISPLAY MATIP SESSION                                |
|                                                                                |
|         LNIATA:                 FE1401                                         |
|         SOCKET NUMBER:            251                                          |
|         IP ADDRESS:             9.117.198.103                                  |
|         TRAFFIC TYPE:           TYPE A                                         |
|         ENCODING:               EBCIDIC                                        |
|         MULTIPLEX:             2-BYTE ASCUS                                    |
|         HEADER:                4-BYTE HEADER                                   |
|         PRESENTATION:          1024C                                           |
|         H1H2:                  3F                                              |
|         NUMBER OF ASCUS:       10                                              |
|                                                                                |
|                                                                                |
+--------------------------------------------------------------------------------+

The following example adds IP address 9.117.107.92 to the WGTA entry, and changes the terminal type from A5 to 43 for LNIATA FE0412.

+--------------------------------------------------------------------------------+
|User:   ZMATP DEFINE FE0412 IP-9.117.107.92 TYPE-MATIPH                         |
|                                                                                |
|System: MATP0001I 13.26.55 IP ADDRESS DEFINED FOR LNIATA-FE0412                 |
|                           OLD            NEW                                   |
|        TERMINAL TYPE  -   A5             43                                    |
|        IP ADDRESS     -   NONE           9.117.107.92                          |
|                                                                                |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

The following example removes the IP address associated with LNIATA FE0412 and resets the terminal type to A5.

+--------------------------------------------------------------------------------+
|User:   ZMATP ALTER FE0412 IP-CLEAR TYPE-A5                                     |
|                                                                                |
|System: MATP0002I 13.26.55 INFORMATION ALTERED FOR LNIATA-FE0412                |
|                           OLD            NEW                                   |
|        TERMINAL TYPE  -   43             A5                                    |
|        IP ADDRESS     -   9.117.107.92   NONE                                  |
|                                                                                |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

The following example activates MATIP support.

+--------------------------------------------------------------------------------+
|User:   ZMATP START                                                             |
|                                                                                |
|System: MATP0007I 13.26.55 MATIP STARTED SUCCESSFULLY                           |
+--------------------------------------------------------------------------------+

The following example deactivates MATIP support.

+--------------------------------------------------------------------------------+
|User:   ZMATP STOP                                                              |
|                                                                                |
|System: MATP0008I 13.26.55 MATIP STOPPED                                        |
+--------------------------------------------------------------------------------+

The following example defines a remote host name.

+--------------------------------------------------------------------------------+
|User:   ZMATP DEF RHOSTN-ABC.DEFG.HIJK.LMN                                      |
|                                                                                |
|System: MATP0021I 13.26.55 HOST NAME DEFINED                                    |
|        HOST: ABC.DEFG.HIJK.LMN                                                 |
|        ASCU: NONE                                                              |
+--------------------------------------------------------------------------------+

The following example changes a host name with 2-byte ASCUs.

+--------------------------------------------------------------------------------+
|User:   ZMATP ALTER RHOSTN-ABC.DEFG.HIJK.LMN ASCU-4141/5533                     |
|                                                                                |
|System: MATP0020I 13.26.55 HOST NAME ALTERED                                    |
|        HOST: ABC.DEFG.HIJK.LMN                                                 |
|        ASCU: 4141 5533                                                         |
+--------------------------------------------------------------------------------+

The following example deletes a remote host name.

+--------------------------------------------------------------------------------+
|User:   ZMATP DEL RHOSTN-ABC.DEFG.HIJK.LMN                                      |
|                                                                                |
|System: MATP0018I 13.26.55 INFORMATION DELETED                                  |
|        HOST: ABC.DEFG.HIJK.LMN                                                 |
|        ASCU: NONE                                                              |
+--------------------------------------------------------------------------------+

The following example deletes 2-byte ASCUs from a host name.

+--------------------------------------------------------------------------------+
|User:   ZMATP DEL RHOSTN-ABC.DEFG.HIJK.LMN ASCU-4141/5533/2345/6162/3456/7171   |
|                                                                                |
|System: MATP0018I 13.26.55 INFORMATION DELETED                                  |
|        HOST: ABC.DEFG.HIJK.LMN                                                 |
|        ASCU: 4141 5533 2345 6162 3456 7171                                     |
+--------------------------------------------------------------------------------+

The following example adds 4-byte ASCUs to a host name.

+--------------------------------------------------------------------------------+
|User:   ZMATP ADD RHOSTN-ABC.DEFG.HIJK.LMN ASCU-41552345/61347181/F1231111      |
|                                                                                |
|System: MATP0017I 13.26.55 ASCUS ADDED FOR HOST NAME                            |
|        HOST: ABC.DEFG.HIJK.LMN                                                 |
|        ASCU: 41552345 61347181 F1231111                                        |
+--------------------------------------------------------------------------------+

The following example displays the ASCU list associated with a host name.

+--------------------------------------------------------------------------------+
|User:   ZMATP DISPLAY ASCU RHOSTN-ABC.DEFG.HIJK.LMN                             |
|                                                                                |
|System: MATP0006I 13.26.55 DISPLAY MATIP SESSION                                |
|        HOST: ABC.DEFG.HIJK.LMN                                                 |
|        ASCU: 43721294 10398452 30491048 20494451                               |
+--------------------------------------------------------------------------------+

The following example displays the characteristics associated with a host name.

+--------------------------------------------------------------------------------+
|User:   ZMATP DISPLAY RHOSTN-ABC.DEFG.HIJK.LMN ASCU                             |
|                                                                                |
|System: MATP0006I 13.26.55 DISPLAY MATIP SESSION                                |
|        HOST: ABC.DEFG.HIJK.LMN                                                 |
|        TYPE-A CONVERSATIONAL                                                   |
|         LNIATA:                FE1401                                          |
|         SOCKET NUMBER:         251                                             |
|         IP ADDRESS:            9.117.198.103                                   |
|         TRAFFIC TYPE:          TYPE A                                          |
|         ENCODING:              EBCIDIC                                         |
|         MULTIPLEX:             2-BYTE ASCUS                                    |
|         HEADER:                4-BYTE HEADER                                   |
|         PRESENTATION:          1024C                                           |
|         H1H2:                  3F                                              |
|         NUMBER OF ASCUS:       10                                              |
|                                                                                |
|        TYPE B                                                                  |
|                                                                                |
|         NO ACTIVE SESSION                                                      |
|                                                                                |
|        TYPE-A HOST TO HOST                                                     |
|         LNIATA:                FE1414                                          |
|         SOCKET NUMBER:         157                                             |
|         IP ADDRESS:            9.117.198.102                                   |
|         TRAFFIC TYPE:          H TO H                                          |
|         ENCODING:              EBCIDIC                                         |
|         MULTIPLEX:             SINGLE FLOW                                     |
|         HEADER:                NO HEADER                                       |
|         PRESENTATION:          1024C                                           |
|         H1H2:                  76                                              |
|         FLOW ID:               42                                              |
|                                                                                |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

Related Information

See TPF Application Programming and TPF Data Communications Services Reference for more information about the terminal address table (WGTA).