Synchronous communication services

This topic describes Transfer CFT synchronous communication services.

Description of functions

Function

Use

COM

Set the communication medium

GETXINFO

Retrieve information concerning the last transfer made from a synchronous request after a request of the following types: SEND, RECV, HALT, KEEP, START, RESUME, DELETE, END, SUBMIT, SWITCH, PURGE.

The information is stored in a cftApiInf-type structure:

  • Transfer state
  • Diagnostic
  • Diagnostic protocol
  • Value of the PART field of CFTPARM
  • Transfer identifier (IDT)
  • Local transfer identifier (IDTU)
  • Transfer type (single, cyclical, diffusion list, collection, file group)
  • Public reference of the transfer (only for a single transfer in Send)

The GETXINFO action returns an error if the communication medium is not synchronous.

Note The public reference of the transfer is a character string of variable length. In the PESIT protocol, it contains 'pi13.pi3.pi4.pi11.pi12.pi61.pi62'.

Call syntax

CALL     "CFTU"     USING     <verb>       <param>     <rc>
CALL     "CFTC"     USING     <verb>       <param>     <rc>

Where:

  • CFTU indicates that syntax analysis is requested
    CFTC indicates that syntax analysis is not requested
  • <verb> is the command that you want to process
  • <param> is a character string of variable length that contains the command parameters. The end of the field is defined by a character initially set to low-value
  • <rc> is the return code

The available <verbs> are listed in the following table.

<verb>

Value

Service

F-COM

COM

Communication mode

The available <param> are listed in the following table.

<verb>

<param>

Explanation

F-COM

D-COM

The COM command parameter structure is as follows: <medium type> = <Medium name>

The medium type consists in an uppercase letter:

  • 'F' for file
  • 'M' for mailbox
  • 'T' for the TCP/IP synchronous medium
  • 'C' for the configuration file (ConfigFileName)

The medium name is the:

  • Filename, if the medium type is 'F'
  • Mailbox name, if the medium type is 'M'
  • Name of the communication channel, if the medium type is 'T'
  • Name of the configuration file containing the medium of communication characteristics, if the medium type is C.

Return codes

Mnemonic

Description

CAPI-NOERR

No error

CAPI-FUNC-UNDEF

Command not valid

CAPI-COM-OPEN

Communication medium opening error

CAPI-COM-WRITE

Communication medium write error

CAPI-COM-CLOSE

Communication medium closing problem

CAPI-COM-ALLOC

Communication medium allocation problem

CAPI-COM-ERR

Communication medium not available on this system

The available <verbs> are listed in the following table.

<verb>

Value

Service

F-COM

COM

Communication mode

F-GETINXFO

GETINXFO

Recovering information about a transfer made from a synchronous request

The available <param> are listed in the following table.

<verb>

<param>

Explanation

F-COM

D-COM

The COM command parameter structure is as follows: <medium type> = <Medium name>

The medium type consists in an uppercase letter:

  • 'F' for file
  • 'M' for mailbox
  • 'T' for the TCP/IP synchronous medium
  • 'C' for the configuration file (ConfigFileName)

The medium name is the:

  • Filename, if the medium type is 'F'
  • Mailbox name, if the medium type is 'M'
  • Name of the communication channel, if the medium type is 'T'
  • Name of the configuration file containing the medium of communication characteristics, if the medium type is C.

F-GETINXFO

Z-XINF

Information about a transfer in the format described in the OAPIINF file.

Related Links