SOTB gate, GET_NEXT function

The GET_NEXT function is called by CEMT and the SPI for browsing TCPIPSERVICE resources. It returns information about an installed TCPIPSERVICE resources.

Input Parameters

BROWSE_TOKEN
A token representing the browse.

Output Parameters

REASON
The following values are returned when RESPONSE is EXCEPTION:
  • BROWSE_END
  • INVALID_BROWSE_TOKEN
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
TCPIPSERVICE_NAME
The name of the service that attached the task.
ATTACHSEC
Optional Parameter
The level of attach-time user security specified in the TCPIPSERVICE definition.
AUTHENTICATION
Optional Parameter
The authentication and identification scheme to be used for inbound TCP/IP connections.
Values for the parameter are:
  • AUTOMATIC
  • AUTOREGISTER
  • BASIC
  • CERTIFICATE
  • KERBEROS
  • NONE
BACKLOG
Optional Parameter
The backlog value associated with the service.
CERTIFICATE_LABEL
Optional Parameter
The certificate label associated with the service.
CIPHER_COUNT
Optional Parameter
The number of cipher suites encoded in the CIPHER_SUITES parameter.
CIPHER_SUITES
Optional Parameter
A binary representation of the cipher suites that are used to encrypt data.
CONNECTIONS
Optional Parameter
Either the number of connections for the service represented by the supplied TCPIPSERVICE name, or the total number of TCP/IP connections to all of the currently active services.
DNSGROUP
Optional Parameter
The group name with which CICS® registers to Workload Manager, for connection optimization.
DNSSTATUS
Optional Parameter
The Domain Name System (DNS) registration status of the service.
Values for the parameter are:
  • DEREGERROR
  • DEREGISTERED
  • NOTAPPLIC
  • REGERROR
  • REGISTERED
  • UNAVAILABLE
  • UNREGISTERED
GRPCRITICAL
Optional Parameter
A binary value indicating whether the TCPIPSERVICE resource is a critical member of the DNS group. When a critical TCPIPSERVICE resource closes or fails, CICS deregisters the group name from Workload Manager.
Values for the parameter are:
  • CRITICAL
  • NONCRITICAL
IPADDRESS
Optional Parameter
The IP address that the service is bound to.
MAXDATA_LENGTH
Optional Parameter
The maximum length of data that CICS will receive when operating as an HTTP server.
MAXPERSIST
Optional Parameter
The maximum number of persistent connections from web clients that the CICS region allows for this port at any one time.
PORT
Optional Parameter
The port number associated with the service.
PRIVACY
Optional Parameter
The level of SSL encryption required for inbound connections to this service.
Values for the parameter are:
  • NOTSUPPORTED
  • REQUIRED
  • SUPPORTED
PROTOCOL
Optional Parameter
The application level protocol used on the TCP/IP port.
Values for the parameter are:
  • ECI
  • HTTP
  • USER
SOCKETCLOSE
Optional Parameter
The interval from the time of the initial receive request for incoming data, after which CICS is to time out the socket.
SSL
Optional Parameter
The SSL setting for the service.
Values for the parameter are:
  • CLIAUTH
  • NO
  • YES
  • ATTLSAWARE
STATUS
Optional Parameter
The current status of the service.
Values for the parameter are:
  • CLOSED
  • CLOSING
  • IMMCLOSING
  • OPEN
  • OPENING
TRANSID
Optional Parameter
The transaction ID associated with the service.
URM
Optional Parameter
The name of the user-replaceable program associated with the service.


dfhs3_SOTBget_next.html | Timestamp icon Last updated: Monday, 5 June 2017