API Sample Application Messages

Table Of Contents

API Sample Application Messages

Socket WHOIS

WHOIS NAME (name) {HOST(hostname)}

WHOIS: bind:

WHOIS: connect:

WHOIS: read:

WHOIS: socket:

WHOIS: whois/tcp: : unknown service

WHOIS: write:

WHOIS: hostname: host unknown

C WHOIS

WHOIS NAME (name) {HOST(hostname)} {SYSID subsystem id)}

WHOIS: ACLOSE FAILED : general return code is ret_code WHOIS: APCBERRC - err_code

WHOIS: AOPEN FAILED : general return code is ret_code WHOIS: APCBERRC - err_code

WHOIS: TBIND FAILED : general return code is err_code WHOIS: TPLRTNCD - ret_code

WHOIS: TCLOSE FAILED : general return code is err_code WHOIS: TPLRTNCD - ret_code

WHOIS: TCONFIRM FAILED : general return code is err_code WHOIS: TPLRTNCD - ret_code

WHOIS: TCONNECT FAILED : general return code is err_code WHOIS: TPLRTNCD - ret_code

WHOIS: TCP/WHOIS service unknown
WHOIS: DIRSRV FAILED: general return code is num WHOIS: DPLRTNCD - value

WHOIS: TOPEN FAILED : general return code is err_code WHOIS: TPLRTNCD - ret_code

WHOIS: TRECV FAILED : general return code is err_code WHOIS: TPLRTNCD - ret_code

WHOIS: TRELACK FAILED : general return code is err_code WHOIS: TPLRTNCD - ret_code

WHOIS: TRELESE FAILED : general return code is err_code WHOIS: TPLRTNCD - ret_code

WHOIS: TSEND FAILED : general return code is err_code WHOIS: TPLRTNCD - ret_code

WHOIS: hostname host unknown
WHOIS: DIRSRV FAILED: general return code is num WHOIS: DPLRTNCD - value

C ACSHELLO

ACSHELLO {PORT(TCP port)} {SYSID (subsystem id)}

ACSHELLO: AOPEN FAILED : general return code is ret_code
ACSHELLO: APCBERRC - err_code

ACSHELLO: DIRSRV FAILED : general  return  code  is ret_code
ACSHELLO: DPLRTNCD - value

ACSHELLO: TACCEPT FAILED... : general return code is err_code
ACSHELLO: TPLRTNCD - ret_code

ACSHELLO: TBIND FAILED : general return code is err_code
ACSHELLO: TPLRTNCD - ret_code

ACSHELLO: TCLOSE FAILED : general return code is err_code
ACSHELLO: TPLRTNCD - ret_code

ACSHELLO: TLISTEN FAILED : general return code is err_code
ACSHELLO: TPLRTNCD - ret_code

ACSHELLO: TOPEN FAILED : general return code is err_code
ACSHELLO: TPLRTNCD - ret_code

ACSHELLO: TRELACK FAILED : general return code is err_code
ACSHELLO: TPLRTNCD - ret_code

ACSHELLO: TRELEASE FAILED : general return code is err_code
ACSHELLO: TPLRTNCD - ret_code

ACSHELLO: TSEND FAILED : general return code is err_code
ACSHELLO: TPLRTNCD - ret_code

ACSHELLO: CPU ID is: id_num

ACSHELLO: Host's internet address is: int_addr

ACSHELLO: MVS SMF ID is: smf_id

ACSHELLO: MVS version level is: MVS/vers

ACSHELLO: Running on host: hostname

ACSHELLO: Server starting at: date_time

ACSHELLO: Server stopping at: date_time

Socket ACSHELLO

ACSHELLO {PORT(TCP port)}

ACSHELLO: accept

ACSHELLO: bind

ACSHELLO: close

ACSHELLO: gethostbyname

ACSHELLO: gethostname

ACSHELLO: listen

ACSHELLO: select

ACSHELLO: socket

ACSHELLO: write

ACSHELLO: CPU ID is...

ACSHELLO: Host's internet address is: int_add

ACSHELLO: MVS SMF ID is: host_id

ACSHELLO: MVS version level is: MVS/level

ACSHELLO: Running on host: hostname

ACSHELLO: Server starting at: date_time

ACSHELLO: Server stopping at: date_time

FINGER

FINGER NAME (USERID@HOST) {LONG}

FINGER: connect

FINGER: socket

FINGER: TCP/FINGER: unknown service

FINGER: unknown host: hostname

(hostname)

TTCP

AOPEN FAILED; VERIFY THAT SSN PARM IS CORRECT AND TCP IS EXECUTING

BAD DPL FUNCTION CODE (DPLFNCCD) FOUND AFTER DIRSRV ERROR

BAD TPL FUNCTION CODE (TPLFNCCD) FOUND AFTER T-FUNCTION ERROR

CIB ADDRESS = 0 AFTER STOP (P) COMMAND

CIB VERB NOT EQUAL TO CIBSTOP AFTER STOP (P) COMMAND

COMLIST ADDRESS = 0 AFTER EXTRACT COMM MACRO ISSUED

INVALID BUFLEN PARAMETER - MUST BE <=TIB MAX (TIBLTRCV)

INVALID BUFLEN PARAMETER - MUST BE <=TIB MAX (TIBLTSND)

INVALID BUFLEN PARAMETER - MUST BE > ZERO (0)

INVALID BUFNUM PARAMETER - MUST BE <=TIB MAX (TIBQRECV)

INVALID BUFNUM PARAMETER - MUST BE <= TIB MAX (TIBQSEND)

INVALID BUFNUM PARAMETER - MUST BE > ZERO (0)

INVALID COMBINATION OF BUFNUM AND BUFLEN PARAMETERS - MUST BE <= TIB MAX (TIBLRECV)

INVALID COMBINATION of BUFNUM AND BUFLEN PARAMETERS - MUST
    BE <= TIB MAX (TIBLSEND)

INVALID COUNT PARAMETER - MUST BE > ZERO (0)

INVALID MESSAGE ID ID PASSED TO PUTLINE ROUTINE

NO FREE RECEIVER SUBTASK FOUND WHERE EXPECTED

NULL (ZERO) ENDPOINT ID ID PASSED TO RECEIVER

QEDIT CIBPTR=0 (DISALLOW MODIFY COMMANDS) FAILED

QEDIT FREE OF CIB FAILED

STAX ATTNEXIT FAILED

TTCPR: TRANSFER SECONDS secs TRECV's trecvs, TRECV's/SEC trecvsps BYTES RECEIVED bytes, BYTES/SEC bytesps

TTCPT: TRANSFER SECONDS secs TSEND's tsends, TSEND's/SEC tsendsps BYTES SENT bytes, BYTES/SEC bytesps

UNEXPECTED ENDPOINT STATE AFTER TOPEN OPTCD=OLD COMPLETED

API Sample Application Messages

---

This chapter lists the messages that can be generated by the FINGER, WHOIS, ACSHELLO, and TTCP sample API application programs. It includes these sections:

•Socket WHOIS

Lists messages generated by the socket version of the WHOIS sample program.

•C WHOIS

Lists messages generated by the C library version of the WHOIS client program.

•C ACSHELLO

Lists the messages generated by the socket version of the ACSHELLO sample program.

•Socket ACSHELLO

Lists the messages generated by the socket version of the ACSHELLO sample program.

•FINGER

Lists messages generated by the FINGER program.

•TTCP

Lists messages generated by the TTCP sample program.

Socket WHOIS

This section lists messages generated by the socket version of the WHOIS sample program.

Most of these messages use the perror function call of the socket library to issue the message, and therefore these messages have an error-specific string appended to them. Read in this document for descriptions of the perror error messages of the socket library.

If the WHOIS program executes successfully, it returns a value of 0. When the socket WHOIS program encounters an error, it immediately terminates execution with a return code of 16.

WHOIS NAME (name) {HOST(hostname)}

Explanation    Usage help message display if the WHOIS command is issued with invalid command line parameters. WHOIS must be called with a required parameter of NAME() and with the optional parameter of HOST() (name of host to request WHOIS service).

WHOIS: bind:

Explanation    The WHOIS program cannot bind a name to the socket used to communicate with the WHOIS server. Read in this document for more information about the error message.

WHOIS: connect:

Explanation    The WHOIS program cannot establish a TCP connection with the WHOIS server. Read in this document for more information about the error message.

WHOIS: read:

Explanation    The WHOIS program encountered an error when reading from the socket used to communicate with the WHOIS server. Read in this document for more information about the error message.

WHOIS: socket:

Explanation    The WHOIS program cannot open a socket to use to connect to the WHOIS server. Read in this document for more information about the error message.

WHOIS: whois/tcp: : unknown service

Explanation    The WHOIS client cannot determine the port number of the WHOIS server to connect to, due to a failure of the directory services to return a correct value. Check that the database contains an entry for the WHOIS service using TCP.

WHOIS: write:

Explanation    The WHOIS program encountered an error when writing to the socket used to communicate with the WHOIS server. Read in this document for more information about the error message.

WHOIS: hostname: host unknown

Explanation    The WHOIS program cannot find the name of the host specified by the command line parameter HOST() using the directory services feature of Cisco IOS for S/390.

C WHOIS

This section lists messages generated by the C library version of the WHOIS client program. If the C WHOIS program completes successfully, it returns an error code of 0. If any errors are encountered, it returns a 16.

WHOIS NAME (name) {HOST(hostname)} {SYSID subsystem id)}

Explanation    This message is issued when a command parameter is formatted incorrectly. It is to provide the user the syntax of the command. WHOIS must be called with a required parameter of NAME() and with optional parameters of HOST() (name of host to request WHOIS service) and SYSID (subsystem ID of Cisco IOS for S/390).

WHOIS: ACLOSE FAILED : general return code is ret_code WHOIS: APCBERRC - err_code

Explanation    When terminating the user session with the API, the WHOIS program detected an error at the completion of the ACLOSE. ret_code is the general return code of the ACLOSE macro; err_code is the error code field of the APCB that was used to call ACLOSE.

WHOIS: AOPEN FAILED : general return code is ret_code WHOIS: APCBERRC - err_code

Explanation    These two lines of output indicate that the WHOIS program cannot open an application session with the API. ret_code is the general return code of the AOPEN macro; err_code is the error code field of the APCB used to call AOPEN.

WHOIS: TBIND FAILED : general return code is err_code WHOIS: TPLRTNCD - ret_code

Explanation    The WHOIS program attempted to assign a name to its local endpoint using TBIND, but an error was encountered by the API. The TBIND macro returned an error indicated by the general error code, err_code, and the Transport Parameter List (TPL) return code field, ret_code.

Explanation    This error message may be followed by a message generated by the API. Read the API messages in Cisco IOS for S/390 Prefixed Messages for information about the message.

WHOIS: TCLOSE FAILED : general return code is err_code WHOIS: TPLRTNCD - ret_code

Explanation    After completing the conversation with the WHOIS server, the client encountered an error when attempting to close the endpoint used for this session. The TCLOSE macro returned an error indicated by the general error code, err_code, and the Transport Parameter List (TPL) return code field, ret_code.

WHOIS: TCONFIRM FAILED : general return code is err_code WHOIS: TPLRTNCD - ret_code

Explanation    While attempting to confirm the connection sequence, the API returned an error to the WHOIS program. The TCONFIRM macro returned an error indicated by the general error code, err_code, and the Transport Parameter List (TPL) return code field, ret_code.

WHOIS: TCONNECT FAILED : general return code is err_code WHOIS: TPLRTNCD - ret_code

Explanation    When trying to initiate a connection with the WHOIS server, an error was encountered. The TCONNECT macro returned an error indicated by the general error code, displayed at the err_code, and the Transport Parameter List (TPL) return code field, ret_code.

WHOIS: TCP/WHOIS service unknown
WHOIS: DIRSRV FAILED: general return code is num WHOIS: DPLRTNCD - value

Explanation    These three lines of messages are printed if the WHOIS program cannot locate the WHOIS service port for TCP using the directory services. num is the number of the general return code returned by the DIRSRV macro expansion. value is the value of the return code field of the Directory Services Parameter List (DPL) used when DIRSRV is called.

WHOIS: TOPEN FAILED : general return code is err_code WHOIS: TPLRTNCD - ret_code

Explanation    The WHOIS program attempted to open a transport endpoint through which to communicate to the WHOIS server. The TOPEN macro returned an error indicated by the general error code, err_code, and the Transport Parameter List (TPL) return code field, ret_code.

WHOIS: TRECV FAILED : general return code is err_code WHOIS: TPLRTNCD - ret_code

Explanation    When receiving data from the WHOIS server, an error was detected. The TRECEIVE macro returned an error indicated by the general error code, err_code, and the Transport Parameter List (TPL) return code field, ret_code.

WHOIS: TRELACK FAILED : general return code is err_code WHOIS: TPLRTNCD - ret_code

Explanation    When attempting to acknowledge a release indication received from the WHOIS server, the client detected an error. The TRELACK macro returned an error indicated by the general error code, err_code, and the Transport Parameter List (TPL) return code field, ret_code.

WHOIS: TRELESE FAILED : general return code is err_code WHOIS: TPLRTNCD - ret_code

Explanation    When completing the orderly release between the client and the server, an error was detected by the WHOIS program. The TRELEASE macro returned an error indicated by the general error code, err_code, and the Transport Parameter List (TPL) return code field, ret_code.

WHOIS: TSEND FAILED : general return code is err_code WHOIS: TPLRTNCD - ret_code

Explanation    While transmitting data to the WHOIS server, an error was detected. The TSEND macro returned an error indicated by the general error code, err_code, and the Transport Parameter List (TPL) return code field, ret_code.

WHOIS: hostname host unknown
WHOIS: DIRSRV FAILED: general return code is num WHOIS: DPLRTNCD - value

Explanation    These three lines of messages are printed if the WHOIS program cannot locate the Network Information Center's name using the directory services. The hostname is replaced by the default host name of the NIC or by the name of the host specified by the user in the HOST command parameter. num is the number of the general return code returned by the DIRSRV macro expansion. value is the value of the return code field of the Directory Services Parameter List (DPL) used when DIRSRV is called.

C ACSHELLO

This section lists those messages issued by the C library version of the ACSHELLO program. If the ACSHELLO program encounters any unrecoverable problem during its operation, it returns a code of 16. Because the program executes a loop servicing the clients requesting information, the program does not terminate successfully. You must either cancel the job or attention out the TSO command.

ACSHELLO {PORT(TCP port)} {SYSID (subsystem id)}

Explanation    This message is issued when a command parameter is formatted incorrectly. It is to provide the user the syntax of the command. ACSHELLO may be called with no parameters or optionally with a well-known port number and/or a subsystem ID.

ACSHELLO: AOPEN FAILED : general return code is ret_code
ACSHELLO: APCBERRC - err_code

Explanation    These two lines of output indicate that the ACSHELLO program cannot open an application session with the API. ret_code is the general return code of the AOPEN macro, and err_code is the error code field of the APCB that was used to call AOPEN.

ACSHELLO: DIRSRV FAILED : general  return  code  is ret_code
ACSHELLO: DPLRTNCD - value

Explanation    The ACSHELLO server cannot look up its local host name and/or its internet address from NDS. ret_code is the number of the general return code returned by the DIRSRV macro expansion. value is the value of the return code field of the Directory Services Parameter List (DPL) used when DIRSRV was called.

ACSHELLO: TACCEPT FAILED... : general return code is err_code
ACSHELLO: TPLRTNCD - ret_code

Explanation    On receiving a connection request from a client, the server attempted to accept the connection to a new endpoint. The TACCEPT macro returned an error indicated by the general error code, err_code, and the Transport Parameter List (TPL) return code field, ret_code.

ACSHELLO: TBIND FAILED : general return code is err_code
ACSHELLO: TPLRTNCD - ret_code

Explanation    The ACSHELLO program attempted to assign a name to its local endpoint using TBIND but an error was encountered by the API. The TBIND macro returned an error indicated by the general error code, err_code, and the Transport Parameter List (TPL) return code field, ret_code. This error message may be followed by a message generated by the API. Read the API messages in Cisco IOS for S/390 Prefixed Messages for information about the message.

ACSHELLO: TCLOSE FAILED : general return code is err_code
ACSHELLO: TPLRTNCD - ret_code

Explanation    After providing service to a client, the ACSHELLO program detected an error on the TCLOSE used to destroy the local endpoint. The TCLOSE macro returned an error indicated by the general error code, err_code, and the Transport Parameter List (TPL) return code field, ret_code.

ACSHELLO: TLISTEN FAILED : general return code is err_code
ACSHELLO: TPLRTNCD - ret_code

Explanation    The ACSHELLO program attempted to wait on the local endpoint receiving an incoming connection request from a client. The TLISTEN macro returned an error indicated by the general error code, err_code, and the Transport Parameter List (TPL) return code field, ret_code.

ACSHELLO: TOPEN FAILED : general return code is err_code
ACSHELLO: TPLRTNCD - ret_code

Explanation    The ACSHELLO program attempted to open a transport endpoint through which to wait for incoming connection requests from clients. The TOPEN macro returned an error indicated by the general error code, err_code, and the Transport Parameter List (TPL) return code field, ret_code.

ACSHELLO: TRELACK FAILED : general return code is err_code
ACSHELLO: TPLRTNCD - ret_code

Explanation    When acknowledging the completion of the orderly release from the client, the ACSHELLO server received an error on the release acknowledgment. The TRELACK macro returned an error indicated by the general error code, err_code, and the Transport Parameter List (TPL) return code field, ret_code.

ACSHELLO: TRELEASE FAILED : general return code is err_code
ACSHELLO: TPLRTNCD - ret_code

Explanation    After issuing a TRELEASE request to the API to begin an orderly release of the TCP connection to the client, an error was returned by the API to the ACSHELLO program. The TRELEASE macro returned an error indicated by the general error code, err_code, and the Transport Parameter List (TPL) return code field, ret_code.

ACSHELLO: TSEND FAILED : general return code is err_code
ACSHELLO: TPLRTNCD - ret_code

Explanation    When trying to send data to a connected client, the ACSHELLO server was returned an error from the API. The TSEND macro returned an error indicated by the general error code, err_code, and the Transport Parameter List (TPL) return code field, ret_code.

ACSHELLO: CPU ID is: id_num

Explanation    This message is transmitted to a connected client to indicate the CPU serial number and model number of the host on which ACSHELLO is running.

ACSHELLO: Host's internet address is: int_addr

Explanation    This message is transmitted to a connected client to indicate the internet address used by this host to communicate.

ACSHELLO: MVS SMF ID is: smf_id

Explanation    This message is transmitted to a connected client to indicate the SMF ID of the host on which ACSHELLO is running.

ACSHELLO: MVS version level is: MVS/vers

Explanation    This message is transmitted to a connected client to indicate the version level of MVS on which the ACSHELLO program is running.

ACSHELLO: Running on host: hostname

Explanation    This message is transmitted to a connected client to indicate the name of the host on which ACSHELLO is executing. hostname is the name of the host or the string No host name, if ACSHELLO encountered a problem getting its name from NDS.

ACSHELLO: Server starting at: date_time

Explanation    This message is transmitted to a connected client to indicate that the ACSHELLO server has accepted its request for service and proceeds to do so. date_time is the current date and time as reflected by the system on which ACSHELLO is running.

ACSHELLO: Server stopping at: date_time

Recommended Action    This message is transmitted to a connected client to indicate that the ACSHELLO has completed its service to the connected client and now terminates. date_time is the current date and time as reflected by the system on which ACSHELLO is running.

Socket ACSHELLO

This section lists the messages generated by the socket version of the ACSHELLO sample program. The ACSHELLO program runs in a loop, servicing clients as they request information of the server. Therefore it does not terminate with a successful return code. The user should cancel it or attention interrupt the TSO command. However if the ACSHELLO server detects an unrecoverable error, it terminates with a return code of 16.

Most of these messages use the perror function call of the socket library to issue the message and have an error-specific string appended to them. Read in this document for more information.

ACSHELLO {PORT(TCP port)}

Explanation    This message is issued when a command parameter is formatted incorrectly. It is to provide the user the syntax of the command. ACSHELLO may be called with no parameters or optionally with a well-known port number.

ACSHELLO: accept

Explanation    The ACSHELLO program encountered an error when trying to accept an incoming connection from a client. Read in this document for more information about the error message.

ACSHELLO: bind

Explanation    The ACSHELLO program cannot bind a well-known name to the socket used to listen for requests from clients. Read in this document for a more detailed explanation of the error message.

ACSHELLO: close

Explanation    The ACSHELLO program encountered an error when closing the connection to a client that just received servicing. Read in this document for more information about the error message.

ACSHELLO: gethostbyname

Explanation    The ACSHELLO program encountered an error after issuing a request to NDS to retrieve its internet address.

ACSHELLO: gethostname

Explanation    The ACSHELLO program detected an error after issuing a request to NDS to retrieve the local host's name. Read in this document for more information about the error message.

ACSHELLO: listen

Explanation    The ACSHELLO program encountered an error when attempting to enable the socket for accepting connection requests. Read in this document for more information about the error message.

ACSHELLO: select

Explanation    The ACSHELLO program detected an error when using the select socket call to perform synchronous I/O multiplexing. Read in this document for more information about the error message.

ACSHELLO: socket

Explanation    The ACSHELLO program cannot open a socket to use to serve clients requesting service. Read in this document for more information about the error message.

ACSHELLO: write

Explanation    The ACSHELLO program encountered an error when writing data to a connected client. Read in this document for more information about the error message.

ACSHELLO: CPU ID is...

Explanation    This message is transmitted to a connected client to indicate the CPU serial number and model number of the host on which ACSHELLO is running.

ACSHELLO: Host's internet address is: int_add

Explanation    This message is transmitted to a connected client to indicate the internet address used by this host to communicate.

ACSHELLO: MVS SMF ID is: host_id

Explanation    This message is transmitted to a connected client to indicate the SMF ID of the host on which ACSHELLO is running.

ACSHELLO: MVS version level is: MVS/level

Explanation    This message is transmitted to a connected client to indicate the version level of MVS on which the ACSHELLO program is running.

ACSHELLO: Running on host: hostname

Explanation    This message is transmitted to a connected client to indicate the name of the host on which ACSHELLO is executing. hostname is the name of the host or the string no host name, if ACSHELLO encountered a problem getting its name from NDS.

ACSHELLO: Server starting at: date_time

Explanation    This message is transmitted to a connected client to indicate that the ACSHELLO server has accepted its request for service and proceeds to do so. date_time is the current date and time as reflected by the system on which ACSHELLO is running.

ACSHELLO: Server stopping at: date_time

Explanation    This message is transmitted to a connected client to indicate that the ACSHELLO has completed its service to the connected client and now terminates. The date_time is replaced with the current date and time as reflected by the system on which ACSHELLO is running.

FINGER

This section lists messages generated by the FINGER program. Most of these messages use the perror function call of the socket library to issue the message. Therefore these messages have an error-specific string appended to them. Read in this document more information.

If the FINGER program executes successfully, it returns a value of 0. When the FINGER program encounters an error, it immediately terminates execution with a return code of 16.

FINGER NAME (USERID@HOST) {LONG}

Explanation    Usage help message display if FINGER command is issued with invalid command line parameters. FINGER must be called with a required parameter of NAME() and with the optional parameter of LONG.

FINGER: connect

Explanation    The FINGER program could not establish a TCP connection with the FINGER server. Read the section on perror generated messages for a more detailed explanation of the error message.

FINGER: socket

Explanation    The FINGER program could not open a socket to use to connect to the FINGER server. Read the section on perror generated messages for a more detailed explanation of the error message.

FINGER: TCP/FINGER: unknown service

Explanation    The FINGER client could not determine the port number to connect to of the FINGER server, due to a failure of the directory services to return a correct value. The user should ensure that the database contains an entry for the FINGER service using TCP.

FINGER: unknown host: hostname

Explanation    The FINGER program could not find the name of the host specified by the command line parameter NAME() using the directory services feature of Cisco IOS for S/390.

(hostname)

Explanation    The name of the host specified as part of the NAME() parameter has been located by the directory services.

TTCP

This section lists messages generated by the TTCP sample program.

If the TTCP program executes successfully, it returns a value of 0. A return code of 100 (decimal) indicates that the MVS IKJPARS facility encountered a severe error in trying to parse the TTCP parameters. A return code of 52 (decimal) indicates a general TTCP program error and is accompanied by a message. A return code of 48 (decimal) indicates the failure of a TPL-based API operation and is also accompanied by a message.

AOPEN FAILED; VERIFY THAT SSN PARM IS CORRECT AND TCP IS EXECUTING

Explanation    An AOPEN macro issued by TTCP failed. This generally means that the SSN parameter was incorrectly specified or that the specified Cisco IOS for S/390 subsystem is not executing.

BAD DPL FUNCTION CODE (DPLFNCCD) FOUND AFTER DIRSRV ERROR

Explanation    After a DIRSRV macro issued by TTCP failed, the DPL function code (DPLFNCCD) was found to be invalid.

BAD TPL FUNCTION CODE (TPLFNCCD) FOUND AFTER T-FUNCTION ERROR

Explanation    After a TPL-based operation issued by TTCP failed, the TPL function code (TPLFNCCD) was found to be invalid.

CIB ADDRESS = 0 AFTER STOP (P) COMMAND

Explanation    When running TTCP under the TSO TMP in a batch job, the address of the CIB was found to be zero after an MVS STOP (P) command.

CIB VERB NOT EQUAL TO CIBSTOP AFTER STOP (P) COMMAND

Explanation    When running TTCP under the TSO TMP in a batch job, the CIBVERB field in the CIB control block was found not to contain the expected CIBSTOP value after an MVS STOP (P) command.

COMLIST ADDRESS = 0 AFTER EXTRACT COMM MACRO ISSUED

Explanation    When running TTCP under the TSO TMP in a batch job, the EXTRACT COMM macro resulted in the returned COMLIST address being zero.

INVALID BUFLEN PARAMETER - MUST BE <=TIB MAX (TIBLTRCV)

Explanation    The BUFLEN parameter entered by the user is invalid. BUFLEN must be less than or equal to the Transport Information Block (TIB) maximum size of TRECV/TRECVFR data (TIBLTRCV) that is set via the MAXLTRECV parameter of the TCP or UDP statement.

INVALID BUFLEN PARAMETER - MUST BE <=TIB MAX (TIBLTSND)

Explanation    The BUFLEN parameter entered by the user is invalid. BUFLEN must be less than or equal to the Transport Information Block (TIB) maximum size of TSEND/TSENDTO data (TIBLTSND) that is set via the MAXLTSEND parameter of the TCP or UDP statement.

INVALID BUFLEN PARAMETER - MUST BE > ZERO (0)

Explanation    The BUFLEN parameter entered by the user is invalid. When TTCP is in receive mode, BUFLEN must be greater than zero.

INVALID BUFNUM PARAMETER - MUST BE <=TIB MAX (TIBQRECV)

Explanation    The BUFNUM parameter entered by the user is invalid. BUFNUM must be less than or equal to the Transport Information Block (TIB) maximum size of the receive queue (TIBQRECV) that is set via the MAXQRECV parameter of the TCP or UDP statement.

INVALID BUFNUM PARAMETER - MUST BE <= TIB MAX (TIBQSEND)

Explanation    The BUFNUM parameter entered by the user is invalid. BUFNUM must be less than or equal to the Transport Information Block (TIB) maximum size of the send queue (TIBQSEND) that is set via the MAXQSEND parameter of the TCP or UDP statement.

INVALID BUFNUM PARAMETER - MUST BE > ZERO (0)

Explanation    The BUFNUM parameter entered by the user is invalid. BUFNUM must be greater than zero.

INVALID COMBINATION OF BUFNUM AND BUFLEN PARAMETERS - MUST BE <= TIB MAX (TIBLRECV)

Explanation    While the individual BUFLEN and BUFNUM parameters entered by the user are valid, the combination of the two is invalid. The product of BUFLEN multiplied by BUFNUM must be less than or equal to the Transport Information Block (TIB) maximum size of the receive buffer (TIBLRECV) that is set via the MAXRECVBUF parameter of the TCP or UDP statement.

INVALID COMBINATION of BUFNUM AND BUFLEN PARAMETERS - MUST
    BE <= TIB MAX (TIBLSEND)

Explanation    While the individual BUFLEN and BUFNUM parameters entered by the user are valid, the combination of the two is invalid. The product of BUFLEN multiplied by BUFNUM must be less than or equal to the Transport Information Block (TIB) maximum size of the send buffer (TIBLSEND) that is set via the MAXSENDBUF parameter of the TCP or UDP statement.

INVALID COUNT PARAMETER - MUST BE > ZERO (0)

Explanation    The count parameter entered by the user is invalid. When TTCP is in transmit mode, COUNT must be greater than zero.

INVALID MESSAGE ID ID PASSED TO PUTLINE ROUTINE

Explanation    The TTCP subroutine that issues the TSO PUTLINE macro was passed an invalid message identifier.

NO FREE RECEIVER SUBTASK FOUND WHERE EXPECTED

Explanation    In TTCP receive mode, a free receiver subtask control block was not found to allow passing of the endpoint to a receiver subtask.

NULL (ZERO) ENDPOINT ID ID PASSED TO RECEIVER

Explanation    In TTCP receive mode, the receiver subtask was passed an invalid (null) endpoint ID.

QEDIT CIBPTR=0 (DISALLOW MODIFY COMMANDS) FAILED

Explanation    When running TTCP under the TSO TMP in a batch job, the QEDIT CIBPTR=0 macro failed; the macro is issued to disallow the MVS MODIFY (F) command from being issued to the batch job.

QEDIT FREE OF CIB FAILED

Explanation    When running TTCP under the TSO TMP in a batch job, the QEDIT FREE of the CIB failed; this CIB represents the MVS STOP (P) command.

STAX ATTNEXIT FAILED

Explanation    When running TTCP under TSO (nonbatch) the STAX ATTNEXIT macro failed.

TTCPR: TRANSFER SECONDS secs TRECV's trecvs, TRECV's/SEC trecvsps BYTES RECEIVED bytes, BYTES/SEC bytesps

Explanation    Statistic message issued Transport Information Block (TIB) completion of a receive (sink) transfer.

Parameter	Description
secs	The number of seconds the transfer took.
trecvs	The number of TRECV/TRECVFR operations completed.
trecvsps	The number of TRECV/TRECVFR operations completed per second.
bytes	The number of data bytes received.
bytesps	The number of data bytes received per second.

TTCPT: TRANSFER SECONDS secs TSEND's tsends, TSEND's/SEC tsendsps BYTES SENT bytes, BYTES/SEC bytesps

Explanation    Statistic message issued Transport Information Block (TIB) completion of a transmit (source) transfer.

Parameter	Description
secs	The number of seconds the transfer took.
tsends	The number of TSEND/TSENDTO operations completed.
tsendsps	The number of TSEND/TSENDTO operations completed per second.
bytes	The number of data bytes received.
bytesps	The number of data bytes received per second.

UNEXPECTED ENDPOINT STATE AFTER TOPEN OPTCD=OLD COMPLETED

Explanation    In TTCP receive mode, the receiver subtask found the passed endpoint to be in the wrong state.