| Keyword | Description |
|---|---|
| TCpipservice(name) | Name of the TCP/IP Service record. Can be up to eight characters in length. Acceptable characters are A through Z, 0 through 9, $, @ and #. |
| Group(groupname) | Names the group the connection definition belongs to. Mandatory. groupname can be up to eight characters in length. Acceptable characters are A through Z, 0 through 9, $, @ and #. Do not specify a group name starting with DFH, as Mainframe Subsystem Support (MSS) uses that prefix for system groups. |
| Description(text) | Describes the bundle. Optional. text can be up to 60 characters in length, with no restrictions except that if you use a left parenthesis you must ensure that there is a matching right parenthesis. |
| AUthenticate (NO|AUTOMATIC|BASIC|AUTOREGISTER|CERTIFICATE) | The authentication and identification scheme to use. |
| CErtificate(tabel) | The certificate to use for the SSL handshake. |
| CIphers(value) | Used when encrypting inbound messages. |
| Host (ANY|DEFAULT|name) | IPv4 or IPv6 address or host name which CICS listens to for incoming connections. This takes precedence over the Ipaddress attribute. |
| Ipaddress (ANY|INADDR_ANY|address) | IPv4 which CICS listens to for incoming connections. |
| Maxdatalen(value) | The maximum length of data CICS can receive. Default is 32. |
| POrtnumber(value) | The port CICS will listen on for incoming client requests. |
| PROtocol (HTTP|USER) | The application-level protocol used. |
| Realmr(string) | The realm used for HTTP basic authentication. |
| SOCketclose (NO|hhmmss) | Whether CICS should close the socket after an amount of time. |
| STAtus (OPEN|CLOSED) | Indicates whether or not CICS is to listen for this service after installation. |
| SSL(NO|YES|CLIENTAUTH) | Whether the service should use SSL. |
| TRansaction (name) | The ID of the CICS transaction to process new requests received. Default is CWXN for PROTOCOL(HTTP), CWXU for PROTOCOL(USER). |
| Urm (name) | A user-replaceable program this service invokes. Default is DFHWBAAX. |
Example
DEFINE TCPIPSERVICE(SAMPTCP) GROUP(SAMPGRP)
DESCRIPTION(Sample SSL TCPIPSERVICE)
HOST(ANY) IPADDRESS(INADDR_ANY) PORTNUMBER(5663) SOCKETCLOSE(NO)
MAXDATALEN(32) STATUS(OPEN) TRANSACTION(CWXN) PROTOCOL(HTTP)
AUTHENTICATE(AUTOMATIC) SSL(CLIENTAUTH) CERTIFICATE(localhost)
CIPHERS(050435363738392F303132330A1613100D0915120F0C03060201)
REALM(SSL AUTOMATIC please logon) MAXDATALEN(32) URM(DFHWBAAX)